List Info

Thread: svn commit: r397909 - in /ant/core/trunk/docs/manual: CoreTasks/filter.html CoreTypes/filterchain.ht
svn commit: r397909 - in /ant/core/trunk/docs/manual: CoreTasks/filter.html CoreTypes/filterchain.ht
user name
 2006-04-28 14:14:00 
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/tr
unk/docs/manual/CoreTasks/filter.html?rev=397909&r1=3979
08&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&l
t;/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 &copy;
2000-2002,2004-2005 The Apache Software Foundation. All
rights
+<p align="center">Copyright &copy;
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/co
re/trunk/docs/manual/CoreTypes/filterchain.html?rev=397909&a
mp;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 &gt; bar
 </code><p>
 -1402,4
+1403,4 
 <hr>
 
 <p align=center>Copyright &copy; 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-unsubscribeant.apache.org
For additional commands, e-mail: dev-helpant.apache.org
svn commit: r397909 - in /ant/core/trunk/docs/manual: CoreTasks/filter.html CoreTypes/filterchain.ht
user name
 2006-04-28 14:23:26 
mbensonapache.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/tr
unk/docs/manual/CoreTasks/filter.html?rev=397909&r1=3979
08&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&l
t;/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-unsubscribeant.apache.org
For additional commands, e-mail: dev-helpant.apache.org
svn commit: r397909 - in /ant/core/trunk/docs/manual: CoreTasks/filter.html CoreTypes/filterchain.ht
user name
 2006-04-28 14:55:35 
--- Stephane Bailliez <sbailliezgmail.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-unsubscribeant.apache.org
> For additional commands, e-mail:
> dev-helpant.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-unsubscribeant.apache.org
For additional commands, e-mail: dev-helpant.apache.org
[1-3]

about | contact  Other archives ( Real Estate discussion Medical topics )