From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: master c86995d07e9: Enable code block evaluation when generating .org manuals Date: Sun, 9 Jun 2024 14:26:28 -0400 Message-ID: References: <171767737644.19678.784876979840850798@vcs2.savannah.gnu.org> <20240606123616.DE7C9C1F9EF@vcs2.savannah.gnu.org> <87h6e6i1mg.fsf@gmail.com> <87sexplbmn.fsf@kyleam.com> <874ja22e7t.fsf@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="8036"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Kyle Meyer , Robert Pluim , emacs-devel@gnu.org To: Ihor Radchenko Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 09 20:27:11 2024 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1sGNG3-0001qn-Pm for ged-emacs-devel@m.gmane-mx.org; Sun, 09 Jun 2024 20:27:11 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sGNFW-0004tx-OF; Sun, 09 Jun 2024 14:26:38 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sGNFR-0004rz-Lq for emacs-devel@gnu.org; Sun, 09 Jun 2024 14:26:36 -0400 Original-Received: from mail-ed1-x533.google.com ([2a00:1450:4864:20::533]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sGNFQ-0008O1-4x for emacs-devel@gnu.org; Sun, 09 Jun 2024 14:26:33 -0400 Original-Received: by mail-ed1-x533.google.com with SMTP id 4fb4d7f45d1cf-57c6d3e6606so1681845a12.0 for ; Sun, 09 Jun 2024 11:26:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1717957590; x=1718562390; darn=gnu.org; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=uZZXoBpOJVYm+XHVnL04/t6N9XMD/oIYMm9AY8G9LnY=; b=d0zywAxIxouIh1gjOujezSxMJOgeGCkU22ZXtyFJnpwEVfrdA4oCufylxChrl8rXJ8 X+nGkfBTTpWETvRG2/viZ9tIln+0ySPtHDvHbpJCNycl5f9XZdGD53qN2kRYPTrrUfm7 LP87Ou+JuIThApepDJCZmhPSQau3zoXrl8aOgmh1ovvcx5EBnHh6oMuCeb3JD+xYnAKm sGSNcML7Gn3vVdsZgh0rSOxPj/iChyAZzRVK3v9f7/cdR+40rNcVFyTlO64J80T+28wt 9fozyGXmWbCcKD5ujVv9LLmrkwr9tj8TEsnlj6hOJLadZgP9lMumz2+vwO/APIFwbNJB zlMg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1717957590; x=1718562390; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=uZZXoBpOJVYm+XHVnL04/t6N9XMD/oIYMm9AY8G9LnY=; b=UsivGVPafGnXD3qdjiN48ZubSOSkh+8Rx9kYS0kbQUDAKpRpeGsf6lm6WnVtGLNpkI h0rLcSwhWhmupcD24Zvw6ewml2/gyt4pm8Q3GV7NwjcLoFR7rgo3Er/RLOEWQXDuemIa +yctCmez/N0v1ZXhUFcVy654Oj8/b8f6eFruCSKK3P8+3+TE4/pTE92kI6XRYK7lF92H o8b8mWHmurKP7CY8P+ynZfybhOJVJshT8F0x1uoXalssSUP9+UFke3NC5P4QYencG68o 4ugCuDIekL2LKeyDYRqEY9lzPsjwgksXq64v5gI1cpeNWMQFDeQE59mNKUHPWsdDYm/o iILQ== X-Forwarded-Encrypted: i=1; AJvYcCW5uD0EqdmGv1Eyf8b0s0mYcj+0pvOZvMxhS7en2mKPwohm1FQY/WE4hZGIV59gsedE0DSMG33YrVKu4Sw4tiV37AFU X-Gm-Message-State: AOJu0YzCOHy9jA1ddewerSxqaf1Yg3+ZPpNAJmt+Vnp3Nee7fohiSgFv bAWVRwH8sISgBldxUP6iIB/h89Gx2L5UnXcKv211q+Mtf/Upgl9sn0xGNIeyjTer/CT58a7ZkCt igoAiE76OUsaQWrXZ2WwFjgi0p81dg26l X-Google-Smtp-Source: AGHT+IHOIxEhJ6+pUOz3Tr/42O8ctLS4f/mQzRGjvQ7bPVx2Da9XHdlCWNwbi5XtqWIu+vid5+1f0w/6sa0/m4hvP6I= X-Received: by 2002:a05:6402:3588:b0:57c:5c50:2ef9 with SMTP id 4fb4d7f45d1cf-57c5c5033bamr5277833a12.3.1717957590035; Sun, 09 Jun 2024 11:26:30 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 9 Jun 2024 14:26:28 -0400 In-Reply-To: <874ja22e7t.fsf@localhost> Received-SPF: pass client-ip=2a00:1450:4864:20::533; envelope-from=stefankangas@gmail.com; helo=mail-ed1-x533.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) 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, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:319934 Archived-At: Ihor Radchenko writes: > Stefan Kangas writes: > >> Kyle Meyer writes: >> >>> As mentioned by Ihor (+cc) in bug#71394, this change is needed before >>> syncing the latest Org release to the Emacs tree due to Org's 715148131 >>> (org-manual: Automatically generate export option list, 2023-07-31). >> >> Does it really need to generated automatically on every build, or can it >> be handled in some other way? For example, we pre-generate our loaddefs >> files and commit the result. > > Preferably, every build, I think. > > What we do in Org mode manual is examining an Elisp variable and build a > table summarizing its values. If that variable changes in the code, the > manual should reflect this change. Right, but the same is true for our loaddefs files (you want them up-to-date, or you get warnings, etc.), and even for them it's been enough to have a cronjob regenerate and commit them once per month. So I think my question still stands.