Re: [U2] Embedded help as hypertext
Wrapping in HTML is easy. Like anything ...doing it properly is hard...doing it right costs time and money...is it really worth it?? Unlikely - unless Rocket did it for us! :) Why don't just used BDT it has online context sensitive help and like the original poster said he uses the PDF. Key flaw in any plans is the large amount of missing commands and functions in all versions of the documentation (PDF, BDT, online in U2, etc.). In the past Rocket Software predecessor companies did produce Windows help file versionsas they do now for the fix/bug/release list download'ble from their website. Ideally, you should be just google it...and it would refer to a page on their site...just like you can do already for a numerous vendors... -Original Message- From: u2-users-boun...@listserver.u2ug.org [mailto:u2-users-boun...@listserver.u2ug.org] On Behalf Of Jeff Schasny Sent: Thursday, 13 March 2014 1:05 AM To: U2 Users List Subject: Re: [U2] Embedded help as hypertext The Universe 'HELP' (and HELP BASIC and HELP SQL) listings are all contained as records in the file 'HELP.FILE'. Creating a program to make an index page and html-ized versions of the individual items would be an easy project: LIST HELP.FILE PICK*SAVE.LIST TEXT 07:59:54am 12 Mar 2014 PAGE1 HELP.FILE. PICK*SAVE.LIST Text.. SAVE.LIST . . Use SAVE.LIST to save an active select list. You can use GET.LIST . to recall this list for subsequent processing and avoid having to . repeat the selection process each time you want to use the same selec . list. . . . Syntax . . SAVE.LIST [ [ filename ] listname ] [ FROM n ] . . . Parameters . . . The following table describes each parameter of the syntax. . On Tue, Mar 11, 2014 at 11:49 PM, Hona, David david.h...@cba.com.au wrote: 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: u2-users-boun...@listserver.u2ug.org [mailto: u2-users-boun...@listserver.u2ug.org] On Behalf Of Wjhonson Sent: Wednesday, 12 March 2014 3:43 AM To: u2-users@listserver.u2ug.org 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 U2-Users@listserver.u2ug.org 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
Re: [U2] Embedded help as hypertext
The Universe 'HELP' (and HELP BASIC and HELP SQL) listings are all contained as records in the file 'HELP.FILE'. Creating a program to make an index page and html-ized versions of the individual items would be an easy project: LIST HELP.FILE PICK*SAVE.LIST TEXT 07:59:54am 12 Mar 2014 PAGE1 HELP.FILE. PICK*SAVE.LIST Text.. SAVE.LIST . . Use SAVE.LIST to save an active select list. You can use GET.LIST . to recall this list for subsequent processing and avoid having to . repeat the selection process each time you want to use the same selec . list. . . . Syntax . . SAVE.LIST [ [ filename ] listname ] [ FROM n ] . . . Parameters . . . The following table describes each parameter of the syntax. . On Tue, Mar 11, 2014 at 11:49 PM, Hona, David david.h...@cba.com.au wrote: 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: u2-users-boun...@listserver.u2ug.org [mailto: u2-users-boun...@listserver.u2ug.org] On Behalf Of Wjhonson Sent: Wednesday, 12 March 2014 3:43 AM To: u2-users@listserver.u2ug.org 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 U2-Users@listserver.u2ug.org 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 U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users -- --- Jeff Schasny - jschasnyATgmailDOTcom --- ___ U2-Users mailing list U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users
Re: [U2] Embedded help as hypertext
Then, someone did the following for D3. http://www.d3ref.com/ It's really too bad this isn't how U2 provides documentation, as it'd get indexed all over the internet, which would be good marketing, maybe. :-) Bill - Original Message - *From:* david.h...@cba.com.au *To:* U2 Users List u2-users@listserver.u2ug.org *Date:* 3/11/2014 10:49 PM *Subject:* Re: [U2] Embedded help as hypertext 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: u2-users-boun...@listserver.u2ug.org [mailto:u2-users-boun...@listserver.u2ug.org] On Behalf Of Wjhonson Sent: Wednesday, 12 March 2014 3:43 AM To: u2-users@listserver.u2ug.org 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 U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users
[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 U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users
Re: [U2] Embedded help as hypertext
Anywhere where this UVHELP is explained more, and why it's better or at least different from HELP ? I tried it a bit, but the only additional thing I see it does is allow paging backward. -Original Message- From: Kurt Neumann kurt.neum...@axizworkgroup.com To: wjhonson wjhon...@aol.com Sent: Tue, Mar 11, 2014 10:08 am Subject: RE: [U2] Embedded help as hypertext From version 10.3 there is the new updated version of HELP - UVHELP. This is also a TCL command and is based on the PDFs. It is also used for the inline help in BDT. Thanks and regards Kurt From: u2-users-boun...@listserver.u2ug.org [u2-users-boun...@listserver.u2ug.org] on behalf of Wjhonson [wjhon...@aol.com] Sent: 11 March 2014 06:42 PM To: u2-users@listserver.u2ug.org 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 U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users Kurt Neumann | Business Unit Manager AxizWorkgroup Direct: +27 11 654 6175 | Office: +27 11 237 7000 | Cell: +27 82 825 5011 International Business Gateway Park,Cnr New and 6th Road,Midrand Please consider the environment before printing this mail This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. Dissemination, distribution or copying of this e-mail or the information herein by anyone other than the intended recipient, or an employee or agent responsible for delivering the message to the intended recipient, is prohibited. This footnote also confirms that this e-mail message has been swept by Trend Interscan Viruswall for the presence of computer viruses. ___ U2-Users mailing list U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users
Re: [U2] Embedded help as hypertext
you can page up with HELP too, if you use the right terminfo for your terminal emulator. I like to set my terminal for 132x44, but if my term width is 80 then HELP starts to mess up drawing it's boxes and placing the text. At 12 columns, it's an unreadable mess. UVHELP doesn't try to draw boxes, so works fine. One oddity--if you just type UVHELP with no arguments, it displays help for HELP On Mar 11, 2014, at 2:12 PM, Wjhonson wjhon...@aol.com wrote: Anywhere where this UVHELP is explained more, and why it's better or at least different from HELP ? I tried it a bit, but the only additional thing I see it does is allow paging backward. -Original Message- From: Kurt Neumann kurt.neum...@axizworkgroup.com To: wjhonson wjhon...@aol.com Sent: Tue, Mar 11, 2014 10:08 am Subject: RE: [U2] Embedded help as hypertext From version 10.3 there is the new updated version of HELP - UVHELP. This is also a TCL command and is based on the PDFs. It is also used for the inline help in BDT. Thanks and regards Kurt From: u2-users-boun...@listserver.u2ug.org [u2-users-boun...@listserver.u2ug.org] on behalf of Wjhonson [wjhon...@aol.com] Sent: 11 March 2014 06:42 PM To: u2-users@listserver.u2ug.org 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 U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users Kurt Neumann | Business Unit Manager AxizWorkgroup Direct: +27 11 654 6175 | Office: +27 11 237 7000 | Cell: +27 82 825 5011 International Business Gateway Park,Cnr New and 6th Road,Midrand Please consider the environment before printing this mail This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. Dissemination, distribution or copying of this e-mail or the information herein by anyone other than the intended recipient, or an employee or agent responsible for delivering the message to the intended recipient, is prohibited. This footnote also confirms that this e-mail message has been swept by Trend Interscan Viruswall for the presence of computer viruses. ___ U2-Users mailing list U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users ___ U2-Users mailing list U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users
Re: [U2] Embedded help as hypertext
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: u2-users-boun...@listserver.u2ug.org [mailto:u2-users-boun...@listserver.u2ug.org] On Behalf Of Wjhonson Sent: Wednesday, 12 March 2014 3:43 AM To: u2-users@listserver.u2ug.org 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 U2-Users@listserver.u2ug.org 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 U2-Users@listserver.u2ug.org http://listserver.u2ug.org/mailman/listinfo/u2-users