From 7428e668f046bec10d1200214789e40390fa51e7 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Wed, 10 Feb 2021 03:01:13 +0000 Subject: CTAN sync 202102100301 --- .../latex/contrib/hyperref/doc/hyperref-doc.html | 920 +++++++++++---------- 1 file changed, 476 insertions(+), 444 deletions(-) (limited to 'macros/latex/contrib/hyperref/doc/hyperref-doc.html') diff --git a/macros/latex/contrib/hyperref/doc/hyperref-doc.html b/macros/latex/contrib/hyperref/doc/hyperref-doc.html index 7b4ce3d361..7b919801b2 100644 --- a/macros/latex/contrib/hyperref/doc/hyperref-doc.html +++ b/macros/latex/contrib/hyperref/doc/hyperref-doc.html @@ -25,7 +25,7 @@ href="https://github.com/latex3/hyperref/issues" class="url" >https://github.com/latex3/hyperref/issues)
2021-02-07 v7.00h
+class="ec-lmr-12">2021-02-08 v7.00i

Contents

@@ -122,69 +122,71 @@ href="#x1-450005.25" id="QQ2-1-45">Default driver setting href="#x1-460005.26" id="QQ2-1-46">Backref entries
  5.27 \phantomsection +
  5.28 puenc encoding and puenc-extra.def
 6 Acrobat-specific behavior +href="#x1-490006" id="QQ2-1-49">Acrobat-specific behavior
 7 PDF and HTML forms +href="#x1-500007" id="QQ2-1-50">PDF and HTML forms
  7.1 Forms environment parameters +href="#x1-510007.1" id="QQ2-1-51">Forms environment parameters
  7.2 Forms optional parameters +href="#x1-520007.2" id="QQ2-1-52">Forms optional parameters
 8 Defining a new driver +href="#x1-530008" id="QQ2-1-53">Defining a new driver
 9 Special support for other packages +href="#x1-540009" id="QQ2-1-54">Special support for other packages
  9.1 Package Compatibility +href="#x1-550009.1" id="QQ2-1-55">Package Compatibility
 10 Limitations +href="#x1-9900010" id="QQ2-1-99">Limitations
  10.1 Wrapped/broken link support +href="#x1-10000010.1" id="QQ2-1-100">Wrapped/broken link support
  10.2 Links across pages +href="#x1-10100010.2" id="QQ2-1-101">Links across pages
  10.3 Footnotes +href="#x1-10200010.3" id="QQ2-1-102">Footnotes
 11 Hints +href="#x1-10300011" id="QQ2-1-103">Hints
  11.1 Spaces in option values +href="#x1-10400011.1" id="QQ2-1-104">Spaces in option values
  11.2 Index with makeindex +href="#x1-10500011.2" id="QQ2-1-105">Index with makeindex
  11.3 Warning Warning "bookmark level for unknown <foobar> defaults to 0"
  11.4 Link anchors in figures +href="#x1-10700011.4" id="QQ2-1-107">Link anchors in figures
  11.5 Additional unicode characters in bookmarks and pdf information entries: +href="#x1-10800011.5" id="QQ2-1-108">Additional unicode characters in bookmarks and pdf information entries:
  11.6 Footnotes +href="#x1-10900011.6" id="QQ2-1-109">Footnotes
  11.7 Subordinate counters +href="#x1-11000011.7" id="QQ2-1-110">Subordinate counters
 12 History and acknowledgments +href="#x1-11100012" id="QQ2-1-111">History and acknowledgments
 13 GNU Free Documentation License +href="#x1-11200013" id="QQ2-1-112">GNU Free Documentation License
  13.1 Applicability and definitions +href="#x1-11400013.1" id="QQ2-1-114">Applicability and definitions
  13.2 Verbatim copying +href="#x1-11500013.2" id="QQ2-1-115">Verbatim copying
  13.3 Copying in quantity +href="#x1-11600013.3" id="QQ2-1-116">Copying in quantity
  13.4 Modifications +href="#x1-11700013.4" id="QQ2-1-117">Modifications
  13.5 Combining documents +href="#x1-11800013.5" id="QQ2-1-118">Combining documents
  13.6 Collections of documents +href="#x1-11900013.6" id="QQ2-1-119">Collections of documents
  13.7 Aggregation with independent works +href="#x1-12000013.7" id="QQ2-1-120">Aggregation with independent works
  13.8 Translation +href="#x1-12100013.8" id="QQ2-1-121">Translation
  13.9 Termination +href="#x1-12200013.9" id="QQ2-1-122">Termination
  13.10 Future revisions of this license +href="#x1-12300013.10" id="QQ2-1-123">Future revisions of this license @@ -2138,7 +2140,7 @@ class="td01"> is not the same as TeX’s. The unit is bp and the origin is in the lower left corner. See also \hypercalcbp that is explained on page 46. pdfTeX works by supplying default values for 47. pdfTeX works by supplying default values for XYZ (horizontal × vertical true

Unicode encoded pdf strings, starting with - version 2021-02-07 v7.00h set by default to - true for all engines. + version v7.00g set by default to true for all + engines. It will load a number of definitions in + puenc.def. It can be set to false for pdflatex, + but this is not recommended. URL}}. Depending on the driver \href also tries to detect the link type. Thus the result can be a url link, file link, … + +

URL}

Write URL in the same way as \url, without creating a hyperlink. - +class="ec-lmvtt-10">\url, without creating a hyperlink.

\phantomsection

This sets an anchor at this location. It works similar to \hypertarget{}{} with an automatically chosen + anchor name. Often it is used in conjunction with \addcontentsline for sectionlike things (index, bibliography, preface).

