emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

"Position Parameters" in lispref/frames.texi


From: Glenn Morris
Subject: "Position Parameters" in lispref/frames.texi
Date: Sun, 20 Jan 2008 21:32:21 -0500
User-agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/)

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 @address@hidden, 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 @address@hidden, 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 @address@hidden, 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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]