summaryrefslogtreecommitdiff
path: root/docs/docbook
diff options
context:
space:
mode:
authorGerald Carter <jerry@samba.org>2002-09-30 20:18:12 +0000
committerGerald Carter <jerry@samba.org>2002-09-30 20:18:12 +0000
commitd64e0e9772e3fd1b4c5af2ff8fd6aa0b89f0fcb6 (patch)
treefe29485235e3050a4a1236eb8b01646b48ffc593 /docs/docbook
parentae61c575babe9488b190481e8f3a10754c876f06 (diff)
downloadsamba-d64e0e9772e3fd1b4c5af2ff8fd6aa0b89f0fcb6.tar.gz
samba-d64e0e9772e3fd1b4c5af2ff8fd6aa0b89f0fcb6.tar.bz2
samba-d64e0e9772e3fd1b4c5af2ff8fd6aa0b89f0fcb6.zip
* add the Developers guide to the repository
* fix syntax errors in developer's docs * update Makefile.in to place HTML files in htmldocs & text files in textdocs/ (This used to be commit cb96e1a1d9a07314bb60e431484cfd05aef83de6)
Diffstat (limited to 'docs/docbook')
-rw-r--r--docs/docbook/Makefile.in21
-rw-r--r--docs/docbook/devdoc/internals.sgml1
-rw-r--r--docs/docbook/devdoc/parsing.sgml2
3 files changed, 16 insertions, 8 deletions
diff --git a/docs/docbook/Makefile.in b/docs/docbook/Makefile.in
index b225eb9780..98b74e12ee 100644
--- a/docs/docbook/Makefile.in
+++ b/docs/docbook/Makefile.in
@@ -57,13 +57,13 @@ all:
@echo "txt - Build plain text version of HOWTO Collection"
manpages: $(MANPAGES)
-pdf: ../Samba-HOWTO-Collection.pdf
-ps: ../Samba-HOWTO-Collection.ps
-txt: ../Samba-HOWTO-Collection.txt
+pdf: ../Samba-HOWTO-Collection.pdf ../Samba-Developers-Guide.pdf
+ps: ../Samba-HOWTO-Collection.ps ../Samba-Developers-Guide.ps
+txt: ../textdocs/Samba-HOWTO-Collection.txt ../textdocs/Samba-Developers-Guide.txt
htmlman: $(MANPAGES_HTML)
+html-single: ../htmldocs/Samba-HOWTO-Collection.html ../htmldocs/Samba-Developers-Guide.html
html:
$(DOCBOOK2HTML) -d samba.dsl -o $(HTMLDIR) projdoc/samba-doc.sgml
-html-single: ../Samba-HOWTO-Collection.html ../Samba-Developers-Guide.html
../Samba-HOWTO-Collection.txt: $(SGMLDIR)/samba-doc.sgml
$(DOCBOOK2TXT) -o .. $<
@@ -73,14 +73,21 @@ html-single: ../Samba-HOWTO-Collection.html ../Samba-Developers-Guide.html
$(DOCBOOK2PS) -o .. $<
mv ../samba-doc.ps $@
-../Samba-HOWTO-Collection.pdf: ../Samba-HOWTO-Collection.html
+../Samba-Developers-Guide.ps: $(SGMLDIR)/samba-doc.sgml
+ $(DOCBOOK2PS) -o .. $<
+ mv ../samba-doc.ps $@
+
+../Samba-HOWTO-Collection.pdf: ../htmldocs/Samba-HOWTO-Collection.html
+ $(HTMLDOC) --book --color --links -f $@ $<
+
+../Samba-Developers-Guide.pdf: ../htmldocs/Samba-Developers-Guide.html
$(HTMLDOC) --book --color --links -f $@ $<
-../Samba-HOWTO-Collection.html: $(SGMLDIR)/samba-doc.sgml
+../htmldocs/Samba-HOWTO-Collection.html: $(SGMLDIR)/samba-doc.sgml
$(DOCBOOK2HTML) -u -o .. $<
mv ../samba-doc.html $@
-../Samba-Developers-Guide.html: devdoc/dev-doc.sgml
+../htmldocs/Samba-Developers-Guide.html: devdoc/dev-doc.sgml
$(DOCBOOK2HTML) -u -o .. $<
mv ../dev-doc.html $@
diff --git a/docs/docbook/devdoc/internals.sgml b/docs/docbook/devdoc/internals.sgml
index 79524347b6..982cfd2e10 100644
--- a/docs/docbook/devdoc/internals.sgml
+++ b/docs/docbook/devdoc/internals.sgml
@@ -26,6 +26,7 @@ telling if a particular char* is in dos codepage or unix
codepage. This led to a nightmare of code that tried to cope with
particular cases without handlingt the general case.
</para>
+</sect1>
<sect1>
<title>The new functions</title>
diff --git a/docs/docbook/devdoc/parsing.sgml b/docs/docbook/devdoc/parsing.sgml
index 0121935d26..8d929617f5 100644
--- a/docs/docbook/devdoc/parsing.sgml
+++ b/docs/docbook/devdoc/parsing.sgml
@@ -196,7 +196,7 @@ terminating character, and the rest of the line is ignored. The lines
&lt;section&gt; :== &lt;section header&gt; { &lt;parameter line&gt; }
&lt;section header&gt; :== '[' NAME ']'
&lt;parameter line&gt; :== NAME '=' VALUE NL
-</programlisting><para>
+</programlisting></para>
<para>Basically, this means that</para>