ARM Club 1

home *** CD-ROM | disk | FTP | other *** search

/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / program / s / stronged2 / !StrongEd2 / StrongEd2 / Helpdata next >

Wrap

Text File | 1992-12-16 | 18.7 KB | 575 lines

Help on StrongED II StrongED II v 1.20 * <Licence > * * <Keyboard layout=>Keys> * * <Mouse Control =>Mouse> * * <Menus > * * <Strengths > * * <Weaknesses > * * <This Version =>ThisVer> * * <Next Version =>NextVer> * * <Thanks > * * <Credits > * Guttorm 'ArmStrong' VikSend me Money! Donations are much appreciated. Apart from bringing me cash, they also show that I've not *wasted* the TWO YEARS it has taken me to write "!StrongED2" and "!StrongHlp"... Send me money in excess of, say, £5.00, and I'll send you the next version. Cash (any currency) (no cheques please!), and other correspondance, can be sent to : #indent 11 #sprite 48,432 !stronged2 Guttorm 'ArmStrong' Vik Hølbekken 208 5262 Arnatveit NORWAY #indent 0 Members of the <German Archimedes Group=>GAG> (GAG), can register for, say, DM 10 through their club.Strengths - It is 'nice' to use.. This because there are lots of little, caring, details : - The scrollbar is based on how many lines are visible , and how many lines there are. In !edit it's based on how many chars are visible, and total size of text. - The save-box allows you alter filetype as well as filename. - Instead of asking "are you sure you want to kill file xxx..", the save-box is opened, with an additional "Quit" icon. - The editor can edit files with different types of newlines. Newline type is automatically detected when file is loaded. - The user has full control of which colours are used. Foreground and background colour of text both inside and outside a block can be set, and caretcolour too. - Editor supports the tab character. - The infobar shows : * Changed state ( *, ,? for yes,no,maybe) * Current cursor position * Insert / overwrite * Current tabkey mode * If there is a block marked and if in this text ( ,b,B for none,block,block here) * Shows which of the marks are used, and if in this text. * Shows ww,cw,WW,CW for wordwrap,charwrap. (Lowercase if no lines are wrapped.) - If you insert a char, and then deletes it again, the editor knows that the text is unchanged. - Lotsa key shortcuts. The one I miss the most when I use other editors, is ^Q. ^Q has same effect as clicking on the window's close icon. - True wordwrap. - There are some big details as well : - !StrongHlp : If you press F1 when cursor is inside a word, the word is sent to !StrongHlp, which then will give help on the word if it knows it. !StrongHlp has currently help on all Wimp_swis, some OS_swis and some other stuff. - List of texts : Shows all texts, their filetype, name and status, in a window. Click on an entry, and it will be opened on top of all others. - List of found : Searches through whole text, and opens a window with the lines where word was found. Click on an entry, and cursor will be moved to that line. ^F will search for the word at cursor. F2 opens the lof dbox. - Throwback : This is for use with Desktop C. Errors & warnings are sent to editor, which shows them in a window. User can then click on one, and the file is automatically loaded, and caret is moved to correct line. - BASIC : files are automatically converted to/from BASIC when saved/loaded. - Fastchars : For 16-colour modes I have made my own output routine. This makes screen update somewhat faster.Weaknesses Well, there are some.. - My editor uses only the 8*8 system font. Since no-one seemed to use outline fonts in !Edit, I didn't bother.. - When editing at the start of a large file, update will be a little slow. This because insert and delete are not 'buffered'. This will be improved upon in a later version. - The search/replace function is somewhat basic. There is no provision for wildcards of any kind. In addition to straight text, you can use \\n for newline, and \\cM or \\x0D for control characters. This will probably be improved upon in the next major version. - Be sure to read about its <strengths> too..Next Version The next major release was planned to be around xmas, but things are moving slowly, and I will probably be a couple of months delayed.. The one thing sure to happen in the next version, is that there will be absolutely *NO* support for RiscOS 2.0 or 3.0. It will be 3.10 only. Other ideas in my scratchbook (No promises..) : StrongED2 : - Macros. - Redefining of keys. - Fastchars for 2,4 and 256 colour modes. - Formatting of text/block : - Centre - Right/Left/Full justify - Plain text -> Wordwrapped text - 'Freeblock' (any rectangular area) - Faster editing of large files. - Modes defining macros/keys/colours/.. These can be connected to filetypes, so that a given mode will be set when a file is loaded. - Implement CC's Intuition. - A better print routine, using the PrinterDrivers. StrongHelp : - More help. - Packing of data. Perhaps using Squash in RO3? - Allow search for "XWimp_.." and not just "Wimp_.." - Implement fonts/draw-files?Keyboard layout Key Normal Shift Ctrl Both ----- ------------- ---------------- ------------- -------------- F1 Help word Help StrongED <Goto Mark=>GotoMark> 1 <Set Mark=>SetMark> 1 F2 <lof dbox =>dbox_lof> <lof C/BASIC=>menu11> Goto Mark 2 Set Mark 2 F3 <Save dbox =>dbox_sav> <BlockSave dbox=>dbox_sav> Goto Mark 3 Set Mark 3 F4 <Search dbox=>dbox_src> <Replace dbox =>dbox_rpl> Goto Mark 4 Set Mark 4 F5 Goto dbox Goto block Insert Char F6 Mark block Clr block Mark Text F7 Copy block Move block Loose caret F8 Undo Delete block Redo F9 <Playback> <Record=>Playback> F10 Run BASIC Save&Run BASIC #Table 7 22 ^B View to Back ^C Copy block ^F Create lof ^H = Backspace ^I <Indent Block=>Findentone> ^J Lowercase char ^L Open lot ^M = Return ^N Next Srch/Repl ^O <'Outdent' block=>Foutdentone> ^P Previous message ^Q Kill view/text ^S Swapcase char ^T View to Top ^U Uppercase char ^V Move block ^W Mark word ^X Delete block ^Z Clear block #EndTable Key Normal Shift Ctrl ------- ------------------ -------------------- ----------------- Tab Insert TAB/spaces Toggle TAB visible Cycle tabkey Copy Delete to right <Copycursor> Delete line Print Print text Print block Esc <Clear/Mark block=>Escape> \<-| Delete to left -------------------------------- Insert Toggle Insert/Overwrite | Ctrl ⇦⇨ Start/End of wl then tl Delete Delete to left |Shift ⇦⇨ Wordwise move Home Start of text |Both ⇧⇩ Scroll Up/DownList of Found Shortcuts : F2 Old string ^O Old string ^C Toggles case sensitivity ^G Toggles global switch F7 copies text from block ^W copies word at cursor ^S Selects what should be shown in list : Whole line all From found string all After found stringSave This dbox is used, in slightly different forms, for save of text, block, lof, viewers, and when killing changed text. In the latter case, there will be an 'Kill' icon, and ^Q can be used as a shortcut. BASIC will not be tokenized if : Filtype is not BASIC. Save to an App, and not filer. Blocksave.Interactive Search Shortcuts : F4 Old string ^C Toggles case sensitivity ^O Old string ^N and ⇩ Find Next ^P and ⇧ Find Prev.Search Replace Shortcuts : ⇧F4 Old string ^O Old string ^C Toggles case sensitivity ^A Toggles magic switch ^S Cycle scope (block,text,all) ^N Count found Magic patterns are : \\n for newline \\t for TAB \\xXX for hexchar \\cX for ctrchar \\\\ for \\ When a string is found, the <WhatNext=>dbox_nxt> box is opened.Indent One This function inserts a space ( or a TAB if truetab mode ) into each textline in the block, at the position of the cursor.Outdent One This function deletes the char at the cursor position, from each textline in the block.Copycursor Move copycursor around with arrow keys, and copy chars by pressing 'Copy'. Leave copycursor mode by pressing 'Esc'Escape key If there is a menu open, this will be closed. If not, and <Copycursor> is enabled, this will be cancelled. If none of these, then the magic begins: When you first press Esc, any existing block will be cleared, and the block 'pivot point' will be set to caret position. If you then keep Esc down, and move cursor, block will continously be set to everything between the 'pivot point' and current caret position.Some menus explained It's not always easy to describe a function in one word, so some of the menu entries might need some extra explanation: Iconbar menu : Switches-><Trap DClick=>menu1> <Trap Shift=>menu2> <Trap EditRequest=>menu10> <Open Behind=>menu3> <Throwback=>menu4> <Suppress Spurious=>menu5> <Infobar-\>=>menu6> View menu : Edit-><AutoTrim=>menu7> <Protect \\n=>menu8> <After Block=>menu9> <ListOfFunctions=>menu11>Trap DClick When this is off, StrongED won't load any doubleclicked files. This can be used when you wish another program to load them. StrongED will still load files dragged to its iconbar icon.Trap Shift When this switch is on and the Shift key is pressed, StrongED will load *any* file, not just textfiles. This is done automatically by RiscOS 3, so there this switch doesn't matter. Open Behind When this switch is on, and you drag several files to the iconbar icon, the first file to be loaded will also be the one on top. This is useful when you load files with names like "xxx00", "xxx01", "xxx02", and you want to read them in the same order.Throwback This is for those with Desktop C, and they will hopefully know what it does. The rest of you can just ignore this switch.Suppress Spurious Some programs broadcasts their "OK, I've loaded the file" messages, instead of sending them directly to the task they got the original message from. This means that StrongED too recieves them. Normally this would be reported as an error, but if you regurlarly use such a program, this can be a bit annoying. If this switch is set, these errormessages will not be reported. Note: There is a similar switch in StrongHelp.Infobar The infobar is the line hanging beneath the windows. If you don't like it, you can remove it by turning off this switch.AutoTrim When this switch is set, StrongED will remove all spaces and TABs from the end of a textline, when you leave it, but only if you've edited in it. To see the effect, set 'Background2' to something else than 'Background'Protect \\n When this switch is on, you can't (inadvertedly?) join two lines with the Copy key.This Version Actually, I hadn't planned to release a new version until xmas or so, but there were some irritating shortcommings in version 1.10 that I just had to fix. First of all, there was a small "bug" in my throwback handler. I believed that throwback messages sent by Desktop C would be 0-terminated. After all, that was what the documentation said.. Silly me... The other thing that I believed was fixed, but wasn't, was support for 3D buttons in RiscOS 3.10. Acorn changed the syntax somewhat, just to be nasty with me, I'm sure.. There are also some genuinly new features in this version: One feature that many have asked for, is to save the text when clicking on "Save ⇨" in the view menu. This is now implemented. As a result of this, the entry "Save ⇨ Block ⇨" will not be greyed out when there is no block marked. There is also a file-info box at "Misc ⇨ File ⇨", and the mouse pointer can be hidden when you type. A more interesting change is perhaps that a Search/Replace now can be limited to a block, current text, or all texts! List-of-found can also be applied to all texts. Ah, yes.. There is one more improvement worth mentioning.. If the program for some reason should crash, it doesn't just quit, but gives you an option to try to continue. This will not always work, but should save your bacon most of the time, I hope.. I hope you all enjoy the new version, and that you don't discover too many bugs. If you do, I'd like to hear about it though. The next major version (with a better Search/Replace) which I had planned to release around xmas, will probably be a couple of months delayed. STOP PRESS : I've added the ability to record a sequence of keypresses, and then playing them back. Start/Stop record with ⇧F9, and playback with F9. STOP PRESS AGAIN: I've implemented Jason Williams' External Edit protocol. This allows much smoother editing of StrongHelp pages. Check it out! Hopefully, other programs will start using this protocol too. Thanks goes to the following people : Kristján Valur Jónsson, Gavin Wraith, Ragnar Hafstað, Olaf Krumnow, Herbert zur Nedden, Nathan G. Aldridge, Stefan Brück, Dr S.H.Curry, Andy Cowling, The Haslam family, Juan Salas, Eivind Hagen, Kjetil T Homme, Ainsley M Pereira, Denis Howe, Jan van der Watt, Jon Thackray, Cy J Booker, Mark Thompson, Iain Waugh, Atle Mjelde Bårdholt, Marcel van Eck, Paul Hobbes, Dick Alstein, Kjetil Bernhard Thomassen, Ari Pitkänen, John Yeates, Steve Walpole, Hugo Mills, Douglas Winter, Hálfdan Ingvarsson, Kenneth Haugland, Knut Folmo, Thomas Christiansen, Søren Lange, Jan Helmke, Ian Palmer, Jón Ragnarsson, Nick Cross, Dag Håkon Myrdal, Jason Williams, Angelo Schneider, Bruno Böttcher, Sebastian Jekutch, "trying to be" Tom Kirby-Green and Geir Åsmund Sagbakken Yes, These are the 46 brave ones who sent money. A special thanks goes to Eivind Hagen for helping me find the bug in my throwback handler. Thanks also to Herbert zur Nedden and Olaf Krumnow from the <German Archimedes Group=>GAG> (GAG), for helping me distribute StrongED in Germany.After Block When this switch is on, the caret will be placed *after* the block when you do Copy, Move, File-insert or Goto block. Otherwise caret will be placed at the start.What Next? Shortcuts : ^N Next ^R Replace ^A Replace all F8 Undo ^F8 Redo ⇩ NextLicence This is a Shareware Program. This means that you can copy it freely, but not alter it, or make money on it, and if you find the program useful, you are supposed to send me <Money>! Don't give away altered copies : * Don't remove any of the modules inside the !StrongED2 directory. * Don't change the icon, even if you find it "Neo Brutalistic", Gavin. * Don't add, change or delete the help in StrongHelp. * Don't do anything else either.. B) With your private, not to be given away copy, you can do all of the above..Credits The Interface module, is written by Simon Huntington. It is this module that gives you 3D buttons & borders in RiscOS2. The "External Edit" protocol was defined by Jason Williams.Mouse control Load file: DClick on textfile. Shift-DClick on *any* file. Drag *any* file to iconbar icon. Insert file: Drag file to view. Shift-Drag to insert pathname of file. Movement/Marking: Select to move caret Dclick with Select to mark word. Tripleclick with Select to mark line. Select-drag marks new block Ctrl-Select starts new block withouth moving caret. Adjust/Adjust-drag to alter block, or start new from caret. Clicking on the *background* of the scroll-bar will scroll one page up/ down. Keep it down for *autorepeat*.Trap EditRequest When this is off, StrongED won't respond to requests from other programs to edit text for them. Not many applications uses this yet. Infact, the only one I know of, is StrongHelp...Set Mark This remembers your current position. You can then later use Goto Mark to return here. Note that if you do Set Mark twice in a row ("doubleclick"), then the mark will be cleared. You can also set mark by using "Adjust" on one of the Mark indicators on the infobar.Goto Mark This will move cursor to a position previously remembered with Set Mark. You can also goto mark by using "Select" on one of the Mark indicators on the infobar.Record and Playback This can be used to automate some rather tedious tasks ("finger killers"). Press ⇧F9 to start recording, type anything you like, and press ⇧F9 again to stop recording. Then press F9 as many times as you like to repeat the sequence you recorded. Please note that it in its current state is rather primitive..The German Archimedes Group #### ## ## ## Herbert zur Nedden ## ### Alte Landstrasse 21 ## ## erman W-2071 Siek ## ## (04107) 99 00 #### #### ## ## ## ## ###### Olaf Krumnow ## ## rchimedes August-Bebel-Strasse 102c ## ## W-2050 Hamburg 80 ## ## #### (040) 721 92 87 ## ## ## ## ### ## ## roup ## ## #### Ein Userclub fuer alle Freunde der Archimedes-Rechner-Familie. Die Sprache des Clubs ist deutsch, die Mitgliedschaft aber nicht auf Deutschland beschraenkt. Zweck: ====== Zusammentragen von Tips&Tricks, Informationen usw., Hilfestellung bei allen moeglichen Problemen, Erstellen von Hard- und Software fuer Acorn Archimedes-Rechner. Beschaffung von Software. Aufbau einer Programmbibliothek. Organisation von Sammelbestellungen zu besonders guenstigen Konditionen. Programme: ========== Tausch von selbstgeschriebenen Programmen. Gute Programme koennen ueber den Club an Mitglieder verkauft werden. Eine spezielle Software-Gruppe innerhalb GAG ist in Planung, um besonders hochwertige Software unter einem gemeinsamen Label zu verbreiten. GAG-NEWS, ======== die Mitgliederzeitschrift, erscheint etwa 8-woechentlich. Inhalt ist alles, was uns ueber die Archimedes-Rechner in die Finger kommt (ohne Copyright), insbesondere von Mitgliedern geschriebene Artikel. Kosten: ======= Wir berechnen ausschliesslich Selbstkosten und verschicken nichts, wenn Ihr persoenliches Guthaben nicht reicht. Fuer jedes Mitglied fuehrt Herbert zur Nedden ein Konto, von dem die jeweils entstehenden Kosten abgehen. Der Kontostand wird bei jeder Sendung mitgeteilt (er steht ueber der Anschrift) und kann natuerlich jederzeit erfragt werden! Einzahlungen bitte auf's Clubkonto (Absender mit Name und Anschrift nicht vergessen!!!) Herbert zur Nedden Sonderkonto G Kontonr.: 6912 14-208 Postgiroamt Hamburg BLZ 200 100 20 oder als V-Scheck an Herbert zur Nedden ListOfFunctions If the current text is a BASIC file, this is the same as using the ListOfFound box to search for "DEF". If the current text is a TEXT file, I will assume that it is a C program, and use a special routine to search for all function declarations.