summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/breakurl
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-04-13 22:59:55 +0000
committerKarl Berry <karl@freefriends.org>2013-04-13 22:59:55 +0000
commit0f41ce1d28482ce78a7ae6d61b06d84184bce1a5 (patch)
tree47cc50b358bd03d9ea8c81afe620b7ba5122a323 /Master/texmf-dist/source/latex/breakurl
parent3e398ad7ee08bc7f8493d2a6a7c0550c5c1ec7cc (diff)
breakurl (12apr13)
git-svn-id: svn://tug.org/texlive/trunk@29901 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/breakurl')
-rw-r--r--Master/texmf-dist/source/latex/breakurl/breakurl.dtx50
1 files changed, 35 insertions, 15 deletions
diff --git a/Master/texmf-dist/source/latex/breakurl/breakurl.dtx b/Master/texmf-dist/source/latex/breakurl/breakurl.dtx
index 0adac7a40ac..fca7e8d8bd4 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>
- [2009/01/24 v1.30 Breakable hyperref URLs]
+ [2013/04/10 v1.40 Breakable hyperref URLs]
%</package>
%<*driver>
\documentclass{ltxdoc}
@@ -43,7 +43,7 @@
%</driver>
% \fi
-% \CheckSum{391}
+% \CheckSum{401}
% \CharacterTable
@@ -62,6 +62,7 @@
% Grave accent \` Left brace \{ Vertical bar \|
% Right brace \} Tilde \~}
%
+% \changes{v1.40}{2013/04/10}{New `anythingbreaks' option}
% \changes{v1.30}{2009/01/24}{Breaks are now allowed before percent signs}
% \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
@@ -90,8 +91,8 @@
% \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{January 24, 2009}
+% \texttt{breakurl@vilarneto.com}}
+% \date{April 10, 2013}
%
% \maketitle
%
@@ -211,6 +212,13 @@
% \item |hyphenbreaks|\par
% Instructs the package to allow line breaks after hyphens.
%
+% \item |anythingbreaks|\par
+% Instructs the package to allow line breaks everywhere. This may be used as
+% a last-resort workaround when working with really, \emph{really} long URLs
+% that generate bad-looking outputs. You may see strange crowds of bracket
+% couples in the logs --- but, hey, you are the one that asked for trouble
+% anyway.
+%
% \item |preserveurlmacro|\par
% Instructs the package to leave the |\url| command exactly as it was before
% the package inclusion. Also, |\urlalt| isn't defined as a synonym of
@@ -251,6 +259,8 @@
%
% \begin{description}
%
+% \item[v1.40] New \texttt{anythingbreaks} option.
+%
% \item[v1.30] Breaks are now allowed before percent sign (|%|).
%
% \item[v1.23] |\hypersetup| now works anywhere.
@@ -323,9 +333,9 @@
% |\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.
+% However, this is related to old versions of \pkg{hyperref}. Currently 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
@@ -350,17 +360,22 @@
% As a drawback word spacing becomes terrible, but now the text is kept
% inside designed margins. You should decide what looks better.
%
+% \item Umesh Vishwakarma reports that \pkg{breakurl} has issues \texttt{dv2dt}
+% and \texttt{dt2dv} tools. Unfortunately I don't have time to track this
+% down (actually I don't even know these tools), so contributions are
+% welcome.
+%
% \end{itemize}
%
% \subsection{Acknowledgments}
%
-% 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, Adrian Vogel, Yu Zhang,
-% 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 thousands of people in the beautiful world of \TeX{}
-% and \LaTeX.
+% Thanks to Hendri Adriaens, Donald Arseneau, Dominik Derigs, Michael Friendly,
+% Morten Høgholm, David Le Kim, Damian Menscher, Tristan Miller, Heiko
+% Oberdiek, Christoph Schiller, Xiaotian Sun, Michael Toews, David Tulloh,
+% Adrian Vogel, Yu Zhang, 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 thousands of
+% people in the beautiful world of \TeX{} and \LaTeX.
%
%
% \section{Source code}
@@ -383,6 +398,7 @@
% Dummy package options
\DeclareOptionX{preserveurlmacro}{}
\DeclareOptionX{hyphenbreaks}{}
+ \DeclareOptionX{anythingbreaks}{}
\DeclareOptionX{vertfit}{}
\ProcessOptionsX\relax
@@ -417,6 +433,7 @@
\newif\if@preserveurlmacro\@preserveurlmacrofalse
\newif\if@burl@fitstrut\@burl@fitstrutfalse
\newif\if@burl@fitglobal\@burl@fitglobalfalse
+\newif\if@burl@anythingbreaks\@burl@anythingbreaksfalse
% \end{macrocode}
% \DescribeMacro{\burl@toks}
@@ -500,6 +517,9 @@
\hyper@normalise\burl@addtocharlistafter{-}%
\egroup
}
+\DeclareOptionX{anythingbreaks}{%
+ \@burl@anythingbreakstrue
+}
\DeclareOptionX{vertfit}[local]{\burl@setvertfit{#1}}
\ProcessOptionsX\relax
@@ -632,7 +652,7 @@
\burl@urltext\do{%
\if@burl@breakafter\@burl@prevbreakaftertrue
\else\@burl@prevbreakafterfalse\fi
- \@burl@breakbeforefalse
+ \if@burl@anythingbreaks\@burl@breakbeforetrue\else\@burl@breakbeforefalse\fi
\@burl@breakafterfalse
\expandafter\burl@mif\burl@mfi
\if@burl@breakbefore