[MacPorts] howto/SyncingWithSVN modified

[MacPorts]

Page "howto/SyncingWithSVN" was changed by rogerpack2005 at gmail.com
Diff URL: <https://trac.macports.org/wiki/howto/SyncingWithSVN?action=diff&version=14>
Revision 14
Comment: add early out option, minor textual changes
Changes:
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: howto/SyncingWithSVN
=========================================================================
--- howto/SyncingWithSVN (version: 13)
+++ howto/SyncingWithSVN (version: 14)
@@ -27,7 +27,7 @@
 cd svn.macports.org/trunk/dports 
 svn co https://svn.macports.org/repository/macports/trunk/dports/ .
 }}}
-If you prefer, the repository is also available via HTTP:
+If you prefer, the repository is also available via HTTP, which may be easier to sync later.
 {{{
 svn co http://svn.macports.org/repository/macports/trunk/dports/ .
 }}}
@@ -37,17 +37,26 @@
 === Step 2: '''Configure MacPorts''' ===
 Edit $prefix/etc/macports/sources.conf to comment out the rsync entry and add the "file" entry:
 
-Note: don't forget to replace $prefix.
+Note: don't forget to replace $prefix, so the initial part will start with "file:///" (three slashes).
 
 {{{
 #rsync://rsync.macports.org/release/ports/ [default]
 file://$prefix/var/macports/sources/svn.macports.org/trunk/dports/ [default]
 }}}
 
+At this point, if you don't care about future updates, you can manually build a portindex, like this:
+
+{{{
+cd $prefix/var/macports/sources/svn.macports.org/trunk/dports/
+portindex
+}}}
+
+and you're ready to go.  If you want to enable easy future updates, see step 3 "Configure Subversion" instead.
+
 === Step 3: '''Configure Subversion''' ===
 
 First, tell subversion to use your proxy to connect to the server:
-1. If $prefix/var/macports/home/.subversion/servers doesn't exist, create it by copying the corresponding file from another user.  (SVN automatically creates this file if it doesn't exist.)
+1. If the $prefix/var/macports/home/.subversion/servers file doesn't exist, create it by copying the corresponding ~/.subversion/servers file from another user to that location.  (SVN automatically creates this file if it doesn't exist, so you probably already have one.)
 2. Edit the file and set a proxy for hosts at `*.macports.org`.  Different proxy configurations require different sets of options here, but the file is pretty well commented, so it should be easy to figure out what you need.  At a minimum you'll need settings for http-proxy-host and http-proxy-port.
 
 Finally, if you want to use SVN over HTTPS to access the repository, you'll need to tell SVN to trust the MacPorts signature.  (SVN doesn't trust the authority that issued it, and `port sync` below invokes `svn up` with the `--non-interactive` flag, so you won't have the opportunity to accept the certificate then.)
@@ -55,7 +64,7 @@
 2. As a normal user, run `svn ls https://svn.macports.org/repository/macports/trunk/dports/`.  When prompted, accept the certificate permanently.
 3. SVN will store the certificate in a file in the directory `$HOME/.subversion/auth/svn.ssl.server`.  In that directory, find the file that contains the string "`https://svn.macports.org`" and copy it into `$prefix/var/macports/home/.subversion/auth/svn.ssl.server`.
 
-Or, you can use SVN over HTTP, in which case you don't need to worry about the certificate.
+Or, you can use SVN over HTTP, in which case you don't need to worry about the certificate or the 3 steps above.
 
 == Optional Parts ==
 
-------8<------8<------8<------8<------8<------8<------8<------8<--------

--
Page URL: <https://trac.macports.org/wiki/howto/SyncingWithSVN>
MacPorts <https://www.macports.org/>
Ports system for OS X

This is an automated message. Someone added your email address to be
notified of changes on 'howto/SyncingWithSVN' page.
If it was not you, please report to .