Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 27 Nov 1995 16:11:49 -0800
From:      Lyndon Nerenberg (VE7TCP) <lyndon@orthanc.com>
To:        Terry Lambert <terry@lambert.org>
Cc:        hackers@freebsd.org
Subject:   Re: Where is the documentation for ibcs2? 
Message-ID:  <199511280011.QAA23175@multivac.orthanc.com>
In-Reply-To: Your message of "Mon, 27 Nov 1995 16:47:30 MST." <199511272347.QAA19930@phaeton.artisoft.com> 

next in thread | previous in thread | raw e-mail | index | archive | help
Well, going by your argument the man page for cc(1) should also document
the programming language and libraries, n'est ce pas? Should we also
incorporate a copy of Stevens in tcp(4)?

The man page should document the fact the iBCS2 support exists,
give three short examples of how to enable the support (compile into
kernel, invoke from sysconfig, load from command line), refer the
reader to the non-existent handbook section describing all the ugly
details of the implementation, and include a warning that the code
is preliminary and shouldn't be used unless you're willing to do some
digging into the source code.

Call the manpage ibcs2(8) and create a link called sco(4) (or maybe sco(5)?).
This makes the two obvious targets for apropos work, and let's people
discover fairly easily that SCO support does exist, while making no
bones about the fact that its use is not for the timid.

--lyndon



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199511280011.QAA23175>