Date: Fri, 2 Feb 2001 09:39:22 -0800 (PST) From: Alex Dumas <dumas@pdx.or.com> To: doc@FreeBSD.ORG Cc: jkoshy@FreeBSD.ORG Subject: man 7 man (or man(7)) Message-ID: <Pine.BSI.4.05L.10102020915240.5681-100000@pdx.or.com>
next in thread | raw e-mail | index | archive | help
Hi, Have you or the other documentation folks considered including an optional, but encouraged "NOTES" section in man pages? It's nice for developers to have a place to put miscellaneous stuff like motivations, justifications, rationale, etc. Sometimes the "HISTORY" section doesn't quite cut it, and there are an increasing number of replacement interfaces and commands. For example, the "md" interface replaced the "mfs" interface. There wasn't really an appropriate "officially sanctioned" place to put the justification of the change. It's just a thought. -dumas To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSI.4.05L.10102020915240.5681-100000>