Now the entry in the table of contents (and bookmarks) for the index points to the start of the index page, not to a location before this page. -

+

+

5.28 puenc encoding and puenc-extra.def

+

The unicode option loads for the bookmarks puenc.def which contains quite a lot definitions of +commands for the bookmarks. As unicode is now true for all engines, this file is now also loaded with +pdflatex. Some of the definitions in puenc.def clash with other uses. To reduce the impact hyperref uses +two strategies. +

+

6 Acrobat-specific behavior

-

If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided + id="x1-490006">Acrobat-specific behavior +

If you want to access the menu options of Acrobat Reader or Exchange, the following macro is provided in the appropriate drivers: -

+

}{text}
-

The

The text is used to create a button which activates the appropriate menuoption. The following table lists the option names you can use—comparison of this with the menus in Acrobat Reader or Exchange will show what they do. Obviously some are only appropriate to Exchange.

+ + class="td01">FileExport - - +

Properties

+ + - - + + - - +

About

@@ -5282,13 +5312,13 @@ class="td01"> class="td01">
File -

Open, +

Open, Close, Scan, Save, @@ -5097,7 +5129,7 @@ class="td10"> class="td01">FileImport

-

ImportImage, +

ImportImage, ImportNotes, AcroForm:ImportFDF

-

ExportNotes, +

ExportNotes, AcroForm:ExportFDF

FileDocumentInfo -

GeneralInfo, +

GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, Weblink:Base, AutoIndex:DocInfo

FilePreferences -

GeneralPrefs, +

GeneralPrefs, NotePrefs, FullScreenPrefs, Weblink:Prefs, @@ -5137,7 +5167,7 @@ class="td10"> style="vertical-align:baseline;" id="TBL-41-6-">

Edit -

Undo, +

Undo, Cut, Copy, Paste, @@ -5153,19 +5183,21 @@ class="td10"> style="vertical-align:baseline;" id="TBL-41-7-">

-

Properties

EditFields -

AcroForm:Duplicate, +

AcroForm:Duplicate, AcroForm:TabOrder

Document -

Cpt:CapturePages, +

Cpt:CapturePages, AcroForm:Actions, CropPages, RotatePages, @@ -5177,13 +5209,11 @@ class="td10"> SetBookmarkDest, CreateAllThumbs, DeleteAllThumbs

View -

ActualSize, +

ActualSize, FitVisible, FitWidth, FitPage, @@ -5207,7 +5237,7 @@ class="td10"> style="vertical-align:baseline;" id="TBL-41-11-">

Tools -

Hand, +

Hand, ZoomIn, ZoomOut, SelectText, @@ -5222,12 +5252,14 @@ class="td10"> FindAgain, FindNextNote, CreateNotesFile

ToolsSearch -

AcroSrch:Query, +

AcroSrch:Query, AcroSrch:Indexes, AcroSrch:Results, AcroSrch:Assist, @@ -5235,13 +5267,11 @@ class="td10"> AcroSrch:PrevHit, AcroSrch:NextHit, AcroSrch:NextDoc

Window -

ShowHideToolBar, +

ShowHideToolBar, ShowHideMenuBar, ShowHideClipboard, Cascade, @@ -5252,7 +5282,7 @@ class="td10"> style="vertical-align:baseline;" id="TBL-41-14-">

Help -

HelpUserGuide, +

HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, @@ -5267,7 +5297,7 @@ class="td10"> style="vertical-align:baseline;" id="TBL-41-15-">

Help(Windows) -

About

-

+

7 PDF and HTML forms

-

You must put your fields inside a PDF and HTML forms +

You must put your fields inside a Form environment (only one per file). -

There are six macros to prepare fields: -

+

There are six macros to prepare fields: +

]{label}
-

+

]{label}
-

+

+ +

}{choices}
-

+

]{label}
-

- - +

]{label}
-

+

]{label}
-

The way forms and their labels are laid out is determined by: -

+

The way forms and their labels are laid out is determined by: +

}{field}
-

+

}{field}
-

+

}{field}
-

These macros default to #1 #2 -

What is actually shown in the field is determined by: -

+

These macros default to #1 #2 +

What is actually shown in the field is determined by: +

}{height}
-

+

}{height}
-

+

}{height}
-

+

}{height}
-

+

+ +

\MakeButtonField{text}
-

These macros default to

These macros default to \vbox to #2{\hbox #1{\hfill}\vfill}, except the l to #1; it is used for buttons, and the special \Submit and \Reset macros. -

You may also want to redefine the following macros: +

You may also want to redefine the following macros:

@@ -5513,12 +5545,12 @@ class="ec-lmvtt-10">\Reset macros.
 \def\DefaultHeightofTextMultiline{4\baselineskip}
 \def\DefaultWidthofText{3cm}
 
-

-

+

+

7.1 Forms environment parameters

+ id="x1-510007.1">Forms environment parameters
action encoding method @@ -5573,15 +5605,15 @@ class="td01">
URL -

The URL that will receive the form data if a

The URL that will receive the form data if a Submit button is included in the form

name -

The encoding for the string set to the URL; FDF-encoding +

The encoding for the string set to the URL; FDF-encoding is usual, and html is the only valid value

name -

Used only when generating HTML; values can be

Used only when generating HTML; values can be post or get

-

+

7.2 Forms optional parameters

-

Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. Forms optional parameters +

Note that all colors must be expressed as RGB triples, in the range 0..1 (i.e. color=0 0 0.5)

style="vertical-align:baseline;" id="TBL-57-63-">
-

