[SLE] Re: Real Man page for tar?
Lenz Grimmer
"tar --help" or "info tar" are also very helpful.
tar --help does provide concise, useful output. Thanks, Lenz! "info tar" is not so useful. I know it's not SuSE's fault; the tar developers seem to have a political problem with the classic man pages. But the "info" page for tar on SuSE 5.3 is no substitute for a real man page (how can you print out the whole thing, for example). Maybe it's all better on SuSE 6.3, but from the responses to my initial query, I doubt it. A consideration is that often the tar user in search of information is in the midst of a crisis, trying to restore a damaged system or complete an installation, and 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've received some promising pointers; when I sort them out, maybe I'll post some tar info here and on my ftp site. 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/
* Jim Osborn (jimo@eskimo.com) [20000113 06:31]:
a real man page (how can you print out the whole thing, for example).
Well, not directly. You'ld need the texinfo source of the document(s),
usually in the source package.
Those may then be processed by TeX and dvi2ps. This gives you very nice
documentation and is also the reason why the FSF prefers the texinfo format,
because it allows to produce both online readable as well as printed
documentation from the same source.
Granted, nowadays IMHO this should be done in sgml, as that would allow an
even broader range of document types to be produced.
Philipp
--
Philipp Thomas
Jim Osborn wrote:
Lenz Grimmer
writes: "tar --help" or "info tar" are also very helpful.
tar --help does provide concise, useful output. Thanks, Lenz!
"info tar" is not so useful. I know it's not SuSE's fault; the tar developers seem to have a political problem with the classic man pages. But the "info" page for tar on SuSE 5.3 is no substitute for a real man page (how can you print out the whole thing, for example).
If you have the .texi files for the tar info file, you can feed them through TeX, I believe, and get a printed version of the whole thing. I've done it, but not recently, so I don't remember the details of how I did it. But it is definitely possible, and the output looks quite nice. Paul -- 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
-
pthomas@suse.de