Jack:
With all due respect, and you earned some, the MAN pages are on the edge of
the worst documentation ever created.
The purpose behind them is to put on some sort of documentation the various
commands and their options. They do that by simply listing them with a
perfunctory description of what the command does. Example "grep". In my
view, one of the most powerful command available in Linux. The man page
lists the command and the options. Some explanation is there but not much
by any stretch, certainly not enough to honor the power of the command.
Showing some contrast to that look at the "grep" documentation on gnu.org.
Now we have something that might be more useful to someone that is learning
or not as conversant with the Unix OS's that are available.
This is getting off topic so, I'll go away now, but recomending the MAN
pages to anyone is the equivelent of telling them to go away and don't
bother me. Try recomending something that might help.
I look forward to meeting you in person at POWERuP 19.....
--
Jim Oberholtzer
Agile Technology Architects
-----Original Message-----
From: MIDRANGE-L <midrange-l-bounces@xxxxxxxxxxxxxxxxxx> On Behalf Of Jack
Woehr
Sent: Tuesday, April 16, 2019 9:44 AM
To: Midrange Systems Technical Discussion <midrange-l@xxxxxxxxxxxxxxxxxx>
Subject: Re: ssh and sftp on the i
On Tue, Apr 16, 2019 at 8:18 AM Jim Oberholtzer
<midrangel@xxxxxxxxxxxxxxxxx>
wrote:
MAN pages were written by people that know the topic extremely well,
for people that know the topic exceptionally well.
A better way of putting is that *the Unix man pages were written for those
who need to know the topic as well as persons who ask questions on this list
need to know the topic!*
They have a style, as does IBM i documentation. They have very rich
informational content, as does IBM i documentation.
IBM i will be gone long before Unix man pages are gone.
As we Unix weenies have admonished one another for decades:
RTFM
!!
--
Jack Woehr
Absolute Performance, Inc.
12303 Airport Way, Suite 100
Broomfield, CO 80021
NON-DISCLOSURE NOTICE: This communication including any and all attachments
is for the intended recipient(s) only and may contain confidential and
privileged information. If you are not the intended recipient of this
communication, any disclosure, copying further distribution or use of this
communication is prohibited. If you received this communication in error,
please contact the sender and delete/destroy all copies of this
communication immediately.
--
This is the Midrange Systems Technical Discussion (MIDRANGE-L) mailing list
To post a message email: MIDRANGE-L@xxxxxxxxxxxxxxxxxx To subscribe,
unsubscribe, or change list options,
visit:
https://lists.midrange.com/mailman/listinfo/midrange-l
or email: MIDRANGE-L-request@xxxxxxxxxxxxxxxxxx
Before posting, please take a moment to review the archives at
https://archive.midrange.com/midrange-l.
Please contact support@xxxxxxxxxxxx for any subscription related questions.
Help support midrange.com by shopping at amazon.com with our affiliate link:
https://amazon.midrange.com
midrange.com
