diff options
author | Jelmer Vernooij <jelmer@samba.org> | 2005-03-17 00:13:11 +0000 |
---|---|---|
committer | Gerald W. Carter <jerry@samba.org> | 2008-04-23 08:46:22 -0500 |
commit | f1820fa60eb415a1952116a2c0e4b924c032cd4f (patch) | |
tree | ff6a1bb9ad932a245c8577711a66697703c2484f /docs | |
parent | f87f8fee8f933c4a4f0f2b7e5f2123749f70eaf8 (diff) | |
download | samba-f1820fa60eb415a1952116a2c0e4b924c032cd4f.tar.gz samba-f1820fa60eb415a1952116a2c0e4b924c032cd4f.tar.bz2 samba-f1820fa60eb415a1952116a2c0e4b924c032cd4f.zip |
Autogenerate parts of the makefile rather then calling seperate shell scripts.
Avoids a lot of copying images that are already present.
(This used to be commit 310b572db83e5a5a14eb4ac7dabbbff60172c668)
Diffstat (limited to 'docs')
-rw-r--r-- | docs/Makefile | 75 | ||||
-rw-r--r-- | docs/configure.in | 4 | ||||
-rwxr-xr-x | docs/scripts/copy-images.sh | 12 | ||||
-rw-r--r-- | docs/xslt/find-image-dependencies.xsl | 20 |
4 files changed, 55 insertions, 56 deletions
diff --git a/docs/Makefile b/docs/Makefile index eb59009e1b..7833294675 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -4,7 +4,7 @@ # James Moore <jmoore@php.net> # Gerald Carter <jerry@samba.org> # Jelmer Vernooij <jelmer@samba.org> --include Makefile.settings +include Makefile.settings # Docs to build MAIN_DOCS = $(patsubst %/index.xml,%,$(wildcard */index.xml)) @@ -17,7 +17,7 @@ MANPAGES_PLUCKER = $(patsubst $(MANPAGEDIR)/%.xml,$(PLUCKERDIR)/%.pdb,$(MANPAGES DATETIME := $(shell date +%Y%m%d%H%M%S) ifndef OUTPUTDIR -Makefile.settings: Makefile.settings.in configure +Makefile.settings: configure @echo Makefile.settings not present, trying to run configure... @./configure @@ -91,20 +91,18 @@ $(HTMLDIR)/index.html: htmldocs.html mkdir -p $(@D) cp $< $@ -$(HTMLDIR)/%/index.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/%/samba.css xslt/html-chunk.xsl +$(HTMLDIR)/%/index.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/%/samba.css xslt/html-chunk.xsl %-images-html-chunks mkdir -p $(@D) $(XSLTPROC) --stringparam base.dir "$(HTMLDIR)/$*/" xslt/html-chunk.xsl $< - mkdir -p $(@D)/images - $(COPY_IMAGES) html $(DOCBOOKDIR)/$*.xml $* $(@D) # Single large HTML files $(OUTPUTDIR)/%/samba.css: xslt/html/samba.css mkdir -p $(@D) cp $< $@ +$(patsubst %,$(HTMLDIR)/%.html,$(MAIN_DOCS)): $(HTMLDIR)/%.html: %-images-html-single + $(HTMLDIR)/%.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/samba.css xslt/html.xsl - mkdir -p $(@D)/images - $(COPY_IMAGES) html $(DOCBOOKDIR)/$*.xml $* $(@D) $(XSLTPROC) --output $@ xslt/html.xsl $< # Attributions @@ -116,15 +114,13 @@ $(TXTDIR)/%.txt: $(HTMLDIR)/%.html mkdir -p $(@D) $(HTML2TEXT) -nobs -style pretty -o $@ $< -$(TXTDIR)/%/: $(HTMLDIR)/%/index.html - $(MAKE) `echo $(HTMLDIR)/$*/*.html | $(PERL) -p -e 's|$(HTMLDIR)|$(TXTDIR)|g;s/\.html/\.txt/g;'` - # Tex files %.tex: $(DOCBOOKDIR)/%.xml xslt/latex.xsl mkdir -p $(@D) $(XSLTPROC) --output $@ xslt/latex.xsl $< latexfigures: $(LATEX_FIGURES) + touch $@ $(PDFDIR)/%.pdf: %.pdf mkdir -p $(@D) @@ -136,11 +132,46 @@ $(PDFDIR)/%.pdf: %.pdf %.ind: %.idx $(MAKEINDEX) $< +# Dependency files +%.d: $(DOCBOOKDIR)/%.xml xslt/generate-dependencies.xsl + $(XSLTPROC) \ + --novalid \ + --stringparam txtbasedir "$(TXTDIR)/$*/" \ + --stringparam target "$*" \ + -o $@ xslt/generate-dependencies.xsl $< + @echo "$*-images-latex-png: \$$(addsuffix .png, \$$($*-images-latex))" >> $@ + @echo " touch \$$@" >> $@ + @echo >> $@ + @echo "$*-images-latex-eps: \$$(addsuffix .eps, \$$($*-images-latex))" >> $@ + @echo " touch \$$@" >> $@ + @echo >> $@ + @echo "\$$(HTMLDIR)/%: $*/%" >> $@ + @echo " mkdir -p \$$(@D)" >> $@ + @echo " cp \$$< \$$@" >> $@ + @echo >> $@ + @echo "\$$(HTMLDIR)/$*/%: $*/%" >> $@ + @echo " mkdir -p \$$(@D)" >> $@ + @echo " cp \$$< \$$@" >> $@ + @echo >> $@ + @echo "\$$(HTMLHELPDIR)/$*/%: $*/%" >> $@ + @echo " mkdir -p \$$(@D)" >> $@ + @echo " cp \$$< \$$@" >> $@ + @echo >> $@ + @echo "$*-images-html-single: \$$(addprefix \$$(HTMLDIR)/, \$$($*-images-html))" >> $@ + @echo " touch \$$@" >> $@ + @echo "$*-images-html-chunks: \$$(addprefix \$$(HTMLDIR)/$*/, \$$($*-images-html))" >> $@ + @echo " touch \$$@" >> $@ + @echo "$*-images-htmlhelp: \$$(addprefix \$$(HTMLHELPDIR)/$*/, \$$($*-images-html))" >> $@ + @echo " touch \$$@" >> $@ + +ifdef OUTPUTDIR +include $(addsuffix .d,$(MAIN_DOCS)) +endif + # Adobe PDF files -%.pdf: %.tex %.ind latexfigures - $(MAKE) $(shell $(XSLTPROC) --stringparam prepend "" --stringparam append ".png" --stringparam role latex xslt/find-image-dependencies.xsl $(DOCBOOKDIR)/$*.xml) +%.pdf: %.tex %.ind latexfigures %-images-latex-png -$(PDFLATEX) $< - $(THUMBPDF) $*.pdf + $(THUMBPDF) --quiet $*.pdf -$(PDFLATEX) $< # DVI files @@ -148,8 +179,7 @@ $(DVIDIR)/%.dvi: %.dvi mkdir -p $(@D) cp $< $@ -%.dvi: %.tex %.idx - $(MAKE) $(shell $(XSLTPROC) --stringparam prepend "" --stringparam append ".eps" --stringparam role latex xslt/find-image-dependencies.xsl $(DOCBOOKDIR)/$*.xml) +%.dvi: %.tex %.idx %-images-latex-eps -$(LATEX) $< %.png: %.dia @@ -176,10 +206,11 @@ $(FOPDFDIR)/%.pdf: $(FODIR)/%.fo mkdir -p $(@D) JAVA_OPTS=-Xmx250m $(FOP) -q -d $< -pdf $@ -$(HTMLHELPDIR)/%: $(DOCBOOKDIR)/%.xml - mkdir -p $@/images - $(COPY_IMAGES) html $(DOCBOOKDIR)/$*.xml $* $@ - $(XSLTPROC) --stringparam htmlhelp.chm $*.chm --stringparam manifest.in.base.dir "$@/" --stringparam base.dir "$@/" http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl $< +$(HTMLHELPDIR)/%: $(DOCBOOKDIR)/%.xml %-images-htmlhelp + $(XSLTPROC) --stringparam htmlhelp.chm $*.chm \ + --stringparam manifest.in.base.dir "$@/" \ + --stringparam base.dir "$@/" \ + http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl $< # Plucker docs $(PLUCKERDIR)/%.pdb: $(HTMLDIR)/%.html @@ -228,7 +259,7 @@ $(PEARSONDIR)/%.report.html: $(PEARSONDIR)/%.xml # Validation verification %-validate: %/index.xml - -cd $(<D) && $(XMLLINT) --xinclude --noent --postvalid --noout $(<F) + cd $(<D) && $(XMLLINT) --xinclude --noent --postvalid --noout $(<F) # Find undocumented parameters undocumented: $(SMBDOTCONFDOC)/parameters.all.xml scripts/find_missing_doc.pl scripts/find_missing_manpages.pl @@ -264,11 +295,11 @@ clobber: clean clean: rm -rf $(OUTPUTDIR)/* $(DOCBOOKDIR) - rm -f *.xml + rm -f *.xml *.d rm -f xslt/figures/*pdf rm -f $(SMBDOTCONFDOC)/parameters.*.xml rm -f $(addsuffix .*,$(MAIN_DOCS)) # Always keep intermediate files if we can .SECONDARY: -.PHONY: clean clobber latexfigures archive release everything all +.PHONY: clean clobber archive release everything all diff --git a/docs/configure.in b/docs/configure.in index e240373a2d..884be787c6 100644 --- a/docs/configure.in +++ b/docs/configure.in @@ -66,7 +66,7 @@ DOCS_TARGET_REQUIRE_PROGRAM(DVIPS, dvips, PS) DOCS_TARGET_REQUIRE_PROGRAM(PLUCKERBUILD, plucker-build, PLUCKER) 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(XMLLINT, xmllint, VALIDATE) DOCS_TARGET_REQUIRE_PROGRAM(FOP, fop, FOPDF) DOCS_TARGET_REQUIRE_PROGRAM(DB2TEXI, docbook2x-texi, TEXI) DOCS_TARGET_REQUIRE_PROGRAM(MAKEINFO, makeinfo, TEXIINFO) @@ -86,7 +86,7 @@ DOCS_DEFINE_TARGET(HTMLMAN, ALL, [HTML versions of the manpages], [htmlman]) DOCS_DEFINE_TARGET(MANPAGES, ALL, [manpages], [manpages]) 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(VALIDATE, ALL, [validating docbook output], []) DOCS_DEFINE_TARGET(FOPDF, ALL, [PDF versions thru FO], [fo-pdf]) DOCS_DEFINE_TARGET(TEXI, ALL, [TexInfo versions], [texi]) DOCS_DEFINE_TARGET(TEXIINFO, ALL, [TexInfo Info versions], [texiinfo]) diff --git a/docs/scripts/copy-images.sh b/docs/scripts/copy-images.sh deleted file mode 100755 index cba43d9d99..0000000000 --- a/docs/scripts/copy-images.sh +++ /dev/null @@ -1,12 +0,0 @@ -#!/bin/sh -ROLE="$1" -XMLFILE="$2" -FROM="$3" -TO="$4" - -for x in `xsltproc --stringparam prepend "" --stringparam append "" --stringparam role "$ROLE" xslt/find-image-dependencies.xsl "$XMLFILE"` -do - test -f $FROM/$x || make $FROM/$x || exit 1 - cp -u $FROM/$x $TO/$x || exit 1 -done -exit diff --git a/docs/xslt/find-image-dependencies.xsl b/docs/xslt/find-image-dependencies.xsl deleted file mode 100644 index f658369145..0000000000 --- a/docs/xslt/find-image-dependencies.xsl +++ /dev/null @@ -1,20 +0,0 @@ -<?xml version='1.0'?> -<!-- - Find the image dependencies of a certain XML file - (C) Jelmer Vernooij 2004 ---> -<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.1"> - <xsl:output method="text"/> - - <xsl:template match="mediaobject/imageobject[@role=$role]"> - <xsl:value-of select="$prepend"/> - <xsl:value-of select="imagedata/@fileref"/> - <xsl:value-of select="$append"/> - <xsl:text> </xsl:text> - </xsl:template> - - <xsl:template match="text()"/> - <xsl:template match="*"> - <xsl:apply-templates/> - </xsl:template> -</xsl:stylesheet> |