summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/ifnextok/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/ifnextok/docsrc
Initial commit
Diffstat (limited to 'macros/latex/contrib/ifnextok/docsrc')
-rw-r--r--macros/latex/contrib/ifnextok/docsrc/ifnextok.tex99
-rw-r--r--macros/latex/contrib/ifnextok/docsrc/makedoc.cfg43
-rw-r--r--macros/latex/contrib/ifnextok/docsrc/srcfiles.tex8
-rw-r--r--macros/latex/contrib/ifnextok/docsrc/testINT.tex16
-rw-r--r--macros/latex/contrib/ifnextok/docsrc/testIfNT.tex16
5 files changed, 182 insertions, 0 deletions
diff --git a/macros/latex/contrib/ifnextok/docsrc/ifnextok.tex b/macros/latex/contrib/ifnextok/docsrc/ifnextok.tex
new file mode 100644
index 0000000000..5efcc81391
--- /dev/null
+++ b/macros/latex/contrib/ifnextok/docsrc/ifnextok.tex
@@ -0,0 +1,99 @@
+\ProvidesFile{ifnextok.tex}[2011/06/26 documenting ifnextok.sty (UL)]
+\title{\textsf{\huge ifnextok}\\---\\\cs{IfNextToken}
+% \MakeNotSkipping\\{\\\relax}%
+ instead of \cs{@ifnextchar}\\Does Not Skip Blank
+ Spaces,\\ [\,and \qtd{\texttt{\string\\ [}} may print bracket in\\
+ new line\,]\thanks{This document describes version
+ \textcolor{blue}{\UseVersionOf{ifnextok.sty}}
+ of \file{ifnextok.sty} as of \UseDateOf{ifnextok.sty}.}}
+{ \RequirePackage{makedoc}[2010/12/20] \ProcessLineMessage{}
+ \MakeJobDoc{18}{\SectionLevelThreeParseInput}
+}
+\documentclass{article}%% TODO paper dimensions!?
+\input{makedoc.cfg} %% shared formatting settings
+\usepackage{color}
+% \ReadPackageInfos{ifnextok} %% 2011/06/26
+\usepackage[stdbreaks]{ifnextok} %% 2011/05/27
+% \usepackage{ifnextok} %% 2011/05/31
+\newcommand*{\secref}[1]{Section~\ref{sec:#1}} %% 2011/05/30
+\newcommand*{\meta}{\textit} %% 2011/06/14
+% \MakeActive\" \def"#1"{``#1''} %% 2011/06/25
+%% <- bad with examples!? TODO
+% \usepackage{german} \mdqoff %% 2011/05/31
+% \tracingmacros=1 \tracingonline=1
+% \IfNextSpace{\show\\}{\show\/}
+\makeatletter
+% \@beginparpenalty\@lowpenalty
+% \show\@xnewline
+% \tracingmacros=1 \tracingonline=1
+% \NoNewlineSkipping
+% \NextTokenForNextChar\@xnewline
+% \show\@xnewline
+% \show\\
+% \show\@normalcr
+\makeatother
+\sloppy
+\begin{document}
+% \MakeNotSkipping\\{\\\relax}
+\maketitle
+\begin{abstract} %%% \noindent
+% \MakeNotSkipping\\{\\\relax}
+% \mdqon \MakeNotSkipping"{\rq\rq} (``Uwe L"uck" )
+ The 'ifnextok' package deals with the behavior of
+ \LaTeX's internal `\@ifnextchar' to skip blank spaces.
+ This sometimes has surprising or for some users really
+ \emph{unwanted} effects, especially with brackets following
+ `\\' when %% v0.1a: was `where'
+ the user does \emph{not} intend to specify an
+ optional argument, rather wants that brackets are \emph{printed.}
+ The package offers commands and options for modifying this
+ behavior, maybe limited to certain parts of the document source.\\
+ [It works!]
+ It may also be useful with active characters in lieu of `\\',
+% \mdqon
+ e.g., the double quote `"' with \ctanpkgref{german}`.sty'
+ or \ctanpkgref{babel}.
+
+ v0.3 fixes behavior in non-typesetting mode with
+ `\MakeNotSkipping', using a somewhat different technique
+ than \LaTeX's robustifications.
+% `\DeclareRobustCommand'.
+ \par\smallskip\noindent
+\strong{Keywords:}\quad
+ macro programming, optional command arguments,
+ manual line breaks, humanities
+ \par\smallskip\noindent
+\strong{Related packages:}\quad \ctanpkgref{amsmath},
+ \ctanpkgref{mathtools}
+\end{abstract}
+ \newpage %% 2011/06/26
+\tableofcontents
+
+ \newpage %% 2011/06/26
+\section{Installing and Calling}
+The package file `ifnextok.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}
+
+Below the `\documentclass' line(s) and above `\begin{document}',
+you load `ifnextok.sty' (as usually) by
+\[`\usepackage{ifnextok}'\qquad \mbox{or by}\qquad
+ `\usepackage[<options>]{ifnextok}'\]---<options> described
+in Section~\ref{sec:options}. E.g., the \emph{main goal} of
+writing the package is achieved by
+\[`\usepackage[stdbreaks]{ifnextok}'\]
+
+% \section{The Package File}
+\section{Header (Legalize)}
+\input{ifnextok.doc}
+\end{document}
+
+VERSION HISTORY
+
+2011/05/22f. very first
+2011/05/27 mentioning [stdbreaks] for v0.11
+2011/05/30 testing \MakeNotSkipping
+2011/06/02 for v0.21: "related packages"
+2011/06/26 for v0.3: mentioning \MakeNotSkipping, \newpage,
+ different sectioning
diff --git a/macros/latex/contrib/ifnextok/docsrc/makedoc.cfg b/macros/latex/contrib/ifnextok/docsrc/makedoc.cfg
new file mode 100644
index 0000000000..b1d9cb4bb1
--- /dev/null
+++ b/macros/latex/contrib/ifnextok/docsrc/makedoc.cfg
@@ -0,0 +1,43 @@
+\ProvidesFile{makedoc.cfg}[2011/06/27 documentation settings]
+
+\author{Uwe L\"uck\thanks{\url{http://contact-ednotes.sty.de.vu}}}
+% \author{Uwe L\"uck---{\tt http://contact-ednotes.sty.de.vu}}
+
+%% hyperref:
+\RequirePackage{ifpdf}
+\usepackage[%
+ \ifpdf
+% bookmarks=false, %% 2010/12/22
+% bookmarksnumbered,
+ bookmarksopen, %% 2011/01/24!?
+ bookmarksopenlevel=2, %% 2011/01/23
+% pdfpagemode=UseNone,
+% pdfstartpage=10,
+% pdfstartview=FitH,
+ citebordercolor={ .6 1 .6},
+ filebordercolor={1 .6 1},
+ linkbordercolor={1 .9 .7},
+ urlbordercolor={ .7 1 1}, %% playing 2011/01/24
+ \else
+ draft
+ \fi
+]{hyperref}
+
+\RequirePackage{niceverb}[2011/01/24]
+\RequirePackage{readprov} %% 2010/12/08
+\RequirePackage{hypertoc} %% 2011/01/23
+\RequirePackage{texlinks} %% 2011/01/24
+\makeatletter
+ \@ifundefined{strong}
+ {\let\strong\textbf} %% 2011/01/24
+ {}
+ \@ifundefined{file}
+ {\let\file\texttt} %% 2011/05/23
+ {}
+\makeatother
+
+\errorcontextlines=4
+\pagestyle{headings}
+
+\endinput
+
diff --git a/macros/latex/contrib/ifnextok/docsrc/srcfiles.tex b/macros/latex/contrib/ifnextok/docsrc/srcfiles.tex
new file mode 100644
index 0000000000..e7f6f89d51
--- /dev/null
+++ b/macros/latex/contrib/ifnextok/docsrc/srcfiles.tex
@@ -0,0 +1,8 @@
+\RequirePackage{myfilist}
+\ProvidesFile{srcfiles.tex}[2011/06/27 collect file infos]
+\EmptyFileList %%% [readprov.sty,myfilist.sty]
+\ReadPackageInfos{ifnextok}
+\ReadFileInfos{ifnextok,testIfNT,srcfiles}
+\ReadPackageInfos{niceverb}
+\ReadFileInfos{makedoc.cfg}
+\ListInfos[SRCFILEs.txt]
diff --git a/macros/latex/contrib/ifnextok/docsrc/testINT.tex b/macros/latex/contrib/ifnextok/docsrc/testINT.tex
new file mode 100644
index 0000000000..1168f8a367
--- /dev/null
+++ b/macros/latex/contrib/ifnextok/docsrc/testINT.tex
@@ -0,0 +1,16 @@
+\ProvidesFile{testINT.tex}[2011/06/25 test ifnextok.sty]
+\RequirePackage{ifnextok}
+\makeatletter
+ \providecommand\StripEsc{\expandafter\@gobble\string}
+\makeatother
+\catcode`\"\active \edef"{q}
+\MakeNotSkipping{"}{\StripEsc\"}
+\documentclass{article}
+\begin{document}
+\tableofcontents
+\section{"a" b}
+\thispagestyle{headings}
+\markboth{}{"a" b}
+"a" b
+\typeout{"a" b}
+\end{document}
diff --git a/macros/latex/contrib/ifnextok/docsrc/testIfNT.tex b/macros/latex/contrib/ifnextok/docsrc/testIfNT.tex
new file mode 100644
index 0000000000..34db821600
--- /dev/null
+++ b/macros/latex/contrib/ifnextok/docsrc/testIfNT.tex
@@ -0,0 +1,16 @@
+\ProvidesFile{testIfNT.tex}[2011/06/27 test ifnextok.sty]
+\RequirePackage{ifnextok}
+\makeatletter
+ \providecommand\StripEsc{\expandafter\@gobble\string}
+\makeatother
+\catcode`\"\active \edef"{q}
+\MakeNotSkipping{"}{\StripEsc\"}
+\documentclass{article}
+\begin{document}
+\tableofcontents
+\section{"a" b}
+\thispagestyle{headings}
+\markboth{}{"a" b}
+"a" b
+\typeout{"a" b}
+\end{document}