From 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 9 Jan 2006 00:49:07 +0000 Subject: doc/latex git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/changebar/00readme.txt | 25 ++ Master/texmf-dist/doc/latex/changebar/catalog.txt | 20 ++ .../texmf-dist/doc/latex/changebar/cbtest1-ltx.pdf | Bin 0 -> 94457 bytes .../texmf-dist/doc/latex/changebar/cbtest1-pdf.pdf | Bin 0 -> 94172 bytes Master/texmf-dist/doc/latex/changebar/cbtest1.tex | 322 +++++++++++++++++++++ .../texmf-dist/doc/latex/changebar/cbtest2-ltx.pdf | Bin 0 -> 94457 bytes .../texmf-dist/doc/latex/changebar/cbtest2-pdf.pdf | Bin 0 -> 94175 bytes Master/texmf-dist/doc/latex/changebar/cbtest2.tex | 322 +++++++++++++++++++++ .../texmf-dist/doc/latex/changebar/changebar.bug | 208 +++++++++++++ .../texmf-dist/doc/latex/changebar/changebar.pdf | Bin 0 -> 311114 bytes Master/texmf-dist/doc/latex/changebar/chbar.1 | 117 ++++++++ Master/texmf-dist/doc/latex/changebar/chbar.sh | 240 +++++++++++++++ Master/texmf-dist/doc/latex/changebar/manifest.txt | 24 ++ 13 files changed, 1278 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/changebar/00readme.txt create mode 100644 Master/texmf-dist/doc/latex/changebar/catalog.txt create mode 100644 Master/texmf-dist/doc/latex/changebar/cbtest1-ltx.pdf create mode 100644 Master/texmf-dist/doc/latex/changebar/cbtest1-pdf.pdf create mode 100644 Master/texmf-dist/doc/latex/changebar/cbtest1.tex create mode 100644 Master/texmf-dist/doc/latex/changebar/cbtest2-ltx.pdf create mode 100644 Master/texmf-dist/doc/latex/changebar/cbtest2-pdf.pdf create mode 100644 Master/texmf-dist/doc/latex/changebar/cbtest2.tex create mode 100644 Master/texmf-dist/doc/latex/changebar/changebar.bug create mode 100644 Master/texmf-dist/doc/latex/changebar/changebar.pdf create mode 100644 Master/texmf-dist/doc/latex/changebar/chbar.1 create mode 100644 Master/texmf-dist/doc/latex/changebar/chbar.sh create mode 100644 Master/texmf-dist/doc/latex/changebar/manifest.txt (limited to 'Master/texmf-dist/doc/latex/changebar') diff --git a/Master/texmf-dist/doc/latex/changebar/00readme.txt b/Master/texmf-dist/doc/latex/changebar/00readme.txt new file mode 100644 index 00000000000..d449aa29bea --- /dev/null +++ b/Master/texmf-dist/doc/latex/changebar/00readme.txt @@ -0,0 +1,25 @@ + changebar bundle + + September 19, 2005 + +This bundle contains a package that I maintain to add changebars to a +LaTeX document. + +It provides the changebar environment as well as the commands cbstart +and cbend. It uses \specials to communicate to the dvi driver where +the bars should be printed. + +The file chbar.sh which is part of this bundle was contributed. It can +be used to compare two versions of a document and automatically add +the changebars. +The file chbar.1, also contributed, documents the workings of chbar.sh + +Copyright (C) 2005 Johannes L. Braams texniek(at)braams.cistron.nl + +This program can be redistributed and/or modified under the terms +of the LaTeX Project Public License Distributed from CTAN +archives in directory macros/latex/base/lppl.txt; either +version 1.3 of the License, or any later version. + + + diff --git a/Master/texmf-dist/doc/latex/changebar/catalog.txt b/Master/texmf-dist/doc/latex/changebar/catalog.txt new file mode 100644 index 00000000000..78a56db94e5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/changebar/catalog.txt @@ -0,0 +1,20 @@ +Name: ChangeBar +Problems-To: texniek(at)braams.cistron.nl +Author: J.L. Braams +Version: 3.5 + +Description: + +This bundle contains a package that provides commands for adding +change bars to a document. It relies on \special commands. + +Keywords: latex, pdflatex, packages, changebars + +See-Also: + +Address: +TeXniek +J.L. Braams +Kersengaarde 33 +2723 BP Zoetermeer +The Netherlands diff --git a/Master/texmf-dist/doc/latex/changebar/cbtest1-ltx.pdf b/Master/texmf-dist/doc/latex/changebar/cbtest1-ltx.pdf new file mode 100644 index 00000000000..8581ac563b7 Binary files /dev/null and b/Master/texmf-dist/doc/latex/changebar/cbtest1-ltx.pdf differ diff --git a/Master/texmf-dist/doc/latex/changebar/cbtest1-pdf.pdf b/Master/texmf-dist/doc/latex/changebar/cbtest1-pdf.pdf new file mode 100644 index 00000000000..723471bab7b Binary files /dev/null and b/Master/texmf-dist/doc/latex/changebar/cbtest1-pdf.pdf differ diff --git a/Master/texmf-dist/doc/latex/changebar/cbtest1.tex b/Master/texmf-dist/doc/latex/changebar/cbtest1.tex new file mode 100644 index 00000000000..040518bbd94 --- /dev/null +++ b/Master/texmf-dist/doc/latex/changebar/cbtest1.tex @@ -0,0 +1,322 @@ +\documentclass[12pt,twoside]{article} +\usepackage{amsmath} +\usepackage[outerbars,color]{changebar} +\ifx\pdfoutput\undefined +\else\ifnum\pdfoutput>0 + \usepackage{pdfcolmk} +\fi\fi + +%\setcounter{changebargrey}{60} +\cbcolor{red} + +\usepackage{fancyhdr} + +%Header-footer instructions +\pagestyle{fancy} +\setlength{\headheight}{15pt} +\lhead{\scriptsize Changebar test file} +\chead{} +\rhead{v3.5} +\lfoot{Onecolumn text} +\cfoot{Page \thepage} +\rfoot{} +\renewcommand{\headrulewidth}{0.4pt} %print a rule below the header +\renewcommand{\footrulewidth}{0.4pt} %print a rule above the footer + +\setcounter{page}{16} +\setlength{\emergencystretch}{4em} + +\begin{document} + +%\tableofcontents + +\title{CHANGEBAR TEST FILE \\FOR ADVANCED FEATURES} +\author{Piet van Oostrum} +\maketitle + +\raggedbottom + +\begin {abstract} + +This file tests various advanced features of the changebar package. +\cbstart\textcolor{red}{\textbf{Text that should have a changebar is + printed in red, so that it can easily be checked that the changebars are + in the proper position.} This changebar should be on the left. +\cbend} + +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. +\end{abstract} + +\newpage + +This file tests various advanced features of the changebar package. +\cbstart\textcolor{red}{Text that should have a changebar (like this) is + printed in red, so that it can easily be checked that the changebars are + in the proper position.On this page, the changebar should be on the right. +\cbend} +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. + +\cbstart[3mm] \textcolor{red}{Here is a thicker changebar. Text that should + have a changebar (like this) is printed in red, so that it can easily be + checked that the changebars are in the proper position.On this page, the + changebar should be on the right. We also include a formula with large + descenders which should be completely covered by the changebar: + $\displaystyle \cfrac{1}{2+\cfrac{1}{3+\cfrac{1}{4+\cdots}}}$ + \cbend} + +\twocolumn +\lfoot{Twocolumn page} + +\section{Introduction} + +\cbstart +\color{red} +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. +\cbend +\color{black} + +\begin{figure} + \centering + \cbstart \color{red} + \fbox{ + \parbox{0.8\linewidth}{ + This is a figure. It has its + own changebar. This is a figure. This is a figure. It has its own + changebar. This is a figure. This is a figure. It has its own + changebar. This is a figure. This is a figure.\cbend}} + \color{black} + \caption{This is a test figure} +\end{figure} + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. + +\cbstart +\color{red} +Sections that have been added or modified are marked with a bar in +the margins. This is a small paragraph that crosses a column boundary. It +should have a changebar in both parts.\cbend +\color{black} + +\section{Continuation} +\cbstart +\color{red} + +\begin{figure} +\centering +\color{red} + \fbox{ + \parbox{0.8\linewidth}{ This is a figure. It inherits a changebar from + the environment. This is a figure. This is a figure. This is a + figure. This is a figure. It inherits a changebar from the + environment. This is a figure. This is a figure.}} +\caption{This is a test figure} +\color{black} +\end{figure} +\cbend +\color{black} + +\begin{figure}[p] +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. This is a figure. This is a figure. This is a figure. + This is a figure. This is a figure. This is a figure. This is a figure. + This is a figure. This is a figure. This is a figure. This is a figure. + This is a figure. This is a figure. This is a figure. This is a figure. + }} + \caption{Test figure} +\end{figure} + +\begin{figure}[p] +\cbstart \color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has its own changebar. This is a figure. It has + its own changebar. + This is a figure. It has its own changebar. This is a figure. It has + its own changebar. + This is a figure. It has its own changebar. This is a figure. It has + its own changebar. + }} \cbend\color{black} + \caption{Test figure} +\end{figure} + +\color{red} +\cbstart + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +This part contains a changebar that crosses several column and page +boundaries. Please note that it crosses several figures also but those have +their own changebars (or not), they do not fall inside the continuation +changebar. + +\enlargethispage{1cm} +\subsection{Enlarged column} + +\noindent\parbox{\linewidth}{% +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +\\ +\textbf{This column is enlarged, therefore its extends in the footer. +The changebar should also cover the extended text.}} + +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. + +\section*{Specific issues} + +\addtocounter{page}{1} +\textbf{Here we change the page number (skipping one page). Therefore we + have two even pages in a row. The page change is in the righthand column + which is not proper LaTeX coding, but it should be handled properly.} +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. + +This part contains a changebar that crosses several column and page +boundaries. Please note that it crosses several figures also but those have +their own changebars (or not), they do not fall inside the continuation +changebar. + + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. + +This part contains a changebar that crosses several column and page +boundaries. Please note that it crosses several figures also but those have +their own changebars (or not), they do not fall inside the continuation +changebar. + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +This part contains a changebar that crosses several column and page +boundaries. Please note that it crosses several figures also but those have +their own changebars (or not), they do not fall inside the continuation +changebar. \cbend +\color{black} The last sentence of this part is outside the changebar. +\\[1ex] + +\color{red}\cbstart +\noindent\fbox{\parbox[t]{0.95\linewidth}{% +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +}}\cbend\color{black} +\\[2cm] +There should be a lonely figure with a changebar at the right. +\end{document} + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: t +%%% End: diff --git a/Master/texmf-dist/doc/latex/changebar/cbtest2-ltx.pdf b/Master/texmf-dist/doc/latex/changebar/cbtest2-ltx.pdf new file mode 100644 index 00000000000..8581ac563b7 Binary files /dev/null and b/Master/texmf-dist/doc/latex/changebar/cbtest2-ltx.pdf differ diff --git a/Master/texmf-dist/doc/latex/changebar/cbtest2-pdf.pdf b/Master/texmf-dist/doc/latex/changebar/cbtest2-pdf.pdf new file mode 100644 index 00000000000..c80c8166671 Binary files /dev/null and b/Master/texmf-dist/doc/latex/changebar/cbtest2-pdf.pdf differ diff --git a/Master/texmf-dist/doc/latex/changebar/cbtest2.tex b/Master/texmf-dist/doc/latex/changebar/cbtest2.tex new file mode 100644 index 00000000000..1f53624e4e6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/changebar/cbtest2.tex @@ -0,0 +1,322 @@ +\documentclass[12pt,twoside]{article} +\usepackage{amsmath} +\usepackage[outerbars,xcolor]{changebar} +\ifx\pdfoutput\undefined +\else\ifnum\pdfoutput>0 + \usepackage{pdfcolmk} +\fi\fi + +%\setcounter{changebargrey}{60} +\cbcolor{red} + +\usepackage{fancyhdr} + +%Header-footer instructions +\pagestyle{fancy} +\setlength{\headheight}{15pt} +\lhead{\scriptsize Changebar test file} +\chead{} +\rhead{v3.5} +\lfoot{Onecolumn text} +\cfoot{Page \thepage} +\rfoot{} +\renewcommand{\headrulewidth}{0.4pt} %print a rule below the header +\renewcommand{\footrulewidth}{0.4pt} %print a rule above the footer + +\setcounter{page}{16} +\setlength{\emergencystretch}{4em} + +\begin{document} + +%\tableofcontents + +\title{CHANGEBAR TEST FILE \\FOR ADVANCED FEATURES} +\author{Piet van Oostrum} +\maketitle + +\raggedbottom + +\begin {abstract} + +This file tests various advanced features of the changebar package. +\cbstart\textcolor{red}{\textbf{Text that should have a changebar is + printed in red, so that it can easily be checked that the changebars are + in the proper position.} This changebar should be on the left. +\cbend} + +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. +\end{abstract} + +\newpage + +This file tests various advanced features of the changebar package. +\cbstart\textcolor{red}{Text that should have a changebar (like this) is + printed in red, so that it can easily be checked that the changebars are + in the proper position.On this page, the changebar should be on the right. +\cbend} +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. + +\cbstart[3mm] \textcolor{red}{Here is a thicker changebar. Text that should + have a changebar (like this) is printed in red, so that it can easily be + checked that the changebars are in the proper position.On this page, the + changebar should be on the right. We also include a formula with large + descenders which should be completely covered by the changebar: + $\displaystyle \cfrac{1}{2+\cfrac{1}{3+\cfrac{1}{4+\cdots}}}$ + \cbend} + +\twocolumn +\lfoot{Twocolumn page} + +\section{Introduction} + +\cbstart +\color{red} +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. +\cbend +\color{black} + +\begin{figure} + \centering + \cbstart \color{red} + \fbox{ + \parbox{0.8\linewidth}{ + This is a figure. It has its + own changebar. This is a figure. This is a figure. It has its own + changebar. This is a figure. This is a figure. It has its own + changebar. This is a figure. This is a figure.\cbend}} + \color{black} + \caption{This is a test figure} +\end{figure} + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. + +\cbstart +\color{red} +Sections that have been added or modified are marked with a bar in +the margins. This is a small paragraph that crosses a column boundary. It +should have a changebar in both parts.\cbend +\color{black} + +\section{Continuation} +\cbstart +\color{red} + +\begin{figure} +\centering +\color{red} + \fbox{ + \parbox{0.8\linewidth}{ This is a figure. It inherits a changebar from + the environment. This is a figure. This is a figure. This is a + figure. This is a figure. It inherits a changebar from the + environment. This is a figure. This is a figure.}} +\caption{This is a test figure} +\color{black} +\end{figure} +\cbend +\color{black} + +\begin{figure}[p] +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. This is a figure. This is a figure. This is a figure. + This is a figure. This is a figure. This is a figure. This is a figure. + This is a figure. This is a figure. This is a figure. This is a figure. + This is a figure. This is a figure. This is a figure. This is a figure. + }} + \caption{Test figure} +\end{figure} + +\begin{figure}[p] +\cbstart \color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has its own changebar. This is a figure. It has + its own changebar. + This is a figure. It has its own changebar. This is a figure. It has + its own changebar. + This is a figure. It has its own changebar. This is a figure. It has + its own changebar. + }} \cbend\color{black} + \caption{Test figure} +\end{figure} + +\color{red} +\cbstart + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +This part contains a changebar that crosses several column and page +boundaries. Please note that it crosses several figures also but those have +their own changebars (or not), they do not fall inside the continuation +changebar. + +\enlargethispage{1cm} +\subsection{Enlarged column} + +\noindent\parbox{\linewidth}{% +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +\\ +\textbf{This column is enlarged, therefore its extends in the footer. +The changebar should also cover the extended text.}} + +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. + +\section*{Specific issues} + +\addtocounter{page}{1} +\textbf{Here we change the page number (skipping one page). Therefore we + have two even pages in a row. The page change is in the righthand column + which is not proper LaTeX coding, but it should be handled properly.} +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. + +This part contains a changebar that crosses several column and page +boundaries. Please note that it crosses several figures also but those have +their own changebars (or not), they do not fall inside the continuation +changebar. + + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. + +This part contains a changebar that crosses several column and page +boundaries. Please note that it crosses several figures also but those have +their own changebars (or not), they do not fall inside the continuation +changebar. + +This file tests various advanced features of the changebar package. +This file contains the following features which in combinations used to +give problems in versions of changebar before version 3.5: +Twoside document, onecolumn and towcolumn text, figures, columns of +figures, page changes in the midst of a document. +It should work both with latex, followed by a supported Postscript driver, +and with pdflatex. + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +\begin{figure}[p] +\color{red} +\centering \fbox{\parbox{.9\linewidth}{ + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + This is a figure. It has a changebar from the environment. This is a + figure. It has a changebar from the environment. + }} + \caption{Test figure} +\end{figure} + +This part contains a changebar that crosses several column and page +boundaries. Please note that it crosses several figures also but those have +their own changebars (or not), they do not fall inside the continuation +changebar. \cbend +\color{black} The last sentence of this part is outside the changebar. +\\[1ex] + +\color{red}\cbstart +\noindent\fbox{\parbox[t]{0.95\linewidth}{% +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +This is a parbox. It should have a changebar along its total height. +}}\cbend\color{black} +\\[2cm] +There should be a lonely figure with a changebar at the right. +\end{document} + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: t +%%% End: diff --git a/Master/texmf-dist/doc/latex/changebar/changebar.bug b/Master/texmf-dist/doc/latex/changebar/changebar.bug new file mode 100644 index 00000000000..45a576a5202 --- /dev/null +++ b/Master/texmf-dist/doc/latex/changebar/changebar.bug @@ -0,0 +1,208 @@ +% Supported drivers sofar: +% dvitops (James Clark) +% dvips (Tom Rokicki) +% dvitoln03 (Brian {Hamilton Kelly}) +% emTeX (dvidrv) (Eberhard Mattes) +% VTeX (Michael Vulis) +% PDFTeX (Piet van Oostrum) +% +% change history +% +% Revisions: +% Support for twosided.sty added. January, 1987. +% +% Warning message added to indicate that another pass is +% required. May, 1987. +% +% Converted to work with dvitops. March 1990. +% Neil Winton (nwinton@axion.bt.co.uk) +% +% Usage by several drivers SPQR spqr@uk.ac.soton.ecs +% +% v2.0 22-11-90 JLB merged the original file with Niel Winton's mods +% now supports both DVI2LN3 and DVItoPS specials. This introduces +% one extra user-command, \device{}. If he says \device{PS} +% the PostScript \specials (DVItoPS by James Clark) will be used, +% anything else gives the original LN03 \specials. +% +% v2.1 06-04-91 SPQR changed the \ifPS statements to be case +% statements which check the value of a counter called \driver@setup, +% and issue specials accordingly. dvitops, dvips and LN03 are only +% drivers supported. +% v2.2 07-03-91 JLB Located all \specials in one place by defining +% the use of three new macros. Supplied a user command to select +% the driver and added code to \document for initializing the +% \special-macros. +% v2.2a 08-03-91 JLB \ps@scale needs a different value for DVItoPS and DVIPS +% so moved initialization of it inside \setup@specials +% v2.2b 08-03-91 JLB The definitions of the \connect macro needed extra +% \space commands, because its arguments can be control sequences. +% v2.2c 08-04-91 JLB Removed use of \cb@beginSaves and \cb@saveBeginPoint +% because - it didn't work as specified +% - seemed unnecessary +% - broke PostScript support because of use of \xdef +% \cb@processActive now calls \cb@setBeginPoint instead of +% \cb@saveBeginPoint. Left the code and comment in for now +% until I'm sure this change doesn't break anything else... +% v2.2d 30-4-91 EN changed resolution dependent parameters in dvips +% specials so it will work on any device using the device's resolution. +% Additionally added \newif\ifouterbars. \outerbarstrue will put +% the bars to the outside of the pages. +% Without the twoside option this will give right hand side bars. +% The positioning of right edge changebars was off by \changebarsep, +% this has been corrected also. +% I do not know if there are changes needed in other than Tom Rokicki's +% drivers since this is the only one I can test. +% v2.2e 13-6-91 JB The documentation stated that the greylevel of the +% changebar could be modified with the command +% \setcounter{\changebargrey}{percentage}. +% This was a mistake, \changebargrey was allocated using \newcount +% (always). Now modified to use \newcount for plain TeX and +% \newcounter for LaTeX. +% v2.2f 15-10-91 JB Added support for the emTeX drivers, based on +% information from Eberhard Mattes about version 1.4j of the dvidrv +% program. Also started updating the documentation towards doc.sty +% standards. +% v2.3 15-10-91 JB Started merging this version of changebar.sty with +% version, dated 1988, distributed with DVItoLN03. This will eventually +% result in version 3.0, hopefully documented using doc.sty. +% Removed vain attempt to make file compatile with plain. +% v2.4 16-10-91 JB Reduced the number of points defined to two per +% bar, removed the need for \cb@tempcnt while removing the problem +% with incorrect changebars across pageboundaries in PostScript +% mode. Also \ps@scale has been removed. +% v3.0 14-nov-91 JB Completed converting the documentation to doc.sty +% format. Also solved the problem with bars appearing on the wrong +% side. +% +% v3.1 02-07-93 JB Finally got round to include Erich Neuwirth's comments +% and made a new distribution. Erich corrected the placement of the +% bars and the conversion of the coordinates when DVIps (Rokicki) +% is used. Also included Hal Peterson's comments about spaces +% creeping into the output. +% +% v3.1b 11-10-93 Spurious white space crept into footnotes because of +% a missing %-sign. Found by Norm Walsh . +% Fixed. +% +% v3.2b 30-06-95 Finally got the LaTeX2e version working; see \changes +% entries in the .dtx file to see what changed. +% Changebar now uses the LaTeX option mechanism; so \driver +% disappeared. +% New options are leftbars and rightbars, tracon and traceoff. +% +% v3.2c 26-03-96 Reintroduced the \driver command in compatibility +% mode. Fixed the checksum. +% Juergen Vollmer enhanced +% the shell script which automatically adds changebar commands +% to your document. +% +% v3.3a 26-09-97 Finally fixed the diagonal bars by (re-)introducing +% four points for each bar (instead of two). Made it work with +% LaTeX's twocolumn option. Fixed positioning problems. +% +% v3.3b 30-09-97 It turns out that the emTeX driver and dvips have +% different ideas about their origin. Had to subtract 1 inch +% from horizontal positions for emTeX drivers. +% +% v3.3d 28-10-97 It now turns out that Xdvi shows the changebars with +% an offset of 1 inch; removed inappropriate pieces of code. +% +% v3.3e Added support for Textures (1.7.7), provided by James Ashton +% +% Added chbar.1 to the distribution. The file was provided by +% John A. Murdie +% +% v3.3i Changebar didn't pay enough attention to the setting of +% twoside. In onesided documents the value of \evensidemargin +% should be ignored. +% \cb@startSpanBars no longer pushes points on the current stack +% as this confused the algorithm and was wrong anyway. +% Introduced a tracing facility for the stack mechanisms +% Now use the history stack to determine the final page on which +% the beginning and ending of the changebars appear. This fixes +% most problems with floating objects and diagonal bars at page +% boundaries. +% Redefined \cbstart and \cbend in terms of the LaTeX +% environment. This catches wrong use of \cbstart ...\cbend with +% respect to TeX's grouping levels. +% +% v3.3j The rightbars option was broken; +% found by Richard Stanton" +% In the oneside mode \cb@even@right received no value instead +% \cb@even@left was set equal to \cb@odd@left and reset +% afterwards. +% +% v3.4a Michael Vulis submitted the code for VTeX support +% +% v3.4b Changebar and the color package clash; +% found by Erwin Achermann +% Because of the extra group and box level for floating objects. +% The redefinition in this package of \@endfloat didn't take +% that into account. +% repaired a few typos in the documentation. +% Introduced support for coloured changebars with the dvips +% driver. +% +% v3.4c small typo repaired +% +% v3.4d Autodetect VTeX and provide the right default driver; +% added possibility of having changebar.cfg to specify a default +% driver. +% Issue an error when \cbcolor is used when the color option +% isn't specified. +% +% v3.4e Double column floats didn't carry a change bar because the +% LaTeX macro \end@dblfloat wasn't adapted for changebar +% Changebars in the first column appeared twice because of +% an error in the conditional which decides where to put the +% bar. +% The color error is now a warning. +% Fixed a few typos. +% Reverted the change in the definition of \cbstart and \cbend +% as it prevented changebars starting inside an environment and +% ending outside of it. +% +% v3.4f Fixed a problem with \changebarwidth; it seemed to become +% hardwired due to a bug in the stack handling. \cb@checkpage +% effectively changed the value of \cb@curbarwd. +% +% v3.4g When the preamble of the document changes the value of the +% page counter the code gets confused when the new page number +% is even. Now initialize \cb@pagecount to \c@page - 1. +% The mechanism with \cb@pagecount and \cb@page may need a +% redesign to make it robust. +% +% v3.4h Herbert Voss (Herbert dot Voss at alumni dot TU-Berlin dot DE> +% suggested to support the xcolor package as well as the color +% package. +% +% v3.5a Piet van Oostrum: Resolved bugs in twocolumn mode, mid-document +% changes to page number, covering parts with large depth (like +% formulas and parboxes), added pdflatex support. +% +% v3.5b JLB: added an extra check (after the call to \ProcessOptions +% to ensure that pdftex.def is used when in pdf producing mode, +% even when the document still contains the option "dvips" +% +% v3.5c JLB: Add a small change in the TeXtures specific code that +% was submitted by Blue Sky Systems; made it work with both the +% color and xcolor packages. + +% Known problems +% - With PostScript a dictstack overflow seems to occur with +% many changebars. cb@maxpoint=20 seems to help +% - I have received the file chgbar.sty, which was written by +% David B. Johnson (dbj@titan.rice.edu) back in 1990. It uses +% LaTeX marginpar mechanism to implement change bars. I Haven't +% yet dared to see if I can merge these two packages into one +% - When using \cbstart with an optional parameter that is different +% from \changebarwidth the distance between the text margin and +% the changebar will not be \changebarsep. Instead, the center of +% the changebar will be aligned with the other changebars. The +% solution to this would be to give an additional parameter to the +% \cb@connect macro to indicat if the bar is on the left or on the +% right. \cb@connect can then do the proper positioning. In that +% case it is easier not to include the 0.5\changebarwidth +% correction in the calculations in \cb@positions. +% - The syntax \cbcolor[rgb]{1,0,0} doesn't work with the xcolor option. diff --git a/Master/texmf-dist/doc/latex/changebar/changebar.pdf b/Master/texmf-dist/doc/latex/changebar/changebar.pdf new file mode 100644 index 00000000000..cf92b71d360 Binary files /dev/null and b/Master/texmf-dist/doc/latex/changebar/changebar.pdf differ diff --git a/Master/texmf-dist/doc/latex/changebar/chbar.1 b/Master/texmf-dist/doc/latex/changebar/chbar.1 new file mode 100644 index 00000000000..f36e68e2bbb --- /dev/null +++ b/Master/texmf-dist/doc/latex/changebar/chbar.1 @@ -0,0 +1,117 @@ +.ds AL L\\v'.3m'A\\v'-.3m'\\*(ET +.TH CHBAR 1 TeX +.SH NAME +chbar \- write \*(AL file with `change bars' showing change between input \*(AL files +.SH SYNOPSIS +.B chbar +[ +.B \-h +] [ +.B \-g +] [ +.B \-G +] [ +.BI \-d " dir" +] [ +.BI \-r " rev" +] +.I old new +[ +.I output +] +.sp +.B chbar +[ +.B \-h +] [ +.B \-g +] [ +.B \-G +] [ +.BI \-d " dir" +] [ +.BI \-r " rev" +] +.I old +.sp +.B chbar +[ +.B \-h +] [ +.B \-g +] [ +.B \-G +] +.BI \-d " dir" +.BI \-r " rev" +.I files +.SH DESCRIPTION +.I chbar +takes two \*(AL files and produce a third which +has change bars highlighting the difference between them. There +are three basic modes of operation: first, pathnames can +be given for +.I old +and +.IR new ; +second, if only +.I old +is named, the +.I new +file is taken from standard input and the output is written to standard +output; thirdly, if the +.B \-r +option is used +.I files +held by RCS must be named - (see the explanation of the +.B \-r +option). +.sp +Change bars are inserted for differences after '\ebegin{document}'. +.SH OPTIONS +.TP +.BI \-d " dir" +Write the output to file +.IR dir/new , +if +.I new +is given or to file +.IR dir/old . +If +.I dir +does not exist, it is created. +If +.I output +is given, it is discarded. +.TP +.BI \-r " rev" +If the \*(AL +.I files +are kept under control of the Revision Control System RCS, the old files of +the revision +.I rev +can be retrieved. +.I rev +is specified using the RCS conventions. +This option must be used together with the +.BI \-d " dir" +option. +.I files +must be a nonempty list of files. +.TP +.B \-h +Print a help text. +.TP +.B \-g +Print some debugging info. +.TP +.B \-G +Even more debug info. +.SH SEE ALSO +.IR diff (1), +.IR rcs (1) +.SH BUGS +The +.I new +file can not be named `-'. + diff --git a/Master/texmf-dist/doc/latex/changebar/chbar.sh b/Master/texmf-dist/doc/latex/changebar/chbar.sh new file mode 100644 index 00000000000..232b1fcc37b --- /dev/null +++ b/Master/texmf-dist/doc/latex/changebar/chbar.sh @@ -0,0 +1,240 @@ +#!/bin/sh +# Gadget to take two LaTeX files and produce a third which +# has changebars highlighting the difference between them. +# +# Version 1.2 +# Author: +# Don Ward, Careful Computing (don@careful.co.uk) +# v1.0 April 1989 +# v1.1 Feb 93 Amended to use changebar.sty (v3.0) and dvips +# v1.2 Aug 95 Added support for LaTeX209/LaTeX2e +# Added RCS support to retrive old files + +CMD=`basename $0` + +SED=sed +RM="rm -f" +DIFF=diff +ED=ed +AWK=awk +GREP=grep +MV=mv +CAT=cat +MKDIR=mkdir +CO="co" + +TMPFILE=/tmp/$CMD.$$ +SED_CMD_FILE=$TMPFILE.sed + +usage() +{ +$CAT << _END_ +Usage: + $CMD [-hgG] [-d dir] old new [output] + default output is stdout + + $CMD [-hgG] [-d dir] old + new file on stdin, output on stdout + + $CMD [-hgG] -d dir -r rev files + old file retrieved using RCS + + Gadget to take two LaTeX files and produce a third which + has changebars highlighting the difference between them. + Changebars are inserted for differences after '\begin{document}'. + + Feature: \`new' can not be named \`-'. + + Options are: + -d dir : Write the output to file \`dir/new', if \`new' is given or + to file \`dir/old'. + If \`dir' does not exist, it is created. + If \`output' is given, it is discarded. + + -r rev : If the LaTeX \`files' are kept under control of the + Revision Control System RCS, the old files of + the revision \`rev' can be retrived. + \`rev' is specified using the RCS conventions. + This option must be used together with the \`-d dir' option. + \`files' must be a nonempty list of files. + + -h : Print this info text. + -g : Print some debugging info. + -G : Even more debug info. + + Version 1.2: August 3. 1995 +_END_ +exit 1 +} + +# parse options and arguments +DEBUG="NO" +DIR= +REV= +# process options +while getopts d:r:gGh i $* +do + case $i in + d ) DIR=$OPTARG;; + r ) REV=$OPTARG;; + g ) DEBUG="YES" ;; + G ) set -x; DEBUG="YES";; + h | \ + * ) usage ;; + esac +done + +shift `expr $OPTIND - 1` + +case $# in + 1 ) OLD=$1; NEW="-"; OUT="" ;; + 2 ) OLD=$1; NEW=$2; OUT="" ;; + 3 ) OLD=$1; NEW=$2; OUT="$3" ;; + * ) usage ;; +esac + +# check correct options +if [ ! -z "$DIR" ] +then + [ -d $DIR ] || $MKDIR $DIR +fi + +if [ ! -z "$REV" ] +then + [ -z "$DIR" ] && usage + FILES=$* +else + FILES=$NEW +fi + +# do the work +for NEW in $FILES +do + if [ ! -z "$DIR" ] + then + if [ $NEW = "-" ] + then + OUT=$DIR/$OLD + else + OUT=$DIR/$NEW + fi + fi + if [ ! -z "$REV" ] + then + OLD=${TMPFILE}.old + $CO -p"$REV" -q $NEW > $OLD + fi + + [ $DEBUG = "YES" ] && echo "OLD=\`$OLD' NEW=\`$NEW' OUT=\`$OUT'" + + # gather some info about the file + # Since we have for sure only the name of the OLD file, ... + $GREP "^\\\\begin{document}" $OLD > /dev/null + if [ $? -eq 0 ] + then + [ $DEBUG = "YES" ] && echo "contains a \\begin{document}" + HAS_BEGIN_DOC="YES" + else + [ $DEBUG = "YES" ] && echo "contains no \\begin{document}" + HAS_BEGIN_DOC="NO" + fi + + # Method to do the work: + # 1 Use diff to get an ed script to go from file1 to file2. + # 2 Breath on it a bit (with sed) to insert changebar commands. + # 3 Apply modified ed script to produce (nearly) the output. + # 4 Use awk to insert the changebars option into the \documentstyle + # and to handle changebar commands inside verbatim environments. + # 5 Remove changebars before \begin{document} with sed + + # SED commands to edit ED commands to edit old file + $CAT > $SED_CMD_FILE <<\_END_ +/^\.$/i\ +\\cbend{}% +/^[0-9][0-9]*[ac]$/a\ +\\cbstart{}% +/^[0-9][0-9]*,[0-9][0-9]*[ac]$/a\ +\\cbstart{}% +/^[0-9][0-9]*d$/a\ +i\ +\\cbdelete{}%\ +. +/^[0-9][0-9]*,[0-9][0-9]*d$/a\ +i\ +\\cbdelete{}%\ +. +_END_ + + # note DIFF accepts `-' as stdin + $DIFF -b -e $OLD $NEW | \ + ( $SED -f $SED_CMD_FILE ; echo w ${TMPFILE}.1 ; echo q ) | \ + $ED - $OLD + + # AWK commands to insert Changebars style and to protect + # changebar commands in verbatim environments + # and to tell what driver is in use; we assume the `dvips' driver + + $AWK ' + BEGIN {kind=""; # we saw now \documentXXX[]{} + } + /^\\documentstyle/{ + kind = "209"; + if (index($0, "changebar") == 0 ) { + opts = index($0, "[") + if (opts > 0) + printf "%schangebar,%s\n",substr($0,1,opts),substr($0,opts+1) + else + printf "\\documentstyle[changebar]%s\n", substr($0,15) + next + } + } + /^\\documentclass/{ + kind = "2e"; + printf "%s\n", $0 + printf "\\usepackage[dvips]{changebar}\n" + next + } + /\\begin{document}/ {if (kind == "209" ) {print "\\driver{dvips}"}} + /\\begin{verbatim}/{++nesting} + /\\end{verbatim}/{--nesting} + /\\cbstart{}%|\\cbend{}%|\cbdelete{}%/ { + if ( nesting > 0) { + # changebar command in a verbatim environment: Temporarily exit, + # do the changebar command and reenter. + # + # The obvious ( printf "\\end{verbatim}%s\\begin{verbatim} , $0 ) + # leaves too much vertical space around the changed line(s). + # The following magic seeems to work + # + print "\\end{verbatim}\\nointerlineskip" + print "\\vskip -\\ht\\strutbox\\vskip -\\ht\\strutbox" + printf "\\vbox to 0pt{\\vskip \\ht\\strutbox%s\\vss}\n", $0 + print "\\begin{verbatim}" + next + } + } + { print $0 } + ' ${TMPFILE}.1 > ${TMPFILE}.2 + + # if a \begin{document} is contained in the file, + # remove the changebar commands before them + + if [ $HAS_BEGIN_DOC = "YES" ] + then + SED_CMD="1,/\\\\begin{document}/s/\(\\\\cb[sed][tne][adl][^{}]*{}%\)$/%%\1/" + $SED "$SED_CMD" ${TMPFILE}.2 > ${TMPFILE}.3 + else + $CAT ${TMPFILE}.2 > ${TMPFILE}.3 + fi + if [ -z "$OUT" ] + then + $CAT ${TMPFILE}.3 + else + $MV ${TMPFILE}.3 $OUT + fi + +done + +[ $DEBUG = "NO" ] && $RM ${TMPFILE}.* + +############################################################### diff --git a/Master/texmf-dist/doc/latex/changebar/manifest.txt b/Master/texmf-dist/doc/latex/changebar/manifest.txt new file mode 100644 index 00000000000..a8f4eb20334 --- /dev/null +++ b/Master/texmf-dist/doc/latex/changebar/manifest.txt @@ -0,0 +1,24 @@ +% +% CONTENTS OF THE CHANGEBAR BUNDLE +% ================================ +% +% changebar.dtx -- A LaTeX2e package that provides commands to add +% change bars to a document. Relies on \specials. +% +% changebar.ins -- The installation script. +% +% changebar.bug -- A (historical) list of changes and of known +% (existing) problems. +% +% chbar.sh -- A Unix sh script to compare two version of a +% document and automatically add changebars to the +% modified document. +% +% chbar.1 -- A Unix man page describing the use of chbar.sh +% +% cbtest1.tex -- A sample file using the color package +% cbtest1-ltx.pdf -- Produced with LaTeX and dvipdf +% cbtest1-pdf.pdf -- Produced with pdfLaTeX +% cbtest2.tex -- A sample file using the xcolor package +% cbtest2-ltx.pdf -- Produced with LaTeX and dvipdf +% cbtest2-pdf.pdf -- Produced with pdfLaTeX -- cgit v1.2.3