GNU bug report logs - #9070
gnus-summary-insert-subject doc needs update

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 9070 in the body.
You can then email your comments to 9070 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Dave Abrahams <dave <at> boostpro.com>
To: submit <at> debbugs.gnu.org (The Gnus Bugfixing Girls + Boys)
Subject: gnus-summary-insert-subject doc needs update
Date: Wed, 13 Jul 2011 16:57:37 -0400

  "Find article ID and insert the summary line for that article.
OLD-HEADER can either be a header or a line number to insert
the subject line on."

the `use-old-header' parameter is undocumented and the fact that
OLD-HEADER can be a vector is undocumented


No Gnus v0.18
GNU Emacs 23.3.1 (x86_64-apple-darwin, NS apple-appkit-1038.35)
 of 2011-03-09 on black.porkrind.org
200 news.gmane.org InterNetNews NNRP server INN 2.5.1 ready (posting ok)
101 Capability list:
VERSION 2
IMPLEMENTATION INN 2.5.1
AUTHINFO USER
HDR
LIST ACTIVE ACTIVE.TIMES DISTRIB.PATS HEADERS NEWSGROUPS OVERVIEW.FMT
OVER
POST
READER
STARTTLS
.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com

Message #12 received at 9070 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: Dave Abrahams <dave <at> boostpro.com>
Cc: 9070 <at> debbugs.gnu.org
Subject: Re: gnus-summary-insert-subject doc needs update
Date: Tue, 19 Jul 2011 19:36:46 +0200

Dave Abrahams <dave <at> boostpro.com> writes:

>   "Find article ID and insert the summary line for that article.
> OLD-HEADER can either be a header or a line number to insert
> the subject line on."
>
> the `use-old-header' parameter is undocumented and the fact that

I've now documented this.

> OLD-HEADER can be a vector is undocumented

HEADER is always a vector.  Well, except in Article and Message buffers,
that is.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Message #15 received at 9070 <at> debbugs.gnu.org (full text, mbox):

From: Dave Abrahams <dave <at> boostpro.com>
To: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
Cc: 9070 <at> debbugs.gnu.org
Subject: Re: gnus-summary-insert-subject doc needs update
Date: Thu, 21 Jul 2011 18:11:26 -0400

on Tue Jul 19 2011, Lars Magne Ingebrigtsen <larsi-AT-gnus.org> wrote:

> Dave Abrahams <dave <at> boostpro.com> writes:
>
>>   "Find article ID and insert the summary line for that article.
>> OLD-HEADER can either be a header or a line number to insert
>> the subject line on."
>>
>> the `use-old-header' parameter is undocumented 
>
> I've now documented this.

thanks

>> and the fact that OLD-HEADER can be a vector is undocumented
>
> HEADER is always a vector.  

And where is that convention documented?

> Well, except in Article and Message buffers, that is.

And what is HEADER there?  And where is /that/ documented?

Trying not to be too nitpicky while still pushing for grokkable code/doc
relationships.  Thanks for your patience.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com

Message #18 received at 9070 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: Dave Abrahams <dave <at> boostpro.com>
Cc: 9070 <at> debbugs.gnu.org
Subject: Re: gnus-summary-insert-subject doc needs update
Date: Sun, 31 Jul 2011 17:30:12 +0200

Dave Abrahams <dave <at> boostpro.com> writes:

>>> and the fact that OLD-HEADER can be a vector is undocumented
>>
>> HEADER is always a vector.  
>
> And where is that convention documented?

In the nnheader.el file.

>> Well, except in Article and Message buffers, that is.
>
> And what is HEADER there?  And where is /that/ documented?

We talk about "message headers" here and there meaning the part of the
message that's not the body.

And it's documented in the RFCs.  :-)

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.