diff options
author | Guy Helmer <ghelmer@FreeBSD.org> | 2012-01-26 20:35:01 +0000 |
---|---|---|
committer | Guy Helmer <ghelmer@FreeBSD.org> | 2012-01-26 20:35:01 +0000 |
commit | 7b7aa969bb8e7227c93a7426cbad1280fd78280a (patch) | |
tree | 172dc78c770f4f9592757cbd4d34f1d926ad09c5 /libutil | |
parent | 8a770c07c5bd31878a5a6a983aabc49fb1b7a3c9 (diff) | |
download | pw-darwin-7b7aa969bb8e7227c93a7426cbad1280fd78280a.tar.gz pw-darwin-7b7aa969bb8e7227c93a7426cbad1280fd78280a.tar.zst pw-darwin-7b7aa969bb8e7227c93a7426cbad1280fd78280a.zip |
Make the comments consistent (capitalization, punctuation, and
format).
Requested by bde
Diffstat (limited to 'libutil')
-rw-r--r-- | libutil/libutil.h | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/libutil/libutil.h b/libutil/libutil.h index bd04eed..fbf5a89 100644 --- a/libutil/libutil.h +++ b/libutil/libutil.h @@ -71,14 +71,14 @@ typedef __uid_t uid_t; #define PROPERTY_MAX_NAME 64 #define PROPERTY_MAX_VALUE 512 -/* for properties.c */ +/* For properties.c. */ typedef struct _property { struct _property *next; char *name; char *value; } *properties; -/* Avoid pulling in all the include files for no need */ +/* Avoid pulling in all the include files for no need. */ struct in_addr; struct pidfh; struct sockaddr; @@ -132,7 +132,11 @@ int uu_lock(const char *_ttyname); int uu_unlock(const char *_ttyname); int uu_lock_txfr(const char *_ttyname, pid_t _pid); -#ifdef _STDIO_H_ /* avoid adding new includes */ +/* + * Conditionally prototype the following functions if the include + * files upon which they depend have been included. + */ +#ifdef _STDIO_H_ char *fparseln(FILE *_fp, size_t *_len, size_t *_lineno, const char _delim[3], int _flags); #endif @@ -209,18 +213,18 @@ __END_DECLS #define HD_OMIT_HEX (1 << 17) #define HD_OMIT_CHARS (1 << 18) -/* Flags for humanize_number(3) flags. */ +/* Values for humanize_number(3)'s flags parameter. */ #define HN_DECIMAL 0x01 #define HN_NOSPACE 0x02 #define HN_B 0x04 #define HN_DIVISOR_1000 0x08 #define HN_IEC_PREFIXES 0x10 -/* Flags for humanize_number(3) scale. */ +/* Values for humanize_number(3)'s scale parameter. */ #define HN_GETSCALE 0x10 #define HN_AUTOSCALE 0x20 -/* return values from realhostname(). */ +/* Return values from realhostname(). */ #define HOSTNAME_FOUND 0 #define HOSTNAME_INCORRECTNAME 1 #define HOSTNAME_INVALIDADDR 2 |