From 536227e169557b4f1a247b2c2fdf4db839582812 Mon Sep 17 00:00:00 2001 From: Manuel Pégourié-Gonnard Date: Sun, 27 Jul 2008 12:22:00 +0000 Subject: breakurl v1.23 2008/07/15 git-svn-id: svn://tug.org/texlive/trunk@9809 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/breakurl/README | 4 +- Master/texmf-dist/doc/latex/breakurl/breakurl.pdf | Bin 117571 -> 120165 bytes .../texmf-dist/source/latex/breakurl/breakurl.dtx | 96 ++++++++++++--------- Master/texmf-dist/tex/latex/breakurl/breakurl.sty | 8 +- 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 Binary files a/Master/texmf-dist/doc/latex/breakurl/breakurl.pdf and b/Master/texmf-dist/doc/latex/breakurl/breakurl.pdf 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 @@ %\NeedsTeXFormat{LaTeX2e}[1999/12/01] %\ProvidesPackage{breakurl} %<*package> - [2008/04/05 v1.22 Breakable hyperref URLs] + [2008/07/15 v1.23 Breakable hyperref URLs] % %<*driver> \documentclass{ltxdoc} @@ -43,7 +43,7 @@ % % \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{}|. % % \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.|\\ % | \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 -- cgit v1.2.3