listing doc update, own package

git-svn-id: svn://tug.org/texlive/trunk@17373 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 132 insertions, 0 deletions

diff --git a/Master/texmf-dist/tex/latex/listing/listing.sty b/Master/texmf-dist/tex/latex/listing/listing.sty
new file mode 100644
index 00000000000..3592501e5b7
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/listing/listing.sty
@@ -0,0 +1,132 @@
+%%----------------------------------------------------------------------
+%% listing.sty
+%
+% LaTeX package for typesetting listings. 
+% Documentation at end of file after \endinput.
+%
+% Requires LaTeX2e (or newer).
+%
+%
+% (C) Copyright 1994, 1996, 1999 by:
+%
+% Matthew Hebley, Volker Kuhlmann
+% University of Canterbury
+% EEE Dept
+% Christchurch, New Zealand
+% E-Mail: v.kuhlmann@elec.canterbury.ac.nz
+%         (Matthew is no longer available for contact, email or otherwise)
+%
+% This program can be redistributed and/or modified under the terms
+% of the LaTeX Project Public License, distributed from CTAN
+% archives as macros/latex/base/lppl.txt; either
+% version 1 of the License, or (at your option) any later version.
+%
+%
+% HISTORY:
+%
+% 1.2   25 May 1999	Re-published under the LPPL. No other change.
+% 1.1   07 Feb 96	Added setting of \thelisting with the book and
+%			report document classes.
+% 1.0   19 Aug 94	Created.
+%
+%%----------------------------------------------------------------------
+
+\def\filename{listing}
+\def\fileversion{V1.2}
+\def\filedate{1999/05/25}
+
+
+\NeedsTeXFormat{LaTeX2e}[1994/06/01]
+\ProvidesPackage{\filename}[\filedate]
+\typeout{Package `\filename', \fileversion, <\filedate>}
+
+
+\newcounter{listing}
+\setcounter{listing}{0}
+
+\newenvironment{listing}{%
+   \newcommand{\@captype}{listing}%
+   \@ifundefined{@bigcaptionflag}{}{%
+      \def\@makecaption##1##2{%
+         \vskip \abovecaptionskip 
+         \@listingsection*{##1:~##2}% 
+         \vskip \belowcaptionskip 
+         }
+      }
+   }%
+   {}
+
+\newcommand{\listingname}{Listing}
+\newcommand{\listlistingname}{List of Listings}
+
+\newcommand{\ext@listing}{lol}
+\newcommand{\fnum@listing}{\listingname ~\thelisting }
+\newcommand{\l@listing}{\@dottedtocline {1}{1.5em}{2.3em}}
+\newcommand{\listoflistings}{%
+   \@listingsection*{\listlistingname 
+      \@mkboth{\uppercase{\listlistingname}}%
+         {\uppercase{\listlistingname}}}%
+   \@starttoc {lol}%
+   }
+\@ifundefined{chapter}{%
+   \newcommand\@listingsection{\section}%
+   }{%
+   \newcommand\@listingsection{\chapter}%
+   \renewcommand\thelisting{\thechapter.\arabic{listing}}%
+   }
+   
+\DeclareOption{bigcaptions}{%
+   \def\@bigcaptionflag{}
+}
+
+\ProcessOptions
+
+ 
+\endinput
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+Load with:
+
+	\usepackage{listing}
+or
+	\usepackage[bigcaptions]{listing}
+
+
+Package option:
+
+bigcaptions	If present, captions appear as for sections
+		(or chapters when using the "book" or "report" 
+		classes).
+		If not present, captions appear as for captions
+		in the figure or table environment.
+
+
+Available control sequences:
+
+\begin{listing}		A new environment for listings is provided.
+			Unlike figure and table, listing is NOT
+			a floating environment.
+
+\caption		As usual. (only inside listing!)
+\label			As usual. (only inside listing; after \caption!)
+\ref			As usual.
+\listoflistings		As for \listoftables, \listoffigures.
+\listingname		Produces the "Listing" text for the caption.
+\listlistingname	Produces the "List of Listings" text.
+
+
+A *.lol file is produced similar to *.lot, *.lof files.
+
+Does not change \@makecaption (unless option "bigcaptions" is used),
+so packages that change the layout of \caption still work.
+listing.sty works together with hangcaption.sty.
+
+	``Documentation is like sex.
+	  If it is good, it is REALLY good, 
+	  and if it is bad, it is better than nothing!''
+
+						[Gabe Helou]
+
+%% EOF listing.sty
+%%----------------------------------------------------------------------