Diff screenshot.

Defining \tcode using \lstinline would be far better. Benefits of \lstinline include

• Single quotes are rendered as straight quotes (using upquote option).
• No escape is needed; we can just write %, \, etc.
• No double spacings.

\lstinline can be used with mathescape option. So we can use macros in $...$ e.g. using $\exposidnc{indirect-value-t}$ = $\seebelow$.

However, \lstinline behaves badly when used in macro arguments. For example, backslashes are used as escape characters in the TeX world and spaces before $ are not rendered. Thus, we cannot use \lstinline (unless this problem is resolved).

This now has overfull \hbox issues that need to be addressed.

Thanks for the guidance. There are three overfull boxes.

• ranges.tex (L10873–10878, std.pdf: p. 1225+10): 0.32013pt too wide

  • The offending word: \tcode{iterator_category}.
  • The overfullness is so small. This “overfull hbox” warning is suppressed by locally increasing \hfuzz from 0.1pt (the default value) to 0.5pt (this value is also used in \sloppy). Note that “overfull hbox” warnings are emitted only when the width is more than \hfuzz's value.

• ranges.tex (L15112–15116, std.pdf: p. 1262+10): 141.33292pt too wide

  • The offending “word”: \tcode{… ? … : …}
  • Easily fixable. It is fixed by adding \brk after : .

• iostreams.tex (L2279–2287 std.pdf: p. 1628+10): 21.81808pt too wide

  • The offending word: "implementation-defined" emitted from \impldef.
  • TeX does not hyphenate words that already contain hyphens (compound words). Adding \- changes this behavior. Compound words might be better not to be hyphenated, so I add \- conservatively (i.e. imple\-men\-ta\-tion-defined rather than im\-ple\-men\-ta\-tion-de\-fined).

The global macro \impldef is changed in the fix for the third case. This introduces changes like "implementation-\ndefined" -> "implementa-\ntion-defined" in other places.

A screenshot for the first case (iterator_-). The overfullness is very small (0.32013pt too wide).

For the first transgression, can you add a hyphenation hint iterator_catego-ry instead? Usually, the spaces are already very compressed when you get an overfull \hbox warning, and we regularly hyphenate this \tcode words if necessary.

For the first transgression, the offending part is the - just after the highlighted "tor_" in the screenshot. \tcode{it\-er\-a\-tor_cat\-e\-go\-ry} doesn't make any change in the output.

The only viable hyphen-hint is \tcode{iterator\-_category}, which outputs "iterator-\n_category". Is this our preferred option?

I took this route:

\tcode{iterator\-_category}

The issue is resolved now, I think.

@tkoeppe, this looks like an editorial improvement.

@jensmaurer Yes, I agree. Any final thoughts?