From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id OLCyHjB7bmZiRQAAqHPOHw:P1 (envelope-from ) for ; Sun, 16 Jun 2024 05:42:08 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id OLCyHjB7bmZiRQAAqHPOHw (envelope-from ) for ; Sun, 16 Jun 2024 07:42:08 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=DGezPIv5; dmarc=pass (policy=none) header.from=gmail.com; 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" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1718516528; a=rsa-sha256; cv=none; b=TnIar1QpF47VgcbuBnuF3XXLzwvYMcstrw2K0BQRb7JqMr3eDt66B7JYdGv7n1boO7kvkR 3bH3cEMTRE5kQq0kMiR4dOdS8B5yw3yX25d4kHnWRXPZoi6Z7MLDP3x1EgTbAximEyQLgp ANZuPe5Eg0J++kd3WUczuqiOSfNdVni3tjGMRqokhqOq/F0pz0I34iRgPI+s5i+7FxXuox ssSe3eQMk3j/f7Z6qNFWYVMuOVapSYZWvwO6evk2OVAmHeYcwZ9KWrYAUKLD4PcGaEB0+R 0jfY+k5apqhI8fpYq8XFxL5rD8GybEDMHLJjomtJsVg8tRIuofx0SQXsboklAQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=DGezPIv5; dmarc=pass (policy=none) header.from=gmail.com; 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" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1718516528; 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=zDQ+AzOWrI8H+b4CjTzb2dRoxsMeWYi2ihY5tfLU95s=; b=RUNYVFMBSDwePWueP5XTPZafXOSsGZs9Z07YFGCALNmzZREDbzaohXL/IPOp4FrJSw/0L3 0s7kV/XVIlvZQAiUFUkKNJKq46jsrzRR1Kv2j0lVXbYjh/QVkMv6xh92pbVNG+5MEvfT9e jv3mquaD+DWCs1hGUhKnw3vl2vfQ5Nz/qMFTWQ59MyFJwEM41GTd5rkeAS8f016Aylevvi I0gsQHJA61qy+KE8OLTPIY9lVdA4BD/qNVfNH5JBSxWTBTfeuEDiu5nTAv5lBCvmSw7p67 NhEMXoJPA7XOUD+6Z6B8lmnIDh/r34iUhDD8pavEyio8Ts6nHnRGTKtqkmw/Hw== 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 4143A6F936 for ; Sun, 16 Jun 2024 07:42:07 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sIidh-0000aG-4a; Sun, 16 Jun 2024 01:41:17 -0400 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 1sIidf-0000Zq-Ll for emacs-orgmode@gnu.org; Sun, 16 Jun 2024 01:41:15 -0400 Received: from mail-vk1-xa36.google.com ([2607:f8b0:4864:20::a36]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sIide-0004qQ-0u; Sun, 16 Jun 2024 01:41:15 -0400 Received: by mail-vk1-xa36.google.com with SMTP id 71dfb90a1353d-4ecf4100d9dso1919038e0c.1; Sat, 15 Jun 2024 22:41:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1718516473; x=1719121273; darn=gnu.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=zDQ+AzOWrI8H+b4CjTzb2dRoxsMeWYi2ihY5tfLU95s=; b=DGezPIv5w2/Tkm0BRF5EauXDDeN1wUIvzCsLc0BBZYKphQOluWRO3OXH9Som4oXjJG Ej6hg6VqZmEXQsztcDbSDRfBMADmOXzVR/oCAjtamtPBLMiaw1UAWf/rGM1KDUWOpmTR g7u9ir4gGGtP3OJFf/RFbFpX+8K38WCqozF3ODZVrQyNqKX+6dfqJwVg6pXabrcfKBPK sGjOiJisl9LfOqFmmb+jARX3TjV8hsqdL5tBLl4qeQN3Ycp8Or16ajTEckpEYhPMKnpA yR7crP2TQcOwIRGOmLAtvTaxCIloufUXb5mOIVGlmfXmKAVw5nUwDi8V+gK/lNg0rJaN D1Bg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1718516473; x=1719121273; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=zDQ+AzOWrI8H+b4CjTzb2dRoxsMeWYi2ihY5tfLU95s=; b=lcSwiO1aTTXQkWK1mXY8CPh3imUWrgANWV3LOaQbn3HLZQ9wI5FrDFy+bahBsYOFp7 3JdLWxRj9EeFhLKBEBHdFJOrnEAIDqCf582c1MRaZFZDRK/dRATbn6YLz3gWnfyIMUL7 3ADgpiUKr6v0DW4fthYCWcH5OuAXm08Za5fJPqqg8thedssMREWY3JQAsmiRl9GY+/mp dG1hDOcUP7/uT/djKKND9ZR1D+zmYD1WwEMCjpni5oXf57QEaYoWpVySZgxuREtT6QtW wqW1DZr8IDJDIxdp/XQO7U3SQN0oyzYcBPP7hMZ6JewFLJOJnPZzvRzR6mOGEj6m18Cj xQHw== X-Forwarded-Encrypted: i=1; AJvYcCUH24VC+9M9gqGkx+mNH2+l9hJEp9fGuIU8SM9W2/HhTV9WIPI93tVg7JeMlrb6HewJWT4ls56w94iwT6bNMXXTNGLIJOk= X-Gm-Message-State: AOJu0YxVrB1OlI1/mFp/ZiQb5cR7LMNsswn0a0jyOokLzmiTFgAU2ioE 9tE2gH+J490hrkPv4OoyRF7RoPVSmNlJlXg0yq3kWDN+erEp27kTFeeavSzt1oG9XFu/S0zElJq kjWp/DchxP5unsuoCQgldgpl8V3Y= X-Google-Smtp-Source: AGHT+IHDaodEXZv9HVTK2oT49jXmx6QVcHoYA/jiA0UM3KaEFp5VvGP/yw6zaMb/wQ9msH9wULuTiyIkKegAf+olHMo= X-Received: by 2002:a05:6122:4586:b0:4e4:e749:32a2 with SMTP id 71dfb90a1353d-4ee4032fe5dmr4720525e0c.7.1718516472675; Sat, 15 Jun 2024 22:41:12 -0700 (PDT) MIME-Version: 1.0 References: <86ed921oxu.fsf@gnu.org> <874j9vllbp.fsf@localhost> In-Reply-To: <874j9vllbp.fsf@localhost> From: Daniel Clemente Date: Sun, 16 Jun 2024 05:40:46 +0000 Message-ID: Subject: Re: Please document the caching and its user options To: Ihor Radchenko Cc: Eli Zaretskii , emacs-orgmode@gnu.org Content-Type: text/plain; charset="UTF-8" Received-SPF: pass client-ip=2607:f8b0:4864:20::a36; envelope-from=n142857@gmail.com; helo=mail-vk1-xa36.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 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_ENVFROM_END_DIGIT=0.25, 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-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-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -9.69 X-Migadu-Scanner: mx12.migadu.com X-Spam-Score: -9.69 X-Migadu-Queue-Id: 4143A6F936 X-TUID: +qUcRvIQY6XO > > Please document the caching features of Org in the manual, including > > how to turn that off. (I also question the wisdom of turning this on > > by default without as much as a single request for confirmation from > > the user.) > Hmm. What aspect of caching do you want us to document? > FYI, Org mode has been doing various forms of caching since > forever. Recently, we just employed a bit more regular API and > introduced one more kind of caching - parser cache. In addition to the > previously existing image cache, publishing cache, ID cache, clock > cache, etc. One of the discussion points is specifically org-persist, which is what creates files on disk. There have been reports, like https://lists.gnu.org/archive/html/emacs-devel/2024-06/msg00203.html, or Eli's message here, mentioning that ~/.cache/org-persist is created when the user doesn't want it or expect it. In particular, when setting (setq org-element-cache-persistent nil) org-mode *should not* create an org-persist directory anywhere. And I think it shouldn't activate org-persist timers (it does now) or hooks. The user's preference should be respected. That's a code change. If you just want to update documentation, a starting point can be org-element-cache-persistent's documentation, which is just "Non-nil when cache should persist between Emacs sessions.", and doesn't mention that some files will always be created even if it's nil. It also doesn't explicitly mention that it will create files (better be explicit about this), or where (or how to control where), or which content (i.e. just statistics, or parts of possible private org files). I suggest making an explicit difference between "caching in memory" and "caching by storing files on disk". For instance: (defvar org-element-use-cache t "Non-nil when Org parser should cache its results.") >From that description, it's not clear to a new user whether they're creating files on disk (as caches often do) or not.