summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/otherformats/psizzl
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-05-24 00:31:38 +0000
committerKarl Berry <karl@freefriends.org>2009-05-24 00:31:38 +0000
commit3db8854079e5f66bff8e115d3e53b74a9e6b1b94 (patch)
treec76f77b61118c210746b2b9a513369908249ae7e /Master/texmf-dist/doc/otherformats/psizzl
parent631b5bbb9b2878fe0c658883d594124839413456 (diff)
move doc for lesser-used formats to subdirs
git-svn-id: svn://tug.org/texlive/trunk@13440 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/otherformats/psizzl')
-rw-r--r--Master/texmf-dist/doc/otherformats/psizzl/base/psizzl.commands312
-rw-r--r--Master/texmf-dist/doc/otherformats/psizzl/base/psizzl.doc41
2 files changed, 353 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/otherformats/psizzl/base/psizzl.commands b/Master/texmf-dist/doc/otherformats/psizzl/base/psizzl.commands
new file mode 100644
index 00000000000..a2737cce66c
--- /dev/null
+++ b/Master/texmf-dist/doc/otherformats/psizzl/base/psizzl.commands
@@ -0,0 +1,312 @@
+ PSIZZL COMMANDS - reference manual
+
+ Reference guide to Psizzl macros
+ This is a list of all the user macros in Psizzl.
+ They are grouped logically according to function.
+
+MACROS
+
+These macros are general-purpose macros used
+everywhere in Psizzl, or are of general interest.
+ \Psizzl - this gives the logo: Psizzl
+ \diagnostics - turns on tracing diagnostics
+ \endpage - causes a page break
+ \underscore#1 -
+ gives the argument, \underscore{{\it underscored}}
+ \leaderfil - gives leaders of dots:\hbox to 1in{(\leaderfil)}
+ \centertitle#1 - along with |\breaktitle|, below, gives a centered
+ title, whose line breaks are controlled by the user
+ \breaktitle - to be used with |\centertitle| to break the lines
+ \monthdayyear - causes the date used in \Psizzl macros to appear
+ as {\sl ``month day, year''}, instead of {\sl ``day month year''},
+ which is the default.
+ \date#1 - sets the date to the argument. See also |\letterdate| and
+ |\pubdate|.
+ \loosepar - To be used to terminate any paragraph which
+ has an overfull |\hbox|, due to the line breaker not working.
+ \unlock - To ``unlock'' the macros, so that the character `|@|'
+ may be used in macro names.
+ \lock - To undo |\unlock|.
+
+ \adddef#1#2 - adds #2 to the \def of #1
+ \bumpcount#1 - increases the absolute value of \count#1 by 1
+ \numorroman#1 - expands to arabic if \count#1 is positive, and to
+ roman if \count#1 is negative
+ \lapcomma - gives a comma which will overlap the chracter to the left
+ \translate#1#2#3 - causes TeX to typeset the object specified by #3
+ at the postion specified by X = #1 and Y = #2 relative to the
+ current postion. The current position is not, however, changed.
+ \iftemp - this is a `scratch' switch. It can be used at any time.
+
+LISTS
+
+These are the macros pertaining to lists.
+ \itembegin#1 - Starts an itemized list and sets the symbol to the
+ argument.
+ \item - Makes an entry in an itemized list with the current symbol.
+ \itemcon - Continues an item in a list starting with a new paragraph.
+ \itemset#1 - sets the symbol to #1, but does not begin an item.
+
+ \sitembegin#1 - Similar to |\itembegin|, for a subitem.
+ \sitem - Similar to |\item|, for a subitem.
+ \sitemcon - Similar to |\itemcon|, for subitem.
+ \sitemset#1 - Similar to |\itemset|, for a subitem.
+
+ \ssitembegin#1 - Similar to |\itembegin|, for a subsubitem.
+ \ssitem - Similar to |\item|, for a subsubitem.
+ \ssitemcon - Similar to |\itemcon|, for subsubitem.
+ \ssitemset#1 - Similar to |\itemset|, for a subsubitem.
+
+ \pointbegin - Start a sequential list of points.
+ \point - Put another item in a seqential list.
+ \pointcon - Like |\itemcon| for a sequentail list.
+
+ \spointbegin - Like |\pointbegin|, for a sublist.
+ \spoint - Like |\point|, for a sublist.
+ \spointcon - Like |\pointcon|, for a sublist.
+
+ \sspointbegin - Like |\pointbegin|, for a subsublist.
+ \sspoint - Like |\point|, for a subsublist.
+ \sspointcon - Like |\pointcon|, for a subsublist.
+
+PICTURE
+These macros facilitate making pictures.
+ \blankbox#1#2 - Makes a blank box of the specified dimensions.
+ \scalein - An inch dimension which magnifies with the type size.
+ \boxit#1 - Put a box around the argument.
+ \picture#1#2 - Currently just |\blankbox|.
+
+FONTDEFS
+These define the fonts used in \Psizzl.
+% `X' denotes that the font is loaded
+% suffixes: rm ss fib i it bf sy sl ss tt x caps
+% prefixes:
+% \twelve X X X X X X X X X X X
+% \ten X X X X X X X X X X X
+% \eight X X X X X
+% \seven X X X X
+% \five X X X X
+
+% e.g.: \twelverm is a roman font at 12 point
+% \tencaps is a cap/smallcap font at 10 pt
+
+% Plus the following special fonts:
+% \fortyss
+% \fifteenrm
+% \fourteenrm
+% \tenex
+The following macros are defined in this file:
+
+ \singlespace - Set to single spaced lines.
+ \normalbaselines - Set to one-and-one-half spaced lines.
+ \doublespace - Set to double spaced lines.
+ \largetype - Set to large type size.
+ \mediumtype - Set to medium type size.
+
+OPTIONS
+These macros turn on various switches, which control how
+certain options are used in \Psizzl depending on what publication
+you are writing for.
+
+ \APS - American Physical Society.
+ \IEEE - IEEE.
+ \NIM - Nuclear Instruments and Methods.
+ \NPB - Nuclear Physics B.
+ \PRL - Phys. Rev. Letters.
+ \PRD - Phys. Rev. D.
+ \PL - Physics Letters.
+ \illn#1 - when in |\proof| mode, it expands to ``Illn. #''
+ \draft - Specifies that this is a draft.
+ \preprint - Specifies that this is a preprint.
+ \proof - Specifies that this is a proof copy.
+ \submit - Specifies that this will be submitted to a journal.
+ \foreign - selects specifications for non-APS journals
+ \journal - selects specifications for journal articles
+ \conference - selects specifications for conference proceedings
+ \ifdraft - flag: this is the draft style of a document
+ \ifproof - flag: this is the proof style of a document
+ \ifsubmit - flag: this is the submit style of a document
+
+OUTPUT
+These macros control how the output will appear on the page.
+ \ifdoubleside - flag: the document will be double sided
+ \ifquadside - flag: the document will be two-pages-per-leaf
+
+PUBLICAT
+These macros generate the title page of a publication,
+and indirectly invoke some switches.
+ \docspec#1 - document specifications. Appear in upper right of title
+ page
+ \contract#1 - Defines the contract to be cited.
+ \contracttrue - Specifies that the given contract is to be cited.
+ \title#1 - Title of the document.
+ \subtitle#1 - specify the subtitle of a document.
+ \authors#1 - Author list.
+ \institute#1 - The publishing institution.
+ \submittedto#1 - The journal to be submitted to.
+ \abstract#1 - The abstract.
+ \university#1 - Specify the university of the thesis student
+ \price#1 - Specify the price code of NTIS
+ \workingauthor#1 - Specify the working author.
+ \workingauthorbin#1 - Specify the mail stop of the working author.
+ \workingauthoraddress#1
+ {Specify the address of the workin g author.
+ \publicationstyle#1 - macros to be invoked at the beginning of the
+ publication
+ \publication - specify that document will be a publication
+ \thesisstyle#1 - macros to be invoked at the beginning of the thesis.
+ \thesis - specify that document will be a thesis
+ \reportstyle#1 - macros to be invoked at the beginning of a report.
+ \report - specify that document will be a report
+ \acknowledge#1 - specify the text of the acknowledgement
+ \begindocument - begin production of the specified document.
+ Title page, etc. are produced now.
+ \enddocument - end production of the document.
+ \sigpage#1#2#3#4#5 - specify details of signature page of a thesis.
+ \iffrontmatter - flag: the front matter of the document is to be
+ produced.
+ \ifabstractsigned - flag: the abstract page is to be signed.
+ \ifcopyright - flag: this document is to be copyrighted.
+
+MEMO
+These macros will cause a memo to be produced.
+ \memohead#1 - Specify the header of the memo.
+ Default is institution-dependent
+ \memodate#1 - Specify the date of the memo.
+ \memoto#1 - Who the memo is to.
+ \memofrom#1 - Who the memo is from.
+ \memosubject#1 - Specify the topic of the memo.
+ \beginmemo - To begin the memo.
+ \endmemo - To end the memo.
+ \memostyle#1 - Specify the style of the memo.
+
+LETTER
+These macros control how letters are made.
+ \letterdate#1 - Specify the date of the letter.
+ \salutation#1 - Specify the salutation.
+ \closing#1 - Specify the closing.
+ \typist#1 - Specify the initials of the typist.
+ \copiesto#1 - Specify the cc:
+ \MyRef#1 - Specify your reference number.
+ \YourRef#1 - Specify the receiver's reference number.
+ \breakletter - Break the page at this point.
+ \letterto#1#2 - Name and address of the receiver.
+ \letterfrom#1#2#3 - Specify the sender.
+ \everyletter#1 - Text to be included in every letter.
+ \beginletter - Begin the letter.
+ \endletter - End the letter.
+ \letterhead#1#2#3#4 - Specify the letterhead.
+ \postscript#1 - specify the postscript of the letter
+ \enclosure#1#2 - specify the enclosures of the letter
+ \prescript#1 - specify the prescript of the letter
+ \letterstyle#1 - macros to be invoked at the start of the letter
+ \ifletter - flag: for output routine: this is a letter
+ \ifletterhead - flag: a letterhead is to be produced. Default: true
+ \ifstreetaddress - flag: the street address of the institution
+ is to appear in the letterhead. default: false.
+ \ifwindowenvelope - flag: the address of the letter will be typeset
+ so that it will appear within the window of a window envelope.
+CHAPTERS
+The body of a document (be it publication, memo, or letter)
+are produced by these macros.
+ \beginbody - Begin the body of the paper.
+ \chapter#1 - Begin a new chapter.
+ \beginappendices - Subsequent |\chapter|s will be appendices.
+ \endbody - End the body. Get out list of references, \etc
+ \section#1 - Start a bew section.
+ \subsection#1 - Start a new subsection.
+ \subsubsection#1 - Start a new subsubsection.
+
+CITATION
+Citations such as references, figures, tables and equations are
+done by these macros.
+
+In the following macros,
+#1 is a valid TeX control squence name
+(`\' followed by alphabetic characters only: don't use any numerals!).
+
+Where the macros use `=', they are defining the mnemonic name, so
+\<NAME> must not have been previously defined. (Hint: use some CAPITALS).
+Once this has been done, the mnemonic name can be used with the macro
+without the `=' and following one (or three) arguments:
+e.g.: first use: `\cite\DrellYan={Private communication}'
+ second use: `\Reference\DrellYan\ has clearly shown....'
+
+In the reference, equation, and author address macros,
+#2 is the text of the respective thing being defined.
+
+ REFERENCES:
+ The following three macros set the style of the reference:
+ \superreference - References will be superscripted: `$^{#1}$'
+ \bracketreference - References will appear in brackets: `[#1]'
+ \parenreference - References will appear in parenthesis: `(#1)'
+
+ The following five macros define or cite references:
+ \cite#1=#2 - Define a new reference and put out, e.g.: `$^{#1}$'
+ \hideref#1=#2 - define a new reference, but don't put out any text.
+ This is how multiple references are produced.
+ \bareref#1=#2 - define a new reference, and put out #1 only (bare).
+ \reference#1=#2 - Define a new reference and put out `Ref.#1'
+ \Reference#1=#2 - Define a new reference and put out `Reference #1'
+
+ \refspec#1,#2(#3)
+ Specify a reference in a way that the journal style can switch.
+ \volyearpageref - |\refspec| will be: volume, year, page.
+ \cernref - References will appear in CERN's style.
+
+ EQUATIONS:
+ \equation#1=#2 - Define a new equation.
+ \Equation#1=#2 - Define a new equation.
+ \display#1=#2 - define a new equation and display it.
+
+ AUTHOR ADDRESS SPECIFICATION:
+ \authoraddress#1=#2 - define a new authoraddress
+ \presentaddress#1=#2 - define a new authoraddress
+ as `Present address: #2'
+ \addressreference - specify author addresses to be references
+ \addressfootnote - specify author addresses to be footnotes
+ \addressinline - specify author addresses to be inline
+
+ In the figure and table macros,
+ #2 is the title of the figure or table, which will appear in the
+ table of contents.
+ #2 and #3 concatenated together constitute the caption of the figure
+ or table.
+ #4 will be the contents of the figure or table itself.
+
+ FIGURES:
+ \figure#1=#2#3#4 - Define a new figure and put out `Fig.#1'
+ \Figure#1=#2#3#4 - Define a new figure and put out `Figure #1'
+ \iffigureembed - figures are to be imbedded into the text.
+ Default: true.
+
+ TABLES:
+ \table#1=#2#3#4 - Define a new table and put out `table #1'
+ \Table#1=#2#3#4 - Define a new table and put out `table #1'
+ \iftableembed - tables are to be embedded into the text.
+ Default: true.
+
+ MISC:
+ \hangpar#1#2 - starts a paragraph with hanging indentation.
+ \lowercasecite - Citations will be lower case, not upper.
+ \vita#1 - specify a curriculum vitae for this document
+ \hyphen - punctuation for equations and multiple references
+ \comma - punctuation for multiple references
+ \lapperiod - a period which overlaps to the left.
+
+
+VERBATIM
+These are the macros for verbatim scanning.
+ \begintt - Begin verbatim mode.
+ \endtt - End verbatim mode.
+ |stuff| - Verbatim mode, inline.
+ \listfile#1 - Make a listing of the specified file.
+ \iflistnumber - flag: \listfile produces a numbered listing.
+
+INDEX
+These are the macros for doing the index of a document.
+They can each turn into a ``silent'' index entry by doubling the `^'
+ ^\{text} - Ordinary index entry.
+ ^\|text| - A special term, index entry.
+ ^\|\text| - A control sequence, index entry.
+ ^\<text> - A bracketed concept, index entry.
diff --git a/Master/texmf-dist/doc/otherformats/psizzl/base/psizzl.doc b/Master/texmf-dist/doc/otherformats/psizzl/base/psizzl.doc
new file mode 100644
index 00000000000..b1c9b1469de
--- /dev/null
+++ b/Master/texmf-dist/doc/otherformats/psizzl/base/psizzl.doc
@@ -0,0 +1,41 @@
+PSIZZL DOC - introduction to Psizzl macros for TeX version 1.1
+
+This disk contains the TeX macro package PSIZZL.
+It is to be used in conjunction with Tex82 ver. 1.1
+
+To use these macros,
+prepare a TeX input file of filetype `TEX',
+and give the (CMS) command `TEX &PSIZZL <filename>',
+where <filename> is the name of your file.
+
+You may want to make a file called MYPSIZZL TEX,
+which would have your customized Psizzl macros on it.
+A dummy version of this file is provided.
+
+The file `PSIZZL ARCHLIST' contains a listing of all the distribution
+Psizzl files.
+
+A file `PSIZZL COMMANDS' gives a listing of the user commands in Psizzl,
+along with a discussion of how to use them.
+
+Models (templates) for various types of jobs, such as letters, memos,
+papers, reports, theses, chapters, lists, figures, tables, and references
+may be found in the files `* TEMPLATE'.
+These files may be edited directly into Psizzl input files.
+Note the file `PSIZZL TEMPLATE', which shows how to
+surround your file with the appropriate commands to run it.
+
+For CMS systems, there are two REXX exec files which, respectively
+carry on a dialog with the user to build Psizzl letters and memos.
+In addition, there is a file called `PSIZBILD' which builds the
+PSIZZL FMT file.
+
+A document describing these macros, ``Psizzl Macros'' is available
+as SLAC-REPORT-268 from the author,
+Arthur Ogawa, CLA B226, Bin 96, SLAC, Stanford, CA 94305,
+(415) 854-3300 X2698,
+vmid `OGAWA' at `SLACVM' on net `BITNET'.
+Future releases of Psizzl will have this paper online.
+
+Any problems, questions, suggestions for improvements, etc.
+should be sent to Ogawa.