morehype (23oct11)

git-svn-id: svn://tug.org/texlive/trunk@24369 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 225 insertions, 96 deletions

diff --git a/Master/texmf-dist/tex/latex/morehype/blog.sty b/Master/texmf-dist/tex/latex/morehype/blog.sty
index bcf0bc0d0ac..947ebabfe96 100644
--- a/Master/texmf-dist/tex/latex/morehype/blog.sty
+++ b/Master/texmf-dist/tex/latex/morehype/blog.sty
@@ -1,5 +1,5 @@
 \NeedsTeXFormat{LaTeX2e}[1994/12/01] %% \newcommand* etc. 
-\ProvidesPackage{blog}[2011/10/15 v0.61 simple fast HTML (UL)] 
+\ProvidesPackage{blog}[2011/10/22 v0.62 simple fast HTML (UL)] 
 %% copyright (C) 2010 2011 Uwe Lueck, 
 %% http://www.contact-ednotes.sty.de.vu 
 %% -- author-maintained in the sense of LPPL below.
@@ -48,8 +48,10 @@
 \ProcessOptions
 \MakeOther\< \MakeOther\>               %% TODO ...
 \newcommand*{\BlogCopyFile}[2][]{%
-    \typeout{^^J\screenqtd{blog.sty} generating         %% 2011/10/05
-                \screenqtd{\htmljob\htmakeext}}%
+%     \typeout{^^J\screenqtd{blog.sty} generating   %% 2011/10/05
+%                 \screenqtd{\htmljob\htmakeext}}%
+%% <- 2011/10/22: such a message should be in driver file
+%% when it is clear how many source files the target file has.
     \ProcessFileWith[\BlogCodes 
                      \let\ProvidesFile\BlogProvidesFile %% 2011/02/24 
                      \let\protect\@empty                %% 2011/03/24
@@ -301,13 +303,17 @@
 %% etc. for |\textbf|, |\texttt| ...:
 \renewcommand*{\textbf}{\SimpleTagSurr b}
 \renewcommand*{\texttt}{\SimpleTagSurr{tt}}         %% 2010/06/07
-%% |\textsf{<text>}| TODO (see some `makehtml.tex') %% 2011/05/11
-%%
+%% |\textsf{<text>}| chooses some sans-serif:       %% 2011/10/20
+\renewcommand*{\textsf}{%
+    \TagSurr{span}{\@style{font-family:sans-serif}}}
 %% |\textcolor| is from \LaTeX's 'color' package 
 %% that we won't load for generating \HTML, 
 %% so it is ``new" here, it is just natural to use it 
-%% for colored text (2010/05/15):
-\newcommand*{\textcolor}[1]{\TagSurr{font}{color="#1"}}
+%% for colored text.                                %% (2010/05/15):
+%% \xmltagcode{font} is deprecated, use             %% 2011/10/20
+%% \xmltagcode{span} instead:
+% \newcommand*{\textcolor}[1]{\TagSurr{font}{color="#1"}}
+\newcommand*{\textcolor}[1]{\TagSurr{span}{\@style{color:#1}}}
 %%
 %% == Logical Markup ==
 %% |\code{<text>}| marks <text> as ``code," 
@@ -419,24 +425,32 @@
 %%
 %% == Links ==
 %% === Basic Link Macros ===
-%% |\hanc{<id>}{<text>}| makes <text> an anchor with 
-%% \HTML\ label <id> (like 'hyperref''s `\hypertarget'): 
+%% %% doc. fixes + hyperref 2011/10/16:
+%% |\hanc{<name>}{<text>}| makes <text> an anchor with 
+%% \HTML\ label <name> like \ctanpkgref{hyperref}'s 
+%% |\hypertarget{<name>}{<text>}| 
+%% (that we actually provide as well, 
+%% towards printing from the same source): 
 \newcommand*{\hanc}[1]{\TagSurr a{\@name{#1}}}
-%% |\hancref{<id>}{<url>}{<text>}| makes <text> an anchor with 
-%% \HTML\ label <id> and at the same time a link to <url>: 
+\@ifdefinable\hypertarget{\let\hypertarget\hanc}
+%% |\hancref{<name>}{<target>}{<text>}| makes <text> an anchor with 
+%% \HTML\ label <name> and at the same time a link to <target>: 
 \newcommand*{\hancref}[2]{\TagSurr a{\@name{#1} \@href{#2}}}
-%% |\href{<id>}{<text>}| makes <text> a link to <url>: 
+%% |\href{<name>}{<text>}| makes <text> a link to <name> 
+%% (as with 'hyperref'): 
 \newcommand*{\href}[1]{\TagSurr a{\@href{#1}}}
 %%
 %% === Special cases of Basic Link Macros ===
 %% |\autanc{<text>}| creates an anchor where <text> is 
 %% the text and the internal label at the same time:
 \newcommand*{\autanc}[1]{\hanc{#1}{#1}}             %% 2010/07/04
-%% |\ancref{<id>}{<text>}| makes <text> a link to 
-%% an anchor <id> on the same web page.
+%% |\ancref{<name>}{<text>}| makes <text> a link to 
+%% an anchor <name> on the same web page.
 %% This is especially useful for a ``table of contents"---a 
 %% list of links to sections of the page. 
+%% It is just like 'hyperref''s |\hyperlink{<name>}{<text>}|:
 \newcommand*{\ancref}[1]{\href{\##1}}
+\@ifdefinable\hyperlink{\let\hyperlink\ancref}
 %% |\autref{<text>}| makes <text> a link to an anchor 
 %% named <text> itself: 
 \newcommand*{\autref}[1]{\ancref{#1}{#1}}           %% 2010/07/04
@@ -493,6 +507,7 @@
 %% or more generally with local non-\HTML\ files),
 %% so let us have a backbone 
 %% |\hnewref{<prot>}{<host-path[#frag]>}{<text>}| 
+%% that                                             %% 2011/10/21
 %% makes <text> a link to <prot><host-path[#frag]>:
 \newcommand*{\hnewref}[2]{%
     \TagSurr a{\@href{#1#2" target="_blank}}}
@@ -503,9 +518,7 @@
 \RequirePackage[blog]{texlinks}[2011/02/10]
 %% Former |\urlref| appears as |\urlhttpref| there ...
 \newcommand \urlref {}      \let\urlref\urlhttpref
-%% ... and |\ctanref| has been replaced by `\tugctanref'.
-%% Let's go on playing with the difference ...
-\newcommand*{\ctanref}[1]{\httpref{ctan.org/tex-archive/#1}}
+%% ... and `\ctanref' has changed its meaning there as of 2011/10/21.
 %% %% 2011/02/07:
 %% 'texlinks' sometimes uses a ``permanent alias" 
 %% |\NormalHTTPref| of `\httpref':
@@ -1065,3 +1078,9 @@ v0.61   2011/10/11  </li> in \item again, \Provides... v wrong
         2011/10/12  \hnewref, `\ ' in allrulestable
         2011/10/14  \CLBrk's
         2011/10/15  doc. note on \HVspace/blogdot
+part of MOREHYPE RELEASE r0.51
+v0.62   2011/10/16  \hyperlink, \hypertarget; doc. fixes there
+        2011/10/20  \textcolor by <span>, \textsf 
+        2011/10/21  \ctanref now in texlinks.sty; 
+                    doc.: grammar with `that'
+        2011/10/22  \BlogCopyFile message removed
diff --git a/Master/texmf-dist/tex/latex/morehype/blogdot.cfg b/Master/texmf-dist/tex/latex/morehype/blogdot.cfg
index 1970295d15a..c0ca5dfc68a 100644
--- a/Master/texmf-dist/tex/latex/morehype/blogdot.cfg
+++ b/Master/texmf-dist/tex/latex/morehype/blogdot.cfg
@@ -1,4 +1,4 @@
-\ProvidesFile{blogdot.cfg}[2011/10/14 local blogdot.sty config]
+\ProvidesFile{blogdot.cfg}[2011/10/21 local blogdot.sty config]
 %% (U.L.:) For my 1024$\times$600 screen 
 %% (with Mozilla Firefox~3.6.22 for Ubuntu canonical~-~1.0),
 %% the following choice of `\leftpagemargin' worked best 
@@ -27,4 +27,9 @@
 %% ... `blogdot.cfg' may be a good idea for general settings; 
 %% recompiling the presentation of a given document source 
 %% `<job>.tex' may better be controlled in a file `<job>.cfg' ...
+%%
+%% Open CTAN files:                             %% 2011/10/21
+% \usemirrorctan
+% \usecurrdirctan
+%% Stop processing this file:
 \endinput
diff --git a/Master/texmf-dist/tex/latex/morehype/blogdot.sty b/Master/texmf-dist/tex/latex/morehype/blogdot.sty
index 699cb64805a..900025e9d35 100644
--- a/Master/texmf-dist/tex/latex/morehype/blogdot.sty
+++ b/Master/texmf-dist/tex/latex/morehype/blogdot.sty
@@ -1,5 +1,5 @@
 \NeedsTeXFormat{LaTeX2e}[1994/12/01] %% \newcommand* etc. 
-\ProvidesPackage{blogdot}[2011/10/15 v0.3 HTML presentations (UL)]
+\ProvidesPackage{blogdot}[2011/10/22 v0.4 HTML presentations (UL)]
 %% copyright (C) 2011 Uwe Lueck, 
 %% http://www.contact-ednotes.sty.de.vu 
 %% -- author-maintained in the sense of LPPL below.
@@ -64,7 +64,8 @@
 %% |\CommentBlogDotWholeWidth| procuces no \HTML\ code ...
 \global\let\BlogDotWholeWidth\@empty
 %% ... unless calculated with |\SumBlogDotWidth|: 
-\newcommand*{\SumBlogDotWidth}{{%
+\newcommand*{\SumBlogDotWidth}{%
+    \relax{%                        %% \relax 2011/10/22 magic ...
     \count@\typeareawidth
     \advance\count@ \leftpagemargin
     \advance\count@\rightpagemargin
@@ -122,7 +123,7 @@
 %% |\BlogDotRestart| expands. 
 \newcommand*{\screenbottom}[1]{%
     \ifFillBlogDotTypeArea 
-      </p>\ancref{#1}{\BlogDotFillText}% 
+      <p>\ancref{#1}{\BlogDotFillText}%    %% not </p> 2011/10/22
     \fi
     \endTd\emptycell
     \endtr
@@ -232,7 +233,9 @@
 %% the type area so that the text is centered on wider screens 
 %% than the one the \HTML\ page was made for. The link may serve 
 %% as an alternative to the bottom margin link 
-%% (which sometimes fails). It can be undone 
+%% (which sometimes fails). 
+%% `\FillBlogDotTypeArea'                   %% 2011/10/22
+%% can be undone 
 %% by |\DontFillBlogDotTypeArea|:
 \newcommand*{\FillBlogDotTypeArea}{%
     \let\ifFillBlogDotTypeArea\iftrue 
@@ -241,8 +244,9 @@
     \let\ifFillBlogDotTypeArea\iffalse}
 \DontFillBlogDotTypeArea
 %% |\FillBlogDotBottom| fills `\BlogDotFillText' into the 
-%% center bottom cell. I tried this before `\FillBlogDotTypeArea'
-%% and I am not sure ... \ It can be undone by 
+%% center bottom cell. I tried it before `\FillBlogDotTypeArea'
+%% and I am not sure ... 
+%% It can be undone by 
 %% |\DontFillBlogDotBottom|:
 \newcommand*{\FillBlogDotBottom}{%
     \let\BlogDotBottomFill\BlogDotFillText}
@@ -251,14 +255,37 @@
 \newcommand*{\DontFillBlogDotBottom}{\let\BlogDotBottomFill\@empty} 
 \DontFillBlogDotBottom
 %% |\DontShowBlogDotFillText| makes `\BlogDotFillText' invisible,\\ 
-%% |\ShowBlogDotFillText| makes it visible:
+%% |\ShowBlogDotFillText| makes it visible. 
+%% Until 2011/10/22, `\textcolor' ('blog.sty') used the 
+%% \xmltagcode{font} element that is deprecated. 
+%% I still use it here because it seems to suppress the 
+%% `hover' \acro{CSS} indication for the link. 
+%% (I might offer a choice---TODO)
 \newcommand*{\DontShowBlogDotFillText}{%
-    \def\BlogDotFillTextColor{\textcolor{\bodybgcolor}}}
+%     \def\BlogDotFillTextColor{\textcolor{\bodybgcolor}}}
+    \def\BlogDotFillTextColor{%
+        \TagSurr{font}{color="\bodybgcolor"}}}
 \newcommand*{\ShowBlogDotFillText}{%
     \def\BlogDotFillTextColor{\textcolor{red}}}
 \DontShowBlogDotFillText
+%% As of 2011/10/21, 'texlinks.sty' provides 
+%% `\ctanfileref{<path>}{<file-name>}' that uses an online 
+%% \TeX\ archive according to 
+%% \[|\usemirrorctan|\quad \mbox{or}\quad |\usetugctan|.\] 
+%% This is preferable for an online version of the presentation. 
+%% In `dantev45.htm', this is used for example files.
+%% When, on the other hand, internet access during the presentation is 
+%% bad, such example files may instead be loaded from the 
+%% ``current directory." \ |\usecurrdirctan| \ modifies `\ctanfileref' 
+%% for this purpose (i.e., it will ignore <path>):
+\newcommand*{\usecurrdirctan}{%
+    \renewcommand*{\ctanfileref}[2]{%
+        \hnewref{}{##2}{\filenamefmt{##2}}}}
+%% (Using a local \acro{TDS} tree would be funny, but I don't 
+%%  have good idea for this right now. )
+%%
 %% |\TryBlogDotCFG| looks for `blogdot.cfg', 
-%% |\TryBlogDotCFG[<file-name-base>]| 
+%% \[|\TryBlogDotCFG[<file-name-base>]|\]       %% \[...\] 2011/10/21 
 %% looks for `<file-name-base>.cfg' 
 %% (for recompiling a certain file):
 \newcommand*{\TryBlogDotCFG}[1][blogdot]{%
@@ -290,3 +317,7 @@ v0.3    2011/10/11    \HVspace, \BlogDotFillText
                       \ifFillBlogDotTypeArea, \tablerow, messages
         2011/10/14    \maybe@blogdot@frame
         2011/10/15    doc. note: \HVspace useless
+        part of morehype RELEASE r0.51 
+v0.4    2011/10/21    \usecurrdirctan
+        2011/10/22    FillText with <p> instead of </p>, its color 
+                      uses <font>; some more reworking of doc.
diff --git a/Master/texmf-dist/tex/latex/morehype/texlinks.sty b/Master/texmf-dist/tex/latex/morehype/texlinks.sty
index 9423dfef4df..ac546b89f67 100644
--- a/Master/texmf-dist/tex/latex/morehype/texlinks.sty
+++ b/Master/texmf-dist/tex/latex/morehype/texlinks.sty
@@ -1,5 +1,5 @@
 \NeedsTeXFormat{LaTeX2e}[1994/12/01] %% \newcommand* etc. 
-\ProvidesPackage{texlinks}[2011/10/10 v0.41 TeX-related links (UL)] 
+\ProvidesPackage{texlinks}[2011/10/21 v0.5 TeX-related links (UL)] 
 %% copyright (C) 2011 Uwe Lueck, 
 %% http://www.contact-ednotes.sty.de.vu 
 %% -- author-maintained in the sense of LPPL below.
@@ -15,19 +15,19 @@
 %% 
 %%   http://www.contact-ednotes.sty.de.vu 
 %%
-%% == Outline ==
+%% == Outline                               ==
 %% % Almost                             %% 2011/07/23
 %% % all the            %% including https 2011/08/27
 %% The link macros of 'texlinks' are based on macros 
 %% |\httpref| and |\httpsref|. For use of 'texlinks' with 'blog.sty', 
 %% the latter provides definitions of `\httpref' and `\httpsref'
-%% suitable for \acro{HTML}, where a choice of opening a new 
+%% suitable for \HTML, where a choice of opening a new 
 %% tab or window---or not---is relevant.
 %%
 %% For use with 'hyperref' (or ...?), 'texlinks' may 
 %% provide definitions of `\httpref' and `\httpsref' 
 %% based on `\href'. The decision to do so or not may happen at 
-%% `\begin{document}'. 'blog.sty' generates \acro{HTML} without 
+%% `\begin{document}'. 'blog.sty' generates \HTML\ without 
 %% using the `{document}' environment, so we might assume 
 %% that when `\begin{document}' is found, we are running
 %% 'hyperref', or just \emph{something} that provides a 
@@ -36,12 +36,12 @@
 %% 
 %% Moreover, a \acro{PDF} file with links may be \emph{printed}, 
 %% and klicking the links on the paper may fail. 
-%% \acro{URL}s in main text, on the other hand, sometimes are 
+%% \URL s in main text, on the other hand, sometimes are 
 %% troublesome. I consider it a good idea to present 
-%% links with their \acro{URL} as the displayed text in \emph{footnotes}
-%% (or endnotes). It may even be useful with \acro{HTML} to present 
-%% the \acro{URL}s displayed in some 
-%% 2011/01/27:
+%% links with their \URL\ as the displayed text in \emph{footnotes}
+%% (or endnotes). It may even be useful with \HTML\ to present 
+%% the \URL s displayed in some 
+%% %% 2011/01/27:               %% rm. 2011/10/20
 %% ``appendix."---This idea has been resumed in v0.2 only, 
 %% |\urlfoot|.
 %% %
@@ -49,7 +49,7 @@
 %% % package option forcing `\httpref' to use this style. 
 %% % Well, better \emph{not today} ... [2011/01/24, TODO]
 %%
-%% == Package Options       ==
+%% == Package Options                       ==
 %% Somebody may want to suppress a definition of `\httpref'
 %% at `\begin{document}' ... [2011/01/24, TODO]
 %% %% 2011/02/10:
@@ -61,7 +61,49 @@
 %% useful for different purposes than running 'blog.sty'.
 \ProcessOptions
 %%
-%%    \pagebreak 
+%% == Fonts for \URL s and File/Package Names ==
+%% %% ** Fonts for \URL s, File Names, and Package Names **
+%% %% new 2011/10/19, TODO: `meansltx'? vgl. `makedoc.cfg'
+%% This section ``provides" markup for displaying \URL s (|\urlfmt|), 
+%% file names (|\filenamefmt|---thinking of single files 
+%% that may be found in the internet or on your computer---, 
+%% and ``packages" (|\pkgnamefmt|). 
+%% For the latter two, in certain files I use shorthands 
+%% |\file| and |\pkg|, resp., ... 
+%% (Not sure about `\providecommand' TODO ...)
+%% %% TODO "fallback" with 'provlast'
+%% 
+%% It is usual to use `\texttt' for formatting \TeX\ code 
+%% (``verbatim", `\verb' etc.). It may also be common to use 
+%% `\texttt' for file names, perhaps even for \URL s. 
+%% Therefore we provide |\urlfmt{<url>}| as follows: 
+\providecommand*{\urlfmt}{\texttt}
+%% The file name format |\filenamefmt{<file-name>}|
+%% may differ from the format for \URL s---if somebody 
+%% wants/adjusts it, \emph{here} it is the \emph{same:}
+\providecommand*{\filenamefmt}{\texttt}
+%% ... 
+%% I favour `\code' over `\texttt' as ``logical markup," 
+%% inspired by the \xmltagcode{code} element in \HTML, 
+%% but it is too difficult to provide this right now here ...
+%% 
+%% %% Instead of |\pkgnamefmt{<pack-name>}|, 
+%% %% 'blog.sty' had `\pkg{<pack-name>}',      %% was `prg' 2011/10/20
+%% %% without a proper implementation. 
+%% |\pkgnamefmt{<package-name>}| displays the name of a ``package". 
+%% Using `\textsf' for `\pkgnamefmt' 
+%% seems to conform to common practice today---implemented here. 
+%% The following code may later be suppressed at some package options, 
+%% as with the choice for `\httpref':   %% TODO 2011/01/24
+% \@ifdefinable\pkgnamefmt {\let\pkgnamefmt\@firstofone}
+% \AtBeginDocument         {\let\pkgnamefmt\textsf}
+%% <- This was here until v0.61, makes a difference for \acro{PDF}
+%% vs.\ 'blog' \HTML. Now we choose the same as with `\urlfmt':
+\providecommand*{\pkgnamefmt}{\textsf}
+%% Indeed, the same day we are providing `\textsf' in 'blog.sty'.
+%% However, the rationale of the earlier solution was 
+%% that web pages use sans-serif as the \emph{normal} font ...
+%%
 %% %% moving \httpsref 2011/08/27:
 %% == Providing &\httpref\ and   &\httpsref ==
 %%                             %% rm. \kern-\baselineskip 2011/10/10
@@ -69,7 +111,7 @@
 %% should display <text> 
 %% as a link to `http://<host-path[#frag]>'; 
 %% \[|\httpsref{<host-path[#frag]>}{<text>}|\]
-%% is the obvious analogue for `https:' \acro{URL}s. 
+%% is the obvious analogue for `https:' \URL s. 
 %% In case `\begin{document}' is found with a definition of 
 %% `\href' present, we provide definitions of `\httpref'
 %% and `\httpsref' in terms of `\href' there:
@@ -86,14 +128,21 @@
 \AtBeginDocument{%% TODO: options, guarded \let (mine, HO)
     \@ifdefinable\NormalHTTPref{\let\NormalHTTPref\httpref}} 
 %% |\ithttpref{<url>}{<text>}| displays <text> in italics:
-\newcommand*{\ithttpref}[2]{\NormalHTTPref{#1}{\textit{#2}}}
-%% === \acro{URL}s as Links ===
-%% With |\urlhttpref{<url>}|, that \acro{URL} <url> is displayed:
+% \newcommand*{\ithttpref}[2]{\NormalHTTPref{#1}{\textit{#2}}}
+%% However, I seem never to have used it. And I would now 
+%% prefer |\metahttpref| TODO ...
+%%
+%% === \URL s as Links ===
+%% With |\urlhttpref{<url>}|, that \URL\ <url> is displayed:
 \newcommand*{\urlhttpref}[1]{%
     \NormalHTTPref{#1}{\urlfmt{\httpprefix#1}}} 
+%% %% moved up here 2011/10/20
+%% In 'blog.sty' (as of 2010/05/26), there was a command 
+%% `\urlref' instead of `\urlhttpref'. It did not provide `\urlfmt'.
+%%
 %% |\httpprefix| is an idea that was missing in 'blog.sty' up to v0.3. 
 %% It may be used to determine generally whether a display of an 
-%% \acro{URL} should include `http://'. I choose as default what was default 
+%% \URL\ should include `http://'. I choose as default what was default 
 %% in 'blog.sty' 
 %% (i.e., ``don't include"):                        %% add. 2011/01/27
 \@ifdefinable\httpprefix{\let\httpprefix\@empty}    %% TODO cf. above
@@ -106,30 +155,24 @@
 %% %% v0.2:
 %% ---or by `\let\httpprefix'|\theHTTPprefix|:
 \newcommand*{\theHTTPprefix}{http://}
-%% |\urlfmt{<url>}| is chosen as `\texttt' here and may be 
-%% customized, e.g., with the 'breakurl' package.
-\@ifdefinable\urlfmt{\let\urlfmt\texttt}
-%% In 'blog.sty' (as of 2010/05/26), there was a command 
-%% `\urlref' instead of `\urlhttpref'. It did not provide `\urlfmt'.
-%%
 %% With |\urlhttpsref{<url>}|, we \emph{force} displaying \qtd{`https://'}:
 \newcommand*{\urlhttpsref}[1]{\httpsref{#1}{\urlfmt{https://#1}}}
 %%
-%% === Linking \acro{URL}s in Footnotes ===     %% 2011/08/27
+%% === Linking \URL s in Footnotes ===     %% 2011/08/27
 %% \label{sec:urlfoot}
 %% |\foothttpurlref{<url>}| just is like
 %% `\footnote{\urlhttpref{<url>}}':
 \newcommand*{\foothttpurlref}[1]{\footnote{\urlhttpref{#1}}}
 %% |\urlfoot{<short>}{<id>}|
 %% redefines `\httpref' so that you can use all the shorthand 
-%% macros based on `\httpref' to get the according \acro{URL} 
+%% macros based on `\httpref' to get the according \URL\ 
 %% display (as provided by `\urlhttpref')
 %% in a footnote without the need to include the 
-%% entire \acro{URL} in your source code. `\urlfoot' is available 
+%% entire \URL\ in your source code. `\urlfoot' is available 
 %% with <short> and <id>
 %% when a shorthand |\<short>{<id>}{<text>}| has been defined
 %% where `\<short>' is the macro name and <id> is the target 
-%% identifier (usually part of the \acro{URL} generated from <id>)
+%% identifier (usually part of the \URL\ generated from <id>)
 %% according to the syntax declaration of `\<short>'. 
 \newcommand*{\urlfoot}[2]{{%
     \let\httpref\foothttpurlref 
@@ -220,7 +263,8 @@
 \newcommand*{\Wikidedisambref}{\Wikidisambref{de}}
 \newcommand*{\Wikiendisambref}{\Wikidisambref{en}}
 %% 
-%% === Blanks and Umlauts in \acro{URL}s and Anchors ===
+%%                                  \pagebreak  %% 2011/10/21
+%% === Blanks and Umlauts in \URL s and Anchors ===
 %% %% <- renamed 2011/05/17 reworked:
 %% |\underscorechar| seemed to be useful in macro 
 %% definitions. The name was inspired by \LaTeX's 
@@ -277,17 +321,10 @@
 % \@namedef{urluml:u}{\#C3\#BC}
 % \@namedef{urluml:s}{\#C3\#9F}           %% 2010/08/09
 %% 
-%% == \TeX-related ==                                   %% 2010/08/24
-%% === \acro{CTAN}               ===
-%% |\bytopicref{<anchor>}{<text>}| 
-%% makes <text> a link to <anchor> of J\"urgen Fenn's 
-%% Topical Index of the \TeX\ Catalogue. You find the <anchor> 
-%% by clicking at the respective TOC entry on top of the page 
-%% and then read the \acro{URL} from the browser's navigation display.
-\newcommand*{\bytopicref}[1]{% 
-    \httpref{mirror.ctan.org/help/Catalogue/bytopic.html\##1}}
-%% (Example:\quad `\bytopicref{html}{\acro{HTML}}' \ for \ \bytopicref{html}{\acro{HTML}}.)
-%%
+%%                                  \pagebreak  %% 2011/10/21
+%% == \TeX-related ==                           %% 2010/08/24
+%% === \CTAN                ===
+%% ==== Directories and Files in a \TeX\ Archive ====
 %% % `\newcommand*{\ctanref}[1]{\httpref{ctan.org/#1}}' 
 %% % once was replaced in 'blog.sty' by what will now be 
 %% |\tugctanref{<path>}{<text>}|
@@ -296,27 +333,64 @@
 \newcommand*{\tugctanref}[1]{% 
   \httpref{tug.ctan.org/tex-archive/#1}} 
 %% Alternatively, you can refer to an (automatically chosen) 
-%% \acro{CTAN} \emph{mirror}
+%% \CTAN\ \emph{mirror}
 %% using 
-%% \[|\mirrorctanref{<path>}{<text>}|:\]            %% 2011/10/10
+%% \[|\mirrorctanref{<path>}{<text>}|.\] %% 2011/10/10 :->.2011/10/21: 
+%% (I prefer the \emph{appearance} of the 
+%% \tugctanref{}{\acro{TUG} archive}, designed by Jim Hefferon.)
 \newcommand*{\mirrorctanref}[1]{\httpref{mirror.ctan.org/#1}} 
 %% You may actually want to ``open" a file <file-name> in <path> 
-%% on \acro{CTAN}, either by 
+%% on \CTAN, 
+%% <file-name> displayed as the link text,          %% 2011/10/21
+%% either by 
 %% \[|\tugctanfileref{<path>}{<file-name>}|\]       %% 2011/10/10
 %% or (for a mirror) by
 %% \[|\mirrorctanfileref{<path>}{<file-name>}|.\]   %% 2011/10/10
-%% The file name format |\file{<file-name>}|
-%% that is used in the definitions must be provided 
-%% elsewhere.       %% 2011/10/06; TODO provlast
 \newcommand*{\tugctanfileref}[2]{%
-    \tugctanref{#1/#2}{\file{#2}}}
+    \tugctanref{#1/#2}{\filenamefmt{#2}}}
 \newcommand*{\mirrorctanfileref}[2]{%
-    \mirrorctanref{#1/#2}{\file{#2}}}
-%% Typically, \LaTeX\ macro packages in \file{macros/latex/contrib/}
+    \mirrorctanref{#1/#2}{\filenamefmt{#2}}}
+%% Typically, \LaTeX\ macro packages in `macros/latex/contrib/'
 %% are discussed, so here is |\ltxcontrib| saving a few characters:
 \newcommand*{\ltxcontrib}{macros/latex/contrib/}
+%% |\ctanref| works like `\tugctanref' or like `\mirrorctanref', 
+%% depending on |\usetugctan| vs.\ |\usemirrorctan|.
+%% So in any case its syntax is \[|\ctanref{<path>}{<text>}|.\]
+%% Likewise, |\ctanfileref| works like 
+%% \[`\tugctanfileref'\quad \mbox{or}\quad `\mirrorctanfileref',\]
+%% depending on the same `\usetugctan' vs.\ `\usemirrorctan', 
+%% so the syntax is 
+%% \[|\ctanfileref{<path>}{<file-name>}|\] 
+\newcommand*{\ctanref}{}    \newcommand*{\ctanfileref}{}
+\newcommand*{\usemirrorctan}{%
+    \let \ctanref     \mirrorctanref
+    \let \ctanfileref \mirrorctanfileref}
+\newcommand*{\usetugctan}{%
+    \let \ctanref     \tugctanref
+    \let \ctanfileref \tugctanfileref}
+%% |\usemirrorctan| is the \strong{default}, i.e., 
+%% |\ctanref| and |\ctanfileref| use 
+%% \urlhttpref{mirror.ctan.org}:
+\usemirrorctan
+%% \meta{Remark} (TODO): \ Another implementation I consider is 
+%% using some `\ctanurl'\-`prefix' that you can redefine for 
+%% accessing your favourite mirror.
+%%
+%% ==== J\"urgen Fenn's Topical \TeX\ Catalogue  ====
+%% |\bytopicref{<anchor>}{<text>}| 
+%% \                                                %% 2011/10/21
+%% makes <text> a link to <anchor> of J\"urgen Fenn's 
+%% Topical Index of the \TeX\ Catalogue. You find the <anchor> 
+%% by clicking at the respective \acro{TOC} entry on top of the page 
+%% and then read the \URL\ from the browser's navigation display.
+\newcommand*{\bytopicref}[1]{% 
+    \httpref{mirror.ctan.org/help/Catalogue/bytopic.html\##1}}
+%% (Example:\quad `\bytopicref{html}{\acro{HTML}}' \ for \ 
+%%  \bytopicref{html}{\acro{HTML}}.)
+%%
+%% ==== Jim Hefferon's Package Descriptions      ====
 %% |\ctanpkgref{<pkg-name>}|
-%% makes <text> a link to the \acro{CTAN} package info page for 
+%% makes <text> a link to the \CTAN\ package info page for 
 %% the package <pkg-name>. 
 %% |\CtanPkgRef{<name>}{<Name>}|
 %% is a variant for the cases where authors have a special idea
@@ -327,25 +401,18 @@
 %% Also, <Name> may be a package from a \emph{bundle} <name> 
 %% where <name> has a description page while <Name> 
 %% doesn't have its \emph{own} description page 
-%% (such as \CtanPkgRef{nicetext}{fifinddo}).
+%% (such as \CtanPkgRef{nicetext}{makedoc}).
+%% %% <- was `fifinddo' 2011/10/20, no with own id.
 \newcommand*{\CtanPkgRef}[2]{%
     \httpref{ctan.org/pkg/#1}{\pkgnamefmt{#2}}}
 \newcommand*{\ctanpkgref}[1]{\CtanPkgRef{#1}{#1}}
-%% Instead of |\pkgnamefmt{<pack-name>}|, 
-%% 'blog.sty' had `\prg{<pack-name>}', without a proper 
-%% implementation. For typesetting, choosing `\pkgnamefmt' 
-%% as `\textsf' seems to conform to common practice today. 
-%% The following code may later be suppressed at some package options, 
-%% as with the choice for `\httpref':   %% TODO 2011/01/24
-\@ifdefinable\pkgnamefmt {\let\pkgnamefmt\@firstofone}
-\AtBeginDocument         {\let\pkgnamefmt\textsf}
 %%
-%% === \acro{CTAN} Announcements ===                    %% 2011/06/27
+%% === \CTAN\ Announcements ===                 %% 2011/06/27
 %% |\ctanannref{<id>}{<text>}| makes <text> a link 
-%% to the DANTE web page displaying a \acro{CTAN} 
+%% to the DANTE web page displaying a \CTAN\ 
 %% announcement. You find <id> by searching 
 %% \[\texttt{https://lists.dante.de/pipermail/ctan-ann/}\]
-%% and then reading the \acro{URL}.
+%% and then reading the \URL.
 %% <id> is composed as `<year>-<month>/<6-digits>.html'.
 \newcommand*{\ctanannref}[1]{%
     \httpsref{lists.dante.de/pipermail/ctan-ann/#1}}
@@ -355,7 +422,7 @@
 %% year, then a `-', then the (arabic) number of 
 %% the month, then another `-', and then the actual 
 %% internal identifier 
-%% (a number of six digits preceding `.html' of the \acro{URL}). 
+%% (a number of six digits preceding `.html' of the \URL). 
 \newcommand*{\ctanannpref}[1]{%
     \ctanannref{\TL@piper@parse#1/.html}}
 \def\TL@piper@parse#1-#2-#3/{%
@@ -367,7 +434,7 @@
     \fi
     /#3}
 %%
-%% === \acro{TUG}                ===
+%% === \acro{TUG}           ===
 %% |\tugref{<path>}{<text>}| makes <text> a link
 %% to <path> on domain `tug.org':
 \newcommand*{\tugref}[1]{\httpref{tug.org/#1}}
@@ -375,7 +442,7 @@
 %% |\texhaxref{<id>}{<text>}| makes <text> a link 
 %% to the \acro{TUG} web page displaying 
 %% a texhax posting. You find <id> by searching 
-%% `tug.org/pipermail/texhax/' and then reading the \acro{URL}.
+%% `tug.org/pipermail/texhax/' and then reading the \URL.
 %% <id> is composed as `<year>-<month>/<6-digits>.html'.
 \newcommand*{\texhaxref}[1]{\tugref{pipermail/texhax/#1}}
 %% |\THref{<id>}| saves you from choosing <text> 
@@ -390,9 +457,9 @@
 %% year, then a `-', then the (arabic) number of 
 %% the month, then another `-', and then the actual 
 %% internal identifier 
-%% (a number of six digits preceding `.html' of the \acro{URL}). 
+%% (a number of six digits preceding `.html' of the \URL). 
 %% I made this macro because I prefer typing to copying 
-%% from the \acro{URL}. 
+%% from the \URL. 
 \newcommand*{\texhaxpref}[1]{%              %% 2010/09/07
     \texhaxref{20\TL@piper@parse#1/.html}}  %% 2011/05/03
 %% TODO: `\texhaxPref#1' searches list of offsets 
@@ -411,22 +478,22 @@
 %% (e.g., \TUGIref{web}{\qtd{Web Projects}}):
 \newcommand*{\TUGIref}[1]{\tugref{interest.html\##1}}
 %%
-%% === \acro{UK FAQ}             ===
+%% === \acro{UK FAQ}        ===
 %% |\ukfaqref{<label>}{<text>}| makes <text> a link to 
 %% the UK~\TeX~FAQ page with ``label"~= <label>:
 \newcommand*{\ukfaqref}[1]{\httpref{%
     www.tex.ac.uk/cgi-bin/texfaq2html?label=#1}}
-%% === Wikibooks                 ===
+%% === Wikibooks            ===
 %% |\wikibooks{<language-code>}{<file>}{<text>}|:
 \newcommand*{\wikibooksref}[2]{\httpref{#1.wikibooks.org/wiki/#2}}
-%% |\wikibooks{<file>}{<subject>}{<text>}| refers to the 
+%% |\latexwikibookref{<file>}{<subject>}{<text>}| refers to the 
 %% (English) \LaTeX\ Wikibook:
 \newcommand*{\latexwikibookref}[1]{\wikibooksref{en}{LaTeX/#1}}
 %% The German 
 %% \wikibooksref{de}{LaTeX-Kompendium}{\dqtd{\LaTeX-Kompendium}}
 %% is somewhat difficult, I leave it for now~...
 %%
-%% == Leaving      ==               %% 2011/01/24
+%% == Leaving      ==                           %% 2011/01/24
 \endinput
 %%
 %% == VERSION HISTORY ==
@@ -451,3 +518,10 @@ v0.41   2011/09/03  doc.: more specific on \urluml/Wikipedia
         2011/10/06  \mirrorctanref, \tugctanfileref, 
                     \mirrorctanfileref, \ltxcontrib
         2011/10/10  doc. formatting of previous
+uploaded with MOREHYPE r0.5(1)
+v0.5    2011/10/19  doc. fix LaTeX Wikibook
+        2011/10/20  \urlfmt, \filenamefmt and \pkgnamefmt
+                    changed and moved, modified doc. on them, 
+                    doc. uses \URL
+        2011/10/21  re-order CTAN, \pagebreak's, \ctanref and 
+                    choice for it, doc. modified; rm. \ithttpref