mirror of
https://github.com/systemd/systemd.git
synced 2025-03-25 18:50:18 +03:00
doc: typographical improvements and choice of words
This commit is contained in:
parent
8d0e0ddda6
commit
45df8656eb
10
CODING_STYLE
10
CODING_STYLE
@ -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
4
NEWS
@ -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.
|
||||
|
||||
|
@ -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>
|
||||
|
||||
|
@ -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
|
||||
|
@ -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>
|
||||
|
Loading…
x
Reference in New Issue
Block a user