[rfc-i] Section structure, was: RFC editing tools

Nico Williams nico at cryptonector.com
Sat Dec 8 12:25:33 PST 2012


On Sat, Dec 8, 2012 at 1:49 AM, Brian E Carpenter
<brian.e.carpenter at gmail.com> wrote:
> On 07/12/2012 22:09, Julian Reschke wrote:
> ...
>>>>> Well, actually I lie, you lose one pathological thing: section
>>>>> contents following sub-sections!  (This pathological case is
>>>>> impossible in <hN> style, and we cannot represent it in any output
>>>>> formats we've had to date because we don't indent section content.
>>>>> It's come up before for xml2rfc.  Isn't it nice that this error is not
>>>>> possible in <hN> style?  Should we infer from this that nested
>>>>> <section> style is flawed?)
>>>>
>>>> It's invalid in xml2rfc.
>>>
>>> Yes, but xml2rfc didn't use to error out on this.
>>
>> It has been doing that for years now.
>
> Which is intensely annoying. Stylistically (excuse shouting but...)
> THERE IS NOTHING WRONG with having introductory content prior to the
> first subsection. The tools have no business telling me I can't
> do that. At the moment, one has to insert a completely pointless
> subsection header.

Section contents that follows a sub-section is indistinguishable
(visually) from equal content in the sub-section instead.  The reason
is that we don't indent section content in presentation formats.

Nico
--


More information about the rfc-interest mailing list