From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id sU6SBxuHpmBYCQEAgWs5BA (envelope-from ) for ; Thu, 20 May 2021 17:58:19 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id aJK3AhuHpmCiUwAAB5/wlQ (envelope-from ) for ; Thu, 20 May 2021 15:58:19 +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 5341A24C3E for ; Thu, 20 May 2021 17:58:18 +0200 (CEST) Received: from localhost ([::1]:57986 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ljl3x-0005h2-G0 for larch@yhetil.org; Thu, 20 May 2021 11:58:17 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:55778) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ljl3E-0005ga-8Y for emacs-orgmode@gnu.org; Thu, 20 May 2021 11:57:32 -0400 Received: from ciao.gmane.io ([116.202.254.214]:54446) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ljl3C-0005JS-FT for emacs-orgmode@gnu.org; Thu, 20 May 2021 11:57:31 -0400 Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1ljl3A-00080Y-Em for emacs-orgmode@gnu.org; Thu, 20 May 2021 17:57:28 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: emacs-orgmode@gnu.org From: Maxim Nikulin Subject: Re: [PATCH] org-faq.org: Expand "What is the best setup for indenting?" Date: Thu, 20 May 2021 22:57:18 +0700 Message-ID: References: <2715701.1621447611@apollo2.minshall.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------77AEBDBC6E4717BB78E5905A" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.8.1 X-Mozilla-News-Host: news://news.gmane.io In-Reply-To: <2715701.1621447611@apollo2.minshall.org> Content-Language: en-US Received-SPF: pass client-ip=116.202.254.214; envelope-from=geo-emacs-orgmode@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: 28 X-Spam_score: 2.8 X-Spam_bar: ++ X-Spam_report: (2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, FORGED_GMAIL_RCVD=1, FORGED_MUA_MOZILLA=2.309, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, NICE_REPLY_A=-0.001, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no 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-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1621526298; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to: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; bh=Qvv/eUQm6hm/IuyKNXM3JsoRyI0YhyJLehFBTU7YiJc=; b=Z+1I0dwTpZ2vKrehl8rNeSpmMq1YNKpLYmmQgaBrXW5d5wlITcScozJA4awpgmZSDT5crw wQiNzIrGbTqQN1SMHFwxbiWiaJeNWwKU60WeVQfX+G/ye+8vwVa57I5q9brFMqEh5XEodm JJ5CUwOSDXimhqQP/iCSOJ+lNV0q1knOKk3ijFV/BY1QAekPiDnOTYEyM1FeNsu2RkQlkD x04jTbvqXwLfRpAVsCeXLk4wVRhJW6UR6sjQ4Ihpz+TA3b6o4Evp8ADLMJntVIq2RJi2z3 lnzGfc1yW5drx11Ag8pMKLeX7UoQ78LBGUFkyZPRQOq3a1kZ/dUxfkTjRUgpKA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1621526298; a=rsa-sha256; cv=none; b=JCx+5+hhWM+WQv+MQ5OJD4cw7n/sKpLt3jmz0d0HgRBAPTJdggOKH6FG9zPyf/zPSISQZ9 F8KfC/kw0B3AUjjopPGLcM4eE4JsY6G1mU3oI7La+m7+6PPPRQzIiarWdTAYfB4yIBeZlM TqMdSPHdbrHAe5wqsYptnAOikcywHSpI2ikFSpl118iwJtTGsNuYGakhySX3XgAwG+Tjdn WPaiMq4dCMNhEIMcod/r2vIzgmvqtKGxa4Pxml4LaLGii+bSxW32eGAJF6QXzqS3eSWoGS p6NUEMKjo9KaDYXkfcmIwiR/O9poBMRL28wobZXgJHsxmkRYi0hbTNguV72Zlg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=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-Migadu-Spam-Score: -1.84 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" 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-Migadu-Queue-Id: 5341A24C3E X-Spam-Score: -1.84 X-Migadu-Scanner: scn0.migadu.com X-TUID: 5KolU6v6lAqC This is a multi-part message in MIME format. --------------77AEBDBC6E4717BB78E5905A Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Thank you for your comments, Greg. On 20/05/2021 01:06, Greg Minshall wrote: > > patches to patches... :) i think these are really just typos, rather > than any useful substantial comment. > > - s/is enable (the default) or not:/is enabled (the default) or not:/ The patch removed this phrase. > - i would suggest separate tables for >= 9.5 and < 9.5. just so the > differences between with/without =electric-indent-mode= are easier to > spot. I have no idea how to express it in a better way. The tables are same for Org >= 9.5 and for Org < 9.5 (modulo bugs in indentation fixed in 9.4.6). Only default configuration evolves in time. 1. Before 9.4. (org-adapt-indentation t) electric-indent-mode disabled. Bugs remained unnoticed. Users were unaware that default configuration assumed indented text aligned to headline title. 2. 9.4. (org-adapt-indentation t) electric-indent-mode enabled. Hot discussions and recommendations to disable electric-indent-mode since even with (org-adapt-indentation headline-data) behavior was strange. 3. Recent changes. Bugs fixed, (org-adapt-indentation nil), so as earlier text is not indented by default. Now absence of indentation is consistent with settings. > - s/C-j anywhere/C-j elsewhere/ (and, iiuc, maybe also the "unadorned" > [C-j] table entry should probably be [C-j elsewhere]?) > > - s/lost formatting/lose formatting/ > > - s/and, that is/and,/ Agree. > - s/always indent relatively/always indent relative/ Not being a native speaker, I would either leave it as is or would change all 3 phrases attempting to make their style more uniform. a. "do not indent anything", "always indent relatively to the element above", "indent just ~PROPERTIES/LOGBOOK~ drawers relatively to the current heading level" b. "no special indentation", "indentation of all elements is relative to the element above", "only ~PROPERTIES/LOGBOOK~ drawers get indentation relative to the current heading level" If you think that your variant is better, I can add it to the patch. > - s/the the element/to the element/ Agree. Intermediate patch is attached. --------------77AEBDBC6E4717BB78E5905A Content-Type: text/x-patch; charset=UTF-8; name="0001-org-faq.org-Fix-typos-and-style-in-setup-for-indenti.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename*0="0001-org-faq.org-Fix-typos-and-style-in-setup-for-indenti.pa"; filename*1="tch" >From 1881aacf22fda650408434394a96f3aaea2c6928 Mon Sep 17 00:00:00 2001 From: Max Nikulin Date: Thu, 20 May 2021 22:48:58 +0700 Subject: [PATCH] org-faq.org: Fix typos and style in "setup for indenting" * org-faq.org (What is the best setup for indenting?): Minor corrections suggested by Greg Minshall. --- org-faq.org | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/org-faq.org b/org-faq.org index 0f8934af..54d5e403 100644 --- a/org-faq.org +++ b/org-faq.org @@ -1039,7 +1039,7 @@ In more details, ~org-adapt-indentation~ controls indentation with regards to previous element. Apparent effect is increased indentation for content of deeper nested headings. The variable accepts three values: =nil= (no special indentation), =t= (always indent relatively -the the element above) and =headline-data= (only indent the +to the element above) and =headline-data= (only indent the ~PROPERTIES/LOGBOOK~ drawers relatively to the current level). Value =t= is suitable for short entries especially if you plan to share your documents with someone who does not use Emacs. If you just want to @@ -1059,8 +1059,8 @@ With ~electric-indent-mode~ enabled: |---------------------------+------------------------+----------------------------+----------------------------| | RET after a headline | Do not indent | Indent | Do not indent | | C-j after a headline | Do not indent | Do not indent | Do not indent | -| RET anywhere | Indent wrt previous | Indent wrt previous | Indent wrt previous | -| C-j anywhere | Do not indent wrt prev | Do not indent wrt previous | Do not indent wrt previous | +| RET elsewhere | Indent wrt previous | Indent wrt previous | Indent wrt previous | +| C-j elsewhere | Do not indent wrt prev | Do not indent wrt previous | Do not indent wrt previous | | Insert PROPERTIES/LOGBOOK | Do not indent | Indent wrt headline | Indent wrt headline | With ~electric-indent-mode~ disabled: @@ -1069,21 +1069,21 @@ With ~electric-indent-mode~ disabled: |---------------------------+---------------------+----------------------------+----------------------------| | RET after a headline | Do not indent | Do not indent | Do not indent | | C-j after a headline | Do not indent | Indent | Do not indent | -| RET | Do not indent | Do not indent wrt previous | Do not indent wrt previous | -| C-j | Indent wrt previous | Indent wrt previous | Indent wrt previous | +| RET elsewhere | Do not indent | Do not indent wrt previous | Do not indent wrt previous | +| C-j elsewhere | Indent wrt previous | Indent wrt previous | Indent wrt previous | | Insert PROPERTIES/LOGBOOK | Do not indent | Indent wrt headline | Indent wrt headline | Do not try to avoid or to ignore indentation of heading body or properties drawer determined by current state of ~org-adapt-indentation~ and ~electric-indent-mode~ by pressing =C-j= instead of =RET= (or vice versa). The result is transient and you will -lost formatting when you refile heading or change its level (promote +lose formatting when you refile heading or change its level (promote or demote it). You may have noticed recommendation to disable ~electric-indent-mode~ to restore behavior prior to Org 9.4. In Org 9.5 -~org-adapt-indentation~ default value changed to =nil= and, that is -more important, a number of bugs related to indentation were fixed. +~org-adapt-indentation~ default value changed to =nil= and, more +importantly, a number of bugs related to indentation were fixed. Using =RET= with enabled ~electric-indent-mode~ should be convenient now. Just customize ~org-adapt-indentation~ variable accordingly to you preferences. -- 2.25.1 --------------77AEBDBC6E4717BB78E5905A--