I am missing your point. The documentation is readily available from both the RTD and the FTP along with the source tarballs.

The sources are in Sphinx doc format, so everyone can modify and build in whatever output format sphinx-build provides: https://www.sphinx-doc.org/en/master/man/sphinx-build.html

Are you really complaining about the lack of handholding because you want to build the documentation yourself and just can’t download it? Because it really seems like the case here.

Ondrej
--
Ondřej Surý — ISC (He/Him)

My working hours and your working hours may be different. Please do not feel obligated to reply outside your normal working hours.

On 21. 12. 2023, at 21:32, Fred Morris <m3...@m3047.net> wrote:



Just pulled the 9.18.21 tarball and checked, same thing.

m3047@sophia:/opt/downloads/bind-9.18.21> grep -B18 '> Change log' README.md 

### <a name="doc"/> Documentation

The *BIND 9 Administrator Reference Manual* (ARM) is included with the source
distribution, and in .rst format, in the `doc/arm`
directory. HTML and PDF versions are automatically generated and can
be viewed at [https://bind9.readthedocs.io/en/latest/index.html](https://bind9.readthedocs.io/en/latest/index.html).

Man pages for some of the programs in the BIND 9 distribution
are also included in the BIND ARM.

Frequently (and not-so-frequently) asked questions and their answers
can be found in the ISC Knowledgebase at
[https://kb.isc.org](https://kb.isc.org).

Additional information on various subjects can be found in other
`README` files throughout the source tree.

### <a name="changes"/> Change log
m3047@sophia:/opt/downloads/bind-9.18.21> sum README.md 
37785    11
m3047@sophia:/opt/downloads/bind-9.18.21> md5sum README.md 
c4e08add5a135ce2573483eb0e5b1207  README.md
m3047@sophia:/opt/downloads/bind-9.18.21> sha256sum README.md 
080e914decc2ed554d8887b0f719b82736c45380b987f23b3eba4ef7418f03f3  README.md

On 12/21/23 12:24 PM, Fred Morris wrote:

No, I was correct the first time, but I had the wrong version. It is a 9.18.9 tarball, not 9.18.21. Checksums are correct for that README.md.

On 12/21/23 12:18 PM, Fred Morris wrote:

I'm sorry 9.18.9 was the version where I discovered that the build didn't build the PDF, and all it says is

### <a name="build"/> Building BIND 9

For information about building BIND 9, see the
["Building BIND 9"](doc/arm/build.inc.rst) section in the BIND 9
Administrator Reference Manual.

The checksums correct for that version of README.md.

I think I must have mistakenly cut & pasted from the source tree in GitLab for 9.18.

On 12/21/23 10:50 AM, Fred Morris wrote:
On 12/21/23 10:08 AM, Ondřej Surý wrote:

In the commit you referenced:

https://gitlab.isc.org/isc-projects/bind9/-/commit/561a83a29182b00bda9237ae30343d76a68dcdf4#8ec9a00bfd09b3190ac6b22251dbb1aa95a0579d_147_147
On 21. 12. 2023, at 18:59, Fred Morris <m3...@m3047.net> wrote:

According to the commit
(https://gitlab.isc.org/isc-projects/bind9/-/commit/561a83a29182b00bda9237ae30343d76a68dcdf4)
Not sure how this works, but I'm looking at what came out of the 9.18.21
tarball and it doesn't build the PDF, and neither does README.md contain
the build instructions:

    ### <a name="doc"/> Documentation

    The *BIND 9 Administrator Reference Manual* (ARM) is included with
    the source
    distribution, and in .rst format, in the `doc/arm`
    directory. HTML and PDF versions are automatically generated and can
    be viewed at
    [https://bind9.readthedocs.io/en/latest/index.html](https://bind9.readthedocs.io/en/latest/index.html).

    Man pages for some of the programs in the BIND 9 distribution
    are also included in the BIND ARM.

    Frequently (and not-so-frequently) asked questions and their answers
    can be found in the ISC Knowledgebase at
    [https://kb.isc.org](https://kb.isc.org).

    Additional information on various subjects can be found in other
    `README` files throughout the source tree.

# sum README.md 30538 11 README.md # md5sum README.md
4b7916a768467c54d1d1f0fd96cff505 README.md # sha256sum README.md
ed0a9280fe2f1d1fd6616f95184c6901709e79897b22205e5200bf1f5a7b1bea README.md

--

Fred Morris



**PerlJacket** deleted text/html part.

--
Visit https://lists.isc.org/mailman/listinfo/bind-users to unsubscribe from this list

ISC funds the development of this software with paid support subscriptions. Contact us at https://www.isc.org/contact/ for more information.


bind-users mailing list
bind-users@lists.isc.org
https://lists.isc.org/mailman/listinfo/bind-users
-- 
Visit https://lists.isc.org/mailman/listinfo/bind-users to unsubscribe from 
this list

ISC funds the development of this software with paid support subscriptions. 
Contact us at https://www.isc.org/contact/ for more information.


bind-users mailing list
bind-users@lists.isc.org
https://lists.isc.org/mailman/listinfo/bind-users

Reply via email to