From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Andreas Schwab Newsgroups: gmane.emacs.devel Subject: Re: Paragraph styles in doc strings Date: Mon, 09 May 2016 17:22:46 +0200 Message-ID: References: <878tzjjn3w.fsf@gnus.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1462808095 29592 80.91.229.3 (9 May 2016 15:34:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 9 May 2016 15:34:55 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon May 09 17:34:41 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 1azn1Q-00028c-Tz for ged-emacs-devel@m.gmane.org; Mon, 09 May 2016 17:23:01 +0200 Original-Received: from localhost ([::1]:41890 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1azn1Q-0005Ed-6F for ged-emacs-devel@m.gmane.org; Mon, 09 May 2016 11:23:00 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56370) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1azn1J-00058j-IP for emacs-devel@gnu.org; Mon, 09 May 2016 11:22:57 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1azn1E-00059C-Mg for emacs-devel@gnu.org; Mon, 09 May 2016 11:22:52 -0400 Original-Received: from mx2.suse.de ([195.135.220.15]:52463) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1azn1E-00058x-AD for emacs-devel@gnu.org; Mon, 09 May 2016 11:22:48 -0400 X-Virus-Scanned: by amavisd-new at test-mx.suse.de Original-Received: from relay1.suse.de (charybdis-ext.suse.de [195.135.220.254]) by mx2.suse.de (Postfix) with ESMTP id 98F14AB1A for ; Mon, 9 May 2016 15:22:46 +0000 (UTC) X-Yow: Look into my eyes and try to forget that you have a Macy's charge card! In-Reply-To: <878tzjjn3w.fsf@gnus.org> (Lars Ingebrigtsen's message of "Mon, 09 May 2016 16:57:07 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x (no timestamps) [generic] X-Received-From: 195.135.220.15 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:203718 Archived-At: Lars Ingebrigtsen writes: > There seems to be three popular paragraph styles in Emacs doc strings. > > Indentation: > > ----- > (directory-files DIRECTORY &optional FULL MATCH NOSORT) > > Return a list of names of files in DIRECTORY. > There are three optional arguments: > If FULL is non-nil, return absolute file names. Otherwise return names > that are relative to the specified directory. > If MATCH is non-nil, mention only file names that match the regexp MATC= H. > If NOSORT is non-nil, the list is not sorted--its order is unpredictabl= e. > Otherwise, the list returned is sorted with =E2=80=98string-lessp=E2=80= =99. > NOSORT is useful if you plan to sort the result yourself. > ----- This isn't a paragraph style, but a list style, only without bullet points or numbering. In a typeset document there wouldn't be extra space between the items. Andreas. --=20 Andreas Schwab, SUSE Labs, schwab@suse.de GPG Key fingerprint =3D 0196 BAD8 1CE9 1970 F4BE 1748 E4D4 88E3 0EEA B9D= 7 "And now for something completely different."