ant-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject DO NOT REPLY [Bug 53019] New: manual/Tasks/import.html unclear
Date Sun, 01 Apr 2012 00:37:27 GMT

             Bug #: 53019
           Summary: manual/Tasks/import.html unclear
           Product: Ant
           Version: 1.8.2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
    Classification: Unclassified

The text is unclear in a number of places:

* "So if I import for example a docsbuild.xml file named builddocs ...":

  The file is already hypothesized to be named "docsbuild.xml", so how can
  it (the _file_) also be named "builddocs"? 

  Presumably, the intent was that the _project_ in the file is named 
  "builddocs", so that text should mention the project, not just "file".

* "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. "

  It is not clear that the "it" in "redefine it" refers to the target (the
  antecedent of "it" could be the file or the (implicitly referred-to) 

  The text should say something like:

    ... I can redefine that target in ...

  or, more accurately and clearer:

    ... I can define a target named "docs" in ...

  (Also, the comma in "... named builddocs, that contains ..." is

Configure bugmail:
------- You are receiving this mail because: -------
You are the assignee for the bug.

View raw message