summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/luatex/lua-visual-debug
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/luatex/lua-visual-debug')
-rw-r--r--Master/texmf-dist/doc/luatex/lua-visual-debug/README25
-rw-r--r--Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.pdfbin0 -> 355891 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.tex49
-rw-r--r--Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.pdfbin0 -> 49370 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.tex16
-rw-r--r--Master/texmf-dist/doc/luatex/lua-visual-debug/sample.pdfbin0 -> 99566 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/lua-visual-debug/sample.tex32
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
new file mode 100644
index 00000000000..62aa83bdfa1
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/lvdebug-doc.pdf
Binary files 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
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample-plain.pdf
Binary files 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
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/lua-visual-debug/sample.pdf
Binary files 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}