1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
\documentclass[DIV=9, parskip=half, pagesize=auto]{scrartcl}
\usepackage{fixltx2e}
\usepackage{etex}
\usepackage{xspace}
\usepackage{lmodern}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{array}
\usepackage{microtype}
\usepackage{hyperref}
\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{#1}}}
\newcommand*{\pkg}[1]{\textsf{#1}}
\newcommand*{\cls}[1]{\textsf{#1}}
\newcommand*{\cs}[1]{\texttt{\textbackslash#1}}
\makeatletter
\newcommand*{\cmd}[1]{\cs{\expandafter\@gobble\string#1}}
\makeatother
\newcommand*{\env}[1]{\texttt{#1}}
\newcommand*{\opt}[1]{\texttt{#1}}
\newcommand*{\myllap}[1]{%
\quitvmode
\setbox0=\hbox{#1}%
\kern-\wd0
#1%
}
\deffootnote{1em}{0em}{\textsuperscript{\thefootnotemark}\,}
\addtokomafont{title}{\rmfamily}
\title{The \pkg{listing} package\thanks{This manual corresponds to \pkg{listing}~V1.2, dated~1999/05/25.}}
\subtitle{\LaTeX\ package for typesetting listings.}
\author{%
Matthew Hebley\thanks{Matthew is no longer available for contact, email or otherwise}%
\and Volker Kuhlmann\thanks{University of Canterbury\newline EEE Dept\newline Christchurch, New Zealand\newline E-Mail: \mail{v.kuhlmann@elec.canterbury.ac.nz}}%
}
\date{1999/05/25}
\begin{document}
\maketitle
\begin{quote}
\footnotesize
This program can be redistributed and/or modified under the terms
of the \LaTeX\ Project Public License, distributed from CTAN
archives as \href{http://www.ctan.org/pub/tex-archive/macros/latex/base/lppl.txt}{\texttt{macros/latex/base/lppl.txt}}; either
version~1 of the License, or (at your option) any later version.
\end{quote}
\minisec{History:}
\begin{tabular}{@{}ll>{\raggedright\arraybackslash}p{10cm}@{}}
1.2 & 25 May 1999 & Re-published under the LPPL\@. No other change. \\
1.1 & 07 Feb 96 & Added setting of \cmd{\thelisting} with the \cls{book} and \cls{report} document classes. \\
1.0 & 19 Aug 94 & Created.
\end{tabular}
\minisec{Load with:}
\verb+\usepackage{listing}+\\
or\\
\verb+\usepackage[bigcaptions]{listing}+
\minisec{Package option:}
\begin{labeling}{\opt{bigcaptions}}
\item[\opt{bigcaptions}] If present, captions appear as for sections
(or chapters when using the ``\cls{book}'' or ``\cls{report}''
classes).
If not present, captions appear as for captions
in the \env{figure} or \env{table} environment.
\end{labeling}
\minisec{Available control sequences:}
\begin{labeling}{\cmd{\listlistingname}}
\item[\cmd{\begin\{listing\}}] A new environment for listings is provided.
Unlike \env{figure} and \env{table}, listing is \textls[40]{NOT}
a floating environment.
\item[\cmd{\caption}] As usual. (only inside listing!)
\item[\cmd{\label}] As usual. (only inside listing; after \cmd{\caption}!)
\item[\cmd{\ref}] As usual.
\item[\cmd{\listoflistings}] As for \cmd{\listoftables}, \cmd{\listoffigures}.
\item[\cmd{\listingname}] Produces the ``Listing'' text for the caption.
\item[\cmd{\listlistingname}] Produces the ``List of Listings'' text.
\end{labeling}
A \texttt{*.lol} file is produced similar to \texttt{*.lot}, \texttt{*.lof} files.
Does not change \cmd{\@makecaption} (unless option ``bigcaptions'' is used),
so packages that change the layout of \cmd{\caption} still work.
\pkg{listing.sty} works together with \pkg{hangcaption.sty}.
\begin{quote}
\myllap{``}Documentation is like sex.
If it is good, it is \textls[50]{REALLY} good,
and if it is bad, it is better than nothing!''
\hfill[Gabe Helou]
\end{quote}
\end{document}
|
