NetBSD Problem Report #59474

From www@netbsd.org  Thu Jun 19 08:44:14 2025
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256
	 client-signature RSA-PSS (2048 bits) client-digest SHA256)
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id E400C1A923C
	for <gnats-bugs@gnats.NetBSD.org>; Thu, 19 Jun 2025 08:44:13 +0000 (UTC)
Message-Id: <20250619084412.A3A2F1A923D@mollari.NetBSD.org>
Date: Thu, 19 Jun 2025 08:44:12 +0000 (UTC)
From: pr@netbsd.dberg.net
Reply-To: pr@netbsd.dberg.net
To: gnats-bugs@NetBSD.org
Subject: BIND9 admin ref manual missing.  (From /usr/share/doc/reference/ref8/bind9/arm/)
X-Send-Pr-Version: www-1.0

>Number:         59474
>Category:       misc
>Synopsis:       BIND9 admin ref manual missing.  (From /usr/share/doc/reference/ref8/bind9/arm/)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Jun 19 08:45:00 +0000 2025
>Closed-Date:    
>Last-Modified:  Wed Jun 25 11:51:42 +0000 2025
>Originator:     Dave B
>Release:        10.1_STABLE
>Organization:
>Environment:
NetBSD xxxxxx 10.1_STABLE NetBSD 10.1_STABLE (GENERIC) #20: Fri Apr 25 10:12:40 EDT 2025  yyyyyy@zzzzzzz.dberg.net:/nb/10.x/obj.amd64/misc/nb/10.x/src/sys/arch/amd64/compile/GENERIC amd64
>Description:
The BIND9 Administrator's Reference Manual (ARM) used to be available in /usr/share/doc/reference/ref8/bind9/arm/.  It was really useful to have it in the base installation; but lately (NetBSD 10 or so?) it seems to be gone.  Is it gone forever or is getting it back a possibility?
>How-To-Repeat:

>Fix:

>Release-Note:

>Audit-Trail:
From: "David H. Gutteridge" <david@gutteridge.ca>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: misc/59474: BIND9 admin ref manual missing. (From
 /usr/share/doc/reference/ref8/bind9/arm/)
Date: Thu, 19 Jun 2025 21:54:41 -0400

 The issue here is that newer versions of Bind expect Python and Sphinx
 to be installed in order to generate this manual from rST. NetBSD
 doesn't include such things in tooling, so it got dropped (I infer).

 Dave

From: Dave B <pr@netbsd.dberg.net>
To: gnats-bugs@netbsd.org
Cc: misc-bug-people@netbsd.org, gnats-admin@netbsd.org,
	netbsd-bugs@netbsd.org
Subject: Re: misc/59474: BIND9 admin ref manual missing. (From
 /usr/share/doc/reference/ref8/bind9/arm/)
Date: Fri, 20 Jun 2025 01:56:24 -0400

 Thanks Dave G,

 That's a shame, but entirely understandable.

 Any chance that if I fully rebuild a NetBSD release from src--
 and I have Python and Sphinx already installed on the build
 system--the bind9 manual will automatically get added to my
 output?

 Or was the whole sub area explicitly removed from things like
 targets and/or flists and/or whatever?

 Best, -Dave B

From: "David H. Gutteridge" <david@gutteridge.ca>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: misc/59474: BIND9 admin ref manual missing. (From
 /usr/share/doc/reference/ref8/bind9/arm/)
Date: Fri, 20 Jun 2025 22:31:49 -0400

 On Fri, 20 Jun 2025 at 01:56:24 -0400, Dave B wrote:
 > Thanks Dave G,
 >=20
 > That's a shame, but entirely understandable.
 >=20
 > Any chance that if I fully rebuild a NetBSD release from src--
 > and I have Python and Sphinx already installed on the build
 > system--the bind9 manual will automatically get added to my
 > output?
 >=20
 > Or was the whole sub area explicitly removed from things like
 > targets and/or flists and/or whatever?

 I think from the upstream project's perspective, they're mostly (?)
 expecting people to access the documentation online now, which they
 provide via readthedocs.io:

 https://bind9.readthedocs.io/en/v9.20.9/

 If you do want to build locally, for offline use, that might be a
 bit more complicated. NetBSD does keep the files in our tree, but
 you'd first have to run autoconf tools to generate a usable
 Makefile, then you may find (as I did with a casual try) that
 other things still choke on the html-generating make targets. (I
 confess I didn't look further than just trying to invoke something.)

 I also looked at the net/bind918 package in pkgsrc, but I see it too
 does not build this documentation. (It would also need tweaking, I
 think, to actually work, though it would be farther ahead. Well,=C2=A0
 except for the fact it may be a different version than you'd want.)

 Regards,

 Dave

State-Changed-From-To: open->feedback
State-Changed-By: gutteridge@NetBSD.org
State-Changed-When: Wed, 25 Jun 2025 00:51:40 +0000
State-Changed-Why:
Is the online version of the documentation sufficient for you?

From: Dave B <pr@netbsd.dberg.net>
To: gnats-bugs@netbsd.org
Cc: misc-bug-people@netbsd.org, netbsd-bugs@netbsd.org,
	gnats-admin@netbsd.org, gutteridge@NetBSD.org
Subject: Re: misc/59474 (BIND9 admin ref manual missing.  (From
 /usr/share/doc/reference/ref8/bind9/arm/))
Date: Wed, 25 Jun 2025 03:24:17 -0400

 Thanks for asking, Dave.

 Yeah, that's what I was afraid of.  I was personally a big fan of
 when those docs were right in the NetBSD distribution sets (it was
 one of a number of things that help make NetBSD feel a little like
 a secret weapon in one's toolbox to me); and I think it would be
 great to see them there again someday.

 That said, I'm not sure it would be right to ask to keep another
 long-term PR open as basically a to-do list item (i.e., for "figure
 out how to miraculously build the BIND docs as part of building a
 NetBSD release--when certain needed tools don't exist in Base"),
 especially with no clear path forward.  If it IS right, I'm not
 opposed to keeping the ticket open of course; but if it isn't
 right, I understand it might be best to close it.

 Miscellaneous parting thoughts:

  - is this a possible NetBSD Projects List candidate?  (cons:
    even if someone figures out how to build the docs, what about
    Base's still not having python & other necessary tools...).
  - is it viable to build the docs at BIND9 import time (assuming
    the right tools in pkgsrc or w/e), rather than build release
    time, and track them in cvsroot/src?  (cons: extra drag at
    import time... extra bloat in /src...?)

 Okay, I appreciate all your help.

 Best, -DB

State-Changed-From-To: feedback->open
State-Changed-By: gutteridge@NetBSD.org
State-Changed-When: Wed, 25 Jun 2025 11:51:42 +0000
State-Changed-Why:
Feedback received; needs NetBSD consideration.

>Unformatted:

Home	PR Database Search