From 27aeb4a162a26f93ac0add986c18c69d456b0fed Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Sat, 15 Sep 2012 23:00:24 +0000
Subject: sandalone (15sep12)

git-svn-id: svn://tug.org/texlive/trunk@27677 c570f23f-e606-0410-a88d-b1316a301751
---
 .../source/latex/standalone/standalone.dtx         | 114 +++++++++++++++------
 1 file changed, 85 insertions(+), 29 deletions(-)

(limited to 'Master/texmf-dist/source/latex/standalone/standalone.dtx')

diff --git a/Master/texmf-dist/source/latex/standalone/standalone.dtx b/Master/texmf-dist/source/latex/standalone/standalone.dtx
index b7244871c83..4d42ed07be5 100644
--- a/Master/texmf-dist/source/latex/standalone/standalone.dtx
+++ b/Master/texmf-dist/source/latex/standalone/standalone.dtx
@@ -26,10 +26,10 @@
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesFile{standalone.dtx}[%
 %<=*DATE>
-    2012/05/20
+    2012/09/15
 %<=/DATE>
 %<=*VERSION>
-    v1.1a
+    v1.1b
 %<=/VERSION>
     DTX file of the standalone bundle]
 \documentclass[a4paper,11pt]{ydoc}
@@ -45,6 +45,7 @@
 \colorlet{keydesc}{opt}
 \OnlyDescription
 \lstset{numbers=none,columns=fullflexible}
+\def\Eurl#1{\edef\temp{{#1}}\expandafter\url\temp}
 \begin{document}
   \DocInput{\jobname.dtx}
   \PrintChanges
@@ -53,7 +54,7 @@
 %</driver>
 % \fi
 %
-% \CheckSum{3603}
+% \CheckSum{3606}
 %
 % \CharacterTable
 %  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -79,6 +80,7 @@
 % \changes{v1.1}{2012/05/05}{Fixed conversion issue with MiKTeX.}
 % \changes{v1.1a}{2012/05/20}{Failed conversion now always creates a normal output file. Some requested changes in the
 % manual.}
+% \changes{v1.1b}{2012/09/15}{Fixed issue with 'subpreambles' for Beamer documents.}
 %
 % \GetFileInfo{\jobname.dtx}
 %
@@ -123,6 +125,78 @@
 % \tableofcontents
 % \end{multicols}
 %
