From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.devel Subject: "Position Parameters" in lispref/frames.texi Date: Sun, 20 Jan 2008 21:32:21 -0500 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1200882781 26655 80.91.229.12 (21 Jan 2008 02:33:01 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 21 Jan 2008 02:33:01 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jan 21 03:33:20 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 1JGmTO-0004qw-Dh for ged-emacs-devel@m.gmane.org; Mon, 21 Jan 2008 03:33:18 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JGmSz-0002EM-0j for ged-emacs-devel@m.gmane.org; Sun, 20 Jan 2008 21:32:53 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JGmSV-0001f2-Li for emacs-devel@gnu.org; Sun, 20 Jan 2008 21:32:23 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JGmSU-0001dL-Gw for emacs-devel@gnu.org; Sun, 20 Jan 2008 21:32:23 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JGmSU-0001d1-7J for emacs-devel@gnu.org; Sun, 20 Jan 2008 21:32:22 -0500 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1JGmSU-0001s4-06 for emacs-devel@gnu.org; Sun, 20 Jan 2008 21:32:22 -0500 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.67) (envelope-from ) id 1JGmST-0002xW-J1; Sun, 20 Jan 2008 21:32:21 -0500 X-Spook: Dateline Dick Cheney MD4 pipeline Commecen TELINT ANDVT X-Ran: mw)e8A]_`%4@hKu'}4o>&>Z{zSm/2BPjGUw@SaZJ_ep&O,oNuOwmM[/^$=9xig{r 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:87162 Archived-At: I find the documentation of `left' in the `Position Parameters' node in frames.texi very confusing. The value may be a positive number POS, or a list of the form `(+ POS)' which permits specifying a negative POS value. What? (+ POS) permits a negative POS value? *Reminder:* if the parameter is a negative integer -POS, then POS is positive. What? Is this just trying to explain "-(-1) = +1" ? I propose just removing these confusing parts. It reads much better without them. *** frames.texi 7 Jan 2008 08:49:05 -0000 1.124.2.7 --- frames.texi 21 Jan 2008 02:27:00 -0000 *************** *** 390,404 **** @item left The screen position of the left edge, in pixels, with respect to the left edge of the screen. The value may be a positive number @var{pos}, ! or a list of the form @code{(+ @var{pos})} which permits specifying a ! negative @var{pos} value. A negative number @minus{}@var{pos}, or a list of the form @code{(- @var{pos})}, actually specifies the position of the right edge of the window with respect to the right edge of the screen. A positive value ! of @var{pos} counts toward the left. @strong{Reminder:} if the ! parameter is a negative integer @minus{}@var{pos}, then @var{pos} is ! positive. Some window managers ignore program-specified positions. If you want to be sure the position you specify is not ignored, specify a --- 390,401 ---- @item left The screen position of the left edge, in pixels, with respect to the left edge of the screen. The value may be a positive number @var{pos}, ! or a list of the form @code{(+ @var{pos})}. A negative number @minus{}@var{pos}, or a list of the form @code{(- @var{pos})}, actually specifies the position of the right edge of the window with respect to the right edge of the screen. A positive value ! of @var{pos} counts toward the left. Some window managers ignore program-specified positions. If you want to be sure the position you specify is not ignored, specify a