Date: Mon, 11 Jan 1999 15:05:17 +0200 From: Jeremy Lea <reg@shale.csir.co.za> To: Nik Clayton <nik@nothing-going-on.demon.co.uk> Cc: Dag-Erling Smorgrav <des@flood.ping.uio.no>, committers@FreeBSD.ORG Subject: Re: sysctl descriptions Message-ID: <19990111150517.B3187@shale.csir.co.za> In-Reply-To: <19990110132507.A24731@catkin.nothing-going-on.org>; from Nik Clayton on Sun, Jan 10, 1999 at 01:25:07PM %2B0000 References: <86u2y0btan.fsf@niobe.ewox.org> <19990110132507.A24731@catkin.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Hi, On Sun, Jan 10, 1999 at 01:25:07PM +0000, Nik Clayton wrote: > I do think that in order to ensure the information is kept up to date > the documentation strings *must* be kept close to the code they document. > But actually keeping those strings in the kernel isn't necessary. Building > a kernel could also update /usr/share/doc/sysctl/_KERNELNAME_/_LANGCODE_/* > with the information, and sysctl(8) could be patched to read from these files > instead. Where _KERNELNAME_ is your current kernel name (different kernels > might have different sysctls enabled) and _LANGCODE_ is 'en', 'ja', 'de' > and so on. What about reversing this, and having the kernel (compiled with 'options I_HAVE_LOTS_OF_RAM_AND_DONT_CARE') pick up all of it's strings (prompts, help, card identification, etc.) from files in /usr/src/sys/doc/_LANG_/? Or if you're PHK, then copy/link it into /boot/doc/? Doesn't satisfy the condition of keeping the docs near the code... <WARNING type="wild idea"> Instead of having /boot, why not have /_KERNEL_? One directory per kernel config file, named after the config file, and will all of the stuff built for that kernel. eg: /SHALE loader kernel kernel.old /modules *.ko //Modules must match kernel... /man *.1k.gz //Kernel taylored help /lib libkvm.so //'nuff said... /boot -> SHALE //Maybe... </WARNING> Regards, -Jeremy -- | "Come home my prodigal son, come home and lets be one, --+-- don't want to see you cry, don't make me tell you why, | you've lived in a house with me, my blood has set you free, | in the world you'll surely die, nothing else will satisfy." -MIC To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990111150517.B3187>