new latex package texments (12oct08)

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

7 files changed, 257 insertions, 1 deletions

diff --git a/Master/texmf-dist/doc/latex/texments/README b/Master/texmf-dist/doc/latex/texments/README
new file mode 100644
index 00000000000..cb4be946633
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/texments/README
@@ -0,0 +1,4 @@
+The first public released version of texments is here, a package
+which allows to use the Pygments highlighter inside LaTeX documents.
+Pygments supports syntax coloring over 50 types of files and ships
+with multiple color schemes.
diff --git a/Master/texmf-dist/source/latex/texments/texments.dtx b/Master/texmf-dist/source/latex/texments/texments.dtx
new file mode 100644
index 00000000000..fea4d784b86
--- /dev/null
+++ b/Master/texmf-dist/source/latex/texments/texments.dtx
@@ -0,0 +1,146 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2008 by Marek Kubica <marek@xivilization.net>
+% -------------------------------------------------------
+% 
+% This file may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.2
+% 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.2 or later is part of all distributions of LaTeX 
+% version 1999/12/01 or later.
+%
+% \fi
+%
+% \iffalse
+%<*driver>
+\ProvidesFile{texments.dtx}
+%</driver>
+%<package>\NeedsTeXFormat{LaTeX2e}
+%<package>\ProvidesPackage{texments}
+%<*package>
+    [2008/10/10 0.1.0 The Pygments highligher accessible in LaTeX]
+%<package>\RequirePackage{fancyvrb}
+%<package>\RequirePackage{color}
+%</package>
+%
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage{texments}[2008/10/10]
+\usepackage{hyperref}
+\EnableCrossrefs
+\CodelineIndex
+\RecordChanges
+\begin{document}
+  \DocInput{texments.dtx}
+  \PrintChanges
+  \PrintIndex
+\end{document}
+%</driver>
+% \fi
+%
+% \CheckSum{27}
+%
+% \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
+%   Lower-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
+%   Digits        \0\1\2\3\4\5\6\7\8\9
+%   Exclamation   \!     Double quote  \"     Hash (number) \#
+%   Dollar        \$     Percent       \%     Ampersand     \&
+%   Acute accent  \'     Left paren    \(     Right paren   \)
+%   Asterisk      \*     Plus          \+     Comma         \,
+%   Minus         \-     Point         \.     Solidus       \/
+%   Colon         \:     Semicolon     \;     Less than     \<
+%   Equals        \=     Greater than  \>     Question mark \?
+%   Commercial at \@     Left bracket  \[     Backslash     \\
+%   Right bracket \]     Circumflex    \^     Underscore    \_
+%   Grave accent  \`     Left brace    \{     Vertical bar  \|
+%   Right brace   \}     Tilde         \~}
+%
+%
+% \changes{v0.0.1}{2008/10/10}{Initial version}
+% \changes{v0.1.0}{2008/10/10}{Properly repackaged}
+%
+% \GetFileInfo{texments.dtx}
+%
+% \DoNotIndex{\newcommand,\newenvironment}
+% 
+%
+% \title{The \textsf{texments} package\thanks{This document
+%   corresponds to \textsf{texments}~\fileversion, dated \filedate.}}
+% \author{Marek Kubica \\ \texttt{marek@xivilization.net}}
+%
+% \maketitle
+%
+% \section{Introduction}
+%
+% texments is a package that is used to connect the not-yet award winning
+% source code colorizer library Pygments (\url{http://pygments.org/})
+% with \LaTeX documents. That means that it is neccessary to have
+% Pygments installed and that the \texttt{pygmentize} command is 
+% available.
+%
+% \section{Usage}
+%
+% This package does not provide many fancy features, it is just meant
+% as an easy bridge between the highlighter and LaTeX. It calls
+% internally the \texttt{pygmentize} command, so you need to start it
+% with \texttt{-shell-escape} activated. Note that this might change
+% in the future.
+%
+% \DescribeMacro{\usestyle\marg{stylename}}
+% This macro needs to be called at least once to set the style that
+% pygments should use to highlight all code.
+%
+% One quite useful style is the ``bw'' style which is, as the name
+% somehow implies black and white.
+%
+% \usestyle{default}
+%
+% \DescribeMacro{\pygment\marg{language}\marg{code}}
+% To highlight a chunk of code, you can use the \texttt{pygment}
+% macro.
+%
+% An example for this is the following Python code:
+%
+% \pygment{python}{print "Hello World"}
+%
+% \StopEventually{}
+%
+% \section{Implementation}
+%
+% \begin{macro}{\usestyle}
+% This macro calls \texttt{pygmentize} with the appropriate style
+% name and gets the color definitions that will be used in all
+% following code listings.
+%    \begin{macrocode}
+\newcommand{\usestyle}[1]{
+  \immediate\write18{pygmentize -S #1 -f latex > \jobname.pyg}
+  \input{\jobname.pyg}
+}
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\pygment}
+% This macro takes the code in the second argument and feeds it
+% to \texttt{pygmentize}, so that it outputs code highlighted
+% to the rules of the first argument.
+%    \begin{macrocode}
+
+\newwrite\code
+\newcommand{\pygment}[2]{
+  \immediate\openout\code\jobname.pyg
+  \immediate\write\code{#2}
+  \immediate\closeout\code
+
+  \immediate\write18{pygmentize -l #1 -f latex -o \jobname.out.pyg \jobname.pyg}
+  \input{\jobname.out.pyg}
+}
+%    \end{macrocode}
+% \end{macro}
+%
+% \Finale
+\endinput
diff --git a/Master/texmf-dist/source/latex/texments/texments.ins b/Master/texmf-dist/source/latex/texments/texments.ins
new file mode 100644
index 00000000000..4010c43066d
--- /dev/null
+++ b/Master/texmf-dist/source/latex/texments/texments.ins
@@ -0,0 +1,59 @@
+%%
+%% Copyright (C) 2008 by Marek Kubica <marek@xivilization.net>
+%%
+%% This file may be distributed and/or modified under the conditions of
+%% the LaTeX Project Public License, either version 1.2 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.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+%%
+
+\input docstrip.tex
+\keepsilent
+
+\usedir{tex/latex/texments}
+
+\preamble
+
+This is a generated file.
+
+Copyright (C) 2008 by Marek Kubica <marek@xivilization.net>
+
+This file may be distributed and/or modified under the conditions of
+the LaTeX Project Public License, either version 1.2 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.2 or later is part of all distributions of LaTeX version
+1999/12/01 or later.
+
+\endpreamble
+
+\generate{\file{texments.sty}{\from{texments.dtx}{package}}}
+
+\obeyspaces
+\Msg{*************************************************************}
+\Msg{*                                                           *}
+\Msg{* To finish the installation you have to move the following *}
+\Msg{* file into a directory searched by TeX:                    *}
+\Msg{*                                                           *}
+\Msg{*     texments.sty                                          *}
+\Msg{*                                                           *}
+\Msg{* This package depends on pygmentize, be sure to install    *}
+\Msg{* this tool via your packet management system, look for     *}
+\Msg{* python-pygments or use easy_install Pygments              *}
+\Msg{*                                                           *}
+\Msg{* To produce the documentation run the file texments.dtx    *}
+\Msg{* through LaTeX with -shell-escape active.                  *}
+\Msg{*                                                           *}
+\Msg{* Happy TeXing!                                             *}
+\Msg{*                                                           *}
+\Msg{*************************************************************}
+
+\endbatchfile
diff --git a/Master/texmf-dist/tex/latex/texments/texments.sty b/Master/texmf-dist/tex/latex/texments/texments.sty
new file mode 100644
index 00000000000..2b920d11e13
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/texments/texments.sty
@@ -0,0 +1,44 @@
+%%
+%% This is file `texments.sty',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% texments.dtx  (with options: `package')
+%% 
+%% This is a generated file.
+%% 
+%% Copyright (C) 2008 by Marek Kubica <marek@xivilization.net>
+%% 
+%% This file may be distributed and/or modified under the conditions of
+%% the LaTeX Project Public License, either version 1.2 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.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+%% 
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{texments}
+    [2008/10/10 0.1.0 The Pygments highligher accessible in LaTeX]
+\RequirePackage{fancyvrb}
+\RequirePackage{color}
+\newcommand{\usestyle}[1]{
+  \immediate\write18{pygmentize -S #1 -f latex > \jobname.pyg}
+  \input{\jobname.pyg}
+}
+
+\newwrite\code
+\newcommand{\pygment}[2]{
+  \immediate\openout\code\jobname.pyg
+  \immediate\write\code{#2}
+  \immediate\closeout\code
+
+  \immediate\write18{pygmentize -l #1 -f latex -o \jobname.out.pyg \jobname.pyg}
+  \input{\jobname.out.pyg}
+}
+\endinput
+%%
+%% End of file `texments.sty'.
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index 9af9b4c9056..3c41706d08e 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -179,7 +179,7 @@ my @WorkingTLP = qw(
           pst-solides3d pst-soroban pst-spectra
           pst-slpe pst-stru pst-text pst-uml pst-vue3d
           pst2pdf pstool pstricks pstricks-add
-          psu-thesis ptptex pxfonts
+          psu-thesis ptptex pxfonts pygments
         qcm qstest quotmark qtree
         r_und_s randbild rccol rcs rcsinfo recipe recipecard
           refman refstyle regcount register resume robustcommand
diff --git a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
index 5c17a6f3801..db8f1465ae3 100644
--- a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
@@ -401,6 +401,7 @@ depend protocol
 depend psfragx
 depend pst-pdf
 depend pstool
+depend texments
 depend qcm
 depend qstest
 depend qsymbols
diff --git a/Master/tlpkg/tlpsrc/texments.tlpsrc b/Master/tlpkg/tlpsrc/texments.tlpsrc
new file mode 100644
index 00000000000..b686cd78fe1
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/texments.tlpsrc
@@ -0,0 +1,2 @@
+name texments
+category Package