% GURPS-BibTeX-HOWTO.tex -- How to use the GURPS.bib BibTeX file
%
% This document is released to the Public Domain by Chad Walstrom
% on Thu, 23 Nov 2006 23:04:51 -0600
%
\documentclass{article}
\usepackage[colorlinks]{hyperref}

\bibliographystyle{GURPS}

\title{How to Use the Unofficial GURPS\textregistered~Bib\TeX~Database}
\author{Chad C. Walstrom}

\begin{document}
\maketitle
\tableofcontents

\section{Introduction}
Bib\TeX\footnote{``The Bib\TeX~Format'',
\url{http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html},
24 Nov 2006.}is a tool used for marking citations in a
\LaTeX{}\footnote{``\LaTeX{}: A Document Preparation System'',
\url{http://www.latex-project.org}, 16 Nov 2006. Look here for HOWTO's
and Tutorials.} document as well as maintaining a re-useable
bibliographical database.  It is rather flexible in that the style of
both the citation as well as the bibliography entries can be
maintained separately from the article, book, or database itself.
GURPS\textregistered, the Generic Universal Role Playing
System\footnote{``GURPS: Generic Universal Role Playing System'',
\url{http://www.sjgames.com/GURPS}, 16 Nov 2006.}, is a
pencil-and-dice game published by Steve Jackson
Games\texttrademark\footnote{``Steve Jackson Games Homepage'',
\url{http://www.sjgames.com/}, 16 Nov 2006.}.  This document explains
how to use the GURPS Bib\TeX~ database, where to find it, and how to
contribute
to it.

\section{This Document}
This document contains no copyrighted works of Steve Jackson Games and
is released to the \emph{Public Domain} as of \emph{Thu, 23 Nov 2006
23:08:43 -0600}.  It was created using \LaTeX{}~and the
ViM\footnote{``ViM: Vi iMproved'', \url{http://www.vim.org}, 16 Nov
2006.} text editor.  If you find errors in this document or have
suggestions on how to improve it, please send email to Chad C.
Walstrom at
$<$\href{mailto:chewie@wookimus.net}{chewie@wookimus.net}$>$.

The document in PDF format, its source in \LaTeX{} format, and the
Bib\TeX~database can be found at
\url{http://wookimus.net/~chewie/GURPS} as separate documents or a
single, compressed tarball.\footnote{A tarball a common name for a tar
archive, a format similar to ZIP but more commonly used in
UNIX\texttrademark environments.}

\section{How do I use Bib\TeX?}
If you are writing \LaTeX{} documents, you can use the GURPS Bib\TeX~
database by including the following directive in the preamble of the
document:

\begin{quote}
\begin{verbatim}
\bibliographystyle{GURPS}
\end{verbatim}
\end{quote}

The style you use, in this case ``\verb+GURPS+'', changes how the
citations appear in the document as well as the bibliographic entries
at the end of the document.  It even changes the order in which
entries are listed.  There is a custom (\emph{buggy} \footnote{With
the recent addition of the `editor' field to the database, this style
file fails to compile references correctly.  If you can help, it would
be much appreciated.  -- Chad Walstrom, 01 May 2007.}) style file
named ``\verb+GURPS.bst+''.  You do not need this style file, but if
you would like citations labeled by the Bib\TeX~key, be sure to use
it.

To make a citation, use the ``\verb+\cite{KEY}+'' directive like so:

\begin{quote}
\begin{verbatim}
this advantage is found in \emph{GURPS Basic Set, 4th
edition}\cite{B}.
\end{verbatim}
\end{quote}

GURPS publications are often referenced by the word ``GURPS'' followed
by the title.  For example, ``\emph{GURPS Magic}''.  Citation keys are
chosen based on the list of abbreviations\footnote{``List of
Abbreviations''\url{http://www.sjgames.com/gurps/abbrevs.html}, 24 Nov
2006.} used by Steve Jackson Games.  If you are uncertain about what
the key might be, reference this document or open the \verb+GURPS.bib+
file in a text editor and search for the book title.  The key is the
text immediately following ``\verb+@book{+''.  Finally, place the
following directive in your Bibliography section of the document.

\begin{quote}
\begin{verbatim}
\bibliography{GURPS}
\end{verbatim}
\end{quote}

The database file is named ``\verb+GURPS.bib+''.  This directive tells
the ``\verb+bibtex+'' program where to find entries to insert into the
document.  When it's time to create the document, run the
``\verb+latex+'' command, the ``\verb+bibtex+'' command once, and
``\verb+latex+'' once again.  To make a PDF, then run
``\verb+pdflatex+''.  If a Postscript document is needed, run
``\verb+dvips+''.  An example of this process is found in the
``\verb+Makefile+'' included with the source tarball for this
document.

\section{How do I contribute?}
By default, publications that do not have accurate information for are
given the generic name ``First Last''.  The year is listed as ``YEAR''
and the ISBN as ``1-55634-XXX-X''.  Volumes and editions are left out.
If this information is known, it is entered into ``\verb+GURPS.bib+''
in the following format:

\begin{verbatim}
@book{B:Ch,
	author = {S. Jackson and S. Punch and D. Pulver},
	title = {Basic Set},
	publisher = {Steve Jackson Games Inc.},
	howpublished = {Hardcover},
	year = {2004},
	volume = {Characters},
	address = {USA},
	edition = {4th},
	isbn = {1-55634-729-4},
}
\end{verbatim}

To correct or update an entry, send email directly to
\href{mailto:chewie@wookimus.net}{Chad Walstrom} with details about a
Steve Jackson Games publication.  Don't worry about formatting or
bother sending \verb+diff+ files if you don't know what they are.  I
will gladly accept the unadorned information.

Send me the authors, editors, title, and publication year of the book.
If it was published by someone other than Steve Jackson Games, is
trademarked or licenced title, please let me know so I can put the
correct attributions in this document as well.  If you don't own these
books, search an on-line bookstore.

JabRef\footnote{``JabRef Reference Manager''
\url{http://jabref.sourceforge.net/}, 01 May 2007.} is a Bib\TeX{}
reference manager written in Java.  It provides a very flexible and
useful graphical interface for managing a Bib\TeX{} database.  If you
do plan on using JabRef, you can email your modified \verb+GURPS.bib+.
If you wish to send me a \verb+diff+ file between your database and
the original, be certain that you order the entries by `bibtexkey'.
You can do this by selecting `Options->Preferences->Save in Default
Table Sort Order'.

\section{Titles}
This section contains a list of titles that can be cited from the
database.  Initial versions of the GURPS.bib file will be grossly
incomplete, but you should be able to see the entries in the
Bibliography section below:

\begin{quote}
\emph{AADA Road Atlas V1: The East Coast}\cite{RAT1},
\emph{AADA Road Atlas V2: The West Coast}\cite{RAT2},
\emph{AADA Road Atlas V3: The South}\cite{RAT3},
\emph{AADA Road Atlas V4: Australia}\cite{RAT4},
\emph{AADA Road Atlas V5: The Midwest}\cite{RAT5},
\emph{AADA Road Atlas V6: The Free Oil States}\cite{RAT6},
\emph{AADA Road Atlas V7: The Mountain West}\cite{RAT7},
\emph{Aces Abroad}\cite{AA},
\emph{Age of Napoleon}\cite{AON},
\emph{Aliens}\cite{A},
\emph{All-Star Jam 2004}\cite{ASJ},
\emph{Alpha Centauri}\cite{AC},
\emph{Alternate Earths 2}\cite{AET},
\emph{Alternate Earths}\cite{AE},
\emph{Arabian Nights}\cite{AN},
\emph{Atlantis}\cite{AT},
\emph{Atomic Horror}\cite{AH},
\emph{Autoduel}\cite{AD},
\emph{Aztecs}\cite{AZ},
\emph{Banestorm}\cite{BA},
\emph{Basic Set Deluxe Edition}\cite{B:De},
\emph{Basic Set: Campaigns}\cite{B:Ca},
\emph{Basic Set: Characters}\cite{B:Ch},
\emph{Basic Set}\cite{B},
\emph{Best of JTAS 1}\cite{T:Ji},
\emph{Best of Pyramid 1}\cite{PYi},
\emph{Best of Pyramid 2}\cite{PYii},
\emph{Bestiary}\cite{BE},
\emph{Bio-Tech}\cite{BIO},
\emph{Black Ops}\cite{BO},
\emph{Blood Types}\cite{BT},
\emph{Blue Planet}\cite{BP},
\emph{Bunnies \& Burrows}\cite{BB},
\emph{Cabal}\cite{CB},
\emph{Callahan's Crosstime Saloon}\cite{CCS},
\emph{Camelot}\cite{CA},
\emph{Castle Falkenstein: The Ottoman Empire}\cite{OT},
\emph{Castle Falkenstein}\cite{CF},
\emph{Celtic Myth}\cite{CM},
\emph{China}\cite{CH},
\emph{Cliffhangers}\cite{CL},
\emph{Compendium II}\cite{CII},
\emph{Compendium I}\cite{CI},
\emph{Conan}\cite{CO},
\emph{Cops}\cite{C},
\emph{Covert Ops}\cite{CV},
\emph{Creatures of the Night}\cite{CN},
\emph{CthulhuPunk}\cite{CT},
\emph{Cyberpunk Adventures}\cite{CYA},
\emph{Cyberpunk}\cite{CY},
\emph{Cyberworld}\cite{CW},
\emph{Dark Places}\cite{DP},
\emph{Deadlands Dime Novel 1 - Aces and Eights}\cite{D:DN1},
\emph{Deadlands Dime Novel 2 - Wanted: Undead or Alive}\cite{D:DN2},
\emph{Deadlands: Hexes}\cite{D:H},
\emph{Deadlands: Varmints}\cite{D:V},
\emph{Deadlands: Weird West}\cite{DL},
\emph{Dinosaurs}\cite{D},
\emph{Discworld Also}\cite{DA},
\emph{Discworld Roleplaying Game}\cite{DI},
\emph{Dragons}\cite{DR},
\emph{Egypt}\cite{EG},
\emph{Espionage}\cite{E},
\emph{Faerie}\cite{FA},
\emph{Fantasy Adventures}\cite{FA},
\emph{Fantasy Bestiary}\cite{FB},
\emph{Fantasy Folk}\cite{FF},
\emph{Fantasy II}\cite{FII},
\emph{Fantasy}\cite{FA},
\emph{Fantasy}\cite{F},
\emph{Goblins}\cite{GB},
\emph{Greece}\cite{GR},
\emph{Grimoire}\cite{G},
\emph{Harkwood}\cite{HA},
\emph{Hellboy Sourcebook and Roleplaying Game}\cite{HB},
\emph{High-Tech}\cite{HT},
\emph{Horror}\cite{H},
\emph{Horseclans}\cite{HO},
\emph{Humanx}\cite{HU},
\emph{IOU}\cite{IOU},
\emph{Ice Age}\cite{IA},
\emph{Illuminati}\cite{I},
\emph{Imperial Rome}\cite{IR},
\emph{In Nomine}\cite{IN},
\emph{Infinite Worlds}\cite{IW},
\emph{International Super Teams}\cite{IST},
\emph{Japan}\cite{J},
\emph{Lensman}\cite{L},
\emph{Lite}\cite{LI},
\emph{Low-Tech}\cite{LT},
\emph{Mage: The Ascension}\cite{MTA},
\emph{Magic Items 1}\cite{MI},
\emph{Magic Items 2}\cite{MIT},
\emph{Magic Items 3}\cite{MIiii},
\emph{Magic}\cite{M},
\emph{Man to Man}\cite{MTM},
\emph{Mars}\cite{MAR},
\emph{Martial Arts Adventures}\cite{MAA},
\emph{Martial Arts}\cite{MA},
\emph{Mecha}\cite{ME},
\emph{Middle Ages 1}\cite{MAO},
\emph{Mixed Doubles}\cite{MD},
\emph{Modern Firepower}\cite{MF},
\emph{Monsters}\cite{MO},
\emph{Myth}\cite{MY},
\emph{New Sun}\cite{NS},
\emph{Ogre}\cite{OG},
\emph{Old Stone Fort}\cite{OSF},
\emph{Old West}\cite{OW},
\emph{Operation Endgame}\cite{OE},
\emph{Places Of Mystery}\cite{PM},
\emph{Planet Krishna}\cite{PK},
\emph{Planet of Adventure}\cite{PA},
\emph{Planetary Survey 1: Kamsii}\cite{T:PS1},
\emph{Planetary Survey 2: Denuli}\cite{T:PS2},
\emph{Planetary Survey 3: Granicus}\cite{T:PS3},
\emph{Planetary Survey 4: Glisten}\cite{T:PS4},
\emph{Planetary Survey 5: Tobibak}\cite{T:PS5},
\emph{Planetary Survey 6: Darkmoon}\cite{T:PS6},
\emph{Prisoner}\cite{PR},
\emph{Psionics}\cite{P},
\emph{Reign of Steel}\cite{RS},
\emph{Religion}\cite{R},
\emph{Riverworld}\cite{RI},
\emph{Robin Hood}\cite{RH},
\emph{Robots}\cite{RO},
\emph{Rogues}\cite{RG},
\emph{Russia}\cite{RU},
\emph{SWAT}\cite{SWT},
\emph{Scarlet Pimpernel}\cite{SP},
\emph{Screampunk}\cite{SCR},
\emph{Shapeshifters}\cite{SH},
\emph{Space Adventures}\cite{SA},
\emph{Space Atlas 2}\cite{SAT2},
\emph{Space Atlas 3}\cite{SAT3},
\emph{Space Atlas 4}\cite{SAT4},
\emph{Space Atlas}\cite{SAT1},
\emph{Space Bestiary}\cite{SB},
\emph{Space}\cite{S},
\emph{Special Ops}\cite{SO},
\emph{Spirits}\cite{SPI},
\emph{Steam-Tech}\cite{STE},
\emph{Steampunk}\cite{STM},
\emph{Super Scum}\cite{SS},
\emph{Supers Adventures}\cite{SUA},
\emph{Supers}\cite{SU},
\emph{Supertemps}\cite{ST},
\emph{Supporting Cast}\cite{SC},
\emph{Swashbucklers}\cite{SW},
\emph{Technomancer}\cite{T},
\emph{Terradyne}\cite{TE},
\emph{Time Travel Adventures}\cite{TTA},
\emph{Time Travel}\cite{TT},
\emph{Timeline}\cite{TI},
\emph{Transhuman Space: Broken Dreams}\cite{BD},
\emph{Transhuman Space: Deep Beyond}\cite{DB},
\emph{Transhuman Space: Fifth Wave}\cite{FW},
\emph{Transhuman Space: High Frontier}\cite{HF},
\emph{Transhuman Space: In The Well}\cite{ITW},
\emph{Transhuman Space: Orbital Decay}\cite{OD},
\emph{Transhuman Space: Personnel Files}\cite{PF},
\emph{Transhuman Space: Spacecraft of the Solar System}\cite{SSS},
\emph{Transhuman Space: Toxic Memes}\cite{TM},
\emph{Transhuman Space: Under Pressure}\cite{UP},
\emph{Transhuman Space}\cite{TS},
\emph{Traveller GM's Screen}\cite{T:GM},
\emph{Traveller: Alien Races 1}\cite{T:AI},
\emph{Traveller: Alien Races 2}\cite{T:AII},
\emph{Traveller: Alien Races 3}\cite{T:AIII},
\emph{Traveller: Alien Races 4}\cite{T:AIV},
\emph{Traveller: Behind The Claw}\cite{T:BC},
\emph{Traveller: Far Trader}\cite{T:FT},
\emph{Traveller: First In}\cite{T:FI},
\emph{Traveller: Ground Forces}\cite{T:GF},
\emph{Traveller: Heroes 1 - Bounty Hunters}\cite{T:BH},
\emph{Traveller: Humaniti}\cite{T:H},
\emph{Traveller: Interstellar Wars}\cite{T:IW},
\emph{Traveller: Modular Cutter}\cite{T:MC},
\emph{Traveller: Navy}\cite{T:NV},
\emph{Traveller: Nobles}\cite{T:N},
\emph{Traveller: Rim of Fire}\cite{T:RF},
\emph{Traveller: Star Mercs}\cite{T:SM},
\emph{Traveller: Starports}\cite{T:ST},
\emph{Traveller: Starships}\cite{T:S},
\emph{Traveller: Sword Worlds}\cite{T:SW},
\emph{Traveller: The Interstellar Wars}\cite{T:TIW} (Duplicate?),
\emph{Traveller}\cite{GT},
\emph{Tredroy}\cite{TR},
\emph{Ultra-Tech 2}\cite{UTT},
\emph{Ultra-Tech}\cite{UT},
\emph{Undead}\cite{UN},
\emph{Uplift}\cite{U},
\emph{Vampire Companion}\cite{VC},
\emph{Vampire: The Masquerade}\cite{VTM},
\emph{Vehicles Expansion 1}\cite{VXi},
\emph{Vehicles Expansion 2}\cite{VXii},
\emph{Vehicles Lite}\cite{VEL},
\emph{Vehicles}\cite{VE},
\emph{Vikings}\cite{VI},
\emph{Villains}\cite{V},
\emph{Voodoo}\cite{VO},
\emph{Vorkosigan}\cite{VOR},
\emph{WWII: All the King's Men}\cite{W:AKM},
\emph{WWII: Blitzkrieg}\cite{W:B},
\emph{WWII: Dogfaces}\cite{W:D},
\emph{WWII: Frozen Hell}\cite{W:FH},
\emph{WWII: Grim Legions}\cite{W:GL},
\emph{WWII: Hand of Steel}\cite{W:HS},
\emph{WWII: Iron Cross}\cite{W:IC},
\emph{WWII: Motor Pool}\cite{W:MP},
\emph{WWII: Return to Honor}\cite{W:RH},
\emph{WWII: Weird War II}\cite{W:WW},
\emph{WWII}\cite{W},
\emph{War Against the Chtorr}\cite{WAC},
\emph{Warehouse 23}\cite{WT},
\emph{Warriors}\cite{WA},
\emph{Werewolf: The Apocalypse}\cite{WTA},
\emph{Who's Who 1}\cite{WWi},
\emph{Who's Who 2}\cite{WWii},
\emph{Wild Cards}\cite{WC},
\emph{Witch World}\cite{WW},
\emph{Wizards}\cite{WI},
\emph{Y2K}\cite{Y}
\end{quote}

\appendix
\section{Bibliography}
This section contains references and citations used to create this
document.

% Bibliography
\bibliography{GURPS}
\end{document}