diff options
author | Karl Berry <karl@freefriends.org> | 2012-02-28 00:34:17 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-02-28 00:34:17 +0000 |
commit | 3896a3ce963e514325035018b02583376d23aa6c (patch) | |
tree | b846e8081e3808d61fe8cc83f7c52da20cd1b473 /Master/texmf-dist/doc/luatex | |
parent | 1c9cfa88a38e47a75fd3a9d1cb19d81330927028 (diff) |
lua-visual-debug generic (24feb12)
git-svn-id: svn://tug.org/texlive/trunk@25517 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/luatex')
-rw-r--r-- | Master/texmf-dist/doc/luatex/lua-visual-debug/README | 25 | ||||
-rw-r--r-- | Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.pdf | bin | 0 -> 355891 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.tex | 49 | ||||
-rw-r--r-- | Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.pdf | bin | 0 -> 49370 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.tex | 16 | ||||
-rw-r--r-- | Master/texmf-dist/doc/luatex/lua-visual-debug/sample.pdf | bin | 0 -> 99566 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/luatex/lua-visual-debug/sample.tex | 32 |
7 files changed, 122 insertions, 0 deletions
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 Binary files differnew file mode 100644 index 00000000000..62aa83bdfa1 --- /dev/null +++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.pdf 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 Binary files differnew file mode 100644 index 00000000000..f77d7bf010c --- /dev/null +++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.pdf 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 Binary files differnew file mode 100644 index 00000000000..088303edca9 --- /dev/null +++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample.pdf 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} |