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#57890: 28.1; Doc string of `initial-frame-alist' Date: Sun, 18 Sep 2022 16:08:03 +0000 Message-ID: References: <83o7vdz1gl.fsf@gnu.org> 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="35269"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "57890@debbugs.gnu.org" <57890@debbugs.gnu.org> To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Sep 18 18:09:25 2022 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 1oZwrD-0008xT-3B for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 18 Sep 2022 18:09:23 +0200 Original-Received: from localhost ([::1]:57464 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oZwrB-000392-Ni for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 18 Sep 2022 12:09:21 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54056) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oZwqs-00038c-Sl for bug-gnu-emacs@gnu.org; Sun, 18 Sep 2022 12:09:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52021) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oZwqs-0000vq-L1 for bug-gnu-emacs@gnu.org; Sun, 18 Sep 2022 12:09:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oZwqs-0004VC-FW for bug-gnu-emacs@gnu.org; Sun, 18 Sep 2022 12:09: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: Sun, 18 Sep 2022 16:09:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 57890 X-GNU-PR-Package: emacs Original-Received: via spool by 57890-submit@debbugs.gnu.org id=B57890.166351729317245 (code B ref 57890); Sun, 18 Sep 2022 16:09:02 +0000 Original-Received: (at 57890) by debbugs.gnu.org; 18 Sep 2022 16:08:13 +0000 Original-Received: from localhost ([127.0.0.1]:51097 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oZwq5-0004U5-8G for submit@debbugs.gnu.org; Sun, 18 Sep 2022 12:08:13 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:6174) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oZwq1-0004Tt-0c for 57890@debbugs.gnu.org; Sun, 18 Sep 2022 12:08:12 -0400 Original-Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 28I8NOZI029950; Sun, 18 Sep 2022 16:08:07 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2022-7-12; bh=NsVo6xc+5sQ5J5FB4qgz/Fe5jep+NP/DlX7KZqUlIuU=; b=R/P4XNYZ8OfW0sYhYFguvodcwHbBinRCnLnyMynUHcKpkYqnrbfsRMAqZKmebLQrelyG yKFrsJv7PRIj9o5CGp4Vno13r5Ffj2VnKKJXgxDcdbrst6fh+COWY51COXg7oY5bpkGf O9IW+zvURr8PwIvxgQ5Cs+v1qWDmv9/6h1bnkV2anCEj2x/Zha+sW3WxV1ZajbZbTMwZ TDy6U9kXihjw4EYpuqLgTOK28TxFD1msiIG30aj4ffkSXgIJEgs9w1YnfDnXUFt7Uu6K MPj0D7RNuHhj28I8cDYAKZpO2SbYcGkmU9L6h7jLN0wgDgTPYgYZE6SAVrfp1npIbldG yQ== Original-Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3jn68ra1vq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 18 Sep 2022 16:08:06 +0000 Original-Received: from pps.filterd (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 28ICMrSI035914; Sun, 18 Sep 2022 16:08:05 GMT Original-Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2169.outbound.protection.outlook.com [104.47.55.169]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3jp39h32cf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 18 Sep 2022 16:08:05 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=m8ad49ahM0xFlSjaS+EYjV+GIiHZm9WDsKv26W16Wi9J+1eNqt2DvP+uNPJ1fSQDAKlLScgK0+4hmkTARSbOQsHXcWTuWn5BsTvzHtdOCd5xck73bgTx81U65lhMipyX/HFzGkLjww4XkqhBK7FuCZrMOrrrg1KuVlBwOmLsmbAEwpalssR+l6INBJVe4ONl8/0Q1EwcnK9LQ2naTR08xMSr6kNJkADiOAcTewfn9dIO+NQvQeFMmk2F+L7F3BXeNMaBbBEhBIYAWH9eVllYiOuHeR+rZDP8kAhw8uSZyYi9A7+QkpDlH5K2PJeE6thH4WN2DATDjch7AwCbom1Zog== 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=NsVo6xc+5sQ5J5FB4qgz/Fe5jep+NP/DlX7KZqUlIuU=; b=BF+cvu7NijyUIQfMPbBY6BgXkOb7PlPdz9+mfMhZ1q4gQvkECxsGU/sxGQ7iZ0wCXtKuNK20/rqVCEPZ9gnBHscMurTnjtZWWHdp1v9j9thQ+fMGa1ZIsti+xUHqpqLKF61T9g/G0AOOOZcc1oGytCyuHlsN7y7uCKKu+7pyPZi8u8BfHMfzyUZCiksjM4MJYbwbKg1fCFRmIQnSvm6YQOdAOIJ+E9Cn5WHemzQ/8jHFxWoyjzdZjTEwHZSldaQIGdAH7HoT3aLpm1kzTDrybhZKixVIZrmAVwNOFAedAkeKCz+S6bAQiwhB6DQAnRpUbPN1NDdhJigFUuymbYJXUw== 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=NsVo6xc+5sQ5J5FB4qgz/Fe5jep+NP/DlX7KZqUlIuU=; b=h5GgyHtFkFks8jGRJihYG9TCGRMFnnTc2Id4LSk3OLSP484nYCCpockLy+HOwstX704y4NwUI3IHQdqo0BA3bKbgmkO83WVsY4tdWGUErcf4ANAHGRumfaNKBfwbQ8DEd5glZU8q5qxIq46SZWYuoD1OHvKYMyfvKzYx23YRo2M= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by MW4PR10MB5812.namprd10.prod.outlook.com (2603:10b6:303:18e::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5632.17; Sun, 18 Sep 2022 16:08:03 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::39f7:f1e6:c5ea:252]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::39f7:f1e6:c5ea:252%5]) with mapi id 15.20.5632.019; Sun, 18 Sep 2022 16:08:03 +0000 Thread-Topic: [External] : Re: bug#57890: 28.1; Doc string of `initial-frame-alist' Thread-Index: AdjK46tPkqwV9BLLRKi8Sgjut1ep0AAPT9vRABXMfPA= In-Reply-To: <83o7vdz1gl.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|MW4PR10MB5812:EE_ x-ms-office365-filtering-correlation-id: ee8f6651-c18c-4619-4e9b-08da998ff712 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: W8Q+K3dCdCHf311NwqfVaD0Px3FcKhKn3toXTv4Y7InSxsA/Bwq0AcameiNKKdpPltkRuXKgu9CN3JiUP9fBqwAbGGTcYcbQeWnMIi6NafMhV6BIg6SPTKa5tlxZXtpEeSj2rgeM1EyhwhB/sSahosw9W7XRhgYAVbOFHdK0q8WLbhiyqdVvP1XHDK28ic2nOKhON1/uPjgMKBknhKugjwAyYxeo00sf18sjKVfHV6UbczX+hr1TyJJ0BNv/dowNwfou4FJ4u8eCyYuxdDyS1LNWEcgwxBQFEUuQSmJcii0L8UoCi4lOnnD2NNEuC4m1xoShPtenp8L84AZXF8ndDDBdW1UqRWxmlygRG0ALr55D1jID7Hxe/DQwbMoKiRarxtFsuPXLw4v/q16uBbgMSPfFp3BMj9D/MxjVfySILs68xzoYWURsIGW/oSlV21LtA7/gLGbN8ZmOOwl6lueRoivhyX2ahtbvSvNJxagwmkwbgzAZNw53dY9Ew3IjQyxnYdUosZ2hcjyJ3ZSdS17UjIN+4z4k1KFKcdw9aK9LsLMUbBXyacP2hpvY1t+cBsOza6bdw9/Y0MUTS91WfWV5ukgsjzeSQ0qbdxWU6TNAOUtoSzS6OqQXLiwSjYsjkWFuKdvikzkJdFMRi3k3yEVaOXfB2CIdPLROkbUkTJwQ2dik6W6rd1bWGqIxxRrdBh7u02YVoYp8H/EErU8gbe9fmW3nqKFPMsHiSoqFilbZBQj723dYVRAKWSxGgfBsj +N9CImyD82xaN22kzdFe/zH+aaM1ObuspeSJvrGOne89Z8= 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:(13230022)(136003)(366004)(39860400002)(376002)(346002)(396003)(451199015)(86362001)(38070700005)(38100700002)(122000001)(33656002)(52536014)(44832011)(2906002)(9686003)(83380400001)(26005)(6506007)(186003)(7696005)(66556008)(66446008)(64756008)(66946007)(478600001)(66476007)(8676002)(316002)(41300700001)(76116006)(4326008)(5660300002)(55016003)(71200400001)(8936002)(6916009)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: YHEGRbY4KfpyRdTduymo10eKkl81LcqZY+9VWvaMd9ViPtaldW9zae2NI2bjqOEQqL+oyROs+TZRpOkIrQp1XeSBm1rHbzBg5PjDjyMnatdvOYtIQAeLtI9l+0638prY/gfotdiLTVgJL5gn9UAP+OQKqDcfCcU2MoSjYLkQpes11DxPGvMt4+kO/he+nzvUIDidgkwIVcmsHP1JnXJD4Km0qskJXGjMEtX/ytHyMtVun+j6KYQ2AApPsTLW36Wt9vUH3EqeI6oGiVVeICGADnHPglkfHcIvcTO4wRcWoIK1XyoVYUvvNaef8LUttPMfnFqUv2FR2v2frozXH9SklAGFCH0Sf0T/vHE4C8MDMo3FKjcSEn4fdc25LFgR/F5B2MJEjFX9JQhAaDO0y0wTFJUNlwJOOSKCjLN1Y1vW+lHYVavYmc2Qt7YADM+tVHCZ4wsjuP/CYVhurccntC6JyZgxzJUIfUX9yESOYPT8OcIn/GtgbLu/sidZbd7nD91Xm2VvQtUtTJEW/8L0WYQ8GT9z7WPEu1VsZSChSYO3AimwWanCIwMSrbfu+Tmr4UkGplnxA64pW3CZAiul+VMWTzghjbJe3rY7kYJ5EUn7oWjbjbfqcrH8SwMwJldIDXEvtDyY923ikDUPJNxkPK4Flz1kM65jwDcCJsgFso0n9yAGBbiwydfocrXNLbT90J/r1PusoYzglsa0Fkty9W7Hcr6nRzpSyNqStmR+Nld5ddszRVes+SCciOi1xi lfJxxdvR6kH/aEd/kP1mFBkT4tAvJSQ7I8w6VmFDlH0LMvThZepwINw5liFqEdwxYr/BTKruKQ++lr00Ze1JVShBzWirKB3yz4 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: ee8f6651-c18c-4619-4e9b-08da998ff712 X-MS-Exchange-CrossTenant-originalarrivaltime: 18 Sep 2022 16:08:03.0266 (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: F1YhyVjYcvW/8HcRkp0CrxmnjKtOx4LNB8QHNWQIIl2mSnvPACbQCSy3mB2aMGW2H+giuH4KclwvA9dK+Le65w== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR10MB5812 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.895,Hydra:6.0.528,FMLib:17.11.122.1 definitions=2022-09-18_08,2022-09-16_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 bulkscore=0 malwarescore=0 spamscore=0 mlxscore=0 adultscore=0 mlxlogscore=933 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2209130000 definitions=main-2209180123 X-Proofpoint-GUID: Pb7PtInds4c_shFaj3JFM0wMoc3YDYga X-Proofpoint-ORIG-GUID: Pb7PtInds4c_shFaj3JFM0wMoc3YDYga 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" Xref: news.gmane.io gmane.emacs.bugs:243002 Archived-At: > > The doc string seems to suggest that the option, or its use, somehow > > depends on X resources: >=20 > And it does. So I don't understand the complaint. Complaint? It depends on X resources if you have X resources. I'm on MS Windows, for example. Nothing about X resources is relevant to `initial-frame-list' on that platform, IIUC. It's fine to mention platform or other non-Emacs features in the doc string. But just make clear that that's what they are. E.g., "IF...". > > That text is not introduced by anything saying, e.g., IF you are > > using X resources or by saying that this 3-step process is > > applicable only if you can use X resources. At least some of it > > doesn't make sense without X resources, AFAIK. >=20 > Doc strings are not nodes in a manual, they cannot have introductions > and terminology explanations. They are succinct and assume some level > of general knowledge. Yes. And? This doc string includes platform-specific info without saying that's what it is, no? If you want to make it more succinct, and leave out that X resources info, that's also a way to remedy the confusion.