I noticed that in the latest draft of the IPS developers guide, the
description of chapter 7 says it talks about mediators, but it doesn't.
That discussion is left until chapter 10.

I haven't (yet) read it cover to cover, but I have some comments
on the table of contents.  :-)

(Note: Can we get a pointer to the dev guide inserted into at
least the pkg(1) and pkg(5) man pages?  At least a 
mention that it exists would tell people to go look for it.)

I think the stuff in chapter 7 should be grouped with the more advanced
stuff.

The mogrification stuff is part of basic functionality because you can't get
very far without overriding dependencies and link warnings and such.
Also it's a basic requirement to centralize things like permissions properties
and owner/group properties.

So I would put chapter 8 (the mogrify chapter) in the first half
(basic IPS) and the following chapters in the advanced sections.

Generally I would divide it according to:
1. things everybody will have to know
     code concepts
     basic commands
     dependencies, simple
     dependencies auto-generation
     mogrify
     pkglint
     some basic solaris conventions
2. things that only some people will have to know
     facets, mediated links, variants
     SMF self assembly
     signing, zones
     more  Solaris conventions

On Monday October 24, at    5:43PM, Bart Smaalders wrote:

> On 10/24/11 13:57, Tim Foster wrote:
>> On 10/21/11 06:42 PM, Dan Mick wrote:
>>> just quickly, from appendix1:
>>> 
>>> -as used in a package manifest might be:
>>> +as used in a package manifest might be::
>>> 
>>> seems like a mistake
>> 
>> Thanks Dan, I've corrected this in the current version, available at
>> 
>> http://timsfoster.files.wordpress.com/2011/10/draft-ips-dev-guide2.pdf
>> 
>> I've made small edits to Chapter 10 this morning and am continuing to
>> work on the remaining 'XXX' items this week. There's still time to make
>> changes to the guide and comments are very welcome,
>> 
> 
> I'm wordsmithing chapters 1 & 2.
> 
> - Bart
> 
> 
> 
> -- 
> Bart Smaalders                        Solaris Kernel Performance
> [email protected]     http://blogs.sun.com/barts
> "You will contribute more with Mercurial than with Thunderbird."
> "Civilization advances by extending the number of important
> operations which we can perform without thinking about them."
> _______________________________________________
> pkg-discuss mailing list
> [email protected]
> http://mail.opensolaris.org/mailman/listinfo/pkg-discuss

_______________________________________________
pkg-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/pkg-discuss

Reply via email to