Invisible listing captions

Question

Short version: how can I make a listing's caption show up in the List of Listings but not in the body of the document where the listing is?

I'm writing a university report, and many of my subsections contain only a single listing. Because of this the logical names of the subsection and the listing are the same. I'm currently using the listings package.

I would like there to be sensible descriptive names in both the Tables of Contents (for the subsection) and the List of Listings (for the listing), but I don't want both names in the body of the document, as the duplication looks silly. Preferably in the main document the subsection would be titled but not the listing, although vice versa is still helpful.

Answer 1

The package listings also provide an optional argument of caption. So simple use:

\begin{lstlisting}[caption={[entry]}]

This way is also described in the documentation at page 32.

The complete example.

\documentclass{article}
\usepackage{listings}

\begin{document}
\lstlistoflistings

\section{This is my section}
\begin{lstlisting}[caption={[foo]}]
 for i:=maxint to 0 do
 begin
 { do nothing }
 end;
\end{lstlisting}


\end{document}

Answer 2

It sounds like you need the command

\addcontentsline{lol}{lstlisting}{<enter description here>}

where lol stands for the extension for the ListOfListings file. Perhaps to be used in something like the following.

\documentclass{article}
\usepackage{listings}

\begin{document}
\lstlistoflistings

\addcontentsline{lol}{lstlisting}{I entered this myself!}
\addcontentsline{lol}{lstlisting}{and this too!}

\section{This is my section}
\begin{lstlisting}
 for i:=maxint to 0 do
 begin
 { do nothing }
 end;
\end{lstlisting}


\end{document}

Answer 3

You can patch listings's caption macro \lst@MakeCaption to never print the caption using etoolbox:

\documentclass{article}
\usepackage{listings}% http://ctan.org/pkg/listings
\usepackage{hyperref}% http://ctan.org/pkg/hyperref
\usepackage{etoolbox}% http://ctan.org/pkg/etoolbox
\makeatletter
\pretocmd{\lst@MakeCaption}{\let\lst@caption\@empty}{}{}
\makeatother
\begin{document}
\tableofcontents
\lstlistoflistings

\section{My first listing}
\begin{lstlisting}[caption={My first listing}]
\typeout{Hello world!}
\end{lstlisting}

\end{document}

As is shown, the above patch works well with hyperref.