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 RwOmN+Tcs1/KRQAA0tVLHw (envelope-from ) for ; Tue, 17 Nov 2020 14:23: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 gEAbM+Tcs19KUAAA1q6Kng (envelope-from ) for ; Tue, 17 Nov 2020 14:23: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 7C36B94043A for ; Tue, 17 Nov 2020 14:23:32 +0000 (UTC) Received: from localhost ([::1]:47222 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kf1tL-0006uv-Dg for larch@yhetil.org; Tue, 17 Nov 2020 09:23:31 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:33836) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kf1qp-0004v1-7f for emacs-orgmode@gnu.org; Tue, 17 Nov 2020 09:20:55 -0500 Received: from hiwela.pair.com ([209.68.5.201]:12971) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kf1qn-0004rL-CN for emacs-orgmode@gnu.org; Tue, 17 Nov 2020 09:20:54 -0500 Received: from hiwela.pair.com (localhost [127.0.0.1]) by hiwela.pair.com (Postfix) with ESMTP id 04B1A98059E; Tue, 17 Nov 2020 09:20:51 -0500 (EST) Received: from minshall-entroware-apollo.cliq.com (unknown [95.8.197.123]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by hiwela.pair.com (Postfix) with ESMTPSA id B8AFC8F0953; Tue, 17 Nov 2020 09:20:50 -0500 (EST) Received: from apollo2.minshall.org (localhost [IPv6:::1]) by minshall-entroware-apollo.cliq.com (Postfix) with ESMTP id 56D46602F6; Tue, 17 Nov 2020 17:20:45 +0300 (+03) From: Greg Minshall To: Robert Pluim Subject: Re: patch to change org-adapt-indentation customization documentation In-reply-to: Your message of "Tue, 17 Nov 2020 15:08:58 +0100." <87y2j0cbyd.fsf@gmail.com> X-Mailer: MH-E 8.6+git; nmh 1.7.1; GNU Emacs 27.1 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Date: Tue, 17 Nov 2020 17:20:45 +0300 Message-ID: <839402.1605622845@apollo2.minshall.org> Received-SPF: softfail client-ip=209.68.5.201; envelope-from=minshall@umich.edu; helo=hiwela.pair.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/17 08:15:16 X-ACL-Warn: Detected OS = FreeBSD 9.x or newer [fuzzy] X-Spam_score_int: -11 X-Spam_score: -1.2 X-Spam_bar: - X-Spam_report: (-1.2 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_SOFTFAIL=0.665 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: , Cc: Org-mode Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Scanner: ns3122888.ip-94-23-21.eu Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=umich.edu (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.91 X-TUID: TmFxUHQb0GHd Robert, > The whole point of customize is that you shouldn't have to worry about > what the actual lisp value is. The actual lisp value only matters if > you directly set the value without using customize. thanks for the response. i've included the documentation for org-adapt-indentation below. since the documentation talks about values and associated behaviors, it might be helpful to mention the values in the customization dialog. an alternative maybe would be to re-do the documentation to highlight the three customization phrases: ---- "Adapt indentation for all lines" "Adapt indentation for headline data lines" "Do not adapt indentation at all" ---- and not change the customization dialog? i, anyway, was very uncertain, even after several rounds, as to which customization option would give me the behavior i had read about in the documentation. cheers, Greg =3D=3D=3D=3D org-adapt-indentation is a variable defined in =E2=80=98org.el=E2=80=99. Its value is 'headline-data Original value was t This variable is safe as a file local variable if its value satisfies the predicate =E2=80=98booleanp=E2=80=99. You can customize this variable. Documentation: Non-nil means adapt indentation to outline node level. When this variable is set to t, Org assumes that you write outlines by indenting text in each node to align with the headline (after the stars). When this variable is set to =E2=80=99headline-data, only adapt the indentation of the data lines right below the headline, such as planning/clock lines and property/logbook drawers. The following issues are influenced by this variable: - The indentation is increased by one space in a demotion command, and decreased by one in a promotion command. However, in the latter case, if shifting some line in the entry body would alter document structure (e.g., insert a new headline), indentation is not changed at all. - Property drawers and planning information is inserted indented when this variable is set. When nil, they will not be indented. - TAB indents a line relative to current level. The lines below a headline will be indented when this variable is set to t. Note that this is all about true indentation, by adding and removing space characters. See also "org-indent.el" which does level-dependent indentation in a virtual way, i.e. at display time in Emacs. [back]