summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2005-03-17 00:13:11 +0000
committerGerald W. Carter <jerry@samba.org>2008-04-23 08:46:22 -0500
commitf1820fa60eb415a1952116a2c0e4b924c032cd4f (patch)
treeff6a1bb9ad932a245c8577711a66697703c2484f /docs
parentf87f8fee8f933c4a4f0f2b7e5f2123749f70eaf8 (diff)
downloadsamba-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/Makefile75
-rw-r--r--docs/configure.in4
-rwxr-xr-xdocs/scripts/copy-images.sh12
-rw-r--r--docs/xslt/find-image-dependencies.xsl20
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>