From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: tabulated-list sort icon is reversed Date: Sat, 09 Mar 2019 14:57:38 -0500 Message-ID: References: <6e662c5b-3d04-2157-6712-aadcb6077f2b@gmail.com> <83a7j0pzbh.fsf@gnu.org> <83sgwpm92r.fsf@gnu.org> <83imx1h4rm.fsf@gnu.org> <83tvglf8h0.fsf@gnu.org> <83r2bhaegh.fsf@gnu.org> <835zss84v0.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="195011"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: Eli Zaretskii , Emacs developers To: Philippe Vaucher Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 09 20:58:23 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1h2i6x-000oas-49 for ged-emacs-devel@m.gmane.org; Sat, 09 Mar 2019 20:58:23 +0100 Original-Received: from localhost ([127.0.0.1]:34879 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h2i6w-0004HV-3E for ged-emacs-devel@m.gmane.org; Sat, 09 Mar 2019 14:58:22 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:37264) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h2i6J-0004HP-5m for emacs-devel@gnu.org; Sat, 09 Mar 2019 14:57:43 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h2i6I-0000Kf-2g for emacs-devel@gnu.org; Sat, 09 Mar 2019 14:57:43 -0500 Original-Received: from pruche.dit.umontreal.ca ([132.204.246.22]:44520) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h2i6H-0000K6-S4; Sat, 09 Mar 2019 14:57:42 -0500 Original-Received: from pastel.home (lechon.iro.umontreal.ca [132.204.27.242]) by pruche.dit.umontreal.ca (8.14.7/8.14.1) with ESMTP id x29Jvdf8025673; Sat, 9 Mar 2019 14:57:39 -0500 Original-Received: by pastel.home (Postfix, from userid 20848) id D217E6AA48; Sat, 9 Mar 2019 14:57:38 -0500 (EST) In-Reply-To: (Philippe Vaucher's message of "Sat, 9 Mar 2019 18:08:02 +0100") X-NAI-Spam-Flag: NO X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 2 Rules triggered EDT_SA_DN_PASS=0, RV6499=0 X-NAI-Spam-Version: 2.3.0.9418 : core <6499> : inlines <7030> : streams <1815233> : uri <2809789> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 132.204.246.22 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:233989 Archived-At: >> > + "Indicator for column sorted in ascending order, for GUI frames. See >> > + `tabulated-list-tty-sort-indicator-asc' for indicator used on >> > + text-mode frames." >> The first line of the doc string should be a single complete sentence. > Just to be clear, if I wrote "It is the indicator used for the column > sorted in ascending order (for GUI frames)." would that be ok? I think there's a misunderstanding here: the only real problem in the code above is the "See" which should be moved to the next line. The reason for that is that the first line will sometimes be shown without showing the rest. We usually skip the "It is the" because it carries no useful information and eats up space which is often a limitation since we don't want to go over the 80 columns limit. Stefan