Re: [xml2rfc] Imaginary vspace?

[Carsten Bormann <[e-mail]>]

On 21. Jun 2023, at 22:50, Brian E Carpenter <[e-mail]> wrote:
> 
>>> It's kramdown-rfc that adds the vspace.
>>> Use of `-----------` in line 74 is the line that adds the space.
>>> I couldn't find any documentation on kramdown-rfc about adding vspace this way.

In markdown, `———` on a line of its own, surrounded by vertical blank space, is a horizontal rule (<hr in HTML).
(There are a few similar syntaxes to do the same [1].)

There are no horizontal rules in RFCXML, so I used this syntactic element to indicate a page break, which has a similar separating function in paginated documents to what you would be trying to achieve with a horizontal rule in HTML.

The way to effect a page break in RFCXMLv2 was to do a large vspace (e.g., with 999 lines).
This is what you see here.

RFCXMLv3 does not provide the author with functionality to influence page breaks (*), so the v2v3 converter we employ to generate RFCXMLv3 throws out the page break (and correctly indicates in a warning that it is simply not doing as told).

What did you want to express with the horizontal rule?

Grüße, Carsten

[1]: https://kramdown.gettalong.org/quickref.html#horizontal-rules

(*) at least not directly for creating page breaks; there is a keepWithNext and a keepWithPrevious attribute, weirdly only on <t, which can be used to avoid a page break in specific places.
I have not spent time to check whether there is another trick in xml2rfcv3 that could be employed to create a page break.