Bug 60344 - Update documentation to clearly document how we handle line endings
Summary: Update documentation to clearly document how we handle line endings
Status: RESOLVED FIXED
Alias: None
Product: Tomcat 9
Classification: Unclassified
Component: Catalina (show other bugs)
Version: unspecified
Hardware: PC Mac OS X 10.1
: P2 enhancement (vote)
Target Milestone: -----
Assignee: Tomcat Developers Mailing List
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-11-05 17:16 UTC by Andrew Lane Carr
Modified: 2017-01-03 17:50 UTC (History)
0 users



Attachments

Note You need to log in before you can comment on or make changes to this bug.
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

Mark