From: <ams AT ludd DOT luth DOT se>
Message-Id: <200302011443.h11Eh6s15828@speedy.ludd.luth.se>
Subject: Re: djgpp: djgpp/src/stub/stubdocs.txi
In-Reply-To: <200301251236.h0PCalQ22297@speedy.ludd.luth.se> "from ams@ludd.luth.se
 at Jan 25, 2003 01:36:47 pm"
To: djgpp-workers AT delorie DOT com
Date: Sat, 1 Feb 2003 15:43:06 +0100 (CET)
X-Mailer: ELM [version 2.4ME+ PL78 (25)]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset=US-ASCII
X-MailScanner: Found to be clean
X-MailScanner-SpamScore: s
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

Hello.

Here's my try for the documentation for the -stubparams parameter of 
stubify.

Index: djgpp/src/stub/stubdocs.txi
===================================================================
RCS file: /cvs/djgpp/djgpp/src/stub/stubdocs.txi,v
retrieving revision 1.2
diff -p -u -r1.2 stubdocs.txi
--- djgpp/src/stub/stubdocs.txi 25 Jan 2003 12:30:42 -0000      1.2
+++ djgpp/src/stub/stubdocs.txi 1 Feb 2003 14:38:36 -0000
@@ -31,7 +31,7 @@ will provide additional debugging output
 @chapter @command{stubify}
 @pindex stubify
 
-Usage: @kbd{stubify [-v] [-g] files}
+Usage: @kbd{stubify [-v] [-g] [-stubparams=param[,param...]] files}
 
 @command{stubify} is a utility that adds a DOS exectuable stub loader to the
 front of a @acronym{COFF} image.  The input program may be @acronym{COFF}
@@ -55,6 +55,13 @@ image containing only the stub, which ca
 program in the same directory.  This is used to simulate links, so
 @code{argv[0]} can be used to change program behavior or create a small
 alias to the other program.
+
+@item -stubparams=param[,param...]
+
+Pass @option{param[ param...]} to @command{stubedit} to tune the stub's
+parameters.  Commas in @option{param[,param...]} are converted into
+spaces.  See the documentation of @command{stubedit} (@pxref{stubedit})
+for which parameters that are available.
 
 @end table
 
I also did some tiny adjustment(s?) to the help text in stubify so here's
that part of the patch again:

Index: djgpp/src/stub/stubify.c
===================================================================
RCS file: /cvs/djgpp/djgpp/src/stub/stubify.c,v
retrieving revision 1.8
diff -p -u -r1.8 stubify.c
--- djgpp/src/stub/stubify.c    23 Jan 2003 16:37:31 -0000      1.8
+++ djgpp/src/stub/stubify.c    1 Feb 2003 14:38:37 -0000
...
 void print_help(void)
 {
-  fprintf(stderr, "Usage: stubify [-v] [-g] <program>\n"
+  fprintf(stderr, "Usage: stubify [-v] [-g] [%sparam[,param...] <program>\n"
          "<program> may be COFF or stubbed .exe, and may be COFF with .exe extension.\n"
          "Resulting file will have .exe\n"
          "-v -> verbose\n"
          "-g -> generate a stub\n"
+         "%sparam[,param...] -> pass param[ param...] to stubedit (commas are\n"
+         "      converted into spaces); see stubedit documentation for what param can be\n"
          "\nThis program is NOT shareware or public domain.  It is copyrighted.\n"
          "It is redistributable but only as part of a complete package.  If you\n"
          "have a copy of this program, the place that you got it from is\n"
-         "responsible for making sure you are able to get its sources as well.\n");
+         "responsible for making sure you are able to get its sources as well.\n",
+         STUB_OPTIONS, STUB_OPTIONS );
 }
 


Right,

						MartinS