truncate own pkg (12jun10)

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

8 files changed, 176 insertions, 2 deletions

diff --git a/Master/texmf-dist/doc/latex/truncate/miscdoc.sty b/Master/texmf-dist/doc/latex/truncate/miscdoc.sty
new file mode 100644
index 00000000000..da1f2a5fdba
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/truncate/miscdoc.sty
@@ -0,0 +1,115 @@
+\ProvidesPackage{miscdoc}[2010/01/20 v1.2 documentation macros misc latex pkgs]
+
+% miscdoc.sty
+% Copyright 2010 Robin Fairbairns
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+%   http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+% 
+% The Current Maintainer of this work is Robin Fairbairns.
+%
+% This work consists of the file miscdoc.sty (only)
+
+\setcounter{errorcontextlines}{1274}
+
+% The package arose from a small exercise to document packages whose
+% previous documentation consisted solely of comments in the package files.
+% The macros here defined are lifted from the author's faq.sty
+% (written for the UK TeX FAQ, CTAN:help/uk-tex-faq) or are inspired
+% by others' work (credited where the author is known) ... except
+% where they came as a flash of inspiration while actually writing the
+% documentation.
+
+% this option suggested by Heiko Oberdiek, 2010-01-29
+\DeclareOption{hyper}{%
+  \AtEndOfPackage{%
+    \RequirePackage[pdfusetitle]{hyperref}
+    \RequirePackage{bookmark}
+    \bookmarksetup{numbered,open,openlevel=1}
+  }
+}
+\ProcessOptions\relax
+
+% note: T1 encoding assumed
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{booktabs}
+
+% from faq.sty
+\newcommand\cs[1]{\texttt{\char`\\#1}}
+\let\csx\cs
+\def\bsbs{\cs{\char`\\}}
+
+% \cmdinvoke\cs<argument sequence>
+% \cs typeset as above
+% <argument sequence> may consist of optional or mandatory arguments;
+%
+% the `arguments' are simply typesett \texttt, as yet -- if something
+% fancier is needed, there's a bunch of code needs rewriting here...
+\DeclareRobustCommand\cmdinvoke{\@ifstar
+  {\let\@tempa\emph\@scmdinvoke}%
+  {\let\@tempa\relax\@scmdinvoke}%
+}
+\def\@scmdinvoke#1{\texttt{\symbol{92}#1}%
+  \futurelet\@let@token\@cmdinvoke
+}
+\def\@cmdinvoke{\ifx\@let@token\bgroup
+    \let\@tempb\@cmdinvoke@lbrace
+  \else
+    \ifx\@let@token[% ]
+      \let\@tempb\@cmdinvoke@lbrack
+    \else
+      \ifx\@let@token(% )
+        \let\@tempb\@cmdinvoke@lparen
+      \else
+        \let\@tempb\@empty
+      \fi
+    \fi
+  \fi
+  \@tempb
+}
+\def\@cmdinvoke@lbrace#1{\penalty0\hskip0pt\relax
+  \texttt{\symbol{123}\@tempa{#1}\symbol{125}}%
+  \futurelet\@let@token\@cmdinvoke
+}
+\def\@cmdinvoke@lbrack[#1]{\penalty-150\hskip0pt\relax
+  \texttt{[\@tempa{#1}]}%
+  \futurelet\@let@token\@cmdinvoke
+}
+\def\@cmdinvoke@lparen(#1){\penalty-150\hskip0pt\relax
+  \texttt{(\@tempa{#1})}%
+  \futurelet\@let@token\@cmdinvoke
+}
+% and extension -- versions that take a single extra (delimiter)
+% argument, such as \delcmdinvoke{lscrunge}( ... awful syntax, but...
+\DeclareRobustCommand\delcmdinvoke{\@ifstar
+  {\let\@tempa\emph\@sdelcmdinvoke}%
+  {\let\@tempa\relax\@sdelcmdinvoke}%
+}
+\def\@sdelcmdinvoke#1#2{\texttt{\symbol{92}#1#2}%
+  \futurelet\@let@token\@cmdinvoke
+}
+
+% sui generis
+\newcommand\newitem{\par\addvspace{1ex}\noindent}
+
+% inspired by doc.sty in latex distribution
+\newcommand\meta[1]{\ensuremath{\langle}\emph{#1}\ensuremath{\rangle}}
+
+% meaningful names, as in faq.sty
+\newcommand\environment[1]{\texttt{#1}}
+\newcommand\pkgoption[1]{\texttt{#1}}
+\newcommand\extension[1]{\texttt{.#1}}
+\newcommand\Package[1]{\textsf{#1}}
+\def\option{\@ifnextchar[\@optionb\@option}% ]
+\def\@optionb[#1]{{\normalfont\ttfamily[#1]}}
+\def\@option#1{\texttt{#1}}
+
+\let\FontName\textsf
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/truncate/truncate.pdf b/Master/texmf-dist/doc/latex/truncate/truncate.pdf
new file mode 100644
index 00000000000..f27ecf8690a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/truncate/truncate.pdf
diff --git a/Master/texmf-dist/doc/latex/truncate/truncate.tex b/Master/texmf-dist/doc/latex/truncate/truncate.tex
new file mode 100644
index 00000000000..412d183553c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/truncate/truncate.tex
@@ -0,0 +1,57 @@
+\documentclass[a4paper]{article}
+\usepackage[a4paper]{geometry}
+\usepackage{miscdoc}
+\usepackage[scaled=0.85]{luximono}
+\begin{document}
+\title{The \Package{truncate} package}
+\author{Donald Arseneau\thanks{Documentation file assembled by Robin
+    Fairbairns}}
+\date{August 2001, version 3.6}
+\maketitle
+
+\section*{Truncating text to a given width}
+
+The package defines a command
+\cmdinvoke{truncate}[\meta{marker}]{\meta{width}}{\meta{text}}
+
+If the text is too wide to fit in the specified width, then it is
+truncated, and a continuation marker is shown at the end.  The default
+marker, used when the optional \texttt{[marker]} parameter is omitted,
+is \cs{,}\cs{dots}.   You can change this default by redefining
+\cs{TruncateMarker}
+(\cmdinvoke{renewcommand}{\cs{TruncateMarker}}{\dots}).
+
+Normally, the text (whether truncated or not) is printed flush-left
+in a box with exactly the width specified.  The package option
+\option[fit] causes the output text to have its natural width, up to a
+maximum of the specified width.
+
+The text will not normally be truncated in the middle of a word,
+nor at a space specified by the tie (\verb|~|).  For example:
+\begin{quote}
+  \cmdinvoke{truncate}{122pt}{This text has been\string~truncated}
+\end{quote}
+gives
+\begin{quote}
+  ``This text has\dots~~~~~~''
+\end{quote}
+
+You can give one of the package options \option[hyphenate],
+\option[breakwords], or \option[breakall] to allow breaking in the
+middle of words.  The first two only truncate at hyphenation points;
+with the difference being that \option[breakwords] suppresses the
+hyphen character.  On the other hand, \option{breakall} allows
+truncation at any character.  For example:
+\begin{quote}
+  \cmdinvoke{truncate}{122pt}{This text has been\string~truncated}
+\end{quote}
+gives
+\begin{quote}
+  \begin{tabular}{l@{\quad}l}
+    ``This text has been trun-...''  & (option hyphenate) \\
+    ``This text has been trun...~''  & (option breakwords) \\
+    ``This text has been trunc...''  & (option breakall)
+  \end{tabular}
+\end{quote}
+(All of these options work through \TeX{}'s hyphenation mechanism.)
+\end{document}
diff --git a/Master/texmf-dist/tex/latex/ltxmisc/truncate.sty b/Master/texmf-dist/tex/latex/truncate/truncate.sty
index a4f0ed840cb..a4f0ed840cb 100644
--- a/Master/texmf-dist/tex/latex/ltxmisc/truncate.sty
+++ b/Master/texmf-dist/tex/latex/truncate/truncate.sty
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index 0607a40608f..8c388a5340f 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -310,7 +310,7 @@ my @TLP_working = qw(
     tkz-doc tkz-linknodes tkz-orm tkz-tab
     tocbibind tocloft tocvsec2 todo todonotes
     tokenizer toolbox tools totcount totpages tracking
-    trajan translator tree-dvips trfsigns trimspaces trivfloat trsym
+    trajan translator tree-dvips trfsigns trimspaces trivfloat trsym truncate
     tufte-latex tugboat tugboat-plain turkmen turnstile twoinone twoup txfonts
     txfontsb type1cm typedref typehtml typogrid
   uaclasses uebungsblatt ucdavisthesis ucs ucthesis uhrzeit uiucthesis
diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds
index 8c3a1ea0089..ee0bf90bad6 100755
--- a/Master/tlpkg/libexec/ctan2tds
+++ b/Master/tlpkg/libexec/ctan2tds
@@ -872,7 +872,6 @@ $standardtex='\.(.bx|cfg|sty|clo|ldf|cls|def|fd|cmap|4ht)$';
  'esint-type1',	'esint.tex',
  'europecv',	'EuropeFlag|europasslogo|\.cls|\.def',
  'fancytooltips',		'fancytipmark\..*|' . $standardtex,
- 'thesis-titlepage-fhac',	'LOGO.*|' . $standardtex,
  'figflow',	'\.tex',
  'fltpoint',	'\.sty|\.tex',
  'font-change',	'font.*\.tex',
@@ -983,6 +982,7 @@ $standardtex='\.(.bx|cfg|sty|clo|ldf|cls|def|fd|cmap|4ht)$';
  'taylor',	'diagrams.tex',
  'tex-ewd',	'dotnot.tex',
  'texsis',	'\.txs|TXS.*tex|texsis.tex',
+ 'thesis-titlepage-fhac',	'LOGO.*|' . $standardtex,
  'threeparttable',	'^..[^s].*\.sty', # not miscdoc.sty
  'ticket',	'\.tdf|' . $standardtex,
  'tikz-qtree',	'(pgf|tikz-)(subpic|q?tree(-compat)?)\.(tex|sty)',
@@ -991,6 +991,7 @@ $standardtex='\.(.bx|cfg|sty|clo|ldf|cls|def|fd|cmap|4ht)$';
  'tkz-orm',	'tkz.*\.sty',		# no pgfmanual.sty
  'tools',	'\.cfg|\.sty|\.clo|\.cls|\.def|\.fd$|.?\.tex|^\.tex$',
  'translator',	'\.dict|translator-language-mappings.tex|' . $standardtex,
+ 'truncate',	'^..[^s].*\.sty', 	# not miscdoc.sty
  'tugboat-plain','\.cmn|' . $standardtex,
  'underscore',	'^..[^s].*\.sty', 	# not miscdoc.sty
  'undolabl',	'\.sty|[^c]\.cfg',	# omit ltxdoc.cfg, would be system-wide
diff --git a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
index 2f50dd65f64..2a861e9daaa 100644
--- a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
@@ -655,6 +655,7 @@ depend trfsigns
 depend trimspaces
 depend trsym
 depend trivfloat
+depend truncate
 depend twoinone
 depend twoup
 depend type1cm
diff --git a/Master/tlpkg/tlpsrc/truncate.tlpsrc b/Master/tlpkg/tlpsrc/truncate.tlpsrc
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/truncate.tlpsrc