| 1 |
\ProvidesFile{ifnextok.tex}[2011/06/26 documenting ifnextok.sty (UL)] |
| 2 |
\title{\textsf{\huge ifnextok}\\---\\\cs{IfNextToken} |
| 3 |
% \MakeNotSkipping\\{\\\relax}% |
| 4 |
instead of \cs{@ifnextchar}\\Does Not Skip Blank |
| 5 |
Spaces,\\ [\,and \qtd{\texttt{\string\\ [}} may print bracket in\\ |
| 6 |
new line\,]\thanks{This document describes version |
| 7 |
\textcolor{blue}{\UseVersionOf{ifnextok.sty}} |
| 8 |
of \file{ifnextok.sty} as of \UseDateOf{ifnextok.sty}.}} |
| 9 |
{ \RequirePackage{makedoc}[2010/12/20] \ProcessLineMessage{} |
| 10 |
\MakeJobDoc{18}{\SectionLevelThreeParseInput} |
| 11 |
} |
| 12 |
\documentclass{article}%% TODO paper dimensions!? |
| 13 |
\input{makedoc.cfg} %% shared formatting settings |
| 14 |
\usepackage{color} |
| 15 |
% \ReadPackageInfos{ifnextok} %% 2011/06/26 |
| 16 |
\usepackage[stdbreaks]{ifnextok} %% 2011/05/27 |
| 17 |
% \usepackage{ifnextok} %% 2011/05/31 |
| 18 |
\newcommand*{\secref}[1]{Section~\ref{sec:#1}} %% 2011/05/30 |
| 19 |
\newcommand*{\meta}{\textit} %% 2011/06/14 |
| 20 |
% \MakeActive\" \def"#1"{``#1''} %% 2011/06/25 |
| 21 |
%% <- bad with examples!? TODO |
| 22 |
% \usepackage{german} \mdqoff %% 2011/05/31 |
| 23 |
% \tracingmacros=1 \tracingonline=1 |
| 24 |
% \IfNextSpace{\show\\}{\show\/} |
| 25 |
\makeatletter |
| 26 |
% \@beginparpenalty\@lowpenalty |
| 27 |
% \show\@xnewline |
| 28 |
% \tracingmacros=1 \tracingonline=1 |
| 29 |
% \NoNewlineSkipping |
| 30 |
% \NextTokenForNextChar\@xnewline |
| 31 |
% \show\@xnewline |
| 32 |
% \show\\ |
| 33 |
% \show\@normalcr |
| 34 |
\makeatother |
| 35 |
\sloppy |
| 36 |
\begin{document} |
| 37 |
% \MakeNotSkipping\\{\\\relax} |
| 38 |
\maketitle |
| 39 |
\begin{abstract} %%% \noindent |
| 40 |
% \MakeNotSkipping\\{\\\relax} |
| 41 |
% \mdqon \MakeNotSkipping"{\rq\rq} (``Uwe L"uck" ) |
| 42 |
The 'ifnextok' package deals with the behavior of |
| 43 |
\LaTeX's internal `\@ifnextchar' to skip blank spaces. |
| 44 |
This sometimes has surprising or for some users really |
| 45 |
\emph{unwanted} effects, especially with brackets following |
| 46 |
`\\' when %% v0.1a: was `where' |
| 47 |
the user does \emph{not} intend to specify an |
| 48 |
optional argument, rather wants that brackets are \emph{printed.} |
| 49 |
The package offers commands and options for modifying this |
| 50 |
behavior, maybe limited to certain parts of the document source.\\ |
| 51 |
[It works!] |
| 52 |
It may also be useful with active characters in lieu of `\\', |
| 53 |
% \mdqon |
| 54 |
e.g., the double quote `"' with \ctanpkgref{german}`.sty' |
| 55 |
or \ctanpkgref{babel}. |
| 56 |
|
| 57 |
v0.3 fixes behavior in non-typesetting mode with |
| 58 |
`\MakeNotSkipping', using a somewhat different technique |
| 59 |
than \LaTeX's robustifications. |
| 60 |
% `\DeclareRobustCommand'. |
| 61 |
\par\smallskip\noindent |
| 62 |
\strong{Keywords:}\quad |
| 63 |
macro programming, optional command arguments, |
| 64 |
manual line breaks, humanities |
| 65 |
\par\smallskip\noindent |
| 66 |
\strong{Related packages:}\quad \ctanpkgref{amsmath}, |
| 67 |
\ctanpkgref{mathtools} |
| 68 |
\end{abstract} |
| 69 |
\newpage %% 2011/06/26 |
| 70 |
\tableofcontents |
| 71 |
|
| 72 |
\newpage %% 2011/06/26 |
| 73 |
\section{Installing and Calling} |
| 74 |
The package file `ifnextok.sty' is provided ready, |
| 75 |
installation only requires putting it somewhere where \TeX\ finds it |
| 76 |
(which may need updating the filename data |
| 77 |
base).\urlfoot{ukfaqref}{inst-wlcf} |
| 78 |
|
| 79 |
Below the `\documentclass' line(s) and above `\begin{document}', |
| 80 |
you load `ifnextok.sty' (as usually) by |
| 81 |
\[`\usepackage{ifnextok}'\qquad \mbox{or by}\qquad |
| 82 |
`\usepackage[<options>]{ifnextok}'\]---<options> described |
| 83 |
in Section~\ref{sec:options}. E.g., the \emph{main goal} of |
| 84 |
writing the package is achieved by |
| 85 |
\[`\usepackage[stdbreaks]{ifnextok}'\] |
| 86 |
|
| 87 |
% \section{The Package File} |
| 88 |
\section{Header (Legalize)} |
| 89 |
\input{ifnextok.doc} |
| 90 |
\end{document} |
| 91 |
|
| 92 |
VERSION HISTORY |
| 93 |
|
| 94 |
2011/05/22f. very first |
| 95 |
2011/05/27 mentioning [stdbreaks] for v0.11 |
| 96 |
2011/05/30 testing \MakeNotSkipping |
| 97 |
2011/06/02 for v0.21: "related packages" |
| 98 |
2011/06/26 for v0.3: mentioning \MakeNotSkipping, \newpage, |
| 99 |
different sectioning |