diff options
author | Gerald Carter <jerry@samba.org> | 2003-10-10 16:46:22 +0000 |
---|---|---|
committer | Gerald Carter <jerry@samba.org> | 2003-10-10 16:46:22 +0000 |
commit | fec4b31bc1a76e408732e1a80b366d97fcf38143 (patch) | |
tree | e23398c2bcc4e3b2da28c8007ca453228aefb44f /docs/docbook/docbook.txt | |
parent | 20c7b998a38424e8e7b4d218f923937b9e8862d4 (diff) | |
download | samba-fec4b31bc1a76e408732e1a80b366d97fcf38143.tar.gz samba-fec4b31bc1a76e408732e1a80b366d97fcf38143.tar.bz2 samba-fec4b31bc1a76e408732e1a80b366d97fcf38143.zip |
removing docs tree from 3.0
(This used to be commit 0a3eb5574c91685ab07436c67b031266fb329693)
Diffstat (limited to 'docs/docbook/docbook.txt')
-rw-r--r-- | docs/docbook/docbook.txt | 74 |
1 files changed, 0 insertions, 74 deletions
diff --git a/docs/docbook/docbook.txt b/docs/docbook/docbook.txt deleted file mode 100644 index dfce2fd61b..0000000000 --- a/docs/docbook/docbook.txt +++ /dev/null @@ -1,74 +0,0 @@ -!== -!== docbook.txt for Samba 3.0 -!== -!== Author: David Bannon, D.Bannon@latrobe.edu.au November, 2000 -!== Updates: Gerald (Jerry) Carter, jerry@samba.org, Feb. 2001 -!== Updates: Jelmer Vernooij, jelmer@samba.org, Aug, 2002 -!== Updates: Jelmer Vernooij, jelmer@samba.org, Jun, 2003 - -What are DocBook documents doing in the Samba Distribution ? ------------------------------------------------------------ - -We have converted all samba docs to XML/DocBook V4.2 -in order to make them easier to maintain and produce a nicer looking -product. - -This short note (strange isn't it how it always starts out as a short note -and becomes a long one ?) will explain very briefly how and why we have -done this. - - -The format ----------- -If you are new to xml, regard an xml file as 'source code'. You don't -read it directly, but use it to create other formats (like the txt and html -included in ../txtdocs and ../htmldocs). - -Docbook is a particular XML style, particularly suited to producing -technical manuals. - -For more information on DocBook tags and format, see "DocBook: The -Definitive Guide" by Walsh and Muellner, (c) O'Reilly Publishing. -This book covers DocBook V4.2 and is available on-line -at http://www.docbook.org/ - -The Output ----------- -The current Samba CVS tree contains the XML/DocBook source files as well -as the following autogenerated formats: - - * man pages - * HTML - * PDF - -The following formats are not available in CVS but can be generated by -the build scripts: - - * PostScript - * DVI - * LaTeX - * ASCII text - -The Tools ---------- - -To generate the docs, you need to have the following packages installed: - - * docbook-utils - * xsltproc - * pngtopnm and pnmtops (from the netpbm utilities) - -For generating PDF (thru LaTeX): - * pdflatex - -For generating PostScript (thru LaTeX): - * latex - * dvips - -For generating ASCII: - * xmlto - -This directory now contains a ./configure script and Makefile to -support the automated building of man pages (including HTML versions), and -the building of the Samba-HOWTO-Collection and the -Samba Developers Guide (HTML,DVI,TeX,PDF,PS,Text versions). |