[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: [fis-gtm] user experience (WAS Re: Fis-gtm accepted in unstable)




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 to: