From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Terminology in multi-tty primitives Date: Mon, 29 Dec 2008 21:26:54 +0200 Message-ID: References: <87zlihi05s.fsf@cyd.mit.edu> <878wq0j52s.fsf@cyd.mit.edu> <87prjbh7j6.fsf@cyd.mit.edu> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1230578828 8052 80.91.229.12 (29 Dec 2008 19:27:08 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 29 Dec 2008 19:27:08 +0000 (UTC) Cc: emacs-devel@gnu.org To: Chong Yidong Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Dec 29 20:28:15 2008 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LHNmc-0006Ev-Ed for ged-emacs-devel@m.gmane.org; Mon, 29 Dec 2008 20:28:10 +0100 Original-Received: from localhost ([127.0.0.1]:53378 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LHNlO-0001IH-Q1 for ged-emacs-devel@m.gmane.org; Mon, 29 Dec 2008 14:26:54 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LHNlK-0001I0-QA for emacs-devel@gnu.org; Mon, 29 Dec 2008 14:26:50 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LHNlK-0001HX-5n for emacs-devel@gnu.org; Mon, 29 Dec 2008 14:26:50 -0500 Original-Received: from [199.232.76.173] (port=36881 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LHNlJ-0001HR-Ux for emacs-devel@gnu.org; Mon, 29 Dec 2008 14:26:50 -0500 Original-Received: from mtaout5.012.net.il ([84.95.2.13]:27261) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LHNlJ-00014U-J5 for emacs-devel@gnu.org; Mon, 29 Dec 2008 14:26:49 -0500 Original-Received: from conversion-daemon.i_mtaout5.012.net.il by i_mtaout5.012.net.il (HyperSendmail v2004.12) id <0KCN00J00K6MPU00@i_mtaout5.012.net.il> for emacs-devel@gnu.org; Mon, 29 Dec 2008 21:28:51 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([77.126.252.83]) by i_mtaout5.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KCN00HODKS3EUF1@i_mtaout5.012.net.il>; Mon, 29 Dec 2008 21:28:51 +0200 (IST) In-reply-to: <87prjbh7j6.fsf@cyd.mit.edu> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by monty-python.gnu.org: Solaris 9.1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:107385 Archived-At: > From: Chong Yidong > Cc: emacs-devel@gnu.org > Date: Mon, 29 Dec 2008 00:31:09 -0500 > > > But again, maybe I'm the only one who is confused. My confusion is > > exasperated by the fact that I cannot find any useful methodical way > > to describe all these functions with partially overlapping > > functionality in the ELisp manual. Suggestions welcome... > > As far as frame creation goes, there is just one primary Elisp interface > for making frames: the function `make-frame'. The frame parameters > passed to `make-frame' determine where the frame appears. The commands > `make-frame-on-display' and `make-frame-on-tty' exist just for > convenience: their purpose is to allow the user to interactively specify > a display or tty name to `make-frame', using the minibuffer. Internal > functions, such as x-create-frame-with-faces and > tty-create-frame-with-faces, should not be documented in the Elisp > manual. Thanks, but what I'm trying to do is arrange the new multi-tty functions into some logical order of a few sections. These are not limited to frame creation functions, see the corresponding portion of etc/NEWS. Maybe I should just stop trying to describe them together, and instead put every function where it belongs elsewhere in the manual...