[Pbuilder-maint] pbuilder CVS update: pbuilder/Documentation
pbuilder-doc.xml debian-latex.xsl Makefile .cvsignore
pbuilder CVS Commit
pbuilder-maint at lists.alioth.debian.org
Tue Mar 7 17:46:30 UTC 2006
User: dancer
Date: 06/03/07 17:46:30
Modified: Documentation pbuilder-doc.xml Makefile .cvsignore
Added: Documentation debian-latex.xsl
Log:
documentation update, and add hooks to generate PDF documentation for pbuilder.
Revision Changes Path
1.66 +9 -4 pbuilder/Documentation/pbuilder-doc.xml
CVSWEB Options: -------------------
CVSWeb: Annotate this file: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/pbuilder-doc.xml?annotate=1.66&cvsroot=
CVSWeb: View this file: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/pbuilder-doc.xml?rev=1.66&content-type=text/x-cvsweb-markup&cvsroot=
CVSWeb: Diff to previous version: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/pbuilder-doc.xml.diff?r1=1.66&r2=1.65&cvsroot=
-----------------------------------
Index: pbuilder-doc.xml
===================================================================
RCS file: /cvsroot/pbuilder/pbuilder/Documentation/pbuilder-doc.xml,v
retrieving revision 1.65
retrieving revision 1.66
diff -u -r1.65 -r1.66
--- pbuilder-doc.xml 13 Jan 2006 12:13:06 -0000 1.65
+++ pbuilder-doc.xml 7 Mar 2006 17:46:30 -0000 1.66
@@ -2,9 +2,9 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "/usr/share/sgml/docbook/dtd/xml/4.2/docbookx.dtd">
<!-- the original of this documentation is in pbuilder source tar-ball,
and the latest version is found in CVS repository. -->
-<book>
+<book xml:lang="en">
<bookinfo>
- <date>2005-11-03</date>
+ <date>2006-3-8</date>
<title>pbuilder User's Manual</title>
<abbrev>pbuilder-doc</abbrev>
<subtitle>Usage and operations</subtitle>
@@ -16,6 +16,7 @@
</author>
</authorgroup>
</bookinfo>
+
<!-- FIXME: consistent markup of commands, files, and variables -->
<chapter>
<title>Introducing pbuilder</title>
@@ -1038,7 +1039,7 @@
</para>
<para>
<screen>
-<command>pbuilder create --distribution sid --debootstrapopts "--arch=i386" --basetgz /var/cache/pbuilder/base-i386.tgz --mirror http://ftp.jp.debian.org/debian</command>
+<command>pbuilder create --distribution sid --debootstrapopts --arch --debootstrapopts i386 --basetgz /var/cache/pbuilder/base-i386.tgz --mirror http://ftp.jp.debian.org/debian</command>
<command>linux32 pbuilder build --basetgz /var/cache/pbuilder/base-i386.tgz</command>
</screen>
</para>
@@ -1245,6 +1246,8 @@
<table>
<title>Directory Structure outside the chroot </title>
<tgroup cols="2">
+ <colspec colnum="1" colname="c1" colwidth="1*" align="left" />
+ <colspec colnum="2" colname="c2" colwidth="1*" align="left" />
<thead>
<row>
<entry>Directory</entry>
@@ -1307,6 +1310,8 @@
<table>
<title>Directory Structure inside the chroot </title>
<tgroup cols="2">
+ <colspec colnum="1" colname="c1" colwidth="1*" align="left" />
+ <colspec colnum="2" colname="c2" colwidth="1*" align="left" />
<thead>
<row>
<entry>Directory</entry>
1.7 +16 -3 pbuilder/Documentation/Makefile
CVSWEB Options: -------------------
CVSWeb: Annotate this file: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/Makefile?annotate=1.7&cvsroot=
CVSWeb: View this file: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/Makefile?rev=1.7&content-type=text/x-cvsweb-markup&cvsroot=
CVSWeb: Diff to previous version: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/Makefile.diff?r1=1.7&r2=1.6&cvsroot=
-----------------------------------
Index: Makefile
===================================================================
RCS file: /cvsroot/pbuilder/pbuilder/Documentation/Makefile,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- Makefile 13 Jan 2006 12:02:14 -0000 1.6
+++ Makefile 7 Mar 2006 17:46:30 -0000 1.7
@@ -11,6 +11,15 @@
xsltproc pbuilder-doc.xsl $< > $@.tmp
mv $@.tmp $@
+%.tex: %.xml debian-latex.xsl
+ ## requires db2latex-xsl and xsltproc package.
+ xsltproc --nonet --novalid --xinclude debian-latex.xsl $< > $@.tmp
+ mv $@.tmp $@
+
+%.pdf: %.tex
+ pdflatex $<
+ pdflatex $<
+
install: pbuilder-doc.html
install -d -m 755 -o root -g root $(DESTDIR)/usr/share/doc/pbuilder/
install -m 644 -o root -g root pbuilder-doc.html $(DESTDIR)/usr/share/doc/pbuilder/
@@ -18,12 +27,16 @@
preview: pbuilder-doc.html
mozilla-firefox -remote "openfile($(PWD)/$<)"
-release: pbuilder-doc.html pbuilder-doc.xml pbuilder-doc.css pbuilder-doc.xsl
+release: pbuilder-doc.html pbuilder-doc.xml pbuilder-doc.css pbuilder-doc.xsl pbuilder-doc.pdf
scp $^ cvs.alioth.debian.org:/org/alioth.debian.org/chroot/home/groups/pbuilder/htdocs/
+ $(MAKE) release-netfort
# for my homepage-publishing.
-release-netfort: pbuilder-doc.html pbuilder-doc.xml pbuilder-doc.css pbuilder-doc.xsl
+release-netfort: pbuilder-doc.html pbuilder-doc.xml pbuilder-doc.css pbuilder-doc.xsl pbuilder-doc.pdf
cp $^ ~/public_html/netfort/software/pbuilder-doc/
+clean:
+ -rm pbuilder-doc.pdf pbuilder-doc.glo pbuilder-doc.idx pbuilder-doc.log pbuilder-doc.out
+
-.PHONY: preview release-netfort release
\ No newline at end of file
+.PHONY: preview release-netfort release clean
\ No newline at end of file
1.2 +6 -0 pbuilder/Documentation/.cvsignore
CVSWEB Options: -------------------
CVSWeb: Annotate this file: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/.cvsignore?annotate=1.2&cvsroot=
CVSWeb: View this file: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/.cvsignore?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=
CVSWeb: Diff to previous version: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/.cvsignore.diff?r1=1.2&r2=1.1&cvsroot=
-----------------------------------
Index: .cvsignore
===================================================================
RCS file: /cvsroot/pbuilder/pbuilder/Documentation/.cvsignore,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- .cvsignore 30 Dec 2002 16:05:25 -0000 1.1
+++ .cvsignore 7 Mar 2006 17:46:30 -0000 1.2
@@ -1 +1,7 @@
+pbuilder-doc.aux
+pbuilder-doc.glo
pbuilder-doc.html
+pbuilder-doc.idx
+pbuilder-doc.log
+pbuilder-doc.out
+pbuilder-doc.pdf
1.1 pbuilder/Documentation/debian-latex.xsl
CVSWEB Options: -------------------
CVSWeb: Annotate this file: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/debian-latex.xsl?annotate=1.1&cvsroot=
CVSWeb: View this file: http://cvs.alioth.debian.org/cgi-bin/cvsweb.cgi/pbuilder/pbuilder/Documentation/debian-latex.xsl?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=
-----------------------------------
Index: debian-latex.xsl
===================================================================
<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:import href="http://db2latex.sourceforge.net/xsl/docbook.xsl"/>
<!-- xsl:import
href="/usr/share/sgml/docbook/stylesheet/xsl/db2latex/latex/docbook.xsl"/ -->
<xsl:param name="admon.graphics.path">/usr/share/xml/docbook/stylesheet/db2latex/latex/figures</xsl:param>
<xsl:param name="latex.document.font">default</xsl:param>
<xsl:param name="latex.documentclass.article">10pt,a4paper,onecolumn,twoside</xsl:param>
<xsl:param name="latex.graphics.formats">PDF</xsl:param>
<xsl:param name="latex.hyperref.param.dvips">1</xsl:param>
<xsl:param name="latex.inputenc">latin1</xsl:param> <!-- this doesn't look correct, but anyway -->
<xsl:param name="latex.pdf.support">1</xsl:param>
<xsl:param name="latex.use.fancybox">1</xsl:param>
<xsl:param name="latex.use.fancyhdr">1</xsl:param>
<xsl:param name="latex.use.fancyvrb">1</xsl:param>
<xsl:param name="latex.use.hyperref">1</xsl:param>
<xsl:param name="latex.use.parskip">1</xsl:param>
<xsl:param name="latex.use.tabularx">1</xsl:param>
<xsl:variable name="latex.hyperref.param.pdftex">
pdfauthor={<xsl:value-of
select="/book/bookinfo/editor/firstname"/> <xsl:value-of
select="/book/bookinfo/editor/surname"/>},
pdfpagemode=UseNone,
pdftitle={<xsl:value-of select="/book/bookinfo/title"/>},
pdfpagelabels,
pdfsubject={<xsl:value-of select="/book/bookinfo/subtitle"/>},
pdfkeywords={<xsl:call-template name="keyword-list"/>},
pdfcreator={DocBook/XML db2latex-xsl},
pdfstartview=FitH
</xsl:variable>
<xsl:variable name="latex.book.preamble.post">
<xsl:text>
\pagestyle{fancy}
\rhead[\leftmark]{}
\lhead[]{\rightmark}
\sloppy
</xsl:text>
</xsl:variable>
<xsl:template name="keyword-list">
<xsl:for-each select="/book/bookinfo/keywordset/keyword">
<xsl:value-of select="."/>
<xsl:if test="position()!=last()">
<xsl:text>, </xsl:text>
</xsl:if>
</xsl:for-each>
</xsl:template>
<!-- I'm probably missing something here, I don't know why -->
<xsl:template name="debian">
\begin{center}
\includegraphics[height=2cm]{openlogo-nd.pdf} \\
\texttt{http://www.debian.org/}
\end{center}
</xsl:template>
<xsl:template match="book/title">
</xsl:template>
<xsl:template match="book/bookinfo"
mode="standalone.book">
<xsl:call-template name="debian"/>
<xsl:apply-templates select="keywordset" />
<xsl:apply-templates select="legalnotice" />
<xsl:apply-templates select="abstract"/>
</xsl:template>
</xsl:stylesheet>
More information about the Pbuilder-maint
mailing list