man pages (was Re: ircII)

[Alan Coopersmith]

Dean Roehrich wrote:
> On Fri, Jun 13, 2008 at 12:56:00PM -0400, James Carlson wrote:
>> Dean Roehrich writes:
>>> On Thu, Jun 12, 2008 at 02:10:21PM -0400, James Carlson wrote:
>>>> I'd make them all Project Private.
>>> Let's do that.  Here's the latest version of the Exported Interfaces table.
>> Looks mostly good -- one nit: man pages aren't actually interfaces.
>> But we'll collectively pretend we didn't see that.  ;-}
> 
> Please help me to understand this.
> 
> Reviewers want to have a copy of the manpages included in the case materials
> directory.  That's a request I see fairly often, and I believe we're not
> questioning that piece.
> 
> However, is it not necessary to talk about the manpages anywhere else in the
> case materials?  It seems to be common practice to list them in the interfaces
> section, which, of course, is why I did so.

They'd be listed as references - they're the specs for the interfaces provided
by the commands or libraries, but not interfaces in themselves.

-- 
	-Alan Coopersmith-           alan.coopersmith at sun.com
	 Sun Microsystems, Inc. - X Window System Engineering