Bug 266360 - Name Server Operations Guide for BIND: resolver(3), resolver(5), and hosts(5) SEE ALSO have no link to the document
Summary: Name Server Operations Guide for BIND: resolver(3), resolver(5), and hosts(5)...
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Gordon Bergling
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2022-09-11 12:08 UTC by Graham Perrin
Modified: 2022-11-14 08:29 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2022-09-11 12:08:26 UTC
<https://www.freebsd.org/cgi/man.cgi?query=resolver&sektion=3&manpath=FreeBSD#SEE_ALSO>

<https://www.freebsd.org/cgi/man.cgi?query=hosts&sektion=5&manpath=FreeBSD#SEE_ALSO>

<https://www.freebsd.org/cgi/man.cgi?query=resolver&sektion=5&manpath=FreeBSD#SEE_ALSO>

A Google search for the name of the document finds a 1998-05-31 PDF of paper: 

<https://docs.freebsd.org/44doc/smm/10.named/paper.pdf>

karels@ please, can you confirm that this paper is the intended target for SEE ALSO purposes? 

Thank you
Comment 1 Mike Karels freebsd_committer freebsd_triage 2022-09-11 13:20:52 UTC
(In reply to Graham Perrin from comment #0)
> karels@ please, can you confirm that this paper is the intended target for SEE ALSO purposes? 

Yes, that was the intended target.  I haven't reviewed the operations guide for a long time, but I have to believe that it is only historical at this point.
Comment 2 commit-hook freebsd_committer freebsd_triage 2022-09-15 13:27:12 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=0090d18235269cc5f9582712a42fb5641d5b6f71

commit 0090d18235269cc5f9582712a42fb5641d5b6f71
Author:     Gordon Bergling <gbe@FreeBSD.org>
AuthorDate: 2022-09-15 13:24:28 +0000
Commit:     Gordon Bergling <gbe@FreeBSD.org>
CommitDate: 2022-09-15 13:24:28 +0000

    Update SEE ALSO sections for resolver.{3,5} and hosts.5

    The mentioned document "Name Server Operations Guide for BIND" is
    outdated, so remove it from the SEE ALSO section of hosts.5
    and resolver.{3,5}.

    PR:             266360
    Reported by:    Graham Perrin <grahamperrin at FreeBSD dot org>
    Reviewed by:    karels
    MFC after:      1 week
    Differential Revision:  https://reviews.freebsd.org/D36557

 lib/libc/net/resolver.3   | 5 +----
 share/man/man5/hosts.5    | 5 +----
 share/man/man5/resolver.5 | 5 +----
 3 files changed, 3 insertions(+), 12 deletions(-)
Comment 3 commit-hook freebsd_committer freebsd_triage 2022-09-24 08:31:55 UTC
A commit in branch stable/13 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=13798b40789343d9babdb529b053d2218c1922d3

commit 13798b40789343d9babdb529b053d2218c1922d3
Author:     Gordon Bergling <gbe@FreeBSD.org>
AuthorDate: 2022-09-15 13:24:28 +0000
Commit:     Gordon Bergling <gbe@FreeBSD.org>
CommitDate: 2022-09-24 08:31:13 +0000

    Update SEE ALSO sections for resolver.{3,5} and hosts.5

    The mentioned document "Name Server Operations Guide for BIND" is
    outdated, so remove it from the SEE ALSO section of hosts.5
    and resolver.{3,5}.

    PR:             266360
    Reported by:    Graham Perrin <grahamperrin at FreeBSD dot org>
    Reviewed by:    karels
    Differential Revision:  https://reviews.freebsd.org/D36557

    (cherry picked from commit 0090d18235269cc5f9582712a42fb5641d5b6f71)

 lib/libc/net/resolver.3   | 5 +----
 share/man/man5/hosts.5    | 5 +----
 share/man/man5/resolver.5 | 5 +----
 3 files changed, 3 insertions(+), 12 deletions(-)
Comment 4 commit-hook freebsd_committer freebsd_triage 2022-11-14 08:29:10 UTC
A commit in branch stable/12 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=5ed391a2a87b8d3e58502e62e11c2cf46cf21731

commit 5ed391a2a87b8d3e58502e62e11c2cf46cf21731
Author:     Gordon Bergling <gbe@FreeBSD.org>
AuthorDate: 2022-09-15 13:24:28 +0000
Commit:     Gordon Bergling <gbe@FreeBSD.org>
CommitDate: 2022-11-14 08:28:30 +0000

    Update SEE ALSO sections for resolver.{3,5} and hosts.5

    The mentioned document "Name Server Operations Guide for BIND" is
    outdated, so remove it from the SEE ALSO section of hosts.5
    and resolver.{3,5}.

    PR:             266360
    Reported by:    Graham Perrin <grahamperrin at FreeBSD dot org>
    Reviewed by:    karels
    Differential Revision:  https://reviews.freebsd.org/D36557

    (cherry picked from commit 0090d18235269cc5f9582712a42fb5641d5b6f71)

 lib/libc/net/resolver.3   | 5 +----
 share/man/man5/hosts.5    | 5 +----
 share/man/man5/resolver.5 | 5 +----
 3 files changed, 3 insertions(+), 12 deletions(-)