`\verb` is omitted from `anchor` example code?

[hbghlyj]

Version

3.1.10

Details

In manual §13.2.3 anchor example code:

\usetikzlibrary {arrows.meta}
\begin{tikzpicture}
\node (shape) at (0,2) [draw] {|class Shape|};
\node (rect) at (-2,0) [draw] {|class Rectangle|};
\node (circle) at (2,0) [draw] {|class Circle|};
\node (ellipse) at (6,0) [draw] {|class Ellipse|};
\draw (node cs:name=circle,anchor=north) |- (0,1);
\draw (node cs:name=ellipse,anchor=north) |- (0,1);
\draw [arrows = -{Triangle[open, angle=60:3mm]}]
(node cs:name=rect,anchor=north)
|- (0,1) -| (node cs:name=shape,anchor=south);
\end{tikzpicture}

I compile this code with PDFLaTeX, the output is different from the manual:

After replacing | with \verb| the output is same as the manual:

[muzimuzhi]

I compile this code with PDFLaTeX, the output is different from the manual:

Which document class did you use?

pgfmanual.tex loads ltxdoc.cls which sets

\AtBeginDocument{\MakeShortVerb{\|}}

An ltxdoc example

\documentclass{ltxdoc}

\begin{document}
normal text
|verb text|
\end{document}

PS: The command \MakeShortVerb is provided by doc.sty. It's also available from a sole package shortvrb (see texdoc doc (v3.0m, 2022/11/13), sec. 2.14 "Short input of verbatim text pieces".

\documentclass{article}
\usepackage{shortvrb}
\MakeShortVerb{\|}

\begin{document}
normal text
|verb text|
\end{document}

[muzimuzhi]

When used as part of a node text, both the short verb |...| and (long) verb \verb|...| forms can't really typeset the content in verbatim (the content is already tokenized), but only in (the current) typewriter font family.

For the sake of

• Examples in the manual as MWE #640 and
• Generate testsuite from pgfmanual #1116

using node font=\ttfamily here (and for all similar codeexamples) seems better. @hmenke opinions?

\documentclass{article}
\usepackage{tikz}
\usetikzlibrary{arrows.meta}

\begin{document}
\begin{tikzpicture}[node font=\ttfamily]
  \node (shape)   at (0,2)  [draw] {class Shape};
  \node (rect)    at (-2,0) [draw] {class Rectangle};
  \node (circle)  at (2,0)  [draw] {class Circle};
  \node (ellipse) at (6,0)  [draw] {class Ellipse};

  \draw (node cs:name=circle,anchor=north) |- (0,1);
  \draw (node cs:name=ellipse,anchor=north) |- (0,1);
  \draw [arrows = -{Triangle[open, angle=60:3mm]}]
           (node cs:name=rect,anchor=north)
        |- (0,1) -| (node cs:name=shape,anchor=south);
\end{tikzpicture}
\end{document}

[hmenke]

Verbatim material inside node text does work. The parser uses \setbox specifically to work around the tokenization problem.

pgf/tex/generic/pgf/frontendlayer/tikz/tikz.code.tex

Lines 3865 to 3916 in 425b03d

	\def\tikz@do@fig{%
	% Ok, reset all node part boxes
	\pgfutil@for\tikz@temp:=\tikz@nodepart@list\do{%
	\expandafter\setbox\csname pgfnodepart\tikz@temp box\endcsname=\box\pgfutil@voidb@x%
	}%
	\setbox\pgfnodeparttextbox=\hbox%
	\bgroup%
	\pgfinterruptpicture%
	\pgfsys@begin@text%
	\pgfsys@text@to@black@hook%
	\tikzset{every text node part/.try}%
	\ifx\tikz@textopacity\pgfutil@empty%
	\else%
	\pgfsetfillopacity{\tikz@textopacity}%
	\pgfsetstrokeopacity{\tikz@textopacity}%
	\fi%
	\ifx\tikz@text@width\pgfutil@empty%
	\tikz@textfont%
	\else%
	\begingroup%
	\pgfmathsetlength{\pgf@x}{\tikz@text@width}%
	\pgfutil@minipage[t]{\pgf@x}\leavevmode\hbox{}%
	\tikz@textfont%
	\tikz@text@action%
	\fi%
	\tikz@atbegin@node%
	\bgroup%
	\aftergroup\unskip%
	% Some color stuff has been moved from here to outside; this is
	% necessary for support of dvisvgm and of animation
	% snapshots.
	\ifx\tikz@textcolor\pgfutil@empty%
	\else%
	\pgfutil@colorlet{.}{\tikz@textcolor}%
	\pgfutil@color{\tikz@textcolor}%
	\fi%
	\setbox\tikz@figbox=\box\pgfutil@voidb@x%
	\setbox\tikz@figbox@bg=\box\pgfutil@voidb@x%
	\tikz@uninstallcommands%
	\iftikz@handle@active@code%
	\tikz@orig@shorthands%
	\let\tikz@orig@shorthands\pgfutil@empty%
	\fi%
	\ifnum\the\catcode`\;=\active\relax\expandafter\let\tikz@activesemicolon=\tikz@origsemi\fi%
	\ifnum\the\catcode`\:=\active\relax\expandafter\let\tikz@activecolon=\tikz@origcolon\fi%
	\ifnum\the\catcode`\|=\active\relax\expandafter\let\tikz@activebar=\tikz@origbar\fi%
	\aftergroup\tikz@fig@collectresetcolor%
	\tikz@signal@halign@check%
	\tikz@text@reset%
	\tikz@halign@check%
	\ignorespaces%
	}%

[muzimuzhi]

Ah you're right! Then the codeexample(s) using |...| as short verb may need sth like

\begin{codeexample}[preamble={\usepackage{shortvrb} \MakeShortVerb{\|}}]

Or, as originally suggested, use \verb|...| instead.

[hmenke]

Since no actual verbatim is required for the example, I prefer your proposal of simply changing the node font to \ttfamily.