diff options
author | Norbert Preining <preining@logic.at> | 2006-10-04 08:43:01 +0000 |
---|---|---|
committer | Norbert Preining <preining@logic.at> | 2006-10-04 08:43:01 +0000 |
commit | ba9472aebfed07843bc4faa00c7b96bc86194691 (patch) | |
tree | 4a952a012e2f1663beaac6384dec265fb50dd361 /Master/texmf-dist/source/latex/breakurl/breakurl.dtx | |
parent | a88bdfe70c672cfced299babf0a54881a916bcca (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/breakurl.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/breakurl/breakurl.dtx | 92 |
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{% |