all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* defface doc misses default and some more errors
@ 2005-02-09  7:01 Lennart Borgman
  2005-02-09 18:36 ` Eli Zaretskii
  2005-02-10  6:02 ` defface doc misses default and some more errors Richard Stallman
  0 siblings, 2 replies; 10+ messages in thread
From: Lennart Borgman @ 2005-02-09  7:01 UTC (permalink / raw)


The docstring for defface does not mention (default ...)

And I believe that

"DISPLAY can either be the symbol t, which will match all frames, or an
alist of the form ((REQ ITEM...)...).  For the DISPLAY to match a
FRAME, the REQ property of the frame must match one of the ITEM."

should be something like

"DISPLAY can either be the symbol t, which will match all frames, or an
alist of the form ((REQ ITEM...)...).  For the DISPLAY to match a
FRAME, the REQ property of the frame must match one of the ITEM for every
member of the alist."

I also am annoyed by the difficulty to get the possible values of
"window-system". If you look at the doc string for window-system (there is a
link in defface doc string) you just get the current value. In (defface
button ...) in button.el there is a (type pc). Is there such a value?
window-system for m "pc" is w32.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: defface doc misses default and some more errors
  2005-02-09  7:01 defface doc misses default and some more errors Lennart Borgman
@ 2005-02-09 18:36 ` Eli Zaretskii
  2005-02-09 20:06   ` Lennart Borgman
  2005-02-09 20:23   ` Mention darwin as a possible value for system-type? Nick Roberts
  2005-02-10  6:02 ` defface doc misses default and some more errors Richard Stallman
  1 sibling, 2 replies; 10+ messages in thread
From: Eli Zaretskii @ 2005-02-09 18:36 UTC (permalink / raw)
  Cc: emacs-devel

> From: "Lennart Borgman" <lennart.borgman.073@student.lu.se>
> Date: Wed, 9 Feb 2005 08:01:28 +0100
> 
> should be something like
> 
>                                                For the DISPLAY to match a
> FRAME, the REQ property of the frame must match one of the ITEM for every
> member of the alist."                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The marked part is grammatically wrong English, I think.

> I also am annoyed by the difficulty to get the possible values of
> "window-system".

??? Type "C-h i d m elisp RET", then "i window-system RET", and you
should see the full list of the possible values of that variable.

> in button.el there is a (type pc). Is there such a value?

`pc' is the value of window-system in the MS-DOS port of Emacs.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: defface doc misses default and some more errors
  2005-02-09 18:36 ` Eli Zaretskii
@ 2005-02-09 20:06   ` Lennart Borgman
  2005-02-10  4:53     ` Eli Zaretskii
  2005-02-09 20:23   ` Mention darwin as a possible value for system-type? Nick Roberts
  1 sibling, 1 reply; 10+ messages in thread
From: Lennart Borgman @ 2005-02-09 20:06 UTC (permalink / raw)
  Cc: emacs-devel

----- Original Message ----- 
From: "Eli Zaretskii" <eliz@gnu.org>


> >                                                For the DISPLAY to match
a
> > FRAME, the REQ property of the frame must match one of the ITEM for
every
> > member of the alist."
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> The marked part is grammatically wrong English, I think.

Thanks, you are right. I just copied that part. Hm. I just read the
semantics so to say. What about the semantic error which I was pointing out?

> > I also am annoyed by the difficulty to get the possible values of
> > "window-system".
>
> "i window-system RET", and you
> should see the full list of the possible values of that variable.

Thanks again, that is good. I never noticed "i" in Info and did not look at
all there in this case. But I believe there should be a link to this in the
defface doc string. Is not that possible?

BTW I think the dividing between Info and the doc strings is a bit
problematic.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Mention darwin as a possible value for system-type?
  2005-02-09 18:36 ` Eli Zaretskii
  2005-02-09 20:06   ` Lennart Borgman
@ 2005-02-09 20:23   ` Nick Roberts
  2005-02-10  4:49     ` Eli Zaretskii
  1 sibling, 1 reply; 10+ messages in thread
From: Nick Roberts @ 2005-02-09 20:23 UTC (permalink / raw)
  Cc: emacs-devel


 > ??? Type "C-h i d m elisp RET", then "i window-system RET", and you
 > should see the full list of the possible values of that variable.

On a related note (or possibly unrelated), if you type "C-h i d m elisp RET",
then "i system-type RET", shouldn't you see the full list of the possible
values of that variable. I see no mention of darwin. Is this deliberate?

Nick

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Mention darwin as a possible value for system-type?
  2005-02-09 20:23   ` Mention darwin as a possible value for system-type? Nick Roberts
