screenplay update (20sep06)

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

4 files changed, 155 insertions, 168 deletions

diff --git a/Master/texmf-dist/doc/latex/screenplay/README b/Master/texmf-dist/doc/latex/screenplay/README
index e165ea11401..7d1f7640260 100644
--- a/Master/texmf-dist/doc/latex/screenplay/README
+++ b/Master/texmf-dist/doc/latex/screenplay/README
@@ -1,17 +1,32 @@
-This is a LaTeX .cls file to provide formatting as recommended by the 
+LaTeX2e .cls file to provide formatting as recommended by the
 Academy of Motion Picture Arts and Sciences.
 
-Potential users need to read the information from the Academy, and 
-a few example scripts, and draw their own conclusions.  The current 
-version of `screenplay.cls' (v 1.417 at time of writing) seems to me to be 
-`good enough' to produce a fair copy for the Nicholl Fellowships 
-Competition - if you do your part - which was the point of it (weeks ago 
-when I started!).  Whether ScriptTeX would, in fact, be a better solution 
-if I managed to get my head around it is another question.  It looks to 
-me, however, that installing ScriptTeX and modifying it will be more work 
-than using `screenplay.cls.' As a more generalised solution ScriptTeX 
-may be better though (but then again, is that the UNIX way?).
+Potential users need to read the information from the Academy,
+and a few example scripts, and draw their own conclusions.
+The current version of `screenplay.cls' (v 1.440 at time of
+writing) seems to me to be `good enough' to produce a fair
+copy for the Nicholl Fellowships Competition - if you do your
+part - which was the point of it (weeks ago when I started!).
 
-Academy:        http://www.oscars.org/nicholl/format.html
+Really we're attempting to emulate a typewriter with this -
+which TeX is not meant for!  So I doubt it can ever be perfect.
 
-ScriptTeX:      http://www.aidtopia.com/software/scripttex/index.html
+Read all the comments in the .cls file, they may help you out.
+
+Whether ScriptTeX would, in fact, be a better solution if I
+managed to get my head around it is another question.  It looks
+to me, however, that installing ScriptTeX and modifying it
+will be more of a pain than using `screenplay.cls.' As a more
+generalised solution ScriptTeX may be better though (but then
+again, is that the UNIX way?).
+
+Academy:
+	http://www.oscars.org/nicholl/format.html
+
+ScriptTeX:
+	http://www.aidtopia.com/software/scripttex/index.html
+
+-- 
+John Pate <johnny@dvc.org.uk>
+http://dvc.org.uk/
+Tue Sep 19 14:05:33 BST 2006
diff --git a/Master/texmf-dist/doc/latex/screenplay/example.tex b/Master/texmf-dist/doc/latex/screenplay/example.tex
index 2fa0120aa78..2cf6f5c2c35 100644
--- a/Master/texmf-dist/doc/latex/screenplay/example.tex
+++ b/Master/texmf-dist/doc/latex/screenplay/example.tex
@@ -1,11 +1,11 @@
-% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/example.tex,v 1.70 2006/09/17 07:45:50 johnny Exp $
+% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/example.tex,v 1.107 2006/09/18 21:17:06 johnny Exp $
 %
 
 \documentclass{screenplay}
 % http://dvc.org.uk/sacrific.txt/screenplay.cls
-% make sure you have the latest versions so they match
-% and the page-breaking is right
-% this example.tex was built for screenplay.cls v 1.417
+% make sure you have the latest version of this
+% file example.tex and screenplay.cls
+
 
 \begin{document}
 
@@ -22,9 +22,9 @@ Your address\\
 here if you're\\
 going postal\\
 UK\\
-\\
+\vspace{2ex} % skip a line
 +44~(0)131~999~9999\\
-johnny@dvc.org.uk%
+johnny@dvc.org.uk
 }
 %
 % ... or use ...
@@ -104,6 +104,8 @@ Brown walks in and goes to a console.
 
 He has a PARROT on his shoulder.
 
+The Parrot has an air of quiet insouciance.
+
 \begin{dialogue}{Fred}
 Switch the visual to main screen so we
 can get a good look.\end{dialogue}
@@ -111,70 +113,12 @@ can get a good look.\end{dialogue}
 They look up at the main screen.
 
 \begin{dialogue}[to John and Mark]{Fred}
