X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/mLib/blobdiff_plain/08da152ecf0c34dbb9fbfa9e863f1057c092e860..6f444bda1b7deb31cf7fb2395cb0993c3e3b8c42:/man/quis.3 diff --git a/man/quis.3 b/man/quis.3 index 96e5d49..ef510d6 100644 --- a/man/quis.3 +++ b/man/quis.3 @@ -1,10 +1,11 @@ .\" -*-nroff-*- -.TH quis 3 "22 May 1999" mLib +.TH quis 3 "22 May 1999" "Straylight/Edgeware" "mLib utilities library" .SH NAME quis \- remember the program's name for use in messages .\" @quis .\" @ego .\" @QUIS +.\" @pquis .SH SYNOPSIS .nf .B "#include " @@ -12,6 +13,7 @@ quis \- remember the program's name for use in messages .BI "void ego(const char *" p ); .B "const char *quis(void);" .B "const char *QUIS;" +.BI "int pquis(FILE *" fp ", const char *" p ); .fi .SH DESCRIPTION The @@ -34,6 +36,22 @@ returned by Don't ask why it's done this way. There are raisins, but they're mostly hysterical. .PP +The function +.B pquis +is passed a file pointer +.I fp +and a string +.IR p : +it writes the string to the file, replacing every lone occurrence of the +character +.RB ` $ ' +by the program name. Pairs +.RB (` $$ ') +are written as single dollar signs. The return value is zero if +everything went OK, or the constant +.B EOF +if there was an error. +.PP The program name is used in the messages produced by the .BR die (3) and