+

8 Defining a new driver

-

A hyperref driver has to provide definitions for eight macros: -

1. Defining a new driver +

A hyperref driver has to provide definitions for eight macros: +

1. \hyper@anchor -

2.

2. \hyper@link -

3.

3. \hyper@linkfile -

4.

4. \hyper@linkurl -

5.

5. \hyper@anchorstart -

6.

6. \hyper@anchorend -

7.

7. \hyper@linkstart -

8.

8. \hyper@linkend -

The draft option defines the macros as follows +

The draft option defines the macros as follows

@@ -6068,11 +6100,11 @@ class="ec-lmvtt-10">\hyper@linkend
 \let\hyper@linkstart\@gobbletwo
 \let\hyper@linkend\@empty
 
-

-

+

+

9 Special support for other packages

-

Package Special support for other packages +

Package hyperref aims to cooperate with other packages, but there are several possible sources for conflict, such as

-

The

The hyperref package is distributed with variants on two useful packages designed to work especially well with it. These are xr and minitoc, which support crossdocument links using \label/\ref mechanisms and per-chapter tables of contents, respectively. -

+

9.1 Package Compatibility

-

Currently only package loading orders are available: -

Note: hyperref loads package Package Compatibility +

Currently only package loading orders are available: +

Note: hyperref loads package nameref at \begin{document}. Sometimes this is too late, thus this package must be loaded earlier. -

+

9.1.1 algorithm
+ id="x1-560009.1.1">algorithm
@@ -6121,11 +6153,11 @@ package must be loaded earlier.
   \usepackage{hyperref}
   \usepackage[chapter]{algorithm}% eg.
 
-

-

+

+

9.1.2 amsmath
-

The environments equation and eqnarray are not supported too well. For example, there might be + id="x1-570009.1.2">amsmath +

The environments equation and eqnarray are not supported too well. For example, there might be spacing problems (eqnarray isn’t recommended anyway, see CTAN:info/l2tabu/, the situation for equation is unclear, because nobody is interested in investigating). Consider using the environments that package amsmath provide, e.g. gather for equation. The environment equation can even redefined to use @@ -6137,22 +6169,22 @@ gather:   \let\equation\gather   \let\endequation\endgather -

-

+

+

9.1.3 amsrefs
-

Package loading order: + id="x1-580009.1.3">amsrefs +

Package loading order:

   \usepackage{hyperref}
   \usepackage{amsrefs}
 
-

-

+

+

9.1.4 arydshln, longtable
-

Package longtable must be put before hyperref and arydshln, hyperref after arydshln generates an error, + id="x1-590009.1.4">arydshln, longtable +

Package longtable must be put before hyperref and arydshln, hyperref after arydshln generates an error, thus the resulting package order is then: @@ -6161,16 +6193,16 @@ thus the resulting package order is then:   \usepacakge{hyperref}   \usepackage{arydshln} -

-

+

+

9.1.5 babel/magyar.ldf
-

The old version 2005/03/30 v1.4j will not work. You need at least version 1.5, maintained by Péter + id="x1-600009.1.5">babel/magyar.ldf +

The old version 2005/03/30 v1.4j will not work. You need at least version 1.5, maintained by Péter Szabó, see CTAN:language/hungarian/babel/. -

+

9.1.6 babel/spanish.ldf
-

Babel’s spanish.ldf redefines ‘babel/spanish.ldf +

Babel’s spanish.ldf redefines ‘\.’ to support ‘\...’. In bookmarks (\pdfstringdef) only ‘\.’ is supported. If ‘\...’ is needed, \texorpdfstring{\...}{\dots} can be used instead. -

+

9.1.7 bibentry
-

Workaround: + id="x1-620009.1.7">bibentry +

Workaround:

@@ -6200,16 +6232,16 @@ class="ec-lmvtt-10">\texorpdfstring{\...}{\dots} can be use
     \nobibliography{database}
   \endgroup
 
-

-

+

+

9.1.8 bigfoot
-

Hyperref does not support package ‘bigfoot’. And package ‘bigfoot’ does not support hyperref’s footnotes + id="x1-630009.1.8">bigfoot +

Hyperref does not support package ‘bigfoot’. And package ‘bigfoot’ does not support hyperref’s footnotes and disables them (hyperfootnotes=false). -

+

9.1.9 chappg
-

Package ‘chappg’ uses chappg +

Package ‘chappg’ uses \@addtoreset that is redefined by ‘hyperref’. The package order is therefore: @@ -6218,11 +6250,11 @@ therefore:   \usepackage{hyperref}   \usepackage{chappg} -

-

+

+

9.1.10 cite
-

This is from Mike Shell: cite.sty cannot currently be used with hyperref. However, I can do a workaround + id="x1-650009.1.10">cite +

This is from Mike Shell: cite.sty cannot currently be used with hyperref. However, I can do a workaround via: @@ -6233,14 +6265,14 @@ via:  \usepackage[hypertex]{hyperref} -

-

so that hyperref will not redefine any of the biblabel stuff - so cite.sty will work as normal - +

+

so that hyperref will not redefine any of the biblabel stuff - so cite.sty will work as normal - although the citations will not be hyperlinked, of course (But this may not be an issue for many people). -

+

9.1.11 count1to
-

Package ‘count1to’ adds several count1to +

Package ‘count1to’ adds several \@addtoreset commands that confuse ‘hyperref’. Therefore \theH<...> has to be fixed: @@ -6256,27 +6288,27 @@ has to be fixed:     \renewcommand*{\theHsubparagraph}{\theHparagraph.\arabic{subparagraph}}%   } -

