RE: RFC and I-D Citation Tool

Ole Jacobsen <ole@cisco.com> Tue, 31 July 2012 21:23 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 7CD4721F8681 for <ietf@ietfa.amsl.com>; Tue, 31 Jul 2012 14:23:02 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -110.488
X-Spam-Level:
X-Spam-Status: No, score=-110.488 tagged_above=-999 required=5 tests=[AWL=0.111, 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 QvGw8L0gL4Ev for <ietf@ietfa.amsl.com>; Tue, 31 Jul 2012 14:23:01 -0700 (PDT)
Received: from mtv-iport-2.cisco.com (mtv-iport-2.cisco.com [173.36.130.13]) by ietfa.amsl.com (Postfix) with ESMTP id 06A0B21F8644 for <ietf@ietf.org>; Tue, 31 Jul 2012 14:23:00 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=ole@cisco.com; l=2644; q=dns/txt; s=iport; t=1343769780; x=1344979380; h=date:from:reply-to:to:cc:subject:in-reply-to:message-id: references:mime-version; bh=jKlEtUQcZGw/VhL67EN6EWcK6sCEecPCfNcSh5RIcN8=; b=CREoA1JdQ8DKFYPIn17Tl0WyzKpHvTW65rogZyxY/mCXFUuOmAyCufdW BGeWRKWIctoxe1bO0hlGlPkd//b2D5nMwn1kuiD3nau7irW0Un+Kc4Ko2 okK2G4C0p36d4b0v0B1L/+EIbt4OQO7OrEqf9z/StuCS90Obz8VXEUKsQ k=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: Av4EAN5LGFCrRDoH/2dsb2JhbABCA7l7gQeCIAEBAQMBEgECJT8FBwQLEQQBASgHRgkIBhMih2UFDJtbg0gQnQ2LSRqDToMhA4hNjg6ER4UygxqBBGKCf4E/
X-IronPort-AV: E=Sophos;i="4.77,689,1336348800"; d="scan'208";a="53682507"
Received: from mtv-core-2.cisco.com ([171.68.58.7]) by mtv-iport-2.cisco.com with ESMTP; 31 Jul 2012 21:22:58 +0000
Received: from [10.27.1.132] (sjc-ole-8913.cisco.com [10.27.1.132]) by mtv-core-2.cisco.com (8.14.5/8.14.5) with ESMTP id q6VLMwfk017675; Tue, 31 Jul 2012 21:22:58 GMT
Date: Tue, 31 Jul 2012 14:23:01 -0700
From: Ole Jacobsen <ole@cisco.com>
To: "Ersue, Mehmet (NSN - DE/Munich)" <mehmet.ersue@nsn.com>
Subject: RE: RFC and I-D Citation Tool
In-Reply-To: <80A0822C5E9A4440A5117C2F4CD36A6404136619@DEMUEXC006.nsn-intra.net>
Message-ID: <alpine.OSX.2.01.1207311421270.87763@173-11-110-132-sfba.hfc.comcastbusiness.net>
References: <alpine.OSX.2.01.1207311102470.86865@173-11-110-132-sfba.hfc.comcastbusiness.net> <80A0822C5E9A4440A5117C2F4CD36A6404136619@DEMUEXC006.nsn-intra.net>
User-Agent: Alpine 2.01 (OSX 1266 2009-07-14)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset="US-ASCII"
Cc: rsag@rfc-editor.org, Henrik Levkowetz <henrik@levkowetz.com>, RSOC <rsoc@iab.org>, The IETF <ietf@ietf.org>, Heather Flanagan <hlflanagan@gmail.com>
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 21:23:02 -0000

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
> 
>