[svnbook] r6062 committed - branches/1.7/en

[cmpilato at users.sourceforge.net]

Revision: 6062
          http://sourceforge.net/p/svnbook/source/6062
Author:   cmpilato
Date:     2023-07-13 14:58:52 +0000 (Thu, 13 Jul 2023)
Log Message:
-----------
Merge from ^/trunk/en r6061.

Modified Paths:
--------------
    branches/1.7/en/book/ch03-advanced-topics.xml

Property Changed:
----------------
    branches/1.7/en/

Index: branches/1.7/en
===================================================================
--- branches/1.7/en	2023-07-13 14:52:56 UTC (rev 6061)
+++ branches/1.7/en	2023-07-13 14:58:52 UTC (rev 6062)

Property changes on: branches/1.7/en
___________________________________________________________________
Modified: svn:mergeinfo
## -1 +1 ##
-/trunk/en:4202,4211,4216,4226,4231,4251,4261,4267-4270,4273,4296,4299,4305,4316,4320,4328,4335,4352,4364,4368,4370-4372,4374-4375,4378,4380,4382,4384,4386-4387,4390,4392-4393,4463,4516,4742,4958,5041,5043,5082,5089,5094,5165,5285,5288,5290,5365-5366,5391,5493,5572-5574,5684,5697,5717,5722,5736,5747,5752,5765,5768,5776,5778,5799,5806
\ No newline at end of property
+/trunk/en:4202,4211,4216,4226,4231,4251,4261,4267-4270,4273,4296,4299,4305,4316,4320,4328,4335,4352,4364,4368,4370-4372,4374-4375,4378,4380,4382,4384,4386-4387,4390,4392-4393,4463,4516,4742,4958,5041,5043,5082,5089,5094,5165,5285,5288,5290,5365-5366,5391,5493,5572-5574,5684,5697,5717,5722,5736,5747,5752,5765,5768,5776,5778,5799,5806,6061
\ No newline at end of property
Modified: branches/1.7/en/book/ch03-advanced-topics.xml
===================================================================
--- branches/1.7/en/book/ch03-advanced-topics.xml	2023-07-13 14:52:56 UTC (rev 6061)
+++ branches/1.7/en/book/ch03-advanced-topics.xml	2023-07-13 14:58:52 UTC (rev 6062)
@@ -3588,12 +3588,22 @@
     <informalexample>
       <screen>
 $ svn propget svn:externals calc
+# Resources versioned elsewhere.
 third-party/sounds             http://svn.example.com/repos/sounds
 third-party/skins -r148        http://svn.example.com/skinproj
 third-party/skins/toolkit -r21 http://svn.example.com/skin-maker
+$
 </screen>
     </informalexample>
 
+    <para>In the previous example, three externals have been defined.
+      The first is <quote>unpinned</quote>—it effectively refers
+      to the HEAD revision of its target.  The other two have specific
+      revisions declared.  Also demonstrated is the fact that lines
+      that begin with a hash (<literal>#</literal>) are treated as
+      comments and ignored by the externals definitions parsing
+      logic.</para>
+
     <para>When someone checks out a working copy of the
       <filename>calc</filename> directory referred to in the previous
       example, Subversion also continues to check out the items found
@@ -3639,9 +3649,11 @@
     <informalexample>
       <screen>
 $ svn propget svn:externals calc
+# Resources versioned elsewhere.
       http://svn.example.com/repos/sounds third-party/sounds
 -r148 http://svn.example.com/skinproj third-party/skins
 -r21  http://svn.example.com/skin-maker third-party/skins/toolkit
+$
 </screen>
     </informalexample>
 
@@ -3652,9 +3664,11 @@
     <informalexample>
       <screen>
 $ svn propget svn:externals calc
+# Resources versioned elsewhere.
 http://svn.example.com/repos/sounds third-party/sounds
 http://svn.example.com/skinproj@148 third-party/skins
 http://svn.example.com/skin-maker@21 third-party/skins/toolkit
+$
 </screen>
     </informalexample>
 
@@ -3802,6 +3816,7 @@
     <informalexample>
       <screen>
 $ svn propget svn:externals calc
+# Resources versioned elsewhere.
 ^/sounds third-party/sounds
 /skinproj at 148 third-party/skins
 //svn.example.com/skin-maker at 21 third-party/skins/toolkit