-

+

+

9.1.12 dblaccnt
-

pd1enc.def or puenc.def should be loaded before: + id="x1-670009.1.12">dblaccnt +

pd1enc.def or puenc.def should be loaded before:

   \usepackage{hyperref}
   \usepackage{dblaccnt}
 
-

or see entry for

or see entry for vietnam. -

+

9.1.13 easyeqn
-

Not compatible, breaks. -

+ id="x1-680009.1.13">easyeqn +

Not compatible, breaks. +

9.1.14 ellipsis
-

This packages redefines ellipsis +

This packages redefines \textellipsis after package hyperref (pd1enc.def/puenc.def should be loaded before): @@ -6285,46 +6317,46 @@ before):   \usepackage{hyperref}   \usepackage{ellipsis} -

-

+

+

9.1.15 float
+ id="x1-700009.1.15">float
  \usepackage{float}
   \usepackage{hyperref}
 
-

+

-

+

9.1.16 endnotes
-

Unsupported. -

+ id="x1-710009.1.16">endnotes +

Unsupported. +

9.1.17 foiltex
-

Update to version 2008/01/28 v2.1.4b: Since version 6.77a hyperref does not hack into foiltex +

Update to version 2008/01/28 v2.1.4b: Since version 6.77a hyperref does not hack into \@begindvi, it uses package ‘atbegshi’ instead, that hooks into \shipout. Thus the patch of ‘foils.cls’ regarding hyperref is now obsolete and causes an undefined error message about \@hyperfixhead. This is fixed in FoilTeX 2.1.4b. -

+

9.1.18 footnote
-

This package is not supported, you have to disable hyperref’s footnote support by using option + id="x1-730009.1.18">footnote +

This package is not supported, you have to disable hyperref’s footnote support by using option hyperfootnotes=false. -

+

9.1.19 geometry
-

Driver ‘dvipdfm’ and program ‘dvipdfm’ might generate a warning: Sorry. Too late to change page size + id="x1-740009.1.19">geometry +

Driver ‘dvipdfm’ and program ‘dvipdfm’ might generate a warning: Sorry. Too late to change page size Then prefer the program ‘dvipdfmx’ or use one of the following workarounds to move the \special of geometry to an earlier location: @@ -6357,36 +6389,36 @@ geometry to an earlier location:     ]{geometry}     \usepackage{hyperref} -

-

+

+

9.1.20 IEEEtran.cls
-

version IEEEtran.cls +

version V1.6b (because of \@makecaption, see ChangeLog) -

+

9.1.21 index
-

version index +

version 1995/09/28 v4.1 (because of \addcontentsline redefinition) -

+

9.1.22 lastpage
-

Compatible. -

+ id="x1-770009.1.22">lastpage +

Compatible. +

9.1.23 linguex
+ id="x1-780009.1.23">linguex
  \usepackage{hyperref}
   \usepackage{linguex}
 
-

-

+

+

9.1.24 ltabptch
+ id="x1-790009.1.24">ltabptch
@@ -6394,54 +6426,54 @@ class="ec-lmvtt-10">\addcontentsline redefinition)
   \usepackage{ltabptch}
   \usepackage{hyperref}
 
-

-

+

+

9.1.25 mathenv
-

Unsupported. -

Both ‘mathenv’ and ‘hyperref’ messes around with environment ‘eqnarray’. You can load ‘mathenv’ + id="x1-800009.1.25">mathenv +

Unsupported. +

Both ‘mathenv’ and ‘hyperref’ messes around with environment ‘eqnarray’. You can load ‘mathenv’ after ‘hyperref’ to avoid an error message. But \label will not work inside environment ‘eqnarray’ properly, for example. -

+

9.1.26 minitoc-hyper
-

This package is obsolete, use the up-to-date original package minitoc instead. -

+ id="x1-810009.1.26">minitoc-hyper +

This package is obsolete, use the up-to-date original package minitoc instead. +

9.1.27 multind
+ id="x1-820009.1.27">multind
  \usepackage{multind}
   \usepackage{hyperref}
 
-

-

+

+

9.1.28 natbib
+ id="x1-830009.1.28">natbib
  \usepackage{natbib}
   \usepackage{hyperref}
 
-

-

+

+

9.1.29 nomencl
-

Example for introducing links for the page numbers: + id="x1-840009.1.29">nomencl +

