src/*: Recast some option descriptions for clarity

Author: g-branden-robinson

src/doom/d_main.c

@@ -2203,7 +2203,7 @@ void D_DoomMain (void)
     // @arg <n>
     // @vanilla
     //
-    // Start playing on episode n (1-4).
+    // Start playing episode n (1-4).
     //
 
     p = M_CheckParmWithArgs("-episode", 1);

src/heretic/d_main.c

@@ -583,8 +583,8 @@ void D_CheckRecordFrom(void)
     // @category demo
     // @arg <save-num> <demo-name>
     //
-    // Record a demo, loading from the given filename.  Equivalent
-    // to -loadgame <save-num> -record <demo-name>.
+    // Load a game from the given savegame slot and record a demo from
+    // it.  Equivalent to -loadgame <save-num> -record <demo-name>.
 
     p = M_CheckParmWithArgs("-recordfrom", 2);
     if (!p)
@@ -993,7 +993,7 @@ void D_DoomMain(void)
     // @arg <n>
     // @vanilla
     //
-    // Start playing on episode n (1-4).
+    // Start playing episode n (1-4).
     //
 
     p = M_CheckParmWithArgs("-episode", 1);

src/hexen/h2_main.c

@@ -1382,8 +1382,8 @@ static void CheckRecordFrom(void)
     // @category demo
     // @arg <save-num> <demo-name>
     //
-    // Record a demo, loading from the given filename.  Equivalent
-    // to -loadgame <save-num> -record <demo-name>.
+    // Load a game from the given savegame slot and record a demo from
+    // it.  Equivalent to -loadgame <save-num> -record <demo-name>.
     //
     p = M_CheckParm("-recordfrom");
     if (!p || p > myargc - 2)

src/i_musicpack.c

@@ -1145,8 +1145,8 @@ static boolean I_MP_InitMusic(void)
     // @category obscure
     // @arg <file>
     //
-    // Read all MIDI files from loaded WAD files, dump an example substitution
-    // music config file to the specified filename and quit.
+    // Read all MIDI files from loaded WAD files, dump an example
+    // substitution music config file to the specified file, and quit.
     //
     i = M_CheckParmWithArgs("-dumpsubstconfig", 1);
 

src/m_argv.c

@@ -288,10 +288,10 @@ void M_FindResponseFile(void)
         //!
         // @arg <file>
         //
-        // Load extra command line arguments from the given response file.
-        // Arguments read from the file will be inserted into the command
-        // line replacing this argument.  A response file can also be loaded
-        // using the abbreviated syntax '@filename.rsp'.
+        // Load extra command-line arguments from the given response
+        // file.  Arguments read from the file are inserted into the
+        // command line, replacing this argument.  A response file can
+        // also be loaded using the abbreviated syntax '@file.rsp'.
         //
         i = M_CheckParmWithArgs("-response", 1);
         if (i <= 0)

src/strife/d_main.c

@@ -1697,7 +1697,8 @@ void D_DoomMain (void)
     // @category obscure
     // @vanilla
     //
-    // Set Rogue playtesting mode (godmode, noclip toggled by backspace).
+    // Set Rogue playtesting mode
+    // (god mode; no cliping mode toggled by backspace).
     //
 
     workparm = M_CheckParm ("-work");
@@ -2113,7 +2114,7 @@ void D_DoomMain (void)
     // // @arg <n>
     // // @vanilla
     // //
-    // // Start playing on episode n (1-4).
+    // // Start playing episode n (1-4).
     // //
 
     // p = M_CheckParmWithArgs("-episode", 1);

src/w_main.c

@@ -177,7 +177,9 @@ boolean W_ParseCommandLine(void)
     // @arg <files>
     // @vanilla
     //
-    // Load the specified PWAD files.
+    // Load the specified PWAD files.  Each succeeding argument is
+    // treated as a PWAD file name until one starts with a dash or the
+    // argument list is exhausted.
     //
 
     p = M_CheckParmWithArgs ("-file", 1);