--- doc/recover.6 2003-12-07 18:39:13.000000000 -0500 +++ doc/nethack-recover.6 2010-03-02 16:03:26.978172561 -0500 @@ -1,9 +1,9 @@ -.TH RECOVER 6 "9 January 1993" +.TH NETHACK-RECOVER 6 "9 January 1993" .UC 4 .SH NAME -recover \- recover a NetHack game interrupted by disaster +nethack-recover \- nethack-recover a NetHack game interrupted by disaster .SH SYNOPSIS -.B recover +.B nethack-recover [ .B \-d .I directory @@ -21,7 +21,7 @@ The .I base options tell -.I recover +.I nethack-recover which files to process. Each base option specifies recovery of a separate game. .PP @@ -56,24 +56,24 @@ or "xlock" if the number of concurrent players is being limited. It may be necessary to look in the playground to find the correct base name of the interrupted game. -.I recover +.I nethack-recover will transform these level files into a save file of the same name as .I nethack would have used. .PP Since -.I recover +.I nethack-recover must be able to read and delete files from the playground and create files in the save directory, it has interesting interactions with game security. Giving ordinary players access to -.I recover +.I nethack-recover through setuid or setgid is tantamount to leaving the playground world-writable, with respect to both cheating and messing up other players. For a single-user system, this of course does not change anything, so some of the microcomputer ports install -.I recover +.I nethack-recover by default. .PP For a multi-user system, @@ -81,22 +81,22 @@ playground to be fed to recover when the host machine boots, and handle game crashes individually. If the user population is sufficiently trustworthy, -.I recover +.I nethack-recover can be installed with the same permissions the .I nethack executable has. In either case, -.I recover +.I nethack-recover is easily compiled from the distribution utility directory. .SH NOTES .PP Like .I nethack itself, -.I recover +.I nethack-recover will overwrite existing savefiles of the same name. Savefiles created by -.I recover +.I nethack-recover are uncompressed; they may be compressed afterwards if desired, but even a compression-using @@ -106,11 +106,11 @@ nethack(6) .SH BUGS .PP -.I recover +.I nethack-recover makes no attempt to find out if a base name specifies a game in progress. If multiple machines share a playground, this would be impossible to determine. .PP -.I recover +.I nethack-recover should be taught to use the nethack playground locking mechanism to avoid conflicts.