\ProvidesFile{substr.tex}[2012/03/18 documentation for substr.sty] \title{\textsf{substr.sty}\thanks{See \url{http://ctan.org/pkg/substr} for more about \textsf{substr.sty}.}---Substring Functions with \LaTeX} \author{Harald Harders\thanks{Joint work with Heiko Oberdiek, one line + documentation tool by Uwe L\"uck.}} % \listfiles %% Preprocessing 'substr.sty': \RequirePackage{makedoc} %% Replacements: \SetPatternCodes{\MakeOther\\} \MakeExpandableAllReplacer{Cmds} {Commands:}{\SECT{Commands:}}{LEAVE} \PrependExpandableAllReplacer{Change}{ChangeLog}{\SECT{ChangeLog}} \PrependExpandableAllReplacer{CR}{Copyright}{\COPYRIGHT} \PrependExpandableAllReplacer{LaTeX} [\MakeOther\ ]{LaTeX }{\LaTeX{} } \PrependExpandableAllReplacer{HH@} {h.harders@tu-bs.de} {`h.harders@tu-bs.de'\MEDSK} \PrependExpandableAllReplacer{COMP} {de.comp.text.tex} {`de.comp.text.tex'} \PrependExpandableAllReplacer{LPPL} {macros/latex/base/lppl.txt} {`macros/latex/base/lppl.txt'} \PrependExpandableAllReplacer{Hist}[\MakeOther\ ]% {History of this package:}{\SECT{History of this package:}} \ResetPatternCodes \SetCorrectHookJobLast \HeaderLines{3} \MainDocParser{\ProcessInputWith{comment}} \LaTeXresultFile{substr.doc} \MakeCloseDoc*{substr.sty} \documentclass{article} \usepackage{hyperref,makedoc,niceverb} %% niceverb after hyperref! \AddToNoVerbList{\MEDSK\SECT\textbf\COPYRIGHT,\LaTeX} \newcommand*{\MEDSK}{\par\medskip} \newcommand*{\SECT}[1]{\MEDSK\textbf{#1}\nopagebreak\par} \newcommand*{\COPYRIGHT}{\MEDSK\textbf{Copyright} } \usepackage[utf8]{inputenc} %% for v1.2 \pagestyle{myheadings} \markboth{\textsf{substr.sty}}{\textsf{substr.sty}} \usepackage{parskip} \usepackage{ragged2e} %% 2012/03/18 \begin{document} \maketitle \begin{abstract}\noindent This documentation of 'substr.sty' has been typeset by automatical ASCII\slash UTF\hbox{-}8~$\to$ \LaTeX\ enhancement provided by 'makedoc.sty' and 'niceverb.sty''s ``auto mode."\footnote{See \url{http://ctan.org/pkg/nicetext} for more on these packages.} Some extended formatting---kind of sectioning, switches to `\tt'---have been achieved by string replacements specific to the comment text of the package file (see source file 'substr.tex'). 'substr.sty' especially demonstrates the rather rare \lq`%% '\rq\ style of package comments that is somewhat favoured by 'makedoc' because this way ``true comments" are easily distinguishable from mere ``commenting out." % % The idea to use 'parskip.sty' for formatting the documentation % (as opposed to the version of the present file of one week ago) % is due to the quite recent % 'import.tex'\footnote{\url{http://ctan.org/pkg/import}} % that %% ??? \end{abstract} \sloppy \RaggedRight % \MakeJobDoc{3}{\ProcessInputWith{comment}} \AutoCmdInput{substr.doc} \enlargethispage{\baselineskip} \end{document} %% HISTORY 2010/03/18 sent to CTAN 2010/03/27 removed `\usepackage{substr}' 2010/03/28 extended formatting by replacing words 2010/03/29 \SetPatternCodes etc. 2010/03/30 import -> substr; see source file 2011/08/20 \ProvidesFile for fileinfo 2012/03/18 use \MakeCloseDoc*, \enlargethispage, ragged2e