[MacPorts] #72628: port @2.10.99: port snapshot - Some differences between behaviour and documentation

[MacPorts]

#72628: port @2.10.99: port snapshot - Some differences between behaviour and
documentation
--------------------------+--------------------
 Reporter:  FaradayLight  |      Owner:  (none)
     Type:  defect        |     Status:  new
 Priority:  Normal        |  Milestone:
Component:  ports         |    Version:
 Keywords:                |       Port:
--------------------------+--------------------
 The following were found to be in contrast to the documentation found in:
 port help snapshot:

 1. The wording of the manual and the synopsis suggest that the following
 is valid and will default to using the '--create' option:

 {{{
 sudo port snapshot
 }}}

 Instead, a usage warning is reported:

 {{{
 % sudo port snapshot
 Password:
 Usage: One of:
   port snapshot [--create] [--note '<message>']
   port snapshot --list
   port snapshot --diff <snapshot-id> [--all]
   port snapshot --delete <snapshot-id>
   port snapshot --export <snapshot-id> >snapshot.json
   port snapshot --import snapshot.json
 }}}


 2. There seems to be a difference between the list of ports that will not
 be included in the snapshot, the list of ports reported by the '--diff'
 option. For example:

 {{{
 % sudo port snapshot --create --note 'Port command test of beta build
 2.10.99'
 The following inactive ports will not be a part of this snapshot and won't
 be installed while restoring:
  adwaita-icon-theme  @44.0_1
  libgcc13  @13.3.0_2 +stdlib_flag
  libvpx  @1.13.1_0
  mypy_select  @0.1_1
  nodejs21  @21.7.3_1
  py27-oldest-supported-numpy  @0.1_0
  py311-cssselect  @1.2.0_0
  py311-defusedxml  @0.7.1_0
  py311-future  @1.0.0_0
  py311-oldest-supported-numpy  @0.1_0
  py311-scour  @0.38.2_1
  py312-cssselect  @1.2.0_0
  py312-oldest-supported-numpy  @0.1_0
  py312-scour  @0.38.2_1
  py312-types-pytz  @2023.4.0.20240130_0
  py312-types-simplejson  @3.19.0.2_0
  py312-types-ujson  @5.10.0.20240515_0
  squid5  @5.10_0 +openssl
 Continue? [Y/n]: Y

 % port snapshot --diff 2
 Showing differences in requested ports only. Re-run with --all to see all
 differences.
 The following ports are installed but not in the snapshot:
  - nodejs21
  - squid5

 % port snapshot --diff 2 --all
 The following ports are installed but not in the snapshot:
  - adwaita-icon-theme
  - libgcc13
  - mypy_select
  - nodejs21
  - py27-oldest-supported-numpy
  - py311-cssselect
  - py311-defusedxml
  - py311-future
  - py311-oldest-supported-numpy
  - py311-scour
  - py312-cssselect
  - py312-oldest-supported-numpy
  - py312-scour
  - py312-types-pytz
  - py312-types-simplejson
  - py312-types-ujson
  - squid5

 ->> NOTE: libvpx is not listed in the '--diff --all' output.

 }}}


 4. The '--export' and '--import' options are not detailed in 'port help
 snapshot'.

-- 
Ticket URL: <https://trac.macports.org/ticket/72628>
MacPorts <https://www.macports.org/>
Ports system for macOS