Description

Adjusts a text file to local conventions.

The set of files to be adjusted can be refined with the includesincludesfileexcludesexcludesfile and defaultexcludes attributes. Patterns provided through the includes or includesfile attributes specify files to be included. Patterns provided through the exclude or excludesfile attribute specify files to be excluded. Additionally, default exclusions can be specified with the defaultexcludes attribute. See the section on directory-based tasks, for details of file inclusion/exclusion patterns and their usage.

This task forms an implicit FileSet and supports most attributes of <fileset> (dir becomes srcdir) as well as the nested <include><exclude> and <patternset> elements.

The output file is only written if it is a new file, or if it differs from the existing file. This prevents spurious rebuilds based on unchanged files which have been regenerated by this task.

Since Apache Ant 1.7, this task can be used in a filterchain.

Parameters

Attribute Description Required
As Task As Filter
srcDir Where to find the files to be fixed up. One of these  
file Name of a single file to fix. Since Ant 1.7  
destDir Where to place the corrected files. Defaults to srcDir (replacing the original file). No  
includes comma- or space-separated list of patterns of files that must be included. All files are included when omitted. No  
includesfile the name of a file. Each line of this file is taken to be an include pattern. No  
excludes comma- or space-separated list of patterns of files that must be excluded. No files (except default excludes) are excluded when omitted. No  
excludesfile the name of a file. Each line of this file is taken to be an exclude pattern. No  
defaultexcludes indicates whether default excludes should be used or not ("yes"/"no"). Default excludes are used when omitted. No  
encoding The encoding of the files. No; defaults to default JVM encoding.  
outputencoding The encoding to use when writing the files. Since Ant 1.7 No; defaults to the value of the encoding attribute.  
preservelastmodified Whether to preserve the last modified date of source files. Since Ant 1.6.3 No; default is false  
eol Specifies how end-of-line (EOL) characters are to be handled. The EOL characters are CR, LF and the pair CRLF. Valid values for this property are:

  • asis: leave EOL characters alone
  • cr: convert all EOLs to a single CR
  • lf: convert all EOLs to a single LF
  • crlf: convert all EOLs to the pair CRLF
  • mac: convert all EOLs to a single CR
  • unix: convert all EOLs to a single LF
  • dos: convert all EOLs to the pair CRLF

Default is based on the platform on which you are running this task. For Unix platforms (including Mac OS X), the default is "lf". For DOS-based systems (including Windows), the default is "crlf". For Mac environments other than OS X, the default is "cr".

This is the preferred method for specifying EOL. The "cr" attribute (see below) is now deprecated.

N.B.: One special case is recognized. The three characters CR-CR-LF are regarded as a single EOL. Unless this property is specified as "asis", this sequence will be converted into the specified EOL type.

No
cr Deprecated. Specifies how CR characters are to be handled at end-of-line (EOL). Valid values for this property are:

  • asis: leave EOL characters alone.
  • add: add a CR before any single LF characters. The intent is to convert all EOLs to the pair CRLF.
  • remove: remove all CRs from the file. The intent is to convert all EOLs to a single LF.

Default is based on the platform on which you are running this task. For Unix platforms, the default is "remove". For DOS based systems (including Windows), the default is "add".

N.B.: One special case is recognized. The three characters CR-CR-LF are regarded as a single EOL. Unless this property is specified as "asis", this sequence will be converted into the specified EOL type.

No
javafiles Used only in association with the "tab" attribute (see below), this boolean attribute indicates whether the fileset is a set of java source files ("yes"/"no"). Defaults to "no". See notes in section on "tab". No
tab Specifies how tab characters are to be handled. Valid values for this property are:

  • add: convert sequences of spaces which span a tab stop to tabs
  • asis: leave tab and space characters alone
  • remove: convert tabs to spaces

Default for this parameter is "asis".

N.B.: When the attribute "javafiles" (see above) is "true", literal TAB characters occurring within Java string or character constants are never modified. This functionality also requires the recognition of Java-style comments.

N.B.: There is an incompatibility between this and the previous version in the handling of white space at the end of lines. This version does not remove trailing whitespace on lines.

