diff options
| -rw-r--r-- | docs/Makefile | 40 | ||||
| -rw-r--r-- | docs/Makefile.settings.in | 3 | ||||
| -rw-r--r-- | docs/configure.in | 4 |
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]) |