Re: [U2] Embedded help as hypertext

"Hona, David" <[email protected]> Wed, 12 Mar 2014 16:49:50 +1100
Newsgroups gmane.comp.db.u2.general
Message-ID <7F9D3D6A1A51A34B91E427507ADF177C3AFB09C3C1@VAUNSW141.au.cbainet.com>
I assume you're talking about UV? Define 'improved'? 

It could be improved by actually having all the commands, options and functions in it first. Even the PDF versions are missing information....  :)

However, if you want another/"better" built-in HELP facility for your own purposes...PIHELP may help you (it offers paging back, sub-topics, indexing, etc.)...

If so, take a look at PIHELP (TCL verb) and SHOW.HELP (subroutine "-SHOW") which is a port of the Prime INFORMATION help which has 'hypertext' (sub-topics) and paging (back/forwards). In PI, there was also a subroutine you could call (rather than "EXECUTE PIHELP <subject>". It has own format where you can specify the help file source and sub-topics indexed based on keywords in the topic/help message, like this in field/line one:

0001: .*X PIHELP ONLINE COMMAND VERB TOPIC SUBJECT AID ASSISTANCE

An index on the help file would on the above field allow "PHELP ABOUT <keyword>". The "FROM" key word lets you specify you own help file.

It is better than the native UV HELP in some respects and utilises the default "SYS.HELP" file or your own (if required). I did note that there is no indices for the SYS.HELP file, so the "PIHELP ABOUT <topic>" function doesn't work...the required I-type dictionary item to parse the help records appears to be missing from the dictionary of SYS.HELP (Rocket Support should be able to assist there).

 The source is in APP.PROGS (PIHELP.B and SHOW.HELP.B) - good luck! I guess it has been "ported over" for PI/open users that used this facility for their own applications...

The U2 Tools have built online help too - which are handy. If you use them - I'd encourage all newcomers to use these tools and similar commercial products to supplement the built-in native command-line tools (aka terminal shell session)...

Cheers,
David


-----Original Message-----
From: [email protected] [mailto:[email protected]] On Behalf Of Wjhonson
Sent: Wednesday, 12 March 2014 3:43 AM
To: [email protected]
Subject: [U2] Embedded help as hypertext


Does anyone have an improved version of the TCL command HELP ?

Are there any wiki's or anything that comprise all of the HELP text and perhaps more ?

I sometimes use it, sometimes use the PDFs and sometimes just google.

I think it would be a great resource were there a better solution.


_______________________________________________
U2-Users mailing list
[email protected]
http://listserver.u2ug.org/mailman/listinfo/u2-users

************** IMPORTANT MESSAGE *****************************       
This e-mail message is intended only for the addressee(s) and contains information which may be
confidential. 
If you are not the intended recipient please advise the sender by return email, do not use or
disclose the contents, and delete the message and any attachments from your system. Unless
specifically indicated, this email does not constitute formal advice or commitment by the sender
or the Commonwealth Bank of Australia (ABN 48 123 123 124) or its subsidiaries. 
We can be contacted through our web site: commbank.com.au. 
If you no longer wish to receive commercial electronic messages from us, please reply to this
e-mail by typing Unsubscribe in the subject line. 
**************************************************************



_______________________________________________
U2-Users mailing list
[email protected]
http://listserver.u2ug.org/mailman/listinfo/u2-users