From 39cb23d10578b9db523f4f499d3dea3630787af0 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 3 Mar 2014 01:38:45 +0000 Subject: prerex (3Mar) git-svn-id: svn://tug.org/texlive/trunk@33078 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/prerex/README | 79 +++++++++++++----------- Master/texmf-dist/doc/latex/prerex/intro.pdf | Bin 284232 -> 284350 bytes Master/texmf-dist/doc/latex/prerex/intro.tex | 11 ++-- Master/texmf-dist/doc/latex/prerex/prerex.pdf | Bin 144291 -> 144411 bytes Master/texmf-dist/doc/latex/prerex/prerex.sty.7 | 6 +- Master/texmf-dist/doc/latex/prerex/prerex.tex | 21 ++++--- 6 files changed, 62 insertions(+), 55 deletions(-) (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/prerex/README b/Master/texmf-dist/doc/latex/prerex/README index daaa393ac4b..fce4dc5536b 100644 --- a/Master/texmf-dist/doc/latex/prerex/README +++ b/Master/texmf-dist/doc/latex/prerex/README @@ -1,5 +1,5 @@ -prerex, version 2014-02-27. -Macros for prerequisite charts, with associated editor and viewer applications. +prerex, version 2014-03-02. Macros for prerequisite charts, with +associated editor and viewer applications. This package consists of @@ -14,8 +14,8 @@ This package consists of vprerex ("visual prerex") a GUI and previewer for prerex. The implementation of prerex.sty is built on pgf, so that it may be -used equally happily with latex or pdflatex; prerex is written in C and -vprerex is written in C++ using the Qt-4 and poppler libraries. +used equally happily with latex or pdflatex; prerex is written in C +and vprerex is written in C++ using the Qt-4 and poppler libraries. See chart.{pdf,html} for a small example of a prerequisite chart and real-life examples at @@ -25,28 +25,30 @@ http://www.cs.queensu.ca/students/undergraduate/prerequisites/ Prerequisite charts are useful to students selecting courses and planning their programs, and to faculty and staff advising students and managing curriculum development. Conventional sources of course, -program and timetable information are rarely in a user-friendly format. -Faculty and staff advisors, being already fairly familiar with their -courses and programs, often do not appreciate how inconvenient it is -for students to access all the information they need to make course -choices. +program and timetable information are rarely in a user-friendly +format. Faculty and staff advisors, being already fairly familiar +with their courses and programs, often do not appreciate how +inconvenient it is for students to access all the information they +need to make course choices. -The crucial tool in the prerex suite is "prerex.sty", a macro package -that defines a "chart" environment and commands to specify construction -of course boxes and directed arrows between them. +The crucial tool in the prerex suite is "prerex.sty", a macro +package that defines a "chart" environment and commands to specify +construction of course boxes and directed arrows between them. prerex.sty depends on - pgf (and add-on tikz), version 1.18 or higher + pgf (and add-on tikz), version 3.0 or higher multido relsize calc - ifthen zref-savepos hyperref -The use of pgf means that Postscript processing is not required; -either pdflatex or latex -> dvips [ -> ps2pdf ] may be used. +The use of pgf means that Postscript processing is not required. +Either pdflatex or latex -> dvips [ -> ps2pdf ] or latex -> dvipdfmx +(with suitable driver options) will generate charts, but pdflatex +processing is necessary to produce correct pixel coordinates in the +generated map and shell files. Installation of prerex.sty: @@ -62,12 +64,13 @@ Installation of prerex.sty: See doc/prerex.pdf for detailed documentation. -The prerex editor allows interactive editing of the chart environments -of LaTeX source files. It supports add, remove, cut-and-paste, and edit -operations on course boxes and arrows, and vertical or horizontal shifts -of the whole diagram or selected sets of course boxes. When a course box -is moved, the arrows into and out of it automatically follow. To install -on most Unix-like platforms, including OS-X and Cygwin on Windows: +The prerex editor allows interactive editing of the chart +environments of LaTeX source files. It supports add, remove, +cut-and-paste, and edit operations on course boxes and arrows, and +vertical or horizontal shifts of the whole diagram or selected sets +of course boxes. When a course box is moved, the arrows into and out +of it automatically follow. To install on most Unix-like platforms, +including OS-X and Cygwin on Windows: tar zxvf prerex-6.5.2.tar.gz cd prerex-6.5.2 @@ -75,24 +78,26 @@ on most Unix-like platforms, including OS-X and Cygwin on Windows: make make install (as root if necessary) -The prerex editor will also build on the MinGW platform on Windows if -the readline package in the gnuwin32.sourceforge.net repository has been -installed. +The prerex editor will also build on the MinGW platform on Windows +if the readline package in the gnuwin32.sourceforge.net repository +has been installed. -The effects of editing operations may be observed in any PDF viewer. -The vprerex (visual prerex) application included in the prerex suite -is a GUI and viewer for the prerex editor. It may be used just as a -minimalist viewer of arbitrary PDF files but supports editing of -charts generated using prerex.sty by allowing coordinates of course -boxes, arrows, and background points to be conveyed back to the prerex -editor command-line using the clipboard. See the INSTALL in the tarball -for installation instructions. +The effects of editing operations may be observed in any PDF viewer +that re-loads dynamically. The vprerex (visual prerex) application +included in the prerex suite is a GUI and viewer for the prerex +editor. It may be used just as a minimalist viewer of arbitrary PDF +files but supports editing of charts generated using prerex.sty +by allowing coordinates of course boxes, arrows, and background +points to be conveyed back to the prerex editor command-line using +the clipboard. See the INSTALL in the tarball for installation +instructions. See the file doc/intro.pdf for an overview of the prerex system. prerex.sty, README, prerex.1, prerex.5, prerex.sty.7, prerex.tex and -chart.tex may be modified and distributed according to the terms of the -LaTeX Project Public License. +chart.tex may be modified and distributed according to the terms of +the LaTeX Project Public License. -The source files for prerex and vprerex may be modified and distributed -according to the terms of the GNU General Public Licence (version 2). +The source files for prerex and vprerex may be modified and +distributed according to the terms of the GNU General Public Licence +(version 2). diff --git a/Master/texmf-dist/doc/latex/prerex/intro.pdf b/Master/texmf-dist/doc/latex/prerex/intro.pdf index c834389373d..ba6cb15c8e5 100644 Binary files a/Master/texmf-dist/doc/latex/prerex/intro.pdf and b/Master/texmf-dist/doc/latex/prerex/intro.pdf differ diff --git a/Master/texmf-dist/doc/latex/prerex/intro.tex b/Master/texmf-dist/doc/latex/prerex/intro.tex index 3fc4bb88e58..e03d426e2fd 100644 --- a/Master/texmf-dist/doc/latex/prerex/intro.tex +++ b/Master/texmf-dist/doc/latex/prerex/intro.tex @@ -335,7 +335,7 @@ to process the description of a prerex-formatted prerequisite chart until some n To process descriptions of prerex-formatted charts, some additional packages are needed. -The file \texttt{prerex.sty} fromthe \texttt{prerex} package is essential; +The file \texttt{prerex.sty} from the \texttt{prerex} package is essential; it should be stored in the same folder as the \texttt{.tex} file to be processed (or in the @@ -344,6 +344,7 @@ Other add-ons that may be necessary are as follows: \texttt{pgf}, \texttt{tikz}, \texttt{multido}, +\texttt{ifpdf}, \texttt{textcomp}, and \texttt{xcolor}. If you are using \MikTeX\ or \texttt{texlive}, these can be installed using the @@ -426,7 +427,7 @@ The Open Sans family\footnote{% of fonts, designed by Steve Matteson of Ascender, is supported for use in \LaTeX\ by the \texttt{opensans} package, available from CTAN\footnote{% -\myurl{http://www.ctan.org/tex-archive/fonts/opensans}} +\myurl{http://mirror.ctan.org/fonts/opensans}} and in most distributions. The Cabin\footnote{% \myurl{http://www.google.com/webfonts/specimen/Cabin}} @@ -449,7 +450,7 @@ Artifex\footnote{% \myurl{http://www.artifex.com/downloads/}}. The four Classico font files, renamed for use in \LaTeX, with the necessary support files and installation instructions are available from CTAN\footnote{% -\myurl{ftp://tug.ctan.org/pub/tex-archive/nonfree/fonts/urw/classico.zip}}. +\myurl{http://mirror.ctan.org/fonts/urw/classico/}}. Note that the font files cannot be distributed commercially without a commercial license; please read the license in the archive before re-distributing them. This restriction does not prevent you from distributing documents that \emph{use} the fonts. @@ -470,7 +471,7 @@ package may be used as follows: The density parameter specifies the number of pixels per inch; if this is too small, the image is of poor quality, and if it is too large, the image file is too big. The quality parameter ensures maximal (loss-free) compression. -From version 5.0, \verb|prerex.sty| generates an auxiliary file +From version 5.0, \verb|prerex.sty| (if processed by \verb\pdflatex\) generates an auxiliary file containing image-map data for the hyperlinked nodes in the chart; consult a reference on the HTML language for an explanation of (client-side) image maps. @@ -544,7 +545,7 @@ coordinates of the centre points of its source and target boxes/minis/text-lines \section{Chart Editing} \label{editor} The source code of \texttt{prerex}, an interactive (command-line) prerequisite-chart editor, is available at -CTAN repositories.\footnote{\myurl{http://www.ctan.org/tex-archive/graphics/prerex/}} +CTAN repositories.\footnote{\myurl{http://mirror.ctan.org/graphics/prerex/}} It should build on any \textsc{Unix}-like system with suitable tools and libraries installed; for example, it can be compiled on GNU/Linux, Solaris, the Cygwin\footnote{\myurl{http://www.cygwin.com/}} diff --git a/Master/texmf-dist/doc/latex/prerex/prerex.pdf b/Master/texmf-dist/doc/latex/prerex/prerex.pdf index 8805aff98c7..4ba8a28f61e 100644 Binary files a/Master/texmf-dist/doc/latex/prerex/prerex.pdf and b/Master/texmf-dist/doc/latex/prerex/prerex.pdf differ diff --git a/Master/texmf-dist/doc/latex/prerex/prerex.sty.7 b/Master/texmf-dist/doc/latex/prerex/prerex.sty.7 index 21da7194fb5..d71cf77aeee 100644 --- a/Master/texmf-dist/doc/latex/prerex/prerex.sty.7 +++ b/Master/texmf-dist/doc/latex/prerex/prerex.sty.7 @@ -1,4 +1,4 @@ -.TH PREREX.STY 7 2012-03-21 "prerex.sty-6.3" "" +.TH PREREX.STY 7 2014-02-28 "prerex.sty-6.4" "" .SH NAME prerex.sty \- a LaTeX document style for prerequisite charts .SH DESCRIPTION @@ -251,7 +251,7 @@ When the grid is on, the mid-point of every arrow is highlighted by a The .B prerex package at -.B http://www.ctan.org/tex-archive/graphics/prerex/ +.B http://mirror.ctan.org/graphics/prerex/ has a patch for .BR kpdf / okular (1) to make it display URIs in tooltips and also capture coordinates of course boxes, arrows and @@ -357,7 +357,7 @@ with add-on package The following additional packages are used: .B relsize, .B calc, -.B ifthen, +.B ifpdf, .B multido, .B textcomp, .B zref-savepos diff --git a/Master/texmf-dist/doc/latex/prerex/prerex.tex b/Master/texmf-dist/doc/latex/prerex/prerex.tex index 454364665da..1146461bb67 100644 --- a/Master/texmf-dist/doc/latex/prerex/prerex.tex +++ b/Master/texmf-dist/doc/latex/prerex/prerex.tex @@ -6,7 +6,7 @@ %\def\LaTeX{\mbox{LaTeX}} \begin{document} -\title{\textsf{prerex.sty}: Prerequisite Charts in \LaTeX\\{\large Version 6.3}} +\title{\textsf{prerex.sty}: Prerequisite Charts in \LaTeX\\{\large Version 6.4}} \author{R. D. Tennent\\\texttt{rdt@cs.queensu.ca}} \date{\today} \maketitle @@ -291,7 +291,7 @@ a ``bullet''. The \texttt{prerex} package at -\url{http://www.ctan.org/tex-archive/graphics/prerex/} +\url{http://mirror.ctan.org/graphics/prerex/} contains source code for a graphical frontend \texttt{vprerex} to the \texttt{prerex} editor. It incorporates a minimalistic prerex-enabled PDF viewer @@ -362,18 +362,19 @@ environment, such as in the explanatory notes for a chart: \end{center} \section{Dependencies} +\sloppypar This implementation of \verb|prerex.sty| uses \verb|pgf| -(version~1.18 or later) +(version~3.0.0 or later) with add-on package \verb|tikz|. The following additional packages are used: \verb|multido|, \verb|relsize|, \verb|calc|, -\verb|ifthen|, +\verb|ifpdf|, \verb|textcomp|, \verb|zref-savepos|, and @@ -381,8 +382,10 @@ and \emph{Either} \verb\pdflatex\ \emph{or} \verb\latex\ (followed by \verb\dvips\ and, possibly, \verb\ps2pdf\) -may be used; however, the page coordinates in the generated shell script and -image-map may not be accurate unless \verb\pdflatex\ +\emph{or} +\verb\latex\ (with suitable driver options, followed by \verb\dvipdfmx\) +may be used; however, cropping shell scripts and +image maps are only generated if \verb\pdflatex\ is used. \section{Conversion to Portable Network Graphic (PNG) Format} @@ -403,7 +406,7 @@ By default, the shell script generated by \texttt{prerex.sty} crops the image at It is possible to use a PNG compression application such as \texttt{optipng} to reduce the file-size of the cropped image (without loss of quality). -An auxiliary file +If \verb\pdflatex\ is used, an auxiliary file containing image-map data for the hyperlinked nodes in the chart is also generated; consult a reference on the HTML language for an explanation of (client-side) image maps. @@ -518,8 +521,6 @@ improve the appearance of crossing arrows; the background also ensures visibility of the arrow when the coordinate grid is on. -A thin white arrow (with a visible -arrowhead) is drawn beneath the visible arrow to obtain a thin arrowhead. \subsection{Coordinate Grid and Associated Changes} When the coordinate grid is drawn, the \texttt{CourseURL} command @@ -534,7 +535,7 @@ PDF viewers to compute chart coordinates. To support HTML versions of charts, \texttt{prerex.sty} -generates a script to crop a chart image at the southeast corner, allowing +(if processed by \verb\pdflatex\) generates a script to crop a chart image at the southeast corner, allowing descriptive notes below the chart to be treated as ordinary text. Also, it generates image-map data for use with an HTML image map. To obtain absolute page coordinates, the \texttt{zsavepos}, \texttt{zposx} -- cgit v1.2.3