On Tue, Feb 15, 2011 at 03:34:56PM -0800, Shawn Walker wrote:
> On 02/15/11 03:03 PM, Peter Schow wrote:
> >Having trouble following Example 1 on the pkgmogrify(1) man page.
> >
> >Example 1 is:
> >
> >      Example 1:  Add tags to SMF manifests so they get imported when the
> >      package is installed on a live system.
> >
> >          <transform file path=(var|lib)/svc/manifest/.*\.xml ->  \
> >              add restart_fmri svc:/system/manifest-import:default>
> >
> >According the to man page, transforms look like this:
> >
> >      <transform matching-criteria ->  operation>
> >
> >where matching-criteria is:
> >
> >      [action-type ... ] [attribute=<value-regexp>  ...]
> >
> >So it looks like "action-type" is "file" and the resulting "operation"
> >is "set" for the example above.
> 
> Before pkgmogrify:
> 
> file path=lib/svc/manifest/application/pkg-server.xml
> 
> After pkgmogrify:
> 
> file path=lib/svc/manifest/application/pkg-server.xml
>    restart_fmri=svc:/system/manifest-import:default
> 
> >Where are these "action-types" like "file" defined?
> 
> See pkg(5).

Ok, I get it now.  I think this section of the pkgmogrify(1) 
man page should also take your advice and explictly refer 
to "Actions" in pkg(5), too.

I'll file a man page bug and propose the following wording 
change to make this clearer:

Old:  

     Matching criteria are of the form:

         [action-type ... ] [attribute=<value-regexp> ...]

     One of the action-types specified must match. 

Proposed:

     Matching criteria are of the form:

         [action-type ... ] [attribute=<value-regexp> ...]

     where action-type is one of the actions listed in the ``Actions''
     section of pkg(5).  One of the action-types specified must match. 
   

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

Reply via email to