From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: Paragraph styles in doc strings Date: Tue, 17 May 2016 23:05:26 -0700 Message-ID: References: <878tzjjn3w.fsf@gnus.org> <9503e7e0-4402-554d-7533-9c3a6d2c5f77@yandex.ru> <87vb2jxbb9.fsf@gnus.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1463551585 1407 80.91.229.3 (18 May 2016 06:06:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 18 May 2016 06:06:25 +0000 (UTC) Cc: emacs-devel@gnu.org To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed May 18 08:06:20 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 1b2ucc-0002mQ-LN for ged-emacs-devel@m.gmane.org; Wed, 18 May 2016 08:06:18 +0200 Original-Received: from localhost ([::1]:43149 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2ucY-0001kg-GK for ged-emacs-devel@m.gmane.org; Wed, 18 May 2016 02:06:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33985) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2ubw-0001kQ-Gu for emacs-devel@gnu.org; Wed, 18 May 2016 02:05:40 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b2ubq-0007Hx-GX for emacs-devel@gnu.org; Wed, 18 May 2016 02:05:35 -0400 Original-Received: from mail-oi0-x230.google.com ([2607:f8b0:4003:c06::230]:33712) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2ubq-0007Hr-6e for emacs-devel@gnu.org; Wed, 18 May 2016 02:05:30 -0400 Original-Received: by mail-oi0-x230.google.com with SMTP id v145so60867379oie.0 for ; Tue, 17 May 2016 23:05:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:references:mail-followup-to:date:in-reply-to :message-id:user-agent:mime-version; bh=Hxeek6ZdHlz0+4009AMakn30Csz3n0tILtU1sLlp5VY=; b=aZ9YmokzHG58PCfrcZdt2pFBjtiTwI0LmynAxLWORwz8so2FCr30MwQ1CpdJ32YgX1 444Iet6oga2Fn8FCrRjl4OI18nn7hjsClOvwvd2Mz0jFko2pFE3R9H6AkQb5Rl1jk+e1 DzbB1GnmOVAvq2LD5aCHTnZpOkqucacfnCam5vrhGjCLiEXjtrO945tamfhO2ymI518n ZBQmpUE/Vc9E/Z6rxYjCAwYXyj4In6f+uwzRGw19ELIAWrPt09yDXSORx8Ujh2uLz2FZ n0xbHVjnAeDjP3btKIxGUiL9+IH1/thozYKmaBugDZSXj41sS5Ph9xPhRS1hlKy+EoB4 hYqQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:references:mail-followup-to :date:in-reply-to:message-id:user-agent:mime-version; bh=Hxeek6ZdHlz0+4009AMakn30Csz3n0tILtU1sLlp5VY=; b=fvQMWkhQQitN62wyBXdqN1ekuMDIrfgS87MjNZS1o1w6KeOcYkw1pWSf6XX2K8FpZP kILPqHp4T2jzOso491UokjRH0YTgURHu8vTkCQjB4r57/6taC1+/3tLCmPOqBMYqDgff l+4tXnGPPq7mYXEkC4NbYvS0er4QUQ1YCbEkdGIBI7fCTpNNY1XQEl4eB5cCZBP0s6CF 2enQs1OiR+mxb4zn8T+hTs7wr2n6ogjZ/LKtb/+MTeCXrAPIZKAbnPVorzLicQ/HzIGn pqNL6LPXPbATeJAa8J0aPBigXWGJiPcOqmZNquXuAQQasl8dWMKP8WqYia6eHzndhALG iUrQ== X-Gm-Message-State: AOPr4FX8jhhGv7SL5ZQWAzQyAFBoj6LcFzPnE49JCjEVBAU+Gre3ap6qqjTlC3KncK4Rlw== X-Received: by 10.202.182.69 with SMTP id g66mr3350943oif.26.1463551529376; Tue, 17 May 2016 23:05:29 -0700 (PDT) Original-Received: from Vulcan.local (76-234-68-79.lightspeed.frokca.sbcglobal.net. [76.234.68.79]) by smtp.gmail.com with ESMTPSA id a95sm1915340oic.16.2016.05.17.23.05.28 (version=TLS1 cipher=AES128-SHA bits=128/128); Tue, 17 May 2016 23:05:28 -0700 (PDT) X-Google-Original-From: "John Wiegley" Original-Received: by Vulcan.local (Postfix, from userid 501) id 2FD7E56BC96; Tue, 17 May 2016 23:05:26 -0700 (PDT) Mail-Followup-To: Lars Ingebrigtsen , emacs-devel@gnu.org In-Reply-To: <87vb2jxbb9.fsf@gnus.org> (Lars Ingebrigtsen's message of "Thu, 12 May 2016 22:37:14 +0200") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/25.0.93 (darwin) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:4003:c06::230 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:203882 Archived-At: >>>>> Lars Ingebrigtsen writes: > 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. Sure, but there's no reason to be aggressive about it. The content is the really important thing. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2