Installing a manual page for configure(1)

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"

doc/configure.xml

@@ -1,27 +1,62 @@
 <?xml version="1.0" encoding="iso-8859-15"?>
 <!-- $Id$ -->
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.5//EN"
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.5//EN"
 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
 	<!ENTITY firstname "Pierre">
 	<!ENTITY surname   "Pronchery">
 	<!ENTITY email     "khorben@defora.org">
+	<!ENTITY section   "1">
 	<!ENTITY package   "configure">
 	<!ENTITY name      "configure">
 	<!ENTITY title     "configure documentation">
 	<!ENTITY purpose   "Generates and maintain software build systems">
 ]>
-<article>
+<refentry>
-	<info>
+	<refentryinfo>
 		<title>&title;</title>
-		<author>
+		<productname>&package;</productname>
-			<firstname>&firstname;</firstname>
+		<authorgroup>
-			<surname>&surname;</surname>
+			<author>
-			<contrib>Code and documentation.</contrib>
+				<firstname>&firstname;</firstname>
-			<address>
+				<surname>&surname;</surname>
-				<email>&email;</email>
+				<contrib>Code and documentation.</contrib>
-			</address>
+				<address>
-		</author>
+					<email>&email;</email>
-	</info>
+				</address>
+			</author>
+		</authorgroup>
+		<copyright>
+			<year>2012</year>
+			<holder>&firstname; &surname; &lt;&email;&gt;</holder>
+		</copyright>
+		<legalnotice>
+			<para>This manual page was written for the DeforaOS project (and may be
+				used by others).</para>
+			<para>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.</para>
+		</legalnotice>
+	</refentryinfo>
+	<refmeta>
+		<refentrytitle>&name;</refentrytitle>
+		<manvolnum>&section;</manvolnum>
+	</refmeta>
+	<refnamediv>
+		<refname>&name;</refname>
+		<refpurpose>&purpose;</refpurpose>
+	</refnamediv>
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>&name;</command>
+			<arg><option>-n</option></arg>
+			<arg><option>-v</option></arg>
+			<arg><option>-S</option></arg>
+			<arg rep="repeat"><option>options</option></arg>
+			<arg rep="repeat">directory</arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+	<refsect1 id="description">
+		<title>Description</title>
 	<para>
 		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.
 	</para>
-	<section>
+</refsect1>
+	<refsect1>
 		<title>Overview</title>
-		<section>
+		<refsect2>
 			<title>What is &package;</title>
 			<para>
 				&package; generates Makefiles needed in an entire project. Instead
@@ -46,8 +82,8 @@
 				and processes such as translations, documentation generation, dynamic
 				bindings...
 			</para>
-		</section>
+		</refsect2>
-		<section>
+		<refsect2>
 			<title>Who should use &package;</title>
 			<para>
 				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.
 			</para>
-		</section>
+		</refsect2>
-		<section>
+		<refsect2>
 			<title>Who should not use &package;</title>
 			<para>
 				&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.
 			</para>
-		</section>
+		</refsect2>
-		<section>
+		<refsect2>
 			<title>Why use &package;</title>
 			<para>
 				&package; was created to be efficient at writing simple and compliant
@@ -83,11 +119,11 @@
 							portability or maintenance of their Makefiles.</para></listitem>
 				</itemizedlist>
 			</para>
-		</section>
+		</refsect2>
-	</section>
+	</refsect1>
-	<section>
+	<refsect1>
 		<title>Using &package;</title>
-		<section>
+		<refsect2>
 			<title>&name; usage</title>
 			<para>
 				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.
 			</para>
-		</section>
+		</refsect2>
-		<section>
+		<refsect2>
 			<title>Migrating to &package;</title>
 			<para>
 				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.
 			</para>
-		</section>
+		</refsect2>
-	</section>
+	</refsect1>
-	<section>
+	<refsect1 id="see_also">
-		<title>Getting further</title>
+		<title>See also</title>
-		<section>
+		<para><citerefentry>
+				<refentrytitle>project.conf</refentrytitle>
+				<manvolnum>5</manvolnum>
+		</citerefentry></para>
+		<refsect2>
 			<title>Additional resources</title>
 			<para>
 				More information can be found on the project page at <ulink
 					url="http://www.defora.org/os/project/16/configure"/>.
 			</para>
-		</section>
+		</refsect2>
-	</section>
+	</refsect1>
-</article>
+</refentry>
 <!-- vim: set noet ts=1 sw=1 sts=1 tw=80: -->

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

doc/project.conf.xml

@@ -181,5 +181,12 @@
 			</refsect3>
 		</refsect2>
 	</refsect1>
+	<refsect1 id="see_also">
+		<title>See also</title>
+		<para><citerefentry>
+				<refentrytitle>configure</refentrytitle>
+				<manvolnum>1</manvolnum>
+		</citerefentry></para>
+	</refsect1>
 </refentry>
 <!-- vim: set noet ts=1 sw=1 sts=1 tw=80: -->