aboutsummaryrefslogtreecommitdiffstats
path: root/mk/README
blob: fd27fd08fdc17965516783780b18b993cbf9a575 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
This is a collection of generic enough makefiles.
Please feel free to use them in your project.

Usage:
	Include all.mk from your makefile.

	It is a good idea to include path.mk before you define
	path variables.

	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.