summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Master/texmf-dist/doc/latex/breakurl/README4
-rw-r--r--Master/texmf-dist/doc/latex/breakurl/breakurl.pdfbin117571 -> 120165 bytes
-rw-r--r--Master/texmf-dist/source/latex/breakurl/breakurl.dtx96
-rw-r--r--Master/texmf-dist/tex/latex/breakurl/breakurl.sty8
4 files changed, 61 insertions, 47 deletions
diff --git a/Master/texmf-dist/doc/latex/breakurl/README b/Master/texmf-dist/doc/latex/breakurl/README
index c32ee623e1f..365e01ea4b5 100644
--- a/Master/texmf-dist/doc/latex/breakurl/README
+++ b/Master/texmf-dist/doc/latex/breakurl/README
@@ -1,4 +1,4 @@
-README for breakurl, version 1.22 (2008/04/05)
+README for breakurl, version 1.23 (2008/07/15)
INTRODUCTION
@@ -44,7 +44,7 @@ b) Generate the `breakurl.sty' file:
latex breakurl.ins
-c) Install the file `breakurl.sty' in your TDS tree:
+c) Install the file `breakurl.sty' into your TDS tree:
mkdir [prefix]/texmf/tex/latex/breakurl
cp breakurl.sty [prefix]/texmf/tex/latex/breakurl/
diff --git a/Master/texmf-dist/doc/latex/breakurl/breakurl.pdf b/Master/texmf-dist/doc/latex/breakurl/breakurl.pdf
index 533acea639e..b0a86e1991a 100644
--- a/Master/texmf-dist/doc/latex/breakurl/breakurl.pdf
+++ b/Master/texmf-dist/doc/latex/breakurl/breakurl.pdf
Binary files differ
diff --git a/Master/texmf-dist/source/latex/breakurl/breakurl.dtx b/Master/texmf-dist/source/latex/breakurl/breakurl.dtx
index 2f43a46c6c8..96d593af626 100644
--- a/Master/texmf-dist/source/latex/breakurl/breakurl.dtx
+++ b/Master/texmf-dist/source/latex/breakurl/breakurl.dtx
@@ -28,7 +28,7 @@
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{breakurl}
%<*package>
- [2008/04/05 v1.22 Breakable hyperref URLs]
+ [2008/07/15 v1.23 Breakable hyperref URLs]
%</package>
%<*driver>
\documentclass{ltxdoc}
@@ -43,7 +43,7 @@
%</driver>
% \fi
-% \CheckSum{377}
+% \CheckSum{378}
% \CharacterTable
@@ -62,6 +62,7 @@
% Grave accent \` Left brace \{ Vertical bar \|
% Right brace \} Tilde \~}
%
+% \changes{v1.23}{2008/07/15}{\string\hypersetup can now be used anywhere}
% \changes{v1.22}{2008/04/05}{Corrected a misuse of \string\leavevmode which
% generated blank lines inside tables}
% \changes{v1.21}{2007/06/20}{\string\burlalt and \string\urlalt now work under
@@ -83,11 +84,13 @@
%
% \GetFileInfo{breakurl.dtx}
%
-% \title{The \textsf{breakurl} package\thanks{This document corresponds to
+% \newcommand{\pkg}[1]{\textsf{#1}}
+%
+% \title{The \pkg{breakurl} package\thanks{This document corresponds to
% \textsf{breakurl}~\fileversion, dated~\filedate.}}
% \author{Vilar Camara Neto \\
% \texttt{neto@dcc.ufmg.br}}
-% \date{April 05, 2008}
+% \date{July 15, 2008}
%
% \maketitle
%
@@ -95,7 +98,7 @@
%
% \section{Introduction}
%
-% The |hyperref| package brings a lot of interesting tools to ``boost''
+% The \pkg{hyperref} package brings a lot of interesting tools to ``boost''
% documents produced by \LaTeX. For instance, a PDF file can have clickable
% links to references, section headings, URLs, etc.
%
@@ -109,8 +112,8 @@
% paragraphs; sometimes the final effect is so bad that the link can't even fit
% inside the physical page limits.
%
-% To overcome that |dvips| limitation, the |breakurl| package was designed with
-% a simple solution: it provides a command called |\burl| (it stands for
+% To overcome that |dvips| limitation, the \pkg{breakurl} package was designed
+% with a simple solution: it provides a command called |\burl| (it stands for
% ``breakable URL''). Instead of generating one long, atomic link, this command
% breaks it into small pieces, allowing line breaks between them. Each sequence
% of pieces that stand together in one line are converted to a hot (clickable)
@@ -176,7 +179,7 @@
% \end{quote}
%
% Here comes the doubt: the author is pointing to |http://internet-page.com| or
-% to |http://internetpage.com|? The |breakurl| package \emph{never} adds a
+% to |http://internetpage.com|? The \pkg{breakurl} package \emph{never} adds a
% hyphen when a link is broken across lines --- so, the first choice would be
% the right one ---, but we can't assume that the reader knows this rule; so, I
% decided to disallow breaks after hyphens. Nevertheless, if you want to
@@ -222,21 +225,16 @@
%
% \subsection{Additional comments}
%
-% As stated in the introduction, the |breakurl| is designed for those compiling
-% documents via \LaTeX{}, not pdf\LaTeX. In the latter case, the package
-% doesn't (re)define the |\url| command: it only defines |\burl| to be a
-% synonym of whatever |\url| is defined (e.g., via |url| or |hyperref|
+% As stated in the introduction, the \pkg{breakurl} is designed for those
+% compiling documents via \LaTeX{}, not pdf\LaTeX. In the latter case, the
+% package doesn't (re)define the |\url| command: it only defines |\burl| to be
+% a synonym of whatever |\url| is defined (e.g., via |url| or \pkg{hyperref}
% packages). Of course, |\burl| may behave differently compared to
% (non-pdf)\LaTeX, because then the system will use other rules to make line
% breaks, spacing, etc.
%
% Also, this package was not designed to nor tested against other drivers: it's
-% compatible with dvips only. And don't forget to specify the driver (|dvips|)
-% to the |hyperref| package, i.e.:
-%
-% \begin{quote}
-% |\usepackage[dvips]{hyperref}|
-% \end{quote}
+% compatible with dvips only.
%
%
% \subsection{Changelog}
@@ -245,12 +243,14 @@
%
% \begin{description}
%
+% \item[v1.23] |\hypersetup| now works anywhere.
+%
% \item[v1.22] Corrected blank lines appearing inside tables.
%
% \item[v1.21] |\burlalt| and the synonym |\urlalt| now work with pdflatex.
% Also, there are a couple of bug fixes (thank you again, Heiko).
%
-% \item[v1.20] An update was needed because |hyperref|'s internals were
+% \item[v1.20] An update was needed because \pkg{hyperref}'s internals were
% changed. (Thanks Heiko for sending the correction patch.) Troubleshooting
% now includes a note about |\sloppy|.
%
@@ -265,20 +265,20 @@
% although the original (|url.sty|'s) documentation allows defining
% |\UrlLeft| as a command with one argument (things such
% \texttt{\string\def\string\UrlLeft\#1\string\UrlRight\{}\emph{do things
-% with \#1}\texttt{\}}, this isn't expected to work with |breakurl|. Please
-% use only the basic definition, e.g.: |\def\UrlLeft{<url:\ }|
+% with \#1}\texttt{\}}, this isn't expected to work with \pkg{breakurl}.
+% Please use only the basic definition, e.g.: |\def\UrlLeft{<url:\ }|
% |\def\UrlRight{>}|.
%
% \item[v0.04] Corrected a bug that prevented URLs to be in color, in despite
-% of |hyperref|'s |colorlinks| and |urlcolor| options. Added an error message
-% if |vertfit| parameter is invalid.
+% of \pkg{hyperref}'s |colorlinks| and |urlcolor| options. Added an error
+% message if |vertfit| parameter is invalid.
%
% \item[v0.03] The package was tested against |pdfeTeX| engine (which may be
% the default for some |teTeX| distributions). Introduced a new package
% option, |vertfit|.
%
% \item[v0.02] The main issue of the initial release --- the odd-looking
-% sequence of small links in the same line, if one uses |hyperref|'s link
+% sequence of small links in the same line, if one uses \pkg{hyperref}'s link
% borders --- was resolved: now the package generates only one rectangle per
% line. Also, breaks after hyphens, which weren't allowed in the previous
% release, are now a users' option. Finally, the package can be used with
@@ -296,22 +296,27 @@
%
% \begin{itemize}
%
-% \item I received some comments saying that in some cases |breakurl| destroys
-% the formatting of the document: the left/right margins aren't respected,
-% justification becomes weird, etc. In all these cases, the problems were
-% corrected when other packages were upgraded, notabily |xkeyval|.
+% \item I received some comments saying that in some cases \pkg{breakurl}
+% destroys the formatting of the document: the left/right margins aren't
+% respected, justification becomes weird, etc. In all these cases, the
+% problems were corrected when other packages were upgraded, notabily
+% |xkeyval|.
%
% \item If your compilation issues the following error:
% \begin{quote}
% |! Undefined control sequence.|\\
% |<argument> \headerps@out| \ldots
% \end{quote}
-% it's probabily because you forgot to specify the |dvips| driver as an
-% option to |hyperref|. Check if you have it:
+% then you need to specify the |dvips| driver as an option to the
+% \pkg{hyperref} package, e.g.:
% \begin{quote}
% |\usepackage[dvips]{hyperref}|
% \end{quote}
%
+% However, this is related to old versions of \pkg{hyperref}: the package is
+% able to automatically determine the driver in current versions. It's
+% probabily better to update your \LaTeX{} system.
+%
% \item If everything compiles but sometimes URLs still don't respect the right
% margin, don't blame the package yet :-) . Roughly speaking, by default the
% right margin is a limit to be respected ``only if word spacing is okay'',
@@ -339,17 +344,18 @@
%
% Thanks to Hendri Adriaens, Donald Arseneau, Michael Friendly, Morten Høgholm,
% David Le Kim, Damian Menscher, Tristan Miller, Heiko Oberdiek, Christoph
-% Schiller, Xiaotian Sun, Michael Toews, David Tulloh, and Jinsong Zhao for
-% suggestions, bug reports, comments, and corrections. A special thanks to the
-% participants of |comp.text.tex| newsgroups for their constant effort to help
-% hundreds of people in the beautiful world of \TeX/\LaTeX.
+% Schiller, Xiaotian Sun, Michael Toews, David Tulloh, Adrian Vogel, and
+% Jinsong Zhao for suggestions, bug reports, comments, and corrections. A
+% special thanks to the participants of |comp.text.tex| newsgroups for their
+% constant effort to help hundreds of people in the beautiful world of
+% \TeX/\LaTeX.
%
%
% \section{Source code}
%
% This section describes the |breakurl.sty| source code.
%
-% The |breakurl| requires some packages, so let's include them:
+% The \pkg{breakurl} requires some packages, so let's include them:
%
% \begin{macrocode}
\RequirePackage{xkeyval}
@@ -378,8 +384,8 @@
\fi
% \end{macrocode}
-% Since |breakurl| is an extension to |hyperref|, let's complain loudly if the
-% latter was not yet loaded:
+% Since \pkg{breakurl} is an extension to \pkg{hyperref}, let's complain loudly
+% if the latter was not yet loaded:
%
% \begin{macrocode}
\@ifpackageloaded{hyperref}{}{%
@@ -402,8 +408,8 @@
% \end{macrocode}
% \DescribeMacro{\burl@toks}
-% The |breakurl| package uses a token list to store characters and tokens until
-% a break point is reached:
+% The \pkg{breakurl} package uses a token list to store characters and tokens
+% until a break point is reached:
%
% \begin{macrocode}
\newtoks\burl@toks
@@ -486,7 +492,7 @@
% \end{macrocode}
% These supporting routines are modified versions of those found in the
-% |hyperref| package. They were adapted to allow a link to be progressively
+% \pkg{hyperref} package. They were adapted to allow a link to be progressively
% built, i.e., when we say ``put a link rectangle here'', the package will
% decide if this will be made.
%
@@ -499,6 +505,10 @@
}
\def\burl@condpdflink#1{%
+ \literalps@out{
+ /burl@bordercolor {\@urlbordercolor} def
+ /burl@border {\@pdfborder} def
+ }%
\if@burl@fitstrut
\sbox\pdf@box{#1\strut}%
\else\if@burl@fitglobal
@@ -657,8 +667,8 @@
% link's horizontal range; |burl@boty| and |burl@topy|, which defines the
% link's vertical range; |burl@llx|, |burl@lly|, |burl@urx|, and |burl@ury|,
% which define the bounding box of the current link segment (they resemble the
-% |hyperref|'s |pdf@llx|--|pdf@ury| counterparts); and |BU.L|, which holds the
-% target URL.
+% \pkg{hyperref}'s |pdf@llx|--|pdf@ury| counterparts); and |BU.L|, which holds
+% the target URL.
%
% \begin{macrocode}
\AtBeginDvi{%
@@ -723,7 +733,7 @@
% \begin{macrocode}
/BU.DF {
BU.BB
- [ /H /I /Border [\@pdfborder] /Color [\@urlbordercolor]
+ [ /H /I /Border [burl@border] /Color [burl@bordercolor]
/Action << /Subtype /URI /URI BU.L >> /Subtype /Link BU.B /ANN pdfmark
/burl@stx null def
} def
diff --git a/Master/texmf-dist/tex/latex/breakurl/breakurl.sty b/Master/texmf-dist/tex/latex/breakurl/breakurl.sty
index 1db3ea3e7c7..994b069c0e7 100644
--- a/Master/texmf-dist/tex/latex/breakurl/breakurl.sty
+++ b/Master/texmf-dist/tex/latex/breakurl/breakurl.sty
@@ -29,7 +29,7 @@
%%
\NeedsTeXFormat{LaTeX2e}[1999/12/01]
\ProvidesPackage{breakurl}
- [2008/04/05 v1.22 Breakable hyperref URLs]
+ [2008/07/15 v1.23 Breakable hyperref URLs]
\RequirePackage{xkeyval}
@@ -135,6 +135,10 @@
}
\def\burl@condpdflink#1{%
+ \literalps@out{
+ /burl@bordercolor {\@urlbordercolor} def
+ /burl@border {\@pdfborder} def
+ }%
\if@burl@fitstrut
\sbox\pdf@box{#1\strut}%
\else\if@burl@fitglobal
@@ -258,7 +262,7 @@
} def
/BU.DF {
BU.BB
- [ /H /I /Border [\@pdfborder] /Color [\@urlbordercolor]
+ [ /H /I /Border [burl@border] /Color [burl@bordercolor]
/Action << /Subtype /URI /URI BU.L >> /Subtype /Link BU.B /ANN pdfmark
/burl@stx null def
} def