Skip to content

Inconsistent use of \colcol vs. ::\brk{} #1359

Closed
@jensmaurer

Description

@jensmaurer

\colcol is defined to allow line breaks before and after the colon. Yet, we also use ::\brk{} fairly often.

\colcol 48
::\brk{} 31

For comparison, total lines with :: 4086.

We should harmonize this somehow. Suggestions:

  • (1) Replace ::\brk{} with \colcol
  • (2) Replace \colcol with ::\brk{} where still necessary (otherwise plain ::) and remove the macro.
  • (3) Replace all :: in running text with \colcol to give LaTeX more line break opportunities, possibly improving layout in a few cases.

My recommendation is (1) or (2). Opinions?

Activity

added
decision-requiredA decision of the editorial group (or the Project Editor) is required.
on Jan 13, 2017
tkoeppe

tkoeppe commented on Jan 13, 2017

@tkoeppe
Contributor

Partial idea: whenever \colcol can be replaced by just :: with no visual change, we should do that.

tkoeppe

tkoeppe commented on Feb 5, 2017

@tkoeppe
Contributor

Option 2 seems best to me. It's consistent with our use of non-breaking spaces before references (foo~(\ref{bar})): We know that we could break there in a crunch, but we don't want to by default, and breaks should be applied manually. By the same token, we should have :: as the default, and we should insert \brk{} as a manual override if needed.

I am also loosely considering the idea of deleting all \brk{}s after publication and only reinserting them before the next publication. This isn't a serious suggestion, but I'd like to think of this as the mental process. We should probably try and tidy up hyphenation hints regularly, since they're the very model of brittle things that rot almost immediately.

self-assigned this
on Feb 8, 2017
jensmaurer

jensmaurer commented on Feb 8, 2017

@jensmaurer
MemberAuthor

@tkoeppe: I'm not sure about hyphenation and line-break hints rotting instantly; most of the text in the standard seems to be quite stable.

added a commit that references this issue on Feb 8, 2017
734ae4b
added a commit that references this issue on Feb 15, 2017
bcb5630
removed
decision-requiredA decision of the editorial group (or the Project Editor) is required.
on Sep 10, 2019
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

      Participants

      @tkoeppe@jensmaurer

      Issue actions

        Inconsistent use of \colcol vs. ::\brk{} · Issue #1359 · cplusplus/draft