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
+
+