summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/spacingtricks
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-03-07 03:02:56 +0000
committerNorbert Preining <norbert@preining.info>2023-03-07 03:02:56 +0000
commit4f55c9271affed648c1a939790a73083043752f5 (patch)
tree5de3491421bbf46cdb941a9a70158ca43e748919 /macros/latex/contrib/spacingtricks
parent75cd005305bd2c2a0ec383f30ee5b1749ed15183 (diff)
CTAN sync 202303070302
Diffstat (limited to 'macros/latex/contrib/spacingtricks')
-rw-r--r--macros/latex/contrib/spacingtricks/spacingtricks.dtx74
-rw-r--r--macros/latex/contrib/spacingtricks/spacingtricks.pdfbin177965 -> 178478 bytes
2 files changed, 40 insertions, 34 deletions
diff --git a/macros/latex/contrib/spacingtricks/spacingtricks.dtx b/macros/latex/contrib/spacingtricks/spacingtricks.dtx
index 68a4afbdd9..cea5d0322e 100644
--- a/macros/latex/contrib/spacingtricks/spacingtricks.dtx
+++ b/macros/latex/contrib/spacingtricks/spacingtricks.dtx
@@ -20,7 +20,7 @@
%<*package>
\NeedsTeXFormat{LaTeX2e}[2005/12/01]
\ProvidesPackage{spacingtricks}
- [2023/02/27 v1.5 .dtx spacingtricks file]
+ [2023/03/05 v1.6 .dtx spacingtricks file]
%</package>
%<*driver>
\documentclass{ltxdoc}
@@ -58,7 +58,7 @@
%</driver>
% \fi
%
-% \CheckSum{242}
+% \CheckSum{246}
%
% \CharacterTable
% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -108,17 +108,21 @@
% \changes{v1.5}{2023/02/26}{
% - Tests and comments about paracol and reledpar packages}
%
+% \changes{v1.6}{2023/03/05}{
+% - Any list symbol is followed by a space if there is no punctuation character after it,
+% - some changes in documentation}
+%
% \GetFileInfo{spacingtricks.sty}
%
% \title{The \textsf{spacingtricks} package\thanks{This document
% corresponds to \textsf{spacingtricks}~\fileversion, dated \filedate.}}
% \author{Antoine Missier \\ \texttt{antoine.missier@ac-toulouse.fr}}
-% \date{February 27, 2023}
+% \date{March 5, 2023}
% \maketitle
%
% \section{Introduction}
%
-% This package offers some macros to deal with spacing issues. Thus:
+% This package offers a few macros to deal with spacing issues. Thus:
% \begin{compactlist}
% \item \hyperlink{centered}{\texttt{\bslash centered}} yields good horizontal
% centering without vertical spacing;
@@ -133,7 +137,7 @@
% produces indentation of all its content;
% \item the \hyperlink{compactlist}{\texttt{compactlist}} environment
% yields a compact list, without vertical spacing between the items, like here;
-% several \hyperlink{aliases}{aliases} are provided to type some list symbols shorter:
+% several aliases are provided to type some \hyperlink{symbols}{list symbols} shorter:
% "\bul", "\dash", "\ddash", "\aster", "\hand", "\checksymb", "\arrowsymb";
% \item common abbreviations \hyperlink{ie-eg}{\ie and \eg}
% are typeset by the macros "\ie" and "\eg" with correct spacing;
@@ -252,9 +256,9 @@
% a thin space is added before the note calls, and the new \texttt{\bslash footnote}
% macro does not alter this behavior.}.
% To avoid undesirable spaces, we don't have to put some space before
-% or after writing "\footnote{", for instance:
+% writing "\footnote{", for instance:
% \begin{center}
-% "this is a note\footnote{good spacing} which works fine,"
+% "Here is no space\footnote{The old command} before the macro."
% \end{center}
% but sometimes, it is convenient to place the "\footnote" command
% on a new line. To achieve this, "\footnote" has been redefined to completely eliminate
@@ -271,7 +275,8 @@
%The old command.}
%with bad spacing.
% \end{verbatim}
-% \vspace{-4ex} This a note
+% \vspace{-4ex}
+% This is a note
% \footnt{
% The old command.}
% with bad spacing.
@@ -284,7 +289,8 @@
%The new command.}
%with good spacing.
% \end{verbatim}
-% \vspace{-4ex} This a note
+% \vspace{-4ex}
+% This is a note
% \footnote{
% The new command.}
% with good spacing.
@@ -294,7 +300,7 @@
% \DescribeMacro{\footnotespace} \DescribeMacro{\footenoteindent}
% Like the old one, the new "\footnote" command can take an optional argument
% to force the number of the note.
-% Likewise, we have always the customization macros
+% Likewise, we have always customization macros
% "\footnotesize", "\footnotesep", "\footnoterule",
% but two new macros have been added to manage spacing:
% "\footnotespace" produces the space before the note call symbol
@@ -324,20 +330,16 @@
% If the values of \meta{height} and \meta{depth} are inferior to the height and depth
% of the current line, the command has no effect.
% Here are some examples.
-%
-% \noindent
-% \begin{minipage}[t]{8cm}
+% \setlength{\juxtopskip}{0pt}\setlength{\juxbottomskip}{0pt}
+% \begin{juxtapose}
% \begin{verbatim}
%\[\frac{\sqrt{0.5p}}{10} =
%\frac{\sqrt{\vstrut{1.7ex} 0.5p}}{10}\]
% \end{verbatim}
-% \end{minipage}
-% \hfill
-% \begin{minipage}[t]{6cm}
+% \otherside
% \[\frac{\sqrt{0.5p}}{10} = \frac{\sqrt{\vstrut{1.7ex} 0.5p}}{10}\]
-% \end{minipage}
-% \\
-% "\fbox{\vstrut{2ex}$\sigma(X)=1$}" gives
+% \end{juxtapose}
+% \noindent"\fbox{\vstrut{2ex}$\sigma(X)=1$}" gives
% \fbox{\vstrut{2ex}$\sigma(X)=1$}
% better than \fbox{$\sigma(X)=1$}.
%
@@ -382,10 +384,10 @@
% \end{array}
%\]
% However, for tables, we have the \textsf{arraycols} package~\cite{ARCOL},
-% based on \textsf{cellspace}~\cite{CELLSP}, which allows to adjust
+% based on \textsf{cellspace}~\cite{CELLSP}, which allows to adjust
% row heights automatically. Nevertheless, "\vstrut" can be useful for fine adjustments.
%
-% In a text line, "\vstrut" can be used in place of "\vspace".
+% In a text line "\vstrut" can be used to increase line space, better than "\vspace".
%
% \hypertarget{indent}{}
% \medskip
@@ -443,7 +445,7 @@
% As for lists in \LaTeX, items are generated by the "\item" command.
% The environment has an optional argument: "\begin{compactlist}"\oarg{symbol}.
%
-% \hypertarget{aliases}{}
+% \hypertarget{symbols}{}
% \medskip
% \DescribeMacro{\bul}\DescribeMacro{\dash}\DescribeMacro{\ddash}\DescribeMacro{\aster}
% The default item symbol is "\textbullet", but can be changed.
@@ -468,10 +470,11 @@
% \item Second item.
% \item Third item.
% \end{compactlist}
-% \hand These aliases can also be used directly in text mode, of course.
-% For "\hand", "\checksymb" and "\arrowsymb", the symbol is followed by a space
-% if there is no punctuation character just after it (thanks to the
+% \hand These aliases can also be used directly in some text.
+% The symbol is followed by a space if there is no punctuation character
+% just after it (thanks to the
% macro \texttt{xspace} from the \textsf{xspace} package~\cite{XSP}).
+% Use "\"\meta{symbol}"\unskip" if you want to remove this space.
%
% \smallskip
% \DescribeMacro{\compactlistindent}
@@ -605,7 +608,8 @@
% nevertheless vertical positioning can be tricky
% and it doesn't belong to common distributions \TeX{}\,Live or MiK\TeX.
% A last one we mention is \textsf{picinpar}~\cite{PICINPAR} in which
-% text can begin after the first line and can flow to the two side of the figure.
+% text can begin after the first line and can flow to the two side of the figure;
+% it allows several paragraphs but neither lists, nor verbatim text.
%
% \hypertarget{juxtapose}{}
% \medskip
@@ -634,7 +638,8 @@
% without the need of \texttt{multipage} environments.
% The two boxes are aligned by their center, but
-% unlike "\dualboxes", you cannot adjust vertical positioning.
+% unlike "\dualboxes", you cannot adjust vertical positioning,
+% except using "\vspace".\smallskip
%
% \otherside
% \myfigure
@@ -655,14 +660,15 @@
% (from indent length) and otherwise the user may forgot to
% put "\noindent" before the figure.
% If you still want to indent the first paragraph use "\indent".
-% For horizontal alignment inside one side, you can use "\centering" or "\flushright"
+% For horizontal alignment inside a box, you can use "\centering" or "\flushright"
% (useful for a figure).
% If you want a global indentation of the first (or the second) box, you
% can put it in an \texttt{indentblock} environment, it works fine!
%
% \medskip
% One may ask why not using multi column environments instead.
-% In the classic \textsf{multicol} environment you cannot choose unbalanced
+% In the classic \textsf{multicol} environment you cannot choose
+% horizontally unbalanced
% columns and you cannot choose where to pass to the other column.
%
% Some nice packages improve \textsf{multicols}, \eg \textsf{vwcol}~\cite{VWCOL} in which
@@ -754,12 +760,12 @@
}
}{\end{list}}
-\providecommand{\bul}{\textbullet}
-\providecommand{\dash}{\textendash}
-\providecommand{\ddash}{\textemdash}
-\providecommand{\aster}{\textasteriskcentered}
+\providecommand{\bul}{\textbullet\xspace}
+\providecommand{\dash}{\textendash\xspace}
+\providecommand{\ddash}{\textemdash\xspace}
+\providecommand{\aster}{\textasteriskcentered\xspace}
% \end{macrocode}
-% The command "\asterisk" already exists in the \textsf{mathabx} package.\\
+% The command "\asterisk" already exists in the \textsf{mathabx} package (for math mode only).\\
% The following macros need the \textsf{pifont} package.
% \smallskip
% \begin{macrocode}
diff --git a/macros/latex/contrib/spacingtricks/spacingtricks.pdf b/macros/latex/contrib/spacingtricks/spacingtricks.pdf
index ba4d8631b8..4b11efd3b1 100644
--- a/macros/latex/contrib/spacingtricks/spacingtricks.pdf
+++ b/macros/latex/contrib/spacingtricks/spacingtricks.pdf
Binary files differ