Kai.Grossjohann@... (Kai Gro=DFjohann) writes:
> Colin Marquardt <c.marquardt@...> writes:
>> I kind of browse the file (often the raw texi file). "Usage" only
>> starts at 67% in the texi (from what the "more" output tells me). 67%
>> seems to be pretty late.
> Well, if it turns out that lots of people do this, then fine. But I
> really think that Texinfo documentation should be optimized for
> printing and for online viewing using an info reader, but not for
> source code browsing.
But for a printed version, the Usage section will still come only at
the beginning of the last third, no? Granted, I will have the page
ref in the TOC then. Well, I have no real string feelings about this.
One thing though: if I do M-x finder-commentary, I'd expect information
about how to use tramp (namely, use the right file name syntax) there,
but it isn't. Instead, I get information on how to get tramp and all, but
I already have it, even installed (I don't say this information shouldn't
be there, but that is shouldn't be the *only* information).
Or maybe I haven't really understood this in general: what is the
suggested point of information in emacs (other than the info format,
which, as we know, many people don't like) to find out about the
basic functionality of a package? Most packages give at least
something like "Use M-x toggle-foo-mode to switch on and off foo
mode." in their Comment section, even if foo-mode has thousands of
other bells and whistles. I feel that tramp should do something
similar like this. How about something like: "Once tramp is correctly
installed (see "Installation" below), you can use M-x find-file RET
/[server_name]/path/to/remote_file to open remote_file on
server_name. Read more about tramp's functionality in the
accompanying info text."?