all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Glenn Morris <rgm@gnu.org>
To: emacs-devel@gnu.org
Subject: "Position Parameters" in lispref/frames.texi
Date: Sun, 20 Jan 2008 21:32:21 -0500	[thread overview]
Message-ID: <mwbq7fvrgq.fsf@fencepost.gnu.org> (raw)


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

             reply	other threads:[~2008-01-21  2:32 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2008-01-21  2:32 Glenn Morris [this message]
2008-01-21  2:44 ` "Position Parameters" in lispref/frames.texi Glenn Morris
2008-01-21  9:32   ` martin rudalics
2008-01-22  5:50     ` Ulrich Neumerkel
2008-01-22  6:34       ` Glenn Morris
2008-01-22  6:37         ` Ulrich Neumerkel
2008-01-22 11:30     ` Richard Stallman
2008-01-21 20:30   ` Richard Stallman
2008-01-21 20:30 ` Richard Stallman

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=mwbq7fvrgq.fsf@fencepost.gnu.org \
    --to=rgm@gnu.org \
    --cc=emacs-devel@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.