@ 2005-02-10  4:49     ` Eli Zaretskii
  2005-02-10 10:10       ` David Kastrup
  0 siblings, 1 reply; 10+ messages in thread
From: Eli Zaretskii @ 2005-02-10  4:49 UTC (permalink / raw)
  Cc: emacs-devel

> From: Nick Roberts <nickrob@snap.net.nz>
> Date: Thu, 10 Feb 2005 09:23:50 +1300
> Cc: emacs-devel@gnu.org
> 
> On a related note (or possibly unrelated), if you type "C-h i d m elisp RET",
> then "i system-type RET", shouldn't you see the full list of the possible
> values of that variable. I see no mention of darwin. Is this deliberate?

If `darwin' is the value on some supported system, its omission cannot
be deliberate, I think.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: defface doc misses default and some more errors
  2005-02-09 20:06   ` Lennart Borgman
@ 2005-02-10  4:53     ` Eli Zaretskii
  0 siblings, 0 replies; 10+ messages in thread
From: Eli Zaretskii @ 2005-02-10  4:53 UTC (permalink / raw)
  Cc: emacs-devel

> From: "Lennart Borgman" <lennart.borgman.073@student.lu.se>
> Cc: <emacs-devel@gnu.org>
> Date: Wed, 9 Feb 2005 21:06:18 +0100
> 
> Thanks, you are right. I just copied that part. Hm. I just read the
> semantics so to say. What about the semantic error which I was pointing out?

The previous wording was inaccurate, but yours is also inaccurate (or
perhaps simply unclear).  I think we need a better wording.

> BTW I think the dividing between Info and the doc strings is a bit
> problematic.

Why?  I think the philosophy is that the doc strings are a short
version of the documentation, and the manual is the full version.  I
don't see any problem in such subdivision.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: defface doc misses default and some more errors
  2005-02-09  7:01 defface doc misses default and some more errors Lennart Borgman
  2005-02-09 18:36 ` Eli Zaretskii
@ 2005-02-10  6:02 ` Richard Stallman
  1 sibling, 0 replies; 10+ messages in thread
From: Richard Stallman @ 2005-02-10  6:02 UTC (permalink / raw)
  Cc: emacs-devel

    I also am annoyed by the difficulty to get the possible values of
    "window-system". If you look at the doc string for window-system (there is a
    link in defface doc string) you just get the current value. In (defface
    button ...) in button.el there is a (type pc). Is there such a value?
    window-system for m "pc" is w32.

It would be good to list the values of window-system into the defvar.
Would people who know about other possible values please add them?

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Mention darwin as a possible value for system-type?
  2005-02-10  4:49     ` Eli Zaretskii
@ 2005-02-10 10:10       ` David Kastrup
  2005-02-11 15:12         ` Eli Zaretskii
  0 siblings, 1 reply; 10+ messages in thread
From: David Kastrup @ 2005-02-10 10:10 UTC (permalink / raw)
  Cc: Nick Roberts, emacs-devel

"Eli Zaretskii" <eliz@gnu.org> writes:

