doc/packaging.txt
changeset 1393 300d3de848bb
parent 1235 413599fe2d31
child 1428 94d2b78b3e05
--- a/doc/packaging.txt	Thu Jul 11 17:18:47 2013 -0700
+++ b/doc/packaging.txt	Fri Jul 12 09:55:54 2013 -0700
@@ -58,7 +58,28 @@
     Actions for editable files must include an appropriate 'preserve' attribute:
         file path=etc/gnu/a2ps.cfg preserve=true mode=0644
 
-    license actions should be placed in the canonical manifest.
+    license actions should be placed in the canonical manifest, as should a
+    handful of other special actions noted in the "Manually generated actions"
+    section just below.
+
+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.
 
 Mogrified Manifest
     The canonical manifest is combined with a set of the transforms