Short: Open Opus 5 listers from shell easily. Author: Matthew Gregan (kinetik@caverock.net.nz) Uploader: Matthew Gregan (kinetik caverock net nz) Type: util/dopus Version: 1.1 Replaces: biz/dopus/Cuido.lha Requires: Directory Opus 5.5+, ARexx Architecture: generic Cuido v1.1, Copyright ©1998 Matthew Gregan. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Introduction: ~~~~~~~~~~~~~ After using Opus for a while, I found that I needed a way to open listers from the shell. I originally wrote this program sometime in 1997, and it served it's purpose. But then I noticed some problems with it, namely it didn't handle spaces in pathnames, and some of the other pathing functions. I sat down and spent a while tidying up the code and speeding it up where it could be (the original version was written in less than five minutes, and it showed) and I ended up with Cuido. Usage: ~~~~~~ You can use Cuido in the shell, by setting up an alias somewhere in your S:Shell-Startup, and copying Cuido to the correct place as follows: Copy Cuido.rexx DOpus5:Arexx/ Alias Cuido RX DOpus5:Arexx/Cuido.rexx Now, you can use Cuido in your shell. Here are some examples: Kinematics:> Cuido RAM: This will open a new lister in with it's path set to RAM: Kinematics:> Cuido This will open the current directory (in this case, Kinematics:) into a new lister. Kinematics:Devs/DOSDrivers> Cuido /Printers This will open Kinematics:Devs/Printers into a new lister. Cuido also supports opening multiple listers by simply typing a path for each lister you wish to open, for example: Kinematics:> Cuido DH1: Temp2: RAM: This will open three new listers, with their respective paths. If you are using multiple paths, and one of them needs to be the current directory, use double quotes, or a '.' if you're using the UnixDirs patch. Kinematics:> Cuido DH1: "" Temp2: This is the 'standard' Amiga way to refer to the current directory. Alternatively, you can put in somewhere in your command path, and set the script bit on the file, like this: Copy Cuido.rexx C:Cuido Protect C:Cuido +S Now you can use Cuido from the shell without an alias, and without having to call RX. There is no real advantage with this way, or the alias way. It's just a matter of taste. As you can see, using Cuido is very straight-forward, and easy. You shouldn't have any problems, but if you do, feel free to contact me and ask for help. Another use for Cuido is to create a hotkey in Opus, and set it to call Cuido and open a requester to ask the path... This is a fast alternative to opening a lister and clicking your way there. And I'm sure there are other uses too... Legal: ~~~~~~ This program is freeware. This means you are able to freely distribute it and use it, without having to pay the author. If you wish to include it with another program, please email me first for permission. Also, I am not liable for any damages or problems arising from the use of the program, directly or indirectly. Directory Opus is Copyright ©1997 Jonathan Potter & GPSoftware Cuido is Copyright ©1998 Matthew Gregan All other Copyrights are © their respective owners. History: ~~~~~~~~ Version Date Notes 1.1 1998-02-22 No changes to the actual script, but I've bumped the version number in it. The only changes I've made are to this readme. I actually proof-read this one, and realised I'd messed it up a bit. Sorry about that, but I *did* write the original at 4am. :) 1.0 1998-02-17 First public/Aminet release. No major changes from 0.9, but I just wrote some documentation and tidied up the Arexx code a little (ie: removed the debug code). 0.9 1998-02-16 This is the pre-Aminet version. I realised my path parsing didn't support some of the other Amiga path quirks, like multiple slashes to traverse dirs. After implementing a quick and easy fix, I found a much better way to handle all of the paths, which involved rewriting almost the entire program. Damn. 0.5 1998-02-11 Path parsing improved dramatically in 0.5. Now it supports paths with spaces, using quotes. <0.5 1997 First versions of Cuido, called CDO at this stage. These versions had some very lame routines in them. Bugs: ~~~~~ The only bug in Cuido, is very slight and should cause no problems. Basically, if you give Cuido a directory or device which it can't access, it will open the current directory in it's place. I think this is better than returning an error, since it's likely that the dir is inaccessible because you misspelled it, or something. So opening a lister in the current dir will mean you have a lister free for the correct path. If this bug/feature causes any problems, let me know and I'll change it. Author: ~~~~~~~ Matthew Gregan EMail: kinetik@caverock.net.nz IRC: Kinetik on A-Net #Amiga Drop me an email saying you're using Cuido, if you like. Let me know if you like it, hate it, or whatever. If you have problems using it, or would like to report a bug, email me at the above address. Thanks: ~~~~~~~ Thanks to Marcel 'Xar' Weber (MW@netaccess.co.nz) for beta testing, and for writing the quote parsing code on his machine, and reading it to me over the phone. This was much easier than actually having to think for myself. Also thanks to Wayne 'TB' Martin (tb@amiga.org) for being the champion of Daytona, one time running.