| 1 |
El Vie, 6 de Febrero de 2009, 5:40, Stroller escribió: |
| 2 |
> |
| 3 |
> less [-[+]aBcCdeEfFgGiIJKLmMnNqQrRsSuUVwWX~] [-b space] [-h lines] [-j |
| 4 |
> line] [-k keyfile] [-{oO} logfile] [-p pattern] [-P prompt] [-t tag] |
| 5 |
> [-T tagsfile] [-x tab,...] [-y lines] [-[z] lines] |
| 6 |
> [-# shift] [+[+]cmd] [--] [filename]... |
| 7 |
> |
| 8 |
> |
| 9 |
> doesn't make any sense to the untrained eye. It just looks like |
| 10 |
> gobbledegook. There's maybe a Linux n00b manual that explains the syntax |
| 11 |
> of man's "Synopsis", but I'm sure I only learned to translate the likes of |
| 12 |
> the above after reading man pages for commands that I already knew - |
| 13 |
> learned through inference, osmosis and newsgroups. |
| 14 |
|
| 15 |
I have no idea if that's documented in any place. |
| 16 |
|
| 17 |
>> If the problem is "contents" then that's nothing to do with |
| 18 |
>> man, but with whomever made (or didn't made) the page. |
| 19 |
> |
| 20 |
> Yes, but there's a problem with the MAJORITY of contents, perhaps of |
| 21 |
> the majority of people writing manpages? It just seems to be a culture of |
| 22 |
> the way man pages are written. They make perfect sense only with |
| 23 |
> experience - don't get me wrong, I love 'em and at least to a degree I |
| 24 |
> think that's how it should be. |
| 25 |
> |
| 26 |
> But I think the criticism of someone who finds man pages difficult to |
| 27 |
> read "your own inadequate ability to read technical documents, ...your own |
| 28 |
> capacity for comprehension" is a tad unfair. |
| 29 |
|
| 30 |
Yes. I wasn't implying that you were wrong, just giving |
| 31 |
some general tips that could be useful if the problem was |
| 32 |
one of those that I was enumerating. |
| 33 |
|
| 34 |
But sometimes, the amount of info to present is simply overwhelming. |
| 35 |
To name just a couple of man pages that are really excellent I'd say |
| 36 |
that the fvwm and bash ones are really good. But being rather long |
| 37 |
they are better suited as reference guides. They are not tutorials, |
| 38 |
that's for sure. |
| 39 |
|
| 40 |
That's where the network nature of unix like OSes break into scene, |
| 41 |
learning without having access to internet is harder, I can tell |
| 42 |
from experience in my beginnings. |
| 43 |
|
| 44 |
About the age of the pages, well, some of the packages are so old |
| 45 |
and rarely need updates that they go mostly unmaintained for ages. |
| 46 |
It's just a guess anyway. |
| 47 |
|
| 48 |
-- |
| 49 |
Jesús Guerrero |
Archives