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

Brian E Carpenter brian.e.carpenter at gmail.com
Sun Dec 9 00:30:11 PST 2012


On 08/12/2012 20:25, Nico Williams wrote:
> 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.

Hmm. I definitely remember being zapped for including text
*before* the first subsection. Maybe that was an early version.

Yes, it's true that we don't indent (today).

    Brian


More information about the rfc-interest mailing list