forked from osmocom/wireshark
![Jeff Morriss](/assets/img/avatar_default.png)
Change-Id: I483596d21f072b97ae87d5032bd450adcafcf243 Reviewed-on: https://code.wireshark.org/review/10678 Reviewed-by: Alexis La Goutte <alexis.lagoutte@gmail.com> Petri-Dish: Alexis La Goutte <alexis.lagoutte@gmail.com> Tested-by: Petri Dish Buildbot <buildbot-no-reply@wireshark.org> Reviewed-by: Anders Broman <a.broman58@gmail.com>
259 lines
8.1 KiB
Makefile
259 lines
8.1 KiB
Makefile
#
|
|
# Make the "Wireshark User Guide" and "Wireshark Developer Guide"
|
|
# in several formats.
|
|
# See the Readme.txt file for instructions.
|
|
#
|
|
|
|
# formatting objects processor
|
|
# Additional options to fop.
|
|
# This needs to contain at least the argument '-Xmx256m'
|
|
# fop executable is found in configure.ac.
|
|
FOP_OPTS=-Xmx256m
|
|
|
|
# Asciidoc converter
|
|
A2X_HTML_OPTS="--stylesheet=ws.css"
|
|
A2X_TEXT_OPTS=
|
|
|
|
#if HAVE_LYNX
|
|
A2X_TEXT_OPTS+="--lynx"
|
|
#endif
|
|
|
|
############### YOU SHOULDN'T HAVE TO EDIT ANYTHING BELOW THIS LINE! ################
|
|
|
|
include Makefile.common
|
|
|
|
# Automatically generate .pdf files from .fo files
|
|
# Suse needs FOP_OPTS, Debian needs JAVA_OPTS
|
|
.fo.pdf:
|
|
if HAVE_FOP
|
|
FOP_OPTS=$(FOP_OPTS) JAVA_OPTS=$(FOP_OPTS) $(FOP) $< $@
|
|
else
|
|
@echo
|
|
@echo "Error: FOP is needed to create PDFs!"
|
|
@false
|
|
endif
|
|
|
|
if HAVE_XSLTPROC
|
|
ALL_TARGETS=wsug wsdg release_notes
|
|
endif
|
|
|
|
all: $(ALL_TARGETS)
|
|
|
|
# Wireshark User Guide
|
|
if HAVE_FOP
|
|
WSUG_TARGETS=wsug.validated wsug_html_chunked wsug_html user-guide-a4.pdf user-guide-us.pdf
|
|
else
|
|
WSUG_TARGETS=wsug.validated wsug_html_chunked wsug_html
|
|
endif
|
|
|
|
wsug: $(WSUG_TARGETS)
|
|
|
|
user-guide.xml: user-guide.asciidoc $(WSUG_FILES)
|
|
$(A2X) --verbose \
|
|
--attribute=docinfo \
|
|
--asciidoc-opts="--conf-file=$(srcdir)/asciidoc.conf --conf-file=$(srcdir)/asciidoctor-asciidoc.conf" \
|
|
--no-xmllint \
|
|
--format=docbook \
|
|
--destination-dir=$(builddir) \
|
|
$<
|
|
|
|
# validate the content
|
|
wsug.validated: $(WSUG_SOURCE)
|
|
if HAVE_XMLLINT
|
|
@ echo --- WSUG - VALIDATING XML ---
|
|
$(XMLLINT) --path .:$(srcdir) --valid --noout $<
|
|
touch $@
|
|
else
|
|
@ echo --- WSUG - SKIP VALIDATION ---
|
|
endif
|
|
|
|
# create html single page file
|
|
wsug_html: wsug_html/index.html
|
|
|
|
wsug_html/index.html: $(WSUG_SOURCE) wsluarm
|
|
@ echo --- WSUG - HTML SINGLE PAGE ---
|
|
mkdir -p wsug_html/wsug_graphics/toolbar
|
|
cp $(srcdir)/wsug_graphics/*.* wsug_html/wsug_graphics
|
|
cp $(srcdir)/common_graphics/*.* wsug_html/wsug_graphics
|
|
cp $(srcdir)/wsug_graphics/toolbar/* wsug_html/wsug_graphics/toolbar
|
|
cp $(srcdir)/ws.css wsug_html
|
|
$(XSLTPROC) --stringparam base.dir wsug_html/ $(COMMON_XSLTPROC_ARGS) \
|
|
$(WSUG_XSLTPROC_ARGS) $(SINGLE_XSLTPROC_ARGS) $< > $@
|
|
-chmod -R og+rX wsug_html
|
|
|
|
# create html chunked page files
|
|
wsug_html_chunked: wsug_html_chunked/index.html
|
|
|
|
wsug_html_chunked/index.html: $(WSUG_SOURCE) wsluarm
|
|
@ echo --- WSUG - HTML CHUNKED ---
|
|
mkdir -p wsug_html_chunked/wsug_graphics/toolbar
|
|
cp $(srcdir)/wsug_graphics/*.* wsug_html_chunked/wsug_graphics
|
|
cp $(srcdir)/common_graphics/*.* wsug_html_chunked/wsug_graphics
|
|
cp $(srcdir)/wsug_graphics/toolbar/* wsug_html_chunked/wsug_graphics/toolbar
|
|
cp $(srcdir)/ws.css wsug_html_chunked
|
|
$(XSLTPROC) --stringparam base.dir wsug_html_chunked/ $(COMMON_XSLTPROC_ARGS) \
|
|
$(WSUG_XSLTPROC_ARGS) $(CHUNKED_XSLTPROC_ARGS) $<
|
|
-chmod -R og+rX wsug_html_chunked
|
|
|
|
# create pdf file (through XSL-FO), portrait pages on US letter paper
|
|
# you will get lot's of errors, but that's ok
|
|
user-guide-us.fo: $(WSUG_SOURCE) custom_layer_pdf.xsl wsluarm
|
|
@ echo --- WSUG - PDF US PAPER ---
|
|
$(XSLTPROC) --stringparam paper.type letter \
|
|
--nonet $(srcdir)/custom_layer_pdf.xsl $< > $@
|
|
|
|
# create pdf file (through XSL-FO), portrait pages on A4 paper
|
|
# you will get lot's of errors, but that's ok
|
|
user-guide-a4.fo: $(WSUG_SOURCE) custom_layer_pdf.xsl wsluarm
|
|
@ echo --- WSUG - PDF A4 PAPER ---
|
|
$(XSLTPROC) --stringparam paper.type A4 \
|
|
--nonet $(srcdir)/custom_layer_pdf.xsl $< > $@
|
|
|
|
wsluarm: make-wsluarm.pl $(WSLUA_MODULES)
|
|
mkdir -p wsluarm_src
|
|
$(PERL) $(srcdir)/make-wsluarm.pl $(WSLUA_MODULES)
|
|
touch wsluarm
|
|
|
|
|
|
# Wireshark Developer Guide
|
|
if HAVE_A2X
|
|
if HAVE_FOP
|
|
WSDG_TARGETS=wsdg.validated wsdg_html_chunked wsdg_html developer-guide-a4.pdf developer-guide-us.pdf
|
|
else
|
|
WSDG_TARGETS=wsdg.validated wsdg_html_chunked wsdg_html
|
|
endif
|
|
else
|
|
WSDG_TARGETS=
|
|
endif
|
|
|
|
wsdg: $(WSDG_TARGETS)
|
|
|
|
developer-guide.xml: developer-guide.asciidoc $(WSDG_FILES)
|
|
$(A2X) --verbose \
|
|
--attribute=docinfo \
|
|
--asciidoc-opts="--conf-file=$(srcdir)/asciidoc.conf --conf-file=$(srcdir)/asciidoctor-asciidoc.conf" \
|
|
--no-xmllint \
|
|
--format=docbook \
|
|
--destination-dir=$(builddir) \
|
|
$<
|
|
|
|
# validate the content
|
|
wsdg.validated: $(WSDG_SOURCE)
|
|
if HAVE_XMLLINT
|
|
@ echo --- WSDG - VALIDATING XML ---
|
|
$(XMLLINT) --path .:wsluarm_src:$(srcdir) --valid --noout $<
|
|
touch $@
|
|
else
|
|
@ echo --- WSDG - SKIP VALIDATION ---
|
|
endif
|
|
|
|
# create html single page file
|
|
wsdg_html: wsdg_html/index.html wsluarm
|
|
|
|
wsdg_html/index.html: $(WSDG_SOURCE)
|
|
@ echo --- WSDG - HTML SINGLE PAGE ---
|
|
mkdir -p wsdg_html/wsdg_graphics/toolbar
|
|
cp $(srcdir)/wsdg_graphics/*.* wsdg_html/wsdg_graphics
|
|
cp $(srcdir)/common_graphics/*.* wsdg_html/wsdg_graphics
|
|
cp $(srcdir)/wsdg_graphics/toolbar/* wsdg_html/wsdg_graphics/toolbar/
|
|
cp $(srcdir)/ws.css wsdg_html
|
|
$(XSLTPROC) --stringparam base.dir wsdg_html/ $(COMMON_XSLTPROC_ARGS) \
|
|
--path .:wsluarm_src \
|
|
$(WSDG_XSLTPROC_ARGS) $(SINGLE_XSLTPROC_ARGS) $< > $@
|
|
-chmod -R og+rX wsdg_html
|
|
|
|
# create html chunked page files
|
|
wsdg_html_chunked: wsdg_html_chunked/index.html
|
|
|
|
wsdg_html_chunked/index.html: $(WSDG_SOURCE)
|
|
@ echo --- WSDG - HTML CHUNKED ---
|
|
mkdir -p wsdg_html_chunked/wsdg_graphics/toolbar
|
|
cp $(srcdir)/wsdg_graphics/*.* wsdg_html_chunked/wsdg_graphics
|
|
cp $(srcdir)/common_graphics/*.* wsdg_html_chunked/wsdg_graphics
|
|
cp $(srcdir)/wsdg_graphics/toolbar/* wsdg_html_chunked/wsdg_graphics/toolbar/
|
|
cp $(srcdir)/ws.css wsdg_html_chunked
|
|
$(XSLTPROC) --stringparam base.dir wsdg_html_chunked/ $(COMMON_XSLTPROC_ARGS) \
|
|
--path .:wsluarm_src \
|
|
$(WSDG_XSLTPROC_ARGS) $(CHUNKED_XSLTPROC_ARGS) $<
|
|
-chmod -R og+rX wsdg_html_chunked
|
|
|
|
# create pdf file (through XSL-FO), portrait pages on US letter paper
|
|
# you will get lot's of errors, but that's ok
|
|
developer-guide-us.fo: $(WSDG_SOURCE) custom_layer_pdf.xsl
|
|
@ echo --- WSDG - PDF US PAPER ---
|
|
$(XSLTPROC) --stringparam paper.type letter \
|
|
--path .:wsluarm_src:$(srcdir) \
|
|
--nonet $(srcdir)/custom_layer_pdf.xsl $< > $@
|
|
|
|
# create pdf file (through XSL-FO), portrait pages on A4 paper
|
|
# you will get lot's of errors, but that's ok
|
|
developer-guide-a4.fo: $(WSDG_SOURCE) custom_layer_pdf.xsl
|
|
@ echo --- WSDG - PDF A4 PAPER ---
|
|
$(XSLTPROC) --stringparam paper.type A4 \
|
|
--path .:wsluarm_src:$(srcdir) \
|
|
--nonet $(srcdir)/custom_layer_pdf.xsl $< > $@
|
|
|
|
|
|
if HAVE_FOP
|
|
RELEASE_NOTES_TARGETS=release-notes.html release-notes.txt release-notes-a4.pdf release-notes-us.pdf
|
|
else
|
|
RELEASE_NOTES_TARGETS=release-notes.html release-notes.txt
|
|
endif
|
|
|
|
release_notes: $(RELEASE_NOTES_TARGETS)
|
|
|
|
# create html single page file
|
|
release-notes.html: $(RELEASE_NOTES_SOURCE)
|
|
@ echo --- RELEASE NOTES - HTML ---
|
|
$(A2X) --format=xhtml $(A2X_HTML_OPTS) \
|
|
--destination-dir=$(builddir) \
|
|
$(srcdir)/release-notes.asciidoc
|
|
|
|
# create txt single page file (through HTML)
|
|
release-notes.txt: $(RELEASE_NOTES_SOURCE)
|
|
@ echo --- RELEASE NOTES - TXT ---
|
|
TZ=UTC $(A2X) --format=text $(A2X_TEXT_OPTS) \
|
|
--xsltproc-opts "--stringparam generate.toc \"article nop\"" \
|
|
--destination-dir=$(builddir) \
|
|
$(srcdir)/release-notes.asciidoc
|
|
|
|
news: release-notes.txt
|
|
cp release-notes.txt ../NEWS
|
|
-cp release-notes.txt $(top_srcdir)/NEWS
|
|
|
|
# Apparently we can only run one instance of a2x at a time.
|
|
.NOTPARALLEL: release-notes-us.pdf release-notes-a4.pdf
|
|
# create pdf file, portrait pages on US letter paper
|
|
release-notes-us.pdf: $(RELEASE_NOTES_SOURCE) custom_layer_pdf.xsl
|
|
@ echo --- RELEASE NOTES - PDF US LETTER PAPER ---
|
|
$(A2X) --format=pdf $(A2X_HTML_OPTS) --fop \
|
|
--xsltproc-opts "--stringparam paper.type letter --nonet" \
|
|
--xsl-file=$(srcdir)/custom_layer_pdf.xsl \
|
|
--destination-dir=$(builddir) \
|
|
$(srcdir)/release-notes.asciidoc
|
|
|
|
# create pdf file, portrait pages on A4 paper
|
|
release-notes-a4.pdf: $(RELEASE_NOTES_SOURCE) custom_layer_pdf.xsl
|
|
@ echo --- RELEASE NOTES - PDF A4 PAPER ---
|
|
$(A2X) --format=pdf $(A2X_HTML_OPTS) --fop \
|
|
--xsltproc-opts "--stringparam paper.type A4 --nonet" \
|
|
--xsl-file=$(srcdir)/custom_layer_pdf.xsl \
|
|
--destination-dir=$(builddir) \
|
|
$(srcdir)/release-notes.asciidoc
|
|
|
|
clean-local:
|
|
-rm -rf $(CLEANDIRS)
|
|
|
|
EXTRA_DIST = \
|
|
$(WSUG_DIST) \
|
|
$(WSDG_DIST) \
|
|
$(RELEASE_NOTES_SOURCE) \
|
|
dfilter2xml.pl \
|
|
make-wsluarm.pl \
|
|
README.txt \
|
|
Makefile.nmake \
|
|
CMakeLists.txt
|
|
|
|
MAINTAINERCLEANFILES = \
|
|
Makefile.in
|