On 12/21/2013 07:00 PM (US Eastern Time), Amul Shah wrote:
Hi Andreas,
One, sorry for sending the last email as a top post.

On 12/20/13 17:09, Andreas Tille wrote:
  $ sudo aptitude install fis-gtm-6.0-003
  $ export gtm_dist=/usr/lib/fis-gtm/V6.0-003_x86_64
  $ export gtmroutines="$gtm_dist/libgtmutil.so $gtm_dist"
  $ $gtm_dist/mumps -dir
If this is the way you are calling mumps we should rather provide a
wrapper doing this.  WHat do you think?
  GTM>zhelp

  Error in GT.M  help utility
I just uploaded a package with your patch which shows the help properly.
Note: As a beginner it is definitely *not* intuitively to leave this
help - I neede to interupt by ^C.

[KSB] I have to agree that MUMPS is not always intuitive to the non-MUMPS person. But we're thinking of reworking on-line help, and for that reason it has not had the attention recently that it deservers.

We plan to make a package of GT.M documentation. For now, please go to http://fis-gtm.com and click on the User Documentation tab to get the documentation.

[amul:2] Could explain this a bit more? It may not be obvious but hitting return/enter a few times will exit the user from the "Topic?" prompt.

[KSB] Yes, this exit from help by hitting a series of Enters works. GT.M help (for historical reasons) is modeled on OpenVMS help.


[amul:2] Bhaskar spent a bit of time crafting a script called gtm in the installation directory. Assuming that GT.M is installed in /opt/fis-gtm/V6.0-003_x8664/, execute /opt/fis-gtm/V6.0-003_x8664/gtm. Here is what I see when I use GT.M as installed from FIS's GT.M distribution tar ball.

    shaha@shaha:~/work/cmakezhelp$ /opt/fis-gtm/V6.0-003_x8664/gtm
    %GDE-I-GDUSEDEFS, Using defaults for Global Directory
            /home/shaha/.fis-gtm/V6.0-003_x86_64/g/gtm.gld

    GDE>
    %GDE-I-EXECOM, Executing command file
    /opt/fis-gtm/V6.0-003_x8664/gdedefaults

    GDE>
    %GDE-I-VERIFY, Verification OK

    %GDE-I-GDCREATE, Creating Global Directory file
            /home/shaha/.fis-gtm/V6.0-003_x86_64/g/gtm.gld
    Created file /home/shaha/.fis-gtm/V6.0-003_x86_64/g/gtm.dat
    %GTM-I-JNLCREATE, Journal file
    /home/shaha/.fis-gtm/V6.0-003_x86_64/g/gtm.mjl created for region
    DEFAULT with BEFORE_IMAGES
    %GTM-I-JNLSTATE, Journaling state for region DEFAULT is now ON

    GTM>halt
    shaha@shaha:~/work/cmakezhelp$ /opt/fis-gtm/V6.0-003_x8664/gtm

    GTM>halt
    shaha@shaha:~/work/cmakezhelp$ /opt/fis-gtm/V6.0-003_x8664/gtm -help
    gtm -dir[ect] to enter direct mode (halt returns to shell)
    gtm -run <entryref> to start executing at an entryref
    gtm -help / gtm -h / gtm -? to display this text

[amul:2] Should we include a getting started section in the README?

[KSB] As Amul says, the gtm script included in GT.M is what people should use out of the box. It sets up a default environment and invokes the mumps program. So, the first time you run it, you will see all the verbiage above where it creates the environment in $HOME/.fis-gtm, or, if you define the gtmdir environment variable, in $gtmdir/.fis-gtm. Once an environment is created, gtm is quiet, e.g.:

   kbhaskar@bhaskark:~$ /usr/lib/fis-gtm/V6.0-003_x86_64/gtm

   GTM>write $zversion
   GT.M V6.0-003 Linux x86_64
   GTM>write 1024*1024
   1048576
   GTM>halt
kbhaskar@bhaskark:~$

Setting gtm_chset to utf-8, which also requires LC_CTYPE or LC_ALL to be defined to a suitable utf8 locale, runs the mumps process in UTF-8 mode, e.g.:

   kbhaskar@bhaskark:~$ gtm_chset=utf-8 LC_ALL=en_US.utf8
   /usr/lib/fis-gtm/V6.0-003_x86_64/gtm

   GTM>write $zchset
   UTF-8
   GTM>write "Victor jagt zwölf Boxkämpfer quer über den großen Sylter
   Deich"
   Victor jagt zwölf Boxkämpfer quer über den großen Sylter Deich
   GTM>write "你好世界" ; hello world in Chinese
   你好世界
   GTM>halt
   kbhaskar@bhaskark:~$


My Christmas vacation project is to draft a gtm man(1) page.

Regards
-- Bhaskar


thanks,
Amul

--
GT.M - Rock solid. Lightning fast. Secure. No compromises.

_____________
The information contained in this message is proprietary and/or confidential. 
If you are not the intended recipient, please: (i) delete the message and all 
copies; (ii) do not disclose, distribute or use the message in any manner; and 
(iii) notify the sender immediately. In addition, please be aware that any 
message addressed to our domain is subject to archiving and review by persons 
other than the intended recipient. Thank you.

Reply via email to