doc: use non-contracted forms in written documents

This commit is contained in:
Jan Engelhardt 2014-05-03 19:15:23 +02:00 committed by Tom Gundersen
parent 22fc2420b2
commit d28315e4af
5 changed files with 42 additions and 42 deletions

42
NEWS
View File

@ -127,8 +127,8 @@ CHANGES WITH 212:
timers configured this way will save to disk when they have timers configured this way will save to disk when they have
been last triggered. This information is then used on next been last triggered. This information is then used on next
reboot to possible execute overdue timer events, that reboot to possible execute overdue timer events, that
couldn't take place because the system was powered off. This could not take place because the system was powered off.
enables simple anacron-like behaviour for timer units. This enables simple anacron-like behaviour for timer units.
* systemctl's "list-timers" will now also list the time a * systemctl's "list-timers" will now also list the time a
timer unit was last triggered in addition to the next time timer unit was last triggered in addition to the next time
@ -359,10 +359,10 @@ CHANGES WITH 210:
anymore. Instead we now build libsystemd.so multiple times anymore. Instead we now build libsystemd.so multiple times
under these alternative names. This means that the footprint under these alternative names. This means that the footprint
is drastically increased, but given that these are is drastically increased, but given that these are
transitional compatibility libraries this shouldn't matter transitional compatibility libraries this should not matter
much. This change has been made necessary to support the ARM much. This change has been made necessary to support the ARM
platform for these compatibility libraries, as the ARM platform for these compatibility libraries, as the ARM
toolchain isn't really at the same level as the toolchain toolchain is not really at the same level as the toolchain
for other architectures like x86 and does not support for other architectures like x86 and does not support
IFUNC. Please make sure to use --enable-compat-libs only IFUNC. Please make sure to use --enable-compat-libs only
during a transitional period! during a transitional period!
@ -617,7 +617,7 @@ CHANGES WITH 209:
merged them into a single library, libsystemd.so, which merged them into a single library, libsystemd.so, which
provides all symbols. The reason for this is cyclic provides all symbols. The reason for this is cyclic
dependencies, as these libraries tend to use each other's dependencies, as these libraries tend to use each other's
symbols. So far, we've managed to workaround that by linking symbols. So far, we have managed to workaround that by linking
a copy of a good part of our code into each of these a copy of a good part of our code into each of these
libraries again and again, which, however, makes certain libraries again and again, which, however, makes certain
things hard to do, like sharing static variables. Also, it things hard to do, like sharing static variables. Also, it
@ -861,13 +861,13 @@ CHANGES WITH 208:
* A new tmpfiles.d(5) command "m" has been introduced which * A new tmpfiles.d(5) command "m" has been introduced which
may be used to change the owner/group/access mode of a file may be used to change the owner/group/access mode of a file
or directory if it exists, but do nothing if it doesn't. or directory if it exists, but do nothing if it does not.
* This release removes high-level support for the * This release removes high-level support for the
MemorySoftLimit= cgroup setting. The underlying kernel MemorySoftLimit= cgroup setting. The underlying kernel
cgroup attribute memory.soft_limit= is currently badly cgroup attribute memory.soft_limit= is currently badly
designed and likely to be removed from the kernel API in its designed and likely to be removed from the kernel API in its
current form, hence we shouldn't expose it for now. current form, hence we should not expose it for now.
* The memory.use_hierarchy cgroup attribute is now enabled for * The memory.use_hierarchy cgroup attribute is now enabled for
all cgroups systemd creates in the memory cgroup all cgroups systemd creates in the memory cgroup
@ -950,7 +950,7 @@ CHANGES WITH 207:
* InaccessibleDirectories= and ReadOnlyDirectories= now take * InaccessibleDirectories= and ReadOnlyDirectories= now take
paths that are optionally prefixed with "-" to indicate that paths that are optionally prefixed with "-" to indicate that
it should not be considered a failure if they don't exist. it should not be considered a failure if they do not exist.
* journalctl -o (and similar commands) now understands a new * journalctl -o (and similar commands) now understands a new
output mode "short-precise", it is similar to "short" but output mode "short-precise", it is similar to "short" but
@ -1056,7 +1056,7 @@ CHANGES WITH 206:
databases to pre-generate dead device nodes based on meta databases to pre-generate dead device nodes based on meta
information contained in kernel modules, so that these would information contained in kernel modules, so that these would
be auto-loaded on access rather then at boot. As this be auto-loaded on access rather then at boot. As this
doesn't really have much to do with the exposing actual does not really have much to do with the exposing actual
kernel devices to userspace this has always been slightly kernel devices to userspace this has always been slightly
alien in the udev codebase. Following the new scheme kmod alien in the udev codebase. Following the new scheme kmod
will now generate a runtime snippet for tmpfiles from the will now generate a runtime snippet for tmpfiles from the
@ -1476,7 +1476,7 @@ CHANGES WITH 201:
* 'systemd-analyze dot' gained the ability to filter for * 'systemd-analyze dot' gained the ability to filter for
specific units via shell-style globs, to create smaller, specific units via shell-style globs, to create smaller,
more useful graphs. I.e. it's now possible to create simple more useful graphs. I.e. it is now possible to create simple
graphs of all the dependencies between only target units, or graphs of all the dependencies between only target units, or
of all units that Avahi has dependencies with. of all units that Avahi has dependencies with.
@ -1854,8 +1854,8 @@ CHANGES WITH 197:
http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames
* Auke Kok's bootchart implementation has been added to the * Auke Kok's bootchart implementation has been added to the
systemd tree. It's an optional component that can graph the systemd tree. It is an optional component that can graph the
boot in quite some detail. It's one of the best bootchart boot in quite some detail. It is one of the best bootchart
implementations around and minimal in its code and implementations around and minimal in its code and
dependencies. dependencies.
@ -2056,7 +2056,7 @@ CHANGES WITH 196:
PolicyKit-less systems. Quite frankly this should have been PolicyKit-less systems. Quite frankly this should have been
this way since day one. It is absolutely our intention to this way since day one. It is absolutely our intention to
make systemd work fine on PolicyKit-less systems, and we make systemd work fine on PolicyKit-less systems, and we
consider it a bug if something doesn't work as it should if consider it a bug if something does not work as it should if
PolicyKit is not around. PolicyKit is not around.
* For embedded systems it is now possible to build udev and * For embedded systems it is now possible to build udev and
@ -2228,7 +2228,7 @@ CHANGES WITH 192:
* The bash completion logic is now available for journalctl * The bash completion logic is now available for journalctl
too. too.
* We don't mount the "cpuset" controller anymore together with * We do not mount the "cpuset" controller anymore together with
"cpu" and "cpuacct", as "cpuset" groups generally cannot be "cpu" and "cpuacct", as "cpuset" groups generally cannot be
started if no parameters are assigned to it. "cpuset" hence started if no parameters are assigned to it. "cpuset" hence
broke code that assumed it it could create "cpu" groups and broke code that assumed it it could create "cpu" groups and
@ -2277,7 +2277,7 @@ CHANGES WITH 191:
CHANGES WITH 190: CHANGES WITH 190:
* Whenever a unit changes state we'll now log this to the * Whenever a unit changes state we will now log this to the
journal and show along the unit's own log output in journal and show along the unit's own log output in
"systemctl status". "systemctl status".
@ -2347,7 +2347,7 @@ CHANGES WITH 190:
* There's now a new RPM macro definition for the system preset * There's now a new RPM macro definition for the system preset
dir: %_presetdir. dir: %_presetdir.
* journald will now warn if it can't forward a message to the * journald will now warn if it ca not forward a message to the
syslog daemon because it's socket is full. syslog daemon because it's socket is full.
* timedated will no longer write or process /etc/timezone, * timedated will no longer write or process /etc/timezone,
@ -2876,7 +2876,7 @@ CHANGES WITH 183:
* systemctl will now warn you if .mount units generated from * systemctl will now warn you if .mount units generated from
/etc/fstab are out of date due to changes in fstab that /etc/fstab are out of date due to changes in fstab that
haven't been read by systemd yet. have not been read by systemd yet.
* systemd is now suitable for usage in initrds. Dracut has * systemd is now suitable for usage in initrds. Dracut has
already been updated to make use of this. With this in place already been updated to make use of this. With this in place
@ -2939,7 +2939,7 @@ CHANGES WITH 183:
* We now mount /tmp as tmpfs by default, but this can be * We now mount /tmp as tmpfs by default, but this can be
masked and /etc/fstab can override it. masked and /etc/fstab can override it.
* Since udisks doesn't make use of /media anymore we are not * Since udisks does not make use of /media anymore we are not
mounting a tmpfs on it anymore. mounting a tmpfs on it anymore.
* journalctl gained a new --local switch to only interleave * journalctl gained a new --local switch to only interleave
@ -2980,7 +2980,7 @@ CHANGES WITH 44:
folks folks
* We now refuse non-UTF8 strings used in various configuration * We now refuse non-UTF8 strings used in various configuration
and unit files. This is done to ensure we don't pass invalid and unit files. This is done to ensure we do not pass invalid
data over D-Bus or expose it elsewhere. data over D-Bus or expose it elsewhere.
* Register Mimo USB Screens as suitable for automatic seat * Register Mimo USB Screens as suitable for automatic seat
@ -3141,7 +3141,7 @@ CHANGES WITH 39:
death, since fanotify() will not see accesses done by blkid, death, since fanotify() will not see accesses done by blkid,
or fsck. or fsck.
* Don't show kernel threads in systemd-cgls anymore, unless * Do not show kernel threads in systemd-cgls anymore, unless
requested with new -k switch. requested with new -k switch.
Contributions from: Dan Horák, Kay Sievers, Lennart Contributions from: Dan Horák, Kay Sievers, Lennart
@ -3213,7 +3213,7 @@ CHANGES WITH 38:
--with-rootprefix= to follow the naming used by udev and --with-rootprefix= to follow the naming used by udev and
kmod kmod
* Unless specified otherwise we'll now install to /usr instead * Unless specified otherwise we will now install to /usr instead
of /usr/local by default. of /usr/local by default.
* Processes with '@' in argv[0][0] are now excluded from the * Processes with '@' in argv[0][0] are now excluded from the

