summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/url
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-12-31 23:17:24 +0000
committerKarl Berry <karl@freefriends.org>2013-12-31 23:17:24 +0000
commitdf85c77bc36e66a3a4906a68fe15b323017b457d (patch)
treec5f32c786405ec8cde14763faade1f4b98886a9d /Master/texmf-dist/tex/latex/url
parentdac9eb4e23466206cd6a88e2d40a2c7553d3283c (diff)
url (31dec13)
git-svn-id: svn://tug.org/texlive/trunk@32528 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/url')
-rw-r--r--Master/texmf-dist/tex/latex/url/url.sty209
1 files changed, 16 insertions, 193 deletions
diff --git a/Master/texmf-dist/tex/latex/url/url.sty b/Master/texmf-dist/tex/latex/url/url.sty
index 30baf537521..801214f6dfa 100644
--- a/Master/texmf-dist/tex/latex/url/url.sty
+++ b/Master/texmf-dist/tex/latex/url/url.sty
@@ -1,7 +1,7 @@
-% url.sty ver 3.3 12-Apr-2006 Donald Arseneau asnd@triumf.ca
-% Copyright 1996-2006 Donald Arseneau, Vancouver, Canada.
+% url.sty ver 3.4 16-Sep-2013 Donald Arseneau asnd@triumf.ca
+% Copyright 1996-2013 Donald Arseneau, Vancouver, Canada.
% This program can be used, distributed, and modified under the terms
-% of the LaTeX Project Public License.
+% of the LaTeX Project Public License, version 2 or later.
%
% A form of \verb that allows linebreaks at certain characters or
% combinations of characters, accepts reconfiguration, and can usually
@@ -20,14 +20,17 @@
% \urldef\xyz\url{ }
% \xyz a defined-url: "\xyz" can be used anywhere, no matter what
% characters it contains.
-% \DeclareUrlCommand\abc{settings}: makes \abc{ } like \url{ }
+% \DeclareUrlCommand\abc{settings}: makes \abc{ } like \url{ } with settings
%
-% See further instructions after "\endinput"
+% See url.tex/url.pdf for documentation. Some info after \endinput
%
+% Required catcodes during loading: letters @ = letter,
+% ` = > < . [ ] + - digits = other,
+% { } \ ~ # % $ _ ^ = their normal
% default style assignments
\def\UrlBreaks{\do\.\do\@\do\\\do\/\do\!\do\_\do\|\do\;\do\>\do\]%
- \do\)\do\,\do\?\do\'\do+\do\=\do\#}%
+ \do\)\do\,\do\?\do\&\do\'\do+\do\=\do\#}%
\def\UrlBigBreaks{\do\:\do@url@hyp}%
\def\UrlNoBreaks{\do\(\do\[\do\{\do\<}%
% any ordinary characters that aren't usually:
@@ -77,7 +80,7 @@
% \Url sets up the reading the argument verbatim if possible
\def\Url{%
\Url@movingtest
- \ifmmode\@nomatherr$\fi %$
+ \ifmmode\@inmatherr$\fi %$
\let\do\@makeother \dospecials % verbatim catcodes
\catcode`{\@ne \catcode`}\tw@ % with exceptions
\catcode`\ =10 % allow "\url {x}"
@@ -151,7 +154,7 @@
\lccode`\~`#1\lowercase{\endgroup\def~}{#2}}
\def\set@mathnolig#1{\ifnum\mathcode`#1<32768
\begingroup\lccode`\~`#1\lowercase{\endgroup
- \edef~}{\mathchar\number\mathcode`#1_{\/}}%
+ \edef~}{\mathchar\number\mathcode`#1\sb{\/}}%
\mathcode`#1=32768 \fi}
\def\Url@movingtest{\begingroup
@@ -212,7 +215,7 @@
\@ifundefined{ProvidesPackage}{
}{\ProvidesPackage
- {url}[2006/04/12 \space ver 3.3 \space Verb mode for urls, etc.]
+ {url}[2013/09/16 \space ver 3.4 \space Verb mode for urls, etc.]
\DeclareOption{hyphens}{\def\do@url@hyp{\do\-}}% allow breaks after hyphens
\DeclareOption{obeyspaces}{\let\Url@ObeySp\relax}% a flag for later
\DeclareOption{spaces}{\def\Url@sppen{\UrlBreakPenalty}}
@@ -272,190 +275,8 @@
%\ifx\urldebug\@undefined \def\urldebug{01}\fi
\endinput
-%
-% url.sty ver 3.3 12-Apr-2006 Donald Arseneau asnd@triumf.ca
-%
-% This package defines "\url", a form of "\verb" that allows linebreaks,
-% and can often be used in the argument to another command. It can be
-% configured to print in different formats, and is particularly useful for
-% hypertext links, email addresses, directories/paths, etc. The font may
-% be selected using the "\urlstyle" command and pre-defined text can be
-% stored with the "\urldef" command. New url-like commands can be defined,
-% and a "\path" command is provided this way.
-%
-% Usage: Conditions:
-% \url{ } If the argument contains any "%", "#", or "^^", or ends with
-% "\", it can't be used in the argument to another command.
-% The argument must not contain unbalanced braces.
-% \url| | ...where "|" is any character not used in the argument and not
-% "{" or a space. The same restrictions as above except that the
-% argument may contain unbalanced braces.
-% \xyz for "\xyz" a defined-url; this can be used anywhere, no matter
-% what characters it contains.
-%
-% The "\url" command is fragile, and its argument is likely to be very
-% fragile, but a defined-url is robust.
-%
-% Package Option: obeyspaces
-% Ordinarily, all spaces are ignored in the url-text. The "[obeyspaces]"
-% option allows spaces, but may introduce spurious spaces when a url
-% containing "\" characters is given in the argument to another command.
-% So if you need to obey spaces you can say "\usepackage[obeyspaces]{url}",
-% and if you need both spaces and backslashes, use a `defined-url' for
-% anything with "\".
-%
-% Package Option: hyphens
-% Ordinarily, breaks are not allowed after "-" characters because this
-% leads to confusion. (Is the "-" part of the address or just a hyphen?)
-% The package option "[hyphens]" allows breaks after explicit hyphen
-% characters. The "\url" command will *never ever* hyphenate words.
-%
-% Package Option: spaces
-% Likewise, breaks are not usually allowed after spaces under the
-% "[obeyspaces]" option, but giving the options "[obeyspaces,spaces]"
-% will allow breaks at those spaces. (Note that it seems logical to
-% allow the sole option "[spaces]" to let input spaces indicate break
-% points, but not to display them in the output. This would be easy to
-% implement, but is left out to avoid(?) confusion.)
-%
-% Package Option: lowtilde
-% Normal treatment of the ~ character is to use the font's "\textasciitilde"
-% character, if it has one (or claims to). Otherwise, the character is
-% faked using a mathematic "\sim". The "[lowtilde]" option causes a
-% faked character to be used always (and a bit lower than usual).
-%
-% Defining a defined-url:
-% Take for example the email address "myself%node@gateway.net" which could
-% not be given (using "\url" or "\verb") in a caption or parbox due to the
-% percent sign. This address can be predefined with
-% \urldef{\myself}\url{myself%node@gateway.net} or
-% \urldef{\myself}\url|myself%node@gateway.net|
-% and then you may use "\myself" instead of "\url{myself%node@gateway.net}"
-% in an argument, and even in a moving argument like a caption because a
-% defined-url is robust.
-%
-% Style:
-% You can switch the style of printing using "\urlstyle{tt}", where "tt"
-% can be any defined style. The pre-defined styles are "tt", "rm", "sf",
-% and "same" which all allow the same linebreaks but different fonts --
-% the first three select a specific font and the "same" style uses the
-% current text font. You can define your own styles with different fonts
-% and/or line-breaking by following the explanations below. The "\url"
-% command follows whatever the currently-set style dictates.
-%
-% Alternate commands:
-% It may be desireable to have different things treated differently, each
-% in a predefined style; e.g., if you want directory paths to always be
-% in typewriter and email addresses to be roman, then you would define new
-% url-like commands as follows:
-%
-% \DeclareUrlCommand\email{\urlstyle{rm}}
-% \DeclareUrlCommand\directory{\urlstyle{tt}}
-%
-% In fact, the "\directory" example is exactly the "\path" definition which
-% is pre-defined in the package. If you look above, you will see that "\url"
-% is defined with
-% \DeclareUrlCommand\url{}
-% I.e., using whatever "\urlstyle" and other settings are already in effect.
-%
-% You can make a defined-url for these other styles, using the usual
-% "\urldef" command as in this example:
-%
-% \urldef{\myself}{\email}{myself%node.domain@gateway.net}
-%
-% which makes "\myself" act like "\email{myself%node.domain@gateway.net}",
-% if the "\email" command is defined as above. The "\myself" command
-% would then be robust.
-%
-% Defining styles:
-% Before describing how to customize the printing style, it is best to
-% mention something about the unusual implementation of "\url". Although
-% the material is textual in nature, and the font specification required
-% is a text-font command, the text is actually typeset in *math* mode.
-% This allows the context-sensitive linebreaking, but also accounts for
-% the default behavior of ignoring spaces. Now on to defining styles.
-%
-% To change the font or the list of characters that allow linebreaks, you
-% could redefine the commands "\UrlFont", "\UrlBreaks", "\UrlSpecials" etc.
-% directly in the document, but it is better to define a new `url-style'
-% (following the example of "\url@ttstyle" and "\url@rmstyle") which defines
-% all of "\UrlBigbreaks", "\UrlNoBreaks", "\UrlBreaks", "\UrlSpecials", and
-% "\UrlFont".
-%
-% Changing font:
-% The "\UrlFont" command selects the font. The definition of "\UrlFont"
-% done by the pre-defined styles varies to cope with a variety of LaTeX
-% font selection schemes, but it could be as simple as "\def\UrlFont{\tt}".
-% Depending on the font selected, some characters may need to be defined
-% in the "\UrlSpecials" list because many fonts don't contain all the
-% standard input characters.
-%
-% Changing linebreaks:
-% The list of characters that allow line-breaks is given by "\UrlBreaks"
-% and "\UrlBigBreaks", which have the format "\do\c" for character "c".
-% The differences are that `BigBreaks' usually have a lower penalty and have
-% different breakpoints when in sequence (as in "http://"): `BigBreaks'
-% are treated as mathrels while `Breaks' are mathbins (see The TeXbook,
-% p.170). In particular, a series of `BigBreak' characters will break at
-% the end and only at the end; a series of `Break' characters will break
-% after the first and after every following *pair*; there will be no
-% break after a `Break' character if a `BigBreak' follows. In the case
-% of "http://" it doesn't matter whether ":" is a `Break' or `BigBreak' --
-% the breaks are the same in either case; but for DECnet nodes with "::"
-% it is important to prevent breaks *between* the colons, and that is why
-% colons are `BigBreaks'.
-%
-% It is possible for characters to prevent breaks after the next following
-% character (I use this for parentheses). Specify these in "\UrlNoBreaks".
-%
-% You can do arbitrarily complex things with characters by making them
-% active in math mode (mathcode hex-8000) and specifying the definition(s)
-% in "\UrlSpecials". This is used in the rm and sf styles for OT1 font
-% encoding to handle several characters that are not present in those
-% computer-modern style fonts. See the definition of "\Url@do", which
-% is used by both "\url@rmstyle" and "\url@sfstyle"; it handles missing
-% characters via "\UrlSpecials". The nominal format for setting each
-% special character "c" is: "\do\c{<definition>}", but you can include
-% other definitions too.
-%
-% If all this sounds confusing ... well, it is! But I hope you won't need
-% to redefine breakpoints -- the default assignments seem to work well for
-% a wide variety of applications. If you do need to make changes, you can
-% test for breakpoints using regular math mode and the characters "+=(a".
-%
-% You can allow some spacing around the breakable characters by assigning
-% \Urlmuskip = 0mu plus 1mu
-% You can change the penalties used for BigBreaks and Breaks by assigning
-% \mathchardef\UrlBreakPenalty=100 \mathchardef\UrlBigBreakPenalty=100
-% The default penalties are "\binoppenalty" and "\relpenalty". These have
-% such odd non-LaTeX syntax because I don't expect people to need to
-% change them often.
-%
-% Yet more flexibility:
-% You can also customize the verbatim text by defining "\UrlRight" and/or
-% "\UrlLeft", e.g., for ISO formatting of urls surrounded by "< >", define
-%
-% \DeclareUrlCommand\url{\def\UrlLeft{<url:\ }\def\UrlRight{>}%
-% \urlstyle{tt}}
-%
-% The meanings of "\UrlLeft" and "\UrlRight" are *not* reproduced verbatim.
-% This lets you use formatting commands there, but you must be careful not
-% to use TeX's special characters ("\^_%~#$&{}" etc.) improperly.
-% You can also define "\UrlLeft" to reprocess the verbatim text, but the
-% format of the definition is special:
-%
-% \def\UrlLeft#1\UrlRight{ ... do things with #1 ... }
-%
-% Yes, that is "#1" followed by "\UrlRight" then the definition. For
-% example, to put a hyperTeX hypertext link in the DVI file:
-%
-% \def\UrlLeft#1\UrlRight{\special{html:<a href="#1">}#1\special{html:</a>}}
-%
-% Using this technique, url.sty can provide a convenient interface for
-% performing various operations on verbatim text. You don't even need
-% to print out the argument! For greatest efficiency in such obscure
-% applications, you can define a null url-style where all the lists like
-% "\UrlBreaks" are empty.
+% For documentation, please see accompanying url.tex (url.pdf)
+% Package Options: obeyspaces, hyphens, spaces, lowtilde
%
% Revision History:
% ver 1.1 6-Feb-1996:
@@ -483,6 +304,8 @@
% a little; fix \lowercase error in \UrlSpecials handling.
% ver 3.3 April 2006:
% Fix some encoding bugs and remove 8-bit characters. lowtilde option
+% ver 3.4 Sept 2013:
+% \@nomatherr->\@inmatherr. & is now another \UrlBreak character.
% The End
Test file integrity: ASCII 32-57, 58-126: !"#$%&'()*+,-./0123456789