From 3896a3ce963e514325035018b02583376d23aa6c Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 28 Feb 2012 00:34:17 +0000 Subject: lua-visual-debug generic (24feb12) git-svn-id: svn://tug.org/texlive/trunk@25517 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/luatex/lua-visual-debug/README | 25 +++++++++++ .../doc/luatex/lua-visual-debug/lvdebug-doc.pdf | Bin 0 -> 355891 bytes .../doc/luatex/lua-visual-debug/lvdebug-doc.tex | 49 +++++++++++++++++++++ .../doc/luatex/lua-visual-debug/sample-plain.pdf | Bin 0 -> 49370 bytes .../doc/luatex/lua-visual-debug/sample-plain.tex | 16 +++++++ .../doc/luatex/lua-visual-debug/sample.pdf | Bin 0 -> 99566 bytes .../doc/luatex/lua-visual-debug/sample.tex | 32 ++++++++++++++ 7 files changed, 122 insertions(+) create mode 100644 Master/texmf-dist/doc/luatex/lua-visual-debug/README create mode 100644 Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.pdf create mode 100644 Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.tex create mode 100644 Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.pdf create mode 100644 Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.tex create mode 100644 Master/texmf-dist/doc/luatex/lua-visual-debug/sample.pdf create mode 100644 Master/texmf-dist/doc/luatex/lua-visual-debug/sample.tex (limited to 'Master/texmf-dist/doc/luatex') diff --git a/Master/texmf-dist/doc/luatex/lua-visual-debug/README b/Master/texmf-dist/doc/luatex/lua-visual-debug/README new file mode 100644 index 00000000000..94fd2312ec9 --- /dev/null +++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/README @@ -0,0 +1,25 @@ +The LuaTeX package 'lua-visual-debug' shows boxes, glues, kerns and +penalties in the PDF output. + +Usage: + +LaTeX: + +\usepackage{lua-visual-debug} + +or (plain) + +\input lua-visual-debug + + + +Requirements: The package has only been tested with LuaTeX and + the formats plain and LaTeX. Other formats might work as well, + but other engines only show a warning message. + + +Copyright 2012 Patrick Gundlach (patrick@gundla.ch) +Public repository: https://github.com/pgundlach/lvdebug +Licensed under the MIT license. See the Lua file for details. +The idea is heavily inspired by Hans Hagen's http://pragma-ade.com/articles/art-visi.pdf + diff --git a/Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.pdf b/Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.pdf new file mode 100644 index 00000000000..62aa83bdfa1 Binary files /dev/null and b/Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.pdf differ diff --git a/Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.tex b/Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.tex new file mode 100644 index 00000000000..3655b96c1d1 --- /dev/null +++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.tex @@ -0,0 +1,49 @@ +\documentclass{article} +\usepackage{graphicx,listings,lmodern} +\newcommand\LuaLaTeX{Lua\LaTeX} + +\newcommand*\pgsmall{\fontsize{8.5}{8.7}\selectfont\ttfamily} +\lstset{basicstyle=\pgsmall, + basewidth=0.55em, + columns=fullflexible, + breakautoindent=true, + breaklines=true, + prebreak=, + postbreak=\mbox{$\hookrightarrow$}, +} + +\begin{document} +\title{The lua-visual-debug package (V0.2)} +\author{Patrick Gundlach} +% \address{patrick@gundla.ch} +\maketitle +\section{About} + +This package aids debugging your \TeX\ and \LaTeX\ document by drawing rectangles around boxes and rules where glue is inserted. Other items are marked as well: kerns, hyphenation points and penalties. + +\section{How to use} + +When you load the package \texttt{lua-visual-debug} in your \LuaLaTeX\ document (or use \verb|\input lua-visual-debug.sty| in plain \TeX), Lua\TeX\ will highlight boxes, penalties, glues and kerns in the PDF. This package requires you to process the document with \LaTeX\ (plain and LaTeX formats). + +\section{A \LaTeX\ example} +\lstinputlisting[language=tex]{sample.tex} + +\noindent yields \vspace{5mm} + +\noindent \includegraphics[width=\textwidth]{sample-crop.pdf} + +\section{A plain \TeX\ example} + +\lstinputlisting[language=tex]{sample-plain.tex} + +\noindent yields \vspace{5mm} + +\noindent \includegraphics{sample-plain-crop.pdf} + + +\section{Copying} + +Copyright 2012 Patrick Gundlach (patrick@gundla.ch), licensed under the MIT license. See the Lua file for details. + + +\end{document} diff --git a/Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.pdf b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.pdf new file mode 100644 index 00000000000..f77d7bf010c Binary files /dev/null and b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.pdf differ diff --git a/Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.tex b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.tex new file mode 100644 index 00000000000..da1e423238f --- /dev/null +++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.tex @@ -0,0 +1,16 @@ +\input lua-visual-debug.sty + +\hsize 3in \vsize 3in +\centerline{A centered line with \TeX} + +\vskip .5in + +A wonderful serenity has taken possession of my entire soul, like these sweet +mornings of spring which I enjoy with my whole heart. I am alone, and feel +the charm of existence in this spot, which was created for the bliss of souls +like mine. I am so happy, my dear friend, so absorbed in the exquisite sense +of mere tranquil existence, that I neglect my talents. + +$$\int_e^x=mc^2$$ + +\bye diff --git a/Master/texmf-dist/doc/luatex/lua-visual-debug/sample.pdf b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample.pdf new file mode 100644 index 00000000000..088303edca9 Binary files /dev/null and b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample.pdf differ diff --git a/Master/texmf-dist/doc/luatex/lua-visual-debug/sample.tex b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample.tex new file mode 100644 index 00000000000..7a0c75e4f36 --- /dev/null +++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample.tex @@ -0,0 +1,32 @@ +\documentclass{article} +\usepackage{lua-visual-debug} + +\usepackage{lmodern} +\setlength\textwidth{300pt} +\setlength\textheight{10cm} + +\begin{document} + +\section{A short story} + +A wonderful serenity has taken possession of my entire soul, like these sweet +mornings of spring which I enjoy with my whole heart. I am alone, and feel +the charm of existence in this spot, which was created for the bliss of souls +like mine. I am so happy, my dear friend, so absorbed in the exquisite sense +of mere tranquil existence, that I neglect my talents. + +\begin{itemize} + \item one + \item two + \item three +\end{itemize} + +\bgroup\fontsize{30}{34}\selectfont +\centerline{\TeX} +\egroup + +\vbox{\strut Hello}\kern .5cm\vbox{\strut World} + +\[ \int_e^x=mc^2 \] + +\end{document} -- cgit v1.2.3