You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by mb...@apache.org on 2006/04/28 16:14:00 UTC
svn commit: r397909 - in /ant/core/trunk/docs/manual: CoreTasks/filter.html
CoreTypes/filterchain.html
Author: mbenson
Date: Fri Apr 28 07:13:57 2006
New Revision: 397909
URL: http://svn.apache.org/viewcvs?rev=397909&view=rev
Log:
More warnings about filtering binary files. Bugzilla #39445.
Modified:
ant/core/trunk/docs/manual/CoreTasks/filter.html
ant/core/trunk/docs/manual/CoreTypes/filterchain.html
Modified: ant/core/trunk/docs/manual/CoreTasks/filter.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/manual/CoreTasks/filter.html?rev=397909&r1=397908&r2=397909&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/CoreTasks/filter.html (original)
+++ ant/core/trunk/docs/manual/CoreTasks/filter.html Fri Apr 28 07:13:57 2006
@@ -13,7 +13,8 @@
<p>Sets a token filter for this project or read multiple token filter from
an input file and sets these as filters.
Token filters are used by all tasks that perform file copying operations
-through the Project commodity methods.</p>
+through the Project commodity methods. See the warning
+<a href="../using.html#filters"><em>here</em></a> before using.</p>
<p>Note 1: the token string must not contain the separators chars (@).<br>
Note 2: Either token and value attributes must be provided, or only the
filtersfile attribute.</p>
@@ -56,7 +57,7 @@
and set these as filters.
<hr>
-<p align="center">Copyright © 2000-2002,2004-2005 The Apache Software Foundation. All rights
+<p align="center">Copyright © 2000-2002, 2004-2006 The Apache Software Foundation. All rights
Reserved.</p>
</body>
Modified: ant/core/trunk/docs/manual/CoreTypes/filterchain.html
URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/manual/CoreTypes/filterchain.html?rev=397909&r1=397908&r2=397909&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/CoreTypes/filterchain.html (original)
+++ ant/core/trunk/docs/manual/CoreTypes/filterchain.html Fri Apr 28 07:13:57 2006
@@ -9,10 +9,11 @@
<body>
<h2>FilterChains and FilterReaders</h2>
-Look at Unix pipes - they offer you so much flexibility -
-say you wanted to copy just those lines that contained the
-string blee from the first 10 lines of a file 'foo'
-to a file 'bar' - you would do something like<p>
+Consider the flexibility of Unix pipes. If you wanted,
+for example, to copy just those lines that contained the
+string blee from the first 10 lines of a text file 'foo'
+(<em>you wouldn't want to filter a binary file</em>)
+to a file 'bar', you would do something like:<p>
<code>
cat foo|head -n10|grep blee > bar
</code><p>
@@ -1402,4 +1403,4 @@
<hr>
<p align=center>Copyright © 2002-2006 The Apache Software Foundation. All rights
-Reserved.</p></body></html>
\ No newline at end of file
+Reserved.</p></body></html>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org
Re: svn commit: r397909 - in /ant/core/trunk/docs/manual: CoreTasks/filter.html CoreTypes/filterchain.html
Posted by Matt Benson <gu...@yahoo.com>.
--- Stephane Bailliez <sb...@gmail.com> wrote:
[SNIP]
> >
> What do you guys think of introducing in the manual
> a css such as:
>
> .warning:before {
> content: "WARNING: ";
> font-weight:bold;
> }
> .warning {
> font-family: Verdana, arial, sans-serif;
> font-size: 80%;
> border-style: solid;
> border-width: 1px;
> border-color: #c00;
> background-color: #fcc;
> text-align:left;
> margin-top: 5px;
> margin-bottom: 5px;
> margin-left: 2em;
> padding: 8px;
> text-align:justify;
> width:85%;
> }
>
>
> To use with: <p class="warning"> BLAH ! </p>
>
> That's basically a Confluence-like style.
>
> We can define other css such as note, info, tip to
> start to introduce
> some semantics and relatively eye-catching notes at
> the same time.
> ..
>
I can't imagine it would be a bad idea, though it
might take a while for it to pervade the existing man
pages; certainly it would be useful if any of us ever
take DD's doco proposal further. ;)
-Matt
> Stephane
>
>
---------------------------------------------------------------------
> To unsubscribe, e-mail:
> dev-unsubscribe@ant.apache.org
> For additional commands, e-mail:
> dev-help@ant.apache.org
>
>
__________________________________________________
Do You Yahoo!?
Tired of spam? Yahoo! Mail has the best spam protection around
http://mail.yahoo.com
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org
Re: svn commit: r397909 - in /ant/core/trunk/docs/manual: CoreTasks/filter.html
CoreTypes/filterchain.html
Posted by Stephane Bailliez <sb...@gmail.com>.
mbenson@apache.org wrote:
> Author: mbenson
> Date: Fri Apr 28 07:13:57 2006
> New Revision: 397909
>
> URL: http://svn.apache.org/viewcvs?rev=397909&view=rev
> Log:
> More warnings about filtering binary files. Bugzilla #39445.
>
> Modified:
> ant/core/trunk/docs/manual/CoreTasks/filter.html
> ant/core/trunk/docs/manual/CoreTypes/filterchain.html
>
> Modified: ant/core/trunk/docs/manual/CoreTasks/filter.html
> URL: http://svn.apache.org/viewcvs/ant/core/trunk/docs/manual/CoreTasks/filter.html?rev=397909&r1=397908&r2=397909&view=diff
> ==============================================================================
> --- ant/core/trunk/docs/manual/CoreTasks/filter.html (original)
> +++ ant/core/trunk/docs/manual/CoreTasks/filter.html Fri Apr 28 07:13:57 2006
> @@ -13,7 +13,8 @@
> <p>Sets a token filter for this project or read multiple token filter from
> an input file and sets these as filters.
> Token filters are used by all tasks that perform file copying operations
> -through the Project commodity methods.</p>
> +through the Project commodity methods. See the warning
> +<a href="../using.html#filters"><em>here</em></a> before using.</p>
> <p>Note 1: the token string must not contain the separators chars (@).<br>
> Note 2: Either token and value attributes must be provided, or only the
> filtersfile attribute.</p>
> @@ -56,7 +57,7 @@
> and set these as filters.
>
What do you guys think of introducing in the manual a css such as:
.warning:before {
content: "WARNING: ";
font-weight:bold;
}
.warning {
font-family: Verdana, arial, sans-serif;
font-size: 80%;
border-style: solid;
border-width: 1px;
border-color: #c00;
background-color: #fcc;
text-align:left;
margin-top: 5px;
margin-bottom: 5px;
margin-left: 2em;
padding: 8px;
text-align:justify;
width:85%;
}
To use with: <p class="warning"> BLAH ! </p>
That's basically a Confluence-like style.
We can define other css such as note, info, tip to start to introduce
some semantics and relatively eye-catching notes at the same time.
..
Stephane
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org