summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-02-26 21:07:29 +0000
committerKarl Berry <karl@freefriends.org>2023-02-26 21:07:29 +0000
commit4824d989b16555689652521e4b0c8543069ff1de (patch)
treea492a3adca774da1fe9f200b892f4cfd846438ad /Master/texmf-dist/doc/latex
parent63ce628d1be3ed1bb55f75a359f6a0af816f011a (diff)
hrefhide (26feb23)
git-svn-id: svn://tug.org/texlive/trunk@66189 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/hrefhide/README136
-rw-r--r--Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdfbin114343 -> 111632 bytes
-rw-r--r--Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex85
-rw-r--r--Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdfbin319943 -> 329925 bytes
4 files changed, 115 insertions, 106 deletions
diff --git a/Master/texmf-dist/doc/latex/hrefhide/README b/Master/texmf-dist/doc/latex/hrefhide/README
index 79b2538d5af..bd65799b5d8 100644
--- a/Master/texmf-dist/doc/latex/hrefhide/README
+++ b/Master/texmf-dist/doc/latex/hrefhide/README
@@ -1,4 +1,4 @@
-README for hrefhide package, 2011/04/29, v1.0f
+README for hrefhide package, 2023-02-26, v1.1a
TABLE OF CONTENTS
@@ -8,45 +8,52 @@ TABLE OF CONTENTS
2 Download
3 Installation
4 Additional Packages
-5 New Features
-6 Package Compatibility
-7 Authors/Maintainers
-8 Bug Reports
-9 Known Problems
+5 Package Compatibility
+6 Author/Maintainer
+7 Bug Reports
+8 Known Problems
1 INTRODUCTION
==============
-This package provides the command \hrefdisplayonly (additionally to \href of
-the hyperref package by Heiko Oberdiek). While the (hyperlinked) text appears
-like an ordinary nhref in the compiled pdf-file, the same text will be "hidden"
-when printing the text. It is not really invisible, but just has the same colour
-as the background (default: white). Therefore the layout is not changed when
-printing the document.
+This LaTeX package provides the command \hrefdisplayonly (additionally to
+\href of the hyperref package). While the (hyperlinked) text appears like an
+ordinary \href in the compiled pdf-file, the same text will be "hidden" when
+printing the text. It is not really invisible, but just has the same color as the
+background (default: white). Therefore the layout is not changed when printing
+the document.
+
Further the commands \hycon and \hycoff (hyper-colour-on/off) can be used
-to simulate switching option ocgcolorlinks of hyperref package on and off.
+to simulate switching option ocgcolorlinks of the hyperref package on and off.
+This package is possibly obsolete, see section 3: "Alternatives"
+in the documentation.
+
+This material is published under the LPPL 1.3c: 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 version. This version of this license is in
+https://www.latex-project.org/lppl/lppl-1-3c.txt
+and the latest version of this license is in
+https://www.latex-project.org/lppl.txt
+and version 1.3c or later is part of all distributions of
+LaTeX version 2005-12-01 or later.
2 DOWNLOAD
==========
-`hrefhide' is available on CTAN:
- CTAN:macros/latex/contrib/hrefhide/
-
-Also a ZIP file is provided that contains the files, already
-sorted in a TDS tree (should become available on CTAN soon):
- CTAN:install/macros/latex/contrib/hrefhide.tds.zip
-
-`CTAN:' means one of the `Comprehensive TeX Archive Network'
-nodes or one of its mirrors. This is explained in
- http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives
+"hrefhide" is available on CTAN:
+https://www.ctan.org/pkg/pagecolor
-The CTAN stuff will be mirrored automatically from the
-ftp server, so
- ftp://ftp.tug.org/pub/tex/pagesLTS/
-corresponds to
- CTAN:macros/latex/contrib/pagesLTS/
+Also a ZIP file is provided that contains the files:
+the manual (hrefhide.pdf), the example (hrefhide-example.tex),
+the compiled example (hrefhide-example.pdf),
+driver (hrefhide.drv), hrefhide.dtx,
+installation file (hrefhide.ins),
+the style file (hrefhide.sty),
+and this README, already sorted in a TDS tree:
+https://mirror.ctan.org/install/macros/latex/contrib/pagecolor.tds.zip
3 INSTALLATION
@@ -54,10 +61,11 @@ corresponds to
Installation with ZIP file in TDS format
----------------------------------------
-The ZIP file `hrefhide.tds.zip' contains the files sorted
-in a TDS tree. Thus you can directly unpack the ZIP file
-inside a TDS tree.
-(See CTAN:tds.zip for an explanation of TDS.)
+The ZIP file "hrefhide.tds.zip" contains the files
+sorted in a TDS tree. Thus you can directly unpack the
+ZIP file inside a TDS tree.
+See https://www.ctan.org/TDS-guidelines for an explanation
+of TDS.
Example:
cd /...somewhere.../texmf
unzip /...downloadpath.../hrefhide.tds.zip
@@ -68,33 +76,39 @@ Example:
Manual installation
-------------------
-a) Download the hrefhide files from CTAN or the TUG server.
+a) Download the hrefhide files from CTAN.
If necessary, unpack them.
b) Generate the package and driver files:
- tex hrefhide.ins
-c) Install the files `*.sty', and `*.cfg' in your TDS tree:
- cp *.sty *.cfg TDS:tex/latex/hrefhide/
- Replace `TDS:' by the prefix of your TDS tree
+ tex hrefhide.dtx
+c) Install the file "*.sty" in your TDS tree:
+ cp hrefhide.sty TDS:tex/latex/hrefhide/
+ Replace "TDS:" by the prefix of your TDS tree
(texmf directory).
-d) Copy the documentation files to
+d) Create the documentation, if necessary, e.g.
+ pdflatex hrefhide.dtx
+ makeindex -s gind.ist hrefhide.idx
+ pdflatex hrefhide.dtx
+ makeindex -s gind.ist hrefhide.idx
+ pdflatex hrefhide.dtx
+e) Update the databases if necessary, e.g. for TeXLive
+ texhash or mktexlsr.
+f) Create the hrefhide-example.pdf, if necessary, e.g.
+ pdflatex hrefhide-example.tex
+ pdflatex hrefhide-example.tex
+ pdflatex hrefhide-example.tex
+g) Copy the documentation files to
"TDS:doc/latex/hrefhide/":
README, hrefhide.pdf, hrefhide-example.tex,
hrefhide-example.pdf.
-e) Update the databases if necessary, e.g. for teTeX:
- mktexlsr .../texmf
4 ADDITIONAL PACKAGES
=====================
-Depending on the driver and option settings, hrefhide loads
-other packages:
-* hyperref.sty:
- CTAN:macros/latex/contrib/hyperref/hyperref.dtx
-* kvoptions.sty:
- CTAN:macros/latex/contrib/oberdiek/kvoptions.dtx
-* xcolor.sty:
- CTAN:/macros/latex/contrib/xcolor/xcolor.dtx
+hrefhide loads other packages:
+- xcolor
+- hyperref
+- kvoptions
which again load other packages
(see the result of the \listfiles command in the log-file
of the example).
@@ -112,26 +126,26 @@ hrefhide must be loaded AFTER package hyperref:
6 AUTHOR/MAINTAINER
-=====================
+===================
-* Hans-Martin Münch
+H.-Martin Münch
7 BUG REPORTS
-==============
+=============
A bug report should contain:
* Comprehensive problem description. This includes error or
warning messages.
- * \errorcontextlines=\maxdimen can be added in the
- TeX code to get more informations in TeX error messages.
-* Minimal test file that shows the problem, but does not
- contain any unnecessary packages and code.
+* \errorcontextlines=\maxdimen can be added in the
+ TeX code to get more information in TeX error messages.
+* Minimal test file that shows the problem,
+ but does not contain any unnecessary packages and code.
* Used drivers/programs.
* Version information about used packages and programs.
- * If you are using LaTeX, then add "\listfiles". Then
- a list of version informations is printed at the end
- of the LaTeX run.
+* If you are using LaTeX, then add "\listfiles" to the document.
+ Then a list of version information is printed at the end
+ of the LaTeX run.
* Please no other files than the minimal test file.
The other files .log, .dvi, .ps, .pdf are seldom
necessary, so send them only on request.
@@ -140,13 +154,13 @@ A bug report should contain:
Bug address
-----------
Bug reports can be send to the maintainer:
- Hans-Martin Münch
+ H.-Martin Münch
<Martin [dot] Muench [at] Uni-Bonn [dot] de>
8 KNOWN PROBLEMS
-=================
+================
* as yet: none... - Well, of course there are all issues
of the hyperref package with ocgcolorlinks option,
- e.g. no linebreaks inside links.
+ e.g. no linebreaks inside links. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdf b/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdf
index 76a4f9e3ecb..0748c23e6c4 100644
--- a/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdf
+++ b/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex b/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex
index fb7c97e1cf0..7746718feab 100644
--- a/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex
+++ b/Master/texmf-dist/doc/latex/hrefhide/hrefhide-example.tex
@@ -9,73 +9,71 @@
%% This is a generated file.
%%
%% Project: hrefhide
-%% Version: 2011/04/29 v1.0f
+%% Version: 2023-02-26 v1.1a
+%% Info: Hiding hyperrefs when printing pdf files
%%
-%% Copyright (C) 2010, 2011 by
-%% H.-Martin M"unch <Martin dot Muench at Uni-Bonn dot de>
-%%
-%% The usual disclaimer applys:
-%% If it doesn't work right that's your problem.
-%% (Nevertheless, send an e-mail to the maintainer
-%% when you find an error in this package.)
+%% Copyright (C) 2010 - 2023 by
+%% H.-Martin Muench <Martin dot Muench at Uni-Bonn dot de>
%%
%% 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
%% version. This version of this license is in
-%% http://www.latex-project.org/lppl/lppl-1-3c.txt
+%% https://www.latex-project.org/lppl/lppl-1-3c.txt
%% and the latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
+%% https://www.latex-project.org/lppl.txt
%% and version 1.3c or later is part of all distributions of
-%% LaTeX version 2005/12/01 or later.
+%% LaTeX version 2005-12-01 or later.
%%
%% This work has the LPPL maintenance status "maintained".
%%
%% The Current Maintainer of this work is H.-Martin Muench.
%%
-%% This work consists of the main source file hrefhide.dtx
-%% and the derived files
-%% hrefhide.sty, hrefhide.pdf, hrefhide.ins, hrefhide.drv,
-%% hrefhide-example.tex.
+%% This work consists of the main source file hrefhide.dtx,
+%% the README, and the derived files
+%% hrefhide.sty, hrefhide.pdf,
+%% hrefhide.ins, hrefhide.drv,
+%% hrefhide-example.tex, hrefhide-example.pdf.
+%%
+%% In memoriam
+%% Claudia Simone Barth + 1996-01-30
+%% Tommy Muench + 2014-01-02
+%% Hans-Klaus Muench + 2014-08-24
%%
-\documentclass[british]{article}[2007/10/19]% v1.4h
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\usepackage{lipsum}[2011/04/14]% v1.2
-\usepackage[ocgcolorlinks,bookmarks=false,bookmarksopen=false]{hyperref}[2011/04/17]% v6.82g
+\NeedsTeXFormat{LaTeX2e}[2022-11-01]
+\documentclass[british]{article}[2022/07/02]% v1.4n Standard LaTeX document class
+\usepackage{lipsum}[2021-09-20]% v2.7 150 paragraphs of Lorem Ipsum dummy text
+\usepackage[ocgcolorlinks,bookmarks=false,bookmarksopen=false%
+ ]{hyperref}[2023-02-07]% v7.00v Hypertext links for LaTeX
\hypersetup{extension=pdf,%
plainpages=false,%
pdfpagelabels=true,%
hyperindex=false,%
pdflang={en},%
pdftitle={hrefhide package example},%
- pdfauthor={Hans-Martin Muench},%
+ pdfauthor={H.-Martin Muench},%
pdfsubject={Example for the hrefhide package},%
- pdfkeywords={LaTeX, hrefhide, Hans-Martin Muench},%
+ pdfkeywords={LaTeX, hrefhide},%
pdfview=Fit,pdfstartview=Fit,%
pdfpagelayout=SinglePage%
}
-\usepackage[linktextcolour=black,backgroundcolour=white,pdfborder={0 0 1}]{hrefhide}[2011/04/29]% v1.0f
-\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}%
+\usepackage[linktextcolour=black,backgroundcolour=white,pdfborder={0 0 1}%
+ ]{hrefhide}[2023-02-26]% v1.1a Hiding hyperrefs when printing pdf files (HMM)
\listfiles
\begin{document}
\pagenumbering{arabic}
\section*{Example for hrefhide}
+\markboth{Example for hrefhide}{Example for hrefhide}
This example demonstrates the use of package\newline
-\textsf{hrefhide}, v1.0f as of 2011/04/29 (HMM).\newline
+\textsf{hrefhide}, v1.1a as of 2023-02-26 (HMM).\newline
The used options were \texttt{linktextcolour=black},
\texttt{backgroundcolour=white}, and \texttt{pdfborder={0 0 1}}
(the default ones).\newline
For more details please see the documentation!\newline
\textit{Print-\textbf{preview} the first page of this document
-and compare it with the page as displayed in your pdf reader.}\newline
-
-\noindent {\color{green} Save per page about $200\unit{ml}$ water,
-$2\unit{g}$ CO$_{2}$ and $2\unit{g}$ wood:\newline
-Therefore please print only if this is really necessary.\newline
-Maybe already the print-preview or just printing
-the first page are sufficient?}\newline
+and compare it with the page as displayed in your pdf reader.}
\bigskip
Lorem ipsum dolor sit amet \href{\#target}{link to target} consectetuer
@@ -91,7 +89,7 @@ Duis autem vel eum iriure dolor \href{\#target}{link to target} in
hendrerit in vulputate velit esse molestie consequat, vel illum dolore
eu feugiat nulla facilisis at vero eros et accumsan et iusto odio
dignissim qui blandit praesent luptatum zzril delenit augue
-duis dolore te feugait nulla facilisi.\newline
+duis dolore te feugait nulla facilisi.
\noindent \textbf{\textsf{%
\hrefdisplayonly{\#RefA}{A}
@@ -119,24 +117,22 @@ duis dolore te feugait nulla facilisi.\newline
\hrefdisplayonly{\#RefW}{W}
\hrefdisplayonly{\#RefX}{X}
\hrefdisplayonly{\#RefY}{Y}
-\hrefdisplayonly{\#RefZ}{Z}}} \linebreak
+\hrefdisplayonly{\#RefZ}{Z}}}\linebreak
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit,
vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida
mauris. Nam arcu libero, nonummy eget, consectetuer id, vulputate a,
-magna.\newline
+magna.
-Switching to coloured links with \verb|\hycon|:\newline
-\hycon
-\href{\#RefX}{X} and also
-\href{http://www.ctan.org/pkg/hrefhide}{http://www.ctan.org/pkg/hrefhide}.
-
-Switching off the coloured links with \verb|\hycoff| again:\newline
-\hycoff
-\href{\#RefY}{Y} and also
-\href{http://www.ctan.org/tex-archive/macros/latex/contrib/hrefhide}{%
-http://www.ctan.org/tex-archive/macros/latex/contrib/hrefhide}.
+Switching to colored links with \verb|\hycon|:\newline
+\hycon%
+\href{\#RefX}{section X} and also
+\href{https://ctan.org/pkg/hrefhide}{https://ctan.org/pkg/hrefhide}.
+Switching off the colored links with \verb|\hycoff| again:\newline
+\hycoff%
+\href{\#RefX}{section X} and also
+\href{https://ctan.org/pkg/hrefhide}{https://ctan.org/pkg/hrefhide}.
\pagebreak
{\Large \textbf{Targets}}\\
@@ -172,7 +168,6 @@ nisl ut aliquip ex ea commodo consequat.
\section[X]{\hypertarget{RefX}{X}} \lipsum[1]
\section[Y]{\hypertarget{RefY}{Y}} \lipsum[1]
\section[Z]{\hypertarget{RefZ}{Z}} \lipsum[1]
-
\end{document}
\endinput
%%
diff --git a/Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdf b/Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdf
index d6badad206c..4f0169a76de 100644
--- a/Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdf
+++ b/Master/texmf-dist/doc/latex/hrefhide/hrefhide.pdf
Binary files differ