@echo " samples - Extract examples"
@echo " files - Extract other files"
-$(DOCBOOKDIR)/Samba-Guide.xml: $(filter-out Samba-Guide/index.xml,$(wildcard Samba-Guide/*.xml))
-$(DOCBOOKDIR)/Samba-HOWTO-Collection.xml: $(filter-out Samba-HOWTO-Collection/index.xml,$(wildcard Samba-HOWTO-Collection/*.xml)) Samba-HOWTO-Collection-attributions.xml
-Samba-HOWTO-Collection/manpages.xml: $(MANPAGEDIR3)/smb.conf.5.xml
+$(DOCBOOKDIR)/Samba3-ByExample.xml: $(filter-out Samba3-ByExample/index.xml,$(wildcard Samba3-ByExample/*.xml))
+$(DOCBOOKDIR)/Samba3-HOWTO.xml: $(filter-out Samba3-HOWTO/index.xml,$(wildcard Samba3-HOWTO/*.xml)) Samba3-HOWTO-attributions.xml
+Samba3-HOWTO/manpages.xml: $(MANPAGEDIR3)/smb.conf.5.xml
$(DOCBOOKDIR)/Samba3-Developers-Guide.xml: $(filter-out Samba3-Developers-Guide/index.xml,$(wildcard Samba3-Developers-Guide/*.xml)) Samba3-Developers-Guide-attributions.xml
$(DOCBOOKDIR)/Samba4-HOWTO.xml: $(filter-out Samba4-HOWTO/index.xml,$(wildcard Samba4-HOWTO/*.xml)) Samba4-HOWTO-attributions.xml
texiinfo: $(patsubst %,$(TEXINFODIR)/%.info,$(MAIN_DOCS))
manpages3: $(patsubst $(MANPAGEDIR3)/%.xml,$(OUTPUTDIR)/manpages-3/%,$(MANPAGES3))
manpages4: $(patsubst $(MANPAGEDIR4)/%.xml,$(OUTPUTDIR)/manpages-4/%,$(MANPAGES4))
-pearson: $(PEARSONDIR)/Samba-HOWTO-Collection.xml
-pearson-verify: $(PEARSONDIR)/Samba-HOWTO-Collection.report.html
+pearson: $(PEARSONDIR)/Samba3-HOWTO.xml
+pearson-verify: $(PEARSONDIR)/Samba3-HOWTO.report.html
plucker: $(patsubst %,$(PLUCKERDIR)/%.pdb,$(MAIN_DOCS))
htmlman3: $(patsubst $(MANPAGEDIR3)/%.xml,$(HTMLDIR)/manpages-3/%.html,$(MANPAGES3)) $(HTMLDIR)/manpages-3/index.html
htmlman4: $(patsubst $(MANPAGEDIR4)/%.xml,$(HTMLDIR)/manpages-4/%.html,$(MANPAGES4)) $(HTMLDIR)/manpages-4/index.html
@$(PERL) scripts/find_missing_manpages.pl $(SRCDIR)
# Examples and the like
-files: Samba-HOWTO-Collection/index.xml xslt/extract-smbfiles.xsl
+files: Samba3-HOWTO/index.xml xslt/extract-smbfiles.xsl
$(XSLTPROC) xslt/extract-smbfiles.xsl $< > /dev/null
-samples: $(DOCBOOKDIR)/Samba-HOWTO-Collection.xml xslt/extract-examples.xsl scripts/indent-smb.conf.pl
+samples: $(DOCBOOKDIR)/Samba3-HOWTO.xml xslt/extract-examples.xsl scripts/indent-smb.conf.pl
mkdir -p $(EXAMPLESDIR)
$(XSLTPROC) --xinclude xslt/extract-examples.xsl $< > /dev/null 2> examples/README
for I in examples/*.conf; do { ./scripts/indent-smb.conf.pl < $$I > $$I.tmp; mv $$I.tmp $$I; } done
# Archiving
archive: pdf
mkdir -p $(ARCHIVEDIR)
- cp $(PDFDIR)/Samba-HOWTO-Collection.pdf $(ARCHIVEDIR)/TOSHARG-$(DATETIME).pdf
- cp $(PDFDIR)/Samba-Guide.pdf $(ARCHIVEDIR)/S3bE-$(DATETIME).pdf
+ cp $(PDFDIR)/Samba3-HOWTO.pdf $(ARCHIVEDIR)/TOSHARG-$(DATETIME).pdf
+ cp $(PDFDIR)/Samba3-ByExample.pdf $(ARCHIVEDIR)/S3bE-$(DATETIME).pdf
# XSL scripts
xslt/html.xsl: xslt/html-common.xsl settings.xsl
<command>groupdel</command>, and <command>groupmod</command>), the resulting UNIX/Linux group names will be subject
to any limits imposed by these tools. If the tool does not allow upper case characters
or space characters, then the creation of an MS Windows NT4/200x style group of
- <ntgroup>Engineering Managers</ntgroup> will attempt to create an identically named
+ <literal>Engineering Managers</literal> will attempt to create an identically named
UNIX/Linux group, an attempt that will of course fail.
</para>
<title>Script to Configure Group Mapping</title>
<para>
- In our example we have created a UNIX/Linux group called <ntgroup>ntadmin</ntgroup>.
- Our script will create the additional groups <ntgroup>Orks</ntgroup>, <ntgroup>Elves</ntgroup>, and <ntgroup>Gnomes</ntgroup>.
+ In our example we have created a UNIX/Linux group called <literal>ntadmin</literal>.
+ Our script will create the additional groups <literal>Orks</literal>, <literal>Elves</literal>, and <literal>Gnomes</literal>.
It is a good idea to save this shell script for later re-use just in case you ever need to rebuild your mapping database.
For the sake of convenience we elect to save this script as a file called <filename>initGroups.sh</filename>.
This script is given in <link linkend="set-group-map">intGroups.sh</link>.
The UNC syntax was developed in the early days of MS DOS 3.x and is used internally by the SMB protocol.
</para></glossdef>
</glossentry>
-
-
-
</glossary>
AC_INIT(settings.xsl.in)
PAPERSIZE=""
-DUPLICATE_ULINKS=""
+ULINK_IN_FOOTNOTE="0"
+ULINK_SHOW="1"
DOCROP="0"
AC_ARG_ENABLE(crop,
[ --enable-crop Whether to use a crop template],
-[ test "$withval" && DOCROP="1" ])
+[ test "$enableval" && DOCROP="1" ])
PAPERSIZE="a4paper"
AC_ARG_ENABLE(printable,
[ --enable-printable Printable output (expand ulinks, etc)],
-[ test "$withval" && DUPLICATE_ULINKS="footnote" ])
+[ if test "$enableval"; then
+ ULINK_IN_FOOTNOTE="1"
+ ULINK_SHOW="0"
+ fi ])
DOC_BUILD_DATE=`date '+%d-%m-%Y'`
AC_SUBST(DOC_BUILD_DATE)
AC_SUBST(PAPERSIZE)
-AC_SUBST(DUPLICATE_ULINKS)
+AC_SUBST(ULINK_IN_FOOTNOTE)
+AC_SUBST(ULINK_SHOW)
AC_SUBST(FONTSIZE)
AC_SUBST(DOCROP)
AC_SUBST(SAMBASOURCEDIR)
<td valign="top">This book is a collection of documents that might be useful for people developing samba or those interested in doing so. It's nothing more than a collection of documents written by samba developers about the internals of various parts of samba and the SMB protocol. It's still (and will always be) incomplete.</td>
</tr>
<tr>
-<td valign="top">Samba-3 by <a href="Samba-Guide/index.html">Example</a></td>
+<td valign="top">Samba-3 by <a href="Samba3-ByExample/index.html">Example</a></td>
<td valign="top">Practical Exercises in Successful Samba Deployment.</td>
</tr>
<tr>
- <td valign="top">The Official Samba-3 <a href="Samba-HOWTO-Collection/index.html">HOWTO</a> and Reference Guide</td>
+ <td valign="top">The Official Samba-3 <a href="Samba3-HOWTO/index.html">HOWTO</a> and Reference Guide</td>
<td valign="top">This book provides example configurations, it documents key aspects of Microsoft Windows networking, provides in-depth insight into the important configuration of Samba-3, and helps to put all of these into a useful framework.</td>
</tr>
<tr>
<xsl:param name="papersize"><xsl:text>@PAPERSIZE@</xsl:text></xsl:param>
<xsl:param name="docrop"><xsl:text>@DOCROP@</xsl:text></xsl:param>
-<xsl:param name="duplicate_ulinks"><xsl:text>@DUPLICATE_ULINKS@</xsl:text></xsl:param>
+<xsl:param name="ulink.footnotes"><xsl:text>@ULINK_IN_FOOTNOTE@</xsl:text></xsl:param>
+<xsl:param name="ulink.show"><xsl:text>@ULINK_SHOW@</xsl:text></xsl:param>
<xsl:param name="fontsize"><xsl:text>@FONTSIZE@</xsl:text></xsl:param>
</xsl:stylesheet>
</xsl:if>
</xsl:template>
- <xsl:template match="translator">
- <xsl:element name="othercredit">
- <xsl:element name="author">
- <xsl:apply-templates/>
- <xsl:element name="contrib">
- <xsl:text>Translation to </xsl:text><xsl:value-of select="@lang"/>
- </xsl:element>
- </xsl:element>
- </xsl:element>
- </xsl:template>
-
<xsl:template match="reference/refentry">
<xsl:element name="section">
<xsl:attribute name="id">
</xsl:attribute>
<xsl:element name="title">
<xsl:value-of select="refmeta/refentrytitle"/>
- <!-- <xsl:text> (</xsl:text>
- <xsl:value-of select="refnamediv/refpurpose"/>
- <xsl:text>)</xsl:text>-->
</xsl:element>
<xsl:apply-templates/>
</xsl:element>
</xsl:choose>
</xsl:template>
- <!-- FIXME: Needs extension sometime -->
- <xsl:template match="ntgroup|ntuser">
- <xsl:element name="emphasis">
- <xsl:apply-templates/>
- </xsl:element>
- </xsl:template>
-
<xsl:template match="smbconfexample">
<xsl:choose>
<xsl:when test="title = ''">
</xsl:element>
</xsl:template>
- <xsl:template match="ulink">
- <xsl:element name="ulink">
- <xsl:attribute name="url">
- <xsl:value-of select="@url"/>
- </xsl:attribute>
-
- <xsl:apply-templates/>
- <xsl:if test="contains(@url,'http://') or contains(@url,'ftp://')">
- <xsl:if test="$duplicate_ulinks='brackets'">
- <xsl:text> (</xsl:text>
- <xsl:value-of select="@url"/>
- <xsl:text>)</xsl:text>
- </xsl:if>
- <xsl:if test="$duplicate_ulinks='footnote'">
- <xsl:element name="footnote">
- <xsl:element name="para">
- <xsl:value-of select="@url"/>
- </xsl:element>
- </xsl:element>
- </xsl:if>
- </xsl:if>
- </xsl:element>
- </xsl:template>
-
- <!-- Just ignore these -->
- <xsl:template match="smbfile">
- <xsl:apply-templates/>
- </xsl:template>
-
<xsl:template match="quote">
<xsl:element name="quote">
<xsl:element name="emphasis">
--- /dev/null
+<?xml version='1.0'?>
+<!DOCTYPE latexbindings SYSTEM "http://db2latex.sourceforge.net/xsl/latex.mapping.dtd">
+<latexbindings>
+ <latexmapping role="begin">
+ </latexmapping>
+ <latexmapping role="end">
+ <mapping key="glossary" text=""/>
+ </latexmapping>
+</latexbindings>
<?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="../settings.xsl"/>
-<!--<xsl:import href="docbook.xsl"/>-->
<xsl:import href="http://db2latex.sourceforge.net/xsl/docbook.xsl"/>
+<xsl:param name="latex.mapping.xml" select="document('latex.overrides.xml')"/>
+
+<xsl:param name="generate.toc">
+ /appendix toc,title
+ article/appendix nop
+ /article toc,title
+ book toc,title,figure,table,example,equation
+ /chapter toc,title,lop
+ part toc,title
+ /preface toc,title
+ qandadiv toc
+ qandaset toc
+ procedure lop
+ reference toc,title
+ /sect1 toc
+ /sect2 toc
+ /sect3 toc
+ /sect4 toc
+ /sect5 toc
+ /section toc
+ set toc,title
+</xsl:param>
+
<xsl:template name="link">
<xsl:element name="link">
<xsl:copy-of select="@*"/>
<xsl:output method="text" encoding="ISO-8859-1" indent="yes"/>
<xsl:param name="l10n.gentext.default.language" select="'en'"/>
<xsl:param name="latex.example.caption.style"></xsl:param>
-<xsl:variable name="latex.documentclass">sambadoc</xsl:variable>
-<xsl:variable name="latex.documentclass.common">twoside,11pt,letterpaper</xsl:variable>
-<xsl:variable name="latex.documentclass.book"></xsl:variable>
<xsl:variable name="latex.hyperref.param.pdftex">hyperfigures,hyperindex,citecolor=black,urlcolor=black,filecolor=black,linkcolor=black,menucolor=red,pagecolor=black</xsl:variable>
-<xsl:variable name="latex.document.font">default</xsl:variable>
<xsl:variable name="admon.graphics.path">xslt/figures</xsl:variable>
<xsl:variable name="latex.use.tabularx">1</xsl:variable>
<xsl:variable name="latex.fancyhdr.lh"></xsl:variable>
<xsl:variable name="latex.book.preamblestart">
\documentclass[twoside,openright,<xsl:value-of select="$fontsize"/>pt]{xslt/latex/sambadoc}
-\usepackage[twoside,dvips]{geometry}
-
-%\usepackage[section]{placeins}
-
-\geometry{%
-paperwidth=7in,
-paperheight=9.25in,
-lmargin=.75in,
-rmargin=.75in,
-bmargin=.625in,
-tmargin=.625in,
-width=5.5in,
-height=7.525in, %7.3
-marginparwidth=0.35in,
-headheight=0.2in,
-headsep=.25in,
-footskip=.025in}
-
-\setlength{\headwidth}{\textwidth}
-
-<xsl:if test="$docrop != '0'">
-\usepackage[letter,center,dvips]{crop}
-</xsl:if>
\usepackage{amsmath}%
\usepackage{amsfonts}%
\usepackage{amssymb}
-<xsl:if test="$docrop != '0'">
-\special{papersize=11in,8.5in}
-
-%\crop[frame]
-\crop
-</xsl:if>
-
\makeindex
-%% Preamble:
-
-% New commands and/or command redefinitions
-%
-% Added for the samba book
-%----------------------- paragraph ----------------------------------
-\cleardoublepage
-\pagenumbering{roman}
-
-\setcounter{page}{2}
-\setcounter{totalnumber}{8}
-\setcounter{bottomnumber}{3}
-\setcounter{topnumber}{3}
-\renewcommand{\textfraction}{0.1}
-\renewcommand{\topfraction}{1.0}
-\renewcommand{\bottomfraction}{1.0}
-
-%% Document Parts
</xsl:variable>
<xsl:param name="latex.babel.language">english</xsl:param>
-<xsl:param name="ulink.url">1</xsl:param>
<xsl:template match="//title/filename|//title/command|//title/parameter|//title/constant">
<xsl:variable name="content">
</xsl:if>
</xsl:template>
-
</xsl:stylesheet>
-
\renewcommand\listfigurename{\uppercase{List Of Figures}}
\renewcommand\listtablename{\uppercase{List Of Tables}}
+\setlength{\emergencystretch}{0cm}
+\cleardoublepage
+\pagenumbering{roman}
+
+\setcounter{page}{2}
+\setcounter{totalnumber}{8}
+\setcounter{bottomnumber}{3}
+\setcounter{topnumber}{3}
+\renewcommand{\textfraction}{0.1}
+\renewcommand{\topfraction}{1.0}
+\renewcommand{\bottomfraction}{1.0}
+
+\usepackage[twoside,dvips]{geometry}
+
+\geometry{%
+paperwidth=7in,
+paperheight=9.25in,
+lmargin=.75in,
+rmargin=.75in,
+bmargin=.625in,
+tmargin=.625in,
+width=5.5in,
+height=7.525in, %7.3
+marginparwidth=0.35in,
+headheight=0.2in,
+headsep=.25in,
+footskip=.025in}
+
+\setlength{\headwidth}{\textwidth}