doc: typographical improvements and choice of words

This commit is contained in:
Jan Engelhardt 2014-06-28 00:49:12 +02:00 committed by Zbigniew Jędrzejewski-Szmek
parent 8d0e0ddda6
commit 45df8656eb
5 changed files with 12 additions and 12 deletions

View File

@ -41,11 +41,11 @@
- Don't synchronously talk to any other service from PID 1, due to
risk of deadlocks
- Avoid fixed sized string buffers, unless you really know the maximum
- Avoid fixed-size string buffers, unless you really know the maximum
size and that maximum size is small. They are a source of errors,
since they possibly result in truncated strings. Often it is nicer
to use dynamic memory, alloca() or VLAs. If you do allocate fixed
size strings on the stack, then it's probably only OK if you either
since they possibly result in truncated strings. It is often nicer
to use dynamic memory, alloca() or VLAs. If you do allocate fixed-size
strings on the stack, then it's probably only OK if you either
use a maximum size such as LINE_MAX, or count in detail the maximum
size a string can have. (DECIMAL_STR_MAX and DECIMAL_STR_WIDTH
macros are your friends for this!)
@ -99,7 +99,7 @@
- Unless you allocate an array, "double" is always the better choice
than "float". Processors speak "double" natively anyway, so this is
no speed benefit, and on calls like printf() "float"s get upgraded
no speed benefit, and on calls like printf() "float"s get promoted
to "double"s anyway, so there is no point.
- Don't invoke functions when you allocate variables on the stack. Wrong:

4
NEWS
View File

@ -20,7 +20,7 @@ CHANGES WITH 214:
synthesize "change" events for the disk and all its partitions.
This is now unconditionally enabled, and if it turns out to
cause major problems, we might turn it on only for specific
devices, or might need to disable it entirely. Device-mapper
devices, or might need to disable it entirely. Device Mapper
devices are excluded from this logic.
* We temporarily dropped the "-l" switch for fsck invocations,
@ -83,7 +83,7 @@ CHANGES WITH 214:
* Socket units gained a new Symlinks= setting. It takes a list
of symlinks to create to file system sockets or FIFOs
created by the specific unix sockets. This is useful to
created by the specific Unix sockets. This is useful to
manage symlinks to socket nodes with the same life-cycle as
the socket itself.

View File

@ -154,7 +154,7 @@
</example>
<example>
<title>Disable packet filter on the bridge (method one)</title>
<title>Disable packet filter on bridged packets (method one)</title>
<para><filename>/etc/udev/rules.d/99-bridge.conf</filename>:
</para>
@ -171,7 +171,7 @@ net.bridge.bridge-nf-call-arptables = 0
</example>
<example>
<title>Disable packet filter on the bridge (method two)</title>
<title>Disable packet filter on bridged packets (method two)</title>
<para><filename>/etc/modules-load.d/bridge.conf</filename>:
</para>

View File

@ -237,14 +237,14 @@
interfaces and all
known network
configuration files to
avoid IP range
avoid address range
conflicts. The default
system-wide pool
consists of
192.168.0.0/16,
172.16.0.0/12 and
10.0.0.0/8 for IPv4,
and [fc00::] for
and fc00::/7 for
IPv6. This
functionality is
useful to manage a

View File

@ -433,7 +433,7 @@ r! /tmp/.X[0-9]*-lock</programlisting>
be removed from the new access mode too, and
if all write bits are removed, they will be
removed from the new access mode too. In
addition, the sticky/suid/gid bit is removed unless
addition, the sticky/SUID/SGID bit is removed unless
applied to a directory. This
functionality is particularly useful in
conjunction with <varname>Z</varname>.</para>