https://issues.apache.org/bugzilla/show_bug.cgi?id=50294

           Summary: Mention obvious things about config format
           Product: Tomcat 7
           Version: trunk
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: enhancement
          Priority: P4
         Component: Documentation
        AssignedTo: dev@tomcat.apache.org
        ReportedBy: lme...@vmware.com


Created an attachment (id=26311)
 --> (https://issues.apache.org/bugzilla/attachment.cgi?id=26311)
diff against http://svn.apache.org/repos/asf/tomcat/trunk/webapps/docs

It might be obvious to those who work on Tomcat, but sometimes things need to
be spelled out for others. I suggest mentioning at the top of the config
section that configs are schemaless XML and case-sensitive. Patches created
against the docs webapps in 5.5, 6.0, and trunk that are basically like this:

--- config/index.xml    (revision 1036202)
+++ config/index.xml    (working copy)

-<p>The Tomcat configuration files support Apache Ant style variable
-substitution. A system property with the name <code>propname</code> may be
+<p>Tomcat configuration files are formatted as schemaless XML; elements and
+attributes are case-sensitive. Apache Ant-style variable substitution
+is supported; a system property with the name <code>propname</code> may be
 used in a configuration file using the syntax <code>${propname}</code>. All

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

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

Reply via email to