Example for introducing links for the page numbers:

       \renewcommand*{\pagedeclaration}[1]{\unskip, \hyperpage{#1}}
 
-

-

+

+

9.1.30 ntheorem-hyper
-

This package is obsolete, use the up-to-date original package ntheorem instead. -

For equations the following might work: + id="x1-850009.1.30">ntheorem-hyper +

This package is obsolete, use the up-to-date original package ntheorem instead. +

For equations the following might work:

@@ -6451,22 +6483,22 @@ properly, for example.
     But the mapping from the equation number to the anchor name
     is not available in general.
 
-

-

+

+

9.1.31 parskip
+ id="x1-860009.1.31">parskip
  \usepackage{parskip}
   \usepackage{hyperref}[2012/08/20]
 
-

-

Both packages want to redefine

+

Both packages want to redefine \@starttoc. -

+

9.1.32 prettyref
+ id="x1-870009.1.32">prettyref
@@ -6489,20 +6521,20 @@ class="ec-lmvtt-10">\@starttoc.
 %%% example for prettyref %%%
       
 
-

-

+

+

9.1.33 setspace
+ id="x1-880009.1.33">setspace
  \usepackage{setspace}
   \usepackage{hyperref}
 
-

-

+

+

9.1.34 sidecap
+ id="x1-890009.1.34">sidecap
@@ -6511,10 +6543,10 @@ class="ec-lmvtt-10">\@starttoc.
     \usepackage{hyperref}
     \usepackage{sidecap}
 
-

-

+

+

9.1.35 subfigure
+ id="x1-900009.1.35">subfigure
@@ -6536,10 +6568,10 @@ class="ec-lmvtt-10">\@starttoc.
     \usepackage{subfigure}
     or vice versa?
 
-

-

+

+

9.1.36 titleref
+ id="x1-910009.1.36">titleref
@@ -6547,24 +6579,24 @@ class="ec-lmvtt-10">\@starttoc.
   \usepackage{titleref}% without usetoc
   \usepackage{hyperref}
 
-

-

+

+

9.1.37 tabularx
-

Linked footnotes are not supported inside environment ‘tabularx’, because they uses the optional + id="x1-920009.1.37">tabularx +

Linked footnotes are not supported inside environment ‘tabularx’, because they uses the optional argument of \footnotetext, see section ‘Limitations’. Before version 2011/09/28 6.82i hyperref had disabled footnotes entirely by ‘hyperfootnotes=false’. -

+

9.1.38 titlesec
-

titlesec +

nameref supports titlesec, but hyperref does not (unsolved is the anchor setting, missing with unnumbered section, perhaps problems with page breaks with numbered ones). -

+

9.1.39 ucs/utf8x.def
-

The first time a multibyte UTF8 sequence is called, it does some calculations and stores the result in a + id="x1-940009.1.39">ucs/utf8x.def +

The first time a multibyte UTF8 sequence is called, it does some calculations and stores the result in a macro for speeding up the next calls of that UTF8 sequence. However this makes the first call non-expandable and will break if used in information entries or bookmarks. Package ucs offers @@ -6580,14 +6612,14 @@ class="ec-lmvtt-10">\PreloadUnicodePage to solve this:     \PrerenderUnicode{^^c3^^b6}% or \PrerenderUnicodePage{1}     \hypersetup{pdftitle={Umlaut example: ^^c3^^b6}} -

The notation with two carets avoids trouble with 8-bit bytes for the README file, you can use the +

The notation with two carets avoids trouble with 8-bit bytes for the README file, you can use the characters directly. -

+

9.1.40 varioref
-

There are too many problems with varioref. Nobody has time to sort them out. Therefore this package is + id="x1-950009.1.40">varioref +

There are too many problems with varioref. Nobody has time to sort them out. Therefore this package is now unsupported. -

Perhaps you are lucky and some of the features of varioref works with the following loading +

Perhaps you are lucky and some of the features of varioref works with the following loading order: @@ -6596,10 +6628,10 @@ order:     \usepackage{varioref}     \usepackage{hyperref} -

-

Also some babel versions can be problematic. For example, 2005/05/21 v3.8g contains a patch for +

+

Also some babel versions can be problematic. For example, 2005/05/21 v3.8g contains a patch for varioref that breaks the hyperref support for varioref. -

Also unsupported: +

Also unsupported:

-

+

9.1.41 verse
-

Version 2005/08/22 v2.22 contains support for hyperref. -

For older versions see example from de.comp.text.tex (2005/08/11, slightly modified): + id="x1-960009.1.41">verse +

Version 2005/08/22 v2.22 contains support for hyperref. +

For older versions see example from de.comp.text.tex (2005/08/11, slightly modified):

@@ -6656,10 +6688,10 @@ class="ec-lmvtt-10">\vpageref[]{...} On the same page a pre
 
   \end{document}
 
-

-

+

+

9.1.42 vietnam
+ id="x1-970009.1.42">vietnam
@@ -6668,20 +6700,20 @@ class="ec-lmvtt-10">\vpageref[]{...} On the same page a pre
   \usepackage{vietnam}
   \usepackage{hyperref}
 
-

-

+

+

9.1.43 XeTeX
-

Default for the encoding of bookmarks is XeTeX +

Default for the encoding of bookmarks is pdfencoding=unicode. That means the strings are always treated as unicode strings. If auto or pdfdoc is forced it applies only if the string restricts to the printable ASCII set, The reason is that the \special does not support PDFDocEncoding. -

In older versions hyperref contained special conversion code from UTF-16BE back to UTF-8 in a +

In older versions hyperref contained special conversion code from UTF-16BE back to UTF-8 in a number of places for xetex to avoid the xdvipdfmx warning -

Failed to convert input string to UTF16... -

This is no longer needed with a current xdvipdfmx, so this code has been removed. +

This is no longer needed with a current xdvipdfmx, so this code has been removed. \csname HyPsd@XeTeXBigCharstrue\endcsname should no longer be used. -

+

10 LimitationsLimitations5

+ id="x1-99001f5">

10.1 Wrapped/broken link support

-

Only few drivers support automatically wrapped/broken links, e.g. pdftex, dvipdfm, hypertex. Other + id="x1-10000010.1">Wrapped/broken link support +

Only few drivers support automatically wrapped/broken links, e.g. pdftex, dvipdfm, hypertex. Other drivers lack this feature, e.g. dvips, dvipsone. -

Workarounds: +

Workarounds:

-

+

10.2 Links across pages

-

In general they have problems: + id="x1-10100010.2">Links across pages +

In general they have problems:

-

+

10.3 Footnotes

-

LaTeX allows the separation of the footnote mark and the footnote text (Footnotes +

LaTeX allows the separation of the footnote mark and the footnote text (\footnotemark, \footnotetext). This interface might be enough for visual typesetting. But the relation between @@ -6752,14 +6784,14 @@ Thus the implementation of hyperref does not support the optional argument of \footnotemark and \footnotetext. -

+

11 HintsHints6

+ id="x1-103001f6">

11.1 Spaces in option values

-

Unhappily LaTeX strips spaces from options if they are given in Spaces in option values +

Unhappily LaTeX strips spaces from options if they are given in \documentclass or \usepackage (or \RequirePackage), e.g.:

     \usepackage[pdfborder=0 0 1]{hyperref}
 
-

Package hyperref now gets +

Package hyperref now gets

     pdfborder=001
 
-

and the result is an invalid PDF file. As workaround braces can be used: +

and the result is an invalid PDF file. As workaround braces can be used:

     \usepackage[pdfborder={0 0 1}]{hyperref}
 
-

Some options can also be given in

Some options can also be given in \hypersetup

     \hypersetup{pdfborder=0 0 1}
 
-

In

In \hypersetup the options are directly processed as key value options (see package keyval) without space stripping in the value part. -

Alternatively, LaTeX’s option handling system can be adapted to key value options by one of the +

Alternatively, LaTeX’s option handling system can be adapted to key value options by one of the packages kvoptions-patch (from project kvoptions) or xkvltxp (from project xsetkeys). -

+

11.2 Index with makeindex

+ id="x1-10500011.2">Index with makeindex -

+

+

11.3 Warning Warning "bookmark level for unknown <foobar> defaults to 0"

-

Getting rid of it: +

Getting rid of it:

@@ -6873,32 +6905,32 @@ class="ec-lmvtt-10">"bookmark level for unknown <foobar> defaults
 \providecommand*{\toclevel@<foobar>}{0}
 \makeatother
 
-

-

+

+

11.4 Link anchors in figures

-

The caption command increments the counter and here is the place where hyperref set the corresponding + id="x1-10700011.4">Link anchors in figures +

The caption command increments the counter and here is the place where hyperref set the corresponding anchor. Unhappily the caption is set below the figure, so the figure is not visible if a link jumps to a figure. In this case, try package hypcap that implements a method to circumvent the problem. -

+

11.5 Additional unicode characters in bookmarks and pdf information entries:

+ id="x1-10800011.5">Additional unicode characters in bookmarks and pdf information entries:
 \documentclass[pdftex]{article}
 \usepackage[unicode]{hyperref}
 
-

-

Support for additional unicode characters: -

Example:

+

Support for additional unicode characters: +

Example: \.{a} and \d{a} -

1. Get a list with unicode data, eg: -

http://www.unicode.org/Public/UNIDATA/UnicodeData.txt -

2. Identify the characters (

1. Get a list with unicode data, eg: +

http://www.unicode.org/Public/UNIDATA/UnicodeData.txt +

2. Identify the characters (\.{a}, \d{a}): @@ -6907,9 +6939,9 @@ class="ec-lmvtt-10">\d{a}):     0227;LATIN SMALL LETTER A WITH DOT ABOVE;...     1EA1;LATIN SMALL LETTER A WITH DOT BELOW;... -

-

3. Calculate the octal code: -

The first characters of the line in the file are hex values, convert each byte and prepend them with a +

+

3. Calculate the octal code: +

The first characters of the line in the file are hex values, convert each byte and prepend them with a backslash. (This will go into the PDF file.) @@ -6917,9 +6949,9 @@ backslash. (This will go into the PDF file.)     0227 -> \002\047     1EA1 -> \036\241 -

-

4. Transform into a form understood by hyperref: -

Hyperref must know where the first byte starts, this is marked by

+

4. Transform into a form understood by hyperref: +

Hyperref must know where the first byte starts, this is marked by 9 (8 and 9 cannot occur in octal numbers): @@ -6928,8 +6960,8 @@ numbers):     \002\047 -> \9002\047     \036\241 -> \9036\241 -

-

Optional:

+

Optional: 8 is used for abbreviations: @@ -6938,8 +6970,8 @@ class="ec-lmvtt-10">8 is used for abbreviations:     \9002\047 -> \82\047 -

-

5. Declare the character with LaTeX: +

+

5. Declare the character with LaTeX:

@@ -6951,11 +6983,11 @@ class="ec-lmvtt-10">8 is used for abbreviations:
 \end{document}
       
 
-

-

+

+

11.6 Footnotes

-

The footnote support is rather limited. It is beyond the scope to use Footnotes +

The footnote support is rather limited. It is beyond the scope to use \footnotemark and \footnotetext out of order or reusing -

+

-

+

11.7 Subordinate counters

-

Some counters do not have unique values and require the value of other counters to be unique. For + id="x1-11000011.7">Subordinate counters +

Some counters do not have unique values and require the value of other counters to be unique. For example, sections or figures might be numbered within chapters or \newtheorem is used with an optional counter argument. Internally LaTeX uses \@addtoreset to catch this situation. Also \numberwithin of package amsmath is caught by hyperref. -

However, if the definition of subordinate counters take place before hyperref is loaded, the old +

However, if the definition of subordinate counters take place before hyperref is loaded, the old meaning of \@addtoreset is called without hyperref’s additions. Then the companion counter macro \theH<counter> can be redefined accordingly. Or move the definition of subordinate counters after hyperref is loaded. -

Example for

Example for \newtheorem, problematic case: @@ -7041,14 +7073,14 @@ class="ec-lmvtt-10">\newtheorem, problematic case:     \newtheorem{corA}{CorollaryA}[section]     \usepackage{hyperref} -

Solution a) +

Solution a)

     \usepackage{hyperref}
     \newtheorem{corA}{CorollaryA}[section}
 
