From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: Convert some files from outline-mode to org-mode Date: Sun, 26 Apr 2020 21:52:02 +0200 Message-ID: References: <520c3307-7cb2-62a6-7b37-ca9ba5333370@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="129538"; mail-complaints-to="usenet@ciao.gmane.io" Cc: =?UTF-8?Q?Cl=C3=A9ment_Pit=2DClaudel?= , Emacs developers To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Apr 26 21:53:56 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jSnLg-000XZW-LC for ged-emacs-devel@m.gmane-mx.org; Sun, 26 Apr 2020 21:53:56 +0200 Original-Received: from localhost ([::1]:44252 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jSnLf-0000HI-NO for ged-emacs-devel@m.gmane-mx.org; Sun, 26 Apr 2020 15:53:55 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51494) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jSnK4-0007i9-OH for emacs-devel@gnu.org; Sun, 26 Apr 2020 15:52:20 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jSnK3-0006wJ-8N for emacs-devel@gnu.org; Sun, 26 Apr 2020 15:52:15 -0400 Original-Received: from mail-yb1-f181.google.com ([209.85.219.181]:34940) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jSnK2-0006rQ-G7 for emacs-devel@gnu.org; Sun, 26 Apr 2020 15:52:14 -0400 Original-Received: by mail-yb1-f181.google.com with SMTP id i2so8333446ybk.2 for ; Sun, 26 Apr 2020 12:52:14 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=ABBzMMtxTmsYyoK8kuihXxMCgLbQ3UEI/zaX1v9tauY=; b=NqCgHbdRm3A32L6p9Tl92tYHNArr/8d4Xkk/y5zNbFGm1GGxBOmDhfOXxSft622hBD rTioezn+WWOKY7RxtxKkzQcLYhUGpKNirlNmxl9e62456/41CwgR0MHwPijgmz4OuLjH +A5LUO8MY0yJ82zi1NlGcY0R+9ChIjh6EwsYhb9s90zJY7o6c8rP6qI6/Z55nvEuKb+F EmOwWgo0nj5aF4R9wWPUMwVylPanp0FY0B0w1uh0hxuM8aD8NFVMp3YSNV7wg48a8H6q 4+Ntz+tELuMA06BCGjqoo8upFfWwL2SH2S+/DK+Fk8gV1ynsdEy02SCJ0qpsivNpfrcH rFAA== X-Gm-Message-State: AGi0PubFkkLJ5TFJqgISz5eDUrGnRFZc08wDd58fpJndYlz8saucfyA/ mSe2tqe4C8XN3y4mm1xDsARheZByNF85D5XO6iw= X-Google-Smtp-Source: APiQypLQT4DHUA65SDojEcyeLwIcCZUAUnKRbUwu8XnCcIENcV1yfS9/5hmRoiipWJWirOqEGBQKv1K6l0pZkbKi8z0= X-Received: by 2002:a25:2:: with SMTP id 2mr30047331yba.466.1587930733250; Sun, 26 Apr 2020 12:52:13 -0700 (PDT) In-Reply-To: Received-SPF: pass client-ip=209.85.219.181; envelope-from=stefankangas@gmail.com; helo=mail-yb1-f181.google.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/04/26 15:52:13 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.219.181 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:247860 Archived-At: Stefan Monnier writes: > So could someone summarize what are those "org-mode reflexes" that need > switching, as well as any other impact (including hypothetical future > benefits which will only materialize after we make further changes to > those files to take advantage of some Org features)? What does "org-mode reflexes" mean here? For me, the main motivation is better navigation. As for future improvements, I'm not sure. I'm not necessarily even suggesting any. But here's one idea: We have seen people make mistakes with "+++" and "---" in NEWS before. So how about using org-mode tags, such that this: +++ ** New command 'undo-redo'. Instead is written like: ** New command 'undo-redo'. :documented: That would be a whole lot clearer and easier on the eyes. It's only one line of text to set file specific tags, and once that's done it's one command (C-c C-q) to use them. Or indeed, one can just type ":documented:" manually after the headline if one doesn't want to use the command or don't know it. (One nice thing here is that when it's time for review, one could then filter the file to look only for headlines tagged ":undocumented:" (or whatever we would use) using org-sparse-tree.) But I understand the point that there are just a small number of such improvements that could be made. In fact, I think we should be careful not to make these files too "heavy" to use (as is Alan's concern). Best regards, Stefan Kangas