* doc/lispref/display.texi (Display-Margins): Clarify that
left/right-margin-width can not be used to determine the current margin width,
and that window-margins must be used instead.
Setting these variables does not immediately affect the window. These
variables are checked when a new buffer is displayed in the window.
Thus, you can make changes take effect by calling
-@code{set-window-buffer}.
+@code{set-window-buffer}. Do not use these variables to try to
+determine the current width of the left or right margin. Instead, use
+the function @code{window-margins}.
You can also set the margin widths immediately.