No
tablength TAB character interval. Valid values are between 2 and 80 inclusive. The default for this parameter is 8. No
eof Specifies how DOS end of file (control-Z) characters are to be handled. Valid values for this property are:

  • add: ensure that there is an EOF character at the end of the file
  • asis: leave EOF characters alone
  • remove: remove any EOF character found at the end

Default is based on the platform on which you are running this task. For Unix platforms, the default is remove. For DOS based systems (including Windows), the default is asis.

No
fixlast Whether to add a missing EOL to the last line of a processed file.
Ignored if EOL is asis.
Since Ant 1.6.1
No; default is true

Examples

<fixcrlf srcdir="${src}" includes="**/*.sh"
eol="lf" eof="remove" />

Replaces EOLs with LF characters and removes eof characters from the shell scripts. Tabs and spaces are left as is.

<fixcrlf srcdir="${src}"
includes="**/*.bat" eol="crlf" />

Replaces all EOLs with cr-lf pairs in the batch files. Tabs and spaces are left as is. EOF characters are left alone if run on DOS systems, and are removed if run on Unix systems.

<fixcrlf srcdir="${src}"
includes="**/Makefile" tab="add" />

Sets EOLs according to local OS conventions, and converts sequences of spaces and tabs to the minimal set of spaces and tabs which will maintain spacing within the line. Tabs are set at 8 character intervals. EOF characters are left alone if run on DOS systems, and are removed if run on Unix systems. Many versions of make require tabs prior to commands.

<fixcrlf srcdir="${src}" includes="**/*.java"
tab="remove" tablength="3"
eol="lf" javafiles="yes" />

Converts all EOLs in the included java source files to a single LF. Replace all TAB characters except those in string or character constants with spaces, assuming a tab width of 3. If run on a unix system, any CTRL-Z EOF characters at the end of the file are removed. On DOS/Windows, any such EOF characters will be left untouched.

<fixcrlf srcdir="${src}"
includes="**/README*" tab="remove" />

Sets EOLs according to local OS conventions, and converts all tabs to spaces, assuming a tab width of 8. EOF characters are left alone if run on DOS systems, and are removed if run on Unix systems. You never know what editor a user will use to browse READMEs.

refer : https://ant.apache.org/manual/Tasks/fixcrlf.html / http://sepp.oetiker.ch/ant-1.6.5-rp/manual/api/org/apache/tools/ant/taskdefs/FixCRLF.html

JAVA_build_ant_FixCRLF的更多相关文章

随机推荐

  1. LeetCode_Single Number II

    Given an array of integers, every element appears three times except for one. Find that single one. ...

  2. perl dbi 测试 mysql wait_timeout

    The number of seconds the server waits for activity on a noninteractive connection before closing it ...

  3. Java---设计模块(单例的变形)(多例)

    设计模式1--单例变形(多例) ★ 缓存在单例中的使用 缓存在编程中使用很频繁,有着非常重要的作用,它能够帮助程序实现以空间换取时间,通常被设计成整个应用程序所共享的一个空间,现要求实现一个用缓存存放 ...

  4. tomcat主目录

    简单显示天气预报js 代码

  5. Sublime Text 3配置记录

    G++ /** * 工具->编译系统->新编译系统 */ { "cmd": ["g++", "${file}", "- ...

  6. css链接

    css code: a:link{ color:#FF0000; } a:visited{ color:#00FF00; } a:hover { color:#0000FF; } a:active{ ...

  7. DB2高级安装

     学习从安装开始,哈哈.这里记下  Windows 和 UNIX/Linux安装DB2的各种方式,不同,及具体的一些细节.    Windows下向导化安装:            setup.exe ...

  8. int与Integer

    int 是基本类型,直接存数值 integer是对象,用一个引用指向这个对象 1.Java 中的数据类型分为基本数据类型和复杂数据类型 int 是前者>>integer 是后者(也就是一个 ...

  9. HDU 蟠桃记

    蟠桃记 Time Limit : 2000/1000ms (Java/Other)   Memory Limit : 65536/32768K (Java/Other) Total Submissio ...

  10. Solr的安装

    1.   JDK要求 Solr 4.10 要求JDK版本必须是1.7或更高. 下载地址: http://www.apache.org/dyn/closer.cgi/lucene/solr/ 下载得到z ...