-----------------------------------------------------------------------------
What StarUrl does
-----------------------------------------------------------------------------

StarUrl converts a tree of OS/2 URL objects into an equivalent tree of StarOffice URL trees, or vice versa.

Characteristics of OS/2 URL objects:
- of type UniformResourceLocator
- of class WPUrl
- URL string is stored within the file
- description of URL is stored in the .LONGNAME extended attribute

OS/2 URL objects can be stored in folders of class WPUrlFolder.

Characteristics of StarOffice URL objects:
- files have .url extension
- URL is stored within the file
- description of URL is stored within the file

-----------------------------------------------------------------------------
How to use StarUrl
-----------------------------------------------------------------------------

The output of "starurl /h" should tell you everything you need.

-----------------------------------------------------------------------------
This is important!
-----------------------------------------------------------------------------

StarUrl is freeware. You pay for nothing, and I don't guarantee anything!

Please distribute only the complete and unmodified StarUrl package. Otherwise. add another readme file (call it, say, readme-2) that describes your modifications.

-----------------------------------------------------------------------------
Files in this distribution
-----------------------------------------------------------------------------

In the starurl directory:

starurl.cmd               - The Rexx source code and executable
readme                    - This file
register-rexxutil-dll.cmd - Script to register RexxUtil.dll (see below)

In the starurl\pgp directory:

starurl.sig               - RL's PGP signature for starurl.cmd
readme.sig                - RL's PGP signature for readme
register-rexxutil-dll.sig - RL's PGP signature for register-rexxutil-dll.cmd

----------------------------------------------------------------------------
The most recent version of StarUrl
----------------------------------------------------------------------------

You will find future revisions of StarUrl on Hobbes <http://hobbes.nmsu.edu/>.

You may also check http://homepages.together.net/~rolf for a link to a newer revision.

-----------------------------------------------------------------------------
RexxUtil library
-----------------------------------------------------------------------------

StarUrl requires functions from the RexxUtil DLL. These functions are also used by many other Rexx scripts. So, instead of trying again and again to register these functions each time you run a script that needs them, you should consider loading them when you start your system. 

To do this, put the script register-rexxutil-dll.cmd (or a link to this script) into your startup folder, or simply run register-rexxutil-dll.cmd at least once after each system boot, before you use StarUrl the first time.

-----------------------------------------------------------------------------
Miscellaneous
-----------------------------------------------------------------------------

To get my PGP public key, send an empty email with "send pgp key" in the subject line to rolf@together.net.

Feel free to send me suggestions for improvements of StarUrl. Of course I'd also appreciate a short note, if you actually use this program. 






Rolf Lochbuehler <rolf@together.net>
--
$Id: readme.m4,v 1.2 1999-12-13 23:51:02-05 rl Exp $