2
README
View File

@ -43,7 +43,7 @@ REQUIREMENTS:
Kernel Config Options: Kernel Config Options:
CONFIG_DEVTMPFS CONFIG_DEVTMPFS
CONFIG_CGROUPS (it's OK to disable all controllers) CONFIG_CGROUPS (it is OK to disable all controllers)
CONFIG_INOTIFY_USER CONFIG_INOTIFY_USER
CONFIG_SIGNALFD CONFIG_SIGNALFD
CONFIG_TIMERFD CONFIG_TIMERFD

36
TODO
View File

@ -50,7 +50,7 @@ Features:
* mount_cgroup_controllers(): symlinks need to get the label applied * mount_cgroup_controllers(): symlinks need to get the label applied
* For timer units: add some mechanisms so that timer units that trigger immediately on boot don't have the services they run added to the initial transaction and thus confuse Type=idle. Alternatively, split up the boot-up state into two, and make Type=idle only be affected by jobs for the default target, but ignore any further jobs * For timer units: add some mechanisms so that timer units that trigger immediately on boot do not have the services they run added to the initial transaction and thus confuse Type=idle. Alternatively, split up the boot-up state into two, and make Type=idle only be affected by jobs for the default target, but ignore any further jobs
* Add RPM macros for registering/unregistering binfmt drop-ins * Add RPM macros for registering/unregistering binfmt drop-ins
@ -85,7 +85,7 @@ Features:
* improve journalctl performance by loading journal files * improve journalctl performance by loading journal files
lazily. Encode just enough information in the file name, so that we lazily. Encode just enough information in the file name, so that we
don't have to open it to know that it is not interesting for us, for do not have to open it to know that it is not interesting for us, for
the most common operations. the most common operations.
* support transient mount units * support transient mount units
@ -177,7 +177,7 @@ Features:
* btrfs raid assembly: some .device jobs stay stuck in the queue * btrfs raid assembly: some .device jobs stay stuck in the queue
* make sure gdm doesn't use multi-user-x but the new default X configuration file, and then remove multi-user-x from systemd * make sure gdm does not use multi-user-x but the new default X configuration file, and then remove multi-user-x from systemd
* man: the documentation of Restart= currently is very misleading and suggests the tools from ExecStartPre= might get restarted. * man: the documentation of Restart= currently is very misleading and suggests the tools from ExecStartPre= might get restarted.
@ -194,7 +194,7 @@ Features:
* sd-bus: * sd-bus:
- make AddMatch calls on dbus1 transports async - make AddMatch calls on dbus1 transports async
- when kdbus doesn't take our message without memfds, try again with memfds - when kdbus does not take our message without memfds, try again with memfds
- systemd-bus-proxyd needs to enforce good old XML policy - systemd-bus-proxyd needs to enforce good old XML policy
- port exit-on-idle logic to byebye ioctl - port exit-on-idle logic to byebye ioctl
- allow updating attach flags during runtime - allow updating attach flags during runtime
@ -251,7 +251,7 @@ Features:
file. file.
* seems that when we follow symlinks to units we prefer the symlink * seems that when we follow symlinks to units we prefer the symlink
destination path over /etc and /usr. We shouldn't do that. Instead destination path over /etc and /usr. We should not do that. Instead
/etc should always override /run+/usr and also any symlink /etc should always override /run+/usr and also any symlink
destination. destination.
@ -277,7 +277,7 @@ Features:
* journal-or-kmsg is currently broken? See reverted commit 4a01181e460686d8b4a543b1dfa7f77c9e3c5ab8. * journal-or-kmsg is currently broken? See reverted commit 4a01181e460686d8b4a543b1dfa7f77c9e3c5ab8.
* remove any syslog support from log.c -- we probably can't do this before split-off udev is gone for good * remove any syslog support from log.c -- we probably cannot do this before split-off udev is gone for good
* shutdown logging: store to EFI var, and store to USB stick? * shutdown logging: store to EFI var, and store to USB stick?
@ -333,7 +333,7 @@ Features:
- journald: also get thread ID from client, plus thread name - journald: also get thread ID from client, plus thread name
- journal: when waiting for journal additions in the client always sleep at least 1s or so, in order to minimize wakeups - journal: when waiting for journal additions in the client always sleep at least 1s or so, in order to minimize wakeups
- add API to close/reopen/get fd for journal client fd in libsystemd-journal. - add API to close/reopen/get fd for journal client fd in libsystemd-journal.
- fallback to /dev/log based logging in libsystemd-journal, if we can't log natively? - fallback to /dev/log based logging in libsystemd-journal, if we cannot log natively?
- declare the local journal protocol stable in the wiki interface chart - declare the local journal protocol stable in the wiki interface chart
- journal: reuse XZ context - journal: reuse XZ context
- sd-journal: speed up sd_journal_get_data() with transparent hash table in bg - sd-journal: speed up sd_journal_get_data() with transparent hash table in bg
@ -369,7 +369,7 @@ Features:
- journald: make sure ratelimit is actually really per-service with the new cgroup changes - journald: make sure ratelimit is actually really per-service with the new cgroup changes
- change systemd-journal-flush into a service that stays around during - change systemd-journal-flush into a service that stays around during
boot, and causes the journal to be moved back to /run on shutdown, boot, and causes the journal to be moved back to /run on shutdown,
so that we don't keep /var busy. This needs to happen synchronously, so that we do not keep /var busy. This needs to happen synchronously,
hence doing this via signals is not going to work. hence doing this via signals is not going to work.
* document: * document:
@ -397,7 +397,7 @@ Features:
- print nice message from systemctl --failed if there are no entries shown, and hook that into ExecStartPre of rescue.service/emergency.service - print nice message from systemctl --failed if there are no entries shown, and hook that into ExecStartPre of rescue.service/emergency.service
- add new command to systemctl: "systemctl system-reexec" which reexecs as many daemons as virtually possible - add new command to systemctl: "systemctl system-reexec" which reexecs as many daemons as virtually possible
- systemctl enable: improve the success messages (i.e. more human readable, less shell-like) - systemctl enable: improve the success messages (i.e. more human readable, less shell-like)
- systemctl enable: fail if target to alias into doesn't exist? maybe show how many units are enabled afterwards? - systemctl enable: fail if target to alias into does not exist? maybe show how many units are enabled afterwards?
- systemctl: "Journal has been rotated since unit was started." message is misleading - systemctl: "Journal has been rotated since unit was started." message is misleading
- support "systemctl stop foobar@.service" to stop all units matching a certain template - support "systemctl stop foobar@.service" to stop all units matching a certain template
- Something is wrong with symlink handling of "autovt@.service" in "systemctl list-unit-files" - Something is wrong with symlink handling of "autovt@.service" in "systemctl list-unit-files"
@ -424,7 +424,7 @@ Features:
o DST changes o DST changes
- Support 2012-02~4 as syntax for specifying the fourth to last day of the month. - Support 2012-02~4 as syntax for specifying the fourth to last day of the month.
- calendarspec: support value ranges with ".." notation. Example: 2013-4..8-1 - calendarspec: support value ranges with ".." notation. Example: 2013-4..8-1
- when parsing calendar timestamps support the UTC timezone (even if we won't support arbitrary timezone specs, support UTC itself certainly makes sense), also support syntaxes such as +0200 - when parsing calendar timestamps support the UTC timezone (even if we will not support arbitrary timezone specs, support UTC itself certainly makes sense), also support syntaxes such as +0200
- Modulate timer frequency based on battery state - Modulate timer frequency based on battery state
* update the kernel's TZ (sys_tz) when DST changes * update the kernel's TZ (sys_tz) when DST changes
@ -448,7 +448,7 @@ Features:
* If we show an error about a unit (such as not showing up) and it has no Description string, then show a description string generated form the reverse of unit_name_mangle(). * If we show an error about a unit (such as not showing up) and it has no Description string, then show a description string generated form the reverse of unit_name_mangle().
* fedup: add --unit to systemctl switch-root somehow * fedup: add --unit to systemctl switch-root somehow
* fedup: don't delete initrd on switch-root * fedup: do not delete initrd on switch-root
* fedup: generator * fedup: generator
* timedated: refuse time changes when NTP is on * timedated: refuse time changes when NTP is on
@ -469,7 +469,7 @@ Features:
* hostnamed: before returning information from /etc/machine-info.conf check the modification data and reread. Similar for localed, ... * hostnamed: before returning information from /etc/machine-info.conf check the modification data and reread. Similar for localed, ...
* currently x-systemd.timeout is lost in the initrd, since crypttab is copied into dracut, but fstab isn't * currently x-systemd.timeout is lost in the initrd, since crypttab is copied into dracut, but fstab is not
* nspawn: * nspawn:
- nspawn: --read-only is not applied recursively to submounts - nspawn: --read-only is not applied recursively to submounts
@ -515,9 +515,9 @@ Features:
* drop PID 1 reloading, only do reexecing (difficult: Reload() * drop PID 1 reloading, only do reexecing (difficult: Reload()
currently is properly synchronous, Reexec() is weird, because we currently is properly synchronous, Reexec() is weird, because we
can't delay the response properly until we are back, so instead of cannot delay the response properly until we are back, so instead of
being properly synchronous we just keep open the fd and close it being properly synchronous we just keep open the fd and close it
when done. That means clients don't get a successful method reply, when done. That means clients do not get a successful method reply,
but much rather a disconnect on success. but much rather a disconnect on success.
* properly handle loop back mounts via fstab, especially regards to fsck/passno * properly handle loop back mounts via fstab, especially regards to fsck/passno
@ -531,7 +531,7 @@ Features:
* rename "userspace" to "core-os" * rename "userspace" to "core-os"
* load-fragment: when loading a unit file via a chain of symlinks * load-fragment: when loading a unit file via a chain of symlinks
verify that it isn't masked via any of the names traversed. verify that it is not masked via any of the names traversed.
* introduce Type=pid-file * introduce Type=pid-file
@ -586,7 +586,7 @@ Features:
- check systemd-tmpfiles for selinux context hookup for mknod(), symlink() and similar - check systemd-tmpfiles for selinux context hookup for mknod(), symlink() and similar
- apply "x" on "D" too (see patch from William Douglas) - apply "x" on "D" too (see patch from William Douglas)
* for services: don't set $HOME in services unless requested * for services: do not set $HOME in services unless requested
* hide PAM options in fragment parser when compile time disabled * hide PAM options in fragment parser when compile time disabled
@ -727,7 +727,7 @@ External:
* drop accountsservice's StandardOutput=syslog and Type=dbus fields * drop accountsservice's StandardOutput=syslog and Type=dbus fields
* dbus upstream still refers to dbus.target and shouldn't * dbus upstream still refers to dbus.target and should not
* dbus: in fedora, make /var/lib/dbus/machine-id a symlink to /etc/machine-id * dbus: in fedora, make /var/lib/dbus/machine-id a symlink to /etc/machine-id
@ -755,7 +755,7 @@ Regularly:
* pahole * pahole
* set_put(), hashmap_put() return values check. i.e. == 0 doesn't free()! * set_put(), hashmap_put() return values check. i.e. == 0 does not free()!
* use secure_getenv() instead of getenv() where appropriate * use secure_getenv() instead of getenv() where appropriate

View File

@ -118,7 +118,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
returns positive or 0, and a valid bus path in the return returns positive or 0, and a valid bus path in the return
argument. On success, <function>sd_bus_path_decode()</function> argument. On success, <function>sd_bus_path_decode()</function>
returns a positive value if the prefixed matched, or 0 if it returns a positive value if the prefixed matched, or 0 if it
didn't. If the prefix matched the external identifier is returned did not. If the prefix matched the external identifier is returned
in the return parameter. If it did not match NULL is returned in in the return parameter. If it did not match NULL is returned in
the return parameter. On failure, a negative errno-style error the return parameter. On failure, a negative errno-style error
number is returned by either function. The returned strings must number is returned by either function. The returned strings must

View File

@ -194,7 +194,7 @@
<para>A boolean. When true, enables IPv4 link-local support. <para>A boolean. When true, enables IPv4 link-local support.
If <literal>DHCP=</literal> is also true, acquiring DHCP address If <literal>DHCP=</literal> is also true, acquiring DHCP address
will deprecate previously acquired IPv4 link-local address or will deprecate previously acquired IPv4 link-local address or
stop acquiring process if there hasn't been one acquired before. stop acquiring process if one has not been acquired before.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>