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#43996: 26.3; Please document frame parameter `modeline' in the Elisp manual Date: Thu, 15 Oct 2020 08:18:25 -0700 (PDT) Message-ID: References: <87362gymmk.fsf@gnus.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="20075"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 43996@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Oct 15 17:19:39 2020 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 1kT52Y-00056m-Ey for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 15 Oct 2020 17:19:38 +0200 Original-Received: from localhost ([::1]:59904 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kT52X-0004Ku-0a for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 15 Oct 2020 11:19:37 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49342) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kT520-0004Jg-2F for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2020 11:19:06 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44677) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kT51y-0005e1-E6 for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2020 11:19:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kT51y-0006v5-AC for bug-gnu-emacs@gnu.org; Thu, 15 Oct 2020 11:19: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, 15 Oct 2020 15:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 43996 X-GNU-PR-Package: emacs Original-Received: via spool by 43996-submit@debbugs.gnu.org id=B43996.160277511426562 (code B ref 43996); Thu, 15 Oct 2020 15:19:02 +0000 Original-Received: (at 43996) by debbugs.gnu.org; 15 Oct 2020 15:18:34 +0000 Original-Received: from localhost ([127.0.0.1]:56223 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kT51W-0006uL-Ih for submit@debbugs.gnu.org; Thu, 15 Oct 2020 11:18:34 -0400 Original-Received: from aserp2130.oracle.com ([141.146.126.79]:39634) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kT51V-0006uA-Oj for 43996@debbugs.gnu.org; Thu, 15 Oct 2020 11:18:34 -0400 Original-Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 09FFEaBl151978; Thu, 15 Oct 2020 15:18:27 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=2Fc1ssyEpDfB/4/OAlnP6MrZsF8hwWAYEt76SUm5/oo=; b=WaQ3O2kGmwSo+BwBHlspLDA5qWo7tHoSJbidPWKU5OCFc90M9Z2MUj99Xsolj/5sdA9T nGcqzAFMknbrix9QKlU3wez/glf3oTHrpUicEZTCbsZq6LP1oNWz01MFpudWZ69dwVU/ t1GtbKvSIpjFMYGlvUEZITOWNiU7UAQZl2kaRJByFGKzS2M84M+hZvY3nfzU+Yl9aZLC 7YtMAL/WpJdmN2sTR+VRQLmjPdklMbZdaN2w6CrCIhPm2jHNyZNE6DqKOfdtCy67gwSE 4NlsKx2zVULZ2B9kmhvByArWRw9KM3xWACWkSE1Pjzl2WUQBDDfiD3luBhMKJtvKEapL og== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by aserp2130.oracle.com with ESMTP id 346g8gjep6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 15 Oct 2020 15:18:27 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 09FFFl3s070389; Thu, 15 Oct 2020 15:18:27 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserp3030.oracle.com with ESMTP id 343phr7cfh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 15 Oct 2020 15:18:27 +0000 Original-Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 09FFIQBZ025495; Thu, 15 Oct 2020 15:18:26 GMT In-Reply-To: <87362gymmk.fsf@gnus.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5056.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9774 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 spamscore=0 adultscore=0 bulkscore=0 mlxlogscore=999 malwarescore=0 mlxscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010150104 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9774 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 impostorscore=0 suspectscore=0 priorityscore=1501 phishscore=0 clxscore=1011 spamscore=0 adultscore=0 mlxscore=0 malwarescore=0 bulkscore=0 mlxlogscore=999 lowpriorityscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010150104 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:190597 Archived-At: > Where did you happen onto the modeline frame parameter? I see it when I invoke function `frame-parameters'. I don't have it in any of my code. It must be coming from Emacs itself. > Reading the code, it looks like internal bookkeeping, and is always set > on the C level from f->wants_modeline, which again is only set to false > in make_minibuffer_frame. Thanks for that info. That corresponds to what I see. I cannot add a mode-line to a standalone minibuffer frame, it seems. See bug #43997 for a request to be able to do that. > So it doesn't look like a frame parameter that can be set by the user, > if I'm reading the code correctly, and therefore shouldn't be documented. Can't be set, but can be seen. And you can _seemingly_ set it. You get no error or direct indication that it doesn't get set, when you try to set it. So at the very least, its visibility and apparent setting can mislead/confuse users. If it were entirely invisible from Lisp, then, yes, it wouldn't need to be described/explained. The fact that you can't really set it should maybe be doc'd. Or at least the fact that non-nil means there is a mode-line (or whatever it really means), and that a standalone minibuffer frame can't have a mode-line (but why not?).