Debian Codegraph @

texmf-dist/doc/latex/seminar/README

raw
1 -------------------------------------------------------
2 IMPORTANT NOTE
3
4 With the agreement of Timothy Van Zandt (now [email protected]),
5 the distributions conditions on seminar are now relaxed to:
6 %%
7 %% This file may be distributed and/or modified under the conditions of
8 %% the LaTeX Project Public License, either version 1.2 of this license
9 %% or (at your option) any later version. The latest version of this
10 %% license is in:
11 %%
12 %% http://www.latex-project.org/lppl.txt
13 %%
14 %% and version 1.2 or later is part of all distributions of LaTeX version
15 %% 1999/12/01 or later.
16 %%
17
18 June 3rd 1999 (last updated September 2005)
19 Sebastian Rahtz <[email protected]>
20 Denis Girou <[email protected]>
21 Herbert Voß <[email protected]>
22
23 (Tim's helpers on earth)
24 -------------------------------------------------------
25
26 %% BEGIN sem-read.me
27 ***********************************************************************
28 **** "readme" file for seminar.cls package, v1.0, 93/04/01 ****
29 ***********************************************************************
30
31 COPYRIGHT 1993, by Timothy Van Zandt
32
33 DESCRIPTION:
34
35 seminar.sty is a LaTeX document style for typesetting slides or
36 transparencies, and accompanying notes. It has many advantages over
37 SliTeX. Here are some of the style's special features:
38 * It is a LaTeX style, rather than another format.
39 * It is compatible with AmS-LaTeX.
40 * You can use any fonts that work with LaTeX, including PostScript
41 fonts and AmSFonts.
42 * Slides can be landscape and portrait within the same file.
43 * Color is supported through PostScript.
44 * The slides can have a frame and a colored background.
45 * The magnification can be changed with a single command.
46 * Overlays can be produced from a single slide environment.
47 * Accompanying notes, such as the text of a presentation, can be put
48 outside the slide environments. The slides, notes or both together
49 can then be typeset in a variety of formats.
50 Some of these features require a PostScript output device.
51
52 FILES:
53
54 LaTeX:
55 seminar.cls : The main class file.
56 seminar.sty : The main style file.
57 seminar.con : The main config file.
58 sem-page.sty : Page parameters.
59 semlayer.sty : The semlayer style option (overlays and color layers).
60 semhelv.sty : The semhelv style option .
61 semlcmss.sty : The semlcmss style option.
62 semcolor.sty : The semcolor style option.
63 semrot.sty : THe semrot style option.
64 slidesec.sty : The slidesec style option.
65 sem-a4.sty : The sem-a4 style option.
66 xcomment.sty : The macros for omitting notes.
67 2up.tex : Macros for printing documents two-up.
68 2up.sty : The same as 2up.tex, but with .sty extension.
69 npsfont.sty : Macros for defining new PostScript fonts with the NFSS.
70 fancybox.sty : Box tips and tricks for LaTeX.
71
72 Documentation:
73 sem-user.tex : User's guide for seminar.sty.
74 sem-user.ind : Index for sem-user.tex.
75 semsamp1.tex : A sample document for seminar.sty.
76 semsamp2.tex : Another sample document for seminar.sty.
77 2up.doc : Documentation for 2up.tex.
78 fancybox.doc : Documentation for fancybox.sty.
79 tvz-hax.sty : For typesetting sem-user.tex and sem-code.tex.
80 tvz-code.sty : For typesetting sem-code.tex.
81 tvz-user.sty : For typesetting sem-user.tex.
82 sem-read.me : This file.
83 read-me.pst : The read-me file for the PSTricks package.
84
85 Sources:
86 seminar.doc : Documented code for seminar.sty.
87 semlayer.doc : Documented code for semlayer.sty.
88 xcomment.doc : Documented code for xcomment.sty.
89 sem-make.tex : For extracting code from seminar.doc and semlayer.doc.
90 sem-code.tex : For typesetting seminar.doc and semlayer.doc.
91 xc-make.tex : For extracting code from xcomment.doc.
92 xcomment.tex : For typesetting xcomment.doc.
93
94 GETTING STARTED:
95
96 1. Put the input files in a directory where your TeX looks for inputs.
97
98 2. Typeset and print sem-user.tex.
99
100 3. Read the preface "Getting Started", and then the appendices.
101
102 4. Typeset semsamp1.tex and semsamp2.tex.
103
104 5 If upgrading from v0.92, see the changes listed at the end of this
105 file. If upgrading from v0.91 or earlier, good luck.
106
107 HACKERS:
108
109 The files seminar.doc, semlayer.doc and xcomment.doc contain the
110 documented code, using Frank Mittelbach's doc system.
111 See sem-code.tex and xcomment.tex for instructions on typesetting
112 these files.
113 See sem-make.tex and xc-make.tex for instruction on extracting
114 stripped input (.sty) files from these .doc files.
115
116 MORE ABOUT THE SUPPLEMENTAL STYLES AND MACROS:
117
118 The following styles and macros are not specifically for use
119 with seminar.sty, and hence are not described in detail in
120 the seminar.sty User's Guide. You do not need to read the
121 documentation of these files in order to use seminar.sty.
122 If you have versions on your system that are older than the
123 ones distributed with seminar.sty, be sure to replace these.
124
125 FANCYBOX.STY:
126 fancybox.sty is a LaTeX style option with tips and tricks for LR-box
127 commands. The documentation, fancybox.doc, is extensive.
128
129 2UP.TEX:
130 2up.tex/2up.sty contains macros for typesetting documents in a
131 two-up format. seminar.sty's \twoup command provides an interface.
132 2up.doc is the documentation for 2up.tex.
133
134 NPSFONT.STY:
135 npsfont.sty contains macros for defining new PostScript fonts
136 with the New Font Selection Scheme. The documentation is in
137 npsfont.sty itself.
138
139 XCOMMENT.STY:
140 xcomment.sty, a LaTeX style option, permits one to typeset only
141 selected environments, omitting input outside these environments.
142 See xcomment.tex if you want to typeset the documentation.
143
144 SLIDESEC.STY
145 slidesec.sty is an experimental file contains sectioning commands
146 for slide type documents. The documentation is in slidesec.sty
147 itself.
148
149
150 SEMINAR.STY AND PSTRICKS.TEX:
151
152 pstricks.tex is a collection of PostScript macros that is compatible
153 with most TeX macro packages, including Plain TeX and LaTeX. Included are
154 macros for color, graphics, rotation, overlays, nodes and much more.
155
156 seminar.sty, combined with the semcolor option, the PSTricks package,
157 and your favorite macros for including EPS files, make a complete
158 TeX presentation software package.
159
160 You can probably obtain the PSTricks package from wherever you got
161 the Seminar package, or try
162 Princeton.EDU:/pub or Princeton.EDU:/pub/tvz
163
164 You must install the PSTricks package before using the semcolor option.
165
166 seminar.sty will work with pstricks.tex v0.92, and maybe later
167 versions.
168
169
170 ACKNOWLEDGEMENTS:
171
172 The author is thankful to Frank Mittelbach for his documentation system.
173
174 Thanks to Sebastian Rahtz for bits of advice, and many users for
175 comments and bug reports.
176
177 BUGS:
178
179 Too many to list, and who knows what they are anyway. These files are all
180 preliminary and unstable. Not responsible for neck injuries.
181
182
183 Thanks.
184
185 CHANGES:
186
187 v1.0: Included sem-a4.sty file, as a way to let the default papersize
188 be A4 (The a4 option still works). Added \epsfslidesize to make
189 it easier to set the slide of eps files with epsf.sty. Fixed bug
190 which caused the width of second pages of a multi-page slide to
191 end up too small if the page only contained a quote or similar
192 environment with reduced margins.
193
194 v0.93a: Fixed bugs so that slides would come out properly with the
195 2-up,article and portrait options (together), and so that
196 slides would be positioned correctly with the portrait style
197 option.
198
199 v0.93:
200
201 INCOMPATIBLE CHANGES:
202
203 ! Use the a4 option instead of sem-a4. There is not longer a
204 separate file for a4.
205
206 ! No more \fewnotes, \nonotes. Use \slideplacement instead.
207
208 ! No more \layerstyle, \overlaystyle.
209
210 ! Slide styles are now "left" and "bottom".
211
212 ! No more \ifslides. Use \ifarticle\else.
213
214 ! You must now use the semlayer option to use overlays (in addition
215 to the semcolor option).
216
217 ! No "down" slide rotation (only "none", "left" and "right".
218
219 ! portrait option is no longer a separate file.
220
221 ! \paperwidth and \paperheight are now ordinary commands, to be set
222 with \renewcommand.
223
224 ! \slidefonts is now always invoked in slide environments, and never in
225 the preamble. (But semhelv.sty and semlcmss.sty have changed to
226 reflect this.)
227
228 ! Method for customizing the slide frames has changed.
229 \slideframecolor, \slideframearc, \slidefillcolor and
230 \slideshadowcolor are obsolete.
231
232 ! \landscape command replaced by \printlandscape to avoid conflict with
233 other style files. (E.g., \def\printlandscape{\special{landscape}}).
234
235 NEW FEATURES:
236
237 + A slide environment can have multiple `pages'. \extraslideheight{len}
238 controls page cutting. See user's guide for details.
239
240 + \centerslidestrue (default) causes the contents of partially full
241 slides to be vertically centered in the slide. \centerslidesfalse
242 causes it to be flush top.
243
244 + New \raggedslides[len] command, for setting
245 whether right margin in slides is ragged or justified. Default is
246 \raggedslides. \raggedslides[0pt] gives justified slides.
247
248 + \slideplacement
249
250 + \onlynotestoo
251
252 + \slideskip and \slideshrink for added control over interline space.
253
254
255 + New: \slideleftmargini, \slideleftmarginii, \slideleftmarginiii,
256 \slidelabelsep, \slideitemsep, \slidepartopsep,
257 \slideparskip, \slideparindent, \slidefootins, \slidefootnotesep,
258 \slidedisplayskips, \theslidefootnote
259
260 + \input and \endinput now supported for the slidesonly selection.
261
262 + New conditional: \ifportrait
263
264 + \newslideframe
265
266 + \leftsliderotation, \rightsliderotation.
267
268 + New \slidetopmargin, \slidebottommargin, \slideleftmargin,
269 \sliderightmargin.
270
271 + New notesonly* selection.
272
273 + New \slidesclearpagetrue
274
275 + New \semcm and \semin.
276
277 + New note environment and \noxcomment command, as an alternative
278 to treating everything outside slide environments as notes.
279
280
281 BACKWARDS-COMPATIBLE CHANGES:
282
283 * \maketitle now uses LaTeX's default from article.sty in notes.
284
285 * Bug in article option with the \twoup command fixed.
286
287 * \topmargin in sem-a4 changed from -.75in to 1in.
288
289 * \slidefontsizes is obsolete (but still works). Use \ptsize instead.
290
291 * Page parameters are now in a separate file sem-page.sty. sem-a4.sty
292 has been changed to reflect this.
293
294 v0.92:
295 Mostly bug fixes, plus some extra options. The PSTricks package
296 is no longer distributed with seminar.sty.
297
298 Pre v0.91:
299 Entirely rewritten. Too many changes to list. Note especially
300 that system of formats and selections has changed.
301
302 %% END sem-read.me
303
304
305
306 THIS IS A SUPPLEMENTARY READ-ME FOR V1.0e OF THE SEMINAR PACKAGE
307
308 ***********************************************************************
309 **** "readme" file for the Seminar package, v1.0e, 94/09/12 ****
310 ***********************************************************************
311
312 COPYRIGHT 1993, 1994 by Timothy Van Zandt, [email protected]
313 %%
314 %% These files may be distributed and/or modified under the conditions of
315 %% the LaTeX Project Public License, either version 1.2 of this license
316 %% or (at your option) any later version. The latest version of this
317 %% license is in:
318 %%
319 %% http://www.latex-project.org/lppl.txt
320 %%
321 %% and version 1.2 or later is part of all distributions of LaTeX version
322 %% 1999/12/01 or later.
323 %%
324
325 BUGS: If you have problems using this seminar package with LaTeX2e,
326 report them to [email protected]. The problem probably lies
327 with seminar.cls. You can probably continue to use the seminar
328 package with LaTeX2e in compatibility mode, while waiting for a bug
329 fix, by renaming seminar.cls to something else.
330
331 ABOUT V1.0e:
332
333 The V1.0e distribution is identical to v1.0 of 93/04/01,
334 except for a few changes so that Seminar can work with
335 NFSS2 and LaTeX2e:
336
337 - semhelv.sty and semlcmss.sty have been modified to work
338 with NFSS2 and LaTeX2e (but they still work with NFSS).
339
340 - seminar.cls has been added. This is a LaTeX2e document class,
341 derived from seminar.sty v1.0 by Sebastian Rahtz.
342
343 If you already have have seminar.sty v1.0e, then all you need
344 are this read-me file plus these files from the inputs
345 directory:
346
347 seminar.cls semhelv.sty semlcmss.sty
348
349 USING SEMINAR WITH LATEX2E:
350
351 !!! YOU MUST BE USING A LATEX2E RELEASED AFTER 19 FEBRUARY 1994
352
353 You can either use seminar.sty in compatibility mode:
354 \documentstyle{seminar}
355 Or use the seminar.cls document class:
356 \documentclass{seminar}
357
358 Unless you are using other macros that only work in
359 compatibility mode, you might as well use the document class.
360
361 You can use the following options with \documentclass{seminar}:
362
363 article slidesonly notes notesonly notesonly*
364 noxcomment portrait a4 (or a4paper) semhelv semlcmss
365 semlayer semrot semcolor slidesec
366
367 plus appropriate options for the article document class
368 (e.g., 11pt)
369
370 NOTE: Use `a4' or `a4paper', not `sem-a4'.
371
372 `seminar.cls' is a minimal modification of seminar.sty. The
373 next release will take advantage of more of LaTeX2e's special
374 capabilities.
375
376
377 Tim Van Zandt
378 August 24, 1994