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 4AAqHW4FwF7PbwAA0tVLHw (envelope-from ) for ; Sat, 16 May 2020 15:23:26 +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 6NIDGW4FwF70fAAA1q6Kng (envelope-from ) for ; Sat, 16 May 2020 15:23:26 +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 A8ECB940B30 for ; Sat, 16 May 2020 15:23:25 +0000 (UTC) Received: from localhost ([::1]:55862 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jZyeq-0000qd-KK for larch@yhetil.org; Sat, 16 May 2020 11:23:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:60616) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jWSMD-00077t-4k for emacs-orgmode@gnu.org; Wed, 06 May 2020 18:17:37 -0400 Received: from helm.ryantate.com ([52.37.201.218]:59448) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jWSMB-0004QT-Pi for emacs-orgmode@gnu.org; Wed, 06 May 2020 18:17:36 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ryantate.com; s=mail; t=1588803451; bh=By6cewD7Kdfe1YO66OztW8LGgodoEBCfGwKPlTBx7hw=; h=From:To:Subject:Date; b=qNXYlrXpmcLDVL9H9jMPQKJhyt/LkFBlmN4trNi0/tAGEYk5fNWG7WuV2ZMWGw2aV nru2wCDLZVw3JQtb8lKsQK0toa/hQeA2V5dMJKnaZLOU8Q+ws73Bb5l25fm1NQZK42 dWlIBsgZL8wMz1Y3Ae5Vu46OZ8UU1Wj7CkVKM/rE= From: Ryan Tate To: emacs-orgmode@gnu.org Subject: Headlines require both space and star Date: Wed, 06 May 2020 18:17:26 -0400 Message-ID: <87ftcc3dzd.fsf@disp2634> MIME-Version: 1.0 Content-Type: text/plain; format=flowed Received-SPF: pass client-ip=52.37.201.218; envelope-from=ryantate@ryantate.com; helo=helm.ryantate.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/06 18:17:31 X-ACL-Warn: Detected OS = Linux 3.11 and newer X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, SPF_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-Mailman-Approved-At: Sat, 16 May 2020 11:18:59 -0400 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=pass header.d=ryantate.com header.s=mail header.b=qNXYlrXp; dmarc=pass (policy=reject) header.from=ryantate.com; 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.21 X-TUID: 58mpwDCE+EYt Hello, I am writing to suggest that the documents reflect that both a star and space are required to create a headline, not just a star. Today I learned org mode through the manual, compact guide, "Org mode beginning at the basics" at orgmode.org and David O'Toole tutorial at orgmode.org. I spent about 15 minutes trying to figure out why folding wasn't "working" in the very first org doc I then created. It turns out I was not including a space after the star in my headlines. My doc looked like this: *Intro **First Part **Second Part ***Sub part **Third Part etc. When I did add spaces after the stars, suddenly the headlines were recognized (color changes) and folding worked as described in the manual at last. (I am on GNU Emacs 26.3 (build 1, x86_64-redhat-linux-gnu, GTK+ Version 3.24.11) of 2019-12-10) I went to see if I missed something when I read the docs. Here are various ways headlines are described, none seem to mention the space after the star being required: Manual, compact guide: " The headlines in Org start with one or more stars, on the left margin3. For example..." https://orgmode.org/manual/Headlines.html#Headlines https://orgmode.org/guide/Headlines.html#Headlines Org mode beginning at the basics: "This is a headline, it starts with one or more stars. A heading has one star, a sub-heading two, etc." https://orgmode.org/worg/org-tutorials/org4beginners.html David O'Toole Org Tutorial: "First-level headlines begin with one star; second-level headlines begin with two stars, and so on. " https://orgmode.org/worg/org-tutorials/orgtutorial_dto.html I am presuming that the requirement of a space after a star has been omitted from the docs and is not an implementation error. If the latter I could probably put together a bug report for the code itself. If the former, I would simply suggest that the docs be amended to fully describe the actual requirements of headlines so others who do read the friendly manual as I did do not waste their own 15 minutes :-) If people are open to this, and a more proper patch is required, I would be happy to submit one in a more elaborate and correct format. If this has been brought up before, or I am misunderstanding, I apologize in advance; the gmane gateway seems to be down so I cannot search the archives at the moment. Cheers and thanks for org mode. Ryan