-

Solution b) +

Solution b)

@@ -7056,11 +7088,11 @@ class="ec-lmvtt-10">\newtheorem, problematic case:
     \usepackage{hyperref}
     \newcommand*{\theHcorA}{\theHsection.\number\value{corA}}
 
-

-

+

+

12 History and acknowledgments

-

The original authors of History and acknowledgments +

The original authors of hyperbasics.tex and hypertex.sty, from which this package descends, are Tanmoy Bhattacharya and Thorsten Ohl. Package

Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has +

Tanmoy found a great many of the bugs, and (even better) often provided fixes, which has made the package more robust. The days spent on RevTeX are entirely due to him! The investigations of Bill Moss into the later versions including native PDF support uncovered a good many bugs, and his testing is appreciated. Hans Hagen provided a lot of insight into PDF. -

Berthold Horn provided help, encouragement and sponsorship for the

Berthold Horn provided help, encouragement and sponsorship for the dvipsone and dviwindo drivers. Sergey Lesenko provided the changes needed for hyper package (developed in parallel with hyperref) showed me solutions for some problems. Hopefully the two packages will combine one day. -

The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and +

The forms creation section owes a great deal to: T. V. Raman, for encouragement, support and ideas; Thomas Merz, whose book Web Publishing with Acrobat/PDF provided crucial insights; D. P. Story, whose detailed article about pdfmarks and forms solved many practical problems; and Hans Hagen, who explained how to do it in pdftex. -

