From e9dd9f9547350c7dc0473583b5c2228dc8f0ab76 Mon Sep 17 00:00:00 2001 From: "Jason St. John" Date: Thu, 27 Jun 2013 21:51:44 +0200 Subject: man: improve grammar and word formatting in numerous man pages Use proper grammar, word usage, adjective hyphenation, commas, capitalization, spelling, etc. To improve readability, some run-on sentences or sentence fragments were revised. [zj: remove the space from 'file name', 'host name', and 'time zone'.] --- man/sd_is_fifo.xml | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) (limited to 'man/sd_is_fifo.xml') diff --git a/man/sd_is_fifo.xml b/man/sd_is_fifo.xml index 44b41abf86..c136b37d8f 100644 --- a/man/sd_is_fifo.xml +++ b/man/sd_is_fifo.xml @@ -109,14 +109,14 @@ called to check whether the specified file descriptor refers to a socket. If the family parameter is not - AF_UNSPEC it is checked whether + AF_UNSPEC, it is checked whether the socket is of the specified family (AF_UNIX, AF_INET, ...). If the - type parameter is not 0 it is + type parameter is not 0, it is checked whether the socket is of the specified type (SOCK_STREAM, SOCK_DGRAM, ...). If the - listening parameter is positive + listening parameter is positive, it is checked whether the socket is in accepting mode, i.e. listen() has been called for it. If listening is 0, it is @@ -135,14 +135,14 @@ AF_INET6. sd_is_socket_unix() is - similar to sd_is_socket(), but + similar to sd_is_socket() but optionally checks the AF_UNIX path the socket is bound to, unless the path parameter - is NULL. For normal file system AF_UNIX sockets set - the length parameter to 0. For - Linux abstract namespace sockets set the + is NULL. For normal file system AF_UNIX sockets, + set the length parameter to 0. For + Linux abstract namespace sockets, set the length to the size of the - address, including the initial 0 byte and set + address, including the initial 0 byte, and set the path to the initial 0 byte of the socket address. @@ -170,7 +170,7 @@ These functions are provided by the reference implementation of APIs for new-style daemons and distributed with the systemd package. The algorithms - they implement are simple, and can easily be + they implement are simple, and they can easily be reimplemented in daemons if it is important to support this interface without using the reference implementation. @@ -180,7 +180,7 @@ getsockname() to check the file descriptor type and where it is bound to. - For details about the algorithms check the + For details about the algorithms, check the liberally licensed reference implementation sources: and