Bug 33739 - 5.5 Docs missing CATALINA_BASE info formerly in RUNNING.txt
5.5 Docs missing CATALINA_BASE info formerly in RUNNING.txt
Status: RESOLVED FIXED
Product: Tomcat 5
Classification: Unclassified
Component: Catalina
5.5.7
All All
: P2 enhancement (vote)
: ---
Assigned To: Tomcat Developers Mailing List
http://jakarta.apache.org/tomcat/tomc...
:
Depends on:
Blocks:
  Show dependency tree
 
Reported: 2005-02-25 05:55 UTC by alexander dosher
Modified: 2005-07-22 07:07 UTC (History)
1 user (show)



Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description alexander dosher 2005-02-25 05:55:19 UTC
Section "(4) Advanced Configuration - Multiple Tomcat 4 Instances" in tomcat-
4.1-doc/RUNNING.txt is the *only* place that the use of the CATALINA_BASE 
directory and its subdirectories is discussed - and this info is missing 
entirely from the tomcat-5.5-doc tree.  This is can cause unnecessary googling 
for users who (like me) have either not touched Tomcat in a while or are new to 
it and starting with 5.*.  This info should be *somewhere*, perhaps tomcat-5.5-
doc/setup.html.
Comment 1 alexander dosher 2005-03-09 22:24:27 UTC
ok, the RUNNING.txt file still exists in the .zip installer - but *not* in 
the .exe.  and even so this info shouldn't be restricted to a text file anyway 
IMHO - should be in amongst the real docs.
Comment 2 Yoav Shapira 2005-03-23 17:02:59 UTC
Added clarifying comments and references/instructions for RUNNING.txt into
setup.html.
Comment 3 john czerwiec 2005-06-09 22:13:35 UTC
This is still NOT clear at all, and the reason is simple to fix -- the Release
Notes state : "Make sure to read the "RUNNING.txt" file in this directory if you
are using J2SE 1.4." but the directory structure of the archives does not match
that of all the directories from which the Release Notes are visible.

It would eliminate confusion if the phrase "in this directory" were changed to:
"in the fulldocs downloadable file(s)". In my opinion this is not worth
re-opening the bug, except to correct this confusion for all future users.
Comment 4 Yoav Shapira 2005-07-22 15:07:58 UTC
Done.