https://cr.opensolaris.org/action/browse/pkg/barts/release-notes/webrev/

7137406 pkg image-update could display release notes (or pointer to)

This changeset doesn't include man page changes.

Updated proposal from bug report:

For Solaris, create a single package containing the release note
fragments. All possible release notes that could affect this release
are delivered as separate files, in a consistent directory. The files
will be named so as to distinguish them; the name is not otherwise
used. A new actuator named 'release-note' is added to each file; it
is set to an FMRI, which has an optional version. If that fmri is
present at the specified level or earlier in the original image, the
release note is included in the release-note summary. If no version
is specified, the release is note is included if any version was
present in the original image. If multiple release-note attributes
are set, the release note is used if any of the conditions are true.
If the special package name feature/package/self is used, this refers
to the containing package; if version 0 of this name is specified,
the release note is used if the package was NOT installed in the
original image. This can be used to display notes only on initial
installation.

The compiled release notes would be stored by IPS, and displayed to
the user if -v is given, or if -n is specified.

Without -v, if any release notes apply to the upgrade the user has
performed, he would be reminded to read them and told how to do so.
If any file with a release note that applies has must-display=true as
well, the release notes will be always be displayed whether or not -v is
used. Release notes for previous packaging operations can be read (&
file name retrieved) using pkg history -N. Release notes prepared for
new boot environments are stored in the new BE; they are also written
to a temporary file and a path given so they may be reviewed easily
prior to reboot.

- Bart

--
Bart Smaalders                  Solaris Kernel Performance
bart.smaald...@oracle.com       http://blogs.oracle.com/barts
"You will contribute more with Mercurial than with Thunderbird."
"Civilization advances by extending the number of important
 operations which we can perform without thinking about them."
_______________________________________________
pkg-discuss mailing list
pkg-discuss@opensolaris.org
http://mail.opensolaris.org/mailman/listinfo/pkg-discuss

Reply via email to