From e13a4bc41a7c5c5697b97a3cb5182ceba8ee0f66 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 8 Mar 2010 01:11:17 +0000 Subject: listing doc update, own package git-svn-id: svn://tug.org/texlive/trunk@17373 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/tex/latex/listing/listing.sty | 132 ++++++++++++++++++++++++ 1 file changed, 132 insertions(+) create mode 100644 Master/texmf-dist/tex/latex/listing/listing.sty (limited to 'Master/texmf-dist/tex/latex/listing') 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 +%%---------------------------------------------------------------------- -- cgit v1.2.3