Steve Peter recreated the manual source in July 2003 after it had been lost. -

Especial extra thanks to David Carlisle for the

Steve Peter recreated the manual source in July 2003 after it had been lost. +

Especial extra thanks to David Carlisle for the backref module, the ps2pdf and dviwindo support, frequent general rewrites of my bad code, and for working on changes to the xr package to suit @@ -7108,62 +7140,62 @@ class="ec-lmss-10">hyperref.

13 GNU Free Documentation License

-

Version 1.2, November 2002 -

Copyright GNU Free Documentation License +

Version 1.2, November 2002 +

Copyright © 2000,2001,2002 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. -

+

Preamble

-

The purpose of this License is to make a manual, textbook, or other functional and useful document + id="x1-11300013">Preamble +

The purpose of this License is to make a manual, textbook, or other functional and useful document “free” in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others. -

This License is a kind of “copyleft”, which means that derivative works of the document must +

This License is a kind of “copyleft”, which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software. -

We have designed this License in order to use it for manuals for free software, because free software +

We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference. -

+

13.1 Applicability and definitions

-

This License applies to any manual or other work, in any medium, that contains a notice placed by + id="x1-11400013.1">Applicability and definitions +

This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The “Document”, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as “you”. You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law. -

A “Modified Version” of the Document means any work containing the Document or a +

A “Modified Version” of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language. -

A “Secondary Section” is a named appendix or a front-matter section of the Document that deals +

A “Secondary Section” is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document’s overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them. -

The “Invariant Sections” are certain Secondary Sections whose titles are designated, as being those of +

The “Invariant Sections” are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none. -

The “Cover Texts” are certain short passages of text that are listed, as Front-Cover Texts or +

The “Cover Texts” are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words. -

A “Transparent” copy of the Document means a machine-readable copy, represented in a format +

A “Transparent” copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or @@ -7172,7 +7204,7 @@ otherwise Transparent file format whose markup, or absence of markup, has been a discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not “Transparent” is called “Opaque”. -

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo +

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include @@ -7180,41 +7212,41 @@ proprietary formats that can be read and edited only by proprietary word process or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only. -

The “Title Page” means, for a printed book, the title page itself, plus such following pages as are +

The “Title Page” means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, “Title Page” means the text near the most prominent appearance of the work’s title, preceding the beginning of the body of the text. -

A section “Entitled XYZ” means a named subunit of the Document whose title either is precisely +

A section “Entitled XYZ” means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as “Acknowledgements”, “Dedications”, “Endorsements”, or “History”.) To “Preserve the Title” of such a section when you modify the Document means that it remains a section “Entitled XYZ” according to this definition. -

The Document may include Warranty Disclaimers next to the notice which states that this +

The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License. -

+

13.2 Verbatim copying

-

You may copy and distribute the Document in any medium, either commercially or noncommercially, + id="x1-11500013.2">Verbatim copying +

You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 13.3. -

You may also lend copies, under the same conditions stated above, and you may publicly display +href="#x1-11600013.3">13.3. +

You may also lend copies, under the same conditions stated above, and you may publicly display copies. -

+

13.3 Copying in quantity

-

If you publish printed copies (or copies in media that commonly have printed covers) of the Document, + id="x1-11600013.3">Copying in quantity +

If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document’s license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly @@ -7223,10 +7255,10 @@ words of the title equally prominent and visible. You may add other material on addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects. -

If the required texts for either cover are too voluminous to fit legibly, you should put the first ones +

If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages. -

If you publish or distribute Opaque copies of the Document numbering more than 100, you must +

If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free @@ -7235,162 +7267,162 @@ begin distribution of Opaque copies in quantity, to ensure that this Transparent remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public. -

It is requested, but not required, that you contact the authors of the Document well before +

It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document. -

+

13.4 Modifications

-

You may copy and distribute a Modified Version of the Document under the conditions of sections 13.2 + id="x1-11700013.4">Modifications +

You may copy and distribute a Modified Version of the Document under the conditions of sections 13.2 and 13.3 above, provided that you release the Modified Version under precisely this License, with the +href="#x1-11600013.3">13.3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version: -

