doc/packaging.txt
branchs11u2-sru
changeset 3496 b38b125547c2
parent 2584 ad7971db6ec0
child 3778 35735ffdda43
equal deleted inserted replaced
3493:ef55c867b23f 3496:b38b125547c2
    57 
    57 
    58     Actions for editable files must include an appropriate 'preserve' attribute:
    58     Actions for editable files must include an appropriate 'preserve' attribute:
    59         file path=etc/gnu/a2ps.cfg preserve=true mode=0644
    59         file path=etc/gnu/a2ps.cfg preserve=true mode=0644
    60 
    60 
    61     license actions should be placed in the canonical manifest.
    61     license actions should be placed in the canonical manifest.
       
    62 
       
    63 Manually generated actions
       
    64     * com.oracle.info.description is a terse description of what utilities,
       
    65       libraries and/or services the package provides.  This should be short,
       
    66       specific, concise text, identifying the technology covered by the
       
    67       associated license(s).  It should fit naturally in the sentence "This
       
    68       package may contain XXX."  For example, "XXX" might be "the tar command"
       
    69       or "bzip2 compression software."  When appropriate, this may begin with
       
    70       "portions of" or another, more specific qualifying clause.
       
    71     * com.oracle.info.tpno is the Oracle 3rd party license number.
       
    72     * info.classification is "org.opensolaris.category.2008:FOO" where FOO
       
    73       varies according to the sorts of utilities, libraries and/or services
       
    74       that the package provides.  Existing packages contain most useful
       
    75       values; check them out to find the closest match.  For a complete
       
    76       list of allowed values, refer to the Solaris system file
       
    77       /usr/share/lib/pkg/opensolaris.org.sections .
       
    78     * org.opensolaris.arc-caseid is typically "PSARC/YYYY/###" and multiple
       
    79       different values are allowed.
       
    80     * pkg.summary is a short synopsis of what the package provides.
       
    81     * org.opensolaris.consolidation is the name of the consolidation delivering
       
    82       the package.  In Userland, this is $(CONSOLIDATION) (which expands to
       
    83       "Userland" during the build).  Manifests in the Userland gate can also
       
    84       decorate this package attribute with an 'incorporate={incorporation-name}'
       
    85       decoration to specify where the package should be incorporated at the end
       
    86       of the userland build.  A special value of 'none' will cause the package
       
    87       to be unincorporated and float freely from the rest of the rest of the
       
    88       packages.  Note that unincorporated packages don't automatically get
       
    89       updated with the rest of the system when 'pkg update' is run unless the
       
    90       unincorporated package(s) are specified on the command line.
    62 
    91 
    63 Mogrified Manifest
    92 Mogrified Manifest
    64     The canonical manifest is combined with a set of the transforms
    93     The canonical manifest is combined with a set of the transforms
    65     in $(WS_TOP)/transforms, and a set of macros to more complete
    94     in $(WS_TOP)/transforms, and a set of macros to more complete
    66     package manifest using pkgmogrify(1).  The transforms apply default
    95     package manifest using pkgmogrify(1).  The transforms apply default