From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.devel Subject: Re: Paragraph styles in doc strings Date: Thu, 12 May 2016 22:37:14 +0200 Message-ID: <87vb2jxbb9.fsf@gnus.org> References: <878tzjjn3w.fsf@gnus.org> <9503e7e0-4402-554d-7533-9c3a6d2c5f77@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1463429470 15462 80.91.229.3 (16 May 2016 20:11:10 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 16 May 2016 20:11:10 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon May 16 22:11:01 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1b2Oqy-0005if-Un for ged-emacs-devel@m.gmane.org; Mon, 16 May 2016 22:11:01 +0200 Original-Received: from localhost ([::1]:47161 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2Oqx-0005sQ-TS for ged-emacs-devel@m.gmane.org; Mon, 16 May 2016 16:10:59 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:32963) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2Oqu-0005pH-8s for emacs-devel@gnu.org; Mon, 16 May 2016 16:10:57 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b2Oqq-0005rf-48 for emacs-devel@gnu.org; Mon, 16 May 2016 16:10:56 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]:48542) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2Oqp-0005rQ-TW for emacs-devel@gnu.org; Mon, 16 May 2016 16:10:52 -0400 Original-Received: from 2.151.133.228.tmi.telenormobil.no ([2.151.133.228] helo=mouse) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1b0xMG-0007bW-IR for emacs-devel@gnu.org; Thu, 12 May 2016 22:37:22 +0200 In-Reply-To: (John Wiegley's message of "Tue, 10 May 2016 18:52:42 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 80.91.224.195 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:203871 Archived-At: John Wiegley writes: >>>>>> Kaushal Modi writes: > >> On Mon, May 9, 2016 at 11:03 AM Dmitry Gutov wrote: >>> On 05/09/2016 05:57 PM, Lars Ingebrigtsen wrote: >>> >>> > So my favourite is definitely the "empty line" one. >>> >>> +1 >>> > >> I like that style too for clarity; I used that in my emacs config. > > Same here. +1 for empty line. Unless I've missed something, I think that means that everybody who's weighed in here is in favour of the "empty line" style. I think that means that we should, perhaps, whenever we're doing doc fix ups, try to reformat doc strings that do not adhere to this style. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no