× The internal search function is temporarily non-functional. The current search engine is no longer viable and we are researching alternatives.
As a stop gap measure, we are using Google's custom search engine service.
If you know of an easy to use, open source, search engine ... please contact support@midrange.com.



On Tue, Apr 16, 2019 at 9:00 AM Jim Oberholtzer <midrangel@xxxxxxxxxxxxxxxxx>
wrote:

Jack:

With all due respect, and you earned some,


Well, thank you sir!

the MAN pages are on the edge of
the worst documentation ever created.



"Worst" is a qualitative assessment that begs definition, but in any case I
disagree.

"Nerdiest", perhaps.

The man regimen was designed:

- with the assumption the reader understood basic unix command sytanx,
(dash-switches, arguments, etc.)
- with the assumption the reader understood the basic execution model
(redirection and pipe stages).
- to be easy to create documentation on the fly
- to be easy to index the created documentation
- to be lightweight to present to the user

In my view, the *worst* advice one can give to the PASE newbie is to blow
off 50 years (this year) of Unix experience as arcana and consign them to
remain under the tutelage of experts.

PASE, as I said, is *not* a bolt-on. *It's the highway to the future of IBM
i.*

Unix was designed to empower the individual. Be that empowered individual.
Embrace PASE and learn it, the *easiest* way being via interaction with the
reference platform, Linux. More pointers on this at COMMON.


As an Amazon Associate we earn from qualifying purchases.

This thread ...

Follow-Ups:
Replies:

Follow On AppleNews
Return to Archive home page | Return to MIDRANGE.COM home page

This mailing list archive is Copyright 1997-2024 by midrange.com and David Gibbs as a compilation work. Use of the archive is restricted to research of a business or technical nature. Any other uses are prohibited. Full details are available on our policy page. If you have questions about this, please contact [javascript protected email address].

Operating expenses for this site are earned using the Amazon Associate program and Google Adsense.