changeset 3476 c35c8f1a6df1
parent 2584 ad7971db6ec0
child 3778 35735ffdda43
--- 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
+    * 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.
+    * 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/ .
+    * 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