Re: [Oorexx-devel] Man Pages

[CVBruce <cv...@gm...>]

Yes the executable is rexx, how do you know that?  I would expect that if I was installing ooRexx, the executable would be ooRexx.  You grab the ooRexx installer off of source forge install it, and now what?  I would think that the ooRexx man page would mention the other man pages, and possibly where stuff was installed, the class files, and the examples in /share.

It might also mention that the documentation is available in a separate download from source forge.  That you have to possibly setup both path and library environmental variables.  The error message you get when rexx can't find its libraries.

You know just general stuff that the first time user wouldn't know.

Bruce


On Aug 25, 2012, at 3:52 PM, Mark Miesfeld wrote:

> On Sat, Aug 25, 2012 at 12:28 PM, CVBruce <cv...@gm...> wrote:
>> Would it not make sense to either create a man page for ooRexx, or to create a link to the existing rexx man page.
> 
> Hi Bruce,
> 
> I'm not sure what you mean by "or to create a link to the existing
> rexx man page"  Actually, I guess I'm just not sure what you mean at
> all.
> 
> Are you saying you would rather have the man page named ooRexx than
> rexx?  Or ... what?  ;-)
> 
> The rpm and deb installers correctly set up the man pages on Linux.
> The executable is named rexx.  On Unix-like systems, you typically
> type "man <nameOfExecutable>" to get a hint as to what some executable
> is.  So, on Linux, the installers do what is typically expected by a
> Linux user.
> 
> I have no idea what that translates into on a Mac.  For instance
> neither my mother nor by brother would have any concept typing 'man'.
> It seems to me, that most Mac users just use the GUI part of a Mac in
> a way similar to Windows users.
> 
> What would make the most sense to me is to set up the ooRexx reference
> manuals in the way the typical Mac user expects to find documentation
> on the things they install.  I probably know closely about 20 or 25
> people who use a Mac.  Not a one of them knows anything about 'man'
> and I doubt that any of them has every used a command prompt on their
> Macs
> 
> --
> Mark Miesfeld
> 
> ------------------------------------------------------------------------------
> Live Security Virtual Conference
> Exclusive live event will cover all the ways today's security and 
> threat landscape has changed and how IT managers can respond. Discussions 
> will include endpoint security, mobile security and the latest in malware 
> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> _______________________________________________
> Oorexx-devel mailing list
> Oor...@li...
> https://lists.sourceforge.net/lists/listinfo/oorexx-devel