isl_vec_read_from_file: drop input_format argument
[isl.git] / doc / chicago.sty
blob33588dba9238069c48fc92072e0d702455fcd55c
1 % -*- LaTeX -*-
2 %%% ====================================================================
3 %%% @LaTeX-style-file{
4 %%% author = "Glenn Paulley",
5 %%% version = "4",
6 %%% date = "31 August 1992",
7 %%% time = "09:42:44 199",
8 %%% filename = "chicago.sty",
9 %%% address = "Data Structuring Group
10 %%% Department of Computer Science
11 %%% University of Waterloo
12 %%% Waterloo, Ontario, Canada
13 %%% N2L 3G1",
14 %%% telephone = "(519) 885-1211",
15 %%% FAX = "(519) 885-1208",
16 %%% checksum = "44674 264 1050 10394",
17 %%% email = "gnpaulle@bluebox.uwaterloo.ca",
18 %%% codetable = "ISO/ASCII",
19 %%% keywords = "",
20 %%% supported = "yes",
21 %%% abstract = "Contains the LaTeX style command definitions
22 %%% for the Chicago BibTeX styles chicago.bst and
23 %%% chicagoa.bst. For details, see below.",
24 %%% docstring = "The checksum field above contains a CRC-16
25 %%% checksum as the first value, followed by the
26 %%% equivalent of the standard UNIX wc (word
27 %%% count) utility output of lines, words, and
28 %%% characters. This is produced by Robert
29 %%% Solovay's checksum utility.",
30 %%% }
31 %%% ====================================================================
33 % chicago.sty: Style file for use with bibtex style chicago.bst, for
34 % bibliographies formatted according to the 13th Edition of the Chicago
35 % Manual of Style.
37 % 'newapa.bst' was made from 'plain.bst', 'named.bst', and 'apalike.bst',
38 % with lots of tweaking to make it look like APA style, along with tips
39 % from Young Ryu and Brian Reiser's modifications of 'apalike.bst'.
40 % newapa.sty formed the basis of this style, chicago.sty. Author-date
41 % references in newapa.bst formed the basis for chicago.bst. Chicagoa.bst
42 % supports annotations.
44 % Version 4 (August, 1992):
45 % - fixed chicago.bst and chicagoa.bst to handle long author lists in
46 % sorting
47 % - fixed chicago.bst and chicagoa.bst so that missing page numbers in
48 % ``article'' entries are handled correctly
49 % - modified chicago.sty to format entries with 2nd and subsequent lines
50 % indented.
52 % Citation format: (author-last-name year)
53 % (author-last-name and author-last-name year)
54 % (author-last-name et al. year)
55 % (author-last-name)
56 % author-last-name
57 % author-last-name (year)
58 % (author-last-name and author-last-name)
59 % (author-last-name et al.)
60 % (year) or (year,year)
61 % year or year,year
63 % Reference list ordering: alphabetical by author or whatever passes
64 % for author in the absence of one.
66 % This BibTeX style has support for abbreviated author lists and for
67 % year-only citations. This is done by having the citations
68 % actually look like
70 % \citeauthoryear{full-author-info}{abbrev-author-info}{year}
72 % The LaTeX style has to have the following (or similar)
74 % \let\@internalcite\cite
75 % \def\fullcite{\def\citeauthoryear##1##2##3{##1, ##3}\@internalcite}
76 % \def\fullciteA{\def\citeauthoryear##1##2##3{##1}\@internalcite}
77 % \def\shortcite{\def\citeauthoryear##1##2##3{##2, ##3}\@internalcite}
78 % \def\shortciteA{\def\citeauthoryear##1##2##3{##2}\@internalcite}
79 % \def\citeyear{\def\citeauthoryear##1##2##3{##3}\@internalcite}
81 % -------------------------------------------------------------------------
82 % This file implements citations for the ``chicago'' bibliography style.
83 % Place it in a file called chicago.sty in the TeX search path.
84 %(Placing it in the same directory as the LaTeX document should also work.)
86 % This file is a modification of the ``newapa'' LaTeX style,
87 % originally adapted by Steven Spencer from the ``apalike'' LaTeX style.
88 % It was originally modified by Stephen N. Spencer, with further
89 % modifications by Young U. Ryu.
91 % The ``chicago'' BibTeX bibliography style creates citations with labels:
92 % \citeauthoryear{author-info}{abbrev. author-info}{year}
94 % These labels are processed by the following LaTeX commands:
96 % \cite{key}
97 % which produces citations with full author list and year.
98 % eg. (Brown 1978; Jarke, Turner, Stohl, et al. 1985)
99 % \citeNP{key}
100 % which produces citations with full author list and year, but without
101 % enclosing parentheses:
102 % eg. Brown 1978; Jarke, Turner and Stohl 1985
103 % \citeA{key}
104 % which produces citations with only the full author list.
105 % eg. (Brown; Jarke, Turner and Stohl)
106 % \citeANP{key}
107 % which produces citations with only the full author list, without
108 % parentheses eg. Brown; Jarke, Turner and Stohl
109 % \citeN{key}
110 % which produces citations with the full author list and year, but
111 % can be used as nouns in a sentence; no parentheses appear around
112 % the author names, but only around the year.
113 % eg. Shneiderman (1978) states that......
114 % \citeN should only be used for a single citation.
115 % \shortcite{key}
116 % which produces citations with abbreviated author list and year.
117 % \shortciteNP{key}
118 % which produces citations with abbreviated author list and year.
119 % \shortciteA{key}
120 % which produces only the abbreviated author list.
121 % \shortciteANP{key}
122 % which produces only the abbreviated author list.
123 % \shortciteN{key}
124 % which produces the abbreviated author list and year, with only the
125 % year in parentheses. Use with only one citation.
126 % \citeyear{key}
127 % which produces the year information only, within parentheses.
128 % \citeyearNP{key}
129 % which produces the year information only.
131 % Abbreviated author lists use the ``et al.'' construct.
133 % `NP' means `no parentheses'.
135 % This LaTeX style file must be used with the ``chicago'' or ``chicagoa''
136 % (annotated chicago style) BibTeX styles.
138 \typeout{Using Chicago Manual of Style bibliography: 31 August 1992}
140 % -------------------------------------------------------------------------
142 % Citation macros.
144 \def\chicagoand/{ and }
145 \def\chicagoetal/{ et~al.}
147 \let\@internalcite\cite
149 \def\cite{\def\@citeseppen{-1000}%
150 \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
151 \def\citeauthortitleyear##1##2##3##4{##1\ ##4}\@internalcite}
152 \def\citeNP{\def\@citeseppen{-1000}%
153 \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
154 \def\citeauthortitleyear##1##2##3##4{##1\ ##4}\@internalcite}
155 \def\citetitleN{\def\@citeseppen{-1000}%
156 \def\@cite##1##2{##1\if@tempswa , ##2)\else{)}\fi}%
157 \def\citeauthortitleyear##1##2##3##4{##3\ (##1; ##4}\@citedata}
158 \def\citeN{\def\@citeseppen{-1000}%
159 \def\@cite##1##2{##1\if@tempswa , ##2)\else{)}\fi}%
160 \def\citeauthortitleyear##1##2##3##4{##1\ (##4}\@citedata}
161 \def\citeA{\def\@citeseppen{-1000}%
162 \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
163 \def\citeauthortitleyear##1##2##3##4{##1}\@internalcite}
164 \def\citeANP{\def\@citeseppen{-1000}%
165 \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
166 \def\citeauthortitleyear##1##2##3##4{##1}\@internalcite}
168 \def\shortcite{\def\@citeseppen{-1000}%
169 \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
170 \def\citeauthortitleyear##1##2##3##4{##2\ ##4}\@internalcite}
171 \def\shortciteNP{\def\@citeseppen{-1000}%
172 \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
173 \def\citeauthortitleyear##1##2##3##4{##2\ ##4}\@internalcite}
174 \def\shortciteN{\def\@citeseppen{-1000}%
175 \def\@cite##1##2{##1\if@tempswa , ##2)\else{)}\fi}%
176 \def\citeauthortitleyear##1##2##3##4{##2\ (##4}\@citedata}
177 \def\shortciteA{\def\@citeseppen{-1000}%
178 \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
179 \def\citeauthortitleyear##1##2##3##4{##2}\@internalcite}
180 \def\shortciteANP{\def\@citeseppen{-1000}%
181 \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
182 \def\citeauthortitleyear##1##2##3##4{##2}\@internalcite}
184 \def\citeyear{\def\@citeseppen{-1000}%
185 \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
186 \def\citeauthortitleyear##1##2##3##4{##4}\@citedata}
187 \def\citeyearNP{\def\@citeseppen{-1000}%
188 \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
189 \def\citeauthortitleyear##1##2##3##4{##4}\@citedata}
192 % \@citedata and \@citedatax:
194 % Place commas in-between citations in the same \citeyear, \citeyearNP,
195 % \citeN, or \shortciteN command.
196 % Use something like \citeN{ref1,ref2,ref3} and \citeN{ref4} for a list.
198 \def\@citedata{%
199 \@ifnextchar [{\@tempswatrue\@citedatax}%
200 {\@tempswafalse\@citedatax[]}%
203 \def\@citedatax[#1]#2{%
204 \if@filesw\immediate\write\@auxout{\string\citation{#2}}\fi%
205 \def\@citea{}\@cite{\@for\@citeb:=#2\do%
206 {\@citea\def\@citea{), }\@ifundefined% by Young
207 {b@\@citeb}{{\bf ?}%
208 \@warning{Citation `\@citeb' on page \thepage \space undefined}}%
209 {\csname b@\@citeb\endcsname}}}{#1}}%
211 \@ifpackageloaded{hyperref}{%
212 \let\BRorg@citedatax\@citedatax
213 \def\@citedatax[#1]#2{%
214 \BRorg@citedatax[#1]{#2}%
215 \Hy@backout{#2}%
218 \@ifpackageloaded{hyperref}{%
219 \def\hyperemph#1{{\em\hyperpage{#1}}}%
220 \def\bold#1{{\bf\hyperpage{#1}}}%
222 \def\hyperemph#1{{\em #1}}%
223 \def\bold#1{{\bf #1}}%
226 \def\BR@@lbibitem[#1]#2#3\par{%
227 \BRorg@bibitem[#1]{#2}#3\hfill\penalty100\hbox{}
228 \newblock
229 \backref\hfill[{\csname br@#2\endcsname}%
230 ]\parskip=-10pt\penalty-10000\hbox{}\nobreak\par
232 \def\BR@@bibitem#1#2\par{%
233 \BRorg@bibitem{#1}#2
234 \newblock
235 \backref\penalty-100\hbox{}\nobreak\hfill[\hbox{\csname br@#2\endcsname}%
236 ]\par
238 \def\thepageorcolor{\thepage}
239 \def\Hy@backout#1{%
240 \@bsphack
241 \ifx\@empty\@currentlabel
242 \protected@write\@auxout{}{%
243 \string\@writefile{brf}{%
244 \string\backcite{#1}{{\thepageorcolor}{(document)}{Doc-Start}}%
247 \else
248 \protected@write\@auxout{}{%
249 \string\@writefile{brf}{%
250 \string\backcite{#1}{{\thepageorcolor}{\@currentlabel}{\@currentHref}}%
254 \@esphack
257 % don't box citations, separate with ; and a space
258 % also, make the penalty between citations negative: a good place to break.
260 \def\@citex[#1]#2{%
261 \if@filesw\immediate\write\@auxout{\string\citation{#2}}\fi%
262 \def\@citea{}\@cite{\@for\@citeb:=#2\do%
263 {\@citea\def\@citea{; }\@ifundefined% by Young
264 {b@\@citeb}{{\bf ?}%
265 \@warning{Citation `\@citeb' on page \thepage \space undefined}}%
266 {\csname b@\@citeb\endcsname}}}{#1}}%
268 % (from apalike.sty)
269 % No labels in the bibliography.
271 \def\@biblabel#1{}
273 % (from apalike.sty)
274 % Set length of hanging indentation for bibliography entries.
276 \newlength{\bibhang}
277 \setlength{\bibhang}{2em}
279 % Indent second and subsequent lines of bibliographic entries. Stolen
280 % from openbib.sty: \newblock is set to {}.
282 \newdimen\bibindent
283 \bibindent=1.5em
284 \@ifundefined{refname}%
285 {\@ifundefined{chapter}%
286 {\newcommand{\refname}{References}}%
287 {\newcommand{\refname}{Bibliography}}%
290 \@ifundefined{chapter}%
291 {\def\thebibliography#1{\section*{\refname\@mkboth
292 {\uppercase{\refname}}{\uppercase{\refname}}}
293 \addcontentsline{toc}{section}{References}
294 \list
295 {[\arabic{enumi}]}{\settowidth\labelwidth{[#1]}
296 \leftmargin\labelwidth
297 \advance\leftmargin\labelsep
298 \advance\leftmargin\bibindent
299 \itemindent -\bibindent
300 \listparindent \itemindent
301 \parsep \z@
302 \usecounter{enumi}}
303 \def\newblock{}
304 \sloppy
305 \sfcode`\.=1000\relax}}
306 {\def\thebibliography#1{\chapter*{\refname\@mkboth
307 {\refname}{\refname}}
308 \addcontentsline{toc}{chapter}{References}
309 \list
310 {[\arabic{enumi}]}{\settowidth\labelwidth{[#1]}
311 \leftmargin\labelwidth
312 \advance\leftmargin\labelsep
313 \advance\leftmargin\bibindent
314 \itemindent -\bibindent
315 \listparindent \itemindent
316 \parsep \z@
317 \usecounter{enumi}}
318 \def\newblock{}
319 \sloppy
320 \sfcode`\.=1000\relax}}