aboutsummaryrefslogtreecommitdiffstats
path: root/mk/README
diff options
context:
space:
mode:
authorMattias Andrée <maandree@member.fsf.org>2015-12-29 15:46:28 +0100
committerMattias Andrée <maandree@member.fsf.org>2015-12-29 15:46:28 +0100
commitf4a2244aff36b12460978c96eb669fd642a42256 (patch)
tree18ac462be5ea2e5eddf863793e1532a3ed62ea7a /mk/README
parentm gitignore (diff)
downloadsat-f4a2244aff36b12460978c96eb669fd642a42256.tar.gz
sat-f4a2244aff36b12460978c96eb669fd642a42256.tar.bz2
sat-f4a2244aff36b12460978c96eb669fd642a42256.tar.xz
add build system + add news file + update deps
Signed-off-by: Mattias Andrée <maandree@member.fsf.org>
Diffstat (limited to '')
-rw-r--r--mk/README71
1 files changed, 71 insertions, 0 deletions
diff --git a/mk/README b/mk/README
new file mode 100644
index 0000000..e79926d
--- /dev/null
+++ b/mk/README
@@ -0,0 +1,71 @@
+This is a collection of generic enough makefiles.
+Please feel free to use them in your project.
+
+Usage:
+ Include all.mk from your makefile.
+
+ Read the top of each file for details.
+
+ Define the variables:
+
+ _VERSION
+ This version of the package.
+
+ _PROJECT
+ The name of the project. Must only include [a-z0-9_-].
+
+ _PROJECT_FULL
+ The name of the project. May include any character.
+
+ _SRC
+ All source code files. This list is used when
+ generating the translation template file.
+
+ _COPYRIGHT_HOLDER
+ The copyright holder's full name and e-mail address.
+
+ COMMAND
+ The name of the command. Must not be declared if
+ the package does not include exactly one runnable
+ command.
+
+ PKGNAME
+ The name of the package.
+
+ Variables beginning with __ are used internally by
+ the files where they appear, or in rare cases,
+ internally between these files.
+
+ Variables beginning with _ but not __ are set in the
+ makefile to specify for these files how they should
+ behave. They should not be changed by a user of the
+ package.
+
+ Variables that do not begin with _ are configurable
+ by the user of the package.
+
+ Do no use single character variables in your Makefile.
+
+ To suppress pre-install, post-install, pre-uninstall,
+ and post-uninstall instructions, set N=true.
+ PRE_INSTALL, POST_INSTALL, PRE_UNINSTALL, and
+ POST_UNINSTALL are supportered as specified by the
+ GNU coding standardars.
+
+ To figure out what pre-install commands to run in your package, run:
+ make -n a=% install | sed -e 's/\\$//' -e 's/^ *//' | sed -n '/^% /s/^..//p'
+
+ To figure out what post-install commands to run in your package, run:
+ make -n z=% uninstall | sed -e 's/\\$//' -e 's/^ *//' | sed -n '/^% /s/^..//p'
+
+ To figure out what pre-uninstall commands to run in your package, run:
+ make -n a=% uninstall | sed -e 's/\\$//' -e 's/^ *//' | sed -n '/^% /s/^..//p'
+
+ To figure out what post-uninstall commands to run in your package, run:
+ make -n z=% uninstall | sed -e 's/\\$//' -e 's/^ *//' | sed -n '/^% /s/^..//p'
+
+ To suppress verbatim which commands Make runs,
+ set Q=@. (Excluding the period.)
+
+Developers should use DEBUG=1 when running make, when possible.
+