* Mike Gerdts <[EMAIL PROTECTED]> [2008-05-24 00:09]:
> On Fri, May 23, 2008 at 4:16 PM, Stephen Hahn <[EMAIL PROTECTED]> wrote:
> > Regarding the -s option: Once, I'd hoped we could collect the man
> > directories from the smf(5) template information across all services.
> >
> > That's still not enough, though. In keeping with our new model, we
> > should really see packages deliver a file with their man path or paths
> > into some well known directory. -s should concatenate these files
> > into an effective man path.
>
> How about having packages deliver man pages as actions? The
> appropriate handler could figure out how exactly how it is stored
> (compressed, preformatted, etc.) based upon configuration, how the
> windex file is updated, etc. This provides an effective means for
> delivering them today with whatever glue is needed to merge between
> the arcane past and the hopefully-not-arcane future.
I'm not keen on file-specific actions. (I think I've been persuaded
that even my envisioned service action (to deliver smf(5) manifests)
isn't needed.) In this example, isn't all the policy really on the
update service, and we're just interested in "this is a man page".
Bart and I have gone back and forth on whether the direct
"restart_fmri" or an indirect "type" attribute is more appropriate.
Either one achieves the "this is a man page" identification in some
fashion.
> > So, maybe
> >
> > /etc/man/paths
> >
> > contains files like
> >
> > /etc/man/paths/SUNWxscreensaver-hacks
> >
> > which has contents
> >
> > /usr/share/X11/man
>
> This seems like it would work, but there are two things that I don't like:
>
> - It introduces an interface (for package producers) that feels like a
> workaround.
> - It will add hundreds or thousands of tiny files, which ontribute to
> longer times for things like installation, restore, etc. If these
> files are read during boot it can add a lot of random reads to the
> boot process.
>
> However - if that is the mechanism used behind a man page action, it
> seems to be an OK mechanism until more attention can be paid.
On the drive home, I thought about this some more. (The drive ended
with a forehead smack.) What about tagging directory actions with a
"this is the top of a man tree"? Then the result of a search for
directory actions with this tag is the basis, and only touches the
pkg(5) indices. That is, in our SUNWxscreensaver-hacks example, we'd
have
dir group=bin mode=0755 owner=root path=usr/X11/share/man \
opensolaris.man_path=true
The update service would then add the value of the path attribute to
the manual path list it's building.
- Stephen
* Note that one of the Sun West Coast network sites will be taking
scheduled downtime tonight and tomorrow. opensolaris.org will be
unaffected, but some of us might not be able to read our sun.com
email. (Plus there's that US holiday weekend aspect.)
--
[EMAIL PROTECTED] http://blogs.sun.com/sch/
_______________________________________________
pkg-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/pkg-discuss
