Terms and Definitions don't follow ISO directives
jwakely opened this issue · 1 comments
jwakely commented
Each definition should be substitutable for the term where it occurs.
jwakely commented
This is what I'm thinking (assuming the POSIX section numbers are correct) ...
\rSec0[defs]{Terms and definitions}
\pnum
\indextext{definitions|(}%
For the purposes of this document,
the terms and definitions
given in ISO/IEC 14882:2014,
the terms and definitions
given in ISO/IEC 2382-1:1993,
and the following apply.
\pnum
ISO and IEC maintain terminological databases
for use in standardization
at the following addresses:
\begin{itemize}
\item IEC Electropedia: available at \url{http://www.electropedia.org/}
\item ISO Online browsing platform: available at \url{http://www.iso.org/obp}
\end{itemize}
\pnum
Terms that are used only in a small portion of this document
are defined where they are used and italicized where they are
defined.
\indexdefn{host byte order}%
\definition{host byte order}{defs.host.byte.order}
natural object representation of scalar types in the execution environment
Note 1 to entry: See section 3.194 of POSIX Base Definitions, Host Byte Order.
\indexdefn{network byte order}%
\definition{network byte order}{defs.net.byte.order}
object representation with the most significant byte first,
followed by any other octets in descending order of significance
Note 1 to entry: See section 3.238 of POSIX Base Definitions, Network Byte Order.
\indexdefn{synchronous operation}%
\definition{synchronous operation}{defs.sync.op}
operation where control is not returned until the operation completes
\indexdefn{asynchronous operation}%
\definition{asynchronous operation}{defs.async.op}
operation where control is returned immediately without waiting for the operation to complete
Note 1 to entry: Multiple asynchronous operations may be executed concurrently.