@DATABASE "DOpusFuncs.guide"
@AUTHOR "Leo Davidson <leo@hampschl.demon.co.uk>"
@(c) "Leo Davidson"
@SMARTWRAP
@WORDWRAP
@$VER: DOpusFuncs.guide 1.4 (10.9.95)
@INDEX Index
@NODE MAIN "DOpusFuncs - Contents"
@Remark This guide was done completely by hand in an ASCII editor.
@{fg shine}
@{par}              DOpusFuncs 1.4 (10-Sep-1995) @{fg fill}-@{fg shine} for Directory Opus 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}                            @{" Debug Version         " LINK DebugVersion}
@{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}                            @{" Index                 " LINK Index}

@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 "DOpusFuncs - 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}There is also now an E-Mail address and WWW page for the charity, but I'm
afraid I don't have the info with me. If you would like to know more about it
or contact any of the people via e-mail instead of snail-mail, please @{" E-Mail " LINK "Credits"} me
and I will get the details.
@{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 "DOpusFuncs - Introduction"

@{par}The purpose behind @{fg fill}DOpusFuncs@{fg text} is to provide you with some features which
are currently @{b}missing@{ub} from @{fg fill}DOpus5@{fg text}.
@{par}
@{par}@{fg fill}DOpusFuncs@{fg text} started as a conversion of the @{fg shine}DirToDest@{fg text}, @{fg shine}ParentToDest@{fg text},
@{fg shine}Same @{fg text}(@{fg shine}Clone@{fg text}), @{fg shine}WinCopy@{fg text}, and @{fg shine}WinSwap @{fg fill}Directory Opus 5@{fg text} scripts. I was annoyed
with how long the scripts took to do their job, so I converted them to
assembler.
@{par}
@{par}At the moment, @{fg fill}DOpusFuncs@{fg text} provides you with these extra commands:
@{par}
@{par}@{fg fill}1)@{fg text} @{b}Read@{ub} the @{b}selected directory@{ub} into an existing or new lister, without
@{par}   having to drag it using the shift key.
@{par}@{fg fill}2)@{fg text} @{b}Read@{ub} a lister's @{b}parent@{ub} directory into an existing or new lister.
@{par}@{fg fill}3)@{fg text} @{b}Copy@{ub} the contents of a lister into an existing or new lister.
@{par}@{fg fill}4)@{fg text} @{b}Swap@{ub} the contents of two listers.
@{par}@{fg fill}5)@{fg text} @{b}Copy@{ub} the @{i}names @{ui}of the @{b}selected entries@{ub} to the @{b}clipboard@{ub}.
@{par}
@{par}@{fg fill}DOpusFuncs@{fg text} can also be used for openning new listers with specified path,
position, size and type, but if you want a program to do this you should
use @{" CDOpus " LINK CDOpus_Intro} instead.

@{par}Read the @{" usage " LINK Usage} node to see exactly what it can do.

@ENDNODE
@NODE CDOpus_Intro "DOpusFuncs - 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 two functions, both of 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}
@{par}@{b}It doesn't end there (!).@{ub} You can also use it as a command to open listers
with a given path, position, and source/dest/locked mode! (I know a couple
of people who have written ARexx scripts to do just this - now you can do
it a little faster @{fg shine};@{fg fill}-@{fg text}).

@ENDNODE
@NODE Requirements "DOpusFuncs - Requirements"

@{par}See also: @{" Known Bugs " LINK Future}
@{par}
@{par}Seeing as I have a low-end machine, this program should run on any type
of @{fg shine}Amiga@{fg text}, provided it has @{fg shine}AmigaOS 2@{fg text} or above.
@{par}
@{par}Of course, you also need @{fg shine}Directory Opus 5@{fg text}.
@{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 "DOpusFuncs - Credits"

@{par}See also: @{" Debug version " LINK DebugVersion}
@{par}
@{par}                                  @{fg shine}@{u}The Author:@{uu}@{fg text}
@{par}                                 @{fg fill}Leo Davidson
@{par}                    @{fg text}leo@hampschl.demon.co.uk @{fg fill}(until Oct'95)
@{par}                 @{fg text}leo.davidson@keble.oxford.ac.uk @{fg fill}(from Oct'95)
@{par}                     @{fg shine}Nudel@{fg fill} in #Amiga on Effnet & Undernet
@{par}
@{par}
@{par}@{fg text}If my EMail address @{b}after Oct'95@{ub} doesn't work, please EMail my friend
Trevor Morris <a3nb@unb.ca> and ask for the correct one.
@{par}
@{par}Please mail me if you find any bugs, or have any ideas for new features. I
am also willing to give out the assembler @{b}source-code@{ub} to almost anyone who
0asks for it.
@{par}
@{par}@{i}I do not have an MMU so @{u}please send@{uu} any and all @{fg fill}Enforcer hits@{fg text}!@{ui}
@{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 Freeman
@{par}                                  Gary Gagnon
@{par}                                  Greg Perry
@{par}                                Jonathan Potter
@{par}                                 Trevor Morris
@{par}
@{par}                          @{fg shine}@{u}Beta testing & Bug reports@{uu}
@{par}                             @{fg shine}(Alphabetical order):@{fg fill}
@REMARK Don't use SortBlock to sort this because of the spaces.
@{par}                                 Trevor Morris
@{par}           Troels Walsted Hansen @{fg text}(1000 thanks for the Enforcer hits)
@{par}
@{par}                    @{fg shine}@{u}Musical Support Used While Programming@{uu}
@{par}                     @{fg shine}(Current Listening Frequency Order):
@{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}        The @{" Index " LINK Index} node was created with @{" AGIX " LINK AGIX} 1.2 by Ralph Seichter
@{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 AGIX "AGIX by Ralph Seichter"

@{par}          @{fg shine}@{u}From: AGIX.doc 1.2 (5.8.94) Copyright © Ralph Seichter@{uu}
@{par}
@{par}@{fg text}PURPOSE:
@{par}
@{par}   Although  AmigaGuide documents may have a node index, only few documents
@{par}make  use of this feature. I suppose that many people are too lazy to build
@{par}an  index  manually (I definitely am), so I thought it would be a good idea
@{par}to have this task done automatically. AGIX scans an AmigaGuide document for
@{par}references  like  \@{"foo" link "bar"} (note that AGIX does not use the node
@{par}definitions), sorts them alphabetically and produces an index file.
@{par}
@{par}   "Haven't I seen something like that before?" you might ask. Well, I have
@{par}seen  one  similar  program  so far, but on my machine it didn't work, so I
@{par}decided  to  try  it myself. The result is short (only 1960 bytes) and uses
@{par}StrnCmp() from locale.library instead of stricmp(), if available, and has a
@{par}very nice sounding name. :)

@ENDNODE
@NODE NewEdit "NewEdit by Uwe Röhm & Paul Huxham"

@{par}NewEdit                                                             NewEdit
@{par}
@{par}   PURPOSE
@{par} To provide aditional functions and operators during string gadget
@{par} editing.
@{par}
@{par}   COPYRIGHT
@{par} The copyright in this package is owned by Paul Huxham © 1995.
@{par} NewEdit 1.9 is based on the original NewEdit by Uwe Röhm.
@{par}
@{par}   DISTRIBUTION
@{par} NewEdit should be distributed at no charge to the end user however
@{par} should a duplication charge be made, it should not exceed the cost of a
@{par} blank 3.5" disk. The NewEdit executable and documentation is public
@{par} domain and no payment is required for its use.
@{par} For commercial applications of NewEdit, contact the author for
@{par} further information concerning distribution.
@{par}
@{par}   CONTENTS
@{par} This package should contain:
@{par} NewEdit - The main program.
@{par} NewEdit.info - The main programs icon.
@{par} NewEdit.doc - The document you are reading now.
@{par}
@{par}   USAGE
@{par} The following key commands are standard functions provided by OS 2.0:
@{par}   CURSOR LEFT         cursor to previous character
@{par}   SHIFT CURSOR LEFT   cursor to start of line
@{par}   CURSOR RIGHT        cursor to next character
@{par}   SHIFT CURSOR RIGHT  cursor to end of line
@{par}   DEL                 delete the character under the cursor
@{par}   SHIFT DEL           delete from the character under the cursor to EOL
@{par}   BACKSPACE           delete the character to the left of the cursor
@{par}   SHIFT BACKSPACE     delete from the character to the left of the cursor
@{par}                       to the start of the line
@{par}   RETURN or ENTER     terminate input and deactivate the gadget
@{par}   RAMIGA Q            restore gadgets contents before alteration
@{par}   RAMIGA X            clear the string gadget
@{par}
@{par} The following key commands are provided by NewEdit 1.9:
@{par}   ALT CURSOR RIGHT    next word
@{par}   ALT CURSOR LEFT     previous word
@{par}   ALT BACKSPACE       delete previous word
@{par}   ALT DEL             delete next word
@{par}   RALT CURSOR UP      go to prev gadget (accepting contents)
@{par}   RALT CURSOR DOWN    go to next gadget (accepting contents)
@{par}   ESC                 leave gadget (accepting contents)
@{par}   RALT C or RAMIGA C  copy gadget contents to clipboard
@{par}   RALT V or RAMIGA V  paste contents of clipboard to gadget
@{par}   RALT I or RAMIGA I  increments a numbered filename by one
@{par}   RALT RSHIFT I or
@{par}   RAMIGA RSHIFT I     decrements a numbered filename by one
@{par}   RALT G or RAMIGA G  toggle the case of indicated character
@{par}   SHIFT RALT G or
@{par}   SHIFT RAMIGA G      toggle the case of characters until EOL or
@{par}                       non alphabetic character is found
@{par}   RALT D or RAMIGA D  Insert the current date
@{par}
@{par} The reason for RALT as well as RAMIGA is that some applications eg ASL
@{par} file requester trap and use the RAMIGA key for other functions. By
@{par} using the RALT key you can still access the functions.
@{par}
@{par} The following parameters can be set either as tooltypes or via command
@{par} line switches when running NewEdit:
@{par}  RALT - If you do not wish to have the RALT functions available (those
@{par}         key commands that can use either RALT or RAMIGA, use this
@{par}         parameter to disable the RALT keys. (Keys like RALT CURSOR LEFT
@{par}         will still work).
@{par}
@{par}  CLIPUNIT - Sets the clipboard unit used to copy to and from.
@{par}
@{par}   COMPLIER
@{par} NewEdit was written and compiled using CED V3.5 and SAS/C 6.55 on
@{par} an Amiga 4000/040. It should perform equally well on a 68000.
@{par} Enforcer was used to detect and correct programming errors.
@{par}
@{par}   BUGS
@{par} The only thing I can find is that in the first string gadget activated
@{par} after NewEdit is installed, the cursor will jump to the right hand end
@{par} of the gadget. I don't know why this happens. This also happened in Uwes
@{par} original version. I don't process any events other than key events so I
@{par} can't see how a mouse click is causing this to happen.
@{par}
@{par} Should you find any bugs, please report them so that they can be fixed.
@{par} Likewise any suggestions for improvment of should be forwarded so that
@{par} they can be addressed.
@{par}
@{par}   HISTORY
@{par} 1.8b Initial release.
@{par} 1.9  Removed locale code and error messages (like: You need KS 2.0).
@{par}      General code cleanup and enhancments.
@{par}      Added paste date.
@{par}      Added decrement a file number.
@{par}      New document format for the instructions.
@{par}
@{par}   THANKYOU
@{par}  Uwe Röhm - For the original version that I have enhanced (butchered??).
@{par}  Steve Quartly - Numerous ideas and long nights playing Deluxe Galaga.
@{par}
@{par}   AUTHOR
@{par} You can contact the author via:
@{par}   Email: paulh@Perth.DIALix.oz.au
@{par} or
@{par}   P.O. Box 875
@{par}   Morley,
@{par}   Perth,
@{par}   Western Australia 6943

@ENDNODE
@NODE Installation "DOpusFuncs - Installation"

@{par}See also: @{" Usage " LINK Usage}
@{par}          @{" Examples " LINK Examples}
@{par}          @{" Debug Version " LINK DebugVersion}
@{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.
@{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 DOpusFuncs +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 DOpusFuncs 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 DOpusFuncs.guide DOpus5:Help/ @{bg back}
@{par}
@{par}@{fg fill}o@{fg text} Read the @{" usage " LINK Usage} and @{" examples " LINK Examples} sections and set up whatever buttons you
@{par}  like.
@{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/DOpusFuncs @{bg back}
@{par}  ...and change all commands to reference @{fg fill}"DOpusFuncs"@{fg text} instead of
@{par}  @{fg fill}"DOpus5:c/DOpusFuncs"@{fg text}.

@ENDNODE
@NODE Usage "DOpusFuncs - Usage"

@{par}See also: @{" Installation " LINK Installation}
@{par}          @{" Examples " LINK Examples}
@{par}
@{par}The @{fg fill}DOpusFuncs@{fg text} command takes the following command-line parameters:
@{par}
@{par}@{fg shine}Mandatory:@{fg text}
@{par} @{" RexxPort     " LINK U_RexxPort}  Specify the @{fg fill}ARexx port@{fg text} to talk with.
@{par}@{fg shine}Action selection:@{fg text}
@{par} @{" ClipEntry    " LINK U_ClipEntry}  @{b}Copy@{ub} @{fg fill}name@{fg text} of @{b}selected entries@{ub} (etc.) -> @{fg fill}clipboard@{fg text}.
@{par} @{" DirToDest    " LINK U_DirToDest}  @{u}Switch:@{uu} @{fg fill}'Source'@{fg text}-@{b}selected dir@{ub} -> @{fg fill}'dest'@{fg text} lister.
@{par} @{" ParentToDest " LINK U_ParentToDest}  @{u}Switch:@{uu} @{fg fill}'Source'@{fg text}-@{b}parent dir@{ub} -> @{fg fill}'dest'@{fg text} lister.
@{par} @{" WinCopy      " LINK U_WinCopy}  @{u}Switch:@{uu} @{b}Copy@{ub} @{fg fill}'source'@{fg text} lister -> @{fg fill}'dest'@{fg text} lister.
@{par} @{" WinSwap      " LINK U_WinSwap}  @{u}Switch:@{uu} @{b}Swap@{ub} @{fg fill}'source'@{fg text} and @{fg fill}'dest'@{fg text} listers.
@{par}@{fg shine}Lister control:@{fg text}
@{par} @{" NewDest      " LINK U_NewDest}  @{u}Switch:@{uu} Open a @{b}new@{ub} @{fg fill}'dest'@{fg text} lister before <@{bg fill}action@{bg back}>.
@{par} @{" DestDir      " LINK U_DestDir}  Specify the new @{fg fill}'dest'@{fg text} lister's @{b}path@{ub}.
@{par} @{" DestPos      " LINK U_DestPos}  Specify the new @{fg fill}'dest'@{fg text} lister's @{b}dimensions@{ub}.
@{par} @{" DestLock     " LINK U_DestLock}  @{u}Switch:@{uu} Make the new lister '@{b}locked@{ub}-dest'.
@{par}
@{par} @{" NewSource    " LINK U_NewSource}  @{u}Switch:@{uu} Open a @{b}new@{ub} @{fg fill}'source'@{fg text} lister before <@{bg fill}action@{bg back}>.
@{par} @{" SourceDir    " LINK U_SourceDir}  Specify the new @{fg fill}'source'@{fg text} lister's @{b}path@{ub}.
@{par} @{" SourcePos    " LINK U_SourcePos}  Specify the new @{fg fill}'source'@{fg text} lister's @{b}dimensions@{ub}.
@{par} @{" SourceLock   " LINK U_SourceLock}  @{u}Switch:@{uu} Make the new lister '@{b}locked@{ub}-source'.
@{par}
@{par} @{" NoFront      " LINK U_NoFront}  @{u}Switch:@{uu} @{b}Don't@{ub} bring the @{b}screen to front@{ub} for new listers.
@{par} @{" NoNew        " LINK U_NoNew}  @{u}Switch:@{uu} Disable automatic openning of new listers.
@{par}
@{par}@{fg shine}@{u}ReadArgs() Template:@{uu}@{fg text}
@{par}
@{par}RP=REXXPORT/A, CLIPENTRY/K/M, DIRTODEST/S, PARENTTODEST/S, WINCOPY/S,
WINSWAP/S, NEWSOURCE/S, SOURCEDIR/K, SOURCEPOS/K, SOURCELOCK/S,
NEW=NEWDEST/S, DIR=DESTDIR/K, POS=DESTPOS/K, LOCK=DESTLOCK/S, NOFRONT/S,
NONEW/S

@ENDNODE
@NODE U_RexxPort "DOpusFuncs - Usage, RexxPort"

@{par}See also: @{" Examples " LINK Examples}
@{par}
@{par}Alias: @{fg fill}"RP"@{fg text}
@{par}
@REMARK
@REMARK The "@{fg fill} <text> @{fg fill}" is required due to an AmigaGuide bug.
@REMARK
@{par}@{fg fill}RexxPort@{fg text} is a @{b}mandatory keyword@{ub} with which you specify the name of @{fg fill}DOpus5's
ARexx @{fg fill}port@{fg text}. This should @{b}always@{ub} be done using the @{fg shine}{Qp}@{fg text} function within
the @{fg fill}DOpus5 command-editor@{fg text}, as shown in all of the @{" examples " LINK Examples}.
@{par}
@{par}@{b}NOTE:@{ub} Port names are @{u}case-sensitive@{uu}.

@ENDNODE
@NODE U_ClipEntry "DOpusFuncs - Usage, ClipEntry"
@{par}See also: @{" Examples " LINK Examples}
@{par}          @{" DirToDest " LINK U_DirToDest}
@{par}          @{" ParentToDest " LINK U_ParentToDest}
@{par}          @{" WinCopy " LINK U_WinCopy}
@{par}          @{" WinSwap " LINK U_WinSwap}
@{par}>>>>>>>>> @{" Known Bugs " LINK Future}
@{par}
@{par}The @{fg fill}ClipEntry@{fg text} @{b}keyword@{ub} takes @{b}all@{ub} words from the command-line which are not
part of other arguments and puts them in the @{fg fill}clipboard@{fg text} as @{b}one@{ub} string. When
used on a @{fg fill}DOpus5 button@{fg text} with the @{fg shine}{}@{fg text} commands you can do useful things such
as @{b}copy@{ub} the @{b}names@{ub} of @{b}all selected files@{ub} to the @{fg fill}clipboard@{fg text}.
@{par}
@{par}@{fg shine}Quotes@{fg text} will be placed around any sub-strings with @{b}spaces@{ub} in, provided you
have left the @{fg fill}"No file quote"@{fg text} switch @{b}off@{ub}.
@{par}
@{par}Have a look at the @{" examples " LINK Examples} section to see some of the things it can
do.

@ENDNODE
@NODE U_DirToDest "DOpusFuncs - Usage, DirToDest"

@{par}See also: @{" Examples " LINK Examples}
@{par}          @{" ClipEntry " LINK U_ClipEntry}
@{par}          @{" ParentToDest " LINK U_ParentToDest}
@{par}          @{" WinCopy " LINK U_WinCopy}
@{par}          @{" WinSwap " LINK U_WinSwap}
@{par}          @{" NewSource " LINK U_NewSource}
@{par}          @{" NewDest " LINK U_NewDest}
@{par}          @{" NoNew " LINK U_NoNew}
@{par}
@{par}The @{fg fill}DirToDest@{fg text} @{b}switch@{ub} causes whatever @{b}directory@{ub} is @{b}selected@{ub} in the @{fg fill}'source'@{fg text} 
lister to be read into the @{fg fill}'dest'@{fg text} lister. Currently, under @{fg fill}DOpus 5.11@{fg text}, the
only way to do this is to @{fg shine}drag'n'drop@{fg text} the directory while holding down the
@{fg shine}shift-key@{fg text}, @{i}and believe me, it's a pain in the arse. @{ui}@{bg shine}:-/@{bg back}
@{par}
@{par}By default, if there isn't a @{fg fill}'destination'@{fg text} lister, a @{b}new@{ub} lister will be
openned for you. You can turn this off with the @{" NoNew " LINK U_NoNew} @{b}switch@{ub}, while you
can @{b}force@{ub} a @{b}new@{ub} @{fg fill}'destination'@{fg text} lister to be openned (even if there already
is one) with the @{" NewDest " LINK U_NewDest} @{b}switch@{ub}.

@ENDNODE
@NODE U_ParentToDest "DOpusFuncs - Usage, ParentToDest"

@{par}See also: @{" Examples " LINK Examples}
@{par}          @{" ClipEntry " LINK U_ClipEntry}
@{par}          @{" DirToDest " LINK U_DirToDest}
@{par}          @{" WinCopy " LINK U_WinCopy}
@{par}          @{" WinSwap " LINK U_WinSwap}
@{par}          @{" NewSource " LINK U_NewSource}
@{par}          @{" NewDest " LINK U_NewDest}
@{par}          @{" NoNew " LINK U_NoNew}
@{par}
@{par}The @{fg fill}ParentToDest@{fg text} @{b}switch@{ub} causes the @{b}parent directory@{ub} of the @{fg fill}'source'@{fg text} lister
to be read into the @{fg fill}'dest'@{fg text} lister.
@{par}
@{par}@{b}NOTE:@{ub} If the @{fg fill}'source'@{fg text} lister is at the @{fg shine}root of a volume, @{fg fill}ParentToDest@{fg text} will
@{par}      cause a @{fg shine}DeviceList@{fg text} to appear in the @{fg fill}'dest'@{fg text} lister.
@{par}
@{par}By default, if there isn't a @{fg fill}'destination'@{fg text} lister, a @{b}new@{ub} lister will be
openned for you. You can turn this off with the @{" NoNew " LINK U_NoNew} @{b}switch@{ub}, while you
can @{b}force@{ub} a @{b}new@{ub} @{fg fill}'destination'@{fg text} lister to be openned (even if there already
is one) with the @{" NewDest " LINK U_NewDest} @{b}switch@{ub}.

@ENDNODE
@NODE U_WinCopy "DOpusFuncs - Usage, WinCopy"

@{par}See also: @{" Examples " LINK Examples}
@{par}          @{" ClipEntry " LINK U_ClipEntry}
@{par}          @{" DirToDest " LINK U_DirToDest}
@{par}          @{" ParentToDest " LINK U_ParentToDest}
@{par}          @{" WinSwap " LINK U_WinSwap}
@{par}          @{" NewSource " LINK U_NewSource}
@{par}          @{" NewDest " LINK U_NewDest}
@{par}          @{" NoNew " LINK U_NoNew}
@{par}
@{par}The @{fg fill}WinCopy@{fg text} @{b}switch@{ub} causes the @{fg fill}'dest'@{fg text} lister to read in the same path as the
@{fg fill}'source'@{fg text} lister. That is, it @{b}copies@{ub} the contents of the @{fg fill}'source'@{fg text} lister to
the @{fg fill}'dest'@{fg text} one, like the old command which was built-into @{fg fill}DOpus4@{fg text}.
@{par}
@{par}By default, if there isn't a @{fg fill}'destination'@{fg text} lister, a @{b}new@{ub} lister will be
openned for you. You can turn this off with the @{" NoNew " LINK U_NoNew} @{b}switch@{ub}, while you
can @{b}force@{ub} a @{b}new@{ub} @{fg fill}'destination'@{fg text} lister to be openned (even if there already
is one) with the @{" NewDest " LINK U_NewDest} @{b}switch@{ub}.

@ENDNODE
@NODE U_WinSwap "DOpusFuncs - Usage, WinSwap"

@{par}See also: @{" Examples " LINK Examples}
@{par}          @{" ClipEntry " LINK U_ClipEntry}
@{par}          @{" DirToDest " LINK U_DirToDest}
@{par}          @{" ParentToDest " LINK U_ParentToDest}
@{par}          @{" WinCopy " LINK U_WinCopy}
@{par}          @{" NewSource " LINK U_NewSource}
@{par}          @{" NewDest " LINK U_NewDest}
@{par}
@{par}The @{fg fill}WinSwap@{fg text} @{b}switch@{ub} causes the @{fg fill}'source'@{fg text} and @{fg fill}'dest'@{fg text} listers to @{b}swap@{ub} around.
In other words, the @{fg fill}'source'@{fg text} lister displays the path previously in the
@{fg fill}'dest'@{fg text} lister, and vice versa, like the old command which was built-into
@{fg fill}DOpus4@{fg text}.

@ENDNODE
@NODE U_NewDest "DOpusFuncs - Usage, NewDest"

@{par}See also: @{" Examples " LINK Examples}
@{par}          @{" DestDir " LINK U_DestDir}
@{par}          @{" DestPos " LINK U_DestPos}
@{par}          @{" DestLock " LINK U_DestLock}
@{par}          @{" NoFront " LINK U_NoFront}
@{par}          @{" DirToDest " LINK U_DirToDest}
@{par}          @{" ParentToDest " LINK U_ParentToDest}
@{par}          @{" WinCopy " LINK U_WinCopy}
@{par}          @{" WinSwap " LINK U_WinSwap}
@{par}          @{" NewSource " LINK U_NewSource}
@{par}
@{par}Alias: @{fg fill}"New"@{fg text}
@{par}
@{par}The @{fg fill}NewDest@{fg text} @{b}switch@{ub} causes a @{b}new@{ub} @{fg fill}'dest'@{fg text} lister to be openned before
whatever selected @{bg fill}action@{bg back}, if any, takes place.
@{par}
@{par}When used in combination with the @{bg fill}action@{bg back}@{fg fill}-selection @{b}switches@{ub}@{fg text}, @{fg fill}NewDest@{fg text} can
do useful things such as open a @{b}new@{ub} lister and then read the @{b}parent@{ub} of
the @{fg fill}'source'@{fg text} lister into it, without altering the @{i}original @{ui}@{fg fill}'dest'@{fg text} lister.
@{par}
@{par}There are a couple of @{" examples " LINK Examples} of ways in which you can use this @{b}switch@{ub},
although I'm not going to list @{i}all @{ui}of them.
@{par}
@{par}Certain attributes of the @{b}new@{ub} @{fg fill}'dest'@{fg text} lister can be defined by
using the @{" DestDir " LINK U_DestDir}, @{" DestPos " LINK U_DestPos}, and @{" DestLock " LINK U_DestLock} @{b}keywords@{ub} and @{b}switch@{ub}.

@ENDNODE
@NODE U_DestDir "DOpusFuncs - Usage, DestDir"

@{par}See also: @{" NewDest " LINK U_NewDest}
@{par}          @{" DestPos " LINK U_DestPos}
@{par}          @{" DestLock " LINK U_DestLock}
@{par}          @{" SourceDir " LINK U_SourceDir}
@{par}          @{" SourcePos " LINK U_SourcePos}
@{par}          @{" SourceLock " LINK U_SourceLock}
@{par}
@{par}Alias: @{fg fill}"Dir"@{fg text}
@{par}
@{par}The @{fg fill}DestDir@{fg text} @{b}keyword@{ub} lets you define what @{b}path@{ub} the @{b}new@{ub} @{fg fill}'dest'@{fg text} lister,
created with the @{" NewDest " LINK U_NewDest} @{b}switch@{ub}, will take. The @{b}keyword@{ub} is @{b}optional@{ub},
and if you don't give it, the @{b}new@{ub} lister will have an @{b}empty path@{ub} which
@{i}may @{ui}result in a @{fg shine}DeviceList@{fg text}, depending on your @{fg fill}DOpus5 environment@{fg text}.
@{par}
@{par}The only real use I can see for this @{b}keyword@{ub} is for openning a @{b}new@{ub} @{fg fill}'dest'@{fg text} 
lister pointing to a @{b}path@{ub} you want to use and then @{" WinSwapping " LINK U_WinSwap} so
that your @{fg fill}'source'@{fg text} lister reads the @{b}new@{ub} path and the previous contents of
the @{fg fill}'source'@{fg text} lister are put aside.

@ENDNODE
@NODE U_DestPos "DOpusFuncs - Usage, DestPos"

@{par}See also: @{" NewDest " LINK U_NewDest}
@{par}          @{" DestDir " LINK U_DestDir}
@{par}          @{" DestLock " LINK U_DestLock}
@{par}          @{" SourceDir " LINK U_SourceDir}
@{par}          @{" SourcePos " LINK U_SourcePos}
@{par}          @{" SourceLock " LINK U_SourceLock}
@{par}
@{par}Alias: @{fg fill}"Pos"@{fg text}
@{par}
@{par}By default, new listers created with the @{" NewDest " LINK U_NewDest} command open under
your mouse-pointer with either the size you set in your @{fg fill}environment @{fg text}file
(DOpus 5.11 and above only), or the size defined by the path's @{fg fill}icon@{fg text}, if it
has one. The @{fg fill}DestPos@{fg text} @{b}keyword@{ub} can be used to set a different size and
position for the lister.
@{par}
@{par}The format is @{fg fill}<x-pos>@{fg text}/@{fg fill}<y-pos>@{fg text}/@{fg fill}<width>@{fg text}/@{fg fill}<height>@{fg text}, e.g. 50/10/100/200
@{par}
@{par}@{b}NOTE: @{ub}Specifying 0/0/@{fg fill}<w>@{fg text}/@{fg fill}<h>@{fg text} will make the lister open under the mouse in
@{par}      the current version of @{fg fill}Directory Opus@{fg text} (5.11). This means that it is
@{par}      not possible to open a lister in the top corner of the screen. @{bg shine}:-(@{bg back}

@ENDNODE
@NODE U_DestLock "DOpusFuncs - Usage, DestLock"

@{par}See also: @{" NewDest " LINK U_NewDest}
@{par}          @{" DestDir " LINK U_DestDir}
@{par}          @{" DestPos " LINK U_DestPos}
@{par}          @{" SourceDir " LINK U_SourceDir}
@{par}          @{" SourcePos " LINK U_SourcePos}
@{par}          @{" SourceLock " LINK U_SourceLock}
@{par}
@{par}Alias: @{fg fill}"Lock"@{fg text}
@{par}
@{par}The @{fg fill}DestLock@{fg text} @{b}switch@{ub} causes @{b}new@{ub} @{fg fill}'dest'@{fg text} listers openned with the @{" NewDest " LINK U_NewDest} 
@{b}switch@{ub} to open in @{fg fill}'locked-dest'@{fg text} mode.

@ENDNODE
@NODE U_NewSource "DOpusFuncs - Usage, NewSource"

@{par}See also: @{" Examples " LINK Examples}
@{par}          @{" SourceDir " LINK U_SourceDir}
@{par}          @{" SourcePos " LINK U_SourcePos}
@{par}          @{" SourceLock " LINK U_SourceLock}
@{par}          @{" NoFront " LINK U_NoFront}
@{par}          @{" DirToDest " LINK U_DirToDest}
@{par}          @{" ParentToDest " LINK U_ParentToDest}
@{par}          @{" WinCopy " LINK U_WinCopy}
@{par}          @{" WinSwap " LINK U_WinSwap}
@{par}          @{" NewDest " LINK U_NewDest}
@{par}
@{par}The @{fg fill}NewSource@{fg text} @{b}switch@{ub} causes a @{b}new@{ub} @{fg fill}'source'@{fg text} lister to be openned before
whatever selected @{bg fill}action@{bg back}, if any, takes place.
@{par}
@{par}Certain attributes of the @{b}new@{ub} @{fg fill}'source'@{fg text} lister can be defined by
using the @{" SourceDir " LINK U_SourceDir}, @{" SourcePos " LINK U_SourcePos}, and @{" SourceLock " LINK U_SourceLock} @{b}keywords@{ub} and @{b}switch@{ub}.

@ENDNODE
@NODE U_SourceDir "DOpusFuncs - Usage, SourceDir"

@{par}See also: @{" NewSource " LINK U_NewSource}
@{par}          @{" SourcePos " LINK U_SourcePos}
@{par}          @{" SourceLock " LINK U_SourceLock}
@{par}          @{" DestDir " LINK U_DestDir}
@{par}          @{" DestPos " LINK U_DestPos}
@{par}          @{" DestLock " LINK U_DestLock}
@{par}
@{par}The @{fg fill}SourceDir@{fg text} @{b}keyword@{ub} lets you define what @{b}path@{ub} the @{b}new@{ub} @{fg fill}'source'@{fg text} lister,
created with the @{" NewSource " LINK U_NewSource} @{b}switch@{ub}, will take. The @{b}keyword@{ub} is @{b}optional@{ub},
and if you don't give it, the @{b}new@{ub} lister will have an @{b}empty path@{ub} which
@{i}may @{ui}result in a @{fg shine}DeviceList@{fg text}, depending on your @{fg fill}DOpus5 environment@{fg text}.

@ENDNODE
@NODE U_SourcePos "DOpusFuncs - Usage, SourcePos"

@{par}See also: @{" NewSource " LINK U_NewSource}
@{par}          @{" SourceDir " LINK U_SourceDir}
@{par}          @{" SourceLock " LINK U_SourceLock}
@{par}          @{" DestDir " LINK U_DestDir}
@{par}          @{" DestPos " LINK U_DestPos}
@{par}          @{" DestLock " LINK U_DestLock}
@{par}
@{par}By default, new listers created with the @{" NewSource " LINK U_NewDest} command open under
your mouse-pointer with either the size you set in your @{fg fill}environment @{fg text}file
(DOpus 5.11 and above only), or the size defined by the path's @{fg fill}icon@{fg text}, if it
has one. The @{fg fill}SourcePos@{fg text} @{b}keyword@{ub} can be used to set a different size and
position for the lister.
@{par}
@{par}The format is @{fg fill}<x-pos>@{fg text}/@{fg fill}<y-pos>@{fg text}/@{fg fill}<width>@{fg text}/@{fg fill}<height>@{fg text}, e.g. 50/10/100/200
@{par}
@{par}@{b}NOTE: @{ub}Specifying 0/0/@{fg fill}<w>@{fg text}/@{fg fill}<h>@{fg text} will make the lister open under the mouse in
@{par}      the current version of @{fg fill}Directory Opus@{fg text} (5.11). This means that it is
@{par}      not possible to open a lister in the top corner of the screen. @{bg shine}:-(@{bg back}

@ENDNODE
@NODE U_SourceLock "DOpusFuncs - Usage, SourceLock"

@{par}See also: @{" NewSource " LINK U_NewSource}
@{par}          @{" SourceDir " LINK U_SourceDir}
@{par}          @{" SourcePos " LINK U_SourcePos}
@{par}          @{" DestDir " LINK U_DestDir}
@{par}          @{" DestPos " LINK U_DestPos}
@{par}          @{" DestLock " LINK U_DestLock}
@{par}
@{par}The @{fg fill}SourceLock@{fg text} @{b}switch@{ub} causes @{b}new@{ub} @{fg fill}'source'@{fg text} listers openned with the
@{" NewSource " LINK U_NewSource} @{b}switch@{ub} to open in @{fg fill}'locked-source'@{fg text} mode.

@ENDNODE
@NODE U_NoFront "DOpusFuncs - Usage, NoFront"

@{par}See also: @{" NewDest " LINK U_NewDest}
@{par}          @{" NewSource " LINK U_NewSource}
@{par}
@{par}By default, when @{" NewDest " LINK U_NewDest} and @{" NewSource " LINK U_NewSource} open a @{b}new@{ub} lister the @{fg fill}DOpus
screen@{fg text} will be popped to the @{b}front@{ub} as you probably want to see and use your
newly created lister. If you specify the @{fg fill}NoFront@{fg text} @{b}switch@{ub} on the command-line
the screens are left alone.

@ENDNODE
@NODE U_NoNew "DOpusFuncs - Usage, NoNew"

@{par}See also: @{" DirToDest " LINK U_DirToDest}
@{par}          @{" ParentToDest " LINK U_ParentToDest}
@{par}          @{" WinCopy " LINK U_WinCopy}
@{par}
@{par}By default, when @{" DirToDest " LINK U_DirToDest}, @{" ParentToDest " LINK U_ParentToDest}, or @{" WinCopy " LINK U_WinCopy}, looks for a
@{fg fill}'destination'@{fg text} lister and one doesn't exist, a @{b}new@{ub} @{fg fill}'destination'@{fg text} lister
is @{i}automatically openned.@{ui} This behaviour is similar to the internal
@{fg fill}DOpus@{fg text} commands and can be very useful - however, there may be times when
it isn't desireable. If you use the @{fg fill}NoNew@{fg text} @{b}switch@{ub} you'll get an @{fg fill}error-
requester@{fg text} instead of a new lister.

@ENDNODE
@NODE Examples "DOpusFuncs - 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} For a button which @{b}swaps@{ub} the @{fg fill}'source'@{fg text} and @{fg fill}'dest'@{fg text} listers:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} WinSwap @{bg back}
@{par}
@{par}@{fg fill}o@{fg text} For a button which @{b}copies@{ub} the @{fg fill}'source'@{fg text} lister to the @{fg fill}'dest'@{fg text} one:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} WinCopy @{bg back}
@{par}
@{par}@{fg fill}o@{fg text} For a button which opens a @{b}clone@{ub} of the @{fg fill}'source'@{fg text} lister:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} WinCopy NewDest @{bg back}
@{par}
@{par}@{fg fill}o@{fg text} For a button which reads the @{b}directory selected@{ub} in the @{fg fill}'source'@{fg text} lister
@{par}  into the @{fg fill}'dest'@{fg text} lister:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} DirToDest @{bg back}
@{par}
@{par}@{fg fill}o@{fg text} For a button which reads the @{b}parent@{ub} of the @{fg fill}'source'@{fg text} lister into a new
@{par}  lister:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} ParentToDest NewDest @{bg back}
@{par}
@{par}@{fg fill}o@{fg text} For a button which @{b}copies@{ub} the @{b}names@{ub} of @{b}all selected entries@{ub} in the
@{par}  @{fg fill}'source'@{fg text} lister to the @{fg fill}clipboard@{fg text}:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} ClipEntry {O} @{bg back}
@{par}
@{par}@{fg fill}o@{fg text} For a button which does the @{i}same as above @{ui}but includes the @{b}full path@{ub} of
@{par}  all the files:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} ClipEntry {F} @{bg back}
@{par}
@{par}@{fg fill}o@{fg text} For a button which @{b}copies@{ub} the @{b}name@{ub} of the @{b}first selected entry@{ub}:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} ClipEntry {o} @{bg back}
@{par}
@{par}@{fg shine}-@{fg text} If you put one of the three examples above in one of the @{b}left-
@{par}  mousebutton@{ub} functions of a @{b}button bank@{ub} you are able to @{fg shine}drag@{fg text} files and
@{par}  icons from listers and @{fg shine}drop@{fg text} them on the button to have their names put
@{par}  in the clipboard (@{i}of course, @{ui}you can still select-n-click, too).
@{par}
@{par}@{fg fill}o@{fg text} For a button which @{b}copies@{ub} the @{b}path@{ub} of the @{fg fill}'source'@{fg text} lister to the
@{par}  @{fg fill}clipboard@{fg text}:
@{par}@{fg fill}>@{fg text} @{bg fill} AmigaDOS @{bg back}
@{par}@{fg fill}>@{fg text} @{bg fill} DOpus5:c/DOpusFuncs {Qp} ClipEntry {s} @{bg back}
@{par}
@{par}@{fg shine}- @{fg text}I hope you get the idea!? @{fg text}Obviously there are many other combinations.
@{par}

@ENDNODE
@NODE DebugVersion "DOpusFuncs - Debug Version"

@{par}As well as the main @{fg fill}"DOpusFuncs"@{fg text} executable file, you should also find a
file called @{fg fill}"DOpusFuncs_DEBUG"@{fg text}. The two programs are identical apart from:
@{par}
@{par}@{fg fill}o@{fg text} The @{b}debug@{ub} version contains all the @{fg fill}debug labels@{fg text} and @{fg fill}headers@{fg text}.
@{par}@{fg fill}o@{fg text} The @{b}debug@{ub} version outputs some extra information while it is running.
@{par}  (Most of the time it just reports the commands sent to the @{fg fill}DOpus ARexx
@{par}  port @{fg text}and what the results are).
@{par}
@{par}If you have any problems getting things to work, you should try running
the @{b}debug@{ub} version and see if you can see what's going on. If there appears
to be a @{b}bug@{ub} in the program, @{" reporting " LINK Credits} what the @{b}debug@{ub} version outputs could
help me a great deal in working out what is going wrong.

@ENDNODE
@NODE History "DOpusFuncs - History"

@{par}See also: @{" Future " LINK Future}
@{par}
@{par}@{b}NOTE:@{ub} Versions numbering is in the @{fg shine}<version>@{fg fill}.@{fg shine}<revision>@{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) - 19-Aug-1995 @{uu}
@{par}@{fg fill}o@{fg text} @{b}First@{ub} release for testing.
@{par}
@{par}@{u}@{fg shine} v1.2 (Private release) - 21-Aug-1995 @{uu}
@{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}@{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}@{fg fill}o@{fg text} @{b}Removed@{ub} the @{fg fill}NoReq@{fg text} @{b}switch@{ub} because it was of very little use.
@{par}@{fg fill}o@{fg text} @{b}Changed@{ub} the @{fg shine}DeviceList@{fg text} routine to wait for the lister to finish the
@{par}  @{fg shine}DevieList@{fg text} before restoring the orginal @{fg fill}'source'@{fg text} lister. Previously this
@{par}  could happen too quickly and cause the @{fg shine}DeviceList@{fg text} to appear in the
@{par}  wrong lister.
@{par}
@{par}@{u}@{fg shine} v1.3 (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} new @{" ClipEntry " LINK U_ClipEntry} @{b}switch@{ub} for the @{fg shine}new function@{fg text}. (@{" Thanks Trevor! " LINK Credits})
@{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}@{fg fill}o@{fg text} @{b}Fixed@{ub} an extra comma (,) in the ReadArgs() template.
@{par}
@{par}@{u}@{fg shine} v1.4 (MWB_DOpus_7.lha release) - 10-Sep-1995 @{uu}
@{par}@{fg fill}o@{fg text} @{b}Changed@{ub} @{" ClipEntry " LINK U_ClipEntry}. (Too detailed to list here).
@{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} @{" NoNew " LINK U_NoNew} @{b}switch@{ub} to disable the above feature.
@{par}@{fg fill}o@{fg text} @{b}Fixed@{ub} some error requesters which were using @{fg fill}EasyRequestArgs()@{fg text} instead
@{par}  of @{fg fill}"dopus request"@{fg text}.
@{par}@{fg fill}o@{fg text} @{b}Added@{ub} two new @{" known bugs " LINK Future}, neither of which are my fault. :)
@{par}@{fg fill}o@{fg text} @{b}Fixed@{ub} a few node titles which had @{fg fill}"CDOpus"@{fg text} in them.
@{par}@{fg fill}o@{fg text} @{b}Updated@{ub} the @{" NewEdit " LINK NewEdit} node.

@Remark VERSION NUMBERS/DATES: VER string and Contents Node.
@Remark WHEN ADDING NEW NODES, DON'T FORGET TO UPDATE THE INDEX.

@ENDNODE
@NODE Future "DOpusFuncs - 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} Turn it into a propper @{fg shine}DOpus5 module@{fg text}, turning everything into @{b}internal@{ub} 
@{par}  @{fg fill}'Commands'@{fg text}. (If I can @{b}bribe@{ub} @{fg fill}Jon@{fg text} enough to let me in on the secret!)
@{par}@{fg fill}o@{fg text} Add the ability to @{fg fill}clone@{fg text} @{b}multiple@{ub} source listers. (Does anyone actually
@{par}  want this? I won't add it if noone asks as it would be a pain to do).
@{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} Two @{fg fill}Enforcer hits@{fg text} have been @{" reported " LINK Credits} in @{fg shine}RexxSend@{fg text} which shares many of
@{par}  its routines with this program.
@{par}@{fg fill}o@{fg text} Due to what appears to be a problem in the @{fg fill}"lister copy"@{fg text} command, listers
@{par}  which have been @{b}copied@{ub} or @{b}swapped@{ub} @{i}may @{ui}revert back to their previous paths
@{par}  when @{b}iconified@{ub}.
@{par}@{fg fill}o@{fg text} Under @{fg fill}Directory Opus 5.11@{fg text} it is not possible to open new listers in the
@{par}  top-right corner, because the coordinates @{fg shine}0/0@{fg text} make the lister open under
@{par}  the mouse pointer.
@{par}@{fg fill}o@{fg text} There is a bug in the @{fg fill}OS3.1 AmigaGuide@{fg text} which can cause extra spaces,
@{par}  missing spaces, and duplicated words at @{fg fill}line-wraps@{fg text}. @{b}This it not my fault!@{ub}
@{par}@{fg fill}o@{fg text} The @{fg fill}OS3.1 Autodocs@{fg text} state that there are some @{b}bugs@{ub} in the @{fg fill}OS2 version@{fg text} of
@{par}  @{fg fill}iffparse.library@{fg text}. If @{" ClipEntry " LINK U_ClipEntry} appears to go bananas and you're using
@{par}  @{fg fill}OS2@{fg text}, it @{i}might @{ui}not be my fault. @{bg shine}:-)@{bg back}

@ENDNODE
@NODE Index "DOpusFuncs - Index"

@{par} @{"AGIX" LINK AGIX}
@{par} @{"ask" LINK Credits}
@{par}
@{par} @{"CDOpus" LINK CDOpus_Intro}
@{par} @{"CheckGuide" LINK CheckGuide}
@{par} @{"Children of the Storm" LINK COTS_Charity}
@{par} @{"ClipEntry" LINK U_ClipEntry}
@{par} @{"Credits" LINK Credits}
@{par}
@{par} @{"Debug Version" LINK DebugVersion}
@{par} @{"DestDir" LINK U_DestDir}
@{par} @{"DestLock" LINK U_DestLock}
@{par} @{"DestPos" LINK U_DestPos}
@{par} @{"DirToDest" LINK U_DirToDest}
@{par}
@{par} @{"E-Mail" LINK "Credits"}
@{par} @{"Examples" LINK Examples}
@{par}
@{par} @{"Future & Known Bugs" LINK Future}
@{par} @{"Future" LINK Future}
@{par}
@{par} @{"History" LINK History}
@{par}
@{par} @{"I" LINK Credits}
@{par} @{"Index" LINK Index}
@{par} @{"Installation" LINK Installation}
@{par} @{"Introduction" LINK Intro}
@{par}
@{par} @{"NewDest" LINK U_NewDest}
@{par} @{"NewEdit" LINK NewEdit}
@{par} @{"NewSource" LINK U_NewDest}
@{par} @{"NewSource" LINK U_NewSource}
@{par} @{"NoFront" LINK U_NoFront}
@{par} @{"NoNew" LINK U_NoNew}
@{par}
@{par} @{"ParentToDest" LINK U_ParentToDest}
@{par}
@{par} @{"reported" LINK Credits}
@{par} @{"reporting" LINK Credits}
@{par} @{"RexxPort" LINK U_RexxPort}
@{par}
@{par} @{"SourceDir" LINK U_SourceDir}
@{par} @{"SourceLock" LINK U_SourceLock}
@{par} @{"SourcePos" LINK U_SourcePos}
@{par} @{"System Requirements" LINK Requirements}
@{par}
@{par} @{"Usage" LINK Usage}
@{par}
@{par} @{"WinCopy" LINK U_WinCopy}
@{par} @{"WinSwap" LINK U_WinSwap}
@{par} @{"WinSwapping" LINK U_WinSwap}

@ENDNODE
