Clarifying book-app-group

[pkra]

This follows up on a recent F2F discussion.

From that discussion, texml is supposed to generate book-app-group even if there's only one appendix seems desirable.

Trying to adjust downstream, I looked at examples across books with appendices we have so far:

• gsm228 [the recent starting point]
  • 1x book-app inside a book-app-group
• gsm203 [oldest with appendix]
  • has parts
  • has 1 book-app-group
  • but lacking specific-use="part" with a "hand-coded" title (expanding BITS)
  • app-group has several book-app elements with specific-use="chapter" and labels like "Appendix A" (good)
  • no lower sectioning
• gsm019
  • has parts
  • 1 book-app-group
  • containing a single book-app with specific-use="chapter" and title Appendices
  • 52 book-app's with "lower" specific-use, i.e., =section for "Appendix A", =subsection for "A.1" etc
• gsm217
  • has parts
  • a single book-app with specific-use="part", label "Part 5", title "Appendices"
  • nested book-apps (with specific-use="chapter" for appendices and specific-use="section" etc for lower sectioning)
  • (had another funky issue early on in prod)
• gsm199
  • has parts
  • has appendix but it's a regular sec specific-use="chapter" in the last part
• gsm205
  • has 4 chapter-level appendices
  • but is using sec instead of app
• gsm210
  • 1 book-app-group, not title or label
  • with nested book-app elements - specific-use="chapter" for Appendix, etc for lower sectioning
• gsm 212 - same as gsm210
• gsm213 - same as gsm210
• gsm214 - same as gsm210 (with just 1 actual appendix)
• gsm215 - same as gms210
• gsm218
  • no book-app-group
  • 1 book-app element, no lower sectioning
• gsm219 - same as gsm210
• gsm220
  • has parts
  • 1 empty book-app-group (in particular no title/label)
  • 1 book-app with specific-use="part", label "Part 5", title "Appendices"
  • in that: nested book-app elements (chapter for Appendix etc)
  • gsm221
  • has parts
  • 1 book-app group without title/label or specific-use=part
  • in it 1 app-group for the Appendix
  • with nested app-group for sectioning
  • gsm224
  • has parts
  • "Part Six: Conclusion and Appendices" - contains 1 chapter and 2 appendices
  • the chapter ends up in a part but the rest is pushed into book-back
  • book-back has 1 book-app-group without title or label
  • book-app group has nested book-back with expected specific-use for sectioning
  • gsm225 - same as gsm210 (1 actual appendix)
  • gsm227 - same as gsm220
  • gsm228
  • 1 book-app with specific-use=chapter (no lower sectioning)
  • gsm230
  • 1 book-app with specific-use=chapter
  • with book-app elements for sectioning
  • gsm233 - same as gsm230
  • gsm234
  • same as gsm230
  • but after bibiliography another book-app (Index of notation)
  • gsm235 - same as gsm210

[pkra]

I hope this explains why downstream is a bit unclear about appendix markup.

[pkra]

As per a recent F2F, we will undo a2ca3381ba85dbec9703837b6819f47fa4ac1e0b

The large variety of app output should no longer occur. We will always have book-app-group if there's a single appendix.

[pkra]

@davidmjones could you double check that book-app-group will get a part indicator when appropriate?

[pkra]

@davidmjones I've seen this change in production but I can't find it here. Could you please check that the repository is up to date?

[pkra]

I believe this has rolled out.