From c70a410ae7fee9b5ddc56c194485b403af335bc5 Mon Sep 17 00:00:00 2001 From: Steve Loughran Date: Tue, 22 Aug 2006 23:12:22 +0000 Subject: [PATCH] s/cvs/svn/ and some other tweaks git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@433795 13f79535-47bb-0310-9956-ffa450edef68 --- docs/ant_task_guidelines.html | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/docs/ant_task_guidelines.html b/docs/ant_task_guidelines.html index ae1b4518a..d862b809e 100644 --- a/docs/ant_task_guidelines.html +++ b/docs/ant_task_guidelines.html @@ -127,6 +127,7 @@ Here is a list of preferred attribute names: destination directory for output + destfile @@ -167,7 +168,8 @@ to their Ant system configuration. Keep member variables private. If read access by subclasses is required, add accessor methods rather than change the accessiblity of the member. -This enables subclasses to access the contents, yet still be decoupled from the actual implementation. +This enables subclasses to access the contents, yet still be decoupled +from the actual implementation.

The other common re-use mechanism in Ant is for one task to create and @@ -223,14 +225,16 @@ Ant tasks cannot use this keyword. They also need to move away from using the JUnit assert() method and call assertTrue() instead.

-Java 1.5 adds the enum; again, this must not be used. +Java 1.5 adds the enum type; again, this must not be used.

Explicitly Expand properties in nested text

For historical reasons, addText(String text) is called to set the task's nested text, without any property expansion taking place. Call Project.replaceProperties() to do this manually. - +If you forget, you create a problem that is impossible to fix +without breaking users' build files. +

Refactor

If the changes made to a task are making it too unwieldy, split it up @@ -396,7 +400,7 @@ that constitute part of the patch.
  • Approach 2 - The Manual Way

    Patches to existing files should be generated with -cvs diff -u filename +svn diff -u filename and save the output to a file. If you want to get the changes made to multiple files in a directory , just use cvs diff -u. Then, Tar and GZip the patch file as well as any new files @@ -454,7 +458,7 @@ cases, while documentation helps sell the reason for a task.

  • New test cases written and succeed.
  • Documentation page extended as appropriate.
  • Example task declarations in the documentation tested. -
  • Diff files generated using cvs diff -u +
  • Diff files generated using svn diff -u
  • Message to dev contains [PATCH], task name and patch reason in subject.
  • Message body contains a rationale for the patch. @@ -473,7 +477,7 @@ subject.
  • New test cases written and succeed
  • Documentation page written
  • Example task declarations in the documentation tested. -
  • Patch files generated using cvs diff -u +
  • Patch files generated using svn diff -u
  • patch files include a patch to defaults.properties to register the tasks
  • patch files include a patch to coretasklist.html or @@ -484,7 +488,7 @@ optionaltasklist.html to link to the new task page test and patches zipped up to escape the HTML filter.
    -

    Copyright © 2001-2003, 2005 Apache Software Foundation. All rights +

    Copyright © 2001-2003, 2005-2006 Apache Software Foundation. All rights Reserved.