From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id eLHzFPyGl1/cCwAA0tVLHw (envelope-from ) for ; Tue, 27 Oct 2020 02:33:32 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id IEzEEPyGl18TMgAA1q6Kng (envelope-from ) for ; Tue, 27 Oct 2020 02:33:32 +0000 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 B463B940430 for ; Tue, 27 Oct 2020 02:33:31 +0000 (UTC) Received: from localhost ([::1]:47672 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kXEni-00008r-0T for larch@yhetil.org; Mon, 26 Oct 2020 22:33:30 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:36910) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kXEnC-00008f-FX for emacs-orgmode@gnu.org; Mon, 26 Oct 2020 22:32:58 -0400 Received: from mail-qt1-x82b.google.com ([2607:f8b0:4864:20::82b]:36453) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kXEnA-0005QC-9o for emacs-orgmode@gnu.org; Mon, 26 Oct 2020 22:32:58 -0400 Received: by mail-qt1-x82b.google.com with SMTP id c5so38971qtw.3 for ; Mon, 26 Oct 2020 19:32:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:user-agent:from:to:subject:message-id:date:mime-version :content-transfer-encoding; bh=qAov1b28t/upiFj7fJPL5DT1z/V8uVaTsOyfK3qCLUs=; b=oj5xUVxc+qrMVWhxsouS0DCr2GmMwoeG2GLKWnNDIbG4w4m8nLOLTzEs1781+/tK/n LF872wd8O/bew2eZ6HbSuoqG0x+ToarV2gpO+iQUY0vd3GmjIkaKVV3lL93IBVEXeMKv h5LxbBAfcjDtGIXmndoKPW0j2/rrlENiIjCb9/fT35WD9RXk07GQrF8YwGwtU1/R6I9w yUcdAD82lsXFEIgTMh7DwC6rzbI/ZyxtuVjCouRkO5z121/AFGEpX99D1qWLjnELQ8Hf 8JBBZxK88l4Qv3VnIZ8ij923UHQPAtsEsznzd/5XJf+4It0O/ogqKgdHK1uCNL0r77Nw wM6Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:user-agent:from:to:subject:message-id :date:mime-version:content-transfer-encoding; bh=qAov1b28t/upiFj7fJPL5DT1z/V8uVaTsOyfK3qCLUs=; b=s8P4plVoSMKQHUs1D5PuJir6EiJPN7aC0LtkXvH5zrMVUDOdRHajfmfNG3pbyqGQZY cj2QqrhPNd/E+7/BnUjdqOn2fkHCnTxD0rLuJt+MaNfnknaMXg66GaDlE7y1zdzP8YA5 XS1zYz8Idz9DTs1U+BQlsYDr/d73i8z8sfKcDuJI2UhnXU2dXxVFAfCgMNemJPQLxtq2 4QkimjKB4uJMd4WCVknxs+yvTfZUMViFP4rpbuHD7sHzjjK1kQHNk1v60rvsWEqmZlHK ryjljff2rwC351VN7wnCP2huouShPOmc2GWXRHArluGurwcPyz0StibIejhJAeODoauD mQHA== X-Gm-Message-State: AOAM5325OqxjvldM9H8YKbVb8xUH4hCvWqlztFKIJqqZAZI3Z67Iwg+q iLrRV4YTI37zTSeSiQIAX925e+h+pRryhA== X-Google-Smtp-Source: ABdhPJzoSPTgGhh1qBWI2tMLIk6jNL+NJplBoygLZ60HZar5CvpolTpuVV4mRAGMcC6Te+5xvKfvIg== X-Received: by 2002:ac8:67ca:: with SMTP id r10mr144834qtp.44.1603765975139; Mon, 26 Oct 2020 19:32:55 -0700 (PDT) Received: from gusbrs-laptop (189.27.5.61.dynamic.adsl.gvt.net.br. [189.27.5.61]) by smtp.gmail.com with ESMTPSA id p38sm77135qtb.20.2020.10.26.19.32.53 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 26 Oct 2020 19:32:54 -0700 (PDT) User-agent: mu4e 1.4.13; emacs 27.1 From: Gustavo Barros To: emacs-orgmode@gnu.org Subject: Documentation suggestion: Mention async-bytecomp-package-mode in the installation section of the manual Message-ID: <87ft60l7or.fsf@gmail.com> Date: Mon, 26 Oct 2020 23:32:52 -0300 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::82b; envelope-from=gusbrs.2016@gmail.com; helo=mail-qt1-x82b.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 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 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.23 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-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=fail (rsa verify failed) header.d=gmail.com header.s=20161025 header.b=oj5xUVxc; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Spam-Score: 0.09 X-TUID: +DHQ0vyvQ1LO Hi All, I've seen time and again folks get bitten by trying to install Org with=20 `package.el' while having Org loaded. The latest, but certainly not the=20 first and not the last:=20 https://www.reddit.com/r/orgmode/comments/jicj1k/how_to_use_org_version_fro= m_orgpluscontrib/ This is well known, and indeed the manual states "important" in bold to=20 say that "You need to do this in a session where no =E2=80=98.org=E2=80=99 = file has been=20 visited, i.e., where no Org built-in function have been loaded." But it is not always easy to ensure that, even when you know what you=20 are doing. And certainly not trivial to users less acquainted with the=20 package system and how library loading works, etc. However, there is a very easy way to ensure that=20 installation/byte-compilation is done in a clean environment in package=20 `async', namely `async-bytecomp-package-mode'. From my experience, I=20 have a simple: (use-package async-bytecomp :ensure async :defer t :custom (async-bytecomp-allowed-packages 'all) (async-bytecomp-package-mode t)) in my init file. My `initial-major-mode' is `org-mode' and I've never=20 had an installation problem, even though I update `org-plus-contrib'=20 carelessly at will on a live session. `async' is by John Wiegley, and available both at ELPA and MELPA. Wouldn't it be worth mentioning it in the manual and/or in the=20 site/Worg? Best regards, Gustavo.