The Listings Package

Version 1.3b

Moving from version 0.21

The version 1.0 came with many changes.
The table below gives a brief overview.

If the fancyvrb package and listings provides same functionality, they now use the same keys; i.e. many keys have been renamed and some changed their behaviour to fit.

The lstlisting environment has lost its mandatory name argument.
A new key controls named and continued listings now.
For downward-compatibility the argument is still allowed.

All color-keys require the \color command to be part of the value.
For example, backgroundcolor=yellow becomes now backgroundcolor=\color{yellow}.
This is how the style-keys always used to select colors.

As always, a compatibility option 0.21 can be used at package loading.
This should be fully compatible with one exception:
don't use the key advancelabel.

Table: New and old keys and commands face to face

0.21

now

first

firstline

last

lastline

stringspaces

showstringspaces

visiblespaces

showspaces

visibletabs

showtabs

framerulewidth

framerule

framerulesep

rulesep

frametextsep

framesep

framespread

superceded by

framexleftmargin

framexrightmargin

framextopmargin

framexbottommargin

framerulecolor

rulecolor1

columns2

0.21

now

numbers

labelstep

stepnumber

labelstyle

numberstyle

\thelstlabel

\thelstnumber

labelsep

numbersep

firstlabel

firstnumber

advancelabel

spread

indent

xleftmargin3

xrightmargin

wholeline

resetmargins

defaultclass

classoffset

stringtest

outputpos

1All color-keys require now an explicit \color command in the value.
2 Please look into section 2.10 of the documentation.
3 Now frames are also moved!