]> pd.if.org Git - pdclib.old/commitdiff
Remove empty lines from manpages (lint errors)
authorOwen Shepherd <owen.shepherd@e43.eu>
Wed, 20 Feb 2013 01:46:27 +0000 (01:46 +0000)
committerOwen Shepherd <owen.shepherd@e43.eu>
Wed, 20 Feb 2013 01:46:27 +0000 (01:46 +0000)
man3/abort.3
man3/assert.3
man3/atexit.3
man3/errno.3
man3/exit.3
man3/flockfile.3
man3/pdclib.3
man3/strdup.3
man3/string.h.3

index 4062011036691f62a86298a5619984e83f3d1206..8fcdc2181253530af21a163a1b428c34bcde7b0d 100644 (file)
@@ -4,19 +4,19 @@
 .Dd\r
 .Dt abort 3\r
 .Os\r
-\r
+.\"\r
 .Sh NAME\r
 .Nm abort\r
 .Nd abnormal process termination\r
-\r
+.\"\r
 .Sh SYNOPSIS\r
 .In stdlib.h\r
 .Fn "noreturn void abort" "void"\r
-\r
+.\"\r
 .Sh DESCRIPTION\r
 .Fn abort\r
 causes abnormal process termination to occur.\r
-\r
+.\"\r
 .Pp\r
 First,\r
 .Dv SIGABRT\r
@@ -29,7 +29,7 @@ will then proceed to cause the process to terminate with a failure exit status.
 It is implementation defined whether any open\r
 .Vt FILE\r
 streams are flushed before the process exits.\r
