Commit 875fc30c authored by Glenn Morris's avatar Glenn Morris
Browse files

(Position Parameters): Clarify the description of `left' and `top',

using information from "Geometry".
(Geometry): Give a pointer to "Position Parameters", rather than
repeating information.
parent 7f48376e
2008-02-22 Glenn Morris <rgm@gnu.org>
* frames.texi (Position Parameters): Clarify the description of
`left' and `top', using information from "Geometry".
(Geometry): Give a pointer to "Position Parameters", rather than
repeating information.
2008-02-11 Glenn Morris <rgm@gnu.org> 2008-02-11 Glenn Morris <rgm@gnu.org>
* objects.texi (Equality Predicates): No longer talk about "two" * objects.texi (Equality Predicates): No longer talk about "two"
......
...@@ -396,26 +396,34 @@ text-only terminals they count characters or lines instead. ...@@ -396,26 +396,34 @@ text-only terminals they count characters or lines instead.
@table @code @table @code
@item left @item left
The screen position of the left edge, in pixels, with respect to the The screen position of the left (or right) edge, in pixels, with respect
left edge of the screen. The value may be a positive number @var{pos}, to the left (or right) edge of the screen. The value may be:
or a list of the form @code{(+ @var{pos})} which permits specifying a
negative @var{pos} value. @table @asis
@item an integer
A negative number @minus{}@var{pos}, or a list of the form @code{(- A positive integer relates the left edge of the frame to the left edge
@var{pos})}, actually specifies the position of the right edge of the of the screen. A negative integer relates the right frame edge to the
window with respect to the right edge of the screen. A positive value right screen edge.
of @var{pos} counts toward the left. @strong{Reminder:} if the
parameter is a negative integer @minus{}@var{pos}, then @var{pos} is @item @code{(+ @var{pos})}
positive. This specifies the position of the left frame edge relative to the left
screen edge. The integer @var{pos} may be positive or negative; a
negative value specifies a position outside the screen.
@item @code{(- @var{pos})}
This specifies the position of the right frame edge relative to the right
screen edge. The integer @var{pos} may be positive or negative; a
negative value specifies a position outside the screen.
@end table
Some window managers ignore program-specified positions. If you want to Some window managers ignore program-specified positions. If you want to
be sure the position you specify is not ignored, specify a be sure the position you specify is not ignored, specify a
non-@code{nil} value for the @code{user-position} parameter as well. non-@code{nil} value for the @code{user-position} parameter as well.
@item top @item top
The screen position of the top edge, in pixels, with respect to the The screen position of the top (or bottom) edge, in pixels, with respect
top edge of the screen. It works just like @code{left}, except vertically to the top (or bottom) edge of the screen. It works just like
instead of horizontally. @code{left}, except vertically instead of horizontally.
@item icon-left @item icon-left
The screen position of the left edge @emph{of the frame's icon}, in The screen position of the left edge @emph{of the frame's icon}, in
...@@ -884,28 +892,9 @@ values are @code{left}, @code{top}, @code{width}, and @code{height}. ...@@ -884,28 +892,9 @@ values are @code{left}, @code{top}, @code{width}, and @code{height}.
For the size parameters, the value must be an integer. The position For the size parameters, the value must be an integer. The position
parameter names @code{left} and @code{top} are not totally accurate, parameter names @code{left} and @code{top} are not totally accurate,
because some values indicate the position of the right or bottom edges because some values indicate the position of the right or bottom edges
instead. These are the @var{value} possibilities for the position instead. The @var{value} possibilities for the position parameters are:
parameters: an integer, a list @code{(+ @var{pos})}, or a list @code{(- @var{pos})};
as previously described (@pxref{Position Parameters}).
@table @asis
@item an integer
A positive integer relates the left edge or top edge of the window to
the left or top edge of the screen. A negative integer relates the
right or bottom edge of the window to the right or bottom edge of the
screen.
@item @code{(+ @var{position})}
This specifies the position of the left or top edge of the window
relative to the left or top edge of the screen. The integer
@var{position} may be positive or negative; a negative value specifies a
position outside the screen.
@item @code{(- @var{position})}
This specifies the position of the right or bottom edge of the window
relative to the right or bottom edge of the screen. The integer
@var{position} may be positive or negative; a negative value specifies a
position outside the screen.
@end table
Here is an example: Here is an example:
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment