RE: region face has no background by default for new frames?

[Drew Adams]

I took a look at
http://cvs.savannah.gnu.org/viewcvs/emacs/emacs/lispref/display.texi?rev=1.2
38&view=markup, and apparently it is the same as what I saw in my Emacs
build. So, my previous comments (below) would apply.

However, rereading the node, I see now that the opening statement in the
node does not apply to all functions in the node; it apparently applies only
to the first set of functions.

Perhaps that could be made more clear, possibly splitting the node to do so.
IOW, if it's necessary to read the intro statements to each group of
functions, in order to understand the functions of that group, then it needs
to be clear that there are groups (the scope of the group statements needs
to be clear).

Here are my comments on the manual, after understanding better the scope of
the intro statements. My comments below on the doc string stand (unless the
doc string has been changed). I still think the doc string and manual don't
jibe, and the manual description of the possible values of FRAME is
incomplete.

My earlier message is at the bottom, for comparison and for the doc-string
information.

Elisp node Attribute Functions:

nil:

    "If you don't specify FRAME, they refer to the default
    data for new frames." I don't know what the "default
    data for new frames" means. I don' t know what this is
    saying; sorry - maybe a cross reference would help?

t:

    Nothing explicit said about t. I don't know what a t
    value means.

a frame:

    Nothing explicit said about a frame arg. I don't know
    what a frame value means.

    -----Original Message-----

                I tried to clarify the test in the Emacs Lisp manual.
                Please take a look.

            Can you please tell me where to look?

        In the section which describes these functions, which I believe is
        Face Attribute Functions.

    I meant, where can I find the latest text? Where is it in
    relation, say, to this location:
    http://cvs.savannah.gnu.org/viewcvs/emacs/emacs/?

    If I look in the last Emacs version I have, which is probably
    before your corrections, the doc string and the Elisp manual
    seem to conflict. In some cases, the Elisp manual text
    contradicts itself or is ambiguous.

    In any case, it is not at all clear to me.

    1. doc string of face-background:

    nil:

    "If frame is omitted or nil, use the selected frame."

    t:

    "If frame is t, report on the defaults for face face (for new frames)."

    a frame:

    "report on face face in that frame."


    2. Elisp node Attribute Functions:

    nil:

    "If you don't specify FRAME, they refer to the default data for
    new frames." Also, the text at the top of the node apparently
    applies here: "otherwise, they affect all frames as well as the
    defaults that apply to new frames." These two statements don't
    say the same thing, IMO.

    t:

    Nothing explicit said about t, except what is implied by the
    text at the node top: "otherwise, they affect all frames as
    well as the defaults that apply to new frames." In this case,
    there is no distinction between nil and t.

    a frame:

    Nothing explicit said about a frame arg, except what is said at
    the node top: "If you specify FRAME, they affect just that frame"