-\r
+.\"\r
 .Sh IMPLEMENTATION NOTES\r
 PDCLib implements termination (in the case that the \r
 .Dv SIGABRT\r
@@ -39,13 +39,13 @@ Therefore, stream flushing rules for
 .Nm\r
 follow those defined for\r
 .Fn _Exit .\r
-\r
+.\"\r
 .Sh SEE ALSO\r
 .Xr exit 3\r
 .Xr quick_exit 3\r
 .Xr _Exit 3\r
 .Xr raise 3\r
-\r
+.\"\r
 .Sh STANDARDS\r
 .Fn abort\r
 is first defined in\r
index d2874e384fd345183b6d096afcb284f6f2e34913..09f9307b554e1e3783607b08a8eda8d269f1c062 100644 (file)
@@ -4,15 +4,15 @@
 .Dd\r
 .Dt assert 3\r
 .Os\r
-\r
+.\"\r
 .Sh NAME\r
 .Nm assert\r
 .Nd validate assertion\r
-\r
+.\"\r
 .Sh SYNOPSIS\r
 .In assert.h\r
 .Fn "void assert" "<scalar expression>"\r
-\r
+.\"\r
 .Sh DESCRIPTION\r
 If\r
 .Dv NDEBUG\r
@@ -30,13 +30,13 @@ The enclosing function of the call to
 .Nm\r
 will only be printed in the error message when compiling for C99, or a later\r
 revision of the C standard. \r
-\r
+.\"\r
 .Sh SEE ALSO\r
 .Xr _Exit 3\r
 .Xr quick_exit 3\r
 .Xr exit 3\r
 .Xr abort 3\r
-\r
+.\"\r
 .Sh STANDARDS\r
 Conforming to\r
 .St -isoC-90 ,\r
index a210266150be56a057244b607acdd77ae1ecb75e..09fe18dfa1f7b7407869cc553639e79334f48023 100644 (file)
@@ -4,17 +4,17 @@
 .Dd\r
 .Dt atexit 3\r
 .Os\r
-\r
+.\"\r
 .Sh NAME\r
 .Nm atexit\r
 .Nd registration of functions to be invoked before process termination\r
-\r
+.\"\r
 .Sh SYNOPSIS\r
 .In stdlib.h\r
 .Fn "int atexit" "void (*handler)(void)"\r
 .Fn "int at_quick_exit" "void (*handler)(void)" \r
 (C11, C++11)\r
-\r
+.\"\r
 .Sh DESCRIPTION\r
 These functions register a function to be called when the corresponding process\r
 exit function is invoked. For\r
@@ -25,7 +25,7 @@ for
 .Fn at_quick_exit\r
 the function will be invoked when the process is terminated by calling\r
 .Fn quick_exit .\r
-\r
+.\"\r
 .Pp\r
 These functions are used in order to permit a program to perform actions before\r
 a process is terminated; for example, releasing an interprocess semaphore. \r
@@ -36,14 +36,14 @@ handlers; the purpose of
 is to support the abandonning of a process when normal process termination might\r
 not be possible; at_quick_exit handlers should therefore be used sparingly and\r
 only when their use is essential.\r
-\r
+.\"\r
 .Pp\r
 The standard guarantees that \r
 .Fn atexit\r
 and\r
 .Fn at_quick_exit\r
 may each be called at least 32 times successfully.\r
-\r
+.\"\r
 .Pp\r
 .Fn atexit \r
 and\r
@@ -51,7 +51,7 @@ and
 handlers are called in reverse order of the order they were registered in. For\r
 precise details of their ordering, see\r
 .Xr exit 3 .\r
-\r
+.\"\r
 .Pp\r
 The result of exiting from a handler registered with\r
 .Fn atexit\r
@@ -66,7 +66,7 @@ or
 should throw, \r
 .Fn std::terminate\r
 is invoked.\r
-\r
+.\"\r
 .Pp\r
 Undefined behaviour results if an \r
 .Fn atexit\r
@@ -76,19 +76,19 @@ handler calls
 .Fn exit\r
 or\r
 .Fn quick_exit . \r
-\r
+.\"\r
 .Sh RETURN VALUES\r
 Returns 0 to indicate success; nonzero returns indicate failure.\r
-\r
+.\"\r
 .Sh ERRORS\r
 No errors are defined\r
-\r
+.\"\r
 .Sh SEE ALSO\r
 .Xr abort 3\r
 .Xr exit 3\r
 .Xr quick_exit 3\r
 .Xr _Exit 3\r
-\r
+.\"\r
 .Sh STANDARDS\r
 .Fn atexit\r
 is first defined in\r
index da5464045aea0d80ec341590734b99d36f23336b..80cb02d1be11d14bd79094b108590560630a6227 100644 (file)
@@ -4,11 +4,11 @@
 .Dd\r
 .Dt ERRNO 3\r
 .Os\r
-\r
+.\"\r
 .Sh NAME\r
 .Nm errno\r
 .Nd library error result\r
-\r
+.\"\r
 .Sh SYNOPSIS\r
 .In errno.h\r
 .Pp\r
@@ -54,7 +54,7 @@ using errno was to define
 .Va extern int errno .\r
 This is no longer supported by the POSIX or C standards, and will not work on \r
 the majority of implementations, including this one.\r
-\r
+.\"\r
 .Sh SEE ALSO\r
 .Xr errno.h 3\r
 .Xr abort 3\r
index ac8ae99403bcf842a0718c77db5e7b94c5613ec3..4d9860ee7abf5c3c04b139cc1c67fe8f2e0a9350 100644 (file)
@@ -4,17 +4,17 @@
 .Dd\r
 .Dt exit 3\r
 .Os\r
-\r
+.\"\r
 .Sh NAME\r
 .Nm exit\r
 .Nd terminates the process\r
-\r
+.\"\r
 .Sh SYNOPSIS\r
 .In stdlib.h\r
 .Fn "noreturn void exit" "int status"\r
 .Fn "noreturn void quick_exit" "int status"\r
 .Fn "noreturn void _Exit" "int exitcode"\r
-\r
+.\"\r
 .Sh DESCRIPTION\r
 Calling any of these three functions terminates the current process, returning \r
 the exit code passed as a parameter. The interpretation of the exit code is \r
@@ -23,7 +23,7 @@ undefined, except that 0 or
 shall indicate successful completion and\r
 .Dv EXIT_FAILURE\r
 shall indicate a non-successful completion.\r
-\r
+.\"\r
 .Pp\r
 .Fn exit\r
 first destroys all objects with C++ thread local storage duration (the C \r
@@ -43,7 +43,7 @@ particular that functions registered with
 are\r
 .Sy not\r
 called.\r
-\r
+.\"\r
 .Pp\r
 .Fn quick_exit\r
 invokes any functions registered with\r
@@ -53,7 +53,7 @@ environment by calling
 .Fn _Exit .\r
 No signal handlers are called, nor are any functions registered with\r
 .Fn atexit .\r
-\r
+.\"\r
 .Pp\r
 .Fn _Exit\r
 returns control to the controlling environment without invoking any functions\r
@@ -64,7 +64,7 @@ any signal handlers, or the destructors of any thread local objects or C++
 objects of static storage duration. Whether or not any open \r
 .Vt FILE\r
 streams with unwritten data are flushed or not is undefined.\r
-\r
+.\"\r
 .Pp\r
 The result of aborting a call to \r
 .Fn exit\r
@@ -79,7 +79,7 @@ or
 should throw, \r
 .Fn std::terminate\r
 is invoked.\r
-\r
+.\"\r
 .Pp\r
 Undefined behaviour results if, while a call to\r
 .Fn exit\r
@@ -90,7 +90,7 @@ is in progress, a call to
 or\r
 .Fn quick_exit\r
 is made. \r
-\r
+.\"\r
 .Sh IMPLEMENTATION NOTES\r
 PDCLib implements the process of flushing streams in\r
 .Fn _Exit ,\r
@@ -99,12 +99,12 @@ and therefore
 calls it after all\r
 .Fn atexit\r
 handlers have been invoked.\r
-\r
+.\"\r
 .Sh SEE ALSO\r
 .Xr abort 3\r
 .Xr atexit 3\r
 .Xr at_quick_exit 3\r
-\r
+.\"\r
 .Sh STANDARDS\r
 .Fn exit\r
 is first defined in\r
index a8a4a3bea408723d8ecca281e820e4498d7980eb..8473fa9cf0e392228672f08e390f5135bbf13f36 100644 (file)
@@ -4,19 +4,19 @@
 .Dd\r
 .Dt flockfile 3\r
 .Os\r
-\r
+.\"\r
 .Sh NAME\r
 .Nm flockfile, ftrylockfile, funlockfile\r
 .Nd stdio file locking\r
-\r
+.\"\r
 .Sh SYNOPSIS\r
 .Sy #define _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600 || _SVID_SOURCE || _BSD_SOURCE\r
-\r
+.\"\r
 .In stdio.h\r
 .Fn "void flockfile" "FILE *file"\r
 .Fn "int ftrylockfile" "FILE *file"\r
 .Fn "void funlockfile" "FILE *file"\r
-\r
+.\"\r
 .Sh DESCRIPTION\r
 .Fn flockfile\r
 locks the passed FILE stream for access by the calling thread, potentially \r
@@ -39,18 +39,18 @@ on a file must be equal to the number of calls to
 .\"\r
 .Pp\r
 No other thread may do I/O through the locked file while it is locked.\r
-\r
+.\"\r
 .Sh IMPLEMENTATION NOTES\r
 PDCLib implements the file locking on top of the Mutex primitives added by C11\r
-\r
+.\"\r
 .Sh SEE ALSO\r
 .Xr fopen 3\r
 .Xr fclose 3\r
 .Xr unlocked_stdio 3\r
 .Xr mtx_t 3\r
-\r
+.\"\r
 .Sh STANDARDS\r
 The locked I/O routines were initially introduced in \r
 .St -svid4 ,\r
 and incorporated into POSIX in \r
-.St -p1003.1-2001 .\r
+.St -p1003.1-2001 .
\ No newline at end of file
index 3c4b664ca663d8b2da921a08604fb204a4ce4cbb..8773c2684af678ef65308036144d2d13d0536e8f 100644 (file)
@@ -4,11 +4,11 @@
 .Dd\r
 .Dt PDCLIB 3\r
 .Os\r
-\r
+.\"\r
 .Sh NAME\r
 .Nm PDCLib\r
 .Nd Public domain, portable C library\r
-\r
+.\"\r
 .Sh LIBRARY\r
 .Lb pdclib\r
 .Sh SYNOPSIS\r
@@ -31,7 +31,7 @@
 .In threads.h\r
 .In time.h\r
 .In wchar.h\r
-\r
+.\"\r
 .Sh DESCRIPTION\r
 The\r
 .Nm\r
@@ -57,7 +57,7 @@ to the appropriate value. For example, in the following definition:
 .br\r
 .Fn "char * strdup" "const char *"\r
 .Ed\r
-\r
+.\"\r
 it is documented that defining either \r
 .Dv _XOPEN_SOURCE\r
 or\r
@@ -68,7 +68,7 @@ before the first inclusion of
 .In string.h\r
 will expose a definition of the function\r
 .Fn strdup\r
-\r
+.\"\r
 .Sh SEE ALSO\r
 .Xr cc 1 ,\r
 .Xr c++ 7\r
@@ -93,4 +93,4 @@ library is maintained by by
 .Mt pdclib@owenshepherd.net .\r
 Based upon work by\r
 .An Martin "Solar" Baute ,\r
-.Mt solar@rootdirectory.de .\r
+.Mt solar@rootdirectory.de .
\ No newline at end of file
index 8ac67e0a60e04c560fa1281ac589b0c19f641c53..28036115251d13c7a1c65d912fa84bac0107da61 100644 (file)
@@ -4,11 +4,11 @@
 .Dd\r
 .Dt strdup 3\r
 .Os\r
-\r
+.\"\r
 .Sh NAME\r
 .Nm strdup\r
 .Nd string duplication\r
-\r
+.\"\r
 .Sh SYNOPSIS\r
 .Sy #define _XOPEN_SOURCE || _POSIX_C_SOURCE >= 200809L\r
 .In string.h\r
@@ -17,7 +17,7 @@
 .Sy #define _POSIX_C_SOURCE >= 200809L\r
 .In string.h\r
 .Fn "char *strndup" "const char *str" "size_t len"\r
-\r
+.\"\r
 .Sh DESCRIPTION\r
 .Fn strdup\r
 allocates a new buffer of sufficient size as to be able to hold the entirety of\r
@@ -25,7 +25,7 @@ allocates a new buffer of sufficient size as to be able to hold the entirety of
 including the terminating character, and copies the contents of\r
 .Va str\r
 into it.\r
-\r
+.\"\r
 .Pp\r
 .Fn strndup\r
 allocates a buffer large enough to contain\r
@@ -38,17 +38,17 @@ including the trailing null character, whichever is smaller. The first
 characters of \r
 .Va str\r
 are then copied into it, and a null character appended.\r
-\r
+.\"\r
 .Pp\r
 The buffers returned by these functions must be released by a call to\r
 .Fn free .\r
-\r
+.\"\r
 .Sh SEE ALSO\r
 .Xr free 3\r
 .Xr malloc 3\r
 .Xr strcpy 3\r
 .Xr strncpy 3\r
-\r
+.\"\r
 .Sh STANDARDS\r
 .Fn strdup\r
 first specified in \r
index fa312b56955e35dbf1dc2cbd3b856aac955edc87..eb786ce2096bef86df4124f75a2a5fb7c20dc2e0 100644 (file)
@@ -23,7 +23,7 @@ The type
 and the preprocessor constant\r
 .Dv NULL\r
 shall be defined.\r
-\r
+.\"\r
 .Pp\r
 The following shall be defined as functions:\r
 .br\r