On Fri, Aug 28, 2020 at 8:52 AM Werner LEMBERG <
wl@gnu.org> wrote:
>> However, saying
>>
>> \oo VeryLong.Grob.PropertyToBeChanged = foo
>>
>> for this (and only this) snippet is just fine.
>
> I don't think that it makes sense for snippets to introduce
> convenience shorthands unless the snippet in itself tries is about
> showcasing the shorthand. It detracts from the content.
Well, we have to make a compromise. The PDF document has a small line
width, and you can't scroll horizontally...
Theoretically, the snippet could be printed with a smaller font size,
but this doesn't look very pretty IMHO. I consider the `\oo`
shorthand both innocuous and simple enough for a snippet.
My preference is the one that you said is inappropriate:
\once \override
Very.Long.Grob.PropertyToBeChanged = foo
If we introduce oo, then that adds extra lines to the snippet, and it confuses the override (which is the purpose of the snippet) with the convenience function (which is not necessary for the operation of the snippet).
I think that the benefit of the improvement in the typography is outweighed by the increased difficulty of understanding the snippet.
Thanks,
Carl