Hello Benedict, I was wondering if you already had a chance to look over the output I sent a few days back and maybe already have a view on how to use that to the. Maximum benefit of the community.
Best Regards, /Dirk > Am 03.12.2018 um 18:57 schrieb Benedict Reuschling <[email protected]>: > > Hello Dirk, > > I think this is definitely valueable in multiple ways: > > - finding missing entries in NOTES or lacking a man page (as you noted) > - adding cross references and notes to existing man pages (when appropriate) > - checking if all these options are needed or are included implicitly > during kernel builds > - identifying outdated information or obsolete entries > > Cross references will help developers understanding how things are > interconnected within the kernel and the source tree. > > I'm just wondering what kind of format would be appropriate for the > table. It could be a big table on the FreeBSD wiki, but it could also be > part of the developers handbook or a separate article. Can you send us > an excerpt so that we can see how it looks like? It does not have to be > fancy, just to get a feel for the information in it. > > I could help out from the doc side of things and we should definitely > find someone from the kernel side to confirm that the findings make sense. > > Thanks! > > Cheers, > Benedict > > > >> Am 03.12.18 um 17:52 schrieb Dirk Schroetter: >> Hello there, >> >> I am just working on my kernel and its config and after trying to find a >> comprehensive list of kernel options, I came up short. >> >> So I did fire up the editor and managed to get a python script running that >> looks at: >> >> * The ‚options‘ files under /usr/src >> * The ‚NOTES‘ files >> * The manual pages >> >> all this being dumped into a table and cross-referenced. >> >> My current stat on a FreeBSD 11.2 AMD64: Around 1000 kernel options of which >> around half do not have either an entry in NOTES or are not mentioned on a >> man page (e.g. ACPI_MAX_TAKS or ADA_TEST_FAILURE) >> >> So I was going to try to compile some form of documentation for all of these >> for my own personal use. Then I was wondering if the Documentation project >> had any use for this kind of information. My idea was: >> >> 1. Try to get the information into the respective NOTES files. >> 2. Make sure the options, devices, hints get into the option.h files >> 3. Updating the man pages. >> >> It may be that this is a fool’s errand and much to big for a single person, >> but I would volunteer to at least get it started, if you folks think that >> there is any merit to it. >> >> So that would be my proposal and I would love to hear back from you. >> >> Best Regards, >> >> /Dirk >> _______________________________________________ >> [email protected] mailing list >> https://lists.freebsd.org/mailman/listinfo/freebsd-doc >> To unsubscribe, send any mail to "[email protected]" >> > > _______________________________________________ [email protected] mailing list https://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "[email protected]"