>> From: Nick Roberts <nickrob@snap.net.nz>
>> Date: Thu, 10 Feb 2005 09:23:50 +1300
>> Cc: emacs-devel@gnu.org
>> 
>> On a related note (or possibly unrelated), if you type "C-h i d m
>> elisp RET", then "i system-type RET", shouldn't you see the full
>> list of the possible values of that variable. I see no mention of
>> darwin. Is this deliberate?
>
> If `darwin' is the value on some supported system, its omission
> cannot be deliberate, I think.

Secondguessing will get us nowhere: by that we just cement possible
oversights permanently.  Policy by accident, "somebody might have
thought something when doing that", is a recipe for disaster in the
long run.

AFAICS, Darwin is free software (while MacOSX isn't).  So even if we
try to be semi-"politically correct" by deliberately making using
unfree software more complicated with buggy documentation, more likely
window-system rather than system-type should be affected.

If there was a rationale, I'd prefer hearing instead of guessing it.

-- 
David Kastrup, Kriemhildstr. 15, 44793 Bochum

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Mention darwin as a possible value for system-type?
  2005-02-10 10:10       ` David Kastrup
@ 2005-02-11 15:12         ` Eli Zaretskii
  2005-02-11 16:25           ` David Kastrup
  0 siblings, 1 reply; 10+ messages in thread
From: Eli Zaretskii @ 2005-02-11 15:12 UTC (permalink / raw)
  Cc: nickrob, emacs-devel

> Cc: Nick Roberts <nickrob@snap.net.nz>,  emacs-devel@gnu.org
> From: David Kastrup <dak@gnu.org>
> Date: Thu, 10 Feb 2005 11:10:54 +0100
> 
> > If `darwin' is the value on some supported system, its omission
> > cannot be deliberate, I think.
> 
> Secondguessing will get us nowhere: by that we just cement possible
> oversights permanently.  Policy by accident, "somebody might have
> thought something when doing that", is a recipe for disaster in the
> long run.
> 
> AFAICS, Darwin is free software (while MacOSX isn't).  So even if we
> try to be semi-"politically correct" by deliberately making using
> unfree software more complicated with buggy documentation, more likely
> window-system rather than system-type should be affected.

Once again David Kastrup pounces on someone guided by nothing else but
his own misunderstandings: all I meant to say was that the omission of
`darwin' is a bug that should be fixed.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: Mention darwin as a possible value for system-type?
  2005-02-11 15:12         ` Eli Zaretskii
@ 2005-02-11 16:25           ` David Kastrup
  0 siblings, 0 replies; 10+ messages in thread
From: David Kastrup @ 2005-02-11 16:25 UTC (permalink / raw)
  Cc: nickrob, emacs-devel

"Eli Zaretskii" <eliz@gnu.org> writes:

>> Cc: Nick Roberts <nickrob@snap.net.nz>,  emacs-devel@gnu.org
>> From: David Kastrup <dak@gnu.org>
>> Date: Thu, 10 Feb 2005 11:10:54 +0100
>> 
>> > If `darwin' is the value on some supported system, its omission
>> > cannot be deliberate, I think.
>> 
>> Secondguessing will get us nowhere: by that we just cement possible
>> oversights permanently.  Policy by accident, "somebody might have
>> thought something when doing that", is a recipe for disaster in the
>> long run.
>> 
>> AFAICS, Darwin is free software (while MacOSX isn't).  So even if
>> we try to be semi-"politically correct" by deliberately making
>> using unfree software more complicated with buggy documentation,
>> more likely window-system rather than system-type should be
>> affected.
>
> Once again David Kastrup pounces on someone guided by nothing else
> but his own misunderstandings: all I meant to say was that the
> omission of `darwin' is a bug that should be fixed.

I apparently mixed up "deliberate" with some synonymon of "arbitrary".
Sorry for the confusion.  It might have helped if your reply had
included a suggested course of action.

-- 
David Kastrup, Kriemhildstr. 15, 44793 Bochum

^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2005-02-11 16:25 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2005-02-09  7:01 defface doc misses default and some more errors Lennart Borgman
2005-02-09 18:36 ` Eli Zaretskii
2005-02-09 20:06   ` Lennart Borgman
2005-02-10  4:53     ` Eli Zaretskii
2005-02-09 20:23   ` Mention darwin as a possible value for system-type? Nick Roberts
2005-02-10  4:49     ` Eli Zaretskii
2005-02-10 10:10       ` David Kastrup
2005-02-11 15:12         ` Eli Zaretskii
2005-02-11 16:25           ` David Kastrup
2005-02-10  6:02 ` defface doc misses default and some more errors Richard Stallman

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.