summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2005-03-11 16:26:19 +0000
committerGerald W. Carter <jerry@samba.org>2008-04-23 08:46:17 -0500
commitd094db74752a7138797b1429fa597974c8826f84 (patch)
tree92a7354c4060fcfded011e796fbdf4985c0411b2 /docs
parentfedcbe8f083f67b3689327bceb9a578175eef625 (diff)
downloadsamba-d094db74752a7138797b1429fa597974c8826f84.tar.gz
samba-d094db74752a7138797b1429fa597974c8826f84.tar.bz2
samba-d094db74752a7138797b1429fa597974c8826f84.zip
Add texi support
(This used to be commit bdcf561e232d4bcee85e4a7dceccb2382bfe9138)
Diffstat (limited to 'docs')
-rw-r--r--docs/Makefile40
-rw-r--r--docs/Makefile.settings.in3
-rw-r--r--docs/configure.in4
3 files changed, 29 insertions, 18 deletions
diff --git a/docs/Makefile b/docs/Makefile
index d3f2b1290b..e08a115277 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -57,6 +57,8 @@ txt-chunks: $(patsubst $(DOCBOOKDIR)/%.xml,$(TXTDIR)/%/,$(MAIN_DOCS))
fo: $(patsubst $(DOCBOOKDIR)/%.xml,$(FODIR)/%.fo,$(MAIN_DOCS))
fo-pdf: $(patsubst $(DOCBOOKDIR)/%.xml,$(FOPDFDIR)/%.pdf,$(MAIN_DOCS))
tex: $(patsubst $(DOCBOOKDIR)/%.xml,%.tex,$(MAIN_DOCS))
+texi: $(patsubst $(DOCBOOKDIR)/%.xml,$(TEXINFODIR)/%.texi,$(MAIN_DOCS))
+texiinfo: $(patsubst $(DOCBOOKDIR)/%.xml,$(TEXINFODIR)/%.info,$(MAIN_DOCS))
manpages: $(patsubst $(MANPAGEDIR)/%.xml,$(MANDIR)/%,$(MANPAGES))
pearson: $(PEARSONDIR)/Samba-HOWTO-Collection.xml
pearson-verify: $(PEARSONDIR)/Samba-HOWTO-Collection.report.html
@@ -104,19 +106,10 @@ $(HTMLDIR)/%.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/samba.css xslt/html.xsl
$(COPY_IMAGES) html $(DOCBOOKDIR)/$*.xml $* $(@D)
$(XSLTPROC) --output $@ xslt/html.xsl $<
+# Attributions
%-attributions.xml:
$(XSLTPROC) --xinclude -o $@ xslt/generate-attributions.xsl $*/index.xml
-clobber: clean
- rm Makefile.settings settings.xsl config.status config.log configure
-
-clean:
- rm -rf $(OUTPUTDIR)/* $(DOCBOOKDIR)
- rm -f *.xml
- rm -f xslt/figures/*pdf
- rm -f $(SMBDOTCONFDOC)/parameters.*.xml
- rm -f $(patsubst $(DOCBOOKDIR)/%.xml,%.*,$(MAIN_DOCS))
-
# Text files
$(TXTDIR)/%.txt: $(HTMLDIR)/%.html
mkdir -p $(@D)
@@ -172,10 +165,6 @@ $(PSDIR)/%.ps: $(DVIDIR)/%.dvi
xslt/figures/%.pdf: xslt/figures/%.eps
$(EPSTOPDF) $<
-# RTF files
-$(RTFDIR)/%.rtf: $(DOCBOOKDIR)/%.xml
- $(XSLTPROC) --output $@ http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl $<
-
# Fo
$(FODIR)/%.fo: $(DOCBOOKDIR)/%.xml
mkdir -p $(@D)
@@ -196,6 +185,14 @@ $(PLUCKERDIR)/%.pdb: $(HTMLDIR)/%.html
mkdir -p $(@D)
$(PLUCKERBUILD) -v -V 2 --stayonhost --zlib-compression -f $* -p $(PLUCKERDIR) file:$<
+# Texinfo docs
+$(TEXINFODIR)/%.texi: $(DOCBOOKDIR)/%.xml
+ mkdir -p $(@D)
+ cd $(@D) && $(DB2TEXI) $(shell pwd)/$<
+
+$(TEXINFODIR)/%.info: $(TEXINFODIR)/%.texi
+ $(MAKEINFO) --no-validate --force -o $@ "$<"
+
# Manpages
$(MANPAGEDIR)/smb.conf.5.xml: $(SMBDOTCONFDOC)/parameters.all.xml $(SMBDOTCONFDOC)/parameters.service.xml $(SMBDOTCONFDOC)/parameters.global.xml
@@ -220,7 +217,6 @@ $(HTMLDIR)/smb.conf/%.html: $(SMBDOTCONFDOC)/%.xml
$(XSLTPROC) --output $@ xslt/smb.conf-html.xsl $<
# Pearson compatible XML
-
$(PEARSONDIR)/%.xml: %/index.xml xslt/pearson.xsl
mkdir -p $(@D)
$(XSLTPROC) --xinclude --output $@ xslt/sambadoc2pearson.xsl $<
@@ -230,7 +226,6 @@ $(PEARSONDIR)/%.report.html: $(PEARSONDIR)/%.xml
$(XMLLINT) --valid --noout --htmlout $< 2> $@
# Validation verification
-
$(VALIDATEDIR)/%.report.html: %/index.xml
mkdir -p $(@D)
$(XMLLINT) --xinclude --postvalid --noout --htmlout $< 2> $@
@@ -238,13 +233,11 @@ $(VALIDATEDIR)/%.report.html: %/index.xml
validate: $(VALIDATEDIR)/Samba-HOWTO-Collection.report.html $(VALIDATEDIR)/Samba-Developers-Guide.report.html $(VALIDATEDIR)/Samba-Guide.report.html
# Find undocumented parameters
-
undocumented: $(SMBDOTCONFDOC)/parameters.all.xml scripts/find_missing_doc.pl scripts/find_missing_manpages.pl
@$(PERL) scripts/find_missing_doc.pl $(SRCDIR)
@$(PERL) scripts/find_missing_manpages.pl $(SRCDIR)
# Examples and the like
-
files: Samba-HOWTO-Collection/index.xml xslt/extract-smbfiles.xsl
$(XSLTPROC) xslt/extract-smbfiles.xsl $< > /dev/null
@@ -268,4 +261,15 @@ xslt/generate-attributions.xsl:
xslt/man.xsl:
xslt/pearson.xsl:
+clobber: clean
+ rm Makefile.settings settings.xsl config.status config.log configure
+
+clean:
+ rm -rf $(OUTPUTDIR)/* $(DOCBOOKDIR)
+ rm -f *.xml
+ rm -f xslt/figures/*pdf
+ rm -f $(SMBDOTCONFDOC)/parameters.*.xml
+ rm -f $(patsubst $(DOCBOOKDIR)/%.xml,%.*,$(MAIN_DOCS))
+
+# Always keep intermediate files if we can
.SECONDARY:
diff --git a/docs/Makefile.settings.in b/docs/Makefile.settings.in
index 9ac8f080aa..f4a3dca2b4 100644
--- a/docs/Makefile.settings.in
+++ b/docs/Makefile.settings.in
@@ -8,6 +8,8 @@ PNMTOPNG = @PNMTOPNG@
DIA = @DIA@
PNMTOPS = @PNMTOPS@
HTML2TEXT = @HTML2TEXT@
+DB2TEXI = @DB2TEXI@
+MAKEINFO = @MAKEINFO@
PLUCKERBUILD = @PLUCKERBUILD@
COPY_IMAGES = ./scripts/copy-images.sh
THUMBPDF = @THUMBPDF@
@@ -24,6 +26,7 @@ endif
# Paths
OUTPUTDIR = output
ARCHIVEDIR = archive
+TEXINFODIR = $(OUTPUTDIR)/texi
SRCDIR = @SAMBASOURCEDIR@
MANDIR = $(OUTPUTDIR)/manpages
EPSTOPDF = @EPSTOPDF@
diff --git a/docs/configure.in b/docs/configure.in
index 4ee6f0e332..5eec1688e8 100644
--- a/docs/configure.in
+++ b/docs/configure.in
@@ -68,6 +68,8 @@ DOCS_TARGET_REQUIRE_PROGRAM(HTML2TEXT, html2text, TXT)
DOCS_TARGET_REQUIRE_PROGRAM(PERL, perl, UNDOCUMENTED)
DOCS_TARGET_REQUIRE_PROGRAM(XMLLINT, xmllint, VERIFY)
DOCS_TARGET_REQUIRE_PROGRAM(FOP, fop, FOPDF)
+DOCS_TARGET_REQUIRE_PROGRAM(DB2TEXI, docbook2x-texi, TEXI)
+DOCS_TARGET_REQUIRE_PROGRAM(MAKEINFO, makeinfo, TEXIINFO)
DOCS_TARGET_REQUIRE_DIR([$SPECIFIED_SOURCEDIR $SPECIFIED_SOURCEDIR/source ..], [param/loadparm.c], SAMBASOURCEDIR, UNDOCUMENTED)
AC_MSG_RESULT([])
@@ -86,6 +88,8 @@ DOCS_DEFINE_TARGET(PEARSON, ALL, [pearson-compatible XML], [pearson])
DOCS_DEFINE_TARGET(PLUCKER, HTML, [plucker versions], [plucker])
DOCS_DEFINE_TARGET(VERIFY, ALL, [verifying docbook output], [verify])
DOCS_DEFINE_TARGET(FOPDF, ALL, [PDF versions thru FO], [fopdf])
+DOCS_DEFINE_TARGET(TEXI, ALL, [TexInfo versions], [texi])
+DOCS_DEFINE_TARGET(TEXIINFO, ALL, [TexInfo Info versions], [texiinfo])
DOCS_DEFINE_TARGET(UNDOCUMENTED, MANPAGES, [list of undocumented options], [undocumented])
DOCS_DEFINE_TARGET(TXT, HTML, [text versions], [txt])