Escape sequence in GenericCode

[MikeEdu]

Is there any reason, why the GenericCode environment has no escape sequence like /+ ... +/?

It would be nice, if this feature is also available in the GenericCode environment. Espacially because the escape sequence is mentioned in the tutorial, but it is not mentioned that there is an exception for any code environment.

[hochleitner]

Just had a look into it. I don't see any reason why there shouldn't be an escape sequence for the GenericCode environment enabled as well. I'll include that for the next iteration after testing it.

For now you can just add it yourself in hgblistings.sty:

HagenbergThesis/dev/latex/hgblistings.sty

Lines 101 to 111 in 9f9b9c3

	% Code Enivornmente for Generic Code
	\lstnewenvironment{GenericCode}[1][]
	{\lstset{%
	language={},
	keepspaces=true,
	commentstyle={},
	texcl=false,
	escapechar={},
	escapeinside={},
	#1}}
	{}

Line 109 needs to be replaced with

escapeinside={/+}{+/},

[MikeEdu]

Thank you!

[imagingbook]

The reason for not allowing this escape sequence in the GenericCode environment is that it makes the encapsulated code "non-generic" in the sense that such code may not contain the escape literals themselves ...

[hochleitner]

Okay, that does make sense, although it's probably a rare case. Let's keep it that way then and I'll adapt this line here

HagenbergThesis/documents/HgbThesisTutorial/chapters/abbildungen.tex

Lines 684 to 688 in 9f9b9c3

	Der Quellcode innerhalb dieser Umgebungen wird in der jeweiligen Programmiersprache interpretiert, wobei Kommentare erhalten bleiben. Diese Umgebungen können sowohl alleinstehend (im Fließtext) oder innerhalb von Float-Umgebungen (insbes.\ \texttt{program}) verwendet werden. Im ersten Fall wird der Quelltext auch über Seitengrenzen umgebrochen. Mit \verb!/+! ... \verb!+/! ist eine Escape-Möglichkeit nach \latex\ vorgesehen, die \va\ zum Setzen von Labels für Verweise auf einzelne Programmzeilen nützlich ist, \zB\ mit
	%
	\begin{quote}
	\verb!/+\label{ExampleCodeLabel}+/!
	\end{quote}

to state that GenericCode is an exception to this. I will also add a wiki page on how to add this in case this comes up again.

[imagingbook]

Rare indeed, but needed e.g. to show the sample code for how to use that escape sequence :,-)

[imagingbook]

As mentioned yesterday, all code environments in hgblistings.sty accept optional arguments that are forwarded to the underlying \lstset command. Thus, to use GenericCode with the usual (or some other) LaTeX escape sequence you can just write, e.g.,

\begin{GenericCode}[escapeinside={/+}{+/}]
double alpha = 1.0;			/+($\alpha$)+/
double beta = 3.14;			/+($\beta$)+/
\end{GenericCode}