From: Eric S. R. <es...@th...> - 2000-03-08 07:47:11
|
Dominik Kubla <dom...@un...>: > All _exported_ functions and variables need to have constant name prefix. > I propose the following: > > con_ console device (already used for this) > kb_ keyboard driver > vt_ virtual terminal handling (already used for this) > vte_ video terminal emulation > > Comments? Good idea. > Eric, what format should we use for the docs? Plain text? Nroff? I would > discount TeX and SGML because people can not be expected to have these > tools installed, even so one could use a SGML subset and sed/awk scripts > to convert them to text. Since man pages are already written in nroff > and nroff is generating decent printer output (and since it's the Unix > standard way of delivering documents anyway), i would propose to use nroff > for the other docs to be included into the kernel as well. And i recall > you are well versed in nroff anyway... ;-) Nroff should be fine for this application. Anyway, the only documentation change I was immediately planning was an update to console_codes(4). -- <a href="http://www.tuxedo.org/~esr">Eric S. Raymond</a> "I hold it, that a little rebellion, now and then, is a good thing, and as necessary in the political world as storms in the physical." -- Thomas Jefferson, Letter to James Madison, January 30, 1787 |