<pre style='margin:0'>
Joshua Root (jmroot) pushed a commit to branch release-2.10
in repository macports-base.

</pre>
<p><a href="https://github.com/macports/macports-base/commit/db5ad538d02e50de5aa8da38dda2e4b56b1896de">https://github.com/macports/macports-base/commit/db5ad538d02e50de5aa8da38dda2e4b56b1896de</a></p>
<pre style="white-space: pre; background: #F8F8F8"><span style='display:block; white-space:pre;color:#808000;'>commit db5ad538d02e50de5aa8da38dda2e4b56b1896de
</span>Author: Clemens Lang <cal@macports.org>
AuthorDate: Mon Oct 14 21:35:06 2024 +0200

<span style='display:block; white-space:pre;color:#404040;'>    doc: Document migrate/restore/snapshot in port(1)
</span><span style='display:block; white-space:pre;color:#404040;'>    
</span><span style='display:block; white-space:pre;color:#404040;'>    See https://lists.macports.org/pipermail/macports-users/2024-October/053107.html.
</span><span style='display:block; white-space:pre;color:#404040;'>    
</span><span style='display:block; white-space:pre;color:#404040;'>    (cherry picked from commit 079ce04d22e3c86fbf26d07a5292275a9e81a978)
</span>---
 doc/port.1     | 29 +++++++++++++++++++++++++++++
 doc/port.1.txt | 16 ++++++++++++++++
 2 files changed, 45 insertions(+)

<span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port.1 b/doc/port.1
</span><span style='display:block; white-space:pre;color:#808080;'>index bf9650bf6..4353e31ef 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port.1
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port.1
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1122,6 +1122,29 @@ gohome
</span> Loads the home page for the given portname in the default web browser\&.
 .RE
 .PP
<span style='display:block; white-space:pre;background:#e0ffe0;'>+migrate
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Reinstall MacPorts and all requested ports to ensure a smooth transition after major system changes such as operating system upgrades or CPU architecture changes\&. This automates the migration procedure previously documented at
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\m[blue]\fBMigration\fR\m[]\&\s-2\u[1]\d\s+2, which MacPorts recommends you follow after each major OS version upgrade\&. See
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fBport-migrate\fR(1)
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+for more details\&.
</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;'>+snapshot
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Create a snapshot of the currently installed ports to restore at a later point in time, e\&.g\&., after an OS upgrade\&. See
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fBport-snapshot\fR(1)
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+for more information\&.
</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;'>+restore
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Restore a previously created snapshot of installed ports created using
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fBport-snapshot\fR(1)\&. See
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\fBport-restore\fR(1)
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+for more information\&.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.PP
</span> usage
 .RS 4
 Displays a condensed usage summary\&.
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1362,3 +1385,9 @@ Rainer Mueller <raimue@macports\&.org>
</span> .if n \{\
 .RE
 .\}
<span style='display:block; white-space:pre;background:#e0ffe0;'>+.SH "EXTERNAL REFERENCES"
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.IP " 1." 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+Migration
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RS 4
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+\%https://trac.macports.org/wiki/Migration
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+.RE
</span><span style='display:block; white-space:pre;color:#808080;'>diff --git a/doc/port.1.txt b/doc/port.1.txt
</span><span style='display:block; white-space:pre;color:#808080;'>index 03882c6c0..d60ad1b63 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/doc/port.1.txt
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/doc/port.1.txt
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -564,6 +564,22 @@ reload::
</span> gohome::
     Loads the home page for the given portname in the default web browser.
 
<span style='display:block; white-space:pre;background:#e0ffe0;'>+migrate::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    Reinstall MacPorts and all requested ports to ensure a smooth transition
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    after major system changes such as operating system upgrades or CPU
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    architecture changes. This automates the migration procedure previously
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    documented at wiki:Migration[], which MacPorts recommends you follow after
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    each major OS version upgrade. See man:port-migrate[1] for more details.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+snapshot::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    Create a snapshot of the currently installed ports to restore at a later
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    point in time, e.g., after an OS upgrade. See man:port-snapshot[1] for more
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    information.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+restore::
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    Restore a previously created snapshot of installed ports created using
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+    man:port-snapshot[1]. See man:port-restore[1] for more information.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span> usage::
     Displays a condensed usage summary.
 
</pre><pre style='margin:0'>

</pre>