https://bz.apache.org/bugzilla/show_bug.cgi?id=65585

            Bug ID: 65585
           Summary: Obsolete comment at top of build.properties.default
                    file
           Product: Tomcat 10
           Version: 10.1.0-M5
          Hardware: PC
            Status: NEW
          Severity: trivial
          Priority: P2
         Component: Documentation
          Assignee: dev@tomcat.apache.org
          Reporter: knst.koli...@gmail.com
  Target Milestone: ------

Just noted. There is a comment at the top of build.properties.default file
(line #16) in all current versions of Tomcat says:

[[[
# -----------------------------------------------------------------------------
# build.properties.sample
#
# This is an example "build.properties" file, used to customize building
# Tomcat for your local environment.  It defines the location of all external
# modules that Tomcat depends on.  Copy this file to "build.properties"
# in the top-level source directory, and customize it as needed.
# -----------------------------------------------------------------------------
]]]

a) This file is not "build.properties.sample", but "build.properties.default".

b) It suggests copying the entire file. It would be better to copy just the
values that you are going to change.

c) Properties that can be configured like that are not limited to those listed
in this file. Almost any property declared in build.xml can be overwritten in
this way.

Maybe just reference to BUILDING.txt where this could be documented with more
details.

(I think properties declared with <local> task cannot be overwritten like
that.)

-- 
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