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 CIr0N3wKs190NAAA0tVLHw (envelope-from ) for ; Mon, 16 Nov 2020 23:25:48 +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 IGvSM3wKs19VYAAA1q6Kng (envelope-from ) for ; Mon, 16 Nov 2020 23:25:48 +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 54FF4940415 for ; Mon, 16 Nov 2020 23:25:48 +0000 (UTC) Received: from localhost ([::1]:60608 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kensY-00068f-Lq for larch@yhetil.org; Mon, 16 Nov 2020 18:25:46 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:52482) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kenrn-00066o-Cp for emacs-orgmode@gnu.org; Mon, 16 Nov 2020 18:24:59 -0500 Received: from relay8-d.mail.gandi.net ([217.70.183.201]:51481) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kenri-0005Gy-ON for emacs-orgmode@gnu.org; Mon, 16 Nov 2020 18:24:58 -0500 X-Originating-IP: 68.2.59.189 Received: from victor.tftorrey.com (ip68-2-59-189.ph.ph.cox.net [68.2.59.189]) (Authenticated sender: tftorrey@tftorrey.com) by relay8-d.mail.gandi.net (Postfix) with ESMTPSA id 5213E1BF206 for ; Mon, 16 Nov 2020 23:24:47 +0000 (UTC) References: <2020-11-13T18-23-43@devnull.Karl-Voit.at> <874klqew77.fsf@web.de> <20201115122154.50ad1503@linux-h0yu.fritz.box> <87tutq67ka.fsf@gmail.com> <87tutpvppm.fsf@kyleam.com> <877dqlby74.fsf@gmail.com> <871rgtbwml.fsf@gmail.com> <87blfxv966.fsf@gmail.com> User-agent: mu4e 1.4.13; emacs 27.1 From: "T.F. Torrey" To: emacs-orgmode@gnu.org Subject: Re: Changed list indentation behavior: how to revert? In-reply-to: <87blfxv966.fsf@gmail.com> Date: Mon, 16 Nov 2020 16:24:45 -0700 Message-ID: <87a6vgq402.fsf@victor.tftorrey.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=217.70.183.201; envelope-from=tftorrey@tftorrey.com; helo=relay8-d.mail.gandi.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/11/16 18:24:49 X-ACL-Warn: Detected OS = Linux 3.11 and newer [fuzzy] 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, RCVD_IN_MSPIKE_H2=-0.001, 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: ns3122888.ip-94-23-21.eu Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=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.01 X-TUID: WT8fquW8J/e5 Hello all, I apologize in advance that this is so long. I've been following this thread closely, because I've been using Org mode daily for well over a decade, and this behavior affects me in several important ways. I think this summary might be helpful. Forever, it has been possible to start a heading in Org by typing a return one or more times, then typing an asterisk and a space and the heading text. To add a series of headings, just keep hitting return at the end of the current one, type an asterisk and a space and the next one, then repeat. If you want subheadings, it is as simple as typing more asterisks. Easy. This worked because electric-indent-mode defaulted to off, and although org-adapt-indentation defaulted to t, it didn't affect this situation. The default behavior here matters because Org is a killer feature of Emacs, enticing many people to give it a try, including my nine-year-old daughter. For them, it should behave by default the way it looks like it should. That means, typing asterisks and text for headings, followed by returns, and text, and more asterisks, should just work by default. #+NAME: Old Defaults: electric-indent-mode OFF and org-adapt-indent t #+begin_example org ,* Testing out Org, type here once or twice I get it! I'll type once or twice again and start a subheading. ,** Headings are easy! Now another or two for subhead content This is awesome! It works just as I expect, and I don't have to memorize a bunch of key chords just to get started. And folding is awesome! I love Org! I will stick with it and learn it all! #+end_example I have probably typed close to a million headings like this all by myself, and collectively we have probably typed billions or more. The last release, as everyone knows, turned on electric-indent-mode by default. So, right now, typing an Org document with default settings does not work like it looks like it should. This is the new experience for people used to the old defaults, and beginners like my daughter: #+NAME: New Defaults: electric-indent-mode ON and org-adapt-indent t #+begin_example org ,* I typed an asterisk for this heading, how about here once or twice Okay. This is indented. Since I'm new, I don't realize it isn't useful yet, or that it makes a difference at all. How about a subheading? I'll hit a couple times, they type two asterisks. ,** Is this a subheading? It looks like one. again here ... Okay, the indentation isn't the same, but maybe it's okay? I probably didn't even notice. ,*** I think I'm organizing my document with *'s and 's I'm going to try folding my stuff, becaue I saw that and it looks awesome. Wait! The instructions say will cycle the folding, but it only works on the top level. What? Okay, some searching said I have to modify init, or something, or type some weird key combinations. What? This looked like it was going to be easy. Nerds are liars. I can't figure this out, and I don't have time to mess with this. I'm going back to Word. Maybe I'll try Markdown tomorrow. #+end_example For new users, step one is either to start changing default settings, start learning key chords and/or arcane (to beginners) commands---or go back to Word or Markdown. Turning on electric-indent-mode, all by itself, shouldn't break the useful or customary indentation that the users of Org expect, but it has. Instead of starting a new heading by typing one or more times, then typing an asterisk and a space and a new heading, a user has to either hit some control characters with returns, or backspace to column zero, or something else. The manual shows heading and body formatting as this: #+NAME: Org Manual Sample: electric-indent-mode on, org-adapt-indent t #+begin_example org ,* Top level headline ,** Second level ,*** Third level some text ,*** Third level more text ,* Another top level headline #+end_example I don't recall ever seeing an Org document in real life with the body indented at the level of each heading, and I haven't seen anyone argue for that behavior on this thread. I've tried it, and the text body width rapidly becomes too narrow to be useful. As several people have noted, even the Org repositories turn this off, which suggests even the developers don't find it useful. Why this is set as the default, I have no idea, but it didn't really matter until now. An Org document looks like you can create it by typing asterisks, text, and returns, but you can't, not by default, anyway. That's the root of the problem: the longstanding default *behavior* has been changed. The only people unaffected are people who already had compensatory settings in their init files. As far as I can tell, turning on electric-indent-mode by default was done for no reason other than other Emacs modes have it as a default. The proper fix for this is one of two choices: 1. If keeping electric-indent-mode on is really important, the easiest way to restore intuitive behavior is to change the default of org-adapt-indentation to nil. Yes, this changes a longstanding default, but it is necessitated because of the change of another longstanding default: electric-indent-mode. Before, anyone who wanted text indented by default needed to specify that in their init file, so this should not inconvenience anyone who wasn't inconvenienced before. or 2. More involved would be to change the default behavior of Org's electric indentation so that typing at the end of a heading takes you back to column 0 by default. In many contexts, the indentation provided by org-auto-indent is useful, but not this one. The Emacs manual says that "Electric Indent mode is a global minor mode that automatically indents the line after every you type", but that's not exactly true. What it does do is indent a line to what is useful or customary based on the context, which is often not at all. In the context of hitting at the end of a heading in Org, what is useful may be debatable, but it seems customary for all serious Org users to return to column 0, and that seems what new and casual users expect. Finally, I can point out that, for myself, adding another line to my init file (actually a literate Org doc) is not a big deal. I've been using Org and Emacs long enough that changing defaults doesn't bother me much. For new and casual users, including my nine-year-old daughter, however, I hope we can change the defaults so that it works the way it looks like it should. It's not easy to get her to try Emacs and Org, and this makes it harder. Side note: the manual frequently refers to headings as "headlines", but that is not the right use of that word. To whit: there is no such thing as a "subheadline", but there is a "subheading", because that construct is a "heading", and a "headline" is something else. All the best, Terry