Debian Codegraph @

texmf-dist/source/latex/ifnextok/ifnextok.tex

raw
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