[MacPorts] SummerOfCode2017 modified

[MacPorts Wiki]

Page "SummerOfCode2017" was changed by umeshksingla
Diff URL: <https://trac.macports.org/wiki/SummerOfCode2017?action=diff&version=4>
Revision 4
Comment: add details for port migrate
Changes:
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: SummerOfCode2017
=========================================================================
--- SummerOfCode2017 (version: 3)
+++ SummerOfCode2017 (version: 4)
@@ -4,18 +4,30 @@
 This page is dedicated to the projects accepted into Google SoC 2017, here's a list of accepted projects:
 
 || '''Project''' || '''Student''' || '''Mentor''' ||
-|| [wiki:SummerOfCode2017#migrate Adding migration action to port command] || Umesh Kumar Singla || [wiki:pixilla Bradley Giesbrecht] ||
+|| [wiki:SummerOfCode2017#migrate Adding migration action to port command] || [wiki:umeshksingla Umesh Singla]  || [wiki:pixilla Bradley Giesbrecht] ||
 || [wiki:SummerOfCode2017#bot-ci Bot and CI for macports-ports] || [wiki:l2dy Zero King] || [wiki:mojca Mojca Miklavec], [wiki:cal Clemens Lang] ||
 
 == Adding migration action to port command == #migrate
 
-A MacPorts installation is designed to work with a particular OS and a particular hardware architecture. After major system changes like an OS upgrade or hardware change, currently, MacPorts users have to follow a set of manual migration instructions to ensure a smooth transition. The purpose of this project is to automate the processes described in the migration documentation, so that following the migration steps is no longer challenging for casual users or for anyone. The migration tool would install a new port command and using PortIndex, it would uninstall and reinstall the requested ports with variants.
+A MacPorts installation is designed to work with a particular OS and a particular hardware architecture. After major system changes like an OS upgrade or hardware change, currently, MacPorts users have to follow a set of manual migration instructions to ensure a smooth transition. The purpose of this project is to automate the processes described in the migration documentation so that following the migration steps is no longer challenging for casual users or for anyone. The migration tool would install a new port command and using PortIndex, it would uninstall and reinstall the requested ports with variants.
 
 [https://summerofcode.withgoogle.com/dashboard/project/5130769411342336/details/ Project on Google's SoC Dashboard (Login required)]
 
+==== How to use: ====
+
+* **NOTE 1: Make sure to take a backup of your requested ports and all ports first in a file.**
+* NOTE 2: It'd be better to keep the interactive mode on, so you know what's going on from time to time. [[BR]] There is a problem with restoring build dependencies at the moment, so it sometimes asks to continue.
+
+Run `sudo port migrate` after upgrading your system. It will create a snapshot of your ports first, and restore the active ports then. If there is a need to update macports, it will fail and notify. Try to follow the notes output at the end of its command.
+
+You can also use:
+`sudo port snapshot --note "some optional note"`  to create a snapshot yourself and later restore it using `sudo port restore --snapshot-id X`.
+
+At any point, if the restore fails and you need to do some manual changes in the registry, you can simply start the restore again afterward, using the same command as above.
+
 == Bot and CI for macports-ports == #bot-ci
 
-Right now PRs have to be manually tested by commiters and some commiters aren't aware of new PRs at all. Also certain information like whether the PR is submitted by the port maintainer have to be checked manually.
+Right now PRs have to be manually tested by commiters and some commiters aren't aware of new PRs at all. Also, certain information like whether the PR is submitted by the port maintainer have to be checked manually.
 
 [wiki:l2dy] plans to implement a bot in Go dealing with PRs for macports-ports and utilize Travis CI to test commits and PRs.
 
-------8<------8<------8<------8<------8<------8<------8<------8<--------

--
Page URL: <https://trac.macports.org/wiki/SummerOfCode2017>
MacPorts <https://www.macports.org/>
Ports system for macOS

This is an automated message. Someone added your email address to be
notified of changes on 'SummerOfCode2017' page.
If it was not you, please report to admin at macports.org.