generalize the genmanpages code to be more flexible.

git-svn-id: http://emdebian.org/svn/current@6616 563faec7-e20c-0410-992a-a66f704d0ccd

debian/emdebian-rootfs.install

@@ -9,10 +9,7 @@ emdebian.gtk ./usr/share/emdebian-tools/
 emdebian.grip ./usr/share/emdebian-tools/
 emdebian.gpe ./usr/share/emdebian-tools/
 emdebian.coreutils ./usr/share/emdebian-tools/
-doc/man/man1/emsandbox.1 ./usr/share/man/man1/
+doc/emdebian-rootfs/man/* ./usr/share/man/
-doc/man/pt/man1/emsandbox.1 ./usr/share/man/pt/man1/
-doc/man/man3/* ./usr/share/man/man3/
-doc/man/pt/man3/* ./usr/share/man/pt/man3/
 examples/packages.conf ./usr/share/doc/emdebian-rootfs/examples/
 examples/setup.sh ./usr/share/doc/emdebian-rootfs/examples/
 examples/config.sh ./usr/share/doc/emdebian-rootfs/examples/

debian/multistrap.install

@@ -1,5 +1,4 @@
 em_multistrap ./usr/sbin/
 multistrap ./usr/sbin/
-doc/man/man1/em_multistrap.1 ./usr/share/man/man1/
+doc/multistrap/man/* ./usr/share/man/
-doc/man/pt/man1/em_multistrap.1 ./usr/share/man/pt/man1/
 bash/multistrap ./etc/bash_completion.d/

debian/rules

@@ -11,6 +11,5 @@ install/emdebian-rootfs::
 	po4a --rm-backups doc/po4a.config
 
 clean::
-#	debconf-updatepo
+	rm -rf doc/emdebian-rootfs doc/multistrap
-	rm -rf doc/man/man1 doc/man/man3
 	rm -rf pod2htmd.tmp pod2htmi.tmp

doc/genmanpages

@@ -16,6 +16,33 @@ set -e
 #  You should have received a copy of the GNU General Public License
 #  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
+# name and location of the config file
+# relative to the top level source directory of the translations
+# i.e. the directory containing ./po/
+CONFIG="doc/po4a.config"
+# POTFILE path
+POTFILE="po/emdebian-rootfs.pot"
+# the binary packages that will contain generated manpages
+BINARIES="emdebian-rootfs multistrap"
+# the binary packages with manpages in Section 3.
+HASMAN3="emdebian-rootfs"
+# the binary packages using DocBook XML & xsltproc
+XMLPACKAGES="emdebian-rootfs"
+# the DocBook XML files (TODO: let this take paths)
+XMLFILE="emdebian-rootfs.1.xml"
+# the XSL file to use for Docbook XSL
+XSLFILE="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"
+# the POD files (TODO: let this take paths)
+PODFILE="em_multistrap"
+# the binary packages using POD
+PODPACKAGES="multistrap"
+
+# remember to add something to the clean:: rule in debian/rules
+# to remove each binary package sub-directory.
+# $(RM) -r doc/emdebian-rootfs doc/multistrap
+
+# below this point, no changes should be needed.
+
 wrap_langs () {
 	if [ -z "$LANGS" ]; then
 		echo "$1 $2" >> $CONFIG
@@ -30,7 +57,7 @@ fi
 if [ -f ../po4a.config ]; then
 	cd ../../
 fi
-CONFIG="doc/po4a.config"
+
 # calculate the langs, automatically.
 LANGS=`ls po/*.po 2>/dev/null || true`
 if [ ! -z "$LANGS" ]; then
@@ -45,74 +72,73 @@ if [ ! -z "$LANGS" ]; then
 	else
 	echo > $CONFIG
 fi
-wrap_langs "[po4a_paths]" "po/emdebian-rootfs.pot" "\$lang:po/\$lang.po"
+wrap_langs "[po4a_paths]" "$POTFILE" "\$lang:po/\$lang.po"
-# need to determine directory for the target package.
-# rootfs only has empbuilderlib.3, emrootfslib.3 and emsandbox.1
 
-for l in $LANGS; do
+for d in $BINARIES; do
-	mkdir -p doc/html/$l/
+	for l in $LANGS; do
-	mkdir -p doc/man/$l/man1/
+		mkdir -p doc/$d/man/$l/man1/
-	mkdir -p doc/man/$l/man3/
+		if [ "$d" = "$HASMAN3" ]; then
+			mkdir -p doc/$d/man/$l/man3/
+		fi
+	done
+	mkdir -p doc/$d/man/man1/
+	if [ "$d" = "$HASMAN3" ]; then
+		mkdir -p doc/$d/man/man3/
+	fi
 	mkdir -p doc/pod/$l/
 done
-
 mkdir -p doc/html/
-mkdir -p doc/man/man3/
-mkdir -p doc/man/man1/
 
-echo "Checking emrootfslib for POSIX compatibility"
-# doesn't expect a shell library, hence nuisance message
-# about interpreter that just needs to be ignored.
-checkbashisms emrootfslib
-echo "Processing Docbook XML . . . "
 for file in `ls doc/xml/*.xml`; do
 	xmllint --format "$file" --output "$file"
 	LOCAL=`basename $file`
 	wrap_langs "[type:docbook]" "$file" "\$lang:doc/xml/\$lang/$LOCAL"
 done
-echo "Processing POD . . ."
-
-# rootfs
 for file in em_multistrap; do
-	pod2html -outfile doc/html/$file.html -title $file < $file
-	pod2man $file > doc/man/man1/$file.1
 	wrap_langs "[type: pod]" "$file" "\$lang:doc/pod/\$lang/$file"
 done
 
-echo "Refreshing POT file for translators"
 # use -k to create all XML even if untranslated or the XSL breaks the build.
 po4a -k 0 $CONFIG
 
-# just make sure the XML catalog is available for XSL.
+for d in $BINARIES; do
-# never go to the internet for build config, use --nonet.
+	for P in $XMLPACKAGES; do
-XML_CATALOG_FILES="/etc/xml/catalog" \
+		for X in $XMLFILE; do
-xsltproc -o doc/man/ --nonet \
+			XML_CATALOG_FILES="/etc/xml/catalog" \
-	http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl \
+			xsltproc -o doc/man/ --nonet $XSLFILE doc/xml/$X
-	doc/xml/emdebian-rootfs.1.xml
+		done
-mv doc/man/empbuilderlib.3 doc/man/man3/empbuilderlib.3
+		if [ "$d" = "$HASMAN3" ]; then
-mv doc/man/emrootfslib.3 doc/man/man3/emrootfslib.3
+			mv doc/man/*.3 doc/$d/man/man3/
-mv doc/man/emsandbox.1 doc/man/man1/emsandbox.1
+		fi
-#mv doc/man/*.1 doc/man/man1/
+		mv doc/man/*.1 doc/$d/man/man1/
-#mv doc/man/*.3 doc/man/man3/
+	done
-
+	for POD in $PODPACKAGES; do
-for l in $LANGS; do
+		pod2man $POD > doc/$d/man/man1/$POD.1
-	mkdir -p doc/man/$l/man3/
+	done
-	mkdir -p doc/man/$l/man1/
+	for l in $LANGS; do
-	XML_CATALOG_FILES="/etc/xml/catalog" \
+		for P in $XMLPACKAGES; do
-	xsltproc -o doc/man/ --nonet \
+			for X in $XMLFILE; do
-		http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl \
+				XML_CATALOG_FILES="/etc/xml/catalog" \
-		doc/xml/$l/emdebian-rootfs.1.xml
+				xsltproc -o doc/man/ --nonet $XSLFILE doc/xml/$l/$X
-	mv doc/man/*.3 doc/man/$l/man3/
+			done
-	mv doc/man/*.1 doc/man/$l/man1/
+			if [ "$d" = "$HASMAN3" ]; then
-	pod2man doc/pod/$l/em_multistrap > doc/man/$l/man1/em_multistrap.1
+				mv doc/man/*.3 doc/$d/man/$l/man3/
-	xsltproc -o doc/html/$l/ --nonet \
+			fi
-		http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl \
+			mv doc/man/*.1 doc/$d/man/$l/man1/
-		doc/xml/$l/emdebian-rootfs.1.xml
+		done
-	pod2html -outfile doc/html/$l/em_multistrap.html -title em_multistrap < doc/pod/$l/em_multistrap
+		for POD in $PODPACKAGES; do
-	rm -rf xml/$lang
+			pod2man doc/pod/$l/$PODFILE > doc/$d/man/$l/man1/$POD.1
+		done
+	done
 done
+for l in $LANGS; do
+	rm -rf doc/xml/$l
+done
+rm -rf doc/pod/
 
-# never go to the internet for build config, use -nonet.
+# the rest is specific to emdebian-rootfs - ignore.
+
+# HTML versions, not packaged.
 xsltproc -o doc/html/ --nonet \
 	http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl \
 	doc/xml/emdebian-rootfs.1.xml
@@ -122,6 +148,3 @@ for i in `ls doc/html/*.html`; do
 	sed < doc/html/tmp > $i -e 's:charset=ISO-8859-1:charset=UTF-8:'
 done
 rm -f doc/html/tmp
-rm -f pod2htmd.tmp
-rm -f pod2htmi.tmp
-rm -rf doc/pod/