Re: version errata Re: Remove PDF-related bits from the build system
You know, whenever I run over a spark plug as I'm driving down the road, the first thing that goes through my mind is good on them for ruling out the spark plug as the cause of rough running, and too bad they'll have to have the valves and rings checked. On 12/22/23 12:42 AM, Ondřej Surý wrote: > 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. I concerned you've lost control of your build. However it does look correct in 9.19.19. -- Fred Morris -- 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
Re: version errata Re: Remove PDF-related bits from the build system
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.htmlAre 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 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 ### 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. ### Change log m3047@sophia:/opt/downloads/bind-9.18.21> sum README.md 3778511 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 ### 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 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: ### 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 listISC funds the development of this software with paid support subscriptions. Contact us at https://www.isc.org/contact/ for more information.bind-users mailing listbind-users@lists.isc.orghttps://lists.isc.org/mailman/listinfo/bind-users-- Visit https://lists.isc.org/mailman/listinfo/bind-users to unsubscribe from this
Re: Remove PDF-related bits from the build system
https://bind.readthedocs.io/_/downloads/en/v9.18.21/pdf/ On Thu, Dec 21, 2023 at 9:59 AM Fred Morris wrote: > (Intentionally posting to the mailing list with that string since that > was the commit message where it occurred. Hopefully this will improve > findability.) > > So, yeah. > > I'll take your word for it that Read The Docs can generate PDFs. I'd > appreciate your promise that it generated the version of the doc which > is here: https://downloads.isc.org/isc/bind9/9.18.21/doc/arm/Bv9ARM.pdf > We could talk about the difference in presentation between the HTML and > PDF versions, but it's a matter of taste. > > Is this free, and where are the instructions? > > According to the commit > ( > https://gitlab.isc.org/isc-projects/bind9/-/commit/561a83a29182b00bda9237ae30343d76a68dcdf4 > ) > you removed "PDF-related bits" from not just the build system, but from > the documentation itself! You removed the instructions that are in the > commit message itself! If your intention was to remove it from the build > system, you went too far. > > I looked for this just the other day in the KB. At the least you should > have a KB article. At least there's this post to the mailing list. > > -- > > Fred Morris > > > -- > 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
Re: version errata Re: Remove PDF-related bits from the build system
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 ### 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. ### 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 >> >> ### 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 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: >>> >>> ### 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
Re: version errata Re: Remove PDF-related bits from the build system
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 > > ### 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 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: >> >> ### 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
version errata Re: Remove PDF-related bits from the build system
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 ### 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 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: > > ### 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
Re: Remove PDF-related bits from the build system
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 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: ### 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 -- 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
Re: Remove PDF-related bits from the build system
In the commit you referenced: https://gitlab.isc.org/isc-projects/bind9/-/commit/561a83a29182b00bda9237ae30343d76a68dcdf4#8ec9a00bfd09b3190ac6b22251dbb1aa95a0579d_147_147 -- 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 18:59, Fred Morris wrote: > > (Intentionally posting to the mailing list with that string since that > was the commit message where it occurred. Hopefully this will improve > findability.) > > So, yeah. > > I'll take your word for it that Read The Docs can generate PDFs. I'd > appreciate your promise that it generated the version of the doc which > is here: https://downloads.isc.org/isc/bind9/9.18.21/doc/arm/Bv9ARM.pdf > We could talk about the difference in presentation between the HTML and > PDF versions, but it's a matter of taste. > > Is this free, and where are the instructions? > > According to the commit > (https://gitlab.isc.org/isc-projects/bind9/-/commit/561a83a29182b00bda9237ae30343d76a68dcdf4) > you removed "PDF-related bits" from not just the build system, but from > the documentation itself! You removed the instructions that are in the > commit message itself! If your intention was to remove it from the build > system, you went too far. > > I looked for this just the other day in the KB. At the least you should > have a KB article. At least there's this post to the mailing list. > > -- > > Fred Morris > > > -- > 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
Re: Remove PDF-related bits from the build system
(Intentionally posting to the mailing list with that string since that was the commit message where it occurred. Hopefully this will improve findability.) So, yeah. I'll take your word for it that Read The Docs can generate PDFs. I'd appreciate your promise that it generated the version of the doc which is here: https://downloads.isc.org/isc/bind9/9.18.21/doc/arm/Bv9ARM.pdf We could talk about the difference in presentation between the HTML and PDF versions, but it's a matter of taste. Is this free, and where are the instructions? According to the commit (https://gitlab.isc.org/isc-projects/bind9/-/commit/561a83a29182b00bda9237ae30343d76a68dcdf4) you removed "PDF-related bits" from not just the build system, but from the documentation itself! You removed the instructions that are in the commit message itself! If your intention was to remove it from the build system, you went too far. I looked for this just the other day in the KB. At the least you should have a KB article. At least there's this post to the mailing list. -- Fred Morris -- 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
