summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/breakurl
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2006-10-04 08:43:01 +0000
committerNorbert Preining <preining@logic.at>2006-10-04 08:43:01 +0000
commitba9472aebfed07843bc4faa00c7b96bc86194691 (patch)
tree4a952a012e2f1663beaac6384dec265fb50dd361 /Master/texmf-dist/source/latex/breakurl
parenta88bdfe70c672cfced299babf0a54881a916bcca (diff)
Fix ctan2tds for pgf installation
comment powerdot-doc-vn in tpm-ctan-check, it always breaks Update of the following packages: labelcas pstricks-add sectionbox ltxmisc frenchle flowfram verse emulateapj pst-pdf poemscol babelbib dk-bib breakurl screenplay ncctools xkeyval bibleref muthesis pst-labo pgf ncclatex active-conf xcolor commath lineno dottex makeplo git-svn-id: svn://tug.org/texlive/trunk@2240 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/breakurl')
-rw-r--r--Master/texmf-dist/source/latex/breakurl/breakurl.dtx92
1 files changed, 60 insertions, 32 deletions
diff --git a/Master/texmf-dist/source/latex/breakurl/breakurl.dtx b/Master/texmf-dist/source/latex/breakurl/breakurl.dtx
index ec9a4d64b86..d5111f4be86 100644
--- a/Master/texmf-dist/source/latex/breakurl/breakurl.dtx
+++ b/Master/texmf-dist/source/latex/breakurl/breakurl.dtx
@@ -1,6 +1,6 @@
% \iffalse meta-comment
%
-% Copyright (C) 2005 by Vilar Camara Neto.
+% Copyright (C) 2005,2006 by Vilar Camara Neto.
%
% This file may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either
@@ -28,7 +28,7 @@
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{breakurl}
%<*package>
- [2005/09/23 v1.10 Breakable hyperref URLs]
+ [2006/08/26 v1.20 Breakable hyperref URLs]
%</package>
%<*driver>
\documentclass{ltxdoc}
@@ -43,7 +43,7 @@
%</driver>
% \fi
-% \CheckSum{371}
+% \CheckSum{372}
% \CharacterTable
@@ -62,6 +62,7 @@
% Grave accent \` Left brace \{ Vertical bar \|
% Right brace \} Tilde \~}
%
+% \changes{v1.20}{2006/08/26}{Changes to reflect update of hyperref package}
% \changes{v1.10}{2005/09/23}{Added the command \string\urlalt, allowing one to
% specify different values for displayed and actual link}
% \changes{v1.01}{2005/09/22}{Fixed a bug when a page break occurs in the
@@ -82,7 +83,7 @@
% \textsf{breakurl}~\fileversion, dated~\filedate.}}
% \author{Vilar Camara Neto \\
% \texttt{neto@dcc.ufmg.br}}
-% \date{September 23, 2005}
+% \date{August 26, 2006}
%
% \maketitle
%
@@ -119,12 +120,10 @@
% the |\usepackage{hyperref}|. The |\burl| command is defined and, by default,
% the package also turns the |\url| command into a synonym of |\burl|. This
% might come in handy, for example, if you use Bib\TeX{}, your |.bib|-file has
-% lots of |\url| commands and you don't want to replace them by
-% |\burl|.\footnote{Yes, \texttt{\string\burl} also works inside
-% bibliographies, since they are considered to be ``in the middle of the
-% document''.} If, for some reason, you want to preserve the original behaviour
-% of |\url| (i.e., it creates an unbreakable link), you must supply the
-% |preserveurlmacro| option to the package (see Section \ref{sec:pkgoptions}).
+% lots of |\url| commands and you don't want to replace them by |\burl|. If,
+% for some reason, you want to preserve the original behavior of |\url| (i.e.,
+% it creates an unbreakable link), you must supply the |preserveurlmacro|
+% option to the package (see Section \ref{sec:pkgoptions}).
%
% In the middle of the document, the syntax of |\burl| (and its synonym |\url|)
% is exactly like the original |\url|: |\burl|\marg{URL}, where \meta{URL} is,
@@ -139,7 +138,7 @@
% \texttt{\string\hyperref}'s \texttt{\string\href}, but since it works in a
% different manner I decided not to call it ``\texttt{\string\bhref}''.}
%
-% The default behaviour of the package is to break the link after any sequence
+% The default behavior of the package is to break the link after any sequence
% of these characters:
%
% \begin{center}
@@ -191,7 +190,7 @@
% \newcommand{\sep}{$\mid$}
%
% When using the |\usepackage| command, you can give some options to customize
-% the package behaviour. Possible options are explained below:
+% the package behavior. Possible options are explained below:
%
% \begin{itemize}
% \item |hyphenbreaks|\par
@@ -242,6 +241,10 @@
%
% \begin{description}
%
+% \item[v1.20] An update was needed because |hyperref|'s internals were
+% changed. (Thanks Heiko for sending the correction patch.) Troubleshooting
+% now includes a note about |\sloppy|.
+%
% \item[v1.10] A new command, |\burlalt| (and the synonym |\urlalt|), allows
% one to specify different values for actual and displayed link.
%
@@ -280,32 +283,57 @@
%
% \subsection{Troubleshooting}
%
-% 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|.
+% Here comes a few notes about known issues:
%
-% 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:
-% \begin{quote}
-% |\usepackage[dvips]{hyperref}|
-% \end{quote}
+% \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 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:
+% \begin{quote}
+% |\usepackage[dvips]{hyperref}|
+% \end{quote}
%
+% \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'',
+% so it may be ignored even when URLs aren't used. Check the following
+% paragraph:
+%
+% Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Proin
+% zzzzzzzzzzzzzzzzzzzzzzz\ldots
+%
+% To overcome this (and make right margins a hard limit) use the command
+% |\sloppy|, preferably before |\begin{document}|. This makes the previous
+% paragraph look like:
+%
+% \sloppy
+%
+% Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Proin
+% zzzzzzzzzzzzzzzzzzzzzzz\ldots
+%
+% As a drawback word spacing becomes terrible, but now the text is kept
+% inside designed margins. You should decide what looks better.
+%
+% \end{itemize}
%
% \subsection{Acknowledgments}
%
% Thanks to Hendri Adriaens, Donald Arseneau, Michael Friendly, Morten Høgholm,
-% David Le Kim, Damian Menscher, Tristan Miller, Christoph Schiller, Xiaotian
-% Sun, and David Tulloh 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.
+% David Le Kim, Damian Menscher, Tristan Miller, Heiko Oberdiek, Christoph
+% Schiller, Xiaotian Sun, and David Tulloh 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}
@@ -550,7 +578,7 @@
\burl@toks{}%
\let\burl@UrlRight=\UrlRight
\let\UrlRight=\empty
- \Hy@colorlink{\@ifundefined{@urlcolor}{\@linkcolor}{\@urlcolor}}%
+ \@ifundefined{@urlcolor}{\Hy@colorlink\@linkcolor}{\Hy@colorlink\@urlcolor}%
\@burl@breakablefalse
\expandafter\@tfor\expandafter\@nextchar\expandafter:\expandafter=%
\burl@urltext\do{%