From 34d7b9f5f879ba6facf4282babb8232384c61070 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 6 Mar 2023 21:41:09 +0000 Subject: spacingtricks (6mar23) (branch) git-svn-id: svn://tug.org/texlive/branches/branch2022.final@66398 c570f23f-e606-0410-a88d-b1316a301751 --- .../source/latex/spacingtricks/spacingtricks.dtx | 74 ++++++++++++---------- 1 file changed, 40 insertions(+), 34 deletions(-) (limited to 'Master/texmf-dist/source') diff --git a/Master/texmf-dist/source/latex/spacingtricks/spacingtricks.dtx b/Master/texmf-dist/source/latex/spacingtricks/spacingtricks.dtx index 68a4afbdd91..cea5d0322e8 100644 --- a/Master/texmf-dist/source/latex/spacingtricks/spacingtricks.dtx +++ b/Master/texmf-dist/source/latex/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] % %<*driver> \documentclass{ltxdoc} @@ -58,7 +58,7 @@ % % \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} -- cgit v1.2.3