Harmonize all the manual pages to use "stream" for FILE* instead of randomly using "fp" or "stream." Choosing something and being consistent helps users scan the man pages quickly and understand what they are looking at. Patch against master. diff --git a/man3/getspnam.3 b/man3/getspnam.3 index 13d6157..e230b78 100644 --- a/man3/getspnam.3 +++ b/man3/getspnam.3 @@ -24,11 +24,11 @@ lckpwdf, ulckpwdf \- get shadow password file entry .sp .B void endspent(void); .sp -.BI "struct spwd *fgetspent(FILE *" fp ); +.BI "struct spwd *fgetspent(FILE *" stream ); .sp .BI "struct spwd *sgetspent(const char *" s ); .sp -.BI "int putspent(const struct spwd *" p ", FILE *" fp ); +.BI "int putspent(const struct spwd *" p ", FILE *" stream ); .sp .B int lckpwdf(void); .sp @@ -46,7 +46,7 @@ lckpwdf, ulckpwdf \- get shadow password file entry .br .BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .sp -.BI "int fgetspent_r(FILE *" fp ", struct spwd *" spbuf , +.BI "int fgetspent_r(FILE *" stream ", struct spwd *" spbuf , .br .BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp ); .sp @@ -137,8 +137,8 @@ The function writes the contents of the supplied struct .I spwd .I *p -as a text line in the shadow password file format to the stream -.IR fp . +as a text line in the shadow password file format to the +.IR stream . String entries with value NULL and numerical entries with value \-1 are written as an empty string. .LP --- Cheers, Carlos. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
