--- a/doc/packaging.txt Tue Nov 18 17:39:37 2014 -0800
+++ b/doc/packaging.txt Fri Oct 10 10:07:08 2014 -0700
@@ -60,6 +60,35 @@
license actions should be placed in the canonical manifest.
+Manually generated actions
+ * com.oracle.info.description is a terse description of what utilities,
+ libraries and/or services the package provides. This should be short,
+ specific, concise text, identifying the technology covered by the
+ associated license(s). It should fit naturally in the sentence "This
+ package may contain XXX." For example, "XXX" might be "the tar command"
+ or "bzip2 compression software." When appropriate, this may begin with
+ "portions of" or another, more specific qualifying clause.
+ * com.oracle.info.tpno is the Oracle 3rd party license number.
+ * info.classification is "org.opensolaris.category.2008:FOO" where FOO
+ varies according to the sorts of utilities, libraries and/or services
+ that the package provides. Existing packages contain most useful
+ values; check them out to find the closest match. For a complete
+ list of allowed values, refer to the Solaris system file
+ /usr/share/lib/pkg/opensolaris.org.sections .
+ * org.opensolaris.arc-caseid is typically "PSARC/YYYY/###" and multiple
+ different values are allowed.
+ * pkg.summary is a short synopsis of what the package provides.
+ * org.opensolaris.consolidation is the name of the consolidation delivering
+ the package. In Userland, this is $(CONSOLIDATION) (which expands to
+ "Userland" during the build). Manifests in the Userland gate can also
+ decorate this package attribute with an 'incorporate={incorporation-name}'
+ decoration to specify where the package should be incorporated at the end
+ of the userland build. A special value of 'none' will cause the package
+ to be unincorporated and float freely from the rest of the rest of the
+ packages. Note that unincorporated packages don't automatically get
+ updated with the rest of the system when 'pkg update' is run unless the
+ unincorporated package(s) are specified on the command line.
+
Mogrified Manifest
The canonical manifest is combined with a set of the transforms
in $(WS_TOP)/transforms, and a set of macros to more complete