From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.devel Subject: Re: master 305dbc7 2/4: Move description of value to syntax-ppss function. Date: Wed, 30 Oct 2019 16:03:17 +0100 Message-ID: <87eeyutgwa.fsf@gnus.org> References: <20191030121649.15369.13207@vcs0.savannah.gnu.org> <20191030121651.BFCF8204DF@vcs0.savannah.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="265734"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 30 16:04:33 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.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iPpWS-001701-V1 for ged-emacs-devel@m.gmane.org; Wed, 30 Oct 2019 16:04:33 +0100 Original-Received: from localhost ([::1]:41328 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iPpWR-0006uD-Cu for ged-emacs-devel@m.gmane.org; Wed, 30 Oct 2019 11:04:31 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38588) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iPpVP-0006jI-Hj for emacs-devel@gnu.org; Wed, 30 Oct 2019 11:03:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iPpVK-0006Ui-GW for emacs-devel@gnu.org; Wed, 30 Oct 2019 11:03:27 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:52448) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iPpVK-0006PS-8s for emacs-devel@gnu.org; Wed, 30 Oct 2019 11:03:22 -0400 Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iPpVG-00080o-6R; Wed, 30 Oct 2019 16:03:20 +0100 In-Reply-To: (Dmitry Gutov's message of "Wed, 30 Oct 2019 16:59:34 +0200") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 80.91.231.51 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.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:241623 Archived-At: Dmitry Gutov writes: > A bit of a problem with this change is the syntax-ppss doscstring > originally said (and still contains these words): > > except that values at positions 2 and 6 > in the returned list (counting from 0) cannot be relied upon. > > So documenting them in this function is... not logical? It's slightly illogical, but it's documented that they "can't be relied upon", whatever that means. And splitting up the documentation over the two functions seemed even worse. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no