%% BEGIN sem-read.me *********************************************************************** **** "readme" file for seminar.sty package, v1.0, 93/04/01 **** *********************************************************************** COPYRIGHT 1993, by Timothy Van Zandt, tvz@Princeton.EDU DESCRIPTION: seminar.sty is a LaTeX document style for typesetting slides or transparencies, and accompanying notes. It has many advantages over SliTeX. Here are some of the style's special features: * It is a LaTeX style, rather than another format. * It is compatible with AmS-LaTeX. * You can use any fonts that work with LaTeX, including PostScript fonts and AmSFonts. * Slides can be landscape and portrait within the same file. * Color is supported through PostScript. * The slides can have a frame and a colored background. * The magnification can be changed with a single command. * Overlays can be produced from a single slide environment. * Accompanying notes, such as the text of a presentation, can be put outside the slide environments. The slides, notes or both together can then be typeset in a variety of formats. Some of these features require a PostScript output device. GETTING SEMINAR.STY The seminar.sty package is available via anonymous ftp from Princeton.EDU:/pub/tvz and from the Utrecht, SHSU, Claremont, Aston and Stuttgart TeX archives. A bug list seminar.bug is kept up-to-date on Princeton.EDU:/pub/tvz. Send requests to get on or off the seminar.sty mailing list to the author. FILES: Inputs: seminar.sty : The main style file. sem-page.sty : Page parameters. semlayer.sty : The semlayer style option (overlays and color layers). semhelv.sty : The semhelv style option . semlcmss.sty : The semlcmss style option. semcolor.sty : The semcolor style option. semrot.sty : THe semrot style option. slidesec.sty : The slidesec style option. sem-a4.sty : The sem-a4 style option. xcomment.sty : The macros for omitting notes. 2up.tex : Macros for printing documents two-up. 2up.sty : The same as 2up.tex, but with .sty extension. npsfont.sty : Macros for defining new PostScript fonts with the NFSS. fancybox.sty : Box tips and tricks for LaTeX. Documentation: sem-user.tex : User's guide for seminar.sty. sem-user.ind : Index for sem-user.tex. semsamp1.tex : A sample document for seminar.sty. semsamp2.tex : Another sample document for seminar.sty. 2up.doc : Documentation for 2up.tex. fancybox.doc : Documentation for fancybox.sty. tvz-hax.sty : For typesetting sem-user.tex and sem-code.tex. tvz-code.sty : For typesetting sem-code.tex. tvz-user.sty : For typesetting sem-user.tex. sem-read.me : This file. read-me.pst : The read-me file for the PSTricks package. Sources: seminar.doc : Documented code for seminar.sty. semlayer.doc : Documented code for semlayer.sty. xcomment.doc : Documented code for xcomment.sty. sem-make.tex : For extracting code from seminar.doc and semlayer.doc. sem-code.tex : For typesetting seminar.doc and semlayer.doc. xc-make.tex : For extracting code from xcomment.doc. xcomment.tex : For typesetting xcomment.doc. GETTING STARTED: 1. Put the input files in a directory where your TeX looks for inputs. 2. Typeset and print sem-user.tex. 3. Read the preface "Getting Started", and then the appendices. 4. Typeset semsamp1.tex and semsamp2.tex. 5 If upgrading from v0.92, see the changes listed at the end of this file. If upgrading from v0.91 or earlier, good luck. HACKERS: The files seminar.doc, semlayer.doc and xcomment.doc contain the documented code, using Frank Mittelbach's doc system. See sem-code.tex and xcomment.tex for instructions on typesetting these files. See sem-make.tex and xc-make.tex for instruction on extracting stripped input (.sty) files from these .doc files. MORE ABOUT THE SUPPLEMENTAL STYLES AND MACROS: The following styles and macros are not specifically for use with seminar.sty, and hence are not described in detail in the seminar.sty User's Guide. You do not need to read the documentation of these files in order to use seminar.sty. If you have versions on your system that are older than the ones distributed with seminar.sty, be sure to replace these. FANCYBOX.STY: fancybox.sty is a LaTeX style option with tips and tricks for LR-box commands. The documentation, fancybox.doc, is extensive. 2UP.TEX: 2up.tex/2up.sty contains macros for typesetting documents in a two-up format. seminar.sty's \twoup command provides an interface. 2up.doc is the documentation for 2up.tex. NPSFONT.STY: npsfont.sty contains macros for defining new PostScript fonts with the New Font Selection Scheme. The documentation is in npsfont.sty itself. XCOMMENT.STY: xcomment.sty, a LaTeX style option, permits one to typeset only selected environments, omitting input outside these environments. See xcomment.tex if you want to typeset the documentation. SLIDESEC.STY slidesec.sty is an experimental file contains sectioning commands for slide type documents. The documentation is in slidesec.sty itself. SEMINAR.STY AND PSTRICKS.TEX: pstricks.tex is a collection of PostScript macros that is compatible with most TeX macro packages, including Plain TeX and LaTeX. Included are macros for color, graphics, rotation, overlays, nodes and much more. seminar.sty, combined with the semcolor option, the PSTricks package, and your favorite macros for including EPS files, make a complete TeX presentation software package. You can probably obtain the PSTricks package from wherever you got the Seminar package, or try Princeton.EDU:/pub or Princeton.EDU:/pub/tvz You must install the PSTricks package before using the semcolor option. seminar.sty will work with pstricks.tex v0.92, and maybe later versions. ACKNOWLEDGEMENTS: The author is thankful to Frank Mittelbach for his documentation system. Thanks to Sebastian Rahtz for bits of advice, and many users for comments and bug reports. COPYING: Copying of part or all of any file in the seminar.sty package is allowed under the following conditions only: (1) You may freely distribute unchanged copies of the files. Please include the documentation when you do so. (2) You may modify a renamed copy of any file, but only for personal use or use within an organization. (3) You may copy fragments from the files, for personal use or for use in a macro package for distribution, as long as credit is given where credit is due. You are NOT ALLOWED to take money for the distribution or use of these files or modified versions or fragments thereof, except for a nominal charge for copying etc. BUGS: Too many to list, and who knows what they are anyway. These files are all preliminary and unstable. Not responsible for neck injuries. Please report bugs, enhancements and other comments to Timothy Van Zandt tvz@Princeton.edu. Department of Economics Princeton University Princeton, NJ 08544 Thanks. CHANGES: v1.0: Included sem-a4.sty file, as a way to let the default papersize be A4 (The a4 option still works). Added \epsfslidesize to make it easier to set the slide of eps files with epsf.sty. Fixed bug which caused the width of second pages of a multi-page slide to end up too small if the page only contained a quote or similar environment with reduced margins. v0.93a: Fixed bugs so that slides would come out properly with the 2-up,article and portrait options (together), and so that slides would be positioned correctly with the portrait style option. v0.93: INCOMPATIBLE CHANGES: ! Use the a4 option instead of sem-a4. There is not longer a separate file for a4. ! No more \fewnotes, \nonotes. Use \slideplacement instead. ! No more \layerstyle, \overlaystyle. ! Slide styles are now "left" and "bottom". ! No more \ifslides. Use \ifarticle\else. ! You must now use the semlayer option to use overlays (in addition to the semcolor option). ! No "down" slide rotation (only "none", "left" and "right". ! portrait option is no longer a separate file. ! \paperwidth and \paperheight are now ordinary commands, to be set with \renewcommand. ! \slidefonts is now always invoked in slide environments, and never in the preamble. (But semhelv.sty and semlcmss.sty have changed to reflect this.) ! Method for customizing the slide frames has changed. \slideframecolor, \slideframearc, \slidefillcolor and \slideshadowcolor are obsolete. ! \landscape command replaced by \printlandscape to avoid conflict with other style files. (E.g., \def\printlandscape{\special{landscape}}). NEW FEATURES: + A slide environment can have multiple `pages'. \extraslideheight{len} controls page cutting. See user's guide for details. + \centerslidestrue (default) causes the contents of partially full slides to be vertically centered in the slide. \centerslidesfalse causes it to be flush top. + New \raggedslides[len] command, for setting whether right margin in slides is ragged or justified. Default is \raggedslides. \raggedslides[0pt] gives justified slides. + \slideplacement + \onlynotestoo + \slideskip and \slideshrink for added control over interline space. + New: \slideleftmargini, \slideleftmarginii, \slideleftmarginiii, \slidelabelsep, \slideitemsep, \slidepartopsep, \slideparskip, \slideparindent, \slidefootins, \slidefootnotesep, \slidedisplayskips, \theslidefootnote + \input and \endinput now supported for the slidesonly selection. + New conditional: \ifportrait + \newslideframe + \leftsliderotation, \rightsliderotation. + New \slidetopmargin, \slidebottommargin, \slideleftmargin, \sliderightmargin. + New notesonly* selection. + New \slidesclearpagetrue + New \semcm and \semin. + New note environment and \noxcomment command, as an alternative to treating everything outside slide environments as notes. BACKWARDS-COMPATIBLE CHANGES: * \maketitle now uses LaTeX's default from article.sty in notes. * Bug in article option with the \twoup command fixed. * \topmargin in sem-a4 changed from -.75in to 1in. * \slidefontsizes is obsolete (but still works). Use \ptsize instead. * Page parameters are now in a separate file sem-page.sty. sem-a4.sty has been changed to reflect this. v0.92: Mostly bug fixes, plus some extra options. The PSTricks package is no longer distributed with seminar.sty. Pre v0.91: Entirely rewritten. Too many changes to list. Note especially that system of formats and selections has changed. %% END sem-read.me