Greetings,
As of changeset 2456 in the pkg(5) gate, pkgsend(1) now only documents
support for the 'generate' and 'publish' subcommands, and the 'publish'
subcommand defaults to --fmri-in-manifest and no longer accepts an FMRI
argument.
======================================================================
What changed?
======================================================================
Previously, pkgsend(1) had a number of subcommands for supporting
action-by-action publication such as 'open', 'close', 'include',
'import', and 'abandon'.
All references to these subcommands have been removed from the man page,
although they continue to be supported for now. However, if you are
relying on them, be aware that they are planned for removal at a later,
future date.
The 'generate' and 'publish' subcommands now provide complete equivalent
functionality, so there should be no need for use of the now
undocumented ones.
The 'publish' subcommand has been changed incompatibly. Previously, it
accepted an FMRI for packages on the command line or inside package
manifests when using the option --fmri-in-manifest. It now only accepts
FMRIs specified inside a manifest and any operand to publish is treated
as the path to a manifest. The --fmri-in-manifest option is now
deprecated, although it is still accepted for compatibility purposes.
Finally, pkgsend(1) has been significantly simplified and updated.
======================================================================
How could this change impact me?
======================================================================
Any project currently relying on the no longer documented (and now
deprecated) subcommands 'open', 'include', 'close', 'abandon', and
import, should start using 'generate' and 'publish' instead. See
pkgsend(1) for information on their usage.
Any project using the --fmri-in-manifest option can safely remove use of
that option as that is now the only available behaviour. The old option
is still accepted for compatibility for now.
======================================================================
What are the related bug entries?
======================================================================
From defect.opensolaris.org:
9809 pkgsend publish should take bundle files as sources for files
13480 pkgsend should check user input before starting operations
16707 pkg.size is not recomputed during publication
16816 pkgsend should drop signatures and warn
17767 pkgsend should gracefully handle pipe errors (interrupted
input/output)
18048 pkgsend publish should assume --fmri-in-manifest by default
18181 pkgsend(1) could be clearer about manifest arguments to publish
18454 pkgsend(1) could be clearer about -s taking non-URI file paths
18527 pkgsend manpage example has publish subcommand in wrong location
18582 pkgsend(1) should not document action-by-action publication
operations
18678 pkgsend can traceback on permission errors when using bundle
files
18681 pkgsend generate output broken when using trailing slash
-Shawn
_______________________________________________
pkg-discuss mailing list
[email protected]
http://mail.opensolaris.org/mailman/listinfo/pkg-discuss
