From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id aPtmF50WMGNVrAAAbAwnHQ (envelope-from ) for ; Sun, 25 Sep 2022 10:51:41 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id OBZPF50WMGMJKwEAauVa8A (envelope-from ) for ; Sun, 25 Sep 2022 10:51:41 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 1EC132984D for ; Sun, 25 Sep 2022 10:51:41 +0200 (CEST) Received: from localhost ([::1]:42252 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ocNMS-0000PJ-94 for larch@yhetil.org; Sun, 25 Sep 2022 04:51:40 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50144) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocNKZ-0000O4-UN for emacs-orgmode@gnu.org; Sun, 25 Sep 2022 04:49:52 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:39296) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocNKX-0000J9-Lv; Sun, 25 Sep 2022 04:49:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=6TKYyNebmO2uJBJHE4srVbzwipKt4bi/s94gxMV2itM=; b=X/acf8RXAhZcS5D/PkfM G71CYon6rpAAo0RlYJz0PpMmtoQm428uePX57YnaNtobjpb8/OcKoqpOC06U03q59i2eXa92XxSwa LhZ1Bq1yUCAPdmnjvuy8dGOA76c9xi1tO4gojIqv9Czl48AIa5PbEQcmWqIa+toHat5PgPBJiyGzo a+IQxAqqvZjH6ui6ZuSKK4XWfORcRImmRt8QFkNS4+c7Cf2k+U3u70zAfhKhFlWJD/L95W5uJDcz1 wawsXoUMAXcMAKMVBxqz86cHR4J4IBBR6Yusp3+QW7HgUqwIpIkrZUf7Pllhg5y4Nd0GN227EneAL wrXjVcXlC4cU0w==; Received: from 96.52.140.77.rev.sfr.net ([77.140.52.96]:50760 helo=hal) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocNKT-0002Tl-BC; Sun, 25 Sep 2022 04:49:41 -0400 Received: by hal (Postfix, from userid 1000) id 7C5871E0409; Sun, 25 Sep 2022 10:49:35 +0200 (CEST) From: Bastien To: Ihor Radchenko Cc: Ypo , samologist@gmail.com, Org-mode Subject: Re: Numbered footnotes in the manual interfere with diff In-Reply-To: <877d1rsuza.fsf@localhost> (Ihor Radchenko's message of "Sun, 25 Sep 2022 16:45:29 +0800") Organization: GNU References: <87bksgpye7.fsf@localhost> <877d1rsuza.fsf@localhost> Date: Sun, 25 Sep 2022 10:49:35 +0200 Message-ID: <871qrzj0tc.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1664095901; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=6TKYyNebmO2uJBJHE4srVbzwipKt4bi/s94gxMV2itM=; b=S7680AnWhD/4aAMn0SauRkYEVrsxT+/ysUWgQOYM9gy+ALH9uQzB5uUjv4Z3/J4f7EUeUT x9BI2xSpKwqEjCMCCbMLFweKSlHe5FoSjeDgVWsgA71JkP8EE6JGjk3EMUoA8URMMn2oOW 6OWYzAB+LfWCasUwM+eIpvzXdoY0Unmcar6XOyRaCfwOnffMtuQQr5Nc+Ikw26aBoQSEdz tusDOCiomtHrM9Rd9dxyKe19BXo2sG28ccxFuaM9aEhnfMXIq2lPTnEzioT944jQ+aAaOs M9rCPVtV/vcJyBgGXX30qunh4o6iUw49kjEbi4gkhVYzECtYyqiabBaHEO0m9Q== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1664095901; a=rsa-sha256; cv=none; b=Y9Ev5Jq+br2X3io3RMDb4TSTYYQm1xGsGA5iAWsDecHxupDgr1ajvO8V27rh+xw6bgIH0E xPXDYuPhVfc1DBbx4BcDQaGNYxXPbQc8MT3bqpMUNXEw9pufH+mBGxFyRfCzDfIz4rLmM4 DuhXoe22DfiTUoe2Xy7OmHKH0EOy504V39u2PjQlwQwuMWO0rRsUKh40nEPcui+QWHqw+F Wc/fZfax89W9PmzQ4uS35Yc+mVW+aS8tvMKFZySRuqqdtyxaHnBYdwMdEqVEVL7oiIas2l BzrC8xcE+fkpiVujLvG2ZM68oklTn576foQ4h0YU4811m3RELHsapzYxEUUlWw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gnu.org header.s=fencepost-gnu-org header.b="X/acf8RX"; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.55 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gnu.org header.s=fencepost-gnu-org header.b="X/acf8RX"; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 1EC132984D X-Spam-Score: -3.55 X-Migadu-Scanner: scn1.migadu.com X-TUID: gayfeASxOycB Ihor Radchenko writes: > Do you have any suggestion on how to deal with changing footnotes in the > manual? When I delete this footnote, all the footnotes must be > re-numbered creating a lot of garbage in the diff. Is it ok? Or should > we prefer inline footnote definitions in the manual to avoid such > situations? I propose to use inline footnotes for notes of one paragraph and to use regular footnotes for notes spanning over more than one paragraph. This will enhance both diffs readability and that of the manual's .org source. WDYT? -- Bastien