Re: RFC and I-D Citation Tool

Henrik Levkowetz <henrik@levkowetz.com> Tue, 31 July 2012 22:55 UTC

Return-Path: <henrik@levkowetz.com>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2C5F421F88E5; Tue, 31 Jul 2012 15:55:44 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.566
X-Spam-Level:
X-Spam-Status: No, score=-102.566 tagged_above=-999 required=5 tests=[AWL=0.033, BAYES_00=-2.599, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id sbDrhPdYr3tk; Tue, 31 Jul 2012 15:55:39 -0700 (PDT)
Received: from merlot.tools.ietf.org (merlot.tools.ietf.org [IPv6:2a01:3f0:0:31::14]) by ietfa.amsl.com (Postfix) with ESMTP id A3C5821F88AD; Tue, 31 Jul 2012 15:55:39 -0700 (PDT)
Received: from dhcp-67cb.meeting.ietf.org ([130.129.103.203]:61583) by merlot.tools.ietf.org with esmtpsa (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.77) (envelope-from <henrik@levkowetz.com>) id 1SwLLS-0006HJ-NF; Wed, 01 Aug 2012 00:55:21 +0200
Message-ID: <50186251.7070705@levkowetz.com>
Date: Tue, 31 Jul 2012 15:55:13 -0700
From: Henrik Levkowetz <henrik@levkowetz.com>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:10.0.6esrpre) Gecko/20120713 Thunderbird/10.0.6
MIME-Version: 1.0
To: "Ersue, Mehmet (NSN - DE/Munich)" <mehmet.ersue@nsn.com>
References: <alpine.OSX.2.01.1207311102470.86865@173-11-110-132-sfba.hfc.comcastbusiness.net> <80A0822C5E9A4440A5117C2F4CD36A6404136619@DEMUEXC006.nsn-intra.net>
In-Reply-To: <80A0822C5E9A4440A5117C2F4CD36A6404136619@DEMUEXC006.nsn-intra.net>
X-Enigmail-Version: 1.4
Content-Type: text/plain; charset="ISO-8859-1"
Content-Transfer-Encoding: 7bit
X-SA-Exim-Connect-IP: 130.129.103.203
X-SA-Exim-Rcpt-To: mehmet.ersue@nsn.com, ole@cisco.com, ietf@ietf.org, rsoc@iab.org, hlflanagan@gmail.com, rsag@rfc-editor.org, henrik-sent@levkowetz.com
X-SA-Exim-Mail-From: henrik@levkowetz.com
Subject: Re: RFC and I-D Citation Tool
X-SA-Exim-Version: 4.2.1 (built Mon, 26 Dec 2011 16:57:07 +0000)
X-SA-Exim-Scanned: Yes (on merlot.tools.ietf.org)
Cc: RSOC <rsoc@iab.org>, Ole Jacobsen <ole@cisco.com>, The IETF <ietf@ietf.org>, rsag@rfc-editor.org, Heather Flanagan <hlflanagan@gmail.com>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/ietf>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 31 Jul 2012 22:55:44 -0000

Hi Ersue,

On 2012-07-31 13:27 Ersue, Mehmet (NSN - DE/Munich) said the following:
> Nice tool. 
> 
> However, I am wondering why the tool changes the order of the names.
> There is actually a reason why documents list names in a specific order.

There is no intentional name re-ordering.  I'll look into why that happens.

> Some of the citations appear to be incomplete, see RFC3410.

Ok, will check that too.

Thanks for the feedback!


Best regards,

	Henrik

> Cheers, 
> Mehmet 
> 
> 
>> -----Original Message-----
>> From: ietf-bounces@ietf.org [mailto:ietf-bounces@ietf.org] On Behalf
> Of ext Ole
>> Jacobsen
>> Sent: Tuesday, July 31, 2012 11:17 AM
>> To: The IETF
>> Cc: RSOC; Heather Flanagan; rsag@rfc-editor.org
>> Subject: RFC and I-D Citation Tool
>> 
>> 
>> In The Internet Protocol Journal I have been using the following
>> citation format, best illustrated by an example:
>> 
>>  Julien Meuric, Diego Caviglia, Don Fedyk, Attila Takacs, and Lou
>>  Berger, "GMPLS Asymmetric Bandwidth Bidirectional Label Switched
>>  Paths (LSPs)," RFC 6387, September 2011.
>> 
>> So, that's full author names "and" before the last author name, title,
>> document number and date, using the American "quotation outside
>> punctuation rule."
>> 
>> I got tired of doing this "by hand" so I asked Henrik if he could
>> write me a tool. He did (THANKS!), and the result is here:
>> 
>> http://tools.ietf.org/tools/citation/
>> 
>> This will take either the draft name or the RFC number as input and
>> produce a citation similar to the one above. You can of course play
>> with the elements and generate a format that suits your own taste, for
>> example, for I-Ds, in print it might be good to have the FILE NAME as
>> the last entry:
>> 
>>  Adam Langley, "Serializing DNS Records with DNSSEC Authentication,"
>>  Internet Draft, work in progress, July 2011,
>>  draft-agl-dane-serializechain-01
>> 
>> ...since I like having filenames or URLs on one line (not wrapping)
>> as much as possible.
>> 
>> Many thanks again to Henrik, and I hope you will find it useful too!
>> 
>> Ole
>> 
>> 
>> 
>> Ole J. Jacobsen
>> Editor and Publisher,  The Internet Protocol Journal
>> Cisco Systems
>> Tel: +1 408-527-8972   Mobile: +1 415-370-4628
>> E-mail: ole@cisco.com  URL: http://www.cisco.com/ipj
>> Skype: organdemo
> 
>