On 2018-03-02, Gintautas Grigelionis wrote: > 2018-03-02 9:54 GMT+01:00 Stefan Bodewig <bode...@apache.org>:
>> On 2018-03-01, Stefan Bodewig wrote: >>>> On Thu, Mar 1, 2018 at 7:28 AM, Gintautas Grigelionis < >>>> g.grigelio...@gmail.com> 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. Stefan --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@ant.apache.org For additional commands, e-mail: dev-h...@ant.apache.org