Re: Man pages and info pages

2010-11-04 Thread Lawrence D'Oliveiro
In message 1bdce24e-4406-44c5-9133-bfd0acd02...@p1g2000yqm.googlegroups.com, rustom wrote: The printed python docs come to several thousand pages. Do we want them to be 1 manpage? a hundred? a thousand? Perl managed to condense a lot of useful information into a handful of man pages. --

Re: Man pages and info pages

2010-11-04 Thread Mark Wooding
Tim Harig user...@ilthio.net writes: When the GNU folk decided to clone *nix they decided that they knew better and simply decided to create their own interfaces. This isn't the case. Actually Info has a long history prior to GNU: it was the way that the documentation was presented at the MIT

Re: Man pages and info pages

2010-11-04 Thread Tim Harig
On 2010-11-04, Mark Wooding m...@distorted.org.uk wrote: Tim Harig user...@ilthio.net writes: When the GNU folk decided to clone *nix they decided that they knew better and simply decided to create their own interfaces. This isn't the case. Actually Info has a long history prior to GNU: it

Re: Man pages and info pages

2010-11-04 Thread Mark Wooding
Tim Harig user...@ilthio.net writes: Right, and in info with the default key bindings, backspace takes me to the command help. I would have expected it to either scroll up the page or take me to the previously visited node. Sounds like your terminal is misconfigured. Backspace should

Re: Man pages and info pages

2010-11-04 Thread Ben Finney
Tim Harig user...@ilthio.net writes: On 2010-11-04, Mark Wooding m...@distorted.org.uk wrote: Tim Harig user...@ilthio.net writes: Actually, the left arrow key does not work at all intuitively. One would expect that it should go back to the previous page as it would in lynx, etc. It does

Re: Man pages and info pages

2010-11-04 Thread Tim Harig
On 2010-11-04, Ben Finney ben+pyt...@benfinney.id.au wrote: As has been noted before, there is no intuitive interface except the nipple. Everything else is not intuitive, but must be learned. What exactly is so intuitive about being slapped in the face followed by being slapped with a lawsuit?

Re: Man pages and info pages

2010-11-03 Thread Hrvoje Niksic
Teemu Likonen tliko...@iki.fi writes: Enter Follow a link (down to node) u up node level h help (general how-to) ? help (commands) s search And don't forget: l last viewed page (aka back) That one seems to be the info reader's

Re: Man pages and info pages

2010-11-03 Thread Daniel da Silva
Guys, this really has nothing to do with python. On Wednesday, November 3, 2010, Hrvoje Niksic hnik...@xemacs.org wrote: Teemu Likonen tliko...@iki.fi writes:     Enter   Follow a link (down to node)     u       up node level     h       help (general how-to)     ?       help (commands)    

Re: Man pages and info pages

2010-11-03 Thread rustom
On Nov 3, 3:11 pm, Daniel da Silva ddasi...@umd.edu wrote: Guys, this really has nothing to do with python. ?? python docs have nothing to do with python?? python docs by default on linux are read with info and many seem to find info unpleasant to use. Myself an old emacs user and cant say info

Re: Man pages and info pages

2010-11-03 Thread Jason Earl
On Wed, Nov 03 2010, rustom wrote: On Nov 3, 3:11 pm, Daniel da Silva ddasi...@umd.edu wrote: Guys, this really has nothing to do with python. ?? python docs have nothing to do with python?? python docs by default on linux are read with info and many seem to find info unpleasant to use.

Man pages and info pages (was: Python documentation too difficult for beginners)

2010-11-02 Thread Teemu Likonen
* 2010-11-02 18:43 (UTC), Tim Harig wrote: The manual format contains all of the information on one page that can be easily searched whereas the info pages are split into sections that must be viewed individually. With the man pages, you can almost always find what you want with a quick

Re: Man pages and info pages (was: Python documentation too difficult for beginners)

2010-11-02 Thread Tim Harig
On 2010-11-02, Teemu Likonen tliko...@iki.fi wrote: * 2010-11-02 18:43 (UTC), Tim Harig wrote: The manual format contains all of the information on one page that can be easily searched whereas the info pages are split into sections that must be viewed individually. With the man pages, you can

Re: Man pages and info pages (was: Python documentation too difficult for beginners)

2010-11-02 Thread Tim Harig
On 2010-11-02, Tim Harig user...@ilthio.net wrote: On 2010-11-02, Teemu Likonen tliko...@iki.fi wrote: With the text terminal info browser called info as well as Emacs' info browser you can use command s (stands for search). It prompts for a regexp pattern to search in the whole document,

Re: Man pages and info pages

2010-11-02 Thread Teemu Likonen
* 2010-11-02 19:36 (UTC), Tim Harig wrote: On 2010-11-02, Teemu Likonen tliko...@iki.fi wrote: There is also the problem that people are less familiar with info browsers than the usual less pager which is used by man command. I thoroughly agree. The default info viewers are quite possibly

Re: Man pages and info pages

2010-11-02 Thread Tim Harig
On 2010-11-03, Teemu Likonen tliko...@iki.fi wrote: * 2010-11-02 19:36 (UTC), Tim Harig wrote: I thoroughly agree. The default info viewers are quite possibly the most counterintuitive programs I have ever encountered. I never did bother to learn how to use them. I instead installed the more