2009-12-29 12:12:26 +00:00
|
|
|
# CMakeLists.txt
|
|
|
|
#
|
|
|
|
# Wireshark - Network traffic analyzer
|
|
|
|
# By Gerald Combs <gerald@wireshark.org>
|
|
|
|
# Copyright 1998 Gerald Combs
|
|
|
|
#
|
2018-02-07 11:26:45 +00:00
|
|
|
# SPDX-License-Identifier: GPL-2.0-or-later
|
2009-12-29 12:12:26 +00:00
|
|
|
#
|
|
|
|
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
# To do:
|
|
|
|
# - Make the build targets top-level on Windows, similar to the NSIS,
|
|
|
|
# WiX, and PortableApps targets?
|
|
|
|
|
|
|
|
find_package( Asciidoctor 1.5 )
|
|
|
|
find_package( XSLTPROC )
|
|
|
|
|
|
|
|
function(set_docbook_target_properties _target)
|
|
|
|
set_target_properties(${_target} PROPERTIES
|
2021-10-20 22:23:19 +00:00
|
|
|
FOLDER "Documentation"
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
EXCLUDE_FROM_DEFAULT_BUILD True
|
|
|
|
)
|
|
|
|
endfunction(set_docbook_target_properties)
|
2017-11-18 21:53:46 +00:00
|
|
|
|
2017-08-18 19:32:17 +00:00
|
|
|
set(COMMON_FILES
|
2019-02-14 23:23:05 +00:00
|
|
|
common_src/GPL_appendix.adoc
|
2022-02-08 04:58:52 +00:00
|
|
|
common_src/typographic_conventions.adoc
|
2017-08-18 19:32:17 +00:00
|
|
|
)
|
|
|
|
|
2014-07-24 01:28:32 +00:00
|
|
|
set(COMMON_GRAPHICS
|
2022-02-08 04:58:52 +00:00
|
|
|
common_graphics/caution.svg
|
|
|
|
common_graphics/important.svg
|
2014-07-24 01:28:32 +00:00
|
|
|
common_graphics/note.svg
|
|
|
|
common_graphics/tip.svg
|
|
|
|
common_graphics/warning.svg
|
|
|
|
)
|
|
|
|
|
2018-02-11 22:34:04 +00:00
|
|
|
set(GUIDE_INSTALL_DIRS)
|
2017-09-25 21:06:37 +00:00
|
|
|
|
2021-08-26 22:44:23 +00:00
|
|
|
set(WSUG_TITLE "Wireshark User's Guide")
|
2021-08-03 20:42:20 +00:00
|
|
|
|
2009-12-29 12:12:26 +00:00
|
|
|
set(WSUG_FILES
|
2019-02-14 23:23:05 +00:00
|
|
|
wsug_src/WSUG_app_files.adoc
|
|
|
|
wsug_src/WSUG_app_howitworks.adoc
|
|
|
|
wsug_src/WSUG_app_protocols.adoc
|
|
|
|
wsug_src/WSUG_app_messages.adoc
|
|
|
|
wsug_src/WSUG_app_tools.adoc
|
|
|
|
wsug_src/WSUG_chapter_advanced.adoc
|
|
|
|
wsug_src/WSUG_chapter_build_install.adoc
|
|
|
|
wsug_src/WSUG_chapter_capture.adoc
|
|
|
|
wsug_src/WSUG_chapter_customize.adoc
|
|
|
|
wsug_src/WSUG_chapter_introduction.adoc
|
|
|
|
wsug_src/WSUG_chapter_io.adoc
|
|
|
|
wsug_src/WSUG_chapter_mate.adoc
|
|
|
|
wsug_src/WSUG_chapter_statistics.adoc
|
|
|
|
wsug_src/WSUG_chapter_telephony.adoc
|
|
|
|
wsug_src/WSUG_chapter_troubleshoot.adoc
|
|
|
|
wsug_src/WSUG_chapter_use.adoc
|
|
|
|
wsug_src/WSUG_chapter_work.adoc
|
|
|
|
wsug_src/WSUG_preface.adoc
|
2018-09-04 20:03:48 +00:00
|
|
|
wsug_src/capinfos-h.txt
|
|
|
|
wsug_src/dumpcap-h.txt
|
|
|
|
wsug_src/editcap-F.txt
|
|
|
|
wsug_src/editcap-T.txt
|
|
|
|
wsug_src/editcap-h.txt
|
|
|
|
wsug_src/mergecap-h.txt
|
|
|
|
wsug_src/rawshark-h.txt
|
|
|
|
wsug_src/reordercap-h.txt
|
|
|
|
wsug_src/text2pcap-h.txt
|
|
|
|
wsug_src/tshark-h.txt
|
2019-11-25 03:41:49 +00:00
|
|
|
wsug_src/wireshark-h.txt
|
2017-08-18 19:32:17 +00:00
|
|
|
${COMMON_FILES}
|
2014-07-17 01:38:42 +00:00
|
|
|
)
|
|
|
|
|
2021-09-12 20:45:54 +00:00
|
|
|
# Note: Images should be minimized using tools/compress-pngs.py.
|
2009-12-29 12:12:26 +00:00
|
|
|
set(WSUG_GRAPHICS
|
2016-01-09 22:24:45 +00:00
|
|
|
wsug_graphics/related-ack.png
|
|
|
|
wsug_graphics/related-current.png
|
|
|
|
wsug_graphics/related-dup-ack.png
|
|
|
|
wsug_graphics/related-first.png
|
|
|
|
wsug_graphics/related-last.png
|
|
|
|
wsug_graphics/related-other.png
|
|
|
|
wsug_graphics/related-request.png
|
|
|
|
wsug_graphics/related-response.png
|
|
|
|
wsug_graphics/related-segment.png
|
2021-04-09 23:26:17 +00:00
|
|
|
wsug_graphics/ws-about-codecs.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-analyze-menu.png
|
2018-12-30 20:29:41 +00:00
|
|
|
wsug_graphics/ws-bytes-pane-popup-menu.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-bytes-pane-tabs.png
|
|
|
|
wsug_graphics/ws-bytes-pane.png
|
2019-12-21 20:06:48 +00:00
|
|
|
wsug_graphics/ws-capture-file-properties.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-capture-info.png
|
2019-12-02 01:07:09 +00:00
|
|
|
wsug_graphics/ws-capture-interfaces-main-macos.png
|
|
|
|
wsug_graphics/ws-capture-interfaces-main-win32.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-capture-menu.png
|
|
|
|
wsug_graphics/ws-capture-options.png
|
2019-12-02 01:07:09 +00:00
|
|
|
wsug_graphics/ws-capture-options-output.png
|
|
|
|
wsug_graphics/ws-capture-options-options.png
|
2018-05-12 11:31:35 +00:00
|
|
|
wsug_graphics/ws-capture-options-compile-selected-bpfs.png
|
|
|
|
wsug_graphics/ws-capture-options-output.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-choose-color-rule.png
|
|
|
|
wsug_graphics/ws-coloring-fields.png
|
|
|
|
wsug_graphics/ws-coloring-rules-dialog.png
|
2011-01-09 22:17:14 +00:00
|
|
|
wsug_graphics/ws-column-header-popup-menu.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-decode-as.png
|
|
|
|
wsug_graphics/ws-details-pane-popup-menu.png
|
|
|
|
wsug_graphics/ws-details-pane.png
|
2022-03-21 03:38:58 +00:00
|
|
|
wsug_graphics/ws-diagram-pane.png
|
|
|
|
wsug_graphics/ws-diagram-pane-popup-menu.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-display-filter-tcp.png # GTK+
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-edit-menu.png
|
|
|
|
wsug_graphics/ws-enabled-protocols.png
|
|
|
|
wsug_graphics/ws-expert-colored-tree.png
|
|
|
|
wsug_graphics/ws-expert-column.png
|
2019-12-15 22:25:54 +00:00
|
|
|
wsug_graphics/ws-expert-information.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-export-objects.png
|
2019-12-08 17:37:09 +00:00
|
|
|
wsug_graphics/ws-export-packet-dissections.png
|
|
|
|
wsug_graphics/ws-export-specified-packets.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-export-selected.png
|
2010-11-22 12:03:28 +00:00
|
|
|
wsug_graphics/ws-file-import.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-file-menu.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-file-set-dialog.png # GTK+
|
|
|
|
wsug_graphics/ws-filter-add-expression.png # GTK+
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-filter-toolbar.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-filters.png # GTK+
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-find-packet.png
|
2021-04-14 13:47:07 +00:00
|
|
|
wsug_graphics/ws-follow-sip-stream.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-follow-stream.png
|
2019-02-27 04:55:52 +00:00
|
|
|
wsug_graphics/ws-follow-http2-stream.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-go-menu.png
|
|
|
|
wsug_graphics/ws-goto-packet.png
|
|
|
|
wsug_graphics/ws-gui-preferences.png
|
2020-04-24 21:19:54 +00:00
|
|
|
wsug_graphics/ws-gui-preferences-advanced.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-help-menu.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-list-pane.png # Outdated
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-main-toolbar.png
|
|
|
|
wsug_graphics/ws-main.png
|
2019-12-02 01:07:09 +00:00
|
|
|
wsug_graphics/ws-manage-interfaces.png
|
2016-07-04 21:21:28 +00:00
|
|
|
wsug_graphics/ws-mate-analysis.png
|
|
|
|
wsug_graphics/ws-mate-dns_pane.png
|
|
|
|
wsug_graphics/ws-mate-dns_pdu.png
|
|
|
|
wsug_graphics/ws-mate-ftp_over_gre.png
|
|
|
|
wsug_graphics/ws-mate-gop_analysis.png
|
|
|
|
wsug_graphics/ws-mate-isup_over_mtp3_over_ip.png
|
|
|
|
wsug_graphics/ws-mate-mmse_over_http.png
|
|
|
|
wsug_graphics/ws-mate-pdu_analysis.png
|
|
|
|
wsug_graphics/ws-mate-tcp-output.png
|
|
|
|
wsug_graphics/ws-mate-transform.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-menu.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-merge-qt5.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-merge-win32.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-open-qt5.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-open-win32.png
|
2019-12-08 17:37:09 +00:00
|
|
|
wsug_graphics/ws-packet-format.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-packet-pane-popup-menu.png
|
2019-12-08 17:37:09 +00:00
|
|
|
wsug_graphics/ws-packet-range.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-packet-selected.png
|
|
|
|
wsug_graphics/ws-packet-sep-win.png
|
|
|
|
wsug_graphics/ws-print.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-save-as-qt5.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-save-as-win32.png
|
|
|
|
wsug_graphics/ws-statistics-menu.png
|
|
|
|
wsug_graphics/ws-stats-conversations.png
|
|
|
|
wsug_graphics/ws-stats-endpoints.png
|
|
|
|
wsug_graphics/ws-stats-hierarchy.png
|
2020-03-14 22:17:39 +00:00
|
|
|
wsug_graphics/ws-stats-iographs.png
|
2019-12-31 23:35:50 +00:00
|
|
|
wsug_graphics/ws-stats-packet-lengths.png
|
2020-03-14 22:17:39 +00:00
|
|
|
wsug_graphics/ws-stats-srt-smb2.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-stats-lte-mac-traffic.png
|
2010-01-22 12:42:53 +00:00
|
|
|
wsug_graphics/ws-stats-lte-rlc-traffic.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-stats-wlan-traffic.png # GTK+
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-statusbar-empty.png
|
2018-05-12 11:31:35 +00:00
|
|
|
wsug_graphics/ws-statusbar-filter.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-statusbar-loaded.png
|
2018-05-12 11:31:35 +00:00
|
|
|
wsug_graphics/ws-statusbar-profile.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-statusbar-selected.png
|
2018-05-12 11:31:35 +00:00
|
|
|
wsug_graphics/ws-tcp-analysis.png
|
2021-04-09 23:26:17 +00:00
|
|
|
wsug_graphics/ws-tel-playlist.png
|
|
|
|
wsug_graphics/ws-tel-rtp-player_1.png
|
|
|
|
wsug_graphics/ws-tel-rtp-player_2.png
|
|
|
|
wsug_graphics/ws-tel-rtp-player_3.png
|
|
|
|
wsug_graphics/ws-tel-rtp-player_button.png
|
|
|
|
wsug_graphics/ws-tel-rtp-streams.png
|
|
|
|
wsug_graphics/ws-tel-rtpstream-analysis_1.png
|
|
|
|
wsug_graphics/ws-tel-rtpstream-analysis_2.png
|
|
|
|
wsug_graphics/ws-tel-rtpstream-analysis_3.png
|
|
|
|
wsug_graphics/ws-tel-seq-dialog.png
|
|
|
|
wsug_graphics/ws-tel-voip-calls.png
|
2011-01-09 22:17:14 +00:00
|
|
|
wsug_graphics/ws-telephony-menu.png
|
2019-12-07 17:06:29 +00:00
|
|
|
wsug_graphics/ws-time-reference.png # GTK+
|
2011-01-09 22:17:14 +00:00
|
|
|
wsug_graphics/ws-tools-menu.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsug_graphics/ws-view-menu.png
|
2018-08-21 21:58:29 +00:00
|
|
|
wsug_graphics/toolbar/document-open.png
|
|
|
|
wsug_graphics/toolbar/edit-find.png
|
|
|
|
wsug_graphics/toolbar/filter-toolbar-add.png
|
|
|
|
wsug_graphics/toolbar/filter-toolbar-apply.png
|
|
|
|
wsug_graphics/toolbar/filter-toolbar-bookmark.png
|
|
|
|
wsug_graphics/toolbar/filter-toolbar-clear.png
|
|
|
|
wsug_graphics/toolbar/filter-toolbar-input.png
|
|
|
|
wsug_graphics/toolbar/filter-toolbar-recent.png
|
|
|
|
wsug_graphics/toolbar/go-first.png
|
|
|
|
wsug_graphics/toolbar/go-jump.png
|
|
|
|
wsug_graphics/toolbar/go-last.png
|
|
|
|
wsug_graphics/toolbar/go-next.png
|
|
|
|
wsug_graphics/toolbar/go-previous.png
|
|
|
|
wsug_graphics/toolbar/x-capture-file-close.png
|
|
|
|
wsug_graphics/toolbar/x-capture-file-reload.png
|
|
|
|
wsug_graphics/toolbar/x-capture-file-save.png
|
|
|
|
wsug_graphics/toolbar/x-capture-options.png
|
|
|
|
wsug_graphics/toolbar/x-capture-restart.png
|
|
|
|
wsug_graphics/toolbar/x-capture-start.png
|
|
|
|
wsug_graphics/toolbar/x-capture-stop.png
|
|
|
|
wsug_graphics/toolbar/x-colorize-packets.png
|
|
|
|
wsug_graphics/toolbar/x-resize-columns.png
|
|
|
|
wsug_graphics/toolbar/x-stay-last.png
|
|
|
|
wsug_graphics/toolbar/zoom-in.png
|
|
|
|
wsug_graphics/toolbar/zoom-original.png
|
|
|
|
wsug_graphics/toolbar/zoom-out.png
|
2014-07-24 01:28:32 +00:00
|
|
|
${COMMON_GRAPHICS}
|
2009-12-29 12:12:26 +00:00
|
|
|
)
|
|
|
|
|
2021-08-26 22:44:23 +00:00
|
|
|
set(WSDG_TITLE "Wireshark Developer's Guide")
|
2021-08-03 20:42:20 +00:00
|
|
|
|
2009-12-29 12:12:26 +00:00
|
|
|
set(WSDG_FILES
|
2020-04-02 17:55:10 +00:00
|
|
|
wsdg_src/WSDG_chapter_asn2wrs.adoc
|
2019-02-14 23:23:05 +00:00
|
|
|
wsdg_src/WSDG_chapter_build_intro.adoc
|
|
|
|
wsdg_src/WSDG_chapter_capture.adoc
|
|
|
|
wsdg_src/WSDG_chapter_dissection.adoc
|
|
|
|
wsdg_src/WSDG_chapter_env_intro.adoc
|
|
|
|
wsdg_src/WSDG_chapter_libraries.adoc
|
|
|
|
wsdg_src/WSDG_chapter_quick_setup.adoc
|
|
|
|
wsdg_src/WSDG_chapter_sources.adoc
|
|
|
|
wsdg_src/WSDG_chapter_tests.adoc
|
|
|
|
wsdg_src/WSDG_chapter_tools.adoc
|
|
|
|
wsdg_src/WSDG_chapter_userinterface.adoc
|
|
|
|
wsdg_src/WSDG_chapter_works.adoc
|
|
|
|
wsdg_src/WSDG_preface.adoc
|
|
|
|
wsluarm.adoc
|
2017-08-18 19:32:17 +00:00
|
|
|
${COMMON_FILES}
|
2014-01-24 01:10:10 +00:00
|
|
|
)
|
|
|
|
|
2009-12-29 12:12:26 +00:00
|
|
|
set(WSDG_GRAPHICS
|
2020-07-28 01:11:02 +00:00
|
|
|
wsdg_graphics/git-triangular-workflow.gv
|
|
|
|
wsdg_graphics/git-triangular-workflow.svg
|
|
|
|
wsdg_graphics/ws-capture-sync.png
|
2009-12-29 12:12:26 +00:00
|
|
|
wsdg_graphics/ws-capture-sync.dia
|
|
|
|
wsdg_graphics/ws-capture-sync.png
|
|
|
|
wsdg_graphics/ws-capture_internals.dia
|
|
|
|
wsdg_graphics/ws-capture_internals.png
|
|
|
|
wsdg_graphics/ws-function-blocks.dia
|
|
|
|
wsdg_graphics/ws-function-blocks.png
|
|
|
|
wsdg_graphics/ws-logo.png
|
2014-07-24 01:28:32 +00:00
|
|
|
${COMMON_GRAPHICS}
|
2009-12-29 12:12:26 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
set(WSUG_SOURCE
|
|
|
|
${WSUG_FILES}
|
|
|
|
${WSUG_GRAPHICS}
|
|
|
|
)
|
|
|
|
|
2018-11-09 11:08:01 +00:00
|
|
|
# Ensure ws.css is available when the user tries to open generated .html files.
|
2015-11-21 12:13:39 +00:00
|
|
|
if(NOT CMAKE_SOURCE_DIR STREQUAL CMAKE_BINARY_DIR)
|
|
|
|
add_custom_command(
|
|
|
|
OUTPUT ws.css
|
|
|
|
COMMAND ${CMAKE_COMMAND} -E copy_if_different
|
|
|
|
${CMAKE_CURRENT_SOURCE_DIR}/ws.css
|
|
|
|
${CMAKE_CURRENT_BINARY_DIR}/ws.css
|
|
|
|
DEPENDS
|
|
|
|
${CMAKE_CURRENT_SOURCE_DIR}/ws.css
|
|
|
|
)
|
2018-11-09 11:08:01 +00:00
|
|
|
add_custom_target(copy_ws.css DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/ws.css)
|
|
|
|
else()
|
|
|
|
add_custom_target(copy_ws.css)
|
2015-11-21 12:13:39 +00:00
|
|
|
endif()
|
2014-12-11 00:50:56 +00:00
|
|
|
|
2018-11-09 11:08:01 +00:00
|
|
|
set( WSUG_BUILT_DEPS copy_ws.css)
|
2014-01-25 00:17:19 +00:00
|
|
|
|
2009-12-29 12:12:26 +00:00
|
|
|
set(WSDG_SOURCE
|
|
|
|
${WSDG_FILES}
|
|
|
|
${WSDG_GRAPHICS}
|
|
|
|
)
|
|
|
|
|
2015-07-07 15:30:44 +00:00
|
|
|
# Note: file order here MATTERS!
|
|
|
|
# new WSLUA_MODULE files must come right before any WSLUA_CONTINUE_MODULE
|
|
|
|
# files for the same module
|
2009-12-29 12:12:26 +00:00
|
|
|
set(WSLUA_MODULES
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_dumper.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_field.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_gui.c
|
2014-02-03 03:49:30 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_int64.c
|
2009-12-29 12:12:26 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_listener.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_pinfo.c
|
2015-07-07 15:30:44 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_address.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_column.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_nstime.c
|
2009-12-29 12:12:26 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_proto.c
|
2015-07-07 15:30:44 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_dissector.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_pref.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_proto_expert.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_proto_field.c
|
2009-12-29 12:12:26 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_tree.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_tvb.c
|
2015-07-07 15:30:44 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_byte_array.c
|
2014-03-18 17:21:51 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_file.c
|
2015-07-07 15:30:44 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_file_handler.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_frame_info.c
|
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_capture_info.c
|
2014-03-26 06:24:51 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_dir.c
|
2021-02-13 03:29:33 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_wtap.c
|
2022-07-23 23:19:49 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_utility.c
|
2014-02-03 03:49:30 +00:00
|
|
|
${CMAKE_SOURCE_DIR}/epan/wslua/wslua_struct.c
|
2009-12-29 12:12:26 +00:00
|
|
|
)
|
|
|
|
|
2015-08-08 01:17:04 +00:00
|
|
|
# Empty file to trigger wsluarm generation.
|
|
|
|
ADD_CUSTOM_COMMAND(
|
|
|
|
OUTPUT
|
|
|
|
wsluarm
|
|
|
|
COMMAND ${CMAKE_COMMAND} -E make_directory wsluarm_src
|
2022-06-30 01:33:36 +00:00
|
|
|
COMMAND ${PYTHON_EXECUTABLE}
|
|
|
|
${CMAKE_CURRENT_SOURCE_DIR}/make-wsluarm.py
|
|
|
|
--output-directory wsluarm_src
|
2015-08-08 01:17:04 +00:00
|
|
|
${WSLUA_MODULES}
|
|
|
|
COMMAND ${CMAKE_COMMAND} -E touch
|
|
|
|
wsluarm
|
|
|
|
DEPENDS
|
2022-06-30 01:33:36 +00:00
|
|
|
${CMAKE_CURRENT_SOURCE_DIR}/make-wsluarm.py
|
2015-08-08 01:17:04 +00:00
|
|
|
${WSLUA_MODULES}
|
|
|
|
)
|
|
|
|
|
2018-11-09 11:08:01 +00:00
|
|
|
set( WSDG_BUILT_DEPS copy_ws.css wsluarm )
|
2015-08-08 01:17:04 +00:00
|
|
|
|
2016-12-15 19:54:01 +00:00
|
|
|
set( ASCIIDOC_CONF_FILES
|
2019-02-14 23:23:05 +00:00
|
|
|
attributes.adoc
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
# XXX Add macros
|
2016-12-15 19:54:01 +00:00
|
|
|
)
|
|
|
|
|
2018-07-03 09:42:20 +00:00
|
|
|
if(ASCIIDOCTOR_FOUND)
|
2015-08-08 22:44:02 +00:00
|
|
|
# Generate the DocBook sources of user and developer guides
|
2015-08-08 01:17:04 +00:00
|
|
|
|
2019-02-14 23:23:05 +00:00
|
|
|
ASCIIDOCTOR2DOCBOOK(user-guide.adoc ${ASCIIDOC_CONF_FILES} ${WSUG_SOURCE} ${WSUG_BUILT_DEPS})
|
2016-02-26 00:03:45 +00:00
|
|
|
add_custom_target(user_guide_docbook DEPENDS generate_user-guide.xml)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(user_guide_docbook)
|
2015-08-08 01:17:04 +00:00
|
|
|
|
2019-02-14 23:23:05 +00:00
|
|
|
ASCIIDOCTOR2DOCBOOK(developer-guide.adoc ${ASCIIDOC_CONF_FILES} ${WSDG_SOURCE} ${WSDG_BUILT_DEPS})
|
2016-02-26 00:03:45 +00:00
|
|
|
add_custom_target(developer_guide_docbook DEPENDS generate_developer-guide.xml)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(developer_guide_docbook)
|
2015-08-08 22:44:02 +00:00
|
|
|
|
|
|
|
# Top-level guide targets.
|
|
|
|
|
|
|
|
add_custom_target(user_guides DEPENDS user_guide_docbook)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(user_guides)
|
2015-08-08 22:44:02 +00:00
|
|
|
|
|
|
|
add_custom_target(developer_guides DEPENDS developer_guide_docbook)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(developer_guides)
|
2015-08-08 22:44:02 +00:00
|
|
|
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
add_custom_target(all_guides DEPENDS user_guides developer_guides )
|
|
|
|
set_docbook_target_properties(all_guides)
|
2015-08-08 22:44:02 +00:00
|
|
|
endif()
|
2015-08-08 01:17:04 +00:00
|
|
|
|
|
|
|
# User's Guide chain.
|
2018-07-03 09:42:20 +00:00
|
|
|
if(ASCIIDOCTOR_FOUND AND XSLTPROC_EXECUTABLE)
|
2015-08-08 01:17:04 +00:00
|
|
|
XML2HTML(
|
|
|
|
user_guide
|
|
|
|
wsug
|
|
|
|
single-page
|
|
|
|
user-guide.xml
|
|
|
|
WSUG_GRAPHICS
|
|
|
|
)
|
|
|
|
|
|
|
|
XML2HTML(
|
|
|
|
user_guide
|
|
|
|
wsug
|
|
|
|
chunked
|
|
|
|
user-guide.xml
|
|
|
|
WSUG_GRAPHICS
|
|
|
|
)
|
2015-08-07 22:08:22 +00:00
|
|
|
add_custom_target(
|
|
|
|
user_guide_html
|
|
|
|
DEPENDS
|
2015-08-08 01:17:04 +00:00
|
|
|
wsug_html/index.html
|
|
|
|
wsug_html_chunked/index.html
|
2015-08-07 22:08:22 +00:00
|
|
|
)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(user_guide_html)
|
2015-08-07 22:08:22 +00:00
|
|
|
add_dependencies(user_guides user_guide_html)
|
2018-02-11 22:34:04 +00:00
|
|
|
list(APPEND GUIDE_INSTALL_DIRS ${CMAKE_CURRENT_BINARY_DIR}/wsug_html_chunked)
|
2014-12-11 00:50:56 +00:00
|
|
|
endif()
|
|
|
|
|
2018-07-03 09:42:20 +00:00
|
|
|
if(ASCIIDOCTOR_FOUND AND ASCIIDOCTOR_PDF_EXECUTABLE)
|
2021-08-03 20:42:20 +00:00
|
|
|
ASCIIDOCTOR2PDF(${WSUG_TITLE} user-guide.adoc ${WSUG_SOURCE} ${WSUG_BUILT_DEPS})
|
2015-08-07 22:08:22 +00:00
|
|
|
|
2015-08-08 01:17:04 +00:00
|
|
|
add_custom_target(
|
2018-01-23 19:02:16 +00:00
|
|
|
user_guide_pdf
|
2015-08-08 01:17:04 +00:00
|
|
|
DEPENDS
|
2021-08-03 20:42:20 +00:00
|
|
|
"${WSUG_TITLE}.pdf"
|
2015-08-08 01:17:04 +00:00
|
|
|
)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(user_guide_pdf)
|
2018-01-23 19:02:16 +00:00
|
|
|
add_dependencies(user_guides user_guide_pdf)
|
2014-12-11 00:50:56 +00:00
|
|
|
endif()
|
|
|
|
|
2021-07-28 17:23:50 +00:00
|
|
|
if(ASCIIDOCTOR_FOUND AND ASCIIDOCTOR_EPUB_EXECUTABLE)
|
2021-08-03 20:42:20 +00:00
|
|
|
ASCIIDOCTOR2EPUB(${WSUG_TITLE} user-guide.adoc ${WSUG_SOURCE} ${WSUG_BUILT_DEPS})
|
2021-07-28 17:23:50 +00:00
|
|
|
|
|
|
|
add_custom_target(
|
|
|
|
user_guide_epub
|
|
|
|
DEPENDS
|
2021-08-03 20:42:20 +00:00
|
|
|
"${WSUG_TITLE}.epub"
|
2021-07-28 17:23:50 +00:00
|
|
|
)
|
|
|
|
set_docbook_target_properties(user_guide_epub)
|
|
|
|
add_dependencies(user_guides user_guide_epub)
|
|
|
|
endif()
|
|
|
|
|
2015-08-08 01:17:04 +00:00
|
|
|
# Developer's Guide chain.
|
2018-07-03 09:42:20 +00:00
|
|
|
if(ASCIIDOCTOR_FOUND AND XSLTPROC_EXECUTABLE)
|
2015-08-08 01:17:04 +00:00
|
|
|
XML2HTML(
|
|
|
|
developer_guide
|
|
|
|
wsdg
|
|
|
|
single-page
|
|
|
|
developer-guide.xml
|
|
|
|
WSDG_GRAPHICS
|
|
|
|
)
|
|
|
|
|
|
|
|
XML2HTML(
|
|
|
|
developer_guide
|
|
|
|
wsdg
|
|
|
|
chunked
|
|
|
|
developer-guide.xml
|
|
|
|
WSDG_GRAPHICS
|
|
|
|
)
|
2015-08-07 22:08:22 +00:00
|
|
|
add_custom_target(
|
|
|
|
developer_guide_html
|
|
|
|
DEPENDS
|
2015-08-08 01:17:04 +00:00
|
|
|
wsdg_html/index.html
|
|
|
|
wsdg_html_chunked/index.html
|
2015-08-07 22:08:22 +00:00
|
|
|
)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(developer_guide_html)
|
2015-08-07 22:08:22 +00:00
|
|
|
add_dependencies(developer_guides developer_guide_html)
|
2018-02-11 22:34:04 +00:00
|
|
|
list(APPEND GUIDE_INSTALL_DIRS ${CMAKE_CURRENT_BINARY_DIR}/wsdg_html_chunked)
|
2014-12-11 00:50:56 +00:00
|
|
|
endif()
|
|
|
|
|
2018-07-03 09:42:20 +00:00
|
|
|
if(ASCIIDOCTOR_FOUND AND ASCIIDOCTOR_PDF_EXECUTABLE)
|
2021-08-03 20:42:20 +00:00
|
|
|
ASCIIDOCTOR2PDF(${WSDG_TITLE} developer-guide.adoc ${WSDG_SOURCE} ${WSDG_BUILT_DEPS})
|
2015-08-07 22:08:22 +00:00
|
|
|
|
2015-08-08 01:17:04 +00:00
|
|
|
add_custom_target(
|
2018-01-23 19:02:16 +00:00
|
|
|
developer_guide_pdf
|
2015-08-08 01:17:04 +00:00
|
|
|
DEPENDS
|
2021-08-03 20:42:20 +00:00
|
|
|
"${WSDG_TITLE}.pdf"
|
2015-08-08 01:17:04 +00:00
|
|
|
)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(developer_guide_pdf)
|
2018-01-23 19:02:16 +00:00
|
|
|
add_dependencies(developer_guides developer_guide_pdf)
|
2014-12-11 00:50:56 +00:00
|
|
|
endif()
|
|
|
|
|
2021-07-28 17:23:50 +00:00
|
|
|
if(ASCIIDOCTOR_FOUND AND ASCIIDOCTOR_EPUB_EXECUTABLE)
|
2021-08-03 20:42:20 +00:00
|
|
|
ASCIIDOCTOR2EPUB(${WSDG_TITLE} developer-guide.adoc ${WSDG_SOURCE} ${WSDG_BUILT_DEPS})
|
2021-07-28 17:23:50 +00:00
|
|
|
|
|
|
|
add_custom_target(
|
|
|
|
developer_guide_epub
|
|
|
|
DEPENDS
|
2021-08-03 20:42:20 +00:00
|
|
|
"${WSDG_TITLE}.epub"
|
2021-07-28 17:23:50 +00:00
|
|
|
)
|
|
|
|
set_docbook_target_properties(developer_guide_epub)
|
|
|
|
add_dependencies(developer_guides developer_guide_epub)
|
|
|
|
endif()
|
|
|
|
|
2018-02-11 22:34:04 +00:00
|
|
|
if (GUIDE_INSTALL_DIRS)
|
|
|
|
# The installation location and DOC_DIR in ui/help_url.c must
|
|
|
|
# match.
|
|
|
|
add_custom_target(install_guides
|
|
|
|
COMMAND ${CMAKE_COMMAND} -P
|
|
|
|
${CMAKE_SOURCE_DIR}/cmake/modules/FileInstall.cmake
|
|
|
|
${GUIDE_INSTALL_DIRS}
|
|
|
|
${CMAKE_INSTALL_FULL_DOCDIR}
|
|
|
|
DEPENDS
|
|
|
|
user_guide_html developer_guide_html
|
|
|
|
)
|
|
|
|
set_docbook_target_properties(install_guides)
|
|
|
|
endif()
|
|
|
|
|
2018-01-23 19:02:16 +00:00
|
|
|
# release_notes: release-notes.html release-notes.txt
|
2009-12-29 12:12:26 +00:00
|
|
|
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
add_custom_target( release_notes_html DEPENDS release-notes.html )
|
|
|
|
set_docbook_target_properties(release_notes_html)
|
2014-12-11 00:50:56 +00:00
|
|
|
add_custom_target( release_notes_txt DEPENDS release-notes.txt )
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(release_notes_txt)
|
2013-11-01 09:55:26 +00:00
|
|
|
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
# Force serial execution so that separate asciidoctor instances don't
|
|
|
|
# trip on each other
|
|
|
|
# add_dependencies ( release_notes_txt release_notes_html )
|
2014-12-11 00:50:56 +00:00
|
|
|
|
|
|
|
add_custom_target( release_notes )
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(release_notes)
|
2014-12-11 00:50:56 +00:00
|
|
|
add_dependencies ( release_notes release_notes_txt release_notes_html )
|
|
|
|
|
|
|
|
add_custom_target(
|
|
|
|
news
|
|
|
|
COMMAND ${CMAKE_COMMAND} -E copy_if_different
|
2013-11-01 09:55:26 +00:00
|
|
|
${CMAKE_CURRENT_BINARY_DIR}/release-notes.txt
|
|
|
|
${CMAKE_SOURCE_DIR}/NEWS
|
|
|
|
DEPENDS
|
2015-11-21 12:13:39 +00:00
|
|
|
${CMAKE_CURRENT_BINARY_DIR}/release-notes.txt
|
2013-11-01 09:55:26 +00:00
|
|
|
)
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
set_docbook_target_properties(news)
|
2013-11-01 09:55:26 +00:00
|
|
|
|
Switch from AsciiDoc to Asciidoctor.
Switch the markup text processor for files in the docbook directory from
AsciiDoc to Asciidoctor. Asciidoctor has several useful features (such
as direct PDF output) and is actively developed. It's written in Ruby
but that dependency can be sidestepped with AsciidoctorJ, a
self-contained bundle that only depends on the JRE.
The current toolchain targets require Python, AsciiDoc, DocBook XML,
DocBook XSL, Java, FOP, xsltproc, lynx, and the HTMLHelp compiler:
HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: AsciiDoc → DocBook XML → xsltproc + DocBook XSL
PDF: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → FOP
HTMLHelp: AsciiDoc → DocBook XML → xsltproc + DocBook XSL → HHC
This change removes the AsciiDoc and FOP requirements and adds either
AsciidoctorJ or Asciidoctor + Ruby:
HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
Chunked HTML: Asciidoctor → DocBook XML → xsltproc + DocBook XSL
PDF: Asciidoctor
HTMLHelp: Asciidoctor → DocBook XML → xsltproc + DocBook XSL → HHC
Ideally we could generate all of these using AsciidoctorJ, Java, and
lynx. Unfortunately we're not there yet.
The release notes depend on several macros (ws-buglink, ws-salink,
cve-idlink, sort-and-group). Add Asciidoctor (Ruby) equivalents.
Remove the BUILD_xxx_GUIDES CMake options and add various output targets
automatically. This means that you have to build the various documentation
targets explicitly.
Change-Id: I31930677a656b99b1c6839bb6c33a13db951eb9a
Reviewed-on: https://code.wireshark.org/review/25668
Petri-Dish: Gerald Combs <gerald@wireshark.org>
Tested-by: Petri Dish Buildbot
Reviewed-by: Gerald Combs <gerald@wireshark.org>
2017-10-19 22:03:55 +00:00
|
|
|
if( ASCIIDOCTOR_FOUND )
|
2021-10-11 21:36:58 +00:00
|
|
|
ASCIIDOCTOR2HTML( release-notes.adoc )
|
2019-02-14 23:23:05 +00:00
|
|
|
ASCIIDOCTOR2TXT( release-notes.adoc )
|
2017-11-18 21:53:46 +00:00
|
|
|
endif()
|
2013-11-01 09:55:26 +00:00
|
|
|
|
2019-02-11 22:24:18 +00:00
|
|
|
# FAQ
|
|
|
|
|
|
|
|
add_custom_target( faq_html DEPENDS faq.html )
|
|
|
|
set_docbook_target_properties(faq_html)
|
|
|
|
|
|
|
|
add_custom_target( faq )
|
|
|
|
set_docbook_target_properties(faq)
|
|
|
|
add_dependencies ( faq faq_html )
|
|
|
|
|
|
|
|
if( ASCIIDOCTOR_FOUND )
|
2021-10-11 21:36:58 +00:00
|
|
|
ASCIIDOCTOR2HTML( faq.adoc )
|
2019-02-11 22:24:18 +00:00
|
|
|
endif()
|
|
|
|
|
2016-10-16 22:35:50 +00:00
|
|
|
#
|
2019-07-26 18:43:17 +00:00
|
|
|
# Editor modelines - https://www.wireshark.org/tools/modelines.html
|
2016-10-16 22:35:50 +00:00
|
|
|
#
|
|
|
|
# Local variables:
|
|
|
|
# c-basic-offset: 8
|
|
|
|
# tab-width: 8
|
|
|
|
# indent-tabs-mode: t
|
|
|
|
# End:
|
|
|
|
#
|
|
|
|
# vi: set shiftwidth=8 tabstop=8 noexpandtab:
|
|
|
|
# :indentSize=8:tabSize=8:noTabs=false:
|
|
|
|
#
|