+

  1. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, + class="enumerate" id="x1-117002x1">Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
  2. List on the Title Page, as authors, one or more persons or entities responsible for authorship + class="enumerate" id="x1-117004x2">List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement.
  3. State on the Title page the name of the publisher of the Modified Version, as the publisher. + class="enumerate" id="x1-117006x3">State on the Title page the name of the publisher of the Modified Version, as the publisher.
  4. Preserve all the copyright notices of the Document. + class="enumerate" id="x1-117008x4">Preserve all the copyright notices of the Document.
  5. Add an appropriate copyright notice for your modifications adjacent to the other copyright + class="enumerate" id="x1-117010x5">Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
  6. Include, immediately after the copyright notices, a license notice giving the public permission + class="enumerate" id="x1-117012x6">Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
  7. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts + class="enumerate" id="x1-117014x7">Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document’s license notice.
  8. Include an unaltered copy of this License. + class="enumerate" id="x1-117016x8">Include an unaltered copy of this License.
  9. Preserve the section Entitled “History”, Preserve its Title, and add to it an item stating at + class="enumerate" id="x1-117018x9">Preserve the section Entitled “History”, Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled “History” in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
  10. Preserve the network location, if any, given in the Document for public access to a + class="enumerate" id="x1-117020x10">Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the “History” section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
  11. For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the + class="enumerate" id="x1-117022x11">For any section Entitled “Acknowledgements” or “Dedications”, Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
  12. Preserve all the Invariant Sections of the Document, unaltered in their text and in their + class="enumerate" id="x1-117024x12">Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
  13. Delete any section Entitled “Endorsements”. Such a section may not be included in the + class="enumerate" id="x1-117026x13">Delete any section Entitled “Endorsements”. Such a section may not be included in the Modified Version.
  14. Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with + class="enumerate" id="x1-117028x14">Do not retitle any existing section to be Entitled “Endorsements” or to conflict in title with any Invariant Section.
  15. Preserve any Warranty Disclaimers. + class="enumerate" id="x1-117030x15">Preserve any Warranty Disclaimers.
-

If the Modified Version includes new front-matter sections or appendices that qualify as Secondary +

If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version’s license notice. These titles must be distinct from any other section titles. -

You may add a section Entitled “Endorsements”, provided it contains nothing but endorsements of +

You may add a section Entitled “Endorsements”, provided it contains nothing but endorsements of your Modified Version by various parties–for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard. -

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as +

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one. -

The author(s) and publisher(s) of the Document do not by this License give permission to use their +

The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version. -

+

13.5 Combining documents

-

You may combine the Document with other documents released under this License, under the terms + id="x1-11800013.5">Combining documents +

You may combine the Document with other documents released under this License, under the terms defined in section 13.4 above for modified versions, provided that you include in the combination all of +href="#x1-11700013.4">13.4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers. -

The combined work need only contain one copy of this License, and multiple identical Invariant +

The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work. -

In the combination, you must combine any sections Entitled “History” in the various original +

In the combination, you must combine any sections Entitled “History” in the various original documents, forming one section Entitled “History”; likewise combine any sections Entitled “Acknowledgements”, and any sections Entitled “Dedications”. You must delete all sections Entitled “Endorsements”. -

+

13.6 Collections of documents

-

You may make a collection consisting of the Document and other documents released under this License, + id="x1-11900013.6">Collections of documents +

You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects. -

You may extract a single document from such a collection, and distribute it individually under this +

You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document. -

+

13.7 Aggregation with independent works

-

A compilation of the Document or its derivatives with other separate and independent documents or + id="x1-12000013.7">Aggregation with independent works +

A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an “aggregate” if the copyright resulting from the compilation is not used to limit the legal rights of the compilation’s users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document. -

If the Cover Text requirement of section 13.3 is applicable to these copies of the Document, then if +

If the Cover Text requirement of section 13.3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document’s Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate. -

+

13.8 Translation

-

Translation is considered a kind of modification, so you may distribute translations of the Document + id="x1-12100013.8">Translation +

Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 13.4. Replacing Invariant Sections with translations requires special +href="#x1-11700013.4">13.4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, @@ -7398,26 +7430,26 @@ provided that you also include the original English version of this License and versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail. -

If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or “History”, the +

If a section in the Document is Entitled “Acknowledgements”, “Dedications”, or “History”, the requirement (section 13.4) to Preserve its Title (section 13.1) will typically require changing the actual +href="#x1-11700013.4">13.4) to Preserve its Title (section 13.1) will typically require changing the actual title. -

+

13.9 Termination

-

You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under + id="x1-12200013.9">Termination +

You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. -

+

13.10 Future revisions of this license

-

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation + id="x1-12300013.10">Future revisions of this license +

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/. -

Each version of the License is given a distinguishing version number. If the Document specifies that a +

Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License “or any later version” applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version @@ -7425,26 +7457,26 @@ number of this License, you may choose any version ever published (not as a draf Foundation. -

+

Addendum: how to use this license for your documents

-

To use this License in a document you have written, include a copy of the License in the document and + id="x1-12400013.10">Addendum: how to use this license for your documents +

To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: -

+

-

Copyright

Copyright © YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled “GNU Free Documentation License”.

-

If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “with...Texts.” +

If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “with...Texts.” line with this: -

with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and +

with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. -

If you have Invariant Sections without Cover Texts, or some other combination of the three, merge +

If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation. -

If your document contains nontrivial examples of program code, we recommend releasing these +

If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software. -- cgit v1.2.3