[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