Re: RFC and I-D Citation Tool

Henrik Levkowetz <henrik@levkowetz.com> Tue, 31 July 2012 22:58 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 1B0F221F8900; Tue, 31 Jul 2012 15:58:44 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.567
X-Spam-Level:
X-Spam-Status: No, score=-102.567 tagged_above=-999 required=5 tests=[AWL=0.032, 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 YoFQUx8ujVMF; Tue, 31 Jul 2012 15:58:43 -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 2751521F88F5; Tue, 31 Jul 2012 15:58:43 -0700 (PDT)
Received: from dhcp-67cb.meeting.ietf.org ([130.129.103.203]:61587) 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 1SwLOL-00031Q-2e; Wed, 01 Aug 2012 00:58:18 +0200
Message-ID: <50186301.9030506@levkowetz.com>
Date: Tue, 31 Jul 2012 15:58:09 -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: Steven Bellovin <smb@cs.columbia.edu>
References: <alpine.OSX.2.01.1207311102470.86865@173-11-110-132-sfba.hfc.comcastbusiness.net> <80A0822C5E9A4440A5117C2F4CD36A6404136619@DEMUEXC006.nsn-intra.net> <alpine.OSX.2.01.1207311421270.87763@173-11-110-132-sfba.hfc.comcastbusiness.net> <C18E588A-541E-43C7-AF41-F301E3A6AE5B@cs.columbia.edu>
In-Reply-To: <C18E588A-541E-43C7-AF41-F301E3A6AE5B@cs.columbia.edu>
X-Enigmail-Version: 1.4
Content-Type: multipart/signed; micalg="pgp-sha1"; protocol="application/pgp-signature"; boundary="------------enigE32A1D029B96A8DF3A0D7EFA"
X-SA-Exim-Connect-IP: 130.129.103.203
X-SA-Exim-Rcpt-To: smb@cs.columbia.edu, ole@cisco.com, mehmet.ersue@nsn.com, rsag@rfc-editor.org, rsoc@iab.org, ietf@ietf.org, hlflanagan@gmail.com, 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: Ole Jacobsen <ole@cisco.com>, The IETF <ietf@ietf.org>, RSOC <rsoc@iab.org>, Heather Flanagan <hlflanagan@gmail.com>, rsag@rfc-editor.org
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:58:44 -0000

On 2012-07-31 14:35 Steven Bellovin said the following:
> There are a number of very weird entries that require special
> handling. I (also) wrote a Python script to convert the XML file to
> bibtex and had to deal with a number of these special cases. For
> example, RFC 4534 lists the authors as "A Colegrove, H Harney"
> instead of "A. Colegrove, H. Harney". Other names like "The Internet
> Society" require special handling. And I completely punted on proper
> capitalization of the titles; I just accept what's there.

Ah.  I'll have to look at fixing cases like the ones you mention, then.

Thanks!

	Henrik

> 
> On Jul 31, 2012, at 2:23 PM, Ole Jacobsen wrote:
> 
>> 
>> Mehmet,
>> 
>> The tool is not INTENDED to change the author order. A somewhat 
>> incomplete database can indeed lead to unexpected results, use with 
>> caution.
>> 
>> 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
>> 
>> 
>> On Tue, 31 Jul 2012, Ersue, Mehmet (NSN - DE/Munich) wrote:
>> 
>>> 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.
>>> 
>>> Some of the citations appear to be incomplete, see RFC3410.
>>> 
>>> 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
>>> 
>>> 
>> 
> 
> 
> 		--Steve Bellovin, https://www.cs.columbia.edu/~smb
> 
> 
> 
> 
> 
>