DO NOT REPLY [Bug 33282] New: - Import task documentation is unclear

[bu...@apache.org]

DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG�
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://issues.apache.org/bugzilla/show_bug.cgi?id=33282>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND�
INSERTED IN THE BUG DATABASE.

http://issues.apache.org/bugzilla/show_bug.cgi?id=33282

           Summary: Import task documentation is unclear
           Product: Ant
           Version: 1.6.2
          Platform: Sun
               URL: http://http://ant.apache.org/manual/CoreTasks/import.htm
                    l
        OS/Version: Solaris
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
        AssignedTo: dev@ant.apache.org
        ReportedBy: douglas.kramer@sun.com


On the import task page: http://ant.apache.org/manual/CoreTasks/import.html
This documentation could be clearer.

  Target overriding

  If a target in the main file is also present in at least one of the 
  imported files, it takes precedence.
                  ^^
Please replace "it" with either "the main target" or "the imported target".

  So if I import for example a docsbuild.xml file named builddocs, 
  that contains a "docs" target, I can redefine it in my main buildfile 
  and that is the one that will be called. This makes it easy to keep the 
  same target name, so that the overriding target is still called by any other 
  targets--in either the main or imported buildfile(s)--for which it is a 
  dependency, with a different implementation. 

This seems to say the target in the import file is called by "docs" name.
(since it doesn't require changing the other references to it.)

  The original target is made available by the name "builddocs.docs". 
  This enables the new implementation to call the old target, thus 
  enhancing it with tasks called before or after it.

The use of the word "original" is unclear.  I would think that the
main file contains the original target, but it cannot be overridden
by the imported target.  but the the name "builddocs.docs" leads me
to think this is the imported target being referred to.  
Please supplement "original" to either "original main" or "original imported".

Normally, I think of an add-on (import) as overriding the original (main)
behavior.  So this has my thinking turned around.

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

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org