[m-rev.] for review: Overhaul of the Syntax chapter of the reference manual

[Julien Fischer]

Hi Mark,

On Mon, 12 Sep 2022, Mark Brown wrote:

> On Sun, Sep 11, 2022 at 11:37 PM Julien Fischer <jfischer at opturion.com> wrote:
>>
>> On Wed, 7 Sep 2022, Mark Brown wrote:
>>
>>> Attached is another diff - it's the full diff as the relative diff is
>>> no shorter. Also attached is the html that results from
>>> --split=chapter.
>>
>> I think that mostly achieves what you wanted.  (The Next and Previous
>> links look a little weird -- I couldn't find a way to omit them.)
>
> There's a --no-headers option that seems to do the trick.

That looks alright.

...

>> Make that into two sentences.
>
> I've added the second line to the first sentence, which seems to read nicely.
>
>> Parenthetical Prology things can go in the transition guide.
>
> Most of them were actually already there :-)
>
> I've deleted/moved them as appropriate.
>
> The remaining points are fixed as suggested. Thanks for the review!

Unless Peter or Zoltan has any objections, I am happy for this to be
committed in its current state, since doing so will simplify working
on it (and also the diffs involved will be less gigantic).

Julien.