summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/dhua/docsrc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/dhua/docsrc
Initial commit
Diffstat (limited to 'macros/latex/contrib/dhua/docsrc')
-rw-r--r--macros/latex/contrib/dhua/docsrc/README.tex12
-rw-r--r--macros/latex/contrib/dhua/docsrc/dhua.tex139
-rw-r--r--macros/latex/contrib/dhua/docsrc/srcfiles.tex14
3 files changed, 165 insertions, 0 deletions
diff --git a/macros/latex/contrib/dhua/docsrc/README.tex b/macros/latex/contrib/dhua/docsrc/README.tex
new file mode 100644
index 0000000000..b6e76fac36
--- /dev/null
+++ b/macros/latex/contrib/dhua/docsrc/README.tex
@@ -0,0 +1,12 @@
+\ProvidesFile{README.tex}[2011/09/16 make README.pdf]
+\listfiles
+
+\documentclass[12pt]{article}
+\usepackage{verbatim}
+\pagestyle{empty}
+\begin{document}
+\vspace*{-2\baselineskip}
+\enlargethispage{5\baselineskip}
+% \small %% 2011/02/14
+\verbatiminput{README.txt}
+\end{document}
diff --git a/macros/latex/contrib/dhua/docsrc/dhua.tex b/macros/latex/contrib/dhua/docsrc/dhua.tex
new file mode 100644
index 0000000000..4922859898
--- /dev/null
+++ b/macros/latex/contrib/dhua/docsrc/dhua.tex
@@ -0,0 +1,139 @@
+\ProvidesFile{dhua.tex}[2011/09/19 make dhua.pdf about dhua.sty]
+\title{\textsf{dhua.sty}\\---\\German Abbreviations
+ Using Thin Space\thanks{This
+ document describes version
+ \textcolor{blue}{\UseVersionOf{\jobname.sty}}
+ of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
+% \listfiles
+{ \RequirePackage{makedoc} \ProcessLineMessage{}
+ \MakeJobDoc{16}
+ {\SectionLevelTwoParseInput} }
+\documentclass[fleqn]{article} %% TODO paper dimensions!?
+\input{makedoc.cfg} %% shared formatting settings
+\providecommand*\pkg{\pkgnamefmt} %% TODO should be in makedoc.cfg
+%% 2011/09/09:
+\AddQuotes %% niceverb
+\hypersetup{%
+ pdftitle=dhua.sty for German abbreviations using thin space,
+ pdfsubject=documenting dhua.sty
+}
+\MDkeywords{German typography;
+ web typography, language support, macro programming}
+\usepackage{dhua}
+% \makeatletter
+\newenvironment*{german}
+ {\par
+ \it\frenchspacing\DontAddQuotes
+ \let\qtd\deqtd}
+% {\par\@endpefalse} %% strange: in vain
+ {\par}
+% \makeatother
+% \usepackage[T1]{fontenc} %% TODO just for ...!?
+% \newcommand*{\deqtd}[1]{\guillemotleft#1\guillemotright}
+\let\EnToday\today
+\usepackage{german} \mdqoff \let\today\EnToday
+\renewcommand*{\contentsname}{Contents}
+\renewcommand*{\abstractname}{Abstract/Zusammenfassung}
+\newcommand*{\deqtd}[1]{\glqq#1\grqq}
+\newcommand*{\HTML}{\acro{HTML}}
+\sloppy
+\begin{document}
+\maketitle
+\begin{MDabstract}\DontAddQuotes
+'dhua.sty' provides commands for German phrase abbreviations
+such as \qtd{\dh}\ that are recommended to use a
+\Wikienref{thin space}---set-up commands `\newdhua' and
+`\newtwopartdhua' %%% --- %% rm. 2011/09/16
+as well as commands for single cases (e.g., `\zB' for \qtd{\zB},
+to save you from typing `z.\,B.').
+% %% 2011/09/15:
+% Moreover, there are package options for (i)~web typography
+% and (ii)~automatical inclusion of `\xspace'.
+Package options are intended to support generating \acro{PDF}
+and \HTML\ from the same source, maybe automatically using
+`\xspace'.
+
+\begin{german} %% reworded 2011/09/16
+ Das Paket 'dhua' bietet Befehle f\"ur sog.\
+ mehrgliedrige Abk\"urzungen, f\"ur die
+ \wikideref{Schmales Lehrzeichen}{schmale Leerzeichen}
+ (\wikideref{Festabstand}{Festabst\"ande}) empfohlen werden.
+ In die englische Paketdokumentation sind deutsche Hinweise
+ (kursiv) eingestreut.
+\end{german}
+\end{MDabstract}
+\tableofcontents
+
+% \newpage
+\section{Installing, Calling, Usage}
+The file 'dhua.sty' is provided ready, installation only requires
+putting it somewhere where \TeX\ finds it
+(which may need updating the filename data
+ base).\urlfoot{ukfaqref}{inst-wlcf} %% corr. 2011/02/08
+
+%% extended 2011/01/14:
+Below the `\documentclass' line(s) and above `\begin{document}',
+you load 'dhua.sty' (as usually) by
+\[`\usepackage{dhua}'\]
+or by
+\[`\usepackage[<option(s)>]{dhua}'\]
+with the option(s) <option(s)> described in Section~\ref{sec:opt}
+(`[web]', `[xspace]'). A few macros for single abbreviations
+are described in Section~\ref{sec:single},
+the macros `\newdhua' and `\newtwopartdhua' for defining such
+abbreviation macros are described in Section~\ref{sec:setup}.
+
+\begin{german}
+ Unten werden (i)~Paketoptionen `[web]' und `[xspace]',
+ (ii)~die Makros `\newdhua' und `\newtwopartdhua'
+ f\"ur die Definition einzelner Ab\-k\"ur\-zungs\-makros
+ sowie (iii)~einzelne vordefinierte Abk\"urzungsmakros beschrieben.
+\end{german}
+
+\section{Package File Header (Legalize)}
+\input{dhua.doc}
+\section{Colophon} %% was `Coda' 2011/09/16
+ %% rm. \enlargethispage{3\baselineskip} 2011/09/19
+The English part of the documentation exemplifies a new
+(2011/09/09) function of 'niceverb.sty' v0.44: automatically
+enclose inline \TeX\ code in single quotation marks after
+`\AddQuotes'.
+I needed especially much time for this because group nesting
+spans several documentation pages.
+
+% On my Atari~ST, there must be another 'dhua.sty'.
+% I~guess it was quite worthless.
+% I think it is only about one year ago that I~became aware
+% of the Duden recommendation about thin unbreakable spaces.
+% I consider this older package 'dhua'~v0.\dots
+% The present version number \qtd{v1.1} is an analogue
+% to my usual starting version number \qtd{v0.1}.
+
+I spent much time with a special environment `{german}'
+for the present purpose: the indent of the following
+paragraph was missing---until I added an empty
+documentation line. (Same with standard `{sloppypar}'
+environment, I don't understand it, tried
+`\@endpefalse' in vain.)
+%% modified 2011/09/16:
+I don't like \ctanpkgref{babel}~\dots
+
+%% 2011/09/16:
+The German parts use 'niceverb''s `\DontAddQuotes'
+because of a different frequency of \TeX\ code.
+Even in the English parts I considered the single
+quotation marks bad and avoided them using \LaTeX's `\verb'.
+
+And my terms \qtd{phrase abbreviation} and \qtd{abbreviation macro}
+may be bad, please help me~\dots
+
+\end{document}
+
+VERSION HISTORY
+
+2011/09/14 for v0.1 renaming from `dhusw'
+2011/09/15 for v0.1a options in abstract
+2011/09/16 more keywords, different \Provides...,
+ Coda/Colophon extended
+2011/09/19 for v0.11 Colophon on next page
+
diff --git a/macros/latex/contrib/dhua/docsrc/srcfiles.tex b/macros/latex/contrib/dhua/docsrc/srcfiles.tex
new file mode 100644
index 0000000000..135ca79a0c
--- /dev/null
+++ b/macros/latex/contrib/dhua/docsrc/srcfiles.tex
@@ -0,0 +1,14 @@
+\RequirePackage{myfilist}
+\ProvidesFile{srcfiles.tex}[2011/09/16 file infos -> SrcFILEs.txt]
+\EmptyFileList %%% [readprov.sty,myfilist.sty]
+%% packages:
+\ReadPackageInfos{dhua}
+\ReadFileInfos{dhua.cfg}
+%% documentation:
+\ReadFileInfos{dhua,README}
+%% documentation settings and auxiliaries:
+% \ReadPackageInfos{fifinddo,makedoc,niceverb}
+% \ReadFileInfos{makedoc.cfg,mdoccorr.cfg}
+\ReadFileInfos{srcfiles}
+\ListInfos[SrcFILEs.txt]
+