You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@poi.apache.org by on...@apache.org on 2016/07/17 21:31:09 UTC

svn commit: r1753126 - in /poi/site: publish/subversion.html src/documentation/content/xdocs/subversion.xml

Author: onealj
Date: Sun Jul 17 21:31:09 2016
New Revision: 1753126

URL: http://svn.apache.org/viewvc?rev=1753126&view=rev
Log:
git checkout should include a start revision range to avoid shooting oneself in the foot

Modified:
    poi/site/publish/subversion.html
    poi/site/src/documentation/content/xdocs/subversion.xml

Modified: poi/site/publish/subversion.html
URL: http://svn.apache.org/viewvc/poi/site/publish/subversion.html?rev=1753126&r1=1753125&r2=1753126&view=diff
==============================================================================
--- poi/site/publish/subversion.html (original)
+++ poi/site/publish/subversion.html Sun Jul 17 21:31:09 2016
@@ -394,16 +394,14 @@ if (VERSION > 3) {
         </p>
             
 <pre class="code">
-            git svn clone https://svn.apache.org/repos/asf/poi/trunk poisvngit
+            git svn clone https://svn.apache.org/repos/asf/poi/trunk poisvngit --revision <a href="https://svn.apache.org/viewvc?view=revision&revision=1732982">1732982</a>:HEAD
             </pre>
         
 <p>
-            This will run for a long time and will retrieve the full version history of
-            the Subversion repository.
-
-            If you would like to speed this up you can restrict the Git repository to a
-            certain range of SVN revisions via
-            <span class="codefrag">--revision from:HEAD</span>.
+            Running without <span class="codefrag">--revision from:HEAD</span> will run for a long time and will retrieve the full version history of
+            the Subversion repository. If you need more repository history, change the <span class="codefrag">from</span> revision to an
+            <a href="https://svn.apache.org/viewvc/poi/tags/">earlier release</a> or omit the <span class="codefrag">--revision</span>
+            specifier altogether.
         </p>
         
 <p>

Modified: poi/site/src/documentation/content/xdocs/subversion.xml
URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/subversion.xml?rev=1753126&r1=1753125&r2=1753126&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/subversion.xml (original)
+++ poi/site/src/documentation/content/xdocs/subversion.xml Sun Jul 17 21:31:09 2016
@@ -122,15 +122,13 @@
 
         </p>
             <source>
-            git svn clone https://svn.apache.org/repos/asf/poi/trunk poisvngit
+            git svn clone https://svn.apache.org/repos/asf/poi/trunk poisvngit --revision <link href="https://svn.apache.org/viewvc?view=revision&amp;revision=1732982">1732982</link>:HEAD
             </source>
         <p>
-            This will run for a long time and will retrieve the full version history of
-            the Subversion repository.
-
-            If you would like to speed this up you can restrict the Git repository to a
-            certain range of SVN revisions via
-            <code>--revision from:HEAD</code>.
+            Running without <code>--revision from:HEAD</code> will run for a long time and will retrieve the full version history of
+            the Subversion repository. If you need more repository history, change the <code>from</code> revision to an
+            <link href="https://svn.apache.org/viewvc/poi/tags/">earlier release</link> or omit the <code>--revision</code>
+            specifier altogether.
         </p>
         <p>
             When this finishes you have a Git repository whose "master" branch



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org