JAVA_build_ant_FixCRLF
Description
Adjusts a text file to local conventions.
The set of files to be adjusted can be refined with the includes, includesfile, excludes, excludesfile 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:
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:
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:
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:
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的更多相关文章
随机推荐
- ural 1671 Anansi's Cobweb
这道题是并差集的简单应用 #include <cstdio> #include <cstring> #include <algorithm> #define max ...
- Protel 的自动推挤功能
大家都在用PROTEL99SE...有时候要修改布好的线...一条条的去拆,这样很麻烦.其实PROTEL99SE是有推挤功能的...虽然不是很强...但是可以给大家带来方便.下面我就发个自己制作的教程 ...
- WPF自定义控件与样式(15)-终结篇
原文:WPF自定义控件与样式(15)-终结篇 系列文章目录 WPF自定义控件与样式(1)-矢量字体图标(iconfont) WPF自定义控件与样式(2)-自定义按钮FButton WPF自定义控件与 ...
- PHP PDO 安装使用
PDO(PHP Data Object) 是PHP 5新出来的东西,在PHP 6都要出来的时候,PHP 6只默认使用PDO来处理数据库,将把所有的数据库扩展移到了PECL,那么默认就是没有了我们喜爱的 ...
- 在SQL Server中使用命令调用SSIS包
在SQL Server中可以使用dtexec命令运行SSIS包(2005以上版本),当然也可以通过系统过程:xp_cmdshell调用dtexec运行SSIS包. 具体操作步骤如下: 1.首先,当然是 ...
- 笔记:java并发编程实践1
Java 5.0 adds ConcurrentHashMap, a replacement for synchronized hash-based Map implementations, and ...
- bfs 记录和打印最短路径
Poj3984 迷宫问题 #include <iostream> #include <algorithm> #include <cstdio> #include & ...
- Scala-数组
package com.mengyao.scala.function /** * Scala中数组的声明和使用(定长数组和变长数组) * * @author mengyao */object Tes ...
- lua中的坑
在工作中使用lua也有一年了,代码也写了不少,踩过不少坑,这里记录一下. table.sort table.sort是lua自带的排序函数,数据量小时,也还是不错的.不过要注意你传入的compare函 ...
- Python进阶(面向对象编程基础)(一)
鉴于昨天被类和函数折腾得晕头转向,今特把类的知识翻出来温习. 1.定义类并创建实力对象 #!/usr/bin/env python # -*- coding:utf-8 -*- __author__ ...