[Gerald Combs <gerald@xxxxxxxxxxxxx>]

We use features that are specific to Asciidoctor, particularly the 
macros in docbook/asciidoctor-macros, so AsciiDoc probably won't work.

On 7/7/22 2:07 PM, chuck c wrote:
> If that doesn't work, here are examples to load asciidoctor:
>
> https://gitlab.com/wireshark/wireshark/-/commit/7f475116532f204e7a461bbc6886d80c5e0c4ef2 
> <https://gitlab.com/wireshark/wireshark/-/commit/7f475116532f204e7a461bbc6886d80c5e0c4ef2>
> dnf install -y ruby
> gem install asciidoctor
>
> https://docs.asciidoctor.org/asciidoctor/latest/install/linux-packaging/#dnf 
> <https://docs.asciidoctor.org/asciidoctor/latest/install/linux-packaging/#dnf>
> "DNF
> On RPM-based Linux distributions, such as Fedora, CentOS, and RHEL, use 
> the DNF package manager to install Asciidoctor.
> ..."
>
> There is also one in EPEL (not sure if it pulls in pre-reqs):
> https://centos.pkgs.org/8/epel-x86_64/rubygem-asciidoctor-2.0.15-3.el8.noarch.rpm.html 
> <https://centos.pkgs.org/8/epel-x86_64/rubygem-asciidoctor-2.0.15-3.el8.noarch.rpm.html>
>
>
>
> On Thu, Jul 7, 2022 at 2:01 PM The Tibetan Traveller <garnet@xxxxxxxxxx 
> <mailto:garnet@xxxxxxxxxx>> wrote:
>
>     __
>
>     I put in a softlink for asciidoctor to asciidoc and the 'cmake'
>     command found it. I am currently recompiling it to see if it
>     installs the man pages.
>
>     On Thursday, July 07, 2022 02:55:09 PM The Tibetan Traveller wrote:
>
>      > It appears to be installed:
>
>      >
>
>      > [sngsacc@freya wireshark-3.6.6]$ rpm -qa | grep ascii
>
>      > sciidoc-8.6.10-0.5.20180627gitf7c2274.el8.noarch
>
>      > [sngsacc@freya wireshark-3.6.6]$ rpm -ql asciidoc | grep bin
>
>      > /usr/bin/a2x
>
>      > /usr/bin/a2x.py
>
>      > /usr/bin/asciidoc
>
>      > /usr/bin/asciidoc.py
>
>      > [sngsacc@freya wireshark-3.6.6]$ which asciidoc
>
>      > /usr/bin/asciidoc
>
>      >
>
>      > Should I put a link connecting asciidoctor to asciidoc?
>
>      >
>
>      >
>
>      > On Thursday, July 07, 2022 01:43:48 PM chuck c wrote:
>
>      >
>
>      >
>     https://www.wireshark.org/docs/wsdg_html/#ChToolsDocumentationToolchai
>     <https://www.wireshark.org/docs/wsdg_html/#ChToolsDocumentationToolchai>
>
>      > n
>
>      >
>
>      > > "The doc directory contains man pages written in Asciidoctor
>     markup."
>
>      > >
>
>      > > -- The following OPTIONAL packages have not been found:
>
>      > > * Asciidoctor (required version >= 1.5)
>
>      > >
>
>      > > Is Asciidoctor installed? On the PATH?
>
>      > >
>
>      > > On Thu, Jul 7, 2022 at 1:23 PM The Tibetan Traveller
>
>      >
>
>      > <garnet@xxxxxxxxxx <mailto:garnet@xxxxxxxxxx>>
>
>      >
>
>      > > wrote:
>
>      > > > I am trying to compile wireshark 3.6.6 from source on a rhel8
>     server;
>
>      >
>
>      > but,
>
>      >
>
>      > > > can not seem to get the man pages installed. I downloaded the
>
>      >
>
>      > source
>
>      >
>
>      > > > tarball from wireshark.org <http://wireshark.org>. untarred
>     it. Changed into the
>
>      >
>
>      > wireshark-3.6.6
>
>      >
>
>      > > > directory. Issued the following commands:
>
>      > > >
>
>      > > >
>
>      > > > cmake -G "Unix Makefiles"
>
>      > > >
>
>      > > > make
>
>      > > >
>
>      > > > make DESTDIR=/tmp/rpmbuild install
>
>      > > >
>
>      > > >
>
>      > > > perl, python3, GNU 'make', pod2man, & flex are installed.
>
>      > > >
>
>      > > >
>
>      > > >
>
>      > > > I can see the binaries; but, I can't see any man pages. I
>     searched the
>
>      > > > INSTALL & README files & couldn't see any type of switches
>     for turning
>
>      >
>
>      > the
>
>      >
>
>      > > > man pages on or off. Searching the web wasn't any help since
>
>      >
>
>      > "compile
>
>      >
>
>      > > > wireshark man pages" just links me to the man pages on the web.
>
>      > > >
>
>      > > >
>
>      > > > The output of the cmake command:
>
>      > > >
>
>      > > >
>
>      > > >
>
>      > > > -- The following OPTIONAL packages have been found:
>
>      > > >
>
>      > > >
>
>      > > >
>
>      > > > * Git
>
>      > > >
>
>      > > > * GMODULE2
>
>      > > >
>
>      > > > * Gettext
>
>      > > >
>
>      > > > * LIBSSH (required version >= 0.6), Library for implementing SSH
>
>      >
>
>      > clients,
>
>      >
>
>      > > > <
>
>      > > > https://www.libssh.org/ <https://www.libssh.org/>>
>
>      > > >
>
>      > > > extcap remote SSH interfaces (sshdump, ciscodump)
>
>      > > >
>
>      > > > * PCAP
>
>      > > >
>
>      > > > * MaxMindDB, C library for the MaxMind DB file format, <
>
>      > > > https://github.com/maxmind/libmaxminddb
>     <https://github.com/maxmind/libmaxminddb>>
>
>      > > >
>
>      > > > Support for GeoIP lookup
>
>      > > >
>
>      > > > * SMI, Library to access SMI management information, <
>
>      > > > https://www.ibr.cs.tu-bs.de/projects/libsmi/
>     <https://www.ibr.cs.tu-bs.de/projects/libsmi/>>
>
>      > > >
>
>      > > > Support MIB and PIB parsing and OID resolution
>
>      > > >
>
>      > > > * GNUTLS (required version >= 3.3.0)
>
>      > > >
>
>      > > > * KERBEROS
>
>      > > >
>
>      > > > * ZLIB
>
>      > > >
>
>      > > > * ZSTD (required version >= 1.0.0), A compressor/decompressor
>     from
>
>      > > > Facebook providing better compression than Snappy at a cost of
>
>      >
>
>      > speed, <
>
>      >
>
>      > > > https://facebook.github.io/zstd/
>     <https://facebook.github.io/zstd/>>
>
>      > > >
>
>      > > > Zstd decompression in Kafka dissector, read compressed capture
>
>      >
>
>      > files
>
>      >
>
>      > > > * NL, Libraries for using the Netlink protocol on Linux, <
>
>      > > > https://www.infradead.org/~tgr/libnl/
>     <https://www.infradead.org/~tgr/libnl/>>
>
>      > > >
>
>      > > > Support for managing wireless 802.11 interfaces
>
>      > > >
>
>      > > > * CAP, The Libcap package implements the user-space interfaces to
>
>      >
>
>      > the
>
>      >
>
>      > > > POSIX 1003.1e capabilities available in Linux kernels, <
>
>      > > > https://sites.google.com/site/fullycapable/
>     <https://sites.google.com/site/fullycapable/>>
>
>      > > >
>
>      > > > Allow packet captures without running as root
>
>      > > >
>
>      > > > * SETCAP
>
>      > > >
>
>      > > > * XSLTPROC
>
>      > > >
>
>      > > >
>
>      > > >
>
>      > > > -- The following REQUIRED packages have been found:
>
>      > > >
>
>      > > >
>
>      > > >
>
>      > > > * GLIB2 (required version >= 2.38.0)
>
>      > > >
>
>      > > > * GTHREAD2
>
>      > > >
>
>      > > > * GCRYPT (required version >= 1.5.0)
>
>      > > >
>
>      > > > * CARES (required version >= 1.5.0), Library for asynchronous DNS
>
>      > > > requests, <https://c-ares.org/ <https://c-ares.org/>>
>
>      > > >
>
>      > > > DNS name resolution for captures
>
>      > > >
>
>      > > > * LEX
>
>      > > >
>
>      > > > * Perl
>
>      > > >
>
>      > > > * Python3 (required version >= 3.4)
>
>     -- 
>
>     And I feel like picking a fight.
>
>     With anybody who claims they're right.
>
>     All the preacher men, the politicians
>
>     All the critics and the things they write.
>
>     -- Rainmakers
>
>     ___________________________________________________________________________
>     Sent via:    Wireshark-users mailing list
>     <wireshark-users@xxxxxxxxxxxxx <mailto:wireshark-users@xxxxxxxxxxxxx>>
>     Archives: https://www.wireshark.org/lists/wireshark-users
>     <https://www.wireshark.org/lists/wireshark-users>
>     Unsubscribe:
>     https://www.wireshark.org/mailman/options/wireshark-users
>     <https://www.wireshark.org/mailman/options/wireshark-users>
>                   mailto:wireshark-users-request@xxxxxxxxxxxxx
>     <mailto:wireshark-users-request@xxxxxxxxxxxxx>?subject=unsubscribe
>
>
> ___________________________________________________________________________
> Sent via:    Wireshark-users mailing list <wireshark-users@xxxxxxxxxxxxx>
> Archives:    https://www.wireshark.org/lists/wireshark-users
> Unsubscribe: https://www.wireshark.org/mailman/options/wireshark-users
>               mailto:wireshark-users-request@xxxxxxxxxxxxx?subject=unsubscribe