svn commit: r1777171 - in /tomcat/site/trunk: docs/svn.html xdocs/svn.xml

[ma...@apache.org]

Author: markt
Date: Tue Jan  3 17:37:00 2017
New Revision: 1777171

URL: http://svn.apache.org/viewvc?rev=1777171&view=rev
Log:
Site part of fix for https://bz.apache.org/bugzilla/show_bug.cgi?id=60344
Document reasoning behind line-ending configuration.

Modified:
    tomcat/site/trunk/docs/svn.html
    tomcat/site/trunk/xdocs/svn.xml

Modified: tomcat/site/trunk/docs/svn.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/svn.html?rev=1777171&r1=1777170&r2=1777171&view=diff
==============================================================================
--- tomcat/site/trunk/docs/svn.html (original)
+++ tomcat/site/trunk/docs/svn.html Tue Jan  3 17:37:00 2017
@@ -219,6 +219,11 @@
 </li>
 <li>
 <a href="#Repository_Structure">Repository Structure</a>
+<ol>
+<li>
+<a href="#Line_endings">Line endings</a>
+</li>
+</ol>
 </li>
 <li>
 <a href="#Git_Mirror">Git Mirror</a>
@@ -392,6 +397,28 @@ http://svn.apache.org/repos/asf/tomcat</
 </table>
 
 
+<div class="subsection">
+<h4 id="Line_endings">Line endings</h4>
+<div class="text">
+
+
+<p>The repositories are configured so that when you check out from svn, you get
+the line ending appropriate for your platform for all files. The thinking behind
+this is that, for example, if you need to fix a typo in a .bat file from MacOS,
+it is easier if the .bat file has MacOS line-endings.</p>
+
+
+<p>When you build locally, line-endings are not changed. The expectation is that
+the source has the correct line-endings for your platform so all the files that
+matter on your platform will have the correct line endings. When you are on
+Windows it doesn't matter if the .sh files have Windows line-endings since
+you'll never use them on Windows.</p>
+
+
+</div>
+</div>
+
+
 </div>
 <h3 id="Git_Mirror">Git Mirror</h3>
 <div class="text">

Modified: tomcat/site/trunk/xdocs/svn.xml
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/xdocs/svn.xml?rev=1777171&r1=1777170&r2=1777171&view=diff
==============================================================================
--- tomcat/site/trunk/xdocs/svn.xml (original)
+++ tomcat/site/trunk/xdocs/svn.xml Tue Jan  3 17:37:00 2017
@@ -124,6 +124,21 @@ http://svn.apache.org/repos/asf/tomcat</
   </tr>
 </table>
 
+<subsection name="Line endings">
+
+<p>The repositories are configured so that when you check out from svn, you get
+the line ending appropriate for your platform for all files. The thinking behind
+this is that, for example, if you need to fix a typo in a .bat file from MacOS,
+it is easier if the .bat file has MacOS line-endings.</p>
+
+<p>When you build locally, line-endings are not changed. The expectation is that
+the source has the correct line-endings for your platform so all the files that
+matter on your platform will have the correct line endings. When you are on
+Windows it doesn't matter if the .sh files have Windows line-endings since
+you'll never use them on Windows.</p>
+
+</subsection>
+
 </section>
 
 <section name="Git Mirror">



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org