Re: Poll: RFCs with page numbers (pretty please) ?

Keith Moore <moore@network-heretics.com> Tue, 27 October 2020 17:44 UTC

Return-Path: <moore@network-heretics.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 497AE3A1274 for <ietf@ietfa.amsl.com>; Tue, 27 Oct 2020 10:44:41 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.146
X-Spam-Level:
X-Spam-Status: No, score=-2.146 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, NICE_REPLY_A=-0.247, RCVD_IN_MSPIKE_H2=-0.001, SPF_NONE=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=messagingengine.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 4syK75ZgG8jh for <ietf@ietfa.amsl.com>; Tue, 27 Oct 2020 10:44:39 -0700 (PDT)
Received: from wout5-smtp.messagingengine.com (wout5-smtp.messagingengine.com [64.147.123.21]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 82E853A1519 for <ietf@ietf.org>; Tue, 27 Oct 2020 10:43:46 -0700 (PDT)
Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.west.internal (Postfix) with ESMTP id CE2EAE9E for <ietf@ietf.org>; Tue, 27 Oct 2020 13:43:45 -0400 (EDT)
Received: from mailfrontend2 ([10.202.2.163]) by compute3.internal (MEProxy); Tue, 27 Oct 2020 13:43:45 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; bh=gxk3hLCiwVJ5xlC+SVrIYncaT0H/Tvj4cI+icVMdC I4=; b=Q6C3tBLDKCQEKNnuBoA/MvyLNC0/CN4UJWPxuWR4ZtbaeXcYpR08fzp1a BF199ZE2tcMxcZJKiZUjVzBrERz1DFPDVlLJMkc1sUfpLQQIl7QEZF3U5odCAkBW LORF7/lW2lqcfAZD64D4Pu+UUt3cX8CfvqzrhbNfGYJvOMoLOcSl9d83c+9WZoEW Hf2tEJYt+8y53BfFplYKD95zes17rhdfpz7ZVWAt5vAy2mu/uyahYqjCQkPlpk56 F6rTZO0sJK35JNeTG+txqJqoA4ErwF/CkuYNymWhOicQdhUmwd4XeDrkzkGg0VU5 zc+ILD12R5RkwolyG/EmQN1B04zPg==
X-ME-Sender: <xms:T1yYX91wQrBjviVDMlNl3RfUQBDB3kIySCNZ-MG_eIUSD0ndjW-i7g> <xme:T1yYX0G4YrcJMlaSxSKo_TqRzi3PcD7mCsJstVAeuVPQI8QXd2myVpoMJL1J-5OF4 GaVwDXvp-1FMQ>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedujedrkeelgddutdegucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefuvfhfhffkffgfgggjtgfgsehtke ertddtfeejnecuhfhrohhmpefmvghithhhucfoohhorhgvuceomhhoohhrvgesnhgvthif ohhrkhdqhhgvrhgvthhitghsrdgtohhmqeenucggtffrrghtthgvrhhnpeehhfeutdehfe fgfefghfekhefguefgieduueegjeekfeelleeuieffteefueduueenucfkphepuddtkedr vddvuddrudektddrudehnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrg hilhhfrhhomhepmhhoohhrvgesnhgvthifohhrkhdqhhgvrhgvthhitghsrdgtohhm
X-ME-Proxy: <xmx:T1yYX94x3_eTMrwbb9aJSIXfO6x6Wkcmhzadmbw_mjtGsyAKlpKIrg> <xmx:T1yYX60bYdLb8-YdYfGdqdM7ep2iEeMXyVUT5528KhmuArrcTy3aJg> <xmx:T1yYXwH79ZeGyl4YYWMyxLYosNUsW4eVk5x8AmE0YWL7_EbCMWCG8g> <xmx:UVyYX0G0oDnLkTK712_ZROTY9Xa2oPof6FxvrK7W9AU6M82N3sqM1Q>
Received: from [192.168.1.85] (108-221-180-15.lightspeed.knvltn.sbcglobal.net [108.221.180.15]) by mail.messagingengine.com (Postfix) with ESMTPA id A78853064684 for <ietf@ietf.org>; Tue, 27 Oct 2020 13:43:43 -0400 (EDT)
Subject: Re: Poll: RFCs with page numbers (pretty please) ?
To: ietf@ietf.org
References: <20201026020433.GA19475@faui48f.informatik.uni-erlangen.de> <CADaq8je8gMwAkOndTNJ9ndwzOZb2HQMZrCUJ5wNUjw-6ax9QtA@mail.gmail.com> <35EFE952-7786-4E24-B228-9BEE51D3C876@tzi.org> <20201026150241.GK48111@faui48f.informatik.uni-erlangen.de> <20201026162814.GP39170@kduck.mit.edu> <20201026164036.GO48111@faui48f.informatik.uni-erlangen.de> <1a56dc3b-56ef-3ffb-a12b-44d5e0d0f835@levkowetz.com> <20201026171931.GP48111@faui48f.informatik.uni-erlangen.de> <b733240-fc78-5a71-8920-ff84fbf64287@iecc.com> <20201026180105.GQ48111@faui48f.informatik.uni-erlangen.de>
From: Keith Moore <moore@network-heretics.com>
Message-ID: <a11ca0a2-94a0-921c-4c4d-0ffc951935b9@network-heretics.com>
Date: Tue, 27 Oct 2020 13:43:42 -0400
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0
MIME-Version: 1.0
In-Reply-To: <20201026180105.GQ48111@faui48f.informatik.uni-erlangen.de>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Transfer-Encoding: 8bit
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/RlCww-swbSDIasg65nWRIfpbBt8>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
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: <https://mailarchive.ietf.org/arch/browse/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, 27 Oct 2020 17:44:41 -0000

References to RFC text should be in terms of section numbers rather than 
page numbers.   However, that the current RFC page formatting (for PDF 
RFCs) isn't well designed for reading on paper, because page footers 
don't include section numbers.   Without such footers, it's harder to 
flip pages looking for the desired section.    So I would welcome 
changes to the RFC footers of paginated RFCs to include section numbers.

Section numbers aren't sufficient, however, if one needs to reorder 
pages from a printed RFC, because a section may span multiple pages.  So 
there is still a need for page numbers in paginated RFCs.

Also, not all sections in recent RFCs are numbered, and this is a 
problem if one wishes to reference an unnumbered section.   I suspect 
the fix here is to explicitly number/label every section, even 
Acknowledgments, appendices, etc.

One problem with having page numbers is that different paginated 
renderings of the same RFC will likely result in different pagination.   
But if there's only one paginated rendering of any RFC, as seems to be 
the case for newer RFCs at least, this is not a problem.

The currently official "plain text" RFCs are not paginated, but the PDF 
versions are paginated with page numbers.     This seems like a good 
compromise (even if it breaks some old scripts), because Windows systems 
have historically been too broken to properly print paginated plain text 
with formfeeds anyway, and because one of the uses of plain text RFCs 
has always been for automated free-text searching in which page breaks 
are a nuisance.

I would like it if HTML versions of RFCs were paginated when printed 
(with footers containing section numbers and page numbers, and with 
those page breaks and numbers aligned with other paginated versions of 
the same RFC.)    But I recognize that this would require significant 
tooling effort, and could occasionally produce very unsatisfactory 
results despite that effort.   It seems like the PDF version is 
sufficient for printing purposes, though it is not as easily found from 
the HTML version as it might be.   Adding a link to the PDF version at 
the top of the HTML version would IMO be a good idea.

Keith