Bug 60344

Summary: Update documentation to clearly document how we handle line endings
Product: Tomcat 9 Reporter: Andrew Lane Carr <andrewlanecarr>
Component: CatalinaAssignee: Tomcat Developers Mailing List <dev>
Severity: enhancement    
Priority: P2    
Version: unspecified   
Target Milestone: -----   
Hardware: PC   
OS: Mac OS X 10.1   

Description Andrew Lane Carr 2016-11-05 17:16:47 UTC

Comment 1 Andrew Lane Carr 2016-11-05 17:20:08 UTC
There is no version in the selection for M13, nor is there a component to select for "Documentation" under "Tomcat 9" bugs, hence the "Catalina" component of this ticket when it should be "Documentation".

When building on the MAC (OSX 10.11.4, also not a selectable option) I experienced issues running the server after the build had finished.  This was due to the line endings in the source archive I downloaded.  After speaking with the community (Mark, Felix, Violeta, others) I discovered that I should be using the src tar gz, instead of the zip file, to build on MAC.

The root of this problem is line endings not clearly defined in the documentation.  This is a place to put a patch for the documentation that will clearly indicate what will define line endings in the build process.
Comment 2 Andrew Lane Carr 2016-11-05 17:21:34 UTC
Also, Mark suggested we clearly define this in the documentation, see snippet below:

>>> ...it would be great if you could turn them into a patch 
>>> for the website - probably this page (part of the main wbesite):
>>> http://tomcat.apache.org/svn.html
>>> and/or this file (part of the docs):
>>> http://tomcat.apache.org/tomcat-9.0-doc/building.html
Comment 3 Mark Thomas 2017-01-03 17:50:06 UTC
Site fixed as well as
- trunk for 9.0.0.M16 onwards
- 8.5.x for 8.5.10 onwards
- 8.0.x for 8.0.40 onwards
- 7.0.x for 7.0.74 onwards