From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/55595 Path: main.gmane.org!not-for-mail From: Kai Grossjohann Newsgroups: gmane.emacs.gnus.general Subject: Re: A P documentation could be enhanced Date: Sun, 04 Jan 2004 19:12:37 +0100 Sender: ding-owner@lists.math.uh.edu Message-ID: <87brpjd1m2.fsf@emptyhost.emptydomain.de> References: <87k749gd3v.fsf@emptyhost.emptydomain.de> <878ykoy89l.fsf@emptyhost.emptydomain.de> <87k747d24h.fsf@emptyhost.emptydomain.de> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1073239966 25995 80.91.224.253 (4 Jan 2004 18:12:46 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 4 Jan 2004 18:12:46 +0000 (UTC) Original-X-From: ding-owner+M4135@lists.math.uh.edu Sun Jan 04 19:12:43 2004 Return-path: Original-Received: from malifon.math.uh.edu ([129.7.128.13]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AdCjz-0000O3-00 for ; Sun, 04 Jan 2004 19:12:43 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu) by malifon.math.uh.edu with smtp (Exim 3.20 #1) id 1AdCjo-00028v-00; Sun, 04 Jan 2004 12:12:32 -0600 Original-Received: from justine.libertine.org ([66.139.78.221] ident=postfix) by malifon.math.uh.edu with esmtp (Exim 3.20 #1) id 1AdCjk-00028q-00 for ding@lists.math.uh.edu; Sun, 04 Jan 2004 12:12:28 -0600 Original-Received: from quimby.gnus.org (quimby.gnus.org [80.91.224.244]) by justine.libertine.org (Postfix) with ESMTP id 1F2E23A0027 for ; Sun, 4 Jan 2004 12:12:28 -0600 (CST) Original-Received: from news by quimby.gnus.org with local (Exim 3.35 #1 (Debian)) id 1AdCjj-0002tx-00 for ; Sun, 04 Jan 2004 19:12:27 +0100 Original-To: ding@gnus.org Original-Path: not-for-mail Original-Newsgroups: gnus.ding Original-Lines: 25 Original-NNTP-Posting-Host: 213-203-244-156.kunde.vdserver.de Original-X-Trace: quimby.gnus.org 1073239947 10297 213.203.244.156 (4 Jan 2004 18:12:27 GMT) Original-X-Complaints-To: usenet@quimby.gnus.org Original-NNTP-Posting-Date: Sun, 4 Jan 2004 18:12:27 +0000 (UTC) User-Agent: Gnus/5.1004 (Gnus v5.10.4) Emacs/21.2 (gnu/linux) Cancel-Lock: sha1:W33fx7ISUt0M2bP+iSNvUobR094= Precedence: bulk Xref: main.gmane.org gmane.emacs.gnus.general:55595 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:55595 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