Infrastructure for autotools-based packages
-------------------------------------------
-[[autotargets-tutorial]]
+[[autotools-package-tutorial]]
+autotools-package+ tutorial
~~~~~~~~~~~~~~~~~~~~~~
macro that generates all the Makefile rules that actually allows the
package to be built.
-[[autotargets-reference]]
+[[autotools-package-reference]]
+autotools-package+ reference
~~~~~~~~~~~~~~~~~~~~~~~
Infrastructure for CMake-based packages
---------------------------------------
-[[cmaketargets-tutorial]]
+[[cmake-package-tutorial]]
+cmake-package+ tutorial
~~~~~~~~~~~~~~~~~~~~~~~
macro that generates all the Makefile rules that actually allows the
package to be built.
-[[cmaketargets-reference]]
+[[cmake-package-reference]]
+cmake-package+ reference
~~~~~~~~~~~~~~~~~~~~~~~~
infrastructure must be used for all packages that do not use the
autotools as their build system. In the future, other specialized
infrastructures might be written for other build systems. We cover
- them through in a xref:gentargets-tutorial[tutorial] and a
- xref:gentargets-reference[reference].
+ them through in a xref:generic-package-tutorial[tutorial] and a
+ xref:generic-package-reference[reference].
* *Makefiles for autotools-based software* (autoconf, automake, etc.):
We provide a dedicated infrastructure for such packages, since
autotools is a very common build system. This infrastructure 'must'
be used for new packages that rely on the autotools as their build
- system. We cover them through a xref:autotargets-tutorial[tutorial]
- and xref:autotargets-reference[reference].
+ system. We cover them through a xref:autotools-package-tutorial[tutorial]
+ and xref:autotools-package-reference[reference].
* *Makefiles for cmake-based software*: We provide a dedicated
infrastructure for such packages, as CMake is a more and more
commonly used build system and has a standardized behaviour. This
infrastructure 'must' be used for new packages that rely on
- CMake. We cover them through a xref:cmaketargets-tutorial[tutorial]
- and xref:cmaketargets-reference[reference].
+ CMake. We cover them through a xref:cmake-package-tutorial[tutorial]
+ and xref:cmake-package-reference[reference].
* *Hand-written Makefiles:* These are currently obsolete, and no new
manual Makefiles should be added. However, since there are still
'autotools' or 'CMake'. This typically includes packages whose build
system is based on hand-written Makefiles or shell scripts.
-[[gentargets-tutorial]]
+[[generic-package-tutorial]]
+generic-package+ Tutorial
~~~~~~~~~~~~~~~~~~~~~
generates, according to the variables defined previously, all the
Makefile code necessary to make your package working.
-[[gentargets-reference]]
+[[generic-package-reference]]
+generic-package+ Reference
~~~~~~~~~~~~~~~~~~~~~~
include::adding-packages-directory.txt[]
-include::adding-packages-gentargets.txt[]
+include::adding-packages-generic.txt[]
-include::adding-packages-autotargets.txt[]
+include::adding-packages-autotools.txt[]
-include::adding-packages-cmaketargets.txt[]
+include::adding-packages-cmake.txt[]
include::adding-packages-handwritten.txt[]
include package/pkg-utils.mk
include package/pkg-download.mk
-include package/pkg-autotargets.mk
-include package/pkg-cmaketargets.mk
-include package/pkg-gentargets.mk
+include package/pkg-autotools.mk
+include package/pkg-cmake.mk
+include package/pkg-generic.mk