@database "Super-Select_DOCS" @REMARK History at the end. @REMARK .----------------------------------------------------------------. @REMARK | Super-Select, HyperText docs written by P0T-NOoDLE of ANTHROX. | @REMARK `----------------------------------------------------------------' @REMARK You need Multiview, AmigaGuide, or some other .Guide viewer. @REMARK Don't be a fucking loser and read this with a standard ASCII viewer!! @REMARK I have not included a non-Guide doc file to make you go and get @REAMRK AmigaGuide, coz it IS suck a cool program. @REMARK $VER: Guide for Super-Select v1.00 (04-Jan-95) @NODE MAIN "Super-Select: Contents." .--------------------------------. .----------' Super-Select v1.00 [RELEASE 1] `---------. | Written by P0T-NOoDLE of ANTHR0X, (C)1995 Gods'Gift. | `------------------------------------------------------' RELEASED ..::::::. `-. For AmigaDOS v2.1 and above. .-' .::::.:. 04-Jan-95 :.:::::::. `------------------------------' .:::::::: 100% Assembler Code. @{" DONATE: Children of the Storm " LINK Charity} @{" Description " LINK Description} @{" Usage " LINK Usage} @{" Examples " LINK Examples} @{" History " LINK History} @{" Contacting the Author " LINK Contact} @{" Now This Is P*D !!! " LINK P*D} PS: If anyone has some old (or even NEW!) GameBoy games that they don't want anymore, I'll be very happy to take them as a form of thank-you!! (Maybe you don't think it's worth it for this util, but loads of people use some of the other more complex programs I've written!)... Oh, and I know I've always said CONSOLES are TOYS, but the GameBoy lets me play Toilet-tris and wasn't very expensive! @ENDNODE @NODE Description "Super-Select: Description." Super-Select is a program which will pick a random string, insert it between two other strings, and execute the result as if it were typed in a shell window. Can't think of how that could be usefull? Well, say you want a random picture displayed whenever you boot your Amiga. The "random string" could be chosen from a file conatining a list of the files in your pictures drawer, and the turned into a command line which displayed that picture! Or, you could make it copy one of the files in the list somewhere so that it appeared as your Workbench backdrop-picture... You could even use it as a fortune cookie program, making the "say" command speak a randomly selected phrase... It is even possible to have a random command executed! I hope that you can think of some cool use for this program to make your Amiga a bit different everytime you boot... Personally, I have a random Bevis'n'Butthead sample played just before my Startup-Menu appears. If I select one of the startups that takes a while to load, I have a random picture displayed and a randomly selected 70's TV Theme-tune sample played! (The music from Mission Impossible is perfect while booting, and takes EXACTLY the same time as my Workbench startup-option, down to the very last drum-beat... :) Why did I write it? I have see one or two programs which do similar things to Super-Select, but instead of taking the random string from a file, they get directory and randomly choose a file within it. This meant that it would have wasted a few seconds getting a directory of all 80 or so of my pictures. I thought it would be much better to be able to have a program which randomly picked the filename from a text-file which would load much quicker than a directory-scan. Using the code from Super-AmiLog which chose the random comments I slapped together a program which did the job for me, but was unreleasable because it had everything hard-coded into it. ...until now: I finally decided to turn it into a propper util with a ReadArgs() interface which allows you to specify the strings and files it should use. I hope you like it! @ENDNODE @NODE Usage "Super-Select: Usage." Typing "Super-Select ?" will bring up the ReadArgs() command template: H = @{" Help " LINK Arg_Help} (Switch) L = @{" ListFile " LINK Arg_ListFile} (String) B = @{" Before " LINK Arg_Before} (String) A = @{" After " LINK Arg_After} (String) D = @{" Delay " LINK Arg_Delay} (Number) S = @{" NoSpaces " LINK Arg_NoSpaces} (Switch) R = @{" Report " LINK Arg_Report} (Switch) E = @{" NoExec " LINK Arg_NoExec} (Switch) @{" ListFile " LINK Arg_ListFile} is the only required argument, all others may be left out. All of the arguments have abbreviations which are those characters before the "=" symbol and can be used instead of the full names. A switch-argument is activated if it is given on the command-line. For example: "Super-Select Help" Activates the @{" Help " LINK Arg_Help} switch. A number-argument expects a number (surprise!) For example: "Super-Select Delay 5" Sets the @{" Delay " LINK Arg_Delay} time to five seconds. A string-argument expects a string of text. For example: "Super-Select ListFile S:SampleList.TXT" Tells the program that the @{" ListFile " LINK Arg_ListFile} is S:SampleList.TXT" To include spaces in your string, "surround it with quotes". To include quotes in your string, use *" instead of " For example: "He said *"HELLO*"!" = He said "HELLO"! If you're still confused, see the @{" Examples " LINK Examples} section. @ENDNODE @NODE Arg_Help "Super-Select: Usage, The 'Help' Argument." HELP Will bring up the more detailed help text. If the help switch is given, the rest of the command-line is ignored and no command-line is built or executed. @ENDNODE @NODE Arg_ListFile "Super-Select: Usage, The 'ListFile' Argument." ListFile Expects the filename of the list of strings, one of which will be chosen at random. This file should be a normal ASCII text file with one string per line, and with a return at the end of EVERY line (it's quite easy to forget the return on the last line). Currently there is a limit of 65535 lines (should be enough). @ENDNODE @NODE Arg_Before "Super-Select: Usage, The 'Before' Argument." Before Expects a string which will be placed before the randomly chosen string when the command-line is build. You do NOT have to have a Before-string - leaving it out will mean that the randomly chosen string is first in the command-line and the program will run a randomly chosen command! @ENDNODE @NODE Arg_After "Super-Select: Usage, The 'After' Argument." After Expects a string which will be placed after the randomly chosen string when the command-line is build. You do NOT have to have an After-string. @ENDNODE @NODE Arg_Delay "Super-Select: Usage, The 'Delay' Argument." Delay Expects the number of seconds to wait after executing the command-line. This allows you to "RUN" things while giving them time to load all their config files, or whatever, without other things getting in their way. If you specify Delay=0 or don't even use the "Delay" argument, no delay will take place. @ENDNODE @NODE Arg_NoSpaces "Super-Select: Usage, The 'NoSpaces' Argument." NoSpaces Normally, a space is inserted before and after the randomly chosen string because most of the time this string will be a filename which must be separated from everything else on the command-line. If you specify the NoSpaces switch, these spaces will not be added. @ENDNODE @NODE Arg_Report "Super-Select: Usage, The 'Report' Argument." Report If you specify the "Report" switch, the resultant command-line which is generated by the program will be output to the Shell window so that you can check that everthing is working OK. So that you can see things such as spaces at the end of the line and control-codes (such as colour-changes) which would normally be interpreted by the Shell console, it is often a good idea to redirect Super-Select's output and view it in an editor such as CygnusEd. Redirection with the Report switch can also be very useful when running Super-Select in a script (which is what it's intended for!) as you can send all the Reports to a file and make sure all the commands were build correctly. Remember that you can use ">>" instead of ">" when redirecting a program's output so that it will APPEND rather than overwrite whatever used to be there. e.g: Super-Select >>RAM:SS_Log.TXT B "TEST" L "S:List" See also: @{" NoExec " LINK Arg_NoExec} @ENDNODE @NODE Arg_NoExec "Super-Select: Usage, The 'NoExec' Argument." NoExec If you specify this switch the program will generate a command-line as normal, but not execute it. Used in conjunction with the @{" Report " LINK Arg_Report} switch, the "NoExec" switch makes it easy for you to make sure the program is generating the right command-lines without it actually executing them and wasting a lot of time. (The "NoExec" switch is of little use without the @{" Report " LINK Arg_Report} one). @ENDNODE @NODE Examples "Super-Select: Examples." Your archive should have come with an example script called "execute.me" which will ECHO a random quote from another included file. Typing: --------------------------------------------------------------------------- Super-Select ListFile S:PicsList Before DH0:Art/Viewtek Delay 2 --------------------------------------------------------------------------- ...where S:PicsList contains the following: --------------------------------------------------------------------------- DH2:Pictures/Sex/Pervert/Cindy_Crawford.IFF DH2:Pictures/Sex/Pervert/LittleGirl.IFF DH2:Pictures/Sex/Pervert/Sheep.IFF DH2:Pictures/Sex/Pervert/Amiga4000_040.IFF DH2:Pictures/Sex/Pervert/Your_Mum.IFF --------------------------------------------------------------------------- ...would run a command-line such as: --------------------------------------------------------------------------- DH0:Art/Viewtek DH2:Pictures/Sex/Pervert/Amiga4000_040.IFF --------------------------------------------------------------------------- ...and then wait 2 seconds. Typing --------------------------------------------------------------------------- Super-Select L S:PicsList B "Copy >NIL: FROM" A "TO DH0:WBBackdrop.PIC" --------------------------------------------------------------------------- ....would run a command-line such as: --------------------------------------------------------------------------- Copy >NIL: FROM DH2:Pictures/Sex/Pervert/Sheep.IFF TO DH0:WBBackdrop.PIC --------------------------------------------------------------------------- I hope you've got the idea by now! That's really all I can be bothered to do as far as examples go! @ENDNODE @NODE Contact "Super-Select: Contacting Mr.Nudel!" You can reach me on any of the following UK Boards: --------------------------------------------------------------------------- Bad Dreams, Beyond Reality, Burger Bar, Cement City, Dawn Raid. --------------------------------------------------------------------------- You can EMail me via: --------------------------------------------------------------------------- M.Davidson@isode.com --------------------------------------------------------------------------- ...but if you do, please write "C/O Leo Davidson" as it is NOT MY ACCOUNT. (I probably won't even know you've written to me for at least a week if you do EMail me - I'd rather your called one of the above boards). @ENDNODE @NODE Charity "Super-Select: Children of the Storm!" OK, this text is a few months old, and some new things have happened since then, but that shouldn't really matter! Please consider donating, even if you don't use this program! 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! 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. 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. 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! Scene members do have hearts, don't they? Make it worth my while typing all of this info! Who are the CHILDREN OF THE STORM? ---------------------------------- 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... Background ---------- 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. Achievements to date include: - providing food, shelter and income for regugee children, working with the Tavistock Clinic which is providing counselling services and advising teachers, - forging links with the local authority (London Borough of Camden) to put children and carers in touch with any relevant support agencies, - establishing a social club in which refugee children are offered additional tuition and emotional support by their fellow pupils at the school, - acting as the children's advocates in relation to housing, social services, social security etc. Status ------ Registered Charity number 1035774 Consultant: Sheila Kasabova, Refugee Co-ordinator, Camden Council Consultant Psychologist: Maureen Fox, Consultant Psychotherapist at the Tavistock Clinic Legal Consultants: Bindmans (services at no charge) Accountants: Alan Heywood, Chartered Accountants (services at no charge) Aims and Objectives ------------------- 1 To continue to build on the existing project achievements outlined, 2 To extend knowledge acquired by staff and pupils of the school to other schools and bodies dealing with refugee children through teacher-training programmes, conferences, booklets etc. Summary of Projects in Progress or Anticipated ---------------------------------------------- 1 Publishing a booklet: the Hampstead Story, by those involved in the project, outlining the problems Hampstead School itself has encountered with refugee children and strategies for dealing with them. To be delivered free of charge to every school in the country. Cost: £9,000. Project in progress. 2 Expanding the social club outlined above to include students from other local schools including primary schools. Cost: £50 per month. Project in progress. 3 Employing a full-time counsellor at Hampstead School to counsel children and train staff in counselling techniques. Cost: £38,000 pa. 4 Employing an administrative assistant to manage the charity. Cost: £20,000 pa. 5 Holding a national conference on problems faced by refugee children in Britain, and strategies for overcoming them, open to any persons or organisations working with regugee children (teachers, welfare and social servicesm volunteer groups etc.) 6 Employing a fundraiser. Cost: £15,000 pa. Conclusion ---------- 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. 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. Further Information =================== This is basically what you would find on the letter head: Children Of The Storm Hampstead School Westbere Road London NW2 3RT United Kingdom There is a telephone and fax number, but I feel that it would be unwise to include it here, as there are a few idiots out there who might abuse it. Charity registration number 1035774 Patrons: Dame Judi Dench, Lindsay Duncan, Geraldine James, Griff Rhys Jones, John Gordon Sinclair. Trustees: A. Demetriades, A. Berkeley, M. Janota Bzowski, S. Pickford, G. Walker, M. Johnson, F. Capone. Consultants: M. Fox THE TAVISTOCK CLINIC, M. Martin LEGAL ADVISER, A. Heywood A.C.A, S. Kasabova CAMDEN L.E.A. The address is up there, so go on, donate! If you think you can offer something other than money, write! I want to say a huge thanks to anyone who does donate some money. My one request is that anyone donating money writes in their letter that they found out about the charity from this util. If you wish, include your scene-handle and I will make a list of everyone who has donated. Thanks for at least reading this... and sorry for any mistakes in the above text - my typing can go a bit haywire sometimes!! @ENDNODE @NODE History "Super-Select: History." .=[*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*]=. [*] Version v1.00 [====] Release #01 [====] Released on 4th January 1995 [*] `=[*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*][*]=' - First public release. - Only problem is that the Random-number generator is not the best in the world, however, I think it does the job well enough! If anyone has a routine which they think is even better, send it to me. - Limited to 65535 random lines (I think that's enough!) - No future updates planned, unless you have some ideas! @ENDNODE @NODE P*D "nOW tHIS iS pUBLIC dOMAIN" n·o·w t·h·i·s i·s ...... _/\_________/\________ ..... ..:....: \ ._ \ ._ \ :..: : : : / |/ / |/ / ..:.. :..:.:.. / /____/ / / ..:. :...: \_____|cOZY\_________/ :.. p·r·e·s·e·n·t·s Super-Select v1.00 [RELEASE 1] for AmigaDOS Will insert a randomly chosen string (such as a filename or a fortune-cookie) into a command-line. Great for random boot-stuff!!! @ENDNODE @REMARK Dates in history, Contents, Version string.