done documenting and added a section on icite and classics. new functions \AuthorTitleDelim and \TitlePageDelim

1 files changed, 52 insertions, 7 deletions

diff --git a/icite.dtx b/icite.dtx
index 57a8bd4..3202594 100644
--- a/icite.dtx
+++ b/icite.dtx
@@ -349,10 +349,10 @@ Running "make install" installs the files in the local TeX tree.
 \newunicodechar{Ǧ}{Ǧ} %
 \usepackage{arabluatex}
 \SetTranslitConvention{loc}
-\usepackage{varioref}
 \usepackage{xurl}
 \usepackage{uri}
 \usepackage{hyperxmp}
+\usepackage{varioref}
 \usepackage[numbered]{hypdoc}
 \hypersetup{unicode=true, colorlinks, allcolors=blue,
   linktocpage=true, pdfauthor={Robert Alessi}, pdftitle={The
@@ -367,9 +367,10 @@ Running "make install" installs the files in the local TeX tree.
   pdflicenseurl={https://creativecommons.org/licenses/by-sa/4.0/legalcode},
   pdfmetalang={en-US}, pdftype={Text}, pdfkeywords={bibtex, biblatex,
     indexing}}
+\usepackage{amsmath}
+\usepackage{cleveref}
 \CodelineIndex
 \usepackage[citecmd=autocite,defaultindex]{\jobname}
-\usepackage{cleveref}
 \IndexSubtypeAs{classical}{primary}
 \bibinput{icite}
 \usepackage[nonewpage,xindy]{imakeidx}
@@ -670,6 +671,8 @@ Running "make install" installs the files in the local TeX tree.
 %</example>
 % \fi
 %
+% \subsection{Preamble-only commands}
+% The following commands may be found in the preamble only.
 % \paragraph{Styling the titles}
 % \DescribeMacro{\SetTitleStyle} By default, \package{icite} prints
 % the titles of the works cited in italics.\\
@@ -688,6 +691,21 @@ Running "make install" installs the files in the local TeX tree.
 % As this example shows, |#1| is the token that is replaced with the
 % actual title in the formatting directives of the \cs{SetTitleStyle}
 % command.
+% 
+% \paragraph{Delimiters}
+% \NEWfeature{v1.2}\DescribeMacro{\AuthorTitleDelim}
+% \cs{AuthorTitleDelim}\marg{delimiter} sets the delimiter between
+% authors and titles in the body text when the |nobibengine| option is
+% set to |true|. The default delimiter is a comma and a space.
+%
+% \DescribeMacro{\TitlePageDelim}
+% \cs{TitlePageDelim}\marg{delimiter} sets the delimiter between
+% titles and pages in the body text when the |nobibengine| option is
+% set to |true|. The default delimiter is a comma and a space.
+%
+% \subsection[\textsf{icite} for the Impatient]%
+% {\package{icite} for the Impatient}
+% Read \href{samples/icite-minimal.pdf}{\texttt{icite-minimal.pdf}}.
 %
 % \subsection{Entry fields}
 % \label{sec:entry-fields}
@@ -1004,7 +1022,7 @@ Running "make install" installs the files in the local TeX tree.
 % \subsection[The \textsf{classics} package]%
 % {The \package{classics} package} %
 % \label{sec:classics-usage}
-% As said above on \cpageref{ref:classics-pkg}, it is advisable to use
+% As said above \vpageref{ref:classics-pkg}, it is advisable to use
 % the \package{classics} package to format volume, page, column, line
 % numbers and the like which are inserted in the \meta{post} optional
 % argument of the \cs{icite} command\autocite{classics}. An example of
@@ -1219,7 +1237,32 @@ Running "make install" installs the files in the local TeX tree.
 }
 \@onlypreamble\SetTitleStyle
 %    \end{macrocode}
-% 
+% \DescribeMacro{\AuthorTitleDelim}
+% \changes{v1.2}{2019/03/16}{\cs{AuthorTitleDelim}: delimiter
+% between authors and titles}\cs{AuthorTitleDelim}\marg{delimiter}
+% sets the delimiter between authors and titles in the body text when
+% the |nobibengine| option is set to |true|. The default delimiter is
+% a comma.
+%    \begin{macrocode}
+\def\ic@authtitdelim{, }
+\NewDocumentCommand{\AuthorTitleDelim}{m}{%
+  \def\ic@authtitdelim{#1}
+}
+\@onlypreamble\AuthorTitleDelim
+%    \end{macrocode}
+% \DescribeMacro{\TitlePageDelim}
+% \changes{v1.2}{2019/03/16}{\cs{TitlePageDelim}: the delimiter
+% between titles and pages}\cs{TitlePageDelim}\marg{delimiter} sets
+% the delimiter between titles and pages in the body text when the
+% |nobibengine| option is set to |true|. The default delimiter is a
+% comma.
+%    \begin{macrocode}
+\def\ic@titpgdelim{, }
+\NewDocumentCommand{\TitlePageDelim}{m}{%
+  \def\ic@titpgdelim{#1}
+}
+\@onlypreamble\TitlePageDelim
+%    \end{macrocode} 
 % \DescribeMacro{\icite} \cs{icite} both inserts a formatted citation
 % and an entry in the \emph{index locorum citatorum}. It is to be used
 % in place of any \hologo{BibTeX} or Bib\LaTeX\ citation command the
@@ -1292,7 +1335,7 @@ Running "make install" installs the files in the local TeX tree.
         \fi}}
     \ifno@bibengine
     \ifx\@shorthand\empty%
-    \@useauthor, \TitleStyle{\@usetitle}%
+    \@useauthor\ic@authtitdelim\TitleStyle{\@usetitle}%
     \else%
     \@shorthand%
     \fi%
@@ -1324,7 +1367,8 @@ Running "make install" installs the files in the local TeX tree.
           \fi}}%
       \ifno@bibengine
       \ifx\@shorthand\empty%
-      \@useauthor, \TitleStyle{\@usetitle}, {#1}%
+      \@useauthor\ic@authtitdelim\TitleStyle{\@usetitle}%
+         \ic@titpgdelim{#1}%
       \else%
       \@shorthand, {#1}%
       \fi%
@@ -1355,7 +1399,8 @@ Running "make install" installs the files in the local TeX tree.
           \fi}}%
       \ifno@bibengine
       \ifx\@shorthand\empty%
-      #1 \@useauthor, \TitleStyle{\@usetitle}, {#2}%
+      #1 \@useauthor\ic@authtitdelim\TitleStyle{\@usetitle}%
+         \ic@titpgdelim{#2}%
       \else%
       #1 \@shorthand, {#2}%
       \fi