[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=16>
Revision 16
Comment: try to clarify the normal flow for sync'ing
Changes:
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: howto/SyncingWithSVN
=========================================================================
--- howto/SyncingWithSVN (version: 15)
+++ howto/SyncingWithSVN (version: 16)
@@ -25,11 +25,11 @@
 cd $prefix/var/macports/sources
 mkdir -p svn.macports.org/trunk/dports
 cd svn.macports.org/trunk/dports 
+svn co http://svn.macports.org/repository/macports/trunk/dports/ .
+}}}
+If you prefer, the repository is also available via HTTPS, though this will require an extra config step, for automatic updates.
+{{{
 svn co https://svn.macports.org/repository/macports/trunk/dports/ .
-}}}
-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/ .
 }}}
 
 == Configuration ==
@@ -37,34 +37,25 @@
 === 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, so the initial part will start with "file:///" (three slashes).
+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.  This should not be necessary if your initial SVN checkout was from an http or https URL, so most people should not have to do this.
+First, tell subversion to use your proxy to connect to the server.  This should not be necessary if your initial SVN checkout was from an http or https URL (and the checkout worked), so most people should not have to do this.  If you needed to configure your own ~/.subversion/servers file to be able to do the initial checkout, then you *do* need this step. 
 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 (i.e. if your initial SVN checkout was from the https:// URL), 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.)
+Finally, if you want to use SVN over HTTPS to access the repository (i.e. if your initial SVN checkout was the https:// URL), 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.)
 1. `mkdir -p $prefix/var/macports/home/.subversion/auth/svn.ssl.server`
 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 (initial checkout was from http:// URL), in which case you don't need to worry about the certificate or the 3 steps above.
+Or, you can use SVN over HTTP (i.e. your initial checkout was from the http:// URL), in which case you don't need to worry about the certificate.
 
 === Step 4: ''Sync''' ===
 
-------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 .