[SLE] Re: Real Man page for tar?
Franois Pinard
Jim Osborn
writes: the tar developers seem to have a political problem with the classic man pages.
Maybe slightly political, but the real truth is that it was not practical spoiling human energies at maintaining parallel documentation in many formats. As Texinfo format is _undoubtedly_ superior to `man', at least to anybody being a bit honest, the choice of crafting a parallel `man' page did not remain. On the other hand, the automated derivation of a `man' page from the `--help' output is quite acceptable, and this is why we managed to do it.
As I said, this concise listing of the various options, with enough explanation to guide the user with at least rudimentary experience is extremely helpful.
the last thing they want is to confront a cryptic "info" system. Give the poor user a simple, single file to read with a pager like less.
I never understood why people are so reluctant to learn the first letter of the words Next, Previous, Up and Menu, or use the space key to page forward. That's all you need. I would be tempted to say that `less' has many more commands than `info', and I've never been tempted to call it cryptic. I think that the habit of bashing Info is mainly folklore, which came both from die-hard `man' people and keyboard-less Netscape users :-).
Well, perhaps you can "de-crypt" a few things I've been unable to figure out with the info system: 1: How do I scroll a single line forward or back? Often the text I'm reading is split inconveniently off the top or bottom of the screen, and I want to bring the entire paragraph onscreen so I can study it. What's the info equivalent of less' <ret> to scroll one line down, or 1b to go one line backward? 2: How do I scroll directly to the end of the current page? Often I happen to know that some point I'm interested in is discussed near the end of the current section, and I'd like to flip directly there, then back to the part I'm currently reading. After I've been to the end of the page (or, say, the beginning) how can I go directly back to where I was before all this jumping around, say, in the middle of the page? 3: How can I scroll unidirectionally (keeping in mind question 1) through the entire document? If I want to make an initial pass through the information, how can I know I've seen it all? I'm an old keyboard person myself, and I can sympathise with the need to maintain a single set of documentation. The reason I consider less "simpler" than info is less' abstraction of the document as a single monolithic file. Once you have a rough idea of where the information you're seeking is located in that file, it's conceptually easy to scroll forward or backward to it. A simple key search helps you find things initially, and a set of marks lets you jump directly to any of 256 locations. That's the extent of the less command I use, despite its daunting array of options and commands. For documents of fewer than, say, fifty pages, it's a nice simple reader. The info system of hyperlinks, or menus, seems much less straightforward in its abstraction of the document itself. I'm not convinced I've ever been able to see the entire info document for tar, for example, as I don't know if I've poked into all its corners and cul de sacs. I find myself going round and round various loops, feeling sure I've seen this page before, but not having a clear idea where this page is in the information tree. Maybe an answer to question 3 above would solve this problem. Thanks for the thoughts, Jim -- To unsubscribe send e-mail to suse-linux-e-unsubscribe@suse.com For additional commands send e-mail to suse-linux-e-help@suse.com Also check the FAQ at http://www.suse.com/Support/Doku/FAQ/
On Sun, 16 Jan 2000, Jim Osborn wrote: jo> jo> Well, perhaps you can "de-crypt" a few things I've been unable to jo> figure out with the info system: jo> jo> 1: How do I scroll a single line forward or back? Often the text I'm jo> reading is split inconveniently off the top or bottom of the screen, jo> and I want to bring the entire paragraph onscreen so I can study it. jo> What's the info equivalent of less' <ret> to scroll one line down, jo> or 1b to go one line backward? jo> Navigation by individual lines isnt available, you can see a list of naviagtion commands by pressing '?' at any time, as well as a tutorial for info by pressing 'h' at any time. But to cut to the chase, SPC = page forward DEL = page backward b = goto beginning (equivalent to Home) e = goto end (equivalent to End) Navigating with the arrows will move the first or last line to the center of the screen when you go past the top or bottom of the current page. jo> 2: How do I scroll directly to the end of the current page? Often I jo> happen to know that some point I'm interested in is discussed near jo> the end of the current section, and I'd like to flip directly jo> there, then back to the part I'm currently reading. After I've jo> been to the end of the page (or, say, the beginning) how can I go jo> directly back to where I was before all this jumping around, say, jo> in the middle of the page? jo> Se previous answer to number 1. jo> 3: How can I scroll unidirectionally (keeping in mind question 1) jo> through the entire document? If I want to make an initial pass jo> through the information, how can I know I've seen it all? jo> Not available, the scrolling method available is the one I described above. Which gives the impression of the cursor jumping. jo> I'm an old keyboard person myself, and I can sympathise with the jo> need to maintain a single set of documentation. The reason I consider jo> less "simpler" than info is less' abstraction of the document jo> as a single monolithic file. Once you have a rough idea of where jo> the information you're seeking is located in that file, it's conceptually jo> easy to scroll forward or backward to it. A simple key search jo> helps you find things initially, and a set of marks lets you jump jo> directly to any of 256 locations. jo> jo> That's the extent of the less command I use, despite its daunting jo> array of options and commands. For documents of fewer than, say, jo> fifty pages, it's a nice simple reader. jo> jo> The info system of hyperlinks, or menus, seems much less straightforward jo> in its abstraction of the document itself. I'm not convinced I've jo> ever been able to see the entire info document for tar, for example, jo> as I don't know if I've poked into all its corners and cul de sacs. jo> I find myself going round and round various loops, feeling sure I've jo> seen this page before, but not having a clear idea where this page jo> is in the information tree. Maybe an answer to question 3 above jo> would solve this problem. jo> jo> Thanks for the thoughts, jo> jo> Jim jo> jo> -- S.Toms - tomas@primenet.com - homepage is in the works SuSE Linux v6.2+ - Kernel 2.2.13 My opinions may have changed, but not the fact that I am right. -- To unsubscribe send e-mail to suse-linux-e-unsubscribe@suse.com For additional commands send e-mail to suse-linux-e-help@suse.com Also check the FAQ at http://www.suse.com/Support/Doku/FAQ/
"S.Toms" wrote:
On Sun, 16 Jan 2000, Jim Osborn wrote:
jo> 1: How do I scroll a single line forward or back? Often the text I'm jo> reading is split inconveniently off the top or bottom of the screen, jo> and I want to bring the entire paragraph onscreen so I can study it. jo> What's the info equivalent of less' <ret> to scroll one line down, jo> or 1b to go one line backward? jo>
Navigation by individual lines isnt available, you can see a list of naviagtion commands by pressing '?' at any time, as well as a tutorial for info by pressing 'h' at any time.
Actually, you can get an approximation to that by using the down arrow key. Not as good, but workable in a pinch. In Emacs, ^L centers the page, but I'm not sure if that also works in standalone Info. The two keys in combination are very helpful.
jo> 3: How can I scroll unidirectionally (keeping in mind question 1) jo> through the entire document? If I want to make an initial pass jo> through the information, how can I know I've seen it all? jo>
Not available, the scrolling method available is the one I described above. Which gives the impression of the cursor jumping.
Actually, it is available; use the space key. When you get to the end of a page it moves to the next page in textual order (the order of the pages if you printed them out). And Bksp (or maybe Del) moves through the document in reverse order. Paul Abrahams -- To unsubscribe send e-mail to suse-linux-e-unsubscribe@suse.com For additional commands send e-mail to suse-linux-e-help@suse.com Also check the FAQ at http://www.suse.com/Support/Doku/FAQ/
participants (3)
-
abrahams@mbs.valinet.com
-
jimo@eskimo.com
-
tomas@primenet.com