[comp.sys.amiga] On-line help

"kosma@ALAN.LAAC-AI.Dialnet.Symbolics.COM"@alan.kahuna.decnet.lockheed.com (08/11/89)

Received: from GEORG.LAAC-AI.Dialnet.Symbolics.COM by ALAN.LAAC-AI.Dialnet.Symbolics.COM via CHAOS with CHAOS-MAIL id 34092; Thu 10-Aug-89 14:23:09 PDT
Date: Thu, 10 Aug 89 14:23 PDT
From: Montgomery Kosma <kosma@ALAN.LAAC-AI.Dialnet.Symbolics.COM>
Subject: Re: On-line help (was Re: Things that need to be on the Amiga (Was: ENV: handler (was Re: A ...)))
To: "Eagle::amiga-relay%udel.edu"@KAHUNA.LAAC-AI.Dialnet.Symbolics.COM
In-Reply-To: Your message of 10 Aug 89 12:39 PDT
Message-ID: <19890810212305.8.KOSMA@GEORG.LAAC-AI.Dialnet.Symbolics.COM>
 
    This sounds nice but for me, I just wrote a short shell script called
    "man" and put it in my s: directory.  When I type "man command", it
    runs my favorite text viewing program on a help file of the same name
    in my docs: directory.  I put all the ARP1.3 manual pages here and
    every time I add a utility that came with a doc file, I add it also.
    Typing "man" with no arguments just displays my docs:man file which
    lists all the available on-line doc files.  It works just like
    man on UNIX. Of course you can't do all this without a hard disk
    (I have about 130 doc files on line).
 
    ------------------------------------------------------------------------
 
    IBM - Inconsequential Bit Manipulator
 
			    Lyle Levine   lel@wuphys.wustl.edu
					  ...!uunet!wucs1!wuphys!lel
 
Something a step further which I've done is to create an alias using the
FIND program (I got it off of peoplelink).  The nice thing about this is
that it's basically a one-liner command, you don't have to type the
whole filename (e.g. typing "help vt100" would get vt100.doc), and you
can get multiple help files with one command (e.g. typing "help vt"
would get vt100.doc, vtek.doc, etc.)
 
first of all, I have a docs: directory assigned as well (true enough
that you can't do this w/o a hard disk).  Then, my shell-startup has:
 
alias help find docs: -name  *[]* -exec blitz {} ";"
 
(this is from my memory so it might not be quite right)
 
and to be even more sophisticated I've made it look for files with the
suffix .doc or .readme with separate commands, depending upon what type
of info I need.
 
Works quite well!
 
monty kosma
 

alh@hprmokg.HP.COM (Al Harrington) (08/12/89)

>This sounds nice but for me, I just wrote a short shell script called
>"man" and put it in my s: directory. 

You could also use an alias:

alias man c:more dh0:man/[]

I have the same setup with all the Arp1.3 "man" pages and all other
documentation.  I also have a an alias to print the man page:

alias pman c:runback >null: c:copy dh0:man/[] prt:

(who needs a steenkin' print spooler!  :-)

+-------------------------------------+------------------------------------+
| -Al Harrington                  /// |                                    |
|                                ///  |    "Do I look like I'm joking?"    |
| alh@hprmo.HP.COM           \\\///   |                                    |
| ..{hplabs,hp-sde}!hprmo!alh \XX/    |               - The Joker          |
+-------------------------------------+------------------------------------+
|         My comments in no way reflect the views or opinions of HP        |
+--------------------------------------------------------------------------+

laba-2kc@web-2a.berkeley.edu (Sang Yup Kim) (08/13/89)

In article <13240038@hprmokg.HP.COM> alh@hprmokg.HP.COM (Al Harrington) writes:
>You could also use an alias:
>
>alias man c:more dh0:man/[]
>
>I have the same setup with all the Arp1.3 "man" pages and all other
>documentation.  I also have a an alias to print the man page:

By the way, I have a short man program written in Rexx which uses the
RexxArpLib.  What it does is if you ask for man with no parameters,
it'll kick up the Arp file requestor on the Docs: directory.  After that,
it'll also ask if you want to use "More", or if you would prefer your favorite
editor (in the environment variable "EDITOR").  I find that most of the time,
more is just plain insufficient (especially for some of the more complex
commands).

------------------------------------------------------------------
Na Choon Piaw			laba-2kc@web.berkeley.edu
------------------------------------------------------------------

wdimm@lehi3b15.csee.Lehigh.EDU (William Dimm) (08/16/89)

Another way of keeping docs online with your Amiga (and harddrive) is
to use zoo.  That way, if a program has multiple document files, it
is still taken care of.  Just do something like:
	 zoo -print docs:filename | more
To display all of the documentation on 'filename'.  Zoo is fast enough
that this is reasonable to do, and it saves disk space.
-- 
------------------------------------------------------------------------
  //  Bill Dimm  wdimm@lehi3b15.csee.Lehigh.EDU   wcd0@lehigh.BITNET
\X/     "It's not the facts but the explanation that counts." - unknown
------------------------------------------------------------------------