Re: RFC and I-D Citation Tool

[Steven Bellovin <[e-mail]>]

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.

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: [phone]   Mobile: [phone]
> E-mail: [e-mail]  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: [e-mail] [mailto:[e-mail]] On Behalf
>> Of ext Ole
>>> Jacobsen
>>> Sent: Tuesday, July 31, 2012 11:17 AM
>>> To: The IETF
>>> Cc: RSOC; Heather Flanagan; [e-mail]
>>> 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: [phone]   Mobile: [phone]
>>> E-mail: [e-mail]  URL: http://www.cisco.com/ipj
>>> Skype: organdemo
>> 
>> 
> 


		--Steve Bellovin, https://www.cs.columbia.edu/~smb