@DataBase BetterEdit.Guide @Author "Allan `Duff' Odgaard" @(c) "Copyright © 1995 D&D Productions." @$VER: BetterEdit.Guide V1.3 (9-Feb-96) @Font Xen.font 9 @WordWrap @Tab 8 @TOC Main @Macro Prg "BetterEdit" @Macro Ver "V1.3" @Node Main "BetterEdit, AmigaGuide documentation." @{JCenter}Welcome to the @{FG HighLight}@{Prg} @{Ver}@{FG Text} @{AmigaGuide}. © 1996 Allan Odgaard @{JLeft} @{" Intro " Link Intro} - What is @{Prg} @{" Install " Link Install} - Very easy! @{" Disclaimer " Link Disc} - Read your rights @{"Functions " Link Funcs} - What @{Prg} offers @{" To Do " Link ToDo} - Isn't it perfect??? @{" Bugs " Link Bugs} - Write me if you have something beside this @{" Author " Link Author} - Here is who you should thank! @{" History " Link History} - If you are acquainted with @{Prg} @EndNode @Node Intro "What's it all about" BetterEdit is yet another EditHook. It adds ALOT of @{" functions " Link Funcs} to the stringgadgets, which are used by almost every program with GUI. The most impressive functions are stuff such as Filename completion and visual blocking. So if you use stringgadgets alot (who doesn't?) you really should consider to @{" install " Link Install} @{Prg}. @EndNode @Node Install "How to install BetterEdit" You should have atleast Kick V39+ Either drag the icon to your WBStartup drawer or: Copy @{Prg} to C: and add this line to your User-Startup or Startup-Sequence: Run <>Nil: BetterEdit Reboot your machine and test it! @EndNode @Node Disc "Bla bla bla..." Standard disclaimer: There is no warranty for this program to the extent permitted by applicable law. Except where otherwise stated in writing the copyright holder and/or other parties provide the program "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Should the program prove defective, you assume the cost of all necessary servicing, repair or correction. In no event unless required by applicable law or agreed to in writing will any copyright holder, or any other party who may redistribute the program as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages. @EndNode @Node Funcs "Functions of BetterEdit" If you use a common editor you should be familiar with some of the following keys, since they're kind of standard. Amiga + b = Go into @{" BlockMode " Link Blocking}. Amiga + c = Copy either the hole string, or the blocked text. Amiga + d = Decrease nearest number with one. Amiga + G = Switch case from cursor to end of word. Amiga + g = Switch case on current character. Amiga + i = Increase nearest number with one. Amiga + q = Undo all changes. Amiga + v = Paste from clipboard Amiga + x = Cut either the hole string, or the blocked text. In blockmode; to clipboard. Amiga + Tab = @{" Complete filename " Link FNC}, hold down shift to cycle backwards. Ctrl + Tab = -||- Amiga + Key = Send the pressed key to the window, use shift to send keys as q,b,c... Esc = Inactivate gadget (this is non-confirming, in contrary of return) Ctrl + Cr Left = Move cursor to start of current word. Ctrl + Cr Right = Move cursor to start of next word. Ctrl + Backspace = Delete from cursor to start of current word. Ctrl + Delete = Delete from cursor to start of next word. Alt + Cr Left = Move cursor left until it reach a dot. Alt + Cr Right = Move cursor right until it reach a dot. Alt + Backspace = Delete to the left until it reach a dot. Alt + Delete = Delete to the right until it reach a dot. Shft + Cr Left = Move cursor to start of string. Shft + Cr Right = Move cursor to end of string. Shft + Backspace = Delete from cursor to start of string. Shft + Delete = Delete from cursor to end of string. @{B}Explanation of used terms:@{UB} Switch case means; convert uppercase characters to lowercase, and lower to upper, e.g.fOO-bAR would be Foo-Bar. Nearest number is more specific the first number placed under or on the right side of the cursor, if there is no match, it'll then go from cursor pos and to the left. Words are separated by one or more non-alphanumerical characters, means that "foo_bar" are two words, since _ is non-alphanumerical. @EndNode @Node Blocking "How about it!" @{I}Have you ever wanted to copy the pre/suf-fix of the name in the stringgadget, or cut out the middle of it - move an argument or similar.@{UI} If you know MS-Windows, you might have noticed that you, via the mouse, can block out text in stringgadgets. Unfortunately the global edithook (@{Prg}) is not called when user presses a mouse button inside a stringgadget. Instead move your cursor to where the block should start Press Amiga+b, and move the cursor to whereever you want the block to stop. Press Amiga+c to copy the block to the clipboard or press Amiga+x to move the block to the clipboard. You can also press Amiga+b, which will leave the blockmode. If you (in blockmode) activates another stringgadget or a program calls GadTools/SetAttrs on the current stringgadget, the blockmode will be disabled. @EndNode @Node FNC "Filename completion" This can both complete a volume/assign/device or filename, but spaces in the volume/assign/device name will confuse the filename completion (will be fixed!) If you need to enter a picture name like "Graphics:Own stuff/Great Logo.64Cols" you can save alot of typing by using the filename completion function, which I will explain via an example: First enter "gr", and press Ctrl+Tab, then @{Prg} will search the doslist for an volume/assign/device name starting with gr, the first match are then pasted into the stringgadget (a screen flash upon failure) Pressing Ctrl+Tab again won't give you next match, but instead the first file in Graphics: (this might change.) Now you need the sub dir "Own stuff/", so simply write ow followed by Ctrl+Tab, volla "Own stuff/" should be pasted. And last but not least the file "Great Logo.64Cols", you then enter gre, press Ctrl+Tab, and get "Great Font.8Cols", ups!, just press Ctrl+Tab again to get next match, if you get to far you press Ctrl+Shift+Tab for previous match. @EndNode @Node ToDo "Look forward to this..." "Amiga + Shift + c", append string to clipboard, like PowerSnaps "Multi Snap". "Amiga + Shift + v", clear string before pasting, idea from MCP!!! These two suggestions would conflict with "Send key to win", since c would be impossible to send, and this is often used as Cancel, so I will think twice before implementing this. First time stringgad. is activated, everything should be blocked, a cursor move would then unblock, or a key press would clear... This idea is adapted from Windows, and I'm not quite sure that I would like it implemented, but in some cases it would be cool (Performer!) Please @{" SNail-/E-Mail " Link Author} me some more suggestions, or comment the Windows idea! @EndNode @Node Bugs "Bugs in BetterEdit" Problems so far... If the last character in the block, or the character under the cursor (only in blockmode!) has negative textspacing, you might experience some cosmetical problems. When the cursor is placed last in the string gadget, and blockmode is on, I have some problems desiding how big the cursor actually is. Using muFS be aware that if you start @{Prg} before multiuser.library has been activated, the @{Prg} process will belong to nobody, and you can't @{" FileNameComplete " Link FNC} the contents of directories without the r-flag set for others. When the string gadget is empty, the cursor will not change color when @{" BlockMode " Link Blocking} is selected. @{B}If you find other bugs or just have some suggestions, call/write or visit me! @{" I'll Do That " Link Author}@{UB} @EndNode @Node Author "I did it" @{Prg} was done by: @{JCenter} Allan "Duff" Odgaard Dagmarsgade 36 DK-2200 Copenhagen Phone: (+45)35821112 EMail: Duff@DK-Online.DK It was released as @{B}rOYAL-WaReZ@{UB}, and if you like and use it, you should consider to call a Royal board, or you could send me a small donation! @{B}Atleast send me an EMail!@{UB} @EndNode @Node History "The making of BetterEdit." @{fg HighLight}@{Prg} V1.3 (9-Feb-96):@{fg Text} ----------------------------- Released on AmiNet!!! Can be stared from WB (Credits goes out to Cryo) Some minor bugfixes. Now Amiga-x will only copy the string into clipboard in blockmode; Demanded by Sune Foldager and Mads Henriksen ----------------------------- @{fg HighLight}@{Prg} V1.2 (16-Jan-96):@{fg Text} ----------------------------- Filename completion works with AmiFileSafePro, this isn't a bug in BetterEdit, but in AFSP!!! You can now name-complete files starting with: '"', '>' & '=' - Unfortunatly you can't use these 3 characters as part of your volumename... E.g. Echo "foo" >T:b... (Would work) Setting=EnvA... (Would also work) "RAM:Clipbo... (Ofcoz' it worls) (The filename analysation routine will soon be rewritten, to a more clever routine....) ----------------------------- @{fg HighLight}@{Prg} V1.1 (05-Nov-95):@{fg Text} ----------------------------- Works 100% with MUI and ReqTools Stringgadgets. Added Amiga key as qualifier for Filename completion. Esc will now inactive the gadget (this is NOT the same as return) ----------------------------- @{fg HighLight}@{Prg} V1.0 (30-Oct-95):@{fg Text} ----------------------------- In @{" BlockMode " Link Blocking}; the selected text is now inverted. Also the cursor changes color. @{" Amiga + Key " Link Funcs} (optional shift), will send a keypress to the active window. ----------------------------- @{fg HighLight}@{Prg} V0.9ß (07-Oct-95):@{fg Text} ----------------------------- Beta release. ----------------------------- @EndNode