From 4095436808b499ffb813daac6f7cea828318faa5 Mon Sep 17 00:00:00 2001 From: Chong Yidong Date: Sun, 10 Apr 2011 16:43:35 -0400 Subject: [PATCH] Doc fix for left-fringe and right-fringe parameters (Bug#6930) * doc/lispref/frames.texi (Layout Parameters): Note the difference between querying and setting parameters for left-fringe and right-fringe. --- doc/lispref/ChangeLog | 6 ++++++ doc/lispref/frames.texi | 21 ++++++++++++--------- 2 files changed, 18 insertions(+), 9 deletions(-) diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 440159a9a58..035fee67f8d 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,9 @@ +2011-04-10 Chong Yidong + + * frames.texi (Layout Parameters): Note the difference between + querying and setting parameters for left-fringe and right-fringe + (Bug#6930). + 2011-03-21 Stefan Monnier * minibuf.texi (Basic Completion): Be a bit more precise about the diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index a99782b95e1..0c81718750a 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -654,17 +654,20 @@ use the default width. @itemx right-fringe The default width of the left and right fringes of windows in this frame (@pxref{Fringes}). If either of these is zero, that effectively -removes the corresponding fringe. A value of @code{nil} stands for -the standard fringe width, which is the width needed to display the -fringe bitmaps. +removes the corresponding fringe. + +When you use @code{frame-parameter} to query the value of either of +these two frame parameters, the return value is always an integer. +When using @code{set-frame-parameter}, passing a @code{nil} value +imposes an actual default value of 8 pixels. The combined fringe widths must add up to an integral number of -columns, so the actual default fringe widths for the frame may be -larger than the specified values. The extra width needed to reach an -acceptable total is distributed evenly between the left and right -fringe. However, you can force one fringe or the other to a precise -width by specifying that width as a negative integer. If both widths are -negative, only the left fringe gets the specified width. +columns, so the actual default fringe widths for the frame, as +reported by @code{frame-parameter}, may be larger than what you +specify. Any extra width is distributed evenly between the left and +right fringe. However, you can force one fringe or the other to a +precise width by specifying that width as a negative integer. If both +widths are negative, only the left fringe gets the specified width. @item menu-bar-lines The number of lines to allocate at the top of the frame for a menu -- 2.11.4.GIT