summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/oberdiek/bookmark.dtx')
-rw-r--r--Master/texmf-dist/source/latex/oberdiek/bookmark.dtx136
1 files changed, 97 insertions, 39 deletions
diff --git a/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx b/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx
index e4603494c7e..d808bc07946 100644
--- a/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx
+++ b/Master/texmf-dist/source/latex/oberdiek/bookmark.dtx
@@ -1,11 +1,12 @@
% \iffalse meta-comment
-%
+%
% File: bookmark.dtx
-% Version: 2011/04/21 v1.21
-%
+% Version: 2011/12/02 v1.24
+% Info: PDF bookmarks
+%
% Copyright (C) 2007-2011 by
% Heiko Oberdiek <heiko.oberdiek at googlemail.com>
-%
+%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either
% version 1.3c of this license or (at your option) any later
@@ -15,22 +16,22 @@
% http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of
% LaTeX version 2005/12/01 or later.
-%
+%
% This work has the LPPL maintenance status "maintained".
-%
+%
% This Current Maintainer of this work is Heiko Oberdiek.
-%
+%
% This work consists of the main source file bookmark.dtx
% and the derived files
% bookmark.sty, bookmark.pdf, bookmark.ins, bookmark.drv,
% bkm-dvipdfm.def, bkm-dvips.def, bkm-dvipsone.def,
% bkm-textures.def, bkm-pdftex.def, bkm-vtex.def,
% bookmark-example.tex.
-%
+%
% Distribution:
% CTAN:macros/latex/contrib/oberdiek/bookmark.dtx
% CTAN:macros/latex/contrib/oberdiek/bookmark.pdf
-%
+%
% Unpacking:
% (a) If bookmark.ins is present:
% tex bookmark.ins
@@ -39,7 +40,7 @@
% (c) If you insist on using LaTeX
% latex \let\install=y\input{bookmark.dtx}
% (quote the arguments according to the demands of your shell)
-%
+%
% Documentation:
% (a) If bookmark.drv is present:
% latex bookmark.drv
@@ -49,14 +50,14 @@
% if available. Here you can specify further options, e.g.
% use A4 as paper format:
% \PassOptionsToClass{a4paper}{article}
-%
+%
% Programm calls to get the documentation (example):
% pdflatex bookmark.dtx
% makeindex -s gind.ist bookmark.idx
% pdflatex bookmark.dtx
% makeindex -s gind.ist bookmark.idx
% pdflatex bookmark.dtx
-%
+%
% Installation:
% TDS:tex/latex/oberdiek/bookmark.sty
% TDS:tex/latex/oberdiek/bkm-dvipdfm.def
@@ -84,7 +85,7 @@
\input docstrip.tex
\Msg{************************************************************************}
\Msg{* Installation}
-\Msg{* Package: bookmark 2011/04/21 v1.21 PDF bookmarks (HO)}
+\Msg{* Package: bookmark 2011/12/02 v1.24 PDF bookmarks (HO)}
\Msg{************************************************************************}
\keepsilent
@@ -96,7 +97,7 @@
This is a generated file.
Project: bookmark
-Version: 2011/04/21 v1.21
+Version: 2011/12/02 v1.24
Copyright (C) 2007-2011 by
Heiko Oberdiek <heiko.oberdiek at googlemail.com>
@@ -138,6 +139,10 @@ and the derived files
\file{bkm-vtex.def}{\from{bookmark.dtx}{vtex}}%
\usedir{doc/latex/oberdiek}%
\file{bookmark-example.tex}{\from{bookmark.dtx}{example}}%
+ \nopreamble
+ \nopostamble
+ \usedir{source/latex/oberdiek/catalogue}%
+ \file{bookmark.xml}{\from{bookmark.dtx}{catalogue}}%
}
\catcode32=13\relax% active space
@@ -166,16 +171,16 @@ and the derived files
%<*driver>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{bookmark.drv}%
- [2011/04/21 v1.21 PDF bookmarks (HO)]%
+ [2011/12/02 v1.24 PDF bookmarks (HO)]%
\documentclass{ltxdoc}
-\usepackage{holtxdoc}[2011/02/04]
+\usepackage{holtxdoc}[2011/11/22]
\begin{document}
\DocInput{bookmark.dtx}%
\end{document}
%</driver>
% \fi
%
-% \CheckSum{2323}
+% \CheckSum{2326}
%
% \CharacterTable
% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -196,7 +201,7 @@ and the derived files
% \GetFileInfo{bookmark.drv}
%
% \title{The \xpackage{bookmark} package}
-% \date{2011/04/21 v1.21}
+% \date{2011/12/02 v1.24}
% \author{Heiko Oberdiek\\\xemail{heiko.oberdiek at googlemail.com}}
%
% \maketitle
@@ -268,8 +273,7 @@ and the derived files
% If a \LaTeX\ file is compiled several times, then a little
% time can be saved, if option \xoption{draft} is used to
% disable the bookmark stuff of this package. Default is
-% \xoption{final}. If \cs{pdfdraftmode} is available, then
-% the default is {draft} if draft mode is enabled.
+% \xoption{final}.
% Both options are boolean options, without
% value the value |true| is used. |draft=true| is the same
% as |final=false|.
@@ -656,7 +660,7 @@ and the derived files
open,
openlevel=2,
atend
-]{bookmark}[2011/04/21]
+]{bookmark}[2011/12/02]
\bookmarksetup{color=blue}
@@ -759,7 +763,7 @@ and the derived files
%<*package>
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{bookmark}%
- [2011/04/21 v1.21 PDF bookmarks (HO)]%
+ [2011/12/02 v1.24 PDF bookmarks (HO)]%
% \end{macrocode}
%
% \subsubsection{Requirements}
@@ -929,7 +933,6 @@ and the derived files
% \begin{macrocode}
\DeclareBoolOption{draft}
\DeclareComplementaryOption{final}{draft}
-\pdf@ifdraftmode\BKM@drafttrue{}
% \end{macrocode}
% \begin{macro}{\BKM@DisableOptions}
% \begin{macrocode}
@@ -1708,7 +1711,8 @@ and the derived files
\let\BookmarkAtEnd\ltx@gobble
\let\bookmarkdefinestyle\ltx@gobbletwo
\let\bookmarkget\ltx@gobble
- \renewcommand*{\pdfbookmark}[3][]{}%
+ \let\pdfbookmark\ltx@undefined
+ \newcommand*{\pdfbookmark}[3][]{}%
\let\currentpdfbookmark\ltx@gobbletwo
\let\subpdfbookmark\ltx@gobbletwo
\let\belowpdfbookmark\ltx@gobbletwo
@@ -1805,7 +1809,8 @@ and the derived files
%
% \begin{macro}{\pdfbookmark}
% \begin{macrocode}
-\renewcommand*{\pdfbookmark}[3][0]{%
+\let\pdfbookmark\ltx@undefined
+\newcommand*{\pdfbookmark}[3][0]{%
\bookmark[level=#1,dest={#3.#1}]{#2}%
\hyper@anchorstart{#3.#1}\hyper@anchorend
}
@@ -1813,14 +1818,14 @@ and the derived files
% \end{macro}
% \begin{macro}{\currentpdfbookmark}
% \begin{macrocode}
-\renewcommand*{\currentpdfbookmark}{%
+\def\currentpdfbookmark{%
\pdfbookmark[\BKM@currentlevel]%
}
% \end{macrocode}
% \end{macro}
% \begin{macro}{\subpdfbookmark}
% \begin{macrocode}
-\renewcommand*{\subpdfbookmark}{%
+\def\subpdfbookmark{%
\BKM@CalcExpr\BKM@CalcResult\BKM@currentlevel+1%
\expandafter\pdfbookmark\expandafter[\BKM@CalcResult]%
}
@@ -1828,7 +1833,7 @@ and the derived files
% \end{macro}
% \begin{macro}{\belowpdfbookmark}
% \begin{macrocode}
-\renewcommand*{\belowpdfbookmark}[2]{%
+\def\belowpdfbookmark#1#2{%
\xdef\BKM@gtemp{\number\BKM@currentlevel}%
\subpdfbookmark{#1}{#2}%
\global\let\BKM@currentlevel\BKM@gtemp
@@ -1839,7 +1844,7 @@ and the derived files
% Section number, text, label, level, file
% \begin{macro}{\Hy@writebookmark}
% \begin{macrocode}
-\renewcommand*{\Hy@writebookmark}[5]{%
+\def\Hy@writebookmark#1#2#3#4#5{%
\ifnum#4>\BKM@depth\relax
\else
\def\BKM@type{#5}%
@@ -1880,7 +1885,7 @@ and the derived files
%<*dvipdfm>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{bkm-dvipdfm.def}%
- [2011/04/21 v1.21 bookmark driver for dvipdfm (HO)]%
+ [2011/12/02 v1.24 bookmark driver for dvipdfm (HO)]%
% \end{macrocode}
%
% \begin{macro}{\BKM@id}
@@ -2055,7 +2060,7 @@ and the derived files
%<*vtex>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{bkm-vtex.def}%
- [2011/04/21 v1.21 bookmark driver for VTeX (HO)]%
+ [2011/12/02 v1.24 bookmark driver for VTeX (HO)]%
% \end{macrocode}
%
% \begin{macrocode}
@@ -2263,7 +2268,7 @@ and the derived files
% \begin{macro}{\BKM@toHexDigit}
% \begin{macrocode}
\def\BKM@toHexDigit#1{%
- \expandafter\ifcase\expandafter\@firstofone\expandafter{\number#1} %
+ \ifcase\expandafter\@firstofone\expandafter{\number#1} %
0\or 1\or 2\or 3\or 4\or 5\or 6\or 7\or
8\or 9\or A\or B\or C\or D\or E\or F%
\fi
@@ -2386,7 +2391,7 @@ and the derived files
%<*pdftex>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{bkm-pdftex.def}%
- [2011/04/21 v1.21 bookmark driver for pdfTeX (HO)]%
+ [2011/12/02 v1.24 bookmark driver for pdfTeX (HO)]%
% \end{macrocode}
%
% \begin{macro}{\BKM@DO@entry}
@@ -2542,7 +2547,7 @@ and the derived files
%<*dvips>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{bkm-dvips.def}%
- [2011/04/21 v1.21 bookmark driver for dvips (HO)]%
+ [2011/12/02 v1.24 bookmark driver for dvips (HO)]%
% \end{macrocode}
% \begin{macro}{\BKM@PSHeaderFile}
% \begin{macrocode}
@@ -2561,7 +2566,7 @@ and the derived files
%<*dvipsone>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{bkm-dvipsone.def}%
- [2011/04/21 v1.21 bookmark driver for dvipsone (HO)]%
+ [2011/12/02 v1.24 bookmark driver for dvipsone (HO)]%
% \end{macrocode}
% \begin{macro}{\BKM@PSHeaderFile}
% \begin{macrocode}
@@ -2580,7 +2585,7 @@ and the derived files
%<*textures>
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{bkm-textures.def}%
- [2011/04/21 v1.21 bookmark driver for textures (HO)]%
+ [2011/12/02 v1.24 bookmark driver for textures (HO)]%
% \end{macrocode}
% \begin{macro}{\BKM@PSHeaderFile}
% \begin{macrocode}
@@ -3248,20 +3253,59 @@ and the derived files
%\end{verbatim}
% \end{quote}
%
+% \section{Catalogue}
+%
+% The following XML file can be used as source for the
+% \href{http://mirror.ctan.org/help/Catalogue/catalogue.html}{\TeX\ Catalogue}.
+% The elements \texttt{caption} and \texttt{description} are imported
+% from the original XML file from the Catalogue.
+% The name of the XML file in the Catalogue is \xfile{bookmark.xml}.
+% \begin{macrocode}
+%<*catalogue>
+<?xml version='1.0' encoding='us-ascii'?>
+<!DOCTYPE entry SYSTEM 'catalogue.dtd'>
+<entry datestamp='$Date$' modifier='$Author$' id='bookmark'>
+ <name>bookmark</name>
+ <caption>A new bookmark (outline) organization for hyperref.</caption>
+ <authorref id='auth:oberdiek'/>
+ <copyright owner='Heiko Oberdiek' year='2007-2011'/>
+ <license type='lppl1.3'/>
+ <version number='1.24'/>
+ <description>
+ This package implements a new bookmark (outline) organization for
+ package <xref refid='hyperref'>hyperref</xref>. Bookmark properties such
+ as style and color can now be set. Other action types
+ are available (URI, GoToR, Named). The bookmarks are
+ generated in the first compile run. Package
+ <xref refid='hyperref'>hyperref</xref> uses two runs.
+ <p/>
+ The package is part of the <xref refid='oberdiek'>oberdiek</xref>
+ bundle.
+ </description>
+ <documentation details='Package documentation'
+ href='ctan:/macros/latex/contrib/oberdiek/bookmark.pdf'/>
+ <ctan file='true' path='/macros/latex/contrib/oberdiek/bookmark.dtx'/>
+ <miktex location='oberdiek'/>
+ <texlive location='oberdiek'/>
+ <install path='/macros/latex/contrib/oberdiek/oberdiek.tds.zip'/>
+</entry>
+%</catalogue>
+% \end{macrocode}
+%
% \begin{thebibliography}{9}
-%
+%
% \bibitem{hyperref}
% Sebastian Rahtz, Heiko Oberdiek:
% \textit{The \xpackage{hyperref} package};
% 2011/04/17 v6.82g;
% \CTAN{macros/latex/contrib/hyperref/}
-%
+%
% \bibitem{currfile}
% Martin Scharrer:
% \textit{The \xpackage{currfile} package};
% 2011/01/09 v0.4.
% \CTAN{macros/latex/contrib/currfile/}
-%
+%
% \end{thebibliography}
%
% \begin{History}
@@ -3439,6 +3483,20 @@ and the derived files
% Some support for file name and line number in error messages
% at end of document (pdfTeX and pdfmark based drivers).
% \end{Version}
+% \begin{Version}{2011/05/13 v1.22}
+% \item
+% Change of version 2010/11/05 v1.18 reverted, because otherwise
+% draftmode disables some \xext{aux} file entries.
+% \end{Version}
+% \begin{Version}{2011/09/19 v1.23}
+% \item
+% Some \cs{renewcommand}s changed to \cs{def} to avoid trouble
+% if the commands are not defined, because hyperref stopped early.
+% \end{Version}
+% \begin{Version}{2011/12/02 v1.24}
+% \item
+% Small optimization in \cs{BKM@toHexDigit}.
+% \end{Version}
% \end{History}
%
% \PrintIndex