Re: [docbook-tc] legalsection versus section in legalnotice

[Bob Stayton <bobs@sagehill.net>]

Hi Norm,

Yes, by default the formatting of legalsection is indistinguishable from section. It is up the implementor to customize it if they want to. Making it an element makes it easier to customize formats, easier to find and maintain, and easier to extract for review by a legal department.

Regarding numbering, the stylesheets currently number section, sect1 through sect5, and simplesect as the same numbering set. We would add legalsection to that set. I'm not clear where the complexity you are referring to comes in?

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

On 2/4/2019 6:03 AM, Norman Walsh wrote:

Bob Stayton <bobs@sagehill.net> writes:

Norm asked about formatting issues like enumeration, and I think
legalsection should be treated as all other members of the section
class by default. Someone could always customize that if they want
something different.

So is this legal?

  <section>
    <section>â</section>
    <legalsection>â</legalsection>
    <section>â</section>
  </section>

And does it format as this?

  1. â
  1.1 â
  1.2 â
  1.3 â

I donât really understand the purpose of legalsection if itâs
indistinguishable from an ordinary one. And I think numbering that
way is potentially making the procssing expectations quite complex.

And also, how does it fit into the numbered section hierarchy and
simplesect?

                                        Be seeing you,
                                          norm