[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: organization of the documentation of customization variables
From: |
Patrice Dumas |
Subject: |
Re: organization of the documentation of customization variables |
Date: |
Wed, 27 Mar 2024 00:06:20 +0100 |
On Sun, Mar 17, 2024 at 04:23:06PM +0000, Gavin Smith wrote:
> Even the second variable in the list is obscure:
>
> ‘AFTER_BODY_OPEN’
> If set, the corresponding text will appear at the beginning of each
> HTML file; default unset.
>
> It is not clear what "corresponding text" means - corresponding to what?
> I think it means the value of the variable but this is not clear.
>
> ‘BODYTEXT’
> The text appearing in ‘<body>’. By default, sets the HTML ‘lang’
> attribute to the document language (*note @documentlanguage::).
>
> I first thought this meant the text occuring between <body> and
> </body>, which would be most of the file, rather than text for the
> attributes.
I tried to fix those two and other similar enrties. But I am not a
native english speaker, so feel free to review all the variables in the
list and correct the grammar and style, it is possible that some
variables were never proofread.
--
Pat