From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#67382: 26.3; Emacs manual: clarify notions/names "visual line" and "screen line" Date: Wed, 22 Nov 2023 16:56:55 +0000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="13681"; mail-complaints-to="usenet@ciao.gmane.io" To: 67382@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Nov 22 17:58:15 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1r5qYI-0003JO-VN for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 22 Nov 2023 17:58:15 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r5qY6-0006Yw-0W; Wed, 22 Nov 2023 11:58:02 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r5qY3-0006Yj-N0 for bug-gnu-emacs@gnu.org; Wed, 22 Nov 2023 11:57:59 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1r5qY3-0002ch-Er for bug-gnu-emacs@gnu.org; Wed, 22 Nov 2023 11:57:59 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1r5qY6-0000EU-I5 for bug-gnu-emacs@gnu.org; Wed, 22 Nov 2023 11:58:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 22 Nov 2023 16:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 67382 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.1700672236833 (code B ref -1); Wed, 22 Nov 2023 16:58:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 22 Nov 2023 16:57:16 +0000 Original-Received: from localhost ([127.0.0.1]:59811 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r5qXL-0000DN-RX for submit@debbugs.gnu.org; Wed, 22 Nov 2023 11:57:16 -0500 Original-Received: from lists.gnu.org ([2001:470:142::17]:59698) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r5qXJ-0000D6-Lz for submit@debbugs.gnu.org; Wed, 22 Nov 2023 11:57:14 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r5qXA-0006Li-Ic for bug-gnu-emacs@gnu.org; Wed, 22 Nov 2023 11:57:04 -0500 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1r5qX8-0002WE-NY for bug-gnu-emacs@gnu.org; Wed, 22 Nov 2023 11:57:04 -0500 Original-Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 3AMGs0xv027633 for ; Wed, 22 Nov 2023 16:56:59 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=corp-2023-11-20; bh=s1NyVoU1AgLjvuu/vk+a4lyKCsSxwajZ8U74DGOmY5g=; b=RWOaXxd6SELK4fsURffyzgpXYC85/PNwJgN3zA9tQHddUs83Vtt/D7aclCI8mtKTLb5N 7ThRwhkp3HzQyjdvdsbs5Vd5broacRo2KGZgGzjpwiUnBYV/rYHcwU4dGRSQjqmogEDA SNHHgDjw5X/O2Op93pmBqmIxupq7/zZW2CO4GMjzfDddOiQ1fED/h73sv5W2MFS73aE9 BK+NuCNhY6y4taaBXKu0R4hb7+3jMzgUBWM4vfhfqLERggkdXmr6xkPL0seGa21scs/6 21qvhG/RX1r2semifMVzGdHg7pYMcQe0Jf0vYHIPMwtsmw+9OTj0FsG68Tj7G0ShDAIe tw== Original-Received: from phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta03.appoci.oracle.com [138.1.37.129]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3uem25002r-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 22 Nov 2023 16:56:59 +0000 Original-Received: from pps.filterd (phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.19/8.17.1.19) with ESMTP id 3AMG0WTe031234 for ; Wed, 22 Nov 2023 16:56:58 GMT Original-Received: from nam10-mw2-obe.outbound.protection.outlook.com (mail-mw2nam10lp2101.outbound.protection.outlook.com [104.47.55.101]) by phxpaimrmta03.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3uekq97j8j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 22 Nov 2023 16:56:58 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=TGDnMp5rNr+otp+cTCULF/wVSrQxXkyeqMv3SD8VEc7fL+jDT9GW0vPhPs2axganVMLC2tGCMJgFV/5oaDtL5HNmUWcHXyBqZf+cO1ducVAfTY8m/qncYaoAtDnmcGajNE9W7mlzbEg8DllH5vZxYzmFLtSYnQhrGKl3HXpsSccaV9tET2GzvD0JQ7eETBmCHrWaKRl/nFR/Q4IU1PqqrjYMBAsM4dJ7A6sYMJyuSUinsnsAaEiY8gnum5Hs6x2aleVs+CSpcaviI1zVu0Kh0nVRbOa5WRC6zdzSASzgPNNjhfy+SIwMO+YtlOm8c1IVlOYnXNNcyp458e6QlV5PXw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=s1NyVoU1AgLjvuu/vk+a4lyKCsSxwajZ8U74DGOmY5g=; b=UlWoqI5DBKvmCZ2wx+ZAqSmZsl+nww5XRoqJwGWNnMm8YenCl39PxWUzy+X0XKlYvUx9fQTCGK9KFtWjlHdCKaq0sTiH5RbIwfxaVl1YpDEX5J64+OzWUtHqU71WvmEri6W5irYcKbFkhyGvwjoH+JMIFWerPgqkf5P0AlMBkJtFlIW7/OwcwM8g6TNwOqpCwa6k6qpeO3NMr5Q2x7WBHXCwYxgZhRIFVvXzmI+IVG26Di8AoEDqtksm7AvoJ+0zosydNiM/+xTAVWZly8i6fol0/M6d6YjXUdZZhv3TYC9sj1RBmCv31lIlBFO0q/38PvUT/nFXkX3szrwAyg/x0A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=s1NyVoU1AgLjvuu/vk+a4lyKCsSxwajZ8U74DGOmY5g=; b=E62HDAF/xQYzKQypqU7jH8gadygBG4lGkAkLnnFFEpDLeV5aXb05zsVVoVIt6CkeblDyTRovDtk6wbZjDKZ1YQZraUDPj4o2X6DZBZH9i3rgVx86Rq2lYriHuCxPLPNgWfq1+IoYvGECG92CELNvk1V9xguRqAgNfEE89YKajS8= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by PH0PR10MB4583.namprd10.prod.outlook.com (2603:10b6:510:43::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7025.18; Wed, 22 Nov 2023 16:56:56 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::3b4c:a669:c229:47b4]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::3b4c:a669:c229:47b4%7]) with mapi id 15.20.7025.017; Wed, 22 Nov 2023 16:56:56 +0000 Thread-Topic: 26.3; Emacs manual: clarify notions/names "visual line" and "screen line" Thread-Index: AdodZMa3j/AuTYAHSTK3kJs1OH78MA== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|PH0PR10MB4583:EE_ x-ms-office365-filtering-correlation-id: 70f5bc47-2224-4b02-e9a0-08dbeb7c08da x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: uZNX1do2cBQTt2onALp6ezCcyyPQaHT4osk1iw8OPfQ3yb7OnKjD1FLUtjwnt5Dw8DHtpa7Wy7muhtqNrtqYbZZDnaY9zaybycp7huql2CPqB8JH5wAcSupo4xZcmtUO+dtBKikT9VhIUj2WK20+JJ6gF2uiPprsUz5hwhV+2IIdJ30++AGPD1nReZZYTwKkPDEmRlCNDxknzYNxkHncqn+Fr1QZEGCch492EREHSPVRfueDV0P4/mJwD5ceW8qiAaPehqoFkXFen9l+1xueo5NNyftp/Z5abCD/Nm0TIHrFHn5oRK6EV9PtM0fQToeTNIDTpkkyq5C0tpn11j4fBjTVwRbG//JhN7/wDSGQyyZICXoU4zBjJQjWObZUdFC6o1gv4WMnHMG0A4mLDPKezSgl73vnxeXUK6mG+8CO7YIaK7gr8jy9VbxH+Z/cLzu9Q4Y1ik7LBAQ2IyC28wFSZh8887j1OSvDV0tK4v27uZFpxjhnANpkq9vviSMQK67DrW0Nuni7+bb7MDYx5UwqES9nx9lbNzOKELvRE4ksR7UKPxIGVv6Y87MMlv3WSTqzxzO8UVlH5N9PTT0M8abJVc1ytO6TVMsF1ceGplqIihW1PIPBXV2JGpiPHQJDr5qH x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(346002)(39860400002)(136003)(376002)(366004)(396003)(230922051799003)(1800799012)(451199024)(64100799003)(186009)(122000001)(8936002)(86362001)(45080400002)(5660300002)(6506007)(66556008)(26005)(64756008)(38070700009)(478600001)(52536014)(7696005)(44832011)(66476007)(66946007)(66446008)(76116006)(6916009)(316002)(8676002)(2906002)(71200400001)(9686003)(33656002)(41300700001)(83380400001)(55016003)(38100700002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: 4uWSamyW36MeXIDnMOutsyu0ZKA7rAKNg0lvobSB4F4X0FsYZ+LHGPL2JJwYEt/ATo5ADPWYSNHpu1Cj5VmX1FE5gt6Zgy7fNvQpIYzvu0s2HE78MtgMXkcP7nx69MYnWz2s9rKk6TAy9XQPDO7cyoLdiF7vuBu0NWooCdz1B/OD0hD3VCy/gdlgGW7t7KJGeP8pY1+Doq07C56WqCRSmzUFEb/HH6/D37/mu/O4+7E7CT3vS3LhRinadufrdsmv2r2ROPSqY2UoAeO6VFN06Tg0bHS6vGOU3F4gNgH+ks9s887aCRXE86kwN6aCTEWzKeKzJAe3jSUHmbhJk2O7jTYF5z+tpZWtvEfcHXcGFrMUbSz4oWST7vdqk0dSs/cm0G5EXAD5OwtQW1N9H5CB7ueh1q30JTV/UPI5T0pu/yJ0DRbILyTvB4lPNhGkMcWexn3hJVPHH9qemoE4mfrhkCq7BSELgnOrGEO8BxyR2TXO2PKFjdjVHWsVURVa84gcrAqigp817tDVpKCyCDb/i4PtVWJQw+OKz75nHzKRL3j4QXEZKrJUTpeLP+xaq2zyGEJD9vST+W5zs+zcTxM2zWwHH64sIAuVWsMRiEFi8vBrZuwjWVnz1CS1Wg6KSYASJBwD4VE20w+wpT/KqJIvOo284JDakvv01p1itNCTo5GUPYHcMTJ+9DunAHEwr738YvkkXoEYZoBbi6UllnPFDDI9M8grkIeOL+Ki7ZRmiYX8o5dK0W/h6UyyIN ZOGr+6GqcCLsbmWDDDbGYhiDwysQ8QuXtnEXNcOBrvvd2JogrTkOJLN4Wcxoau5jkrQ/thH90ZY2jK4avUt96GNrct9zYz28Pr X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: kSX+ZSzEhv1XKglvFqWjtn2qFfmAVyZmyb/sx2CFTntWg/vevKlliNu21ugNPn+P2TYGCmxhJBujzl8QDhYPg9JHdU/+o+gWiydbR2dyZgm6Mzdt3FRHoIdjinf89E48XX3zZyIPevnxjzzeLeOujn2BN2Zrn2giCE1g8IuCmM+zY2PQUEeEgOEWE8cMJmvfw1EzjK8+S4M2wUt600y/hncl0k1E3PY+DSDnFZ/E6gaE/1s1jDOWBVwHma7vu+QZRmuQSw3VGfVi4FiE+nppjcGKls7s6vjvm7QV1Nv6o308iPD/SHsfjEQJO2NXE+CLP+KtF7nNCSqj+If0DzPVU862wefUi/x4DB3c1DbnnnQRLgzp7PjW28301fG3AtlsX3fbAxlOJgiLlKoAOtL1rYfuHD3iqM/7Z5ghw7KveXYYRVbBSgnql3Jtg3lV8lU5lKwl7o4Gnd5PNIP4ryn8Ruwqn0i3T4BMAm4l6uf75IZXX8pOf/45wNl5WC80TWuaGy2DNGBH0Jqw9SRMsz7OQ5GyjijhqbaM5Kaqymth+RklWIA+eGvWcUMnDKWKSL8A4Z+QVa/EECwL9lt2V/qOHlhnCbz12Bx0PI5h+YqW2owNlA+pxPJFpPdcVEprwP4F2aHN8NyZK05OlH35TQIP7eBWaFHmpPWxtKHYy9C207tHzVs8cPwjiZDNqqZz7JiOsUSrRE0z7wV2vcVNDS1jhfemF3DXJWjhVR3V6N6dobC8xt DQq19GUnuo0QOWR15s X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 70f5bc47-2224-4b02-e9a0-08dbeb7c08da X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Nov 2023 16:56:55.9475 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: HFF+oSQWdLeGYUwhUhnp+vm/Pc4+02SBh1hoYmjUgm6KtW0I6WJ0nkfsdRqUUl7EtKARVNLEtU0aTgVsQaSTDg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR10MB4583 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.987,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-11-22_12,2023-11-22_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 spamscore=0 bulkscore=0 malwarescore=0 mlxlogscore=999 adultscore=0 phishscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2311060000 definitions=main-2311220122 X-Proofpoint-GUID: AvMU2rmA7cvMggU7-BAY7oTMOxtow3yu X-Proofpoint-ORIG-GUID: AvMU2rmA7cvMggU7-BAY7oTMOxtow3yu Received-SPF: pass client-ip=205.220.177.32; envelope-from=drew.adams@oracle.com; helo=mx0b-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:274771 Archived-At: Close if you don't think this is a bug. But in that case please point to / explain where this is explained/defined in the manual. There are multiple functions/commands that have `visual' in their name, and refer to "visual lines". And there is `visual-line-mode', which is not necessarily involved/required for such functions. I haven't found a definition of "visual line" in the manual. But I do see a definition of "screen line", in node `Continuation Lines'. Is "visual line" synonymous with "screen line"? If so, should "visual line" replace "screen line", since there are line-oriented functions with `visual' in their name? Please take a look, and if relevant fix the manual to make this clear. Functions whose doc strings or manual doc refers to "visual line" should be able to be understood by referring to some definition/explanation of "visual line" in the manual. The only index entry matching "visual line" is for node `Visual Line Mode'. The Glossary refers only to "screen lines", not "visual lines" - there's no match for "visual" in the Glossary at all. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.19045 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''