screenplay update (20sep06)

git-svn-id: svn://tug.org/texlive/trunk@2169 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 111 insertions, 82 deletions

diff --git a/Master/texmf-dist/tex/latex/screenplay/screenplay.cls b/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
index b59362ddbde..186a3ec309a 100644
--- a/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
+++ b/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
@@ -1,4 +1,6 @@
-% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/screenplay.cls,v 1.417 2006/09/16 20:56:57 johnny Exp $
+% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/screenplay.cls,v 1.440 2006/09/19 12:58:41 johnny Exp $
+%
+%
 % Provides markup mostly along the lines of
 % 	http://www.oscars.org/nicholl/format.html
 %
@@ -6,8 +8,6 @@
 % 	John Pate <johnny@dvc.org.uk>
 % 		http://dvc.org.uk
 %
-% See http://dvc.org.uk/sacrific.txt/example.tex
-%
 % See specs, licence, at end.
 % ``It works for me.''
 % I'm no kind of TeXpert! YOUR MILEAGE MAY VARY
@@ -38,7 +38,8 @@
 % see http://www.gwydir.demon.co.uk/jo/units/print.htm
 
 
-% MUST have Courier as font (may cause warnings about font stuff, ignore) ...
+% MUST have Courier as font (may cause warnings about
+% font stuff, ignore) ...
 %
 \usepackage{courier}
 \renewcommand*\familydefault{\ttdefault}
@@ -51,85 +52,109 @@
 
 % can load hyphenation ability for non-standard font ... 
 %\usepackage[htt]{hyphenat}
-% (comment out raggedright here and in dialogue & titleover envs) 
-% you really DO NOT want hyphenation
+% but DON'T, you should NOT hyphenate for Nicholl format
 % you want this ...
 %
 \raggedright
 %
-% between this and the typewriter font we're likely to
-% have to live with a few `Overfull \hbox' warnings
+% you'll have to nuke \raggedright wherever found to test out
+% hyphenation
+%
+% between this and the `fixed pitch' typewriter font we may
+% want to live with one or two `Overfull \hbox' warnings in
+% final copy (a word going into the right margin).  You will
+% likely have to add a few \\ to some of the dialogue text
+% blocks to help TeX out with linebreaks so the formatting
+% works, or you'll get extra space where you don't want it.
+%
+% LaTeX isn't really meant for fixed pitch but we're
+% pretending to be a typewriter here.
 
 
 % page numbers top right ...
-%
-\def\ps@myheadings{%
-    \let\@oddfoot\@empty\let\@evenfoot\@empty
-    \def\@oddhead{{\slshape\rightmark}\hfil\thepage}%
-    }
 \pagestyle{myheadings}
 
 
-% margins and such
-% fiddle if you must, see specs at end ... 
+% margins and such see specs at end ... 
+% -- fudge factors are apparent in `script.pdf' (use a ruler)
+% they're needed to approach the `correct' margins with tt font ...
 %
-% left margin, default 1in + ...
+% left margin 1.5", default 1" + ...
 \setlength{\evensidemargin}{0.5in}
 \setlength{\oddsidemargin}{0.5in}
 %
-% top margin ...
-\setlength{\topmargin}{-0.7in}
-\setlength{\headsep}{0.2in}
+% top margin (0.5" to number, 1" to body) ...
+\setlength{\topmargin}{-0.5in}
+\setlength{\headsep}{0.4in}
 \setlength{\topskip}{0in}
 %
