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.