summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/siunitx/siunitx.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/siunitx/siunitx.tex')
-rw-r--r--macros/latex/contrib/siunitx/siunitx.tex23
1 files changed, 19 insertions, 4 deletions
diff --git a/macros/latex/contrib/siunitx/siunitx.tex b/macros/latex/contrib/siunitx/siunitx.tex
index 28eaa37b2c..2be2483297 100644
--- a/macros/latex/contrib/siunitx/siunitx.tex
+++ b/macros/latex/contrib/siunitx/siunitx.tex
@@ -1748,7 +1748,9 @@ if no sign was present in the input.
\DescribeOption{print-zero-exponent}
Printing of a mantissa of $1$ and an exponent of $0$ is controllable by the
options \opt{print-unity-mantissa} and \opt{print-zero-exponent}. The standard
-settings print a mantissa of $1$ but omit an exponent of $0$.
+settings print a mantissa of $1$ but omit an exponent of $0$. Notice that where
+both are set to \opt{false}, the value $1$ will still be printed
+(\foreign{i.e.}~\opt{print-zero-exponent} has a higher priority).
\begin{LaTeXdemo}
\num{1e4} \\
\num[print-unity-mantissa = false]{1e4} \\
@@ -1993,7 +1995,7 @@ the \LaTeX3 floating-point unit, so is limited to $16$ decimal places.
\DescribeOption{number-angle-product}
The separator between the number and angle symbol (degrees, minutes or seconds)
can be set using the \opt{number-angle-product} option, independent of the
-related \opt{number-unit-product} option used by the \cs{qty} command.
+related \opt{quantity-product} option used by the \cs{qty} command.
\begin{LaTeXdemo}
\ang{2.67} \\
\ang[number-angle-product = \,]{2.67}
@@ -2102,6 +2104,14 @@ outside of the \cs{unit} and \cs{qty} arguments. When this option is
method to achieve this does not overwrite any existing macros: this behaviour
can be altered using the \opt{overwrite-commands} switch.
+When using the approach of \enquote{free-standing} unit commands, only macros
+created using \cs{DeclareSIUnit} are defined generally. Thus prefixes and
+powers should be combined with the desired unit into a single free-standing
+command, for example
+\begin{LaTeXdemo}[code only]
+ \DeclareSIUnit\kilometre{\kilo\metre}
+\end{LaTeXdemo}
+
\DescribeOption{space-before-unit}
\DescribeOption{unit-optional-argument}
\DescribeOption{use-xspace}
@@ -2324,7 +2334,7 @@ needed. This can be turned on using the \opt{allow-quantity-breaks} option.
\end{minipage}
\end{LaTeXdemo}
-\DescribeOption{number-unit-product}
+\DescribeOption{quantity-product}
The product symbol between the number and unit is set using the
\opt{quantity-product} option.
\begin{LaTeXdemo}
@@ -2742,7 +2752,8 @@ content. However, there are cases where a strictly fixed width is desirable.
For these cases, the \opt{table-fixed-width} and \opt{table-column-width}
options are available. The \opt{table-fixed-width} option activates fixed-width
columns, whilst \opt{table-column-width} defines the target width
-(Table~\ref{tab:width:fixed}).
+(Table~\ref{tab:width:fixed}). Setting \opt{table-column-width} to a positive
+value automatically enables \opt{table-fixed-width}.
\begin{LaTeXdemo}[code and float]
\begin{table}
\caption{Fixed-width columns.%
@@ -3026,6 +3037,10 @@ When the \pkg{physics} package is loaded before \pkg{siunitx}, the command
\cs{qty} is not defined: users will need to use the version~$2$ command
\cs{SI}.
+When the \pkg{units} package is loaded before \pkg{siunitx}, the command
+\cs{unit} is not defined: users will need to use the version~$2$ command
+\cs{si}.
+
\section{Hints for using \pkg{siunitx}}
\subsection{Adjusting \cs{litre} and \cs{liter}%