--- Begin Message ---
Subject: |
24.3.50; Elisp manual: mention what units are used for window margin functions |
Date: |
Fri, 13 Sep 2013 15:17:31 -0700 (PDT) |
(elisp) `Display Margins` talks a lot about window margins, but AFAICT
it never once says which units are used for the functions and variables
described there. I'm guessing the unit is `frame-char-width', but Emacs
should tell us explicitly here.
Moreover, we don't even tell users what a nil value means, as opposed
to a whole number.
For example, right now, `M-: (window-margins)' returns `(nil)' for me,
which corresponds to both LEFT and RIGHT being nil. What does a nil
value mean for each of these?
In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
of 2013-08-31 on ODIEONE
Bzr revision: 114088 address@hidden
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --prefix=/c/Devel/emacs/binary --enable-checking=yes,glyphs
'CFLAGS=-O0 -g3' LDFLAGS=-Lc:/Devel/emacs/lib
CPPFLAGS=-Ic:/Devel/emacs/include'
--- End Message ---
--- Begin Message ---
Subject: |
Re: bug#15375: 24.3.50; Elisp manual: mention what units are used for window margin functions |
Date: |
Sat, 14 Sep 2013 19:33:42 +0300 |
> Date: Sat, 14 Sep 2013 09:26:42 -0700 (PDT)
> From: Drew Adams <address@hidden>
> Cc: address@hidden
>
> 1. Move the "(a.k.a.@: ``column'')" to the first occurrence of "character
> cell". I, for one, did not know the latter term, and wondered about it
> until I got to that aka.
>
> 2. You can remove this part, as it is implied: "; if none of the two margins
> exist, the function returns @code{(nil)}." (It does not hurt, but in that
> case please change "none" to "neither", to be clearer.)
>
> 3. You should add a comma before "and" in "The argument @var{left} controls
> the left margin and @var{right} controls the right margin (default @code{0})."
> ,
> Alternatively, you can use ";" instead of ", and", or split it into two
> sentences.
Done.
--- End Message ---