From b9421dc80af485591a9c50cc8921f912e0def11e Mon Sep 17 00:00:00 2001 From: Ashlee Young Date: Fri, 23 Oct 2015 10:05:40 -0700 Subject: Removing sources to replace with download links instead. Change-Id: Ie28789a725051aec0d1b04dd291b7690a7898668 Signed-off-by: Ashlee Young --- .../manual/Tasks/native2ascii.html | 246 --------------------- 1 file changed, 246 deletions(-) delete mode 100644 framework/src/ant/apache-ant-1.9.6/manual/Tasks/native2ascii.html (limited to 'framework/src/ant/apache-ant-1.9.6/manual/Tasks/native2ascii.html') diff --git a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/native2ascii.html b/framework/src/ant/apache-ant-1.9.6/manual/Tasks/native2ascii.html deleted file mode 100644 index c50483b9..00000000 --- a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/native2ascii.html +++ /dev/null @@ -1,246 +0,0 @@ - - - -Native2Ascii Task - -

Native2Ascii

- -

Description:

- -

- Converts files from native encodings to ASCII with escaped Unicode. - A common usage is to convert source files maintained in a native - operating system encoding, to ASCII prior to compilation. -

- -

- Files in the directory src - are converted from a native encoding to ASCII. - By default, all files in the directory are converted. - However, conversion may be limited to selected files using - includes and excludes attributes. - For more information on file matching patterns, - see the section on - directory based tasks. - If no encoding is specified, - the default encoding for the JVM is used. - If ext is specified, then output files are renamed - to use it as a new extension. - More sophisticated file name translations can be achieved using a nested - <mapper> element. By default an - identity mapper will be used. - If dest and src point to the same directory, - the ext attribute or a nested <mapper> - is required. -

- -

- This task forms an implicit File Set, - and supports most attributes of <fileset> - (dir becomes src) as well as - nested <include>, <exclude>, - and <patternset> elements. -

- -

It is possible to use different converters. This can be selected - with the implementation attribute or a nested element. - Here are the choices of the attribute:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
AttributeDescriptionRequired
reverseReverse the sense of the conversion, - i.e. convert from ASCII to native only supported by the - sun converterNo
encodingThe native encoding the files are in - (default is the default encoding for the JVM)No
srcThe directory to find files in (default is basedir)No
destThe directory to output file toYes
extFile extension to use in renaming output filesNo
defaultexcludesindicates whether default excludes should be used or not - ("yes"/"no"). - Default excludes are used when omitted. - No
includescomma- or space-separated list of patterns of files that must be - included. All files are included when omitted.No
includesfilethe name of a file. Each line of this file is - taken to be an include patternNo
excludescomma- or space-separated list of patterns of files that must be excluded. - No files (except default excludes) are excluded when omitted.No
excludesfilethe name of a file. Each line of this file is - taken to be an exclude patternNo
implementationThe converter implementation to use. - If this attribute is not set, the default converter for the - current VM will be used. (See the above list of valid converters.)No
- -

Parameters specified as nested elements

- -

arg

- -

You can specify additional command line arguments for the converter -with nested <arg> elements. These elements are -specified like Command-line Arguments -but have an additional attribute that can be used to enable arguments -only if a given converter implementation will be used.

- - - - - - - - - - - - - - - - - - - - - - - - - - -
AttributeDescriptionRequired
valueSee - Command-line Arguments.Exactly one of these.
line
file
path
implementationOnly pass the specified argument if the chosen converter - implementation matches the value of this attribute. Legal values - are the same as those in the above list of valid compilers.)No
- -

implementationclasspath since Apache Ant 1.8.0

- -

A PATH like structure holding the - classpath to use when loading the converter implementation if a - custom class has been specified. Doesn't have any effect when - using one of the built-in converters.

- -

Any nested element of a type that implements Native2AsciiAdapter - since Ant 1.8.0

- -

If a defined type implements the Native2AsciiAdapter - interface a nested element of that type can be used as an - alternative to the implementation attribute.

- -

Examples

- - 
-<native2ascii encoding="EUCJIS" src="srcdir" dest="srcdir"
-   includes="**/*.eucjis" ext=".java"/>
-
- -

- Converts all files in the directory srcdir - ending in .eucjis from the EUCJIS encoding to ASCII - and renames them to end in .java. -

- -
-<native2ascii encoding="EUCJIS" src="native/japanese" dest="src"
-   includes="**/*.java"/>
-
- -

- Converts all the files ending in .java - in the directory native/japanese to ASCII, - placing the results in the directory src. - The names of the files remain the same. -

- -

If you want to use a custom - Native2AsciiAdapter org.example.MyAdapter you can either - use the implementation attribute:

-
-<native2ascii encoding="EUCJIS" src="srcdir" dest="srcdir"
-       includes="**/*.eucjis" ext=".java"
-       implementation="org.example.MyAdapter"/>
-
-

or a define a type and nest this into the task like in:

-
-<componentdef classname="org.example.MyAdapter"
-              name="myadapter"/>
-<native2ascii encoding="EUCJIS" src="srcdir" dest="srcdir"
-       includes="**/*.eucjis" ext=".java">
-  <myadapter/>
-</native2ascii>
-
-

in which case your native2ascii adapter can support attributes and - nested elements of its own.

- - - -- cgit 1.2.3-korg