On Wed, 7 Nov 2001, Golubev I. N. wrote:
Your message is really helpful wrt to basic keybindings and how to
start. But I think that such a startup should be (easily) available
to everybody through conventional emacs techniques. One should not
have to post questions or read faq.
The key binding is mentioned if you do C-h m, it is also available in the
menubar.
In Oort Gnus the somewhat confusing menubar name "MML" was changed into
"Attachment" to make things easier to locate for users that doesn't know
what MML is. Please suggest other specific things that can be improved as
well, and I'm sure they will be added.
> Composing mail is described in the Message manual.
All that end user `sees' is gnus. So gnus documentation should be a
point to start and figure out everything one needs.
Right, but this seems to be covered -- in the top-level node "Composing
Messages" in the first paragraph, there is a reference to the message
manual.
When it describes `gnus-group-mail' and friends, it should refer
to
`message' manual.
Referring to the "Composing Messages" node is perhaps better, I'll add
this.
Currently `gnus.info' does not mention `gnus-msg-mail' at
all, and
functions' documentation does not state explicitly where to read about
mail composition.
gnus-msg-mail is a XEmacs thing, it should be documented in the XEmacs
manual. Gnus does not use the function as far as I know.
> > What if I am on tty?
>
> Gnus doesn't notice the difference,
I am sure that gnus doesn't, but user does. With menubar it is easier
to understand what MML does. MML minor mode description (which is the
only thing universally available on any device) is quite terse and
does not state explicitly that it is stuff for composing MIME messages
described in this-and-this `.info'.
Right, I'll submit a patch that adds a few sentences to the MML minor
mode with more information.
> Etc,
> you do not normally need to indicate to Gnus anything about the charsets,
> but for details see the Emacs MIME manual.
Hope that it describes what to do without MULE or when same text may
be sent in different charsets, and required charset may change.
Yes, see the "Charset Translation" node. (Located via `s mule RET'.)
> > It appears that current version of gnus lacks documentation
badly.
I think that the statement still holds. There are apparently not
enough cross-references, and learning it is not as easy as it could
be.
Agreed, please submit more places where you think cross references are
appropriate. Diff format prefered, but suggestions are useful as well.
Even now I observe some surprises in message mode. It appears to
use
`sendmail' stuff, and does that in a strange way. One has to change
default `sendmail-program' value, not buffer-local one, to have it
affect sending in `message' mode. So one cannot (easily) reuse his
`sendmail-program' stuff.
This is a bug that was fixed a while ago, but I don't think there has been
a new mail-lib release that includes it yet.
(A new mail-lib release would be a good thing, the mail-lib in CVS solves
alot of problems and add several new features.)
And there is no way back, that is, you cannot stick to `tm'
either,
since it is also considerably hosed. So mail editing in xemacs
becomes quite uncomfortable.
With yours and others help it will become more comfortable. Without the
help, it will stay uncomfortable.