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-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org