Re: A P documentation could be enhanced

[Kai Grossjohann <kai@emptydomain.de>]

Here is a suggestion for a docstring.  What do you think?  Does it
describe the behavior better?

--- gnus-sum.el.~6.373.~	Fri Jan  2 17:49:04 2004
+++ gnus-sum.el	Sun Jan  4 19:09:33 2004
@@ -8534,10 +8534,16 @@
 			  "[()]" "\\\\\\&"))
 
 (defun gnus-summary-print-article (&optional filename n)
-  "Generate and print a PostScript image of the N next (mail) articles.
+  "Generate and print a PostScript image of the process-marked (mail) articles.
 
-If N is negative, print the N previous articles.  If N is nil and articles
-have been marked with the process mark, print these instead.
+If used interactively, print the current article if none are
+process-marked.  With prefix arg, prompt the user for the name of the
+file to save in.
+
+When used from Lisp, accept two optional args FILENAME and N.  N means
+to print the next N articles.  If N is negative, print the N previous
+articles.  If N is nil and articles have been marked with the process
+mark, print these instead.
 
 If the optional first argument FILENAME is nil, send the image to the
 printer.  If FILENAME is a string, save the PostScript image in a file with