-Lock on to that. Give me a Scanalysis.
-\dialbreak[to Tom]{Fred}
+Lock on to that.
+\dialbreak[to Tom]{Fred}%
 Establish planetary orbit, stationary
 above this thing.
 \end{dialogue}
 
-\begin{dialogue}{Mark}
-It seems to be solid with a high
-metallic content and be the source of
-the radio energy.
-\end{dialogue}
-
-\begin{dialogue}{John}
-The gravity map shows there's some kind
-of cavern directly beneath it.
-\end{dialogue}
-
-\begin{dialogue}{Fred}
-Get me the fullest details you can.
-Survey that cavern and see what you can
-make of it. Looks like this is what we
-came all the way to see.
-\end{dialogue}
-
-\begin{dialogue}{Brown}
-You'd better prep the Galileo for a
-planet-fall. Looks like we've got some
-digging to do. Unless Bliar objects
-that is.
-\end{dialogue}
-
-\begin{dialogue}{Fred}I didn't come all this way to see the
-first signs of alien life then turn
-around and ignore it.\paren{beat} I wonder how this
-will fit into Bliar's theology.\end{dialogue}
-
-\begin{dialogue}{Brown}
-Perhaps when you've done some digging
-we'll have some answers.\end{dialogue}
-
-\begin{dialogue}{Parrot}
-Or maybe more questions.
-\end{dialogue}
-
-
-
-\begin{dialogue}{Brown}
-Who said that?
-\end{dialogue}
-
-\begin{dialogue}[to radio]{Fred}
-Now hear this. Shuttle to be prepared
-for launch.
-\end{dialogue}
-\pagebreak%
-
-\intslug{Atlantis -- SHIP'S  HOLD}
-
-The Hold is large, has various piles of crates and
-equipment
-stored in it.       Near the door is a large coffin-shaped packing
-crate standing on its end.
-
-
 \intextslug[day]{in or out}
 Apparently some people do this.
 
@@ -194,8 +138,7 @@ It isn't the done thing to hyphenate for formatting purposes.
 Use the source, Luke.
 
 
-\intslug[illumination]{title over environment or centred title}
-
+\intslug[illumination]{title over}
 \begin{titleover}There's a titleover environment for dialogue-like layout if you're
 doing the "Star Wars" thing.\end{titleover}
 
@@ -218,7 +161,7 @@ http://www.oscars.org/nicholl/format.html
 
 \end{document}
 
-% $Id: example.tex,v 1.70 2006/09/17 07:45:50 johnny Exp $
+% $Id: example.tex,v 1.107 2006/09/18 21:17:06 johnny Exp $
 % +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=
 %
 % Copyright (C) 2006 John Pate <johnny@dvc.org.uk>
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:
diff --git a/Master/texmf-dist/tpm/screenplay.tpm b/Master/texmf-dist/tpm/screenplay.tpm
index a10429eb521..f00b8077b8b 100644
--- a/Master/texmf-dist/tpm/screenplay.tpm
+++ b/Master/texmf-dist/tpm/screenplay.tpm
@@ -3,19 +3,19 @@
   <rdf:Description about="http://texlive.dante.de/texlive/Package/screenplay.zip">
     <TPM:Name>screenplay</TPM:Name>
     <TPM:Type>Package</TPM:Type>
-    <TPM:Date>2006/09/17 23:08:00</TPM:Date>
+    <TPM:Date>2006/09/19 12:07:00</TPM:Date>
     <TPM:Version></TPM:Version>
     <TPM:Creator>karl</TPM:Creator>
     <TPM:Title>The screenplay package.</TPM:Title>
     <TPM:Description></TPM:Description>
     <TPM:Author></TPM:Author>
-    <TPM:Size>11121</TPM:Size>
+    <TPM:Size>17616</TPM:Size>
     <TPM:Build/>
-    <TPM:RunFiles size="10666">
+    <TPM:RunFiles size="11980">
 texmf-dist/tex/latex/screenplay/screenplay.cls
 texmf-dist/tpm/screenplay.tpm
     </TPM:RunFiles>
-    <TPM:DocFiles size="6950">
+    <TPM:DocFiles size="5859">
 texmf-dist/doc/latex/screenplay/README
 texmf-dist/doc/latex/screenplay/example.tex
     </TPM:DocFiles>