Re: [Tools-discuss] question on datatracker access to particular I-D version

Robert Sparks <rjsparks@nostrum.com> Sun, 19 July 2015 11:26 UTC

Return-Path: <rjsparks@nostrum.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0A26F1ACD0C for <tools-discuss@ietfa.amsl.com>; Sun, 19 Jul 2015 04:26:08 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.91
X-Spam-Level:
X-Spam-Status: No, score=-1.91 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01] autolearn=ham
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id TdF_F5684A7h for <tools-discuss@ietfa.amsl.com>; Sun, 19 Jul 2015 04:26:06 -0700 (PDT)
Received: from nostrum.com (raven-v6.nostrum.com [IPv6:2001:470:d:1130::1]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 136841ACCEC for <tools-discuss@ietf.org>; Sun, 19 Jul 2015 04:26:06 -0700 (PDT)
Received: from dhcp-b65f.meeting.ietf.org (dhcp-b65f.meeting.ietf.org [31.133.182.95]) (authenticated bits=0) by nostrum.com (8.15.2/8.14.9) with ESMTPSA id t6JBQ22X036363 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=OK) for <tools-discuss@ietf.org>; Sun, 19 Jul 2015 06:26:04 -0500 (CDT) (envelope-from rjsparks@nostrum.com)
Message-ID: <55AB8949.8050705@nostrum.com>
Date: Sun, 19 Jul 2015 13:26:01 +0200
From: Robert Sparks <rjsparks@nostrum.com>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10; rv:31.0) Gecko/20100101 Thunderbird/31.7.0
MIME-Version: 1.0
To: tools-discuss@ietf.org
References: <55AB80CF.2030307@att.com> <55AB85ED.90103@gmail.com>
In-Reply-To: <55AB85ED.90103@gmail.com>
Content-Type: text/plain; charset="windows-1252"; format="flowed"
Content-Transfer-Encoding: 7bit
Archived-At: <http://mailarchive.ietf.org/arch/msg/tools-discuss/iFsuWQZ8XFvEA5cPoU3tlGi7gVc>
Subject: Re: [Tools-discuss] question on datatracker access to particular I-D version
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 19 Jul 2015 11:26:08 -0000

Good find, Brian -

I'll find the right folks to look at what happens there.

(Specifically, referencing
https://www.ietf.org/id/draft-hansen-rfc-use-of-pdf-02.txt
results in a redirect to
http://www.ietf.org/id/draft-hansen-rfc-use-of-pdf-07.txt
which has more than one problem.)

As you note the
/doc/(doc-name)/(version-number) form is what Tony is looking for at the 
datatracker.

RjS




On 7/19/15 1:11 PM, Brian E Carpenter wrote:
> It seems to me that there's a bug.
>
> Go to https://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf/02/
>
> The links for html and pdf formats bring up the -02 version, as expected.
> The link for txt format brings up the latest version.
>
> Regards
>     Brian
>
>
> On 19/07/2015 22:49, Tony Hansen wrote:
>> I'm working on generating bibxml3 (bibxml for internet drafts) via
>> django and the datatracker database.
>>
>> Is there a way to pull up a >particular version< of an I-D on the
>> datatracker via the URL?
>>
>> That is, URLs such as
>>
>> http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf-02
>> http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf?version=02
>> http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf-02.txt
>> http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf/02
>>
>> as opposed to
>>
>> http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf
>>
>> which pulls up the final document and lets you get at the earlier
>> versions after additional clicks.
>>
>>
>>      Tony Hansen
>>
>> Full discussion:
>>
>> I'm also looking at the possibility of making an update to remove the
>> <format> entries and replacing them with a target on the <reference>
>> element.
>>
>> I had *thought* that I could do this using a reference to the
>> datatracker copy of the internet drafts. But there is an issue.
>>
>> For each internet draft, e.g. draft-ietf-example-foo-*, there are at
>> least two entries:
>>
>>      reference.I-D.draft-ietf-example-foo-00.xml
>>      reference.I-D.ietf-example-foo.xml
>>
>> That is, there is a specific entry for each version of the document with
>> the complete name of the document and version, PLUS a single entry for
>> the document >series< that does not have any version number or the
>> leading "draft-" prefix. This last entry is updated whenever a new
>> version is created
>>
>> Picking a draft at random, and doing an ls -l on its variants shows this:
>>
>> -r--r--r-- 1 tony tony      986 Jun 26  2014
>> reference.I-D.draft-hansen-rfc-use-of-pdf-00.xml
>> -r--r--r-- 1 tony tony     1096 Jul 21  2014
>> reference.I-D.draft-hansen-rfc-use-of-pdf-01.xml
>> -r--r--r-- 1 tony tony     1089 Jul 22  2014
>> reference.I-D.draft-hansen-rfc-use-of-pdf-02.xml
>> -r--r--r-- 1 tony tony      982 Oct 27  2014
>> reference.I-D.draft-hansen-rfc-use-of-pdf-03.xml
>> -r--r--r-- 1 tony tony      982 Jan 23 00:00
>> reference.I-D.draft-hansen-rfc-use-of-pdf-04.xml
>> -r--r--r-- 1 tony tony      983 Feb 17 00:00
>> reference.I-D.draft-hansen-rfc-use-of-pdf-05.xml
>> -r--r--r-- 1 tony tony     1089 Mar  9 00:00
>> reference.I-D.draft-hansen-rfc-use-of-pdf-06.xml
>> -r--r--r-- 1 tony tony     1090 Mar 25 00:00
>> reference.I-D.draft-hansen-rfc-use-of-pdf-07.xml
>>
>> -r--r--r-- 1 tony tony     1090 Mar 25 00:00
>> reference.I-D.hansen-rfc-use-of-pdf.xml
>>
>>
>> Currently the document series entry is always identical to the
>> largest-numbered entry.
>>
>>
>> The relevant bits of one of these files (-02) for this discussion are:
>>
>> <reference anchor='I-D.hansen-rfc-use-of-pdf'>
>>      <seriesInfo name='Internet-Draft'
>> value='draft-hansen-rfc-use-of-pdf-02' />
>>      <format type='TXT'
>> target='http://www.ietf.org/internet-drafts/draft-hansen-rfc-use-of-pdf-02.txt'
>> />
>> </reference>
>>
>> I could certainly do a direct move of the existing target so that we get
>>
>> <reference anchor='I-D.hansen-rfc-use-of-pdf'
>> target='http://www.ietf.org/internet-drafts/draft-hansen-rfc-use-of-pdf-02.txt'>
>>      <seriesInfo name='Internet-Draft'
>> value='draft-hansen-rfc-use-of-pdf-02' />
>> </reference>
>>
>> But that doesn't use the datatracker like I wanted.
>>
>> I could make the document series entry different from the
>> individual-document entry, as in:
>>
>> <reference anchor='I-D.hansen-rfc-use-of-pdf'
>> target='http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf'>
>>      <seriesInfo name='Internet-Draft'
>> value='draft-hansen-rfc-use-of-pdf-07' />
>> </reference>
>>
>>
>>
>> But I don't know of any way to pull up a particular version of the I-D
>> on the datatracker via the command line. That is, URLs such as
>>
>> http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf-02
>> http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf-02.txt
>> http://datatracker.ietf.org/doc/draft-hansen-rfc-use-of-pdf/02
>>
>> So, unless I can find a way to reference the individual version of a
>> document on the datatracker, the individual-document entries would need
>> to continue using the www.ietf.org/internet-drafts URL instead of a
>> datatracker URL.
>>