diff --git a/doc/Makefile b/doc/Makefile index bae7e6f..94c8866 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -1,5 +1,5 @@ SUBDIRS = scripts -TARGETS = configure.html project.conf.5 project.conf.html +TARGETS = configure.1 configure.html project.conf.5 project.conf.html PREFIX = /usr/local DESTDIR = RM ?= rm -f @@ -13,6 +13,9 @@ all: subdirs $(TARGETS) subdirs: @for i in $(SUBDIRS); do (cd $$i && $(MAKE)) || exit; done +configure.1: configure.xml + ./docbook.sh -P "$(PREFIX)" -- "configure.1" + configure.html: configure.xml ./docbook.sh -P "$(PREFIX)" -- "configure.html" @@ -24,21 +27,23 @@ project.conf.html: project.conf.xml clean: @for i in $(SUBDIRS); do (cd $$i && $(MAKE) clean) || exit; done - $(RM) -- $(configure.html_OBJS) $(project.conf.5_OBJS) $(project.conf.html_OBJS) + $(RM) -- $(configure.1_OBJS) $(configure.html_OBJS) $(project.conf.5_OBJS) $(project.conf.html_OBJS) distclean: @for i in $(SUBDIRS); do (cd $$i && $(MAKE) distclean) || exit; done - $(RM) -- $(configure.html_OBJS) $(project.conf.5_OBJS) $(project.conf.html_OBJS) + $(RM) -- $(configure.1_OBJS) $(configure.html_OBJS) $(project.conf.5_OBJS) $(project.conf.html_OBJS) $(RM) -- $(TARGETS) install: $(TARGETS) @for i in $(SUBDIRS); do (cd $$i && $(MAKE) install) || exit; done + ./docbook.sh -P "$(DESTDIR)$(PREFIX)" -i -- "configure.1" ./docbook.sh -P "$(DESTDIR)$(PREFIX)" -i -- "configure.html" ./docbook.sh -P "$(DESTDIR)$(PREFIX)" -i -- "project.conf.5" ./docbook.sh -P "$(DESTDIR)$(PREFIX)" -i -- "project.conf.html" uninstall: @for i in $(SUBDIRS); do (cd $$i && $(MAKE) uninstall) || exit; done + ./docbook.sh -P "$(DESTDIR)$(PREFIX)" -u -- "configure.1" ./docbook.sh -P "$(DESTDIR)$(PREFIX)" -u -- "configure.html" ./docbook.sh -P "$(DESTDIR)$(PREFIX)" -u -- "project.conf.5" ./docbook.sh -P "$(DESTDIR)$(PREFIX)" -u -- "project.conf.html" diff --git a/doc/configure.xml b/doc/configure.xml index a4a1444..22278b1 100644 --- a/doc/configure.xml +++ b/doc/configure.xml @@ -1,27 +1,62 @@ - + ]> -
- + + &title; - - &firstname; - &surname; - Code and documentation. -
- &email; -
-
-
+ &package; + + + &firstname; + &surname; + Code and documentation. +
+ &email; +
+
+
+ + 2012 + &firstname; &surname; <&email;> + + + This manual page was written for the DeforaOS project (and may be + used by others). + Permission is granted to copy, distribute and/or modify this + document under the terms of the GNU General Public License, + Version 3 as published by the Free Software Foundation. + + + + &name; + §ion; + + + &name; + &purpose; + + + + &name; + + + + + directory + + + + Description These are the documentation notes for &package;. The &package; project generates and maintain software build systems, suitable for use with the most @@ -29,9 +64,10 @@ to provide simple Makefiles. It is intended to keep the code generated as simple and portable as possible. -
+ + Overview -
+ What is &package; &package; generates Makefiles needed in an entire project. Instead @@ -46,8 +82,8 @@ and processes such as translations, documentation generation, dynamic bindings... -
-
+ + Who should use &package; Some software developers could gain using &package;. However, due to its @@ -58,8 +94,8 @@ Advanced users willing to modify the build process of projects using &package; may have to learn about &package; as well. -
-
+ + Who should not use &package; &package; was primarily designed for projects using the C or C++ @@ -67,8 +103,8 @@ &package; may not be appropriate for other languages or complex build processes. -
-
+ + Why use &package; &package; was created to be efficient at writing simple and compliant @@ -83,11 +119,11 @@ portability or maintenance of their Makefiles. -
-
-
+ + + Using &package; -
+ &name; usage The &name; utility may be invoked from the command line this way: @@ -114,8 +150,8 @@ It then processes the current directory, or the ones given at the command line, according to the project configuration files encountered. -
-
+ + Migrating to &package; You may first create all necessary "project.conf" files with the @@ -128,17 +164,21 @@ targets are defined in the same file, as the "bin_PROGRAMS" variable, each declined to "program_SOURCES" for their respective source files. -
-
-
- Getting further -
+ + + + See also + + project.conf + 5 + + Additional resources More information can be found on the project page at . -
-
-
+ + + diff --git a/doc/project.conf b/doc/project.conf index 3d0eb8f..807d4b2 100644 --- a/doc/project.conf +++ b/doc/project.conf @@ -1,7 +1,13 @@ subdirs=scripts -targets=configure.html,project.conf.5,project.conf.html +targets=configure.1,configure.html,project.conf.5,project.conf.html dist=Makefile,docbook.sh,configure.xml,project.conf.xml +[configure.1] +type=script +script=./docbook.sh +install= +depends=configure.xml + [configure.html] type=script script=./docbook.sh diff --git a/doc/project.conf.xml b/doc/project.conf.xml index 1453ec7..dc219fc 100644 --- a/doc/project.conf.xml +++ b/doc/project.conf.xml @@ -181,5 +181,12 @@ + + See also + + configure + 1 + +