+% \section{Installation}
+% This package is part of the two main \LaTeX\ distributions \emph{TeX Live} and \emph{MikTeX} and can be easily installed
+% with their package managers. It is also provided as TDS ZIP file on CTAN which can be used for a manual install.
+% Other packages are also required as described in \autoref{sec:dep}.
+%
+% \subsection{Installation with TeX Live}
+% Using a normal TeX Live the package is easily installed using the package manager \texttt{tlmgr}.
+% The command \texttt{tlmgr install \csname @package\endcsname} will install it and \texttt{tlmgr update \csname
+% @package\endcsname} can be used to update it.
+%
+% Because the Ubuntu/Debian version of TeX Live may not include \texttt{tlmgr} a manual install of the package is
+% required. The author recommends to manually install the vanilla version of TeX Live instead which will include
+% regular package updates.
+%
+% \subsection{Installation with MikTeX}
+% The package can be easily installed using the MikTeX package manager as described by
+% \url{http://docs.miktex.org/manual/pkgmgt.html}. The MikTeX package name is identical to the normal package name.
+%
+% \subsection{Manual Installation from CTAN}
+% The package is also available on the Comprehensive TeX Archive Network (CTAN), both as the DTX/INS files and as TDS
+% ZIP file, which can be used for a manual install. A manual install is only required if the used distribution does not
+% include the (required version of the) package.
+%
+%
+% \subsubsection{Installation from TDS ZIP file}
+% The TDS (\TeX\ Directory Structur) ZIP file includes all package files in the final form and relative location.
+% It can be downloaded from CTAN: \Eurl{http://mirrors.ctan.org/install/macros/latex/contrib/\csname @package\endcsname.tds.zip} and from the Bitbucket project site \Eurl{https://bitbucket.org/martin_scharrer/standalone/downloads/\csname @package\endcsname.tds.zip}.
+% It needs only to be unzipped in a TEXMF directory. Under Linux/Unix this is usually the user TEXMF directory
+% \path{~/texmf}.
+% Under Windows it is usually \path{C:\Users\<user name>\texmf} (Windows Vista/7) or \path{C:\Documents and
+% Settings\<user name>\texmf} (Windows XP).
+% Under Mac OS X it is usually \path{/Users/<user name>/Library/texmf}.
+% Alternatively a system local directory can be used which is usually given by the environment variable
+% \texttt{TEXMFLOCAL}.
+% After the files are copied to this location the file name database of \TeX\ might need to be updated.
+% This can be done with TeX Live by running \texttt{texhash <path>} or \texttt{mktexlsr <path>}.
+% MikTeX provides a graphical interface to refresh its file name database as described by
+% \url{http://docs.miktex.org/manual/configuring.html#fndbupdate}.
+%
+%
+% \subsubsection{Installation from DTX File}
+% The package is also provided as DTX (Documented TeX file) which is accompanied by an INS (Install) file
+% under \Eurl{http://www.ctan.org/tex-archive/macros/latex/contrib/\csname @package\endcsname}.
+% To unpack all package files from the DTX file compile the INS file with |tex| once.
+% The manual can be compiled from the DTX file with |pdflatex|. This requires the \pkg{ydoc} bundle to be installed.
+%
+%
+% \subsection{Dependencies}\label{sec:dep}
+% The \cls{standalone} class and package require the \pkg{xkeyval} package.
+% The packages \pkg{ifpdf}, \pkg{ifluatex} and \pkg{ifxetex} are loaded if available, otherwise some fall-back code is used.
+% If enabled the class options \opt{varwidth}, \opt{preview} and \opt{beamer} require the package or class of the same name.
+%
+% The \pkg{standalone} package requires the \pkg{currfile} package (which in turn uses \pkg{filehook}) to track the correct file names of
+% sub-files included using |\input|.
+% For the compilation support for included standalone files the \pkg{gincltex} and \pkg{filemod} packages are also required.
+%
+% To compile the documentation of \cls{standalone} the \cls{ydoc} bundle is required.
+%
+% All of these packages are included in recent versions of the TeXLive or MikTeX distributions and are freely available on \href{http://www.ctan.org/}{CTAN}.
+%
+% \section{Bug reports, feature requests and other feedback}
+% Bug reports, feature requests and other feedback about the \cls{standalone} bundle can be sent to the author
+% either by email to \href{mailto:martin@scharrer-online.de?subject=standalone:%20}{martin@scharrer-online.de}
+% or using the issue tracker for the bundle under \href{https://bitbucket.org/martin_scharrer/standalone/issues}.
+% Bug reports should include the used version of \cls{standalone} as well as the used \LaTeX\ format (|pdflatex|, |latex|, |xelatex|, etc.) and distribution including its version.
+% Usually a minimal example which recreate the issue is immensely helpful in analysing and solving any bug.
+% Please look for existing related issue tickets first and check the FAQ/troubleshooting in \autoref{sec:classfaq} first.
+% Issues related to the \opt{preview} class option should be compared with a direct use of the underlying \pkg{preview} package.
+%
+%
+% \clearpage
+%
 % \section{Introduction}
 % Larger \LaTeX{} documents can be split into multiple \TeX\ files which are then included in a main document with \cs{include}
 % for e.g.\ chapter files or \cs{input} for e.g.\ \TeX-coded pictures. Keeping pictures in their own sub-files improves readability
@@ -156,28 +230,6 @@
 % The packages required by each sub-file can be transfered automatically to the main document preamble using the options
 % listed in \autoref{sec:pkgoptions}.
 %
-% \subsection{Dependencies}
-% The \cls{standalone} class and package require the \pkg{xkeyval} package.
-% The packages \pkg{ifpdf}, \pkg{ifluatex} and \pkg{ifxetex} are loaded if available, otherwise some fall-back code is used.
-% If enabled the class options \opt{varwidth}, \opt{preview} and \opt{beamer} require the package or class of the same name.
-%
-% The \pkg{standalone} package requires the \pkg{currfile} package (which in turn uses \pkg{filehook}) to track the correct file names of
-% sub-files included using |\input|.
-% For the compilation support for included standalone files the \pkg{gincltex} and \pkg{filemod} packages are also required.
-%
-% To compile the documentation of \cls{standalone} the \cls{ydoc} bundle is required.
-%
-% All of these packages are included in recent versions of the TeXLive or MikTeX distributions and are freely available on \href{http://www.ctan.org/}{CTAN}.
-%
-% \subsection{Bug reports, feature requests and other feedback}
-% Bug reports, feature requests and other feedback about the \cls{standalone} bundle can be sent to the author
-% either by email to \href{mailto:martin@scharrer-online.de?subject=standalone:%20}{martin@scharrer-online.de}
-% or using the issue tracker for the bundle under \href{https://bitbucket.org/martin_scharrer/standalone/issues}.
-% Bug reports should include the used version of \cls{standalone} as well as the used \LaTeX\ format (|pdflatex|, |latex|, |xelatex|, etc.) and distribution including its version.
-% Usually a minimal example which recreate the issue is immensely helpful in analysing and solving any bug.
-% Please look for existing related issue tickets first and check the FAQ/troubleshooting in \autoref{sec:classfaq} first.
-% Issues related to the \opt{preview} class option should be compared with a direct use of the underlying \pkg{preview} package.
-%
 % \subsection{Version update and backwards compatibility}
 % The default behaviour of v1.x of the \cls{standalone} class is slightly different as the one of v0.x, but should result in the same output for the majority of standalone files.
 % In previous versions the \opt{preview} option was enabled by default, but since v1.0 the new, similar \opt{crop} option is now used.
@@ -3471,11 +3523,15 @@
 %
 % \begin{macro}{\sa@endinput}
 % Ends the input file and discards all remaining material on the same line.
-% The comment character is disabled to ensure that there is always a end-of-line character present.
+% To avoid issues with some user input like |%| after |\begin{document}| or
+% a changed |\endlinechar| it is reset and any remaining text is discarded
+% verbatim. This might also read the next line if the EOL of the current
+% one got already commented out.
 %    \begin{macrocode}
 \def\sa@endinput{%
-    \@makeother\%%
-    \@makeother\^^A%
+    \endlinechar`^^J\relax
+    \let\do\@makeother
+    \dospecials
     \sa@@endinput
 }%
 \def\sa@@endinput#1^^J{%
@@ -3551,7 +3607,7 @@
       }{}%
     \global\@namedef{subpreamble@\currfilepath}{}%
     \ifsa@printsubpreambles
-      \endlinechar=`\^^J%
+      \endlinechar=`\^^J\relax
     \else
       \endlinechar=\m@ne
     \fi
-- 
cgit v1.2.3