-% reckon this gives a reasonable bottom margin ...
-\setlength{\textheight}{9.7in}
+% 11" - (1" top margin) - (0.5" bottom) = 
+\setlength{\textheight}{9.5in}
+% bottom can go to 1.5" for page breaking purposes
+%
+% 6" for 1" right margin ...
+\setlength{\textwidth}{6.1in}		% 0.1" fudge 
 %
-% 6in for 1in right margin ...
-\setlength{\textwidth}{6.0in}
+% tabbing / spacing for dialogues ...
+\newcommand{\dialwidth}{3.2in}		% 3" wide with 0.2" fudge
+\newcommand{\dialtab}{\hspace{1.5in}}	% 3" from left edge
+\newcommand{\dialnametab}{\hspace*{1.2in}}	% NAME, tab in 4.2" from left
+\newcommand{\parenwidth}{1.7in}		% parenthetical 1.5" with 0.2" fudge
+\newcommand{\parentab}{\hspace{0.7in}}	% paren, tab in 3.7" from left
 %
-% tabbing / spacing for dialogues 
-\newcommand{\dialwidth}{3.2in}
-\newcommand{\dialtab}{\hspace{1.5in}}
-\newcommand{\dialnametab}{\hspace*{1.2in}}
-\newcommand{\parenwidth}{2.1in}
-\newcommand{\parentab}{\hspace{0.7in}}
+% kludgy fix for formatting of parenthetical ...
+\newcommand{\parenkludge}{\vspace{5pt}}
+% multi-line parentheticals require this be in,  tested with
+% TeX 3.141592 (Web2C 7.5.4)
+% pdfeTeX 3.141592-1.21a-2.2 (Web2C 7.5.4)
+% kpathsea version 3.5.4
 
 
-% skip one line between paras ...
+% line spacing / pitch / parindent
 %
-\setlength{\parskip}{1.0em plus0.1em minus0.1em}
+% fixed pitch, 10pt ...
+\setlength{\baselineskip}{10pt plus 0pt minus 0pt}
+% LaTeX floats minipages and centring (I assume) so fix them ...
+\setlength{\floatsep}{\baselineskip}
+\setlength{\textfloatsep}{\baselineskip}
+\setlength{\intextsep}{\baselineskip}
 %
+% skip one line between paras ...
+\setlength{\parskip}{\baselineskip}
 % no paragraph indent ...
-%
 \setlength{\parindent}{0in}
 
 
 % for title page - author details ... 
 %
 % use one of \titleauthor, \nicholl, \titleextra to taste ...
-% this has to be the first command after \begin{document}
-% (if you shrink \textwidth you will need to adjust \hspace here)
+% this must be the first command after \begin{document}
+%
+% you may have to adjust the \vspace if you put in a lot of text
 %
 
 % \titleauthor[year]{title}{author's name}{contact details\\email etc}
-%  -- don't fuss about warnings if it looks OK
-% (the copyright notice doesn't fit the spec so optional... if you
-% put it on the web tho, copyright certainly won't hurt!)
+% [the copyright notice doesn't fit the spec so optional... if you
+% put it on the web tho, copyright certainly won't hurt!]
 %
 \newcommand{\titleauthor}[4][]{
-	\thispagestyle{empty}
-	\parbox{1em}{ \ }
-	\vspace{2.2in}
-	\begin{center}{\textbf{\MakeUppercase{#2}}\\}
-		\vspace{1em}by\\\vspace{1em}#3
+	\thispagestyle{empty} % no page number
+	\vspace*{2.25in}
+	\begin{center}{\textbf{\MakeUppercase{#2}}}\\
+		\vspace{\baselineskip}
+		by\\
+		\vspace{\baselineskip}
+		#3
 	\ifthenelse{\not\equal{#1}{}}
 	{
-	\\\vspace{1em}\scriptsize\copyright\normalsize#1\\
-	}{}
+	\\\vspace{\baselineskip}\scriptsize\copyright\normalsize#1%
+	\end{center}
+	\vspace{4.0in}
+	}{%
 	\end{center}
-	\vspace{4.25in}
-	\hspace{4.0in}\parbox{2.0in}{#4} 
+	\vspace{4.2in}
+	}
+	\hspace{4.0in}\parbox[t]{2.0in}{\raggedright#4} 
 % reset page numbers for actual blurb ...
 	\newpage\setcounter{page}{1}
 } %titleauthor
@@ -139,8 +164,7 @@
 %
 \newcommand{\nicholl}[1]{
 	\thispagestyle{empty}
-	\parbox{1em}{ \ }
-	\vspace{2.2in}
+	\vspace*{2.25in}
 	\begin{center}\MakeUppercase{#1}\end{center}
 % reset page numbers for actual blurb ...
 	\newpage\setcounter{page}{1}
@@ -149,17 +173,18 @@
 % \titleextra{extra blurb}{title}{author's name}{contact details\\email etc}
 % for title page - author details with extra blurb
 % not recommended by the Academy but by popular request, apparently
-%  -- don't fuss about warnings if it looks OK
+% some people like to put in copyright and WGA registration details
 %
 \newcommand{\titleextra}[4]{
 	\thispagestyle{empty}
-	\parbox{1em}{ \ }
-	\vspace{2.2in}
-	\begin{center}{\textbf{\MakeUppercase{#2}}\\}
-		\vspace{1em}by\\\vspace{1em}#3
-	\end{center}
-	\vspace{4.25in}
-	\parbox[t]{2.0in}{#1}\hspace*{2.0in}\parbox[t]{2.0in}{#4} 
+	\vspace*{2.25in}
+	\begin{center}{\textbf{\MakeUppercase{#2}}}\\
+		\vspace{\baselineskip}
+		by\\
+		\vspace{\baselineskip}
+		#3\end{center}
+	\vspace{4.2in}
+	\parbox[t]{2.0in}{\raggedright#1}\hspace*{2.0in}\parbox[t]{2.0in}{\raggedright#4} 
 % reset page numbers for actual blurb ...
 	\newpage\setcounter{page}{1}
 } %titleextra
@@ -173,7 +198,7 @@
 % only for _very short_ text (directions) within dialogue env
 %
 \newcommand{\paren}[1]{%
-\\\parentab\parbox{\parenwidth}{(#1)}\\
+\\\parentab\parbox[t]{\parenwidth}{\raggedright(#1)\parenkludge}\\
 } %paren
 
 
@@ -182,21 +207,20 @@
 % \begin{dialogue}[directions]{character name} ...  \end{dialogue}
 % \begin{dialogue}{character name} ...  \end{dialogue}
 %
-% also uses above parenthetical logic but without the newlines
 % minipage won't allow pagebreaks, see below for new manual
 % pagebreak command for this env
 % (you can centre the NAME but tabbing is more typewriter-esque)
 %
 \newenvironment{dialogue}[2][]{
 
-\dialtab\begin{minipage}{\dialwidth}
+\dialtab\begin{minipage}[b]{\dialwidth}
 \raggedright
-\dialnametab\hbox{\MakeUppercase{#2}}\\
+\dialnametab\hbox{\MakeUppercase{#2}}
 %\centerline{\MakeUppercase{#2}}
 \ifthenelse{\not\equal{#1}{}}
 {
-\parentab\parbox{\parenwidth}{(#1)}\\
-}{}
+\paren{#1}
+}{\\}
 }{ \end{minipage}
 
 }% end dialogue
@@ -207,7 +231,7 @@
 % \dailbreak[directions]{Character}
 %
 % (need to know character name -- LaTeX scoping rules don't seem to
-% like global vars, somebody tell me howto fix it)
+% like global vars, somebody tell me otherwise)
 % NOTE:
 % only do any manual pagebreaks when you absolutely positively
 % have killed every muthafucka in the room! ...
@@ -235,9 +259,10 @@
 
 \MakeUppercase{INT. #2}
 \ifthenelse{\not\equal{#1}{}}
-                {%
+                {% 1em = width of `M'
 \hspace{1em}\MakeUppercase{#1}
                 }{}
+\nopagebreak 
 
 }% intslug
  
@@ -251,6 +276,7 @@
                 {%
 \hspace{1em}\MakeUppercase{#1}
                 }{}
+\nopagebreak
 
 }% extslug
  
@@ -265,6 +291,7 @@
                 {%
 \hspace{1em}\MakeUppercase{#1}
                 }{}
+\nopagebreak
 
 }% intextslug
 
@@ -279,6 +306,7 @@
                 {%
 \hspace{1em}\MakeUppercase{#1}
                 }{}
+\nopagebreak
 
 }% extintslug
 
@@ -295,8 +323,9 @@ TITLE OVER (#1):\\
 }{%false
 TITLE OVER:\\
 }%ifthenelse
-\vspace{1em}
-\dialtab\begin{minipage}{\dialwidth}
+\vspace{\baselineskip}
+\nopagebreak
+\dialtab\begin{minipage}[b]{\dialwidth}
 \raggedright
 }{
 
@@ -321,9 +350,9 @@ TITLE OVER:\\
 \newcommand{\centretitle}[1]{
 
 TITLE OVER:
-
-\vspace{1.0em}
-\centerline{#1}
+\vspace{\baselineskip}
+\nopagebreak
+\centerline{#1}\\
 
 } %titleover
 
@@ -343,9 +372,9 @@ FADE IN:
 %
 \newcommand{\fadeout}{
 
-\vspace{-1.0em}
+\vspace{-\baselineskip}
 \begin{flushright}FADE OUT:\end{flushright}
-\vspace{-1.0em}
+\vspace{-\baselineskip}
 
 } %fadeout
 
@@ -354,9 +383,9 @@ FADE IN:
 %
 \newcommand{\intercut}{
 
-\vspace{-1.0em}
+\vspace{-\baselineskip}
 \begin{flushright}INTERCUT WITH:\end{flushright}
-\vspace{-1.0em}
+\vspace{-\baselineskip}
 
 } %intercut
 
@@ -376,22 +405,22 @@ FADE IN:
 % http://www.oscars.org/nicholl/format.html
 %
 % Letter paper 8.5"x11.0"
-% Courier 12pt
+% Courier 12pt, 10 pitch
 % 
 % PAGE
-% Top margin:	0.75"
-% Bottom margin:0.5"
+% Top margin:	1.0"
+% Bottom margin:0.5"-1.5"
 % Left margin:	1.5"
 % Right margin:	1.0"
 % 
 % DIALOGUE
-% centre NAME over dialogue
-%     or tab to 4.2"
+% centre NAME over dialogue (deprecated)
+% tab NAME to:	4.2"
 % Left margin:	3.0"
-% Right margin:	2.3"
-% 	Parenthetical
+% Right margin:	2.5"
+%   Parenthetical
 % Left margin:	3.7"
-% Right margin:	3.0"
+% Right margin:	3.3"
 % 
 % Numbering: Top Right, Arabic
 % Top margin:	0.5"
@@ -400,7 +429,7 @@ FADE IN:
 % INT/EXT. SLUG LINE DESCRIPTION   DAY/NIGHT
 %                               ^^^ some kind of extra spacing 
 %
-% $Id: screenplay.cls,v 1.417 2006/09/16 20:56:57 johnny Exp $
+% $Id: screenplay.cls,v 1.440 2006/09/19 12:58:41 johnny Exp $
 % +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=
 %
 % Latest version is available as: