Welcome to Scribd, the world's digital library. Read, publish, and share books and documents. See more
Standard view
Full view
of .
Look up keyword
Like this
0 of .
Results for:
No results containing your search query
P. 1


Ratings: (0)|Views: 2|Likes:
Published by vibhore1980

More info:

Published by: vibhore1980 on Feb 08, 2013
Copyright:Attribution Non-commercial


Read on Scribd mobile: iPhone, iPad and Android.
download as PDF, TXT or read online from Scribd
See more
See less





version 3.3
Donald Arseneauedited as a L
TEX document by Robin Fairbairns2006-04-12, documentation 2010-01-20
The package defines a form of 
command that allows linebreaks atcertain characters or combinations of characters, accepts reconfiguration, andcan usually be used in the argument to another command. It is intended foremail addresses, hypertext links, directories/paths, etc., which normally haveno spaces. The font used may be selected using the
command, andnew url-like commands may be defined using
.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 andnot “
” or a space. The same restrictions apply as aboveexcept that the argument may contain unbalanced braces.
for “
a defined-url; such a command can be usedanywhere, no matter what characters it contains.The “
” command is fragile, and its argument is likely to be very fragile,but a defined-url is robust.
1 Package options
Package Option:
Ordinarily, all spaces are ignored in the url-text. The “
” op-tion 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 “
”,and if you need both spaces and backslashes, use a defined-url.Package Option:
Ordinarily, breaks are not allowed after “
” characters because this leads toconfusion. (Is the “
” part of the address or just a hyphen?)The package option “
” allows breaks after explicit hyphen char-acters. The
command will
never ever
hyphenate words.Package Option:
Likewise, breaks are not usually allowed after spaces under the “
option, but if you give the options “
will allowbreaks at those spaces.1
Note that it seems logical to allow the sole option “
” to letinput spaces indicate break points, but not to display them in theoutput. This would be easy to implement, but is left out to avoid(?)confusion.Package Option:
Normal treatment of the
character is to use the font’s “
character, if it has one (or claims to). Otherwise, the character is faked usinga mathematical “
. The “
” option causes a faked character tobe used always (and a bit lower than usual).
2 Defining a defined-url
Take for example the email address “
" which couldnot be given (using “
” or “
”) in a caption or parbox due to the percentsign. This address can be predefined with
and then you may use “
” instead of “
in an argument, and even in a moving argument like a caption because a defined-url is robust.
3 Style
You can switch the style of printing using “
”, where “
” canbe any defined style. The pre-defined styles are “
” and “
which all allow the same linebreaks but use different fonts — the first threeselect a specific font and the “
” style uses the current text font. You candefine your own styles with different fonts and/or line-breaking by following theexplanations below. The “
” command follows whatever the currently-setstyle dictates.
4 Alternate commands
It may be desireable to have different things treated differently, each in a pre-defined style; e.g., if you want directory paths to always be in typewriter andemail addresses to be roman, then you would define new url-like commands asfollows:
In fact, this
example is exactly the
definition which ispre-defined in the package. If you look above, you will see that
is definedwith
I.e., using whatever
and other settings are already in effect.You can make a defined-url for these other styles, using the usual
command as in this example:
which makes
act like
, if the
command is defined as above. The
command would thenbe robust.
5 Defining styles
Before describing how to customize the printing style, it is best to mentionsomething about the unusual implementation of 
. Although the materialis textual in nature, and the font specification required is a text-font command,the text is actually typeset in
mode. This allows the context-sensitivelinebreaking, but also accounts for the default behavior of ignoring spaces. Nowon to defining styles.To change the font or the list of characters that allow linebreaks, you couldredefine the commands
, etc., directly inthe document, but it is better to define a new ‘url-style’ (following the exam-ple of 
) which defines all of 
, and
5.1 Changing font
command selects the font. The definition of 
doneby the pre-defined styles varies to cope with a variety of L
TEX font selectionschemes, but it could be as simple as
. Depending on thefont selected, some characters may need to be defined in the
listbecause many fonts don’t contain all the standard input characters.
5.2 Changing linebreaks
The list of characters that allow line-breaks is given by
, which have the format
for each character
.The differences are that ‘BigBreaks’ usually have a lower penalty and havedifferent breakpoints when in sequence (as in
): ‘BigBreaks’ are treatedas mathrels while ‘Breaks’ are mathbins (see The TeXbook, p.170). In particu-lar, 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
; there will be no break after a ‘Break’ character if a ‘BigBreak’ follows. Inthe case of 
it doesn’t matter whether
is a ‘Break’ or ‘BigBreak’ —the breaks are the same in either case; but for
nodes with
it isimportant to prevent breaks
the colons, and that is why colons are‘BigBreaks’.It is possible for characters to prevent breaks after the next following char-acter (I use this for parentheses). Specify these in
.You can do arbitrarily complex things with characters by making them ac-tive in math mode (mathcode hex-8000) and specifying the definition(s) in3

You're Reading a Free Preview

/*********** DO NOT ALTER ANYTHING BELOW THIS LINE ! ************/ var s_code=s.t();if(s_code)document.write(s_code)//-->