Skip to content

Table names should be present as stable names #2674

Closed

Description

@PeterSommerlad

The latex sources of the standard have "stable" table identifications as their \label{tablename}. However, in contrast to regular sections, these names are never rendered in the text. This leads to tedious updates of table numbers in any paper referring to any of the tables. It would be great if the table labels would be printed with the standard like the stable names are printed in the header sections.

This would ease the work of the paper authors as well as the editors (i guess).

Activity

  1. tkoeppe commented on Feb 20, 2019

    @tkoeppe
    Contributor

    (I feel like this issue has been raised before.)

  2. cpplearner commented on Feb 20, 2019

    @cpplearner
    Contributor
  3. added
    decision-requiredA decision of the editorial group (or the Project Editor) is required.
    on Feb 22, 2019
  4. jensmaurer commented on Feb 22, 2019

    @jensmaurer
    Member

    Editorial meeting:

    • Review all table labels.
    • Expose label as "tab:blah".
  5. removed
    decision-requiredA decision of the editorial group (or the Project Editor) is required.
    on Feb 22, 2019
  6. jensmaurer commented on May 10, 2019

    @jensmaurer
    Member

    This needs substantial work. Almost all labels seem to be overly long or nondescript. Suggested rules:

    • If a subclause consists predominantly of a table, use the same label as the subclause label (plus tab: prefix). Example: tab:lex.key, tab:lex.digraph.
    • For concepts tables, just use the flat name as-is. Example: tab:copyconstructible.
    • Otherwise, use at least some parts in common with the subclause label. Example: tab:temp.fold.empty.

    What's the desired formatting of the table label? I currently have "bold", but I feel I need a bit more space separating it from the prose caption text:

    tablelabel

    Should the label be repeated for continued captions of longtables?

  7. added
    decision-requiredA decision of the editorial group (or the Project Editor) is required.
    on May 10, 2019
  8. removed
    decision-requiredA decision of the editorial group (or the Project Editor) is required.
    on Jun 5, 2019
  9. jensmaurer commented on Jun 5, 2019

    @jensmaurer
    Member

    Editorial meeting:

    • Second rule: Use cpp17.conceptname. DONE
    • Do not make the label bold. DONE
    • Separate label from caption text by \quad. DONE
    • Separate table number from caption text by \quad or colon (show screenshots of both options). Remove mdash. Try to be consistent with subclause titles. SEE BELOW
    • Make figure captions the same as table captions, except for before/after placement. DONE
    • Check linebreaks in captions. SEE BELOW
    • Do not repeat the label in continued captions of longtables. DONE
  10. jensmaurer commented on Jun 7, 2019

    @jensmaurer
    Member

    Sample 1: separate table number from caption text by colon
    caption-colon

    Sample 2: separate table number from caption text by \quad
    caption-quad

  11. self-assigned this
    on Jun 8, 2019
  12. jensmaurer commented on Jun 8, 2019

    @jensmaurer
    Member

    Sample figure:

    caption-figure

    Sample linebreak:

    caption-linebreak

  13. hubert-reinterpretcast commented on Jun 8, 2019

    @hubert-reinterpretcast
    Member

    My preference is for the colon between the number and the caption.

  14. W-E-Brown commented on Jun 8, 2019

    @W-E-Brown
    Contributor
  15. zygoloid commented on Jun 13, 2019

    @zygoloid
    Member

    (I also prefer the colon.) Thanks Jens!

  16. jensmaurer commented on Jun 13, 2019

    @jensmaurer
    Member

    Added a "labels" section to the wiki style guidelines.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions