screenplay update (19sep06)

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

5 files changed, 270 insertions, 17 deletions

diff --git a/Master/texmf-dist/doc/latex/screenplay/README b/Master/texmf-dist/doc/latex/screenplay/README
index 213e9bb6ff4..e165ea11401 100644
--- a/Master/texmf-dist/doc/latex/screenplay/README
+++ b/Master/texmf-dist/doc/latex/screenplay/README
@@ -1,3 +1,17 @@
-LaTeX .cls file to provide formatting as recommended by the Academy of Motion 
-Picture Arts and Sciences.  For more information, see 
-http://dvc.org.uk/sacrific.txt/
+This is a LaTeX .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?).
+
+Academy:        http://www.oscars.org/nicholl/format.html
+
+ScriptTeX:      http://www.aidtopia.com/software/scripttex/index.html
diff --git a/Master/texmf-dist/doc/latex/screenplay/example.tex b/Master/texmf-dist/doc/latex/screenplay/example.tex
new file mode 100644
index 00000000000..2fa0120aa78
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/screenplay/example.tex
@@ -0,0 +1,243 @@
+% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/example.tex,v 1.70 2006/09/17 07:45:50 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
+
+\begin{document}
+
+% cover page, this command has to go first ...
+%
+% choose one of \titleauthor, \titleextra, \nicholl ...
+
+% copyright year is [optional]
+% (apparently putting your copyright on things upsets studio moguls)
+\titleauthor[2006]
+{Example .tex}
+{John Pate}{%
+Your address\\
+here if you're\\
+going postal\\
+UK\\
+\\
++44~(0)131~999~9999\\
+johnny@dvc.org.uk%
+}
+%
+% ... or use ...
+% \titleextra{%
+% \copyright 2006 John Pate\\
+% ALL RIGHTS RESERVED 
+% }
+% {Example .tex}
+% {John Pate}{%
+% Your address\\
+% here if you're\\
+% going postal\\ \\
+% +44~(0)131~999~9999\\
+% http://dvc.org.uk\\%
+% johnny@dvc.org.uk%
+% }
+%
+% or for the Nicholl Fellowships ...
+% \nicholl{Example .tex}
+%
+
+% end cover page
+
+%
+% TeX allows quite a lot of leeway in whitespace, so I've messed this
+% up a bit.  I find keeping the format structured helps me a lot tho.
+% Note: but don't have blank lines *inside* the body of text in
+% a dialogue environment.
+% I use vi (Elvis) with macros to make a lot of typing disappear.
+% 
+% 
+% Anyhoo, on with the show ... 
+
+% for some reason this always happens at the start ...
+\fadein
+
+\intslug[illumination]{example sample -- screenplay.cls}
+
+
+\begin{dialogue}{Bob}
+That means that someone
+sabotaged the unit and killed the
+President! Was it one of us?
+\end{dialogue}
+\begin{dialogue}{Brown}
+Who else is mad but us, Condi~--
+and Bliar?
+\end{dialogue}
+
+Bob buries his head in his hands.
+\intercut
+
+\intslug{Atlantis -- somewhere ANyway}
+
+John and Mark are at adjacent consoles. Fred is with them. Tom
+is at another console slightly further away.
+
+\begin{dialogue}{John}
+The planetoid seems to have a thin crust
+covering a nickel-iron core. Could have
+been an Earth-like planet at one time.
+\end{dialogue}
+
+\begin{dialogue}{Mark}
+We're coming up on the radio source now.
+\end{dialogue}
+
+\begin{dialogue}{John}
+Are we?
+\end{dialogue}
+
+\begin{dialogue}{Mark}
+Yes.
+\end{dialogue}
+
+Brown walks in and goes to a console.
+
+He has a PARROT on his shoulder.
+
+\begin{dialogue}{Fred}
+Switch the visual to main screen so we
+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}
+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.
+
+\extintslug[night]{out or in}
+Or even this.
+
+\extslug[day or nite]{NO WARRANTY -- EXPRESS OR IMPLIED}
+
+\pov I made the slugline DAY/NIGHT optional 'cause in space no-one can
+tell the time.  You probably will need to specify.
+
+\nb  Don't put in pagebreaks by hand until you're really, really
+finished editing!
+
+It isn't the done thing to hyphenate for formatting purposes.
+
+Use the source, Luke.
+
+
+\intslug[illumination]{title over environment or centred title}
+
+\begin{titleover}There's a titleover environment for dialogue-like layout if you're
+doing the "Star Wars" thing.\end{titleover}
+
+\ldots or a centred title over\ldots
+
+\centretitle{http://dvc.org.uk/sacrific.txt/}
+
+\extslug[All Hail Discordia!]{where to find us}
+http://dvc.org.uk/sacrific.txt/example.tex\\
+http://dvc.org.uk/sacrific.txt/screenplay.cls
+
+\extslug[illumination]{for definitive info on layout}
+
+http://www.oscars.org/nicholl/format.html
+
+% and this always happens at the end ...
+\fadeout
+
+\theend
+
+\end{document}
+
+% $Id: example.tex,v 1.70 2006/09/17 07:45:50 johnny Exp $
+% +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=
+%
+% Copyright (C) 2006 John Pate <johnny@dvc.org.uk>
+% 
+% This text is free software; you can redistribute it and/or modify it
+% under the terms of the GNU General Public License as published by the
+% Free Software Foundation; either version 2 of the License, or (at your
+% option) any later version.
+% 
+% This text is distributed in the hope that it will be useful, but
+% WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+% or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+% for more details.
+% 
+% You should have received a copy of the GNU General Public License along
+% with this text; if not, write to the Free Software Foundation, Inc.,
+% 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+% 
+% GPL v2 text also available as:
+%       http://dvc.org.uk/gplv2.txt
+% 
+% +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=
diff --git a/Master/texmf-dist/tex/latex/screenplay/screenplay.cls b/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
index db0e0d8dc6c..b59362ddbde 100644
--- a/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
+++ b/Master/texmf-dist/tex/latex/screenplay/screenplay.cls
@@ -1,4 +1,4 @@
-% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/screenplay.cls,v 1.416 2006/09/16 18:50:37 johnny Exp $
+% $Header: /home/johnny/html/Sacrifice/LaTeX/RCS/screenplay.cls,v 1.417 2006/09/16 20:56:57 johnny Exp $
 % Provides markup mostly along the lines of
 % 	http://www.oscars.org/nicholl/format.html
 %
@@ -89,19 +89,11 @@
 \setlength{\textwidth}{6.0in}
 %
 % tabbing / spacing for dialogues 
-% dialwidth 0.1in bigger than spec for wiggle room ...
-\newcommand{\dialwidth}{3.3in}
+\newcommand{\dialwidth}{3.2in}
 \newcommand{\dialtab}{\hspace{1.5in}}
 \newcommand{\dialnametab}{\hspace*{1.2in}}
 \newcommand{\parenwidth}{2.1in}
 \newcommand{\parentab}{\hspace{0.7in}}
-%
-% no, really, if you're emulating a typewriter then running
-% past the right margin is realistic dontcha know
-% (plus I needed to squeeze away a page or two)
-% use ...
-%\newcommand{\dialwidth}{3.2in} 
-% ... to be absolutely spot on
 
 
 % skip one line between paras ...
@@ -408,7 +400,7 @@ FADE IN:
 % INT/EXT. SLUG LINE DESCRIPTION   DAY/NIGHT
 %                               ^^^ some kind of extra spacing 
 %
-% $Id: screenplay.cls,v 1.416 2006/09/16 18:50:37 johnny Exp $
+% $Id: screenplay.cls,v 1.417 2006/09/16 20:56:57 johnny Exp $
 % +=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=+=
 %
 % Latest version is available as:
diff --git a/Master/texmf-dist/tpm/screenplay.tpm b/Master/texmf-dist/tpm/screenplay.tpm
index 45267150bf1..a10429eb521 100644
--- a/Master/texmf-dist/tpm/screenplay.tpm
+++ b/Master/texmf-dist/tpm/screenplay.tpm
@@ -3,7 +3,7 @@
   <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/16 20:23:00</TPM:Date>
+    <TPM:Date>2006/09/17 23:08:00</TPM:Date>
     <TPM:Version></TPM:Version>
     <TPM:Creator>karl</TPM:Creator>
     <TPM:Title>The screenplay package.</TPM:Title>
@@ -11,11 +11,14 @@
     <TPM:Author></TPM:Author>
     <TPM:Size>11121</TPM:Size>
     <TPM:Build/>
-    <TPM:RunFiles size="10955">
+    <TPM:RunFiles size="10666">
 texmf-dist/tex/latex/screenplay/screenplay.cls
 texmf-dist/tpm/screenplay.tpm
     </TPM:RunFiles>
-    <TPM:DocFiles size="166">texmf-dist/doc/latex/screenplay/README</TPM:DocFiles>
+    <TPM:DocFiles size="6950">
+texmf-dist/doc/latex/screenplay/README
+texmf-dist/doc/latex/screenplay/example.tex
+    </TPM:DocFiles>
     <TPM:Provides>Package/screenplay</TPM:Provides>
   </rdf:Description>
 </rdf:RDF>
diff --git a/Master/texmf/lists/screenplay b/Master/texmf/lists/screenplay
index db957379e24..009f8cf30d4 100644
--- a/Master/texmf/lists/screenplay
+++ b/Master/texmf/lists/screenplay
@@ -1,4 +1,5 @@
 texmf-dist/doc/latex/screenplay/README
+texmf-dist/doc/latex/screenplay/example.tex
 
 texmf-dist/tex/latex/screenplay/screenplay.cls
 texmf-dist/tpm/screenplay.tpm