On Tue, Oct 21, 2008 at 02:42:46PM -0700, John Plocher wrote:
> Dean Roehrich wrote:
> >On Tue, Oct 21, 2008 at 01:46:19PM -0700, Mike Oliver wrote:
> >>Peter Dennis wrote:
> >>[...]
> >>> Example man page in the case's materials directory.
> >>Will man page(s) be delivered to the target system? The Exported
> >>Interfaces table makes no mention of them.
> >
> >The manpages belong in the References section.
> >
> >Or so I've been told,
> >
> > "Looks mostly good -- one nit: man pages aren't actually interfaces.
> > But we'll collectively pretend we didn't see that. ;-}"
> > -- James Carlson, 13 June 2008, LSARC/2008/373.
>
>
> Man pages are not exported interfaces, but they certainly import (or
> adhere to) the interfaces defined by the man page project
> (directories, formats, names...)
>
> Having them enumerated in a pkg manifest is usually sufficient,
> especially if they are going into the "right places". The project's
> spec needs to note what those "right places" are in this situation;
> the easy place to do this is one line in the interface table :-)
I would have expected another entry in the References section, something
like this:
References:
[1] http://www.gnu.org/software/gdbm/
Leader(s) of gdbm project: Jason Downs <downsj at downsj.com>
[2] 6744694 - Integrate gdbm into Solaris.
[3] gdbm.3c
In my past encounters with ARC members, that seemed to be what they were
looking for. That should answer the question of "right place".
Dean
