Skip to content

Commit

Permalink
add some comments to the Makefile
Browse files Browse the repository at this point in the history
- `src` und `tgt` habe ich entfernt, da sie nicht notwendig sind -- make
  hat für die Stellen, an denen sie verwendet wurden eigene Variablen:
  - $@ - aktuelles Target
  - $< - erstes Prerequisite (hier: hostmux.mandoc)
- das Starten einer Sub-Shell für `dirname` habe ich entfernt und mit
  der make-eigenen Funktion `dir` ersetzt (ist portabler)
- die Notwendigkeit des Konstrukts zur Fehlerbehandlung während der
  `mandoc`-Ausführung habe ich im Makefile mit einem Comment erklärt
  • Loading branch information
mjaschen committed Apr 7, 2017
1 parent 69c2296 commit 44a1f65
Showing 1 changed file with 9 additions and 5 deletions.
14 changes: 9 additions & 5 deletions Makefile
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
src=hostmux.mandoc
tgt=man/hostmux.1

$(tgt): $(src)
mkdir -p $(shell dirname $@)
# This target creates the manpage from its source file
#
# (1) Create target's directory if it doesn't exist
# (2) create the target $@ from the first prerequisite $<
# The shell redirection creates the target file before `mandoc` is
# actually executed. To avoid working further with an empty target file
# it's removed in case of an error and make exits with an error code.
man/hostmux.1: hostmux.mandoc
mkdir -p $(dir $@)
mandoc -I os=sh -Tman $< > $@ || { rm -f $@ ; exit 2 ; }

0 comments on commit 44a1f65

Please sign in to comment.