Description
onatan
2007-02-09 15:50:13 UTC
brueffer 2007-02-09 20:32:58 UTC FreeBSD src repository Modified files: share/man/man9 ieee80211_ioctl.9 Log: Remove Xref to owi(4), it's dead and gone. PR: 108980 Submitted by: Yonatan Revision Changes Path 1.4 +0 -1 src/share/man/man9/ieee80211_ioctl.9 _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" brueffer 2007-02-09 20:39:14 UTC FreeBSD src repository Modified files: share/man/man4 enc.4 Log: Correct references to tcpdump(1). PR: 108980 Submitted by: Yonatan Revision Changes Path 1.4 +2 -2 src/share/man/man4/enc.4 _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" brueffer 2007-02-09 20:53:19 UTC FreeBSD src repository Modified files: share/man/man4 uark.4 Log: Remove Xref to non-existant uhub(4). PR: 108980 Submitted by: Yonatan Revision Changes Path 1.3 +0 -1 src/share/man/man4/uark.4 _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" brueffer 2007-02-09 21:05:47 UTC FreeBSD src repository Modified files: share/man/man4 ng_bt3c.4 share/man/man4/man4.i386 fe.4 Log: Remove references to pccardd(8), pccardc(8) and OLDCARD. PR: 108980 Submitted by: Yonatan Revision Changes Path 1.39 +1 -2 src/share/man/man4/man4.i386/fe.4 1.11 +1 -19 src/share/man/man4/ng_bt3c.4 _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" brueffer 2007-02-09 21:12:21 UTC FreeBSD src repository Modified files: share/man/man9 device_set_driver.9 Log: There is no isa(4) manpage, convert to normal text an join lines. PR: 108980 Submitted by: Yonatan Revision Changes Path 1.4 +1 -3 src/share/man/man9/device_set_driver.9 _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" brueffer 2007-02-09 22:18:56 UTC FreeBSD src repository Modified files: share/man/man5 rc.conf.5 Log: Nuke pcnfsd(8) reference. PR: 108980 Submitted by: Yonatan Revision Changes Path 1.316 +0 -1 src/share/man/man5/rc.conf.5 _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" On Fri, 9 Feb 2007 16:39:41 +0200 (IST) Yonatan <onatan@gmail.com> wrote: > > >Number: 108980 > >Category: docs > >Synopsis: list of missing man pages [SNIP]: PR discussion, tool, and manual page list. I'm in favor of reviewing this with everyone else; however, I would like to run it on a "fresh" install of FreeBSD. One with no ports or special build options. Also, there was once a way to handle ports manual pages; or at least a discussion of it. I see many references to such things as zip and zsh, utilities that should not be referenced unless we somehow reference the port. Perhaps we should de-reference those pages, and add a paragraph stating that use of XXX/XXX utility might be useful. Not sure, what do others think? -- Tom Rhodes On 2/10/07, Tom Rhodes <trhodes@freebsd.org> wrote: > On Fri, 9 Feb 2007 16:39:41 +0200 (IST) > Yonatan <onatan@gmail.com> wrote: > > I'm in favor of reviewing this with everyone else; however, I > would like to run it on a "fresh" install of FreeBSD. One with > no ports or special build options. Note this are just the base system man pages from a recent -stable. (enforced using /usr/share/man restriction). In some pages it is clearly noted that the referenced man page is from a port. For example: the reference in sysctl(8) to zsh(1). brueffer 2007-02-10 08:44:41 UTC FreeBSD src repository Modified files: sbin/kldload kldload.8 sbin/kldstat kldstat.8 sbin/kldunload kldunload.8 share/man/man4 kld.4 Log: Don't reference lkm(4), it doesn't exist. PR: 108980 Submitted by: Yonatan Revision Changes Path 1.26 +1 -1 src/sbin/kldload/kldload.8 1.16 +1 -1 src/sbin/kldstat/kldstat.8 1.19 +1 -1 src/sbin/kldunload/kldunload.8 1.21 +1 -1 src/share/man/man4/kld.4 _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" trhodes 2007-02-15 02:40:31 UTC FreeBSD src repository Added files: lib/libypclnt ypclnt.3 Log: Add a ypclnt.3 manual page referenced by various other YP based manual pages. PR: 108980 Obtained from: OpenBSD (minimal changes for mdoc(7) style) Revision Changes Path 1.1 +362 -0 src/lib/libypclnt/ypclnt.3 (new) _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" State Changed From-To: open->analyzed AFAICT there have been some commits but more remain to be done. The script contained herein ought to be incorporated into the tree somewhere as a sanity check. *** Bug 51480 has been marked as a duplicate of this bug. *** Make this a tracking PR and take. Now that we have a Manpages subcategory, maybe we can find all these. I have not worked on this in some time and am overcommitted. Someone else needs to look at it, please. <https://wiki.freebsd.org/MissingManpages> no longer exists there, it was moved a few months ago. Create a dependency tree, for easier viewing/listing. I am looking at this bug and have some questions, not 100% sure who to direct it towards. Reviewing this bug, it appears to be spanning across multiple versions, if I was to review the bash output, should I only focus on RELEASE? which at this time is 14.0? Also, is it expected to only cover "base" install or all package items that are possible in the system? Thank you in advance I am looking at this bug and have some questions, not 100% sure who to direct it towards. Reviewing this bug, it appears to be spanning across multiple versions, if I was to review the bash output, should I only focus on RELEASE? which at this time is 14.0? Also, is it expected to only cover "base" install or all package items that are possible in the system? Thank you in advance @Chris Davidson: It's not realistic to keep consistent cross-references among the manual pages of the base system and all possible ports. We should only consider the base system. (In reply to Diomidis Spinellis from comment #19) Agree.. i have been making some progress on this bug and have been documenting some results over here: https://bughuntingfreebsd.wordpress.com/progress-report-what-has-been-addressed/ I am currently looking into how to structure PR for the github to do this in chunks. This bug was submitted in 2007, and describes the state of the man pages then. The script only looks at /usr/share/man , and so should be unaware of any port related man pages. Some of the base man pages point to ports. For example make.conf(5) in the part discussing MAKE_SHELL variable mentions sh(1), csh(1) and ksh(1), the latter being a port. good to know, i went through and got some updates/help with an updated script that focuses on /usr/share/man and it is based on freebsd 14.0 and the url above has some more of the details. thank you for the clarification and details. (In reply to Chris Davidson from comment #22) Please let us know if you can make this script available. That would be a better solution in the long-term IMHO. Thanks. (In reply to onatan from comment #21) Oh, I don't know, ksh(1) seems like kind of a special case to me. But yes, the work I've done on it from time to time only took into account the base system. With 30,000+ ports it's intractable. (In replay to Mark Linimon) - The code that i am using is available here: https://github.com/chrisdavidson/manpages/tree/master/tools This is very much a work in progress but it is the baseline for how i am approaching doing these efforts. Mark - try again, sorry about that. Hmm... a lot of these missing manual pages are pages that a running, set-up system would have, they just don't come from src/share/man/*. I myself have contributed some of new ones deliberately, such as "see x(7), if installed", and even more flagrantly "see automount(8) or bsdisks(8)". I thought that was very nice, if you have files in /media/ you didn't create, one of those is creating them. One is in base and the other is pulled as a dependency by afaik every desktop environment. The FreeBSD manual concisely tells you everything you need to know. Is this incorrect? This concept also works... backwards, for example, we have manual pages that are built unconditionally describing parts of the system that MINIMAL wouldn't have, such as msdosfs(5). The synopsis says that you need to build it into your kernel, so if someone doesn't have it, and they look for it in the manual, they should know at first glance that... they could have it. I think this behavior is reasonable and massively more useful than the manual speaking authoratively as if the pages in src/share/man are all that exists. Please excuse and forgive me that I didn't see this, and discuss this here, before contributing those examples. I did not know this was controversial. Those are good points, those did not come up when the utilities were created. Is there a methodical way those outliers (outside of /usr/share/man) could be determined for consideration? The thought going in: This is what is known and anything else that could possibly be considered valid, can and should be added.. I just do not know of any beyond what was mentioned below. |