Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
BIND
BIND
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 633
    • Issues 633
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Merge Requests 106
    • Merge Requests 106
  • CI / CD
    • CI / CD
    • Pipelines
    • Jobs
    • Schedules
  • Operations
    • Operations
    • Incidents
    • Environments
  • Packages & Registries
    • Packages & Registries
    • Container Registry
  • Analytics
    • Analytics
    • CI / CD
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
  • ISC Open Source Projects
  • BINDBIND
  • Issues
  • #2127

Closed
Open
Opened Sep 04, 2020 by Matthijs Mekking@matthijs🏡Maintainer

Update ARM with lost changes since the conversion to RST files

The ARM does not yet mention that signing can be done with dnssec-policy (oops).

This is caused by commit 9fb6d11a (converting documentation to Sphinx). The commit was authored on March 31, 2019 and was merged on May 7, 2020.

It is likely that other documentation changes between that period may have been lost in translation.

@michal provided a git command to go over the changes to XML files that were made in that period.

git log --patch --color-words d571b3346818dd28bfca1528449e16bee86bb3cc..9fb6d11abbdb10ded128f0ee5c004f24b4030ede^ -- $(git diff-tree -r --no-commit-id --name-only 9fb6d11abbdb10ded128f0ee5c004f24b4030ede -- ':*.xml*' ':!doc/arm/notes*')
  1. commit 978c7b2e changes libdns documentation but since the libraries have been made private we no longer have to worry about that.
  2. commit 98b3b937 removes the Python based DNSSEC tools after the introduction of dnssec-policy. They don't appear in the latest version of the RST files, so all good.
  3. commit 4e8f8da6 adds information on nsdname-wait-recurse. Yes, also present in reference.rst.
  4. commit 6fb568ca improves the readability of the bibliography. Lots of style changes, but no content changes.
  5. commit d9a6fef0 shortens the text of mirror zones. That same change I see has been made in reference.rst.
  6. commit 9e4a153f use relative width for zone tables. No content changes.
  7. commit 47e42d57 explains that DNSSEC keys are not shared among zones. I see that text also in reference.rst.
  8. commit 5a23e7ab documents max-ixfr-ratio. The same text is present in advancded.rst and reference.rst.
  9. commit fa3fbf62 adds a clarification on "glob expression". Is also there in reference.rst.
  10. commit ba0313e6 fixes spelling errors reported by Fossies. These also seem to have been fixed in the RST files.
  11. commit c7866acb revises dnssec-policy documentation. Those revisions have also been made in the RST files.
  12. commit 21bb9fa7 improves query logging documentation. Those improvements can also be seen in reference.rst.
  13. commit 58aa084e adds support for algorithm mnemonics in dnssec-policy. Those mnemonics have also been added in reference.rst.
  14. commit 2733edb2 allows an unlimited key lifetime. Also in reference.rst.
  15. commit 9dc63001 renames zone-max-ttl to max-zone-ttl in both documentation formats.
  16. commit be3a1102 documents forwarders config port and dscp parameters. Also made it to reference.rst.
  17. commit 05c6a29c documents that version also controls authors.bind in both documentation formats.
  18. commit fc36798a removes the restriction that key and ds trust anchors cannot be mixed. That restriction is also not present in the RST files.
  19. commit 343c6d35 updates platform compatibility. Both documentation sets are in sync with respect to platforms.
  20. commit 2df13f79 adds 2020 to the copyright years. RST deals with that differently.
  21. commit 4b66c0eb changes some dnssec-policy defaults, also in reference.rst.
  22. commit a339a6df updates documentation with durations. I see them in both.
  23. commit 8fd8404e removes two leftover ttlval references. No ttlval references can be found in the RST files.
  24. commit 8c37d3d3 renames dnssec-keys to trust-anchors. It looks like the changed made it, but grepping for dnssec-keys I found some leftover references to dnssec-keys.
  25. commit c29ccae2 documents static-ds and static-key. Also in reference.rst.
  26. commit 45d62398 adds dnssec-policy grammar. This is also included in the RST files.
  27. commit 6468ffc3 adds keywords to dnssec-policy's keys clause, also in reference.rst.
  28. commit 1f0d6296 exposes more key timing configurations. Those are also present in reference.rst.
  29. commit da0ae529 updates DNSSEC documentation and adds dnssec-policy to the list of methods to sign your zone. This change did NOT make it in dnssec.rst.
  30. commit a50d707f introduces dnssec-policy. Made it to reference.rst.
  31. commit b7c5bfb2 extends ttlval to also use ISO 8601 durations and was also done in reference.rst.
  32. commit c67379fb changes indentation, so not important.
  33. commit ebc61946 adds a sentence on overlapping selectors. That sentence can also be found in reference.rst.
  34. commit e0618174 adds more info about automatic-interface-scan and interface- interval. That info has also been added in reference.rst.
  35. commit f7eea400 changes the default for the lock-file to none. And in reference.rst the default is also none.
  36. commit c6f91f8b adds require-server-cookie explanation. And reference.rst explains the same thing.
  37. commit c5453ea3 adds require-server-cookie when to set. The text is there although has been reworded. I think this requires no further action.
  38. commit 1ea6aadf documents resolver-nonbackoff-tries and resolver-retry-interval. It is also documented in reference.rst.
  39. commit d8abf4f5 adds defaults for require-server-cookie and send-cookie options. The reference.rst documents the same defaults.
  40. commit a20c42dc disables NSEC aggressive caching, alos in reference.rst.
  41. commit aca78add removes discussion about fallback to plain DNS on timeout. I don't see that discussion in reference.rst either.
  42. commit 9fc4be22 removes rate-limit reference from "Response Rate Limiting" section. It is also missing in reference.rst.
  43. commit 2ceb4b6a improves cache db statistics documentation. Also improved in reference.rst.
  44. commit c9d56a81 documents the ~ mark in cache db statistics. reference.rst also mentions the tilde mark.
  45. commit 33bddbb5 clarifies relationship between ACLs and RPZs. That clarification made it in reference.rst.
  46. commit 5ed13fe4 removes DLV from ARM. The general.rst file also moves DLV to historic.
  47. commit 02d95d0b removes dnssec-lookaside. I don't see it anywhere in the RST files.
  48. commit a7ec7eb6 checks bits 64..71 and so does reference.rst.
  49. commit bded8af7 corrects default for rrset-order. It changed to random and that is also what is in reference.rst.
  50. commit 9ba3e3f1 converts geoip to geoip2. The added note regarding Windows systems can also be found in reference.rst.
  51. commit 55cca87d removes references to legacy GeoIP. No "legacy GeoIP" mentions can be found in the RST files.
  52. commit 77c2a8bc removes spurious commas, moving on.
  53. commit d1503cbf deprecates dnssec-lookaside validation (and was later removed, so carry on).
  54. commit a5dc24b2 marks some managed-keys instances as deprecated and I have seen them marked as deprecated in the RST files.
  55. commit c9945d61 updates the ARM with the new GeoIP and those have made it into reference.rst.
  56. commit 3a3f40e3 includes a note on DNSSEC sign metrics. This note has been lost in reference.rst.*
  57. commit e21103f2 fixes statistics for x86 Windows builds. The note on 32-bit Windows that was added here cannot be found in the RST files, but that is because we dropped support for 32-bit Windows. So all good.
  58. commit 3853b3cf updates documentation for dnssec-keys. Has made it to the RST files.
  59. commit a9dca583 removes cleaning-interval. Also obsoleted in reference.rst.
  60. commit 4889e06c fixes NODATA ANCOUNT, and the same fix is in reference.rst.
  61. commit d809ec6c restores tcp-clients < interfaces. Also restored in reference.rst.
  62. commit b7e91157 revises minimal-responses. The revision has also made it to reference.rst.
  63. commit 91dca0f8 updates documentation on allow-update-forwarding. The added text can also be found in reference.rst.
  64. commit 1d45ad8f ignores trust anchors using disabled algorithms, and reference.rst approves.
  65. commit d0696586 removes dnssec-enable and is marked as obsoleted in reference.rst.
  66. commit d1fa8be6 adds add-soa and is also added in reference.rst.
Edited Sep 10, 2020 by Matthijs Mekking
Assignee
Assign to
October 2020 (9.11.24, 9.11.24-S1, 9.16.8, 9.16.8-S1, 9.17.6)
Milestone
October 2020 (9.11.24, 9.11.24-S1, 9.16.8, 9.16.8-S1, 9.17.6) (Past due)
Assign milestone
Time tracking
None
Due date
None
Reference: isc-projects/bind9#2127