[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v3] docs/match: pattern matcher example makeover
From: |
David Pirotte |
Subject: |
Re: [PATCH v3] docs/match: pattern matcher example makeover |
Date: |
Thu, 2 Feb 2023 14:47:20 -0300 |
> > -
> > style: switch to "Indiana style", bracketing lets and clauses
> > --
> > After spending much time looking at the examples in black & white
> > to edit the texinfo document, it occurred to me just how much the
> > brackets improve legibility.
Not at all - and quite annoying. imo.
So i'd 'vote' not to use them anywhere in the guile reference manual
David.
It makes the code appear as if it was another language, and requires
you train yourself to ignore them - as they actually do _not_ have any
specific meaning, but nonetheless 'pretend they do', by their mere
presence, and this causes a reading nuisance.
They are also often used inconsistently by those who use them, as
where/how you'd use them is a matter of taste, which further adds to
the reading nuisance, imo.
pgpiDlt1YVSr_.pgp
Description: OpenPGP digital signature