@DATABASE "CDOpus.guide" @AUTHOR "Leo Davidson " @(c) "Leo Davidson" @SMARTWRAP @WORDWRAP @$VER: CDOpus.guide 2.0 (11.5.96) @NODE MAIN "CDOpus - Contents" @Remark I really hate AmigaGuide creator programs. I've yet to use a good one. @{fg shine} @{par} CDOpus 2.0 (11-May-1996) @{fg fill}-@{fg shine} for Directory Opus 5.5 @{par} Written by Leo '@{b}Nudel@{ub}' Davidson @{fg fill}for @{fg shine}Gods'Gift Utilities @{par} 100% Assembler @{fg fill}-@{fg shine} May be made resident @{par}@{fg text} @{par} @{" Introduction " LINK Intro} @{par} @{" System Requirements " LINK Requirements} @{par} @{par} @{" Installation " LINK Installation} @{par} @{" Usage " LINK Usage} @{par} @{" Examples " LINK Examples} @{par} @{par} @{" History " LINK History} @{par} @{" Future & Known Bugs " LINK Future} @{par} @{par} @{" Credits " LINK Credits} @{par} @{par} @{" Children of the Storm " LINK COTS_Charity} @{par} @{par} @{par} @{par}@{fg shine} i'm drunk @{par} and right now i'm so in love with you @{par} and i don't want to think to much about what we should or shouldn't do @{par}@{i} lay my hands on Heaven and the sun and the moon and the stars @{par} while the devil wants to f k me in the back of his car @{ui} @{par} @{par} nothing quite like the feel of something new @{par} @{par} i swear @{par} i just found everything i need @{par} the sweat in your eyes the blood in your veins are listening to me @{par}@{i} well i want to drink it up and swim in it until i drown @{par} my moral standing is lying down @{ui} @{par} @{par} this is the only time i really feel alive @{par} @{par}@{fg fill} - trent reznor / nin@{fg text} @ENDNODE @NODE Beavis @{par}Pah, I wouldn't bother with the Browse button - the nodes are in no logical order. :-). @ENDNODE @NODE Butthead @{par}Look, I told you not to use Browse, so what's your problem? @ENDNODE @NODE Stuart @{par}@{i}Congratulations! @{ui}You've found the @{b}@{u}hidden part!@{ub}@{uu} @REMARK ...and this message is even more hidden. HEY YOU!! YEAH, YOU! @REMARK I can see you. YESSSS! I'm talking to *YOU*, MTFKR! Why are you @REMARK looking at me in the nude? You, my friend, are a god-damn PERVERT. @ENDNODE @NODE COTS_Charity "CDOpus - Children of the Storm" @{par} @{par} @{fg shine}Children of the Storm@{fg text} @{par} @{par}@{u} @{uu} @{par} @{par}@{b}NOTE@{ub}: This information hasn't been updated for a long time, but the ideas are still the same - only more things have been accomplished since it was written. The address at the end IS still correct. @{par} @{par}@{fg shine}Contacting COTS via the Internet: @{par}@{fg fill}EMail: @{fg text}Athy Demetriades @{par} @{fg fill}WWW: @{fg text}http://www.rmplc.co.uk/eduweb/sites/hampscit/storm.html @{par}@{u} @{uu} @{par} @{par}I know that most you out there won't pay anything at all, but I am doing this in the hope that at least a few people donate even a small amount of money, because every little penny can be put to some good! @{par} @{par}Please, at least read about the charity, Children of the Storm. I not going to say that anyone who doesn't send off some money should feel really guilty, just that anyone who does send off some money should feel really great, knowing that they've helped someone out. @{par} @{par}Even if you don't want to send any money (for whatever reasons), you could always send a letter of support, or spread the word to other people. @{par} @{par}I have never asked for any money for all the work I put into these utils, and I do not gain anything from your donations except knowing that I have helped some people out. I know that my work is used by a lot of people and that because of that, I have helped them out in one way or another, so why not help someone else now! You do have hearts, don't you? Make it worth my while typing all of this info! @{par} @{par} @{par} @{fg shine}Who are the CHILDREN OF THE STORM?@{fg text} @{par} @{par}In Britain this year, over a hundred young children will be accepted into the country by the Home Office, seeking political asylum. They may be just eleven or twelve years old. Often they have travelled across continents alone. They may have just lost their parents, seen brothers and sisters brutally murdered, or suffered beatings or torture themselves. Whilst our Government offers them basic shelter and the long-term possibility of war-refugee status in the UK, they can live here for weeks and months under the threat of instand deportation, sometimes forced to live rough without provision for food, clothing and other simple necessities. Far from their home and their culture, hungry, fearful and insecure, these children attempt, often with an astounding dignity and human spirit, to survive and grow despite the weight of unbearable memories they carry deep within... @{par} @{par} @{fg shine}Background@{fg text} @{par} @{par}Since 1989 several members of the staff at Hampstead School have been building up a support network for refugee children attending the school who have little or no family back-up, few resources, and are often in a critical emotional state. @{par} @{par}Achievements to date include: @{par} @{par}· Providing food, shelter and income for regugee children, working with the @{par} Tavistock Clinic which is providing counselling services and advising @{par} teachers, @{par}· Forging links with the local authority (London Borough of Camden) to put @{par} children and carers in touch with any relevant support agencies, @{par}· Establishing a social club in which refugee children are offered additional @{par} tuition and emotional support by their fellow pupils at the school, @{par}· Acting as the children's advocates in relation to housing, social services, @{par} social security etc. @{par} @{par} @{fg shine}Status@{fg text} @{par} @{par}Registered Charity number 1035774 @{par}Consultant: Sheila Kasabova, Refugee Co-ordinator, Camden Council @{par}Consultant Psychologist: Maureen Fox, Consultant Psychotherapist at the @{par} Tavistock Clinic @{par}Legal Consultants: Bindmans (services at no charge) @{par}Accountants: Alan Heywood, Chartered Accountants (services at no charge) @{par} @{par} @{fg shine}Aims and Objectives@{fg text} @{par} @{par}1. To continue to build on the existing project achievements outlined, @{par}2. To extend knowledge acquired by staff and pupils of the school to other @{par} schools and bodies dealing with refugee children through teacher-training @{par} programmes, conferences, booklets etc. @{par} @{par} @{fg shine}Summary of Projects in Progress or Anticipated@{fg text} @{par} @{par}1. Publishing a booklet: the Hampstead Story, by those involved in the @{par} project, outlining the problems Hampstead School itself has encountered @{par} with refugee children and strategies for dealing with them. To be @{par} delivered free of charge to every school in the country. @{par} Cost: £9,000. Project in progress. @{par}2. Expanding the social club outlined above to include students from other @{par} local schools including primary schools. @{par} Cost: £50 per month. Project in progress. @{par}3. Employing a full-time counsellor at Hampstead School to counsel children @{par} and train staff in counselling techniques. @{par} Cost: £38,000 pa. @{par}4. Employing an administrative assistant to manage the charity. @{par} Cost: £20,000 pa. @{par}5. Holding a national conference on problems faced by refugee children in @{par} Britain, and strategies for overcoming them, open to any persons or @{par} organisations working with regugee children (teachers, welfare and social @{par} servicesm volunteer groups etc.) @{par}6. Employing a fundraiser. @{par} Cost: £15,000 pa. @{par} @{par} @{fg shine}Conclusion@{fg text} @{par} @{par}The project originated at Hampstead School is the only one of its kind. Due largely to recent wide coverage and acclaim in local, national and international media, it is increasingly being recognised by local authorities as a role model for other schools. Central to the project's success is teacher Athy Demetriades, who has assisted on training days in schools around the country. Regular requests for her to speak now come from solicitors, educational psychologists, welfare services and radio programmes as well as schools. On average, she fulfils one such engagement per week. She is, in effect, becoming one of few experts on the all-round care of children suffering a unique combination of problems - the destruction of the childhood together with the loss of citizenship and any automatic recourse to law and welfare that citizenship entails. @{par} @{par}Sponsorship for Children of the Storm would ensure that the work originated at Hampstead School can continue. It would also lay the foundations for a training programme enabling teachers and carers right across the country to provide the basics of security and education to refugee children. @{par} @{par} @{fg shine}Further Information@{fg text} @{par} @{par}This is basically what you would find on the letter head: @{par} @{par}@{fg fill}Children Of The Storm @{par}Hampstead School @{par}Westbere Road @{par}London @{par}NW2 3RT @{par}United Kingdom@{fg text} @{par} @{par}There is a telephone and fax number, but I feel that it would be unwise to @{par}include it here, as there are a few idiots out there who might abuse it. @{par} @{par}Charity registration number 1035774 @{par} @{par}Patrons: @{par}@{fg fill} Dame Judi Dench, @{par} Lindsay Duncan, @{par} Geraldine James, @{par} Griff Rhys Jones, @{par} John Gordon Sinclair.@{fg text} @{par} @{par}Trustees: @{par} @{fg fill}A. Demetriades, @{par} A. Berkeley, @{par} M. Janota Bzowski, @{par} S. Pickford, @{par} G. Walker, @{par} M. Johnson, @{par} F. Capone.@{fg text} @{par} @{par}Consultants: @{par} @{fg fill}M. Fox THE TAVISTOCK CLINIC, @{par} M. Martin LEGAL ADVISER, @{par} A. Heywood A.C.A, @{par} S. Kasabova CAMDEN L.E.A.@{fg text} @{par} @{par} The address is up there, so go on, donate! @{par} If you think you can offer something other than money, write! @{par} @{par} I want to say a huge thanks to anyone who does donate some money. @{par} @{par} Thanks for at least reading this... and sorry for any mistakes in @{par} the above text - my typing can go a bit haywire sometimes!! @ENDNODE @NODE Intro "CDOpus - Introduction" @{par}CDOpus was originally based on the @{fg shine}CDO.dopus5@{fg text} and @{fg shine}OCD.dopus5@{fg text} ARexx scripts which @{" I " LINK Credits} wrote a while ago. I wrote it in order to develop my routines for talking to ARexx ports via Assembler, but since then it has actually grown in to something quite useful! @{par} @{par}@{u}Basically@{uu}, the program has three functions which are intended to make moving between Shell and @{fg shine}Directory Opus@{fg text} quicker and easier: @{par} @{par}@{fg fill}1)@{fg text} You can run it from a Shell to change-directories to the same path as @{par} your Directory Opus 5 source lister. @{par}@{fg fill}2)@{fg text} You can run it from a Shell and have a new DOpus lister open with the @{par} same path as your shell. (You can also read into a lister which is @{par} already open). @{par}@{fg fill}3)@{fg text} You can cause DOpus to perform one of its commands on some of the @{par} files in the current directory. @{fg shine}...did I say three? I meant four...@{fg text} @{par}@{fg fill}4)@{fg text} You can also use it as a command to open listers with given paths, positions and modes for when the internal ScanDir command doesn't offer you enough. @{fg shine}...I didn't expect some kind of Spanish Inquisition...@{fg text} @{par}@{fg fill}5)@{fg text} Finally, you can set local and global environment variables to lister paths for use in scripts. @{par} @{par}Read the @{" usage " LINK Usage} node to see exactly what it can do. @ENDNODE @NODE Requirements "CDOpus - Requirements" @{par}See also: @{" Known Bugs " LINK Future} @{par} @{par}This program should run on any Amiga with AmigaOS 2 or above. @{par} @{par}Of course, you also need @{fg shine}Directory Opus 5@{fg text} (version @{b}5.5@{ub} or above). @{par} @{par}This @{fg fill}AmigaGuide@{fg text} takes advantage of some of the extra features of the @{fg fill}OS3.1 amigaguide.datatype@{fg text}, such as @{fg fill}SmartWrap@{fg text}, @{fg fill}WordWrap@{fg text}, @{fg fill}Colour@{fg text}, and @{fg fill}Styles@{fg text}. @{fg fill}OS3.0@{fg text} users should get everything apart from the @{fg fill}SmartWrapping@{fg text}, and @{fg fill}OS2@{fg text} users should still see the same text, just not as @{bg shine}p@{bg fill}r@{bg shine}e@{bg fill}t@{bg shine}t@{bg fill}y@{bg back}. @ENDNODE @NODE Credits "CDOpus - Credits" @{par} @{fg shine}@{u}The Author:@{uu}@{fg text} @{par} @{fg fill}Leo Davidson @{par} @{fg text}leo.davidson@keble.oxford.ac.uk @{par} @{fg text}http://users.ox.ac.uk/~kebl0364 @{par} @{fg shine}Nudel@{fg fill} in #Amiga on Effnet & Undernet @{par} @{par}@{fg text}Please mail me if you find any bugs, or have any ideas for new features. @{par} @{par}The full assembler source-code for this program is available on my Web-Page, or from Aminet in biz/dopus. @{par} @{par}@{fg fill} Directory Opus 5 developed by Jonathan Potter and GPSoftware. @{par}@{fg fill} Please support this amazing piece of software and the equally amazing @{par}@{fg fill} creators by purchasing it. @{par} @{par} @{fg shine}@{u}Additional ideas, support, and advice@{uu} @{par} @{fg shine}(Alphabetical order):@{fg fill} @REMARK Don't use SortBlock to sort this because of the spaces. @{par} Dave Clarke @{par} Dave Freeman @{par} Greg Perry @{par} Jonathan Potter @{par} Trevor Morris @{par} Ahmed's Kebab Van, Oxford. ;-) @{par} (The 'Babylonian Army of Babshit will kick your arse!) @{par} @{par} @{fg shine}@{u}Beta testing & Bug reports@{uu} @{par} @{fg shine}(Alphabetical order):@{fg fill} @{par} Frederic Steinfels @{par} Trevor Morris @{par} Troels Walsted Hansen @{par} @{par} @{fg shine}@{u}Musical Support Used While Programming@{uu} @{par} @{fg fill}Rage Against The Machine @{fg text}(Evil Empire) @{par} @{fg fill}The Red Hot Chilli Peppers @{fg text}(One Hot Minute) @{fg shine}[The best album of '95?] @{par} @{fg fill}Faith No More @{fg text}(King For A Day) @{par} @{fg fill}Tool @{fg text}(Undertow, Prison Sex) @{par} @{fg fill}Nine Inch Nails @{fg text}(Further Down The Spiral, UK Version) @{par} @{fg fill}Jamiroquai @{fg text}(Return Of The Space Cowboy) @{par} @{fg fill}Metallica @{fg text}(...And Justice For All) @{par} @{fg fill}Multiplayer @{fg text}(Various Modules) @{par} @{fg fill}Beavis'n'Butthead @{fg text}(Various Samples) @{par} @{par} This guide was tested with @{" CheckGuide " LINK CheckGuide} 1.0 by Eddy Carroll @{par} @{par} @{par}@{u}@{fg shine} My setup: @{uu}@{fg text} @{par} @{par} A500, 68000, 1/4 meg chip/fast, 300mb of harddrives, OS3.1 @{par}A1200, 68030 50mhz FPU MMU, 2/8 meg chip/fast, one 810mb harddrive, OS3.0 @{par} (And a bloody nice Wizard Developments 3-button mouse sitting on a @{par} tasteless Hamburger mouse mat!) @{par} @{par}I run DOpus5 in workbench replacement mode (please not you don't HAVE to) on a 32 colour workbench using the dark MWB palette and Pal: Hires, 720 * 282 (overscan). One day I'll have a seventy-eight inch monitor which can sync down to 1hz. One day, just after I take over the world. @{par} @{par}MCP does almost all of my system enhancing -- it rulez. @{par}Other things I run of note ar PowerSnap, CycleToMenu (don't like MCP's), ScreenWizard, KingCON, TinyMeter, CygnusEd, RexxEvent, GrabIFF, and MagicMenu. @{par}My assigns are all done with Assign prefs (not MCP), and I use ILock to keep people out of my system from time to time. WaitForValidate stops my harddrive going crazy sometimes, and Super-Select and PicBoot keep me entertained with random bootpictures from my collection of around 550 pictures. @{par} @{par} @{par} As the economic situations and standards of living of millions around the World fall, people once more begin to blame those old, easy targets. They contradict: so proud of their "great" country, but still blaming minorities for how bad things are. WAKE UP. Your country is shit because of the system; because of what has been happening for hundreds of years; because of those who are easily led into red-herring causes while the real problem is allowed to continue, unnoticed by the masses. @{par} More people don't screw up a country, mismanagement does. Britain is mismanaged, Germany is mismanaged, America is mismanaged. The entire World is mismanaged. And it isn't because of the Jews, the Blacks, the Asians, or the Refugees, it's because while fools blame the innocent scapegoats the real criminals continue. @{par} Any educated human being with half a brain can logically work out that the ideas of Nazis can solve nothing and only set back the progress of @{par}humanity. __aµæææÑÑÑÑææmµ___ @{par} __æÆØØØØØØØØØØØØØØØØØØÑm__ @{par} aæØØØØØ@°"¯ __ ¯¬"¶M#ØØØØm_ @{par} _æØØØØ@" _ÆØØm_ ¬°ÑØØØÑw_ @{par} µØØØ#° _æØØØØØØp ¬¶#ØØÑw @{par} ÆØØØ" _ÆØØØØØØ#" _æ#_ ¶ØØØm @{par} _ÆØØ@ ,dØØØØØØ#" _ÆØØØP_æØØØØØØÑ_ @{par} ØØØF ¶ØØØØØ#_ _ÆØÑ°aæØØØØØØØ#ØØ& @{par} ÆØØ@ °#ØØØØ#w _ø@5µÆØØØØØØѶ_ ¬#ØØK @{par} JØØØ ¶ØØØØØÑw¤ÇµÆØØØØØØ@5æÆØ#w ¬ØØØ @{par} aØØ# _ ¬¶Ø#¶5æØØØØØØØP" ¶ØØØØØÑ #ØØL @{par} ØØØF _aÆØm_ _µæØØØØØØÑ°¯ ¬ÑØØP 0ØØQ @{par} ØØØL #ØØØØÑ_ _µÆØØØØØØ@5æÆÑ_ ° ÆØØ# @{par} ÆØØE ¶ØØØ#M_µØØØØØØØP" ÆØØØØØm_ ØØØF @{par} JØØ# ¬®µæØØØØØØѶ®æ" ¬#ØØØØØm_ JØØØÞ @{par} 0ØØK _µÆØØØØØØ@®µÆ#" °ØØØØØØm ÆØØ# @{par} ¬#ØØÆØØØØØØM5æØØ#" µØØØØØØØ" æØØØ @{par} ¬ØØØØØÑ°¯ °##" µÆØØØØØØP dØØØ` @{par} ¬#ØØb_ ¬ _ØØØØØØØP _ØØØ# @{par} ¶ØØØm_ aÆØØØØØØK _ÆØØØP @{par} ¬ÑØØØæµ_ ¬#ØØØØP¯ _µÆØØØ@` @{par} ¬¶#ØØØÑm___ °#° __µæØØØØØP" @{par} "¶ÑØØØØØØMÑææææÑÆØØØØØØØP" @{par} "°¶#ÑØØØØØØØØØ#@°" You know it makes sense. @ENDNODE @NODE "CheckGuide" "CheckGuide by Eddy Carroll" @{par} @{fg shine}CheckGuide 1.0 -- Checks AmigaGuide files for common errors @{par} @{par} by Eddy Carroll, September 1994. Freely distributable.@{fg text} @{par} @{par}Introduction @{par} @{par}If you've ever tried creating even a modestly sized AmigaGuide file by hand, @{par}you'll have discovered that it can be quite difficult to keep track of all the @{par}various links and cross references. As your help file gets larger, it gets @{par}increasingly harder to ensure that you have remembered to reference all the @{par}nodes in the file from at least one place, and haven't left any unresolved @{par}links. @{par} @{par}CheckGuide is a simple utility that can detect several common errors in @{par}AmigaGuide files. The errors it can detect are: @{par} @{par}· Extra plain text between an \@ENDNODE and \@NODE (AmigaGuide won't allow such @{par} text to ever be displayed) @{par} @{par}· Nodes that are defined but not referenced from any other node. Unless your @{par} program directly instructs AmigaGuide to access such nodes, the user won't @{par} easily be able to access them. @{par} @{par}· Links to help nodes that aren't defined within the file. @{par} @{par}· Open braces with no preceding \@ character (usually a simple typo). @{par} @{par}· \@{" Button "} constructs with no LINK command (an easy mistake to make if @{par} you're entering a lot of them). @{par} @{par}All of these options can be selectively enabled or disabled. @{par} @{par} @{fg shine}CheckGuide was used in the creation of @{b}THIS@{ub} document!@{fg text} @ENDNODE @NODE Installation "CDOpus - Installation" @{par}See also: @{" Usage " LINK Usage} @{par} @{" Examples " LINK Examples} @{par} @{par}@{b}NOTE:@{ub} This is just a @{u}suggestion@{uu} of how to install it. You can do with it @{par} what you want, and indeed the program can do @{u}many@{uu} more things than @{par} the two things which we'll set-up here. @{par} @{par}@{fg fill}o@{fg text} Make sure the @{fg fill}"P"@{fg text} bit is set as this program is @{fg shine}'Pure'@{fg text} and may be made @{par} @{b}resident@{ub} @{fg fill}(see below)@{fg text}. @{par}@{fg fill}>@{fg text} @{bg fill} Protect CDOpus +P @{bg back} @{par} @{par}@{fg fill}o@{fg text} Copy the main file to @{fg fill}DOpus5:c/@{fg text} @{par}@{fg fill}>@{fg text} @{bg fill} Copy CDOpus DOpus5:c/ @{bg back} @{par} @{par}@{fg fill}o@{fg text} Copy the AmigaGuide to @{fg fill}DOpus5:Help/@{fg text} @{par}@{fg fill}>@{fg text} @{bg fill} Copy CDOpus.guide DOpus5:Help/ @{bg back} @{par} @{par}@{fg fill}o@{fg text} Setup a @{fg shine}"CDO"@{fg text} alias in your shell to CD to the source lister's directory. @{par} (Add this to your @{fg fill}S:Shell-Startup@{fg text}) @{par}@{fg fill}>@{fg text} @{bg fill} Alias CDO "DOpus5:c/CDOpus" @{bg back} @{par} @{par}@{fg fill}o@{fg text} Setup an @{fg shine}"OCD"@{fg text} alias in your shell to open a new lister in your current dir. @{par} (Add this to your @{fg fill}S:Shell-Startup@{fg text}) @{par}@{fg fill}>@{fg text} @{bg fill} Alias OCD "DOpus5:c/CDOpus Open" @{bg back} @{par} @{par}@{fg fill}o@{fg text} Read the @{" usage " LINK Usage} and @{" examples " LINK Examples} sections to see what else you can do! @{par} @{par}@{fg fill}o@{fg text} If you want to make the command @{b}resident@{ub} (to save loading time), add this @{par} line to your @{fg fill}S:User-Startup@{fg text}... @{par}@{fg fill}>@{fg text} @{bg fill} Resident DOpus5:c/CDOpus @{bg back} @{par} ...and change all the alias commands to reference @{fg fill}"CDOpus"@{fg text} instead of @{par} @{fg fill}"DOpus5:c/CDOpus"@{fg text}. @ENDNODE @NODE Usage "CDOpus - Usage" @{par}See also: @{" Installation " LINK Installation} @{par} @{" Examples " LINK Examples} @{par} @{par}The @{fg fill}CDOpus@{fg text} command takes the following command-line parameters: @{par} @{par}@{fg shine}Generic:@{fg text} @{par} @{" RexxPort " LINK U_RexxPort} Specify a differnt port instead of @{fg shine}"DOPUS.1"@{fg text}. @{par} @{" Help " LINK U_Help} @{fg fill}Switch:@{fg text} Brings up this text. @{par}@{fg shine}Modes:@{fg text} @{par} @{" " LINK U_CD } CD to 'source' lister's path. @{par} @{" Open " LINK U_Open} @{fg fill}Switch:@{fg text} Read path into a lister. @{par} @{" Action " LINK U_Action} @{fg fill}Switch:@{fg text} Read path into new source lister. @{par} @{" SetVar " LINK U_SetVar} @{fg fill}Switch:@{fg text} Set environment variable. @{par}@{fg shine}CD mode only:@{fg text} @{par} @{" Quiet " LINK U_Quiet} @{fg fill}Switch:@{fg text} Don't echo the new path to the shell. @{par}@{fg shine}Open/Action modes only:@{fg text} @{par} @{" NoFront " LINK U_NoFront} @{fg fill}Switch:@{fg text} Don't pop the DOpus screen to front. @{par} @{" Dir " LINK U_Dir} Specify a different directory to read, instead of . @{par} @{" Pos " LINK U_Pos} Specify different lister position in x/y/w/h format. @{par}@{fg shine}Open/SetVar modes only:@{fg text} (Open defaults to a new lister) @{par} @{" Source " LINK U_SourceDestLock} @{fg fill}Switch:@{fg text} Read to/from 'source' lister. @{par} @{" Dest " LINK U_SourceDestLock} @{fg fill}Switch:@{fg text} Read to/from 'destination' lister. @{par}@{fg shine}Open mode only:@{fg text} @{par} @{" New " LINK U_New} @{fg fill}Switch:@{fg text} Force new lister (source/dest/off). @{par} @{" Lock " LINK U_SourceDestLock} @{fg fill}Switch:@{fg text} Lock new lister as source/dest. @{par}@{fg shine}Action mode only:@{fg text} @{par} @{" ActPat " LINK U_ActPat} Specify files to select. @{par} @{" ActCom " LINK U_ActCom} Specify DOpus5 command to execute. @{par} @{" ActClose " LINK U_ActClose} @{fg fill}Switch:@{fg text} Close lister on completion. @{par}@{fg shine}SetVar mode only:@{fg text} @{par} @{" Global " LINK U_Global} @{fg fill}Switch:@{fg text} Set global variable instead of local. @{par} @{par}@{fg shine}@{u}ReadArgs() Template:@{uu}@{fg text} @{par}RP=REXXPORT/K, HELP/S, QUIET/S, OPEN/S, ACTION/S, SETVAR/S, DIR=PATH/K, SOURCE/S, DEST/S, LOCK/S, NEW/S, POS=DIMENSIONS/K, PAT=ACTPAT/K, COM=ACTCOM/K, ACTCLOSE/S, GLOBAL/S, NOFRONT/S: @ENDNODE @NODE U_RexxPort "CDOpus - Usage, RexxPort" @{par}See also: @{" Examples " LINK Examples} @{par} @{par}@{fg fill}RexxPort@{fg text} is an optional @{b}keyword@{ub} which lets you specify the name of the ARexx port to talk to. By default this is @{fg fill}"DOPUS.1"@{fg text} (most of the time you'll only be running one copy of DOpus), but should you need to address another name you can use this. @{par} @{par}@{b}NOTE:@{ub} Port names are @{u}case-sensitive@{uu}. @{par} @{par}When running @{fg fill}CDOpus@{fg text} from Directory Opus, you should @{u}always@{uu} specify the Rexx port in case one day you run two copies. To do this you should have... @{par}@{fg fill}>@{fg text} @{bg fill} ... RexxPort {Qp} ... @{bg back} @{par}...on the command-line. @ENDNODE @NODE U_Help "CDOpus - Usage, Help" @{par}Seel also: @{" Future " LINK Future} @{par} @{par}@{fg fill}Help@{fg text} is a @{b}switch@{ub} which will dump the help-text to the shell window when given. @ENDNODE @NODE U_CD "CDOpus - Usage, CD Mode" @{par}See also: @{" Usage " LINK Usage} @{par} @{" Examples " LINK Examples} @{par} @{" Quiet " LINK U_Quiet} @{par} @{par}@{fg shine}@{u}CD Mode@{fg text}@{uu} @{par} @{par}This is the @{b}default@{ub} mode and is used whenever none of the others are specified. In @{fg fill}CD Mode@{fg text} the program will attempt to change your shell's current directory to that of the DOpus 'source' lister. @{par} @{par}In this mode, all error messages go to the shell window, while in all other modes error messages appear in @{b}requesters@{ub}. @{par} @{par}Unless you give the @{" Quiet " LINK U_Quiet} switch the new directory path is echoed to the shell. @ENDNODE @NODE U_Open "CDOpus - Usage, Open Mode" @{par}See also: @{" Usage " LINK Usage} @{par} @{" Examples " LINK Examples} @{par} @{" NoFront " LINK U_NoFront} @{par} @{" Dir " LINK U_Dir} @{par} @{" Pos " LINK U_Pos} @{par} @{" Source / Dest / Lock " LINK U_SourceDestLock} @{par} @{" New " LINK U_New} @{par} @{par}@{fg shine}@{u}Open Mode@{fg text}@{uu} @{par} @{par}Giving the @{fg fill}Open@{fg text} @{b}switch@{ub} puts CDOpus into @{fg fill}Open Mode@{fg text}. This mode is intended for reading the directory your shell is in into a DOpus lister. @{par} @{par}By default, a new lister is created, but if you specify the @{" Source " LINK U_SourceDestLock} or @{" Dest " LINK U_SourceDestLock} switches CDOpus will attempt to read the path into an existing lister of the type given. It will still open a new lister if it can't find an existing one of the correct type. @{par} @{par}If you want to open a new lister of a given type you should also give the @{" New " LINK U_New} switch on the command line, along with any of @{" Source " LINK U_SourceDestLock}, @{" Dest " LINK U_SourceDestLock}, and @{" Lock " LINK U_SourceDestLock}. @{par} @{par}You can specify the position for any newly created lister with the @{" Pos " LINK U_Pos} keyword. @{par} @{par}You can read in a different directory with the @{" Dir " LINK U_Dir} keyword. @ENDNODE @NODE U_Action "CDOpus - Usage, Action" @{par}See also: @{" Usage " LINK Usage} @{par} @{" Examples " LINK Examples} @{par} @{" NoFront " LINK U_NoFront} @{par} @{" Dir " LINK U_Dir} @{par} @{" Pos " LINK U_Pos} @{par} @{" ActPat " LINK U_ActPat} @{par} @{" ActCom " LINK U_ActCom} @{par} @{" ActClose " LINK U_ActClose} @{par} @{par}@{fg shine}@{u}Action Mode@{fg text}@{uu} @{par} @{par}This mode is enabled when the @{fg fill}Action@{fg text} @{b}switch@{ub} is given. A new 'source' lister for the current directory will open and it is possible to give a @{" file pattern " LINK U_ActPat} and @{" DOpus command " LINK U_ActCom} so that all files matching the pattern have the command performed on them. @{par} @{par}You can act on a different directory using the @{" Dir " LINK U_Dir} keyword, and you can change the new lister's position using the @{" Pos " LINK U_Pos} keyword. @{par} @{par}You don't have to give either the pattern or the command (you could just select some files, for example, or just issue a command like @{fg shine}"all"@{fg text}), and you can have the lister @{" close " LINK U_ActClose} automatically once the command has completed. @ENDNODE @NODE U_SetVar "CDOpus - Usage, SetVar" @{par}See also: @{" Usage " LINK Usage} @{par} @{" Examples " LINK Examples} @{par} @{" Source / Dest " LINK U_SourceDestLock} @{par} @{" Global " LINK U_Global} @{par} @{par}@{fg shine}@{u}SetVar Mode@{fg text}@{uu} @{par} @{par}When you give the @{fg fill}SetVar@{fg text} @{b}switch@{ub} CDOpus runs in @{fg fill}SetVar Mode@{fg text}. This means that it gets the path of either the @{" source " LINK U_SourceDestLock} or @{" destination " LINK U_SourceDestLock} lister and sets the @{fg shine}CDOSource@{fg text} or @{fg shine}CDODest@{fg text} environment variable. @{par} @{par}By default the variable is local to the shell you are running in. You can make the variable available to the entire system with the @{" Global " LINK U_Global} switch. @{par} @{par}If you don't know what environment variables are you should look them up in a good AmigaOS manual. @{fg shine}:-)@{fg text}. @ENDNODE @NODE U_Quiet "CDOpus - Usage, Quiet" @{par}Normally, in @{" CD Mode " LINK U_CD}, the name of the new path is echoed to the shell before the actual directory change takes place. If the @{fg fill}Quiet@{fg text} @{b}switch@{ub} is given this doesn't happen. @ENDNODE @NODE U_NoFront "CDOpus - Usage, NoFront" @{par}Normally, when in @{" Open Mode " LINK U_Open} or @{" Action Mode " LINK U_Action} the DOpus screen is popped to the front. If you specify the @{fg fill}NoFront@{fg text} @{b}switch@{ub} this doesn't happen. @ENDNODE @NODE U_Dir "CDOpus - Usage, Dir" @{par}By default, when in @{" Open Mode " LINK U_Open} or @{" Action Mode " LINK U_Action} a lister will read in the current directory of your shell. You can use the @{fg fill}Dir@{fg text} @{b}keyword@{ub} to specify a different directory to read in. @{par} @{par}Amoung other things, this can be used to open listers from DOpus buttons when you need a little more control than is offered by the internal ScanDir command. @ENDNODE @NODE U_Pos "CDOpus - Usage, Pos" @{par}By default, new listers created by CDOpus open under your mouse pointer with the default size or that snapshotted to the path. @{par} @{par}The @{fg fill}Pos@{fg text} @{b}keyword@{ub} can be used to set a different size and/or position for new listers openned by @{" Open " LINK U_Open} or @{" Action " LINK U_Action}. @{par} @{par}The format is @{fg fill}@{fg text}/@{fg fill}@{fg text}/@{fg fill}@{fg text}/@{fg fill}@{fg text}, e.g. 50/10/100/200 @{par} @{par}@{b}NOTE: @{ub}Specifying -1/-1/@{fg fill}@{fg text}/@{fg fill}@{fg text} will make the lister open under the mouse. @ENDNODE @NODE U_SourceDestLock "CDOpus - Usage, Source/Dest/Lock" @{par}@{u}@{fg shine}The Source, Dest, and Lock Switches@{fg text}@{uu} @{par} @{par}The effect of these @{b}switches@{ub} varies depending on what mode you are in: @{par} @{par}In @{" Open Mode " LINK U_Open} the @{fg fill}source@{fg text} switch tells CDOpus that you want to read the directory into the 'source' lister instead of a new one. A new lister will still be created if no source one is found. @{par} @{par}If you give the @{" New " LINK U_New} switch as well as the @{fg fill}Source@{fg text} one in @{" Open Mode " LINK U_Open} CDOpus will open a new lister for your path and put it in 'source' mode. If you also give the @{fg fill}Lock@{fg text} switch the lister will be locked in source mode. @{par} @{par}In @{" Open Mode " LINK U_Open} the @{fg fill}Dest@{fg text} switch acts just like the @{fg fill}Source one@{fg text}, with a few obvious differences. @{par} @{par} @{par}In @{" SetVar Mode " LINK U_SetVar} the @{fg fill}Source@{fg text} switch tells CDOpus to set the @{fg shine}CDOSource@{fg text} environment variable to the path of the 'source' lister. The @{fg fill}Dest@{fg text} switch sets the @{fg shine}CDODest@{fg text} variable to the path of the 'destination' lister. @ENDNODE @NODE U_New "CDOpus - Usage, New" @{par}When in @{" Open Mode " LINK U_Open} the @{fg fill}New@{fg text} @{b}switch@{ub} tells CDOpus that it must create a new lister and put it into the mode given by the @{" source, dest, and lock " LINK U_SourceDestLock} switches. @ENDNODE @NODE U_ActPat "CDOpus - Usage, ActPat" @{par}Listers openned in @{" Action Mode " LINK U_Action} can have some or all of their files selected by giving any valid AmigaDOS pattern to the @{fg fill}ActPat@{fg text} @{b}keyword@{ub}. Note that the @{fg fill}ActPat@{fg text} keyword is entirely @{i}optional @{ui}-- you can execute a DOpus @{" command " LINK U_ActCom} without selecting any files. @ENDNODE @NODE U_ActCom "CDOpus - Usage, ActCom" @{par}When in @{" Action-mode " LINK U_Action}, the @{fg fill}ActCom@{fg text} keyword takes the name of one of the internal DOpus commands (you know -- "@{fg fill}Delete@{fg text}", "@{fg fill}All@{fg text}", "@{fg fill}SmartRead@{fg text}", and so on). The newly created lister will be in 'source' mode, and the command will be executed @{b}after@{ub} file selection (if any) by the @{" ActPat " LINK U_ActPat} keyword. @{par} @{par}For commands like "@{fg fill}Delete@{fg text}" and "@{fg fill}SmartRead@{fg text}" you will want to select some files first, but for other commands such as "@{fg fill}All@{fg text}" and "@{fg fill}CacheList@{fg text}" there is no need. Like the @{" ActPat " LINK U_ActPat} keyword, @{fg fill}ActCom@{fg text} is entirely @{i}optional @{ui}-- you can open a lister and select some files without having to execute a command. @ENDNODE @NODE U_ActClose "CDOpus - Usage, ActClose" @{par}When CDOpus is in @{" Action-mode " LINK U_Action}, the @{fg fill}ActClose@{fg text} @{b}switch@{ub} causes it to close the new lister automatically once the @{" file selection " LINK U_ActPat} and @{" command " LINK U_ActCom} have completed. @ENDNODE @NODE U_Global "CDOpus - Usage, Global" @{par}By default, environment variables created in @{" SetVar Mode " LINK U_SetVar} are @{b}local@{ub}, meaning they only exist for programs run from the same shell. The @{fg fill}Global@{fg text} @{b}switch@{ub} causes CDOpus to create @{b}global@{ub} variables instead (stored in @{fg shine}ENV:@{fg text} with all versions of AmigaDOS upto 3.1) which are available to all programs running on the machine. @{par} @{par}If you don't understand what all this means, it probably isn't of much use to you anyway. @ENDNODE @NODE Examples "CDOpus - Examples" @{par}See also: @{" Usage " LINK Usage} @{par} @{par}Here are some quick examples of how to use the program: @{par} @{par}@{fg fill}o@{fg text} Shell Alias to CD to the @{fg fill}'source'@{fg text} lister's path. @{par}@{fg fill}>@{fg text} @{bg fill} Alias CDO "DOpus5:c/CDOpus" @{bg back} @{par} @{par}@{fg fill}o@{fg text} Shell Alias to CD to the @{fg fill}'source'@{fg text} lister's path, for a @{b}second@{ub} @{fg fill}DOpus5@{fg text}. @{par}@{fg fill}>@{fg text} @{bg fill} Alias CDO2 "DOpus5:c/CDOpus RexxPort DOPUS.2" @{bg back} @{par} @{par}@{fg fill}o@{fg text} Shell Alias to open a @{b}new@{ub} lister with the same path as the shell. @{par}@{fg fill}>@{fg text} @{bg fill} Alias OCD "DOpus5:c/CDOpus Open" @{bg back} @{par} @{par}@{fg fill}o@{fg text} @{b}As above@{ub}, but make it the @{fg fill}'dest'@{fg text} lister as well. @{par}@{fg fill}>@{fg text} @{bg fill} Alias OCDest "DOpus5:c/CDOpus Open New Dest" @{bg back} @{par} @{par}@{fg fill}o@{fg text} Shell Alias to read the current directory into the @{fg fill}'source'@{fg text} lister. @{par}@{fg fill}>@{fg text} @{bg fill} Alias Source "DOpus5:c/CDOpus Open Source" @{bg back} @{par} @{par}@{fg fill}o@{fg text} DOpus button to open a @{fg fill}'source'@{fg text} lister in @{fg fill}"RAM:Env"@{fg text}, with given @{fg fill}size@{fg text}. @{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back} @{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/CDOpus RexxPort {Qp} Open New Source Dir RAM:Env Pos 11/3/100/50 @{bg back} @{par} @{par}@{fg fill}o@{fg text} Shell Alias to have @{fg fill}DOpus@{fg text} @{b}HexRead #?.exe@{ub} in the @{fg fill}current dir@{fg text}. @{par}@{fg fill}>@{fg text} @{bg fill} Alias HexRead "DOpus5:c/CDOpus Action ActPat #?.exe ActCom HexRead" @{bg back} @{par} @{par}@{fg shine}Hope you get the idea!?@{fg text} @ENDNODE @NODE History "CDOpus - History" @{par}See also: @{" Future " LINK Future} @{par} @{par}@{b}NOTE:@{ub} Version numbering is in the @{fg shine}@{fg fill}.@{fg shine}@{fg text} format. This means @{par} that version @{fg shine}1.10 @{fg text}(one.ten) is @{b}newer@{ub} than version @{fg shine}1.2 @{fg text}(one.two). @{par} @{par}@{u}@{fg shine} v1.1 (Private release) - ??-Aug-1995 @{uu} @{par}@{fg fill}o@{fg text} @{b}First@{ub} release for testing. @{par} @{par}@{u}@{fg shine} v1.2 (Private release) - 16-Aug-1995 @{uu} @{par}@{fg fill}o@{fg text} Reorganised a lot of the code. @{par}@{fg fill}o@{fg text} Added @{" Source " LINK U_SourceDestLock}, @{" Dest " LINK U_SourceDestLock} and, @{" Lock " LINK U_SourceDestLock} @{b}switches@{ub}. @{par} @{par}@{u}@{fg shine} v1.3 (Private release) - 19-Aug-1995 @{uu} @{par}@{fg fill}o@{fg text} More code reorganisation. @{par}@{fg fill}o@{fg text} Removed @{fg fill}"Reqs"@{fg text} switch - @{b}requesters@{ub} are turned on @{u}automatically@{uu} unless @{par} in @{fg fill}CD-mode@{fg text} where error messages go to the @{b}shell@{ub}. @{par}@{fg fill}o@{fg text} Added @{bg fill} ReadSource @{bg back} and, @{bg fill} ReadDest @{bg back} @{b}switches@{ub}. @{par}@{fg fill}o@{fg text} W@{fg fill}r@{fg shine}o@{fg fill}t@{fg text}e @{bg fill}t@{bg shine}h@{bg fill}i@{bg shine}s@{bg back} @{b}A@{ub}@{u}m@{uu}@{b}i@{ub}@{u}g@{uu}@{b}a@{ub}@{u}G@{uu}@{b}u@{ub}@{u}i@{uu}@{b}d@{ub}@{u}e@{uu}. @{par} @{par}@{fg shine}@{u} v1.4 (Private release) - 21-Aug-1995 @{uu} @{par}@{fg fill}o@{fg text} @{b}Fixed@{ub} a few minor mistakes in the AmigaGuide, added a couple more links @{par} and a little more colour in places. Updated the @{" Credits " LINK Credits} node. @{par}@{fg fill}o@{fg text} @{b}Fixed@{ub} something in the way that @{fg fill}ARexx@{fg text} messages are sent to @{fg fill}DOpus5@{fg text}. @{par} (This shouldn't have caused any problems, but it is done properly now). @{par} @{par}@{u}@{fg shine} v1.5 (Private release) - 27-Aug-1995 @{uu} @{par}@{fg fill}o@{fg text} @{b}Added@{ub} my @{b}new@{ub} @{fg fill}email address@{fg text} to the @{" credits " LINK Credits} node. @{par}@{fg fill}o@{fg text} @{b}Added@{ub} an @{fg fill}icon@{fg text} for this 'guide. (@{" Thanks Trevor! " LINK Credits}) @{par}@{fg fill}o@{fg text} @{b}Fixed@{ub} alphabetical-sorting in the @{" credits " LINK Credits} node. (@{" Thanks Trevor! " LINK Credits}) @{par} @{par}@{u}@{fg shine} v1.6 (MWB_DOpus_7.lha release) - 10-Sep-1995 @{uu} @{par}@{fg fill}o@{fg text} @{i}Where useful, @{ui}new listers will open @{b}automatically@{ub} if there isn't a lister @{par} of the required type open already (just like @{fg fill}DOpus5's@{fg text} internal commands). @{par}@{fg fill}o@{fg text} @{b}Added@{ub} @{bg fill} NoNew @{bg back} @{b}switch@{ub} to disable the above feature. @{par}@{fg fill}o@{fg text} Added a new @{" known bug " LINK Future}, which isn't my fault. :) @{par} @{par}@{u}@{fg shine} v1.7 - 6-Jan-1996 @{uu} @{par}@{fg fill}o@{fg text} @{b}Added@{ub} @{bg fill} VarSource @{bg back} and @{bg fill} VarDest @{bg back} commands and accompanying @{" Global " LINK U_Global} switch. @{par}@{fg fill}o@{fg text} @{b}Added@{ub} @{" DoAction " LINK U_Action} command and accompanying switches @{" ActPat " LINK U_ActPat}, @{" ActCom " LINK U_ActCom}, and @{par} @{" ActClose " LINK U_ActClose}. @{" Thanks " LINK Credits} to Dave Clarke for the suggestion. @{par}@{fg fill}o@{fg text} @{b}Rearranged@{ub} the @{" Usage " LINK Usage} section a little, hopefully it's better now. @{par}@{fg fill}o@{fg text} @{b}Removed@{ub} section about possible @{fg fill}enforcer hits@{fg text}, they were nothing to @{par} do with my programs (YIPEE!). @{par}@{fg fill}o@{fg text} @{b}Updated@{ub} @{" Credits " LINK Credits} section. (Most importantly my @{b}new EMail/WWW addresses@{ub}). @{par}@{fg fill}o@{fg text} @{b}Added@{ub} EMail address and WWW URL for @{" Children of the Storm " LINK COTS_Charity}. @{par}@{fg fill}o@{fg text} This should be the last @{fg fill}DOpusFuncs@{fg text} update before @{fg fill}DOpus 5.5@{fg text} is released. @{par}@{fg fill}o@{fg text} Hey! It's my birthday tomorrow!... :-) @{par} @{par}@{u}@{fg shine} v1.8 - 8-Jan-1996 @{uu} @{par}@{fg fill}o@{fg text} Now @{b}requires@{ub} (and checks for) @{fg fill}DOpus v5.5@{fg text} or above. @{par}@{fg fill}o@{fg text} Thanks to @{fg fill}DOpus 5.5@{fg text}, you can now open listers in the @{b}top corner@{ub} of the @{par} screen, and you can also open them @{" under the mouse " LINK U_Pos}. @{par}@{fg fill}o@{fg text} Error routine returns error strings from @{fg fill}DOpus5.5@{fg text} which could help to explain @{par} @{i}why @{ui}something went wrong, not just what went wrong (e.g. "@{i}Could not open @{par} a new lister, DOpus Reason: Insufficient memory@{ui}", instead of just @{par} "@{i}Could not open a new lister@{ui}"). @{par}@{fg fill}o@{fg text} One or two other minor improvements. @{par}@{fg fill}o@{fg text} Debug version no longer included in archive. @{par} @{par}@{u}@{fg shine} v1.9 - 26-Apr-1996 @{uu} @{par}@{fg fill}o@{fg text} Will no longer open @{b}any@{ub} requesters (from Opus or Intuition) when in @{par} @{" CD Mode " LINK U_CD}. All error messages will be diverted to the shell so @{par} that you can run CDOpus in your shell-startup without getting an error @{par} requester because Opus isn't loaded or you don't have a source lister. @{par}@{fg fill}o@{fg text} Note my new @{" webpage URL " LINK Credits}. @{par} @{bg fill}===========================================================================@{bg back} @{par} @{par}@{u}@{fg shine} v2.0 - 11-May-1996 @{uu} @{par}@{fg fill}o@{fg text} The way the program works has been rationalised some what. Hopefully it's @{par} now simpler to use. @{par}@{fg fill}o@{fg text} @{bg fill} DoAction @{bg back} keyword renamed to @{" Action " LINK U_Action}. @{par}@{fg fill}o@{fg text} Much has changed, please read the @{" Usage " LINK Usage} section again. @{par}@{fg fill}o@{fg text} The @{bg fill} Index @{bg back} for this guide is gone. I doubt anyone ever used it for @{par} such a small program. @{par}@{fg fill}o@{fg text} Rewrote most of the AmigaGuide. @Remark VERSION NUMBERS/DATES: VER string and Contents Node. @ENDNODE @NODE Future "CDOpus - Future & Known Bugs" @{par}See also: @{" History " LINK History} @{par} @{" Credits " LINK Credits} @{par} @{par}@{fg shine}@{u} To Do: @{uu} @{par}@{fg fill}o@{fg text} Make the @{" help " LINK U_Help} text pause if the shell window is not tall enough. @{par} I'm too lame to be work out how to do it. @{par}o@{fg shine} Add an option to @{b}automatically load@{ub} @{fg fill}DOpus5@{fg text} if it isn't already loaded. @{par} This should be very easy to do but I wouldn't personally use it, so I'll @{par} only add it if someone asks for it. @{par}@{fg fill}o@{fg text} If you want something, @{" ask " LINK Credits} for it! @{par} @{par}@{fg shine}@{u} Known Bugs: @{uu} @{par}@{fg fill}o@{fg text} There is a bug in the OS3.1 AmigaGuide which can cause extra spaces, @{par} missing spaces, and duplicated words at line-wraps. @{b}This it not my fault!@{ub} @ENDNODE