CONTENTS ======== README Author: Chris Burns (HMU NZ) Date: 02.Sep.94 Version: 1.0 Directions regarding the deposit or retrieval of Hyper-G tools including information needed for new tools and prefered formats for different platforms. harmony.tar.gz Author: Paul Hulford (HMU NZ) Date: 13.Jul.94 Version: 1.4 This perl script sets up the extra environment variables required by harmony (harmony bin dir & harmony_home) before calling both the appropriate xrdb command and the appropriate harmony binary for the platform. hg.tar.gz Author: Paul Hulford (HMU NZ) Date: 13.Sep.94 Version: 1.6 In order to make harmony available to as wider audience as possible and without requiring staff and students to change their environment to accommodate I create this command which sits in the /usr/local/bin directory of each platform which both sets up the required environment and provides access to all the Hyper-G commands. The perl script acts in the following way. It first sets up a suitable environment (cpu, path, manpath). If there are no arguments it provides a menu of the most commonly used Hyper-G commands. (presently these are hgtv, harmony, hginsrht - see below, hginstext, hginfo, man, hginscoll, hgmvcp). A user can select a menu option and add what ever arguments they wish for that command which is then executed. If there is an argument and the arg1 is not a number then the arguments are taken to be a command and just executed in the new environment what ever they are. eg "hg ls" would list the current directory, "hg hgtv -r hyperg.tu-graz.ac.at" would correctly start the text viewer if a user had none of the extras required by Hyper-G in their environment. If the first argument is a number it is interpreted as a menu option allowing a bit of short hand. eg "hg 2" to start harmony. hgaccount.tar.gz Author: Paul Hulford (HMU NZ) Date: 09.Aug.94 Version: 2.3 As we are no managing a large number of accounts it was important quite early on to write a perl script that would add or remove a file of user names as hyper-G accounts. The command works like this hgaccount -a -f file_of_names -g group_name -H hostlist where -a means add (-r remove), -g (optional) gives them all the same group membership and -H (optional) is a list of hosts the users are each allowed to be autoidentified from. In addition to this it is also important to be able to update all the Hyper-G passwords to match our unix passwords wherever possible. This can be done by hgaccount -u (for update). hgchattribs.tar.gz Author: Paul Hulford (HMU NZ) Date: 10.Oct.94 Version: 1.4 A simple utility that given a collection will change all occurances of a given attribute with value X to value Y for all the documents in that collection eg hgchattribs -c coll_name -o old_attribute -n new_attribute for instance: hgchattribs -c homepages_paul -o "Author=paul" "Author=bruce-b" hgchname.tar.gz Author: Paul Hulford (HMU NZ) Date: 09.Aug.94 Version: 1.1 While I was standardising the group and account name structure it was necessary on several occasions to change the individual account names (mainly to match existing unix account names for password resolution but also where accounts terminated and I wanted to pass the ownership of all documents to a new owner). The command would change all occurances of an author to another name. eg (-o old, -n new) hgchname -o paul -n bruce hgcmd.tar.gz Author: Paul Hulford (HMU NZ) Date: 15.Sep.94 Version: 1.9 This command provided the menu of hyper-g options mentioned above for the "hg" command. You only want to have one copy of the menu so it is easily changed. The hg command above is placed in the /usr/local/bin of each Hyper-G participating host. hgcolltree.tar.gz Author: Paul Hulford (HMU NZ) Date: 09.Aug.94 Version: 1.1 Given a start collection generate a recursive list of all of its children stopping if you have seen a child before or if there are no more children. Used mainly to change access rights on a whole collection heirarchy. I usually use it in conjunction with hgchattribs hgemacs.tar.gz Author: Paul Hulford (HMU NZ) Date: 02.Aug.94 Version: 1.0 In order to provide the same editors across all the platforms commands like this are used to handle the variances of binary locations between platforms and variations between the location and versions of XWindows software. hginsrht.tar.gz Author: Paul Hulford (HMU NZ) Date: 14.Aug.94 Version: 2.8 Script that given a file, collection and a title will insert the file into Hyper-G. It automatically identifies test, htf or rtf files and handles them each accordingly. The script recognises paragraphs lists and titles and assigns appropriate HTF tags. It does a neat job and is used as the basis for automatically inserting email sent to hyper-G. hginsst.tar.gz Author: Paul Hulford (HMU NZ) Date: 5.Nov.94 Version: 1.0 Script that given a text file, collection and a title will insert the file into Hyper-G. The script recognises paragraphs lists and titles and assigns appropriate HTF tags. hgperl.tar.gz Author: Paul Hulford (HMU NZ) Date: 03.Aug.94 Version: 1.0 This is for a generic document type for the text viewer. It executes a perl script but has to first spawn a xterm for the output since there seems no way of capturing the Hyper-G hgtv window for output. This of course means that generic docs don't work over telnet even if the perl script output is simple ascii. hgxedit.tar.gz Author: Paul Hulford (HMU NZ) Date: 20.Jul.94 Version: 1.0 X windows editor for the current platform what ever that is. hifexport.tar.gz Author: Frank Kappe (Graz Austria) Date: 5.Nov.94 Version: 1.0 Use this program if you want to download a whole collection hierarchy from a Hyper-G server (and maybe upload it to another Hyper-G server). hifimport.tar.gz Author: Frank Kappe (Graz Austria) Date: 5.Nov.94 Version: 1.0 Use this program if you want to import a Hyper-G Interchange Format file into a Hyper-G server. logtime.tar.gz Author: Paul Hulford (HMU NZ) Date: 02.Nov.94 Version: 1.0 This is used to convert times recorded in log files as hex strings of seconds since Jan 71 to readable local time. Log file times are normally recorded for compactness by displaying output of the perl "time" command as a hex string eg. printf( LOG "%-10lx\n", time ); The logtime command takes this 8 character string and displays this as a local time in the format: h:mm:ss d/m/y. If no argument is passed the current local time is displayed. .