summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAyush Agarwal <ayushnix@fastmail.com>2023-03-11 17:20:23 +0530
committerAyush Agarwal <ayushnix@fastmail.com>2023-03-22 17:20:17 +0530
commit2f227cd77b07948f225e4efffe3757f100706f79 (patch)
treee7405ab55bede60969098fe6bc8dc15315b7c9bb
parent79ba777cd2d28c7ca0930667666ec5fe02ea7aa7 (diff)
make: remove redundant comments
-rw-r--r--Makefile31
1 files changed, 0 insertions, 31 deletions
diff --git a/Makefile b/Makefile
index 1b205d0..8bdd652 100644
--- a/Makefile
+++ b/Makefile
@@ -1,7 +1,3 @@
-# `?=` assigns value to a variable only if it has not been set before
-# this can be useful when you want to override variables during execution of
-# the make command
-# for example, sudo make PREFIX=/custom/dir install
DESTDIR ?=
PREFIX ?= /usr
BINDIR ?= ${PREFIX}/bin
@@ -11,32 +7,11 @@ BASHCOMPDIR ?= ${DATAROOTDIR}/bash-completion/completions
FISHCOMPDIR ?= ${DATAROOTDIR}/fish/vendor_completions.d
PROG ?= tessen
-# `:=` is simple variable assignment and variables which are part of the values
-# being assigned are expanded only if they are already set
RM := rm
-# `@echo` prevents the command itself from being printed
ECHO := @echo
SCDOC := scdoc
INSTALL := install
-# this is where the basic structure of Makefiles start and it looks like
-# file_a : file_b
-# command
-# command
-# ...
-#
-# file_b: file_c
-# command
-# command
-# ...
-#
-# file_a needs file_b and file_b needs file_c - this is how Makefiles operate
-
-# file_a can be a `.PHONY`, a special target, which says that the files `all`,
-# `man` etc aren't really files but other targets
-# think of them as pseudo files or fake files which don't exist but serve to
-# execute commands in a certain logical sequence
-# by default, if nothing is specified, the `all` target is executed
.PHONY: all install minimal bashcomp fishcomp clean uninstall
all:
@@ -48,9 +23,6 @@ install: man bashcomp fishcomp
${ECHO} ""
${ECHO} "${PROG} has been installed succesfully"
-# a minimal alternative for people who don't want completion files or man pages
-# `make man`, `make install_man`, `make bashcomp`, `man fishcomp`, and `make
-# minimal` can be used selectively to install what's needed
minimal:
${INSTALL} -Dm 0755 ${PROG} -t ${DESTDIR}${BINDIR}
${ECHO} ""
@@ -60,9 +32,6 @@ man: man/${PROG}.1 man/${PROG}.5
${INSTALL} -Dm 0644 man/${PROG}.1 -t ${DESTDIR}${MANDIR}/man1
${INSTALL} -Dm 0644 man/${PROG}.5 -t ${DESTDIR}${MANDIR}/man5
-# we want *.scd files from the files that are inside man/
-# the `$^` is an automatic variable which means the list of `file_b`'s
-# the `$@` is an automatic variable which means the list of `file_a`'s
man/%: man/%.scd
${SCDOC} < $^ > $@