ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Stefan Bodewig <>
Subject Re: Ant documentation
Date Fri, 02 Mar 2018 12:13:40 GMT
On 2018-03-02, Gintautas Grigelionis wrote:

> 2018-03-02 9:54 GMT+01:00 Stefan Bodewig <>:

>> On 2018-03-01, Stefan Bodewig wrote:

>>>> On Thu, Mar 1, 2018 at 7:28 AM, Gintautas Grigelionis <
>>>>> wrote:

>>>>> I tried then to use the replacement tags as consistently as
>>>>> possible in such a large body of text, but I realised that we
>>>>> perhaps need a kind of a style guide. Would you like to discuss
>>>>> it? Where would it best fit in the source code tree?

>>> I'm not convinced I want to have any kind of rules keep people from
>>> writing docs :-)

>> This comment isn't fair and I should have known better, sorry.

> I didn't even notice your remark, really :-)

That's good. Sometimes I realize when I'm being a jerk as in this case,
often I don't (and I appreciate people telling me when that happens).

> All I wanted to say, keeping things visually consistent helps
> understanding.  So, my simple set of rules is:

>    - <var> is for attributes
>    - <q> is for values
>    - <code> is for shell variable names/property name/CLI options and input
>    (should change that to <kbd>, really)
>    - <samp> is for everything else, like filenames etc

Looks reasonable.


To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message