
% The playerlist format is defined with \playerlist by the Production Czar,
% just after these comments:
%% \playerlist{
%%	{Column heading}{Column info}
%%	{2nd column heading}{2nd column info}
%%	...
%%	{last column heading}{last column info}
%% }
% You can have any number of columns.  The 'column heading' is put
% at the top of the column, of course.  The 'column info' is the
% info taken from each character for the column with \Cchar{info}.
% That is, the typical entry of {\bf Character}{char} puts ``Character''
% in boldface at the top of the column, and for each \Ccharacter in
% Lists/characters.tex puts \Ccharacter{char} in that column.  You can put
% anything for 'info' that you could put in \Ccharacter{info},
% as per html/charinfo.html.

% For each clump of character entries you want on the playerlist, put
%% \clump{clumpname}{clump heading}
% between the \begin{document} and \end{document} here.
% For instance, if you're not doing anything fancy you'd probably do
%% \clump{gm}{\bf GMs}
%% \clump{pc}{\bf PCs}
% which would give you ``GMs'' as a section header (boldface), followed by 
% listing all the GMs, the header ``PCs,'' then all the PCs.
% If you're doing something more complicated, you might have
%% \clump{gm}{\bf GMs}
%% \clump{elf}{\bf Elves and Fairies}
%% \clump{dwarf}{\bf Dwarves and Gnomes}
%% \clump{man}{\bf Humans}
% listing GMs, Elves/Fairies, Dwarves/Gnomes, and Humans separately.

% Which clump a character/gm falls into is determined by the
% 'clump' argument to \newchar, as per the Lists/characters.tex comments.
% So for the first example, you'd put {gm} for GMs and Game Mommies,
% {pc} for PCs, and for NPCs and others who shouldn't be listed you'd
% put {unlisted}, or just {}, or omit the playerlist arguments entirely
% (those last two options leave the clump at its custom.sty default, which
% probably ought to be ``unlisted'').
% For the second example you'd use {gm}, {elf}, {dwarf}.  CASE MATTERS.  Also,
% don't put whitespace in the clump names, although it's fine in headings.
% It's probably a good idea to keep your clumpnames short and simple.

% Within each clump, characters will be listed alphabetically by
% in the order defined in \orderby, which is a list of the fields
% to use with \thenby's between.  For instance, the usual ones are
% \orderby{last \thenby first \thenby middle \thenby player} or
% \orderby{first \thenby middle \thenby last \thenby player};
% the former says to order by character last name, then by char first name
% if the last names are the same, then by char middle name, then player name.

% If you'd rather have your clump ordered ``as is,'' use \clumpasis and the 
% order for that clump will be that in characters.tex.  (No, characters.tex
% entries in the same clump don't have to be near each other in characters.tex,
% of course.)  For instance, you might do this to have characters in a 
% {military} clump ordered by rank.

% The playerlist will break pages between clumps if at all possible; if it's
% not possible, the last clump on the first page will extend to the second.

% If the playerlist happens to fit on a single page, your Postscript/map.ps
% can be automatically put on the other side; this will happen if you used
%% \usepackage[map]{playerlist}
% or just
%% \usepackage{playerlist}
% but not if you used
%% \usepackage[nomap]{playerlist}

% When you latex this you'll get warnings for each character whose
% clump is never \clump'ed nor \clumpasis'ed, unless it's ``unlisted''
% (which, again, probably ought to be the clump default in custom.sty,
% for exactly this reason).

% If you have a really big game (#characters + 2 * #clumps > 90 or so) you 
% may need to toss \small in after \begin{document} to keep it on two pages.


\documentclass{game}

\usepackage[map]{playerlist}    % put map on back if list fits on one side

\orderby{last \thenby first \thenby middle \thenby player}

\playerlist{
	{\bf Character}{char}
	{\bf Position}{position}
	{\bf Player}{player}
	{\bf E-mail}{email}
	{\bf Address}{address}
	{\bf Phone}{phone}
	{\bf Don't call}{dontcall}
}


\begin{document}

\clump{gm}{\bf GMs}
\clump{pc}{\bf PCs}

\end{document}
