This is automatically generated email about problems in a man page for which
you appear to be responsible. If you are not the right person or list, tell
me and I will attempt to correct my database.
See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated. Feel free to email me with any questions.
Note: These patches do not change the mod date of any manual page. You
may wish to do that by hand.
Problems with SDL_Init.3:
List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
This confuses doclifter, and may also mess up stricter troff
interpreters like Xman and Rosetta.
— SDL_Init.3-orig 2007-01-27 04:23:08.000000000 -0500
+++ SDL_Init.3 2007-01-27 04:23:56.000000000 -0500
@@ -32,6 +32,7 @@
Prevents SDL from catching fatal signals&.
.TP 20
\fBSDL_INIT_EVENTTHREAD\fP
+(This needs to be documented)
.SH “RETURN VALUE”
.PP
Returns \fB-1\fR on an error or \fB0\fR on success&.-----------------------------
esr has a man page bot now?On Tuesday 06 February 2007 16:11, esr at thyrsus.com wrote:
This is automatically generated email about problems in a man page for
which you appear to be responsible. If you are not the right person or
list, tell me and I will attempt to correct my database.
See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated. Feel free to email me with any
questions. Note: These patches do not change the mod date of any manual
page. You may wish to do that by hand.
Problems with SDL_Init.3:
List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
This confuses doclifter, and may also mess up stricter troff
interpreters like Xman and Rosetta.
— SDL_Init.3-orig 2007-01-27 04:23:08.000000000 -0500
+++ SDL_Init.3 2007-01-27 04:23:56.000000000 -0500
@@ -32,6 +32,7 @@
Prevents SDL from catching fatal signals&.
.TP 20
\fBSDL_INIT_EVENTTHREAD\fP
+(This needs to be documented)
.SH “RETURN VALUE”
.PP
Returns \fB-1\fR on an error or \fB0\fR on success&.
–
Patrick McFarland || http://AdTerrasPerAspera.com
"Computer games don’t affect kids; I mean if Pac-Man affected us as kids,
we’d all be running around in darkened rooms, munching magic pills and
listening to repetitive electronic music." – Kristian Wilson, Nintendo,
Inc, 1989
Nope, I ship these by hand every one in a while. But they’re generated
from a database of patches and error codes that I’ve accumulated as I’ve
worked on doclifter. I suppose that’s a bit bottish :-).
Actually, you can consider yourselves part of a…privileged…few. Only
about 5% of man pages have the sorts of defects my validator catches. Here
are more precise figures from my latest torture test, run just an hour ago
on a full Fedora Core 6 installation:
Nope, I ship these by hand every one in a while. But they’re generated
from a database of patches and error codes that I’ve accumulated as I’ve
worked on doclifter. I suppose that’s a bit bottish :-).
Actually, you can consider yourselves part of a…privileged…few. Only
about 5% of man pages have the sorts of defects my validator catches.
Here
are more precise figures from my latest torture test, run just an hour ago
on a full Fedora Core 6 installation:
Actually, you can consider yourselves part of a…privileged…few. Only
about 5% of man pages have the sorts of defects my validator catches. Here
are more precise figures from my latest torture test, run just an hour ago
on a full Fedora Core 6 installation:
Thanks for the info, Eric.
Unfortunately, our manpages appear to be generated from some docbook
file that doesn’t appear to exist anymore:
http://bugzilla.libsdl.org/show_bug.cgi?id=351
We really should move to Doxygen or something, since while having the
manpages are convenient, they are out of date in some places, competing
with the wiki, and are yet-another copy that needs to be updated when
things change. It’d be nice to unify all that.
We really should move to Doxygen or something, since while having the
manpages are convenient, they are out of date in some places,
competing
with the wiki, and are yet-another copy that needs to be updated when
things change. It’d be nice to unify all that.
You have my vote for doxygen.On Feb 12, 2007, at 12:38 PM, Ryan C. Gordon wrote:
–
Kuon
Programmer and sysadmin.
“Computers should not stop working when the users’ brain does.”