ant-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 53019] New: manual/Tasks/import.html unclear
Date Sun, 01 Apr 2012 00:37:27 GMT
https://issues.apache.org/bugzilla/show_bug.cgi?id=53019

             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
        AssignedTo: notifications@ant.apache.org
        ReportedBy: dsb@smart.net
    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) 
  project).

  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
  extraneous.)

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

Mime
View raw message