Re: [Tools-discuss] The Document Citation Tool is (somewhat) broken

Brian E Carpenter <brian.e.carpenter@gmail.com> Mon, 28 June 2021 21:55 UTC

Return-Path: <brian.e.carpenter@gmail.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 040393A15F0; Mon, 28 Jun 2021 14:55:27 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.435
X-Spam-Level:
X-Spam-Status: No, score=-2.435 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, NICE_REPLY_A=-0.338, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
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 AF_Z2-jk10VV; Mon, 28 Jun 2021 14:55:22 -0700 (PDT)
Received: from mail-pg1-x52e.google.com (mail-pg1-x52e.google.com [IPv6:2607:f8b0:4864:20::52e]) (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 065F03A15F2; Mon, 28 Jun 2021 14:55:21 -0700 (PDT)
Received: by mail-pg1-x52e.google.com with SMTP id 80so907331pgg.10; Mon, 28 Jun 2021 14:55:21 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=DbEf5Sio4f71qWhkr2AaJzctP6RYDtQbX4i2m4G6GCE=; b=vb7iaVM2T8I7OmCGTVCdUJSd2VkN9fkqrxWGdWVYR7nFzMF6/72md4FFJBZ4Z5yYAU fC9681SLYdN/FRhneEoIR52sNqVn/1KI0KAvxS5wax3WUiEw33e7ig1oDlvAjmRfEpa0 dpGnL+5DSZrln21YrirLNMhyjUeTJnv9dspSjKqTEbqkx7xT8Wc2p9iIdHXfyGJ12H9R WgqLU0VfE/LUM9kcY2c/a/khGkbgFKXb6mJxBdQj9vjYH354jdC05RpszSVRF/Gra99Z 5qExs9QQlAR1CNUfT4ZcXzJOC9kR1UYp2q9CTEnxWkqyttbVp0e+hfEH8MWD7B6wMCV/ I+OQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=DbEf5Sio4f71qWhkr2AaJzctP6RYDtQbX4i2m4G6GCE=; b=eiDc4uLWwHmp/iPCLv+xA9QRYTF4MktbO85S65zvukeh3PNd+iF1s6D10ZCiAkCSw1 e7p1AOlxrLmev+2Xu1hoeVs82i8L/VGigH55SsyIlNdXRVA3Z9acAfNR2MyrOd4eqz3D uSAo+3yzZQkvBRSLMNJeup5bIdxrzsu4LWAk8xYeFqRpNBtb4U4GvLs/BvOKHhTiDC9M isFPBzE/41cDKmpnL/t4FwUzvda4AQqAbUiHC5/ymXSlW9MoLCDHGV9rbm/kJj7KDqPx 3qy2mpjMxXlfeREMmVYzusuq1zwWd2/9l2R5u9L5axkCkk3jenIty3xn/7qMFLxLu0KJ Yy/A==
X-Gm-Message-State: AOAM532JhDwbSFLn2cSoyipOVl9KqDuFefQ2PES+/RSJY7SRwleufuCC m14/z6hbIF/XENCkfjIS6Ynp9RaFb08x/A==
X-Google-Smtp-Source: ABdhPJypDYuj50RHqu3rBMnsFUkBZBbBL1p2sL8kkKwxQpOnXj6KtG1U6oft+KHoAHEvzUXA0yoSmA==
X-Received: by 2002:a63:1601:: with SMTP id w1mr24963320pgl.116.1624917320884; Mon, 28 Jun 2021 14:55:20 -0700 (PDT)
Received: from ?IPv6:2406:e003:100d:901:80b2:5c79:2266:e431? ([2406:e003:100d:901:80b2:5c79:2266:e431]) by smtp.gmail.com with ESMTPSA id p3sm558957pjt.0.2021.06.28.14.55.18 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 28 Jun 2021 14:55:20 -0700 (PDT)
To: Ole Jacobsen <olejacobsen=40me.com@dmarc.ietf.org>, Jay Daley <jay@ietf.org>
Cc: Ole Jacobsen <olejacobsen@me.com>, Tools Discussion <tools-discuss@ietf.org>
References: <1391A159-DD66-413D-BD49-F18056583BE5@me.com> <04FA17DA-3A85-422B-B181-F88D278A1135@ietf.org> <88A5738C-CB33-49E4-9B3D-FE64B69651D3@me.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <71c62a48-f2b3-1058-bab9-da72923ccb76@gmail.com>
Date: Tue, 29 Jun 2021 09:55:15 +1200
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.10.0
MIME-Version: 1.0
In-Reply-To: <88A5738C-CB33-49E4-9B3D-FE64B69651D3@me.com>
Content-Type: text/plain; charset="utf-8"
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/aUnhjZ_F6PJygQ46sbmOfVTXZ7o>
Subject: Re: [Tools-discuss] The Document Citation Tool is (somewhat) broken
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
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: Mon, 28 Jun 2021 21:55:27 -0000

Note that https://www.rfc-editor.org/info/rfc8990 offers "Cite this RFC: TXT  |  XML".

For LaTeX lovers, there are also .bib options around.

Regards
   Brian Carpenter

On 29-Jun-21 08:05, Ole Jacobsen wrote:
> Hi Jay,
> 
> I only use the two output options:
> 
> {authors.andlist}, "{doctitle}," {date:%B %Y}, {docname}.
> 
> and
> 
> {authors.rfclist}, "{doctitle}," {docname}, {date:%B %Y}.
> 
> ... although I usually set both the the first option {authors.andlist}
> and would be more than happy if that was the only option.
> 
> Thanks for looking into this!
> 
> And: In the interim, perhaps something changed "behind the scenes" that 
causes this
> problem that could be fixed?
> 
> Ole
> 
> 
>> On Jun 28, 2021, at 13:00, Jay Daley <jay@ietf.org> wrote:
>>
>> (moving discussion to tools-discuss)
>>
>> Ole
>>
>>> On 29/06/2021, at 6:36 AM, Ole Jacobsen <olejacobsen=40me.com@dmarc.ietf.org> wrote:
>>>
>>>
>>> Hi,
>>>
>>> Several years ago, Henrik set up this wonderful tool that creates citations for
>>> IETF documents (IDs and RFCs) in a standard format. The tool is customizable
>>> and lives here:
>>>
>>> https://tools.ietf.org/tools/citation/
>>>
>>> Enter, for example, "7575" in the box and you get:
>>>
>>> Clemm, A., Behringer, M., Jiang, S., Pritikin, M., Ciavaglia, L., Bjarnason, S., and B. Carpenter,
>>> "Autonomic Networking: Definitions and Design Goals," RFC 7575, June 2015.
>>>
>>> It's something I use often to get a consistent list of references in
>>> articles.
>>>
>>> But, sadly, something is currently broken with this tool, or I suspect something has
>>> changed in the back-end (datatracker or tools?) whereby recent RFCs are not recognized,
>>> for example: RFC 8890 gives me: "Could not find author data for document 'rfc8990'"
>>>
>>> And worse: RFC 8995 returns: "An error occurred at this point in the web-page generation.
>>> An error report has been sent to the webmaster. If this error isn't fixed within 48 hours,
>>> please contact the web page author directly at webmaster@tools.ietf.org."
>>>
>>> I know Henrik is probably no longer maintaining this tool so I am not 
blaming him
>>> or expecting him to fix it, but perhaps someone from the tools/datatracker group could
>>> take a look at this? It really is a VERY nice tool and I would hate to see it disabled
>>> forever.
>>>
>>> Thanks in advance!
>>
>> An RFP was recently awarded [1] for a replacement for the citation library generation and access (API and web page) tool. Unfortunately, when writing that RFP I didn’t know about this specific tool and so it is not listed as a deliverable.  However, it should be relatively straightforward to add simple output of this format, though a fully programmable 
output format is more complex and I’m not sure it is necessary.  Do you use that programmable output functionality?
>>
>> Jay
>>
>> [1] https://mailarchive.ietf.org/arch/msg/ietf-announce/XPvRg0vSCWUBaSxtX1jSVtsNb3I/
>>
>>>
>>> Ole
>>>
>>>
>>> Ole J. Jacobsen
>>> Editor and Publisher
>>> The Internet Protocol Journal
>>> Office: +1 415-550-9433
>>> Cell:   +1 415-370-4628
>>> Web: protocoljournal.org
>>> E-mail: olejacobsen@me.com
>>> E-mail: ole@protocoljournal.org
>>> Skype: organdemo
>>>
>>>
>>
>> -- 
>> Jay Daley
>> IETF Executive Director
>> jay@ietf.org
>>
> 
> Ole J. Jacobsen
> Editor and Publisher
> The Internet Protocol Journal
> Office: +1 415-550-9433
> Cell:   +1 415-370-4628
> Web: protocoljournal.org
> E-mail: olejacobsen@me.com
> E-mail: ole@protocoljournal.org
> Skype: organdemo
> 
> 
> 
> ___________________________________________________________
> Tools-discuss mailing list - Tools-discuss@ietf.org
> This list is for discussion, not for action requests or bug reports.
> * Report datatracker and mailarchive bugs to: datatracker-project@ietf.org
> * Report tools.ietf.org bugs to: webmaster@tools.ietf.org
> * Report all other bugs or issues to: ietf-action@ietf.org
> List info (including how to Unsubscribe): https://www.ietf.org/mailman/listinfo/tools-discuss
>