From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#31349: 27.0; Doc of `up-list' Date: Wed, 2 May 2018 17:45:17 -0700 (PDT) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1525308247 5153 195.159.176.226 (3 May 2018 00:44:07 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 3 May 2018 00:44:07 +0000 (UTC) To: 31349@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu May 03 02:44:03 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fE2Lr-0001FA-5e for geb-bug-gnu-emacs@m.gmane.org; Thu, 03 May 2018 02:44:03 +0200 Original-Received: from localhost ([::1]:53207 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fE2Ny-0000Xl-0J for geb-bug-gnu-emacs@m.gmane.org; Wed, 02 May 2018 20:46:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57065) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fE2Nq-0000XR-TP for bug-gnu-emacs@gnu.org; Wed, 02 May 2018 20:46:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fE2Nm-0007pi-UZ for bug-gnu-emacs@gnu.org; Wed, 02 May 2018 20:46:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:39585) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fE2Nm-0007pc-Qq for bug-gnu-emacs@gnu.org; Wed, 02 May 2018 20:46:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fE2Nm-000127-IF for bug-gnu-emacs@gnu.org; Wed, 02 May 2018 20:46:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 03 May 2018 00:46:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 31349 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.15253083372230 (code B ref -1); Thu, 03 May 2018 00:46:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 3 May 2018 00:45:37 +0000 Original-Received: from localhost ([127.0.0.1]:47482 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fE2NN-0000ZW-2k for submit@debbugs.gnu.org; Wed, 02 May 2018 20:45:37 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:37712) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fE2NL-0000Qa-2E for submit@debbugs.gnu.org; Wed, 02 May 2018 20:45:35 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fE2NE-0007Mf-LS for submit@debbugs.gnu.org; Wed, 02 May 2018 20:45:29 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:57233) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fE2NE-0007MS-CC for submit@debbugs.gnu.org; Wed, 02 May 2018 20:45:28 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56908) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fE2ND-0000OH-A0 for bug-gnu-emacs@gnu.org; Wed, 02 May 2018 20:45:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fE2N9-0007K1-1m for bug-gnu-emacs@gnu.org; Wed, 02 May 2018 20:45:27 -0400 Original-Received: from aserp2130.oracle.com ([141.146.126.79]:54026) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fE2N8-0007J4-Ni for bug-gnu-emacs@gnu.org; Wed, 02 May 2018 20:45:22 -0400 Original-Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w430al0L040747 for ; Thu, 3 May 2018 00:45:20 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=kluRQw6/RqDeUnJS6O/33ALi6gpJNktBehzFVaX7otA=; b=YYKqQ55EeyqG+KvdEdK8Ka1HYhMB+agXJkZucw+n2kqGJGNGtCqp41h4NTtUcJv4x3n/ 2cDM+u722kx0uQjTyefvVON3UoNZ3tzVTJ/tybxBcexKpzmekV9t62FcYbt32M++RUTz TnagWjjN8AJetMkXi9Du8SVQOfc454cyuyKkj9nsGAsUhGensflAn1h46APulQ0TqjGZ U1cN3pRMqojCJTEwr8bbc87PuZb5bEATqhV3hZaOAiQeOHXnrBVRLcOPJKS49zZeo57g /+eaSNnKrbZpRP5C1ivt7ODtVOl/zKcczgfuY9IB1oKulaztR39ha5wl5klxGDT7VN/C 2w== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp2130.oracle.com with ESMTP id 2hmeg5yk56-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 03 May 2018 00:45:20 +0000 Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w430jJuD020771 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 3 May 2018 00:45:19 GMT Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w430jIN5019097 for ; Thu, 3 May 2018 00:45:19 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4678.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8881 signatures=668698 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1805030004 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:145951 Archived-At: In Emacs 25, apparently, two additional optional args were added to `up-list'. But the doc added for the second of these args is not understandable, to me. The doc is identical for the doc string and the manual, so going to either from the other didn't help me understand. This is the description of the second new arg: If NO-SYNTAX-CROSSING is non-'nil' (as it is interactively), prefer to break out of any enclosing string instead of moving to the start of a list broken across multiple strings. On error, location of point is unspecified. Looking at the code briefly, it seems to concern not only strings but also comments. If so, shouldn't the description mention that? At any rate, I don't follow the description. Can you elaborate, perhaps giving an example? If I understand the behavior then perhaps I can help clarify the doc. Why were these args added? What use cases do they serve? (It's also not helpful or conventional to put descriptions of all args in the same paragraph.) In GNU Emacs 27.0.50 (build 3, x86_64-w64-mingw32) of 2018-03-21 Repository revision: e70d0c9e66d7a8609450b2889869d16aeb0363b5 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install -C 'CFLAGS=3D-O2 -static -g3''