Le 31-10-2026, Nuno Silva <nunojsilva@invalid.invalid> a ‚crit˙:
On 2026-10-31, Carlos E. R. wrote:
Talking of manuals, I find large man pages very difficult to use,
specially when you need something specific. No clickable table of
content, no clickable index. Info pages are somewhat better.
Isn't that more about the viewer using to read the manual pages, than a
flaw of the online manual in itself?
Maybe. When I wanted to learned about Linux, I hated man pages. I found
them awful and useless. Now, I'm using them only when I know what I'm
looking for. I mean, when I don't know something, I know that the man
page will send me a useless shit load of details without anything
useful. Or, if anything is useful it's buried and hidden among useless
stuff. If I'm looking for a fast way to use a command, I'm using tldr.
If I want to understand a command, I avoid man pages and go look for
some information on Internet. It's only when I want to know what an
option is really doing or if an option exists that I'm going to look for
it in the man pages.
On 2026-10-31, Carlos E. R. wrote:
On 2026-10-30 20:24, Charlie Gibbs wrote:
On 2026-10-30, c186282 <c186282@nnada.net> wrote:
On 10/29/26 12:27, Chris Ahlstrom wrote:
rbowman wrote this screed in ALL-CAPS (fixed):
On Wed, 28 Oct 2026 19:33:23 GMT, Charlie Gibbs wrote:
The closest I ever came to using an IDE was the symbolic debugger that >>>>>>> came with Lattice C for MS-DOS. Simple, effective... and gone.
I missed that one although I did use MS C after they bought Lattice and >>>>>> developed it further. I will say for its era Microsoft C had excellent >>>>>> hard copy documentation.
I agree with that last sentence. In the 80's the manuals for their
C and FORTRAN were very good, and obviously inspired by the layout
of DEC's manuals.
You are correct - manuals/docs were EXTREMELY good
for such stuff "back in the day". Found a manual
for "Aztec C" (great !) from the old days ... WOW ! ...
literally bit-level shit in there in case you needed
to hyper-optimize something. Clearly the people who
wrote the doc also wrote the compiler.
More VOLUME of docs these days ... but "As Good" ???
Hardly. Most manuals back in the day had a section titled
"Theory of Operation". I really miss that.
Talking of manuals, I find large man pages very difficult to use,
specially when you need something specific. No clickable table of
content, no clickable index. Info pages are somewhat better.
Isn't that more about the viewer using to read the manual pages, than a
flaw of the online manual in itself?
On 2026-10-31 11:49, Nuno Silva wrote:
On 2026-10-31, Carlos E. R. wrote:
Talking of manuals, I find large man pages very difficult to use,
specially when you need something specific. No clickable table of
content, no clickable index. Info pages are somewhat better.
Isn't that more about the viewer using to read the manual pages, than
a flaw of the online manual in itself?
No, man pages do not contain links to section of the document. It is
not structured.
"Carlos E. R." <robin_listas@es.invalid> writes:
On 2026-10-31 11:49, Nuno Silva wrote:
On 2026-10-31, Carlos E. R. wrote:
Talking of manuals, I find large man pages very difficult to use,
specially when you need something specific. No clickable table of
content, no clickable index. Info pages are somewhat better.
Isn't that more about the viewer using to read the manual pages, than
a flaw of the online manual in itself?
No, man pages do not contain links to section of the document. It is
not structured.
Nuno is right; a viewer can include links. For an example see man7.org.
On 2026-10-31, Carlos E. R. wrote:
On 2026-10-31 16:57, Janis Papanagnou wrote:
On 2026-10-31 11:40, Carlos E. R. wrote:
Talking of manuals, I find large man pages very difficult to use,
specially when you need something specific. No clickable table of
content, no clickable index. Info pages are somewhat better.
I agree with you on the _horrendous large_ 'man' "pages".
They shouldn't replace exhaustive and thorough documentation, IMO.
But worse I think are the ("maneuverable") 'info' pages.
Or the habit of some "Unixes" to have no man-page information but
only a stub with the hint to look into the (IMO horrendous) 'info'
pages. (I'm aware that some certainly prefer them; how else would
their proliferation be otherwise explainable.)
Concerning "clickable" information generally, mind the time when
man-pages were introduced!
Yes, I understand that. Isn't time we get something better?
A question is how much of that is already possible using the current
format.
And another question is whether the current format, which could easily
be printed besides being installed as an online manual, does make for
better documentation to read than something focused on having more
internal references.
No, man pages do not contain links to section of the document. It is not structured.
On 2026-10-31, Nuno Silva <nunojsilva@invalid.invalid> wrote:
On 2026-10-31, Carlos E. R. wrote:
On 2026-10-30 20:24, Charlie Gibbs wrote:
On 2026-10-30, c186282 <c186282@nnada.net> wrote:
More VOLUME of docs these days ... but "As Good" ???
Hardly. Most manuals back in the day had a section titled
"Theory of Operation". I really miss that.
Talking of manuals, I find large man pages very difficult to use,
specially when you need something specific. No clickable table of
content, no clickable index. Info pages are somewhat better.
Isn't that more about the viewer using to read the manual pages, than a
flaw of the online manual in itself?
At least the man command can search a man page for a text string.
It's not perfect, but it's better than nothing.
There is the tool "pinfo", it can highlight somethings like the name of another man page, and jump to it.
Still, no table of content. No jumping from one section while browsing
the man page.
| Sysop: | Jacob Catayoc |
|---|---|
| Location: | Pasay City, Metro Manila, Philippines |
| Users: | 5 |
| Nodes: | 4 (0 / 4) |
| Uptime: | 498677:20:24 |
| Calls: | 212 |
| Calls today: | 3 |
| Files: | 910 |
| D/L today: |
31 files (22,593K bytes) |
| Messages: | 69,826 |