From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Organizing the NEWS file a bit better Date: Mon, 06 Sep 2021 14:01:42 +0300 Message-ID: <83a6kqrmqx.fsf@gnu.org> References: <87wnnwp3g8.fsf@gnus.org> <87tuiyqklv.fsf@mail.linkov.net> <87sfyije12.fsf@gnus.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1228"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, juri@linkov.net, emacs-devel@gnu.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Sep 06 13:03:25 2021 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 1mNCPM-00009k-PS for ged-emacs-devel@m.gmane-mx.org; Mon, 06 Sep 2021 13:03:24 +0200 Original-Received: from localhost ([::1]:36784 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mNCPL-0003yY-HH for ged-emacs-devel@m.gmane-mx.org; Mon, 06 Sep 2021 07:03:23 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56626) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mNCNg-0002ZC-Gy for emacs-devel@gnu.org; Mon, 06 Sep 2021 07:01:45 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:35598) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mNCNe-0004Kk-DT; Mon, 06 Sep 2021 07:01:39 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:4107 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mNCNb-0005qx-7m; Mon, 06 Sep 2021 07:01:38 -0400 In-Reply-To: (message from Stefan Kangas on Mon, 6 Sep 2021 11:01:04 +0200) 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:274103 Archived-At: > From: Stefan Kangas > Date: Mon, 6 Sep 2021 11:01:04 +0200 > Cc: Emacs developers , Juri Linkov > > Lars Ingebrigtsen writes: > > > > Perhaps we could try it for Emacs 29? If we do it soon after cutting > > > the new branch, it should be easier to change it back if we find any > > > reason to. > > > > What would the lines look like? > > > > ** New user option 'use-short-answers'. :DOC: > > > > and > > > > ** New user option 'use-short-answers'. :NODOC: > > > > ? > > Yes. Then PLEASE don't. This makes the text much harder to read, even before we consider lines that are long enough to overflow after this addition. What is the purpose? to make it easier to find entries that aren't documented yet? If so, why not use Occur or somesuch? > The command 'org-set-tags-command' lines them up like this, which > helps improve readability: > > ** 'open-gnutls-stream' now also accepts a ':coding' argument. :DOC: > ** 'process-attributes' now works under OpenBSD, too. :NODOC: IME, Org's tags are intended to be used with relatively short headings, and these aren't.