RFC and I-D Citation Tool

Ole Jacobsen <ole@cisco.com> Tue, 31 July 2012 18:16 UTC

Return-Path: <ole@cisco.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 5C9B321F88DA for <ietf@ietfa.amsl.com>; Tue, 31 Jul 2012 11:16:31 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -110.471
X-Spam-Level:
X-Spam-Status: No, score=-110.471 tagged_above=-999 required=5 tests=[AWL=0.128, BAYES_00=-2.599, RCVD_IN_DNSWL_HI=-8, 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 uPd8HYHW9hFr for <ietf@ietfa.amsl.com>; Tue, 31 Jul 2012 11:16:30 -0700 (PDT)
Received: from mtv-iport-4.cisco.com (mtv-iport-4.cisco.com [173.36.130.15]) by ietfa.amsl.com (Postfix) with ESMTP id 64DD321F88A2 for <ietf@ietf.org>; Tue, 31 Jul 2012 11:16:30 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=ole@cisco.com; l=1475; q=dns/txt; s=iport; t=1343758590; x=1344968190; h=date:from:reply-to:to:cc:subject:message-id:mime-version; bh=UBLR7ac0hOrFEbDgwv1uOhIKxALFXJZp6pwMrSPl5MQ=; b=Y6q40ll06o+FEWh1yR2ZP4loI3LzZtjm9g7nvB74/jqdmgJ5uw+JV/kZ wWYBm5JxsZBMgLDX4UE25MdGUON1CU/aNqwvcJto4/0ErV6EyCmL/YT+u iGJPcznNsMdLZzT5ZfNkVl9GVmPXmby3LiIfW7Mpy92IjJfnzMCX3C2HR Y=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: Av0EAE4gGFCrRDoG/2dsb2JhbABCA7l6gQeCOQECJT+BPhMih2oMnAKDSBCBTptNi2ODToMhA4hNjg6ER4UygxqBBGKCf4E/
X-IronPort-AV: E=Sophos;i="4.77,688,1336348800"; d="scan'208";a="53587708"
Received: from mtv-core-1.cisco.com ([171.68.58.6]) by mtv-iport-4.cisco.com with ESMTP; 31 Jul 2012 18:16:30 +0000
Received: from [10.27.1.132] (sjc-ole-8913.cisco.com [10.27.1.132]) by mtv-core-1.cisco.com (8.14.5/8.14.5) with ESMTP id q6VIGTHK021774; Tue, 31 Jul 2012 18:16:29 GMT
Date: Tue, 31 Jul 2012 11:16:33 -0700
From: Ole Jacobsen <ole@cisco.com>
To: The IETF <ietf@ietf.org>
Subject: RFC and I-D Citation Tool
Message-ID: <alpine.OSX.2.01.1207311102470.86865@173-11-110-132-sfba.hfc.comcastbusiness.net>
User-Agent: Alpine 2.01 (OSX 1266 2009-07-14)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset="US-ASCII"
Cc: 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
Reply-To: Ole Jacobsen <ole@cisco.com>
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 18:16:31 -0000

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