<pre style='margin:0'>
Joshua Root (jmroot) pushed a commit to branch master
in repository macports-base.
</pre>
<p><a href="https://github.com/macports/macports-base/commit/787ffd01b06458558ddb890ba019cab75bbf13a5">https://github.com/macports/macports-base/commit/787ffd01b06458558ddb890ba019cab75bbf13a5</a></p>
<pre style="white-space: pre; background: #F8F8F8">The following commit(s) were added to refs/heads/master by this push:
<span style='display:block; white-space:pre;color:#404040;'> new 787ffd01b Document port snapshot
</span>787ffd01b is described below
<span style='display:block; white-space:pre;color:#808000;'>commit 787ffd01b06458558ddb890ba019cab75bbf13a5
</span>Author: Joshua Root <jmr@macports.org>
AuthorDate: Tue Jun 11 18:22:21 2024 +1000
<span style='display:block; white-space:pre;color:#404040;'> Document port snapshot
</span>---
doc/Makefile.in | 1 +
doc/port-snapshot.1 | 93 ++++++++++++++++++++++++++++++++++++++++++++
doc/port-snapshot.1.txt | 64 ++++++++++++++++++++++++++++++
src/macports1.0/snapshot.tcl | 2 +-
4 files changed, 159 insertions(+), 1 deletion(-)
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/Makefile.in b/doc/Makefile.in
</span><span style='display:block; white-space:pre;color:#808080;'>index ed2d1a01c..f50c5c4af 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/Makefile.in
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/Makefile.in
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -75,6 +75,7 @@ MAN1= \
</span> port-selfupdate.1 \
port-setrequested.1 \
port-setunrequested.1 \
<span style='display:block; white-space:pre;background:#e0ffe0;'>+ port-snapshot.1 \
</span> port-space.1 \
port-sync.1 \
port-test.1 \
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-snapshot.1 b/doc/port-snapshot.1
</span>new file mode 100644
<span style='display:block; white-space:pre;color:#808080;'>index 000000000..2ad9082de
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--- /dev/null
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-snapshot.1
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -0,0 +1,93 @@
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+'\" t
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.TH "PORT\-SNAPSHOT" "1" "2\&.9\&.99" "MacPorts 2\&.9\&.99" "MacPorts Manual"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" -----------------------------------------------------------------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" * Define some portability stuff
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" -----------------------------------------------------------------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" http://bugs.debian.org/507673
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.ie \n(.g .ds Aq \(aq
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.el .ds Aq '
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" -----------------------------------------------------------------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" * set default formatting
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" -----------------------------------------------------------------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" disable hyphenation
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.nh
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" disable justification (adjust text to left margin only)
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.ad l
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" -----------------------------------------------------------------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" * MAIN CONTENT STARTS HERE *
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\" -----------------------------------------------------------------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.SH "NAME"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+port-snapshot \- Manage snapshots of installed ports\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.SH "SYNOPSIS"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.nf
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fBport\fR [\fB\-vdN\fR] \fBsnapshot\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ [\-\-create [\-\-note <note>]]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ [\-\-list] [\-\-diff \fIsnapshot\-id\fR [\-\-all]]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ [\-\-delete \fIsnapshot\-id\fR] [\-\-help]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.fi
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.SH "DESCRIPTION"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fBport snapshot\fR creates and manages snapshots of installed ports\&. Snapshots record information about the ports that are installed when the snapshot is created, and can be used by \fBport restore\fR to return to that previous state at a later time\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.SH "OPTIONS"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fB\-\-create\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Create a new snapshot that records the currently active ports\&. This is the default if no options are given\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fB\-\-note <note>\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+When creating a snapshot, it will be labelled with the given note\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fB\-\-list\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Display a list of all snapshots that currently exist, with their ID numbers, creation dates, and associated notes\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fB\-\-diff ID\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Display the differences between the given snapshot ID and the currently installed ports\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fB\-\-all\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Consider all ports when displaying diffs\&. By default, only differences in requested ports are shown\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fB\-\-delete ID\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Delete the snapshot with the given ID number\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fB\-\-help\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Display brief usage information\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.SH "GLOBAL OPTIONS"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fB\-N\fR
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Non\-interactive mode, create snapshots without asking for confirmation when there are inactive ports that will not be included\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.SH "SEE ALSO"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fBport\fR(1), \fBport-restore\fR(1), \fBport-migrate\fR(1)
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.SH "AUTHORS"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.sp
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.if n \{\
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\}
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.nf
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+(C) 2024 The MacPorts Project
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Joshua Root <jmr@macports\&.org>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.fi
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.if n \{\
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.\}
</span><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port-snapshot.1.txt b/doc/port-snapshot.1.txt
</span>new file mode 100644
<span style='display:block; white-space:pre;color:#808080;'>index 000000000..222f69818
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>--- /dev/null
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port-snapshot.1.txt
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -0,0 +1,64 @@
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+port-snapshot(1)
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+===============
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+NAME
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+----
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+port-snapshot - Manage snapshots of installed ports.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+SYNOPSIS
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+--------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+[cmdsynopsis]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*port* [*-vdN*] *snapshot*
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ [--create [--note <note>]]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ [--list] [--diff 'snapshot-id' [--all]]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ [--delete 'snapshot-id'] [--help]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+DESCRIPTION
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-----------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*port snapshot* creates and manages snapshots of installed ports. Snapshots
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+record information about the ports that are installed when the snapshot is
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+created, and can be used by *port restore* to return to that previous state
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+at a later time.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+OPTIONS
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*--create*::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Create a new snapshot that records the currently active ports. This is
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+the default if no options are given.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*--note <note>*::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+When creating a snapshot, it will be labelled with the given note.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*--list*::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Display a list of all snapshots that currently exist, with their ID
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+numbers, creation dates, and associated notes.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*--diff ID*::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Display the differences between the given snapshot ID and the currently
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+installed ports.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*--all*::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Consider all ports when displaying diffs. By default, only
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+differences in requested ports are shown.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*--delete ID*::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Delete the snapshot with the given ID number.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*--help*::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Display brief usage information.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+include::global-flags.txt[]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+*-N*::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Non-interactive mode, create snapshots without asking for confirmation
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+when there are inactive ports that will not be included.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+SEE ALSO
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+--------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+man:port[1], man:port-restore[1], man:port-migrate[1]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+AUTHORS
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+-------
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ (C) 2024 The MacPorts Project
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ Joshua Root <jmr@macports.org>
</span><span style='display:block; white-space:pre;color:#808080;'>diff --git a/src/macports1.0/snapshot.tcl b/src/macports1.0/snapshot.tcl
</span><span style='display:block; white-space:pre;color:#808080;'>index 7e6736a67..317f50444 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/src/macports1.0/snapshot.tcl
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/src/macports1.0/snapshot.tcl
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -63,7 +63,7 @@ namespace eval snapshot {
</span> ui_msg "Usage: One of:"
ui_msg " port snapshot \[--create\] \[--note '<message>'\]"
ui_msg " port snapshot --list"
<span style='display:block; white-space:pre;background:#ffe0e0;'>- ui_msg " port snapshot --diff <snapshot-id> \[--requested-only\]"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ ui_msg " port snapshot --diff <snapshot-id> \[--all\]"
</span> ui_msg " port snapshot --delete <snapshot-id>"
return 0
}
</pre><pre style='margin:0'>
</pre>