summaryrefslogtreecommitdiff
path: root/docs-xml
diff options
context:
space:
mode:
authorAndrew Bartlett <abartlet@samba.org>2020-06-03 12:33:50 +1200
committerAndrew Bartlett <abartlet@samba.org>2020-06-10 07:11:59 +0000
commit0208d5f64b2cb9b67d5ab6070f411cf45cea1fc4 (patch)
treebb2b0f089239c24e7e6935438c39e5e81c058286 /docs-xml
parent4a3ed0d8459f626b8df0781b3231270040a0480d (diff)
downloadsamba-0208d5f64b2cb9b67d5ab6070f411cf45cea1fc4.tar.gz
Add docs build to CI
We did not check we could actually build the HTML of the Samba Developers guide and HTML of the manpages previously. Signed-off-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: David Disseldorp <ddiss@samba.org> Autobuild-User(master): Andrew Bartlett <abartlet@samba.org> Autobuild-Date(master): Wed Jun 10 07:11:59 UTC 2020 on sn-devel-184
Diffstat (limited to 'docs-xml')
-rw-r--r--docs-xml/Makefile11
-rw-r--r--docs-xml/Makefile.settings.in2
-rw-r--r--docs-xml/README4
-rw-r--r--docs-xml/configure.ac2
4 files changed, 4 insertions, 15 deletions
diff --git a/docs-xml/Makefile b/docs-xml/Makefile
index 769e46bdde6..c614097f6c0 100644
--- a/docs-xml/Makefile
+++ b/docs-xml/Makefile
@@ -36,7 +36,7 @@ help:
@echo " release - Build the docs needed for a Samba release"
@echo " all - Build all docs that can be build using the utilities found by configure"
@echo " everything - Build all of the above"
- @echo " pdf,tex,ps,manpages,txt,htmlhelp - Build specific output format"
+ @echo " pdf,tex,ps,manpages,htmlhelp - Build specific output format"
@echo " html - Build multi-file HTML versions"
@echo " html-single - Build single-file HTML versions"
@echo " htmlman - Build HTML version of manpages"
@@ -45,7 +45,7 @@ $(PDFDIR)/Samba3-Developers-Guide.pdf $(PSDIR)/Samba3-Developers-Guide.ps $(DOCB
# Pseudo targets
all:: $(TARGETS)
-everything:: manpages pdf html-single html htmlman txt ps fo htmlhelp
+everything:: manpages pdf html-single html htmlman ps fo htmlhelp
release:: manpages htmlman html pdf
clean::
@echo "Cleaning up..."
@@ -61,7 +61,6 @@ clean::
# Output format targets
pdf:: $(patsubst %,$(PDFDIR)/%.pdf,$(MAIN_DOCS))
ps:: $(patsubst %,$(PSDIR)/%.ps,$(MAIN_DOCS))
-txt:: $(patsubst %,$(TXTDIR)/%.txt,$(MAIN_DOCS))
tex:: $(addsuffix .tex,$(MAIN_DOCS))
manpages:: $(patsubst $(MANPAGEDIR)/%.xml,$(OUTPUTDIR)/manpages/%,$(MANPAGES))
htmlman:: $(patsubst $(MANPAGEDIR)/%.xml,$(HTMLDIR)/manpages/%.html,$(MANPAGES)) $(HTMLDIR)/manpages/index.html
@@ -117,11 +116,6 @@ $(HTMLDIR)/%.html: $(DOCBOOKDIR)/%.xml $(HTMLDIR)/samba.css xslt/html.xsl $(XSLT
@cp -f templates/attributions.xml $@
@$(XSLTPROC) --xinclude -o $@ xslt/generate-attributions.xsl $*/index.xml
-# Text files
-$(TXTDIR)/%.txt: $(HTMLDIR)/%.html
- @mkdir -p $(@D)
- $(HTML2TEXT) -nobs -style pretty -o $@ $<
-
# Tex files
%.tex: %/index.xml xslt/latex.xsl
@echo "Generating $@..."
@@ -132,7 +126,6 @@ $(TXTDIR)/%.txt: $(HTMLDIR)/%.html
%.d: $(DOCBOOKDIR)/%.xml xslt/generate-dependencies.xsl $(XSLTPROC_DEPS)
@echo "Generating dependency file for $*"
@$(XSLTPROC) --novalid \
- --stringparam txtbasedir "$(TXTDIR)/$*/" \
--stringparam target "$*" \
-o $@ xslt/generate-dependencies.xsl $<
@echo "$*-images-latex-eps: \$$(addsuffix .eps, \$$($*-images-latex))" >> $@
diff --git a/docs-xml/Makefile.settings.in b/docs-xml/Makefile.settings.in
index b619292c88c..7898b6bb4d0 100644
--- a/docs-xml/Makefile.settings.in
+++ b/docs-xml/Makefile.settings.in
@@ -3,7 +3,6 @@ XSLTPROC = @XSLTPROC@ --nonet
XMLLINT = @XMLLINT@
PNGTOPNM = @PNGTOPNM@
PNMTOPS = @PNMTOPS@
-HTML2TEXT = @HTML2TEXT@
MAKEINFO = @MAKEINFO@
DBLATEX = @DBLATEX@
RM = @RM@
@@ -20,7 +19,6 @@ DOCBOOKDIR = tmp
PSDIR = $(OUTPUTDIR)
PDFDIR = $(OUTPUTDIR)
HTMLHELPDIR = $(OUTPUTDIR)/htmlhelp
-TXTDIR = $(OUTPUTDIR)/textdocs
HTMLDIR=$(OUTPUTDIR)/htmldocs
DB2LATEX_ARGS = --stringparam latex.documentclass.book @LATEX_DOCUMENTCLASS_OPTIONS@
diff --git a/docs-xml/README b/docs-xml/README
index a1caae3d9b5..4affbeec538 100644
--- a/docs-xml/README
+++ b/docs-xml/README
@@ -35,8 +35,8 @@ The format
----------
If you are new to xml, regard an xml file as 'source code'. You don't
-read it directly, but use it to create other formats (like the txt and html
-included in ../txtdocs and ../htmldocs).
+read it directly, but use it to create other formats (like the html
+included in ../htmldocs).
Docbook is a particular XML style, particularly suited to producing
technical manuals.
diff --git a/docs-xml/configure.ac b/docs-xml/configure.ac
index 196ab883def..aaec457d817 100644
--- a/docs-xml/configure.ac
+++ b/docs-xml/configure.ac
@@ -12,7 +12,6 @@ DOCS_TARGET_REQUIRE_PROGRAM(RM, rm, ALL)
DOCS_TARGET_REQUIRE_PROGRAM(PNGTOPNM, pngtopnm, PS)
DOCS_TARGET_REQUIRE_PROGRAM(PNMTOPS, pnmtops, PS)
DOCS_TARGET_REQUIRE_PROGRAM(DBLATEX, dblatex, LATEX)
-DOCS_TARGET_REQUIRE_PROGRAM(HTML2TEXT, html2text, TXT)
DOCS_TARGET_REQUIRE_PROGRAM(XMLLINT, xmllint, VALIDATE)
AC_MSG_RESULT([])
@@ -26,7 +25,6 @@ DOCS_DEFINE_TARGET(HTMLHELP, ALL, [HTML Help versions], [htmlhelp])
DOCS_DEFINE_TARGET(HTMLMAN, ALL, [HTML versions of the manpages], [htmlman])
DOCS_DEFINE_TARGET(MANPAGES, ALL, [manpages], [manpages])
DOCS_DEFINE_TARGET(VALIDATE, ALL, [validating docbook output], [])
-DOCS_DEFINE_TARGET(TXT, HTML, [text versions], [txt])
if test x"$TARGETS" = x; then
AC_MSG_ERROR([You won't be able to build any of the docs])