summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libstruct.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2001-07-06 20:30:11 (GMT)
committerFred Drake <fdrake@acm.org>2001-07-06 20:30:11 (GMT)
commit907e76b62081cc3e3d4dbab94f3e5799086021a0 (patch)
treede205bb308f02d8fbefb427aab172786aae98aae /Doc/lib/libstruct.tex
parent19b1c6156bcb9d8c79808c718be2dac2f55c6d00 (diff)
downloadcpython-907e76b62081cc3e3d4dbab94f3e5799086021a0.zip
cpython-907e76b62081cc3e3d4dbab94f3e5799086021a0.tar.gz
cpython-907e76b62081cc3e3d4dbab94f3e5799086021a0.tar.bz2
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
translation more difficult, as well as reading the English more difficult for non-native speakers.
Diffstat (limited to 'Doc/lib/libstruct.tex')
-rw-r--r--Doc/lib/libstruct.tex24
1 files changed, 12 insertions, 12 deletions
diff --git a/Doc/lib/libstruct.tex b/Doc/lib/libstruct.tex
index 9666633..6de67cc 100644
--- a/Doc/lib/libstruct.tex
+++ b/Doc/lib/libstruct.tex
@@ -33,8 +33,8 @@ The module defines the following exception and functions:
Unpack the string (presumably packed by \code{pack(\var{fmt},
\textrm{\ldots})}) according to the given format. The result is a
tuple even if it contains exactly one item. The string must contain
- exactly the amount of data required by the format (i.e.
- \code{len(\var{string})} must equal \code{calcsize(\var{fmt})}).
+ exactly the amount of data required by the format
+ (\code{len(\var{string})} must equal \code{calcsize(\var{fmt})}).
\end{funcdesc}
\begin{funcdesc}{calcsize}{fmt}
@@ -78,8 +78,8 @@ Notes:
\end{description}
-A format character may be preceded by an integral repeat count;
-e.g.\ the format string \code{'4h'} means exactly the same as
+A format character may be preceded by an integral repeat count. For
+example, the format string \code{'4h'} means exactly the same as
\code{'hhhh'}.
Whitespace characters between formats are ignored; a count and its
@@ -87,7 +87,7 @@ format must not contain whitespace though.
For the \character{s} format character, the count is interpreted as the
size of the string, not a repeat count like for the other format
-characters; e.g. \code{'10s'} means a single 10-byte string, while
+characters; for example, \code{'10s'} means a single 10-byte string, while
\code{'10c'} means 10 characters. For packing, the string is
truncated or padded with null bytes as appropriate to make it fit.
For unpacking, the resulting string always has exactly the specified
@@ -133,8 +133,8 @@ according to the following table:
If the first character is not one of these, \character{@} is assumed.
Native byte order is big-endian or little-endian, depending on the
-host system (e.g. Motorola and Sun are big-endian; Intel and DEC are
-little-endian).
+host system. For example, Motorola and Sun processors are big-endian;
+Intel and DEC processors are little-endian.
Native size and alignment are determined using the C compiler's
\keyword{sizeof} expression. This is always combined with native byte
@@ -156,7 +156,7 @@ The form \character{!} is available for those poor souls who claim they
can't remember whether network byte order is big-endian or
little-endian.
-There is no way to indicate non-native byte order (i.e. force
+There is no way to indicate non-native byte order (force
byte-swapping); use the appropriate choice of \character{<} or
\character{>}.
@@ -182,10 +182,10 @@ big-endian machine):
Hint: to align the end of a structure to the alignment requirement of
a particular type, end the format with the code for that type with a
-repeat count of zero, e.g.\ the format \code{'llh0l'} specifies two
-pad bytes at the end, assuming longs are aligned on 4-byte boundaries.
-This only works when native size and alignment are in effect;
-standard size and alignment does not enforce any alignment.
+repeat count of zero. For example, the format \code{'llh0l'}
+specifies two pad bytes at the end, assuming longs are aligned on
+4-byte boundaries. This only works when native size and alignment are
+in effect; standard size and alignment does not enforce any alignment.
\begin{seealso}
\seemodule{array}{Packed binary storage of homogeneous data.}