Wireshark-commits: [Wireshark-commits] master 23c9a1e: Convert the FAQ to Asciidoctor and remove ol
From: Wireshark code review <code-review-do-not-reply@xxxxxxxxxxxxx>
Date: Thu, 14 Feb 2019 23:11:21 +0000
URL: https://code.wireshark.org/review/gitweb?p=wireshark.git;a=commit;h=23c9a1e036445c17ec4bbc5d0fcbea4f588253c1
Submitter: "Gerald Combs <gerald@xxxxxxxxxxxxx>"
Changed: branch: master
Repository: wireshark

Commits:

23c9a1e by Gerald Combs (gerald@xxxxxxxxxxxxx):

    Convert the FAQ to Asciidoctor and remove old help files.
    
    Convert our self-generating FAQ to Asciidoctor via the following steps:
    
    - `help/faq.py > /tmp/faq.html`.
    - `pandoc -t asciidoc -o docbook/faq.adoc /tmp/faq.html`.
    - Manually clean up the markup using a text editor.
    
    Question and answer content was left intact. Removing or updating
    obsolete content will have to be done in a separate change.
    
    The Asciidoctor project uses the .adoc extension, so start using it here
    as well.
    
    The contents of the "help" directory appear to have been used for
    offline support in help_url.c, but that functionality was removed in
    2008 in 242e3b78bc. Its content is covered in the User's Guide and man
    pages so remove it.
    
    Change-Id: I9060eefe97cfc137f8b414077c30f814379b576a
    Reviewed-on: https://code.wireshark.org/review/32014
    Petri-Dish: Gerald Combs <gerald@xxxxxxxxxxxxx>
    Tested-by: Petri Dish Buildbot
    Reviewed-by: Gerald Combs <gerald@xxxxxxxxxxxxx>
    

Actions performed:

    from  ef0ef16   macOS: Try to work around .dmg packaging issues.
     add  23c9a1e   Convert the FAQ to Asciidoctor and remove old help files.


Summary of changes:
 CMakeLists.txt                    |   58 +-
 docbook/CMakeLists.txt            |   13 +
 docbook/faq.adoc                  | 1108 ++++++++++++++++++++++
 help/capture_filters.txt          |   78 --
 help/capturing.txt                |   82 --
 help/display_filters.txt          |   41 -
 help/faq.py                       | 1822 -------------------------------------
 help/getting_started.txt          |   91 --
 help/overview.txt                 |   36 -
 help/toc                          |    6 -
 packaging/nsis/CMakeLists.txt     |    3 +-
 packaging/nsis/config.nsh.in      |    2 +-
 packaging/nsis/wireshark.nsi      |   11 +-
 packaging/wix/CMakeLists.txt      |    3 +-
 packaging/wix/ComponentGroups.wxi |   53 +-
 packaging/wix/Features.wxi        |    7 +-
 ui/help_url.c                     |    2 +-
 17 files changed, 1151 insertions(+), 2265 deletions(-)
 create mode 100755 docbook/faq.adoc
 delete mode 100644 help/capture_filters.txt
 delete mode 100644 help/capturing.txt
 delete mode 100644 help/display_filters.txt
 delete mode 100755 help/faq.py
 delete mode 100644 help/getting_started.txt
 delete mode 100644 help/overview.txt
 delete mode 100644 help/toc