cplusplus/networking-ts

Terms and Definitions don't follow ISO directives

jwakely opened this issue · 1 comments

Each definition should be substitutable for the term where it occurs.

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.