═══ 1. Smalled OS/2 editor ═══ SMALLED 2.00 Smalled is a powerfull 32 bit Multi threaded PM editor. It has all of the attractive OS/2 features like direct manipulation (d&d), highly configurable, use of extended attributes, ATM font support, WYSIWYG printing and extended text formatting tools  Disclaimer Registering/Shareware  The Smalled controls  How do I .....  Glossary/What is .....  Startup parameters  What's new / History  Future attractions  Thanks  About the author/support  About Smalled  Other Bianchi software products For support please contact Biachi Software at: Eric.Slaats@wxs.nl ═══ 2. Thanks ═══ !Thanks! I've got a lot of people to thank for their help while I was building this and previous Smalled versions. Thanks to:  First the beta testers who kept me going, especially -Peter Landstreet (Barent) -Paulo Mario dos S. D. de Moraes -Martin S. Hanoian  My wife and two kids for constantly interrupting and showing me what's really important.  Rich Walsh for sharing the DT rendering method with me.  An increasing number of users who send me their comments. ═══ 3. Startup parameters ═══ Smalled only supports one startup parameter at the moment. If a program object is created of smalled with the parameter /H or the /H is used on the command line, Smalled will execute the Smalled HTML Extensions automaticly. Future versions will see a lot more employement of startup parameters. ═══ 4. The Smalled controls ═══ Smalled features a normal menu bar, a toolbar and several context-popups to control it's action. Besides that Smalled will respond in any way to direct manipulation (d&d) and supports a number of hot keys (accelerators) which can be edited to fit your personal needs. This section is organized in the same way as the Smalled controls.  Main menu. - File-menu. - Edit-menu. - Options-menu. - Tools-menu. - Windows-menu.  The toolbar.  The Statusbar.  Popups. - The context popup menu. - Statusbar Wrap popup. - Statusbar Indent popup. - Statusbar Changed/Autosave popup..  Drag-n-drop.  Hotkeys and mouse. ═══ 4.1. The Statusbar ═══ Smalled has a configurable graphic statusbar. It contains four area's in which information is displayed. The color and font of the statusbar can be changed by dropping a color or a font. The area's in the statusbar will match the font width. The height however won't change. These changes will be saved when you close smalled. or when User window save is on by using Save window. To configure the statusbar use the Statusbar preference page from the preferences dialog. You can change if the information area's are displayed as text or as an icon. Besides that information area's can be turned on and of.  Text area. This area is used to display the lineno, colnr and number of lines. Besides that it's used to show a number of system messages on certain actions.  The Wrap area shows the current wrap state. off, word wrap, line wrap  The Indent area shows the current indent state. on, off  The Autosave area shows the current autosave state. on, off  The Changed area shows the current saved state of the document being edited. unchanged, changed. By clicking on the information area's with the RMB, a context popup will appear for that area. The main-message will show the same popup as the edit area. The Warp area shows a wrap popup, the Indent area a Indent popup and the changed/autosave area shows a file-save popup. ═══ 4.2. The Toolbar ═══ The Smalled toolbar is configurable so that it can be modified to fit your personal needs (see the toolbar preferences). To provide some help the Toolbar also features bubblehelp. The icons in the toolbar have the following functions: By doubleclicking the icon right here in the help file, you'll get more extensive help about the feature attached to the button. -New. -Open -Insert file. -Save. -Save as. -Copy file to -Save-n-exit. -Print. -File info. -Undo. -Redo -Cut. -Copy. -Paste. -Clear. -Goto. -Find -Find again. -Replace. -Fonts. -Word wrap. -Indent -Text info. -Text formatting tools -Preprogrammed style 1 -Preprogrammed style 2 -Preprogrammed style 3 -Preprogrammed style 4 -Preferences -Tile Smalled windows -Cascade Smalled windows -Make window tall -Make window wide -Next Smalled window -Previous Smalled window ═══ 4.3. The File menu ═══ The file menu contains a number of options which enable you to handle a file from and to disk, do some simple file-management or print it.  New  Open...  Insert file...  Reload file...  Shred file...  Backup file...  Save  Save as...  copy to file...  Autosave...  Print...  File information...  Exit  Save-n-exit ═══ 4.3.1. New ═══ The way New will react depends on the setting for New in the general preferences page. New will either clear the current document and will set the filename to: Untitled.fil, or a new Smalled session will be started. A new document can also be created by using open with a non-existing filename, this invokes a new action and the name of the new file is set to the name entered. Another way to invoke new is through drag-n-drop. Simply drag the Smalled titlebar-icon to the shredder. If New is invoked and Smalled is configured so that it will remove the current contents, it will first check if the file you're currently editing has changed since the last time it was last saved. If this is the case, you will be prompted if the current contents of Smalled have to be saved. ═══ 4.3.2. Opening a file ═══ A new document can be opened by activating Open. The Smalled handles this depends on the settings for Open in the general preferences page. If Smalled doesn't open a new session for the selected file, a check will be aplied if the file you're currently editing has changed since load-time or since the last time it was saved. If this is the case, you will be prompted if the current contents of Smalled have to be saved. You can reply with:  Cancel: cancels the whole operation. You will return in the current document.  No: doesn't save the current file, but it start the fileopen dialog. The contents of Smalled aren't distroyed yet, so if you press cancel in the fileopen dialog, smalled returns to the current text.  Yes: saves the current file and it will start the fileopen dialog. The fileopen dialog will be opened in the directory set with the set default directory preferences. This can be either a default directory or the directory in which the last opened file resides. If a filename is entered in the file open dialog, that doesn't exist, Smalled will assume that you want to create a new file. So if a nonexisting filename is entered, Open functions like New with the ability to set a new filename. If you do this, an alarm will sound and the statusbar will mention what you're doing. An other way of opening a file is to use the drag-n-drop capability of OS/2. If a file object is dropped on the Smalled icon, Smalled will be started and the dropped object will be opened. Drag-n-drop can also be used when Smalled is already started. If an object is dropped on the main edit area, the dropped file will be opened. If Smalled already contains text, this drop will have the effect of a Insert file action. The contents of the dropped file will be inserted at the point were the file is dropped (droppoint). Besides getting the file contents into Smalled, there are some values loaded from the extended attributes if the file was previously saved with Smalled. The font, tab, wrap, Indent and cursor position settings are loaded from the extended attributes. Smalled can handle large files. However, some operations may become rather slow as files grow very large (>1Mb). However, most of the time this shouldn't be a problem because Smalled is multi-threaded. You may start editing or searching while Smalled is still loading a file. ═══ 4.3.3. Insert file ═══ If Insert file is activated, Smalled will start an action which has a large similarity with opening a file. The fileopen dialog will be started using the directory set with the Set default directory dialog and a filename can be entered. If the filename doesn't exist, you will be prompted so. If the file exists, it will be opened and the contents of this file will be inserted at the current cursor position. The name of the file which is currently being edited will be preserved. The font, tab, indent and wrap settings of the Inserted file will NOT be used. The retrieved text will use the settings of the current file. There is however one xeption. If you're retrieving a file while the smalled doesn't contain anything, it will handle a file-insert as a fileopen. An alternative way of retrieving a file is to use the drag-n-drop capability of OS/2. If a file object is dropped on the Edit area, the file contents will be inserted in the current text at the position of the drop (droppoint). ═══ 4.3.4. Reload file ═══ Reload file, destroys all currently made changes and reloads the file currently being edited. If there are changes in the current document, a messagebox will popup with the warning that all changes will be discarded. At that point the reload action can be aborted. This option isn't available if the file being edited is Untitled.fil. (check the title-bar for the current filename). ═══ 4.3.5. Shred file ═══ Shred file deletes the file currently loaded without any further warning. As a safety catch, the changed status of the document is set. This way an unwanted Shred can be undone by saving the file. Note that if changes are made, the document saved will not be the same as the document that's deleted! Besides this safety, you can also choose to automaticly invoke a backup before a shred is performed. Check out the Shred directory in the Backup preferences ═══ 4.3.6. Backup file ═══ Backup file will create a backup of the original of the file currently being edited. How this backup is created depends on the settings in the Backup preferences. With this option backups can be created if you want to control the backups that are made. For example, you may want to create a backup before you save a file. ═══ 4.3.7. Save ═══ Save file, saves the current contents of Smalled. If the filename is Untitled.fil, a file-dialog will be displayed in which you can enter a filename under which the contents will be saved. The Smalled contents can also be saved by using drag-n-drop. (Drag the titlebar icon to the disired folder to save the whole file). If a file is saved, not only the contents are saved, but also the: - used font - current wrap mode - used 1inelength. - the current Indent setting - the tab size and mode - the current cursor position. These settings are saved in the Extended attributes. This way the files can still be handled as pure ASCII.The drawback is that saving a file on a fat drive may take extra time because the ea's on a fat drive must be saved in a separate file. The name used for saving the file is displayed in the titlebar. If the titlebar contains the name Untitled.fil, Smalled assumes that you're editing a new file and no filename has been entered yet. The standard file dialog will be started so that a valid name may be entered. If you want to save the current file under another name, use save as. ═══ 4.3.8. Save as ═══ The Save as option of the file menu has as main purpose to save an existing file under a new name. Normally the filename of the contents is diplayed in the titlebar. The name displayed will be used when Save as starts the standard file dialog. After the Save as action, the filename used for the file saved will be changed in the filename used for save as. If you don't want that name to be changed use the copy to file option in the same menu. If a text-selection is active in the edit area, the fileopen dialog will show a checkbox which will enable you to save the selected text to a file. If this option is choosen, the filename for the current text won't be changed. If the filename entered in the save dialog already exists, you're prompted. At that point you can choose to overwrite the existing file or to cancel the save as action. ═══ 4.3.9. copy to file... ═══ The copy to file action enables you to save the file currently being edited under another name (and in another path or drive) without changing the current filename. This way it's easy to make multiple copies of one text-file. If copy to file is activated, the standard file dialog is started. In the header of that dialog you can see that copy to is started. If a text-selection is active in the edit area, the fileopen dialog will show a checkbox which will enable you to save the selected text to a file. You may use all the facilities of the file open dialog, it won't affect the file you're currently editing. ═══ 4.3.10. Autosave ═══ Tthe Autosave function is a toggle. The initial state of this item depends on the setting in the Backup preferences page. The status of the autosave setting can also be viewed in the statusbar. Here it can also be toggled by using the popup on the autosave statusbar area. If this menuitem is togled on, Smalled will start counting the changes you make in the current document. Every letter you type, as well as changing the font or tabs is concidered a change. If the number of changes that is given in the preference page is reached, Smalled will save the current file if it has a valid filename (it won't work for untitled.fil). Depending on the backup settings a backup will be created on this event. ═══ 4.3.11. Print ═══ Printing is only available when Smalled contains text. The way this text will be printed can be modified by setting the print preferences. Headers, footers, pagenr's, margins etc can be set here. If printing is activated, the following dialog will shown. If a selection has to be printed, check the "print selected text" checkbox. Another attractive way to print the text or a selection is by using drag-n-drop. Simply drag the selected text to the printer. (For the whole document, drag the titlebar icon.) If this dialog is activated, the default printer will be hilited. If you've got more printers installed, another printer can be selected by hiliting the printername. (It may be a good idea to install more printerobjects even if you've only got one physical printer. Every printerobject can have a different set of properties. For example, one printer for draft, one for landscape, etc.) The print job properties for the printjob you're about to start can be modified by choosing the setup button. A printer specific setup dialog will appear. This dialog is contained in the printer driver and has its own help. If the print button is hit,Smalled will start printing. The Smalled print routine is multi-threaded. This means you can work while Smalled is printing. The Smalled print routine is a two staged routine. In the first stage, the contents of the edit area are read. During this action the red slider will show the progress made. During this red period, you shouldn't make any changes in the text. Any changes made during this period may show up in the print (depending on whether Smalled has already handled the line you're working on). The next stage in printing is the actual printing. The progress in this action is shown by a green slider. During this action every function in Smalled may be performed, it won't disturb the printout. Exiting Smalled at this time will cause the printjob to be discarded without any further notice! If you want to stop the current printjob, use the Stop button which came available after the printjob started. This will interrupt the printjob. It won't remove the already printed pages from the printqueue though. The Smalled print facility features WYSIWYG printing. The way things look on screen, they will appear on paper. There is a simple trick to create a print-preview with the OS/2 system. Open the print object you want to print to and activate the object popup. In the popup of a printer there is an option named "Change status". With this option the spooler can be told to hold the printjobs. If this option is flagged, the printjobs aren't sent to the printer, but it will appear in the printer object. To view the contents simply double-click in the job you want to view. OS/2 will start a viewer and you can view the contents of tge print on-screen. (Future versions of Smalled will contain a print-preview option) WYSIWYG printing in Smalled means: The font used in the edit area is the same font as used by the printer. If a font incompatebility occurs, the print routine will try to match the printer font as close as possible to the used screen font. An example: The system font or the vio fonts aren't supported by printers. These are typical screenfonts developed for fast screendisplay. If these fonts are printed OS/2 tries to match them as closely as possible to one of the available fonts. In most cases this will mean that Courier is selected because this is in most cases the only other available non-proportional font. All ATM fonts are supported. The tab size as set in the Smalled is also used in the printed document. This means that the width of the tabs is also used by the print-function By using tabs it's possible to create tables. If word wrap is on, the width of the lines printed are set by the size of the main Smalled window! This means that Smalled uses the width of the Smalled main window to set the width of the printed text. So a litteral copy of every textline as you see them on the screen will appear on the printout. Note that in a fullscreen (maximized) Smalled session with word-wrap, the lines always exceed the width of the print-paper! There's no checking if the line width exeeds the printer page width! So if you print very long lines, they are clipped at the side of the page. To prevent this from happening, us the preview described above. ═══ 4.3.12. File information ═══ The file information option in the file menu gives the possibility to get some more information about the file you're currently editing. This option will only work if the file you're editing is already present on disk. If you're editing a new document, file information won't be available. File information gives info about: - Current filename - Current filesize - Allocated filesize - Creation date (HPFS only) - Last access (HPFS only) - Last write - File attributes Besides that it gives information about five settings saved in the extended attributes. - Used font - Wrap mode - Linelength - Indent mode - Used tabsize ═══ 4.3.13. Save-n-Exit ═══ Save-n-Exit is a shortcut for exiting Smalled and saving the current contents at the same time. ═══ 4.3.14. Exit ═══ Exiting Smalled can be done by double clicking on the system icon, by selecting the exit option of the file menu, by clicking the exit button in the titlebar or by using the F3 button. In all cases Smalled will check if the file contents are changed since the last save action or since load-time. If this is the case, you are prompted if the file has to be saved, if the exit procedure should be canceled or if Smalled should quit without saving the changes. If the current filename is Untitled.fil, selecting Yes from the dialog will start the save as file dialog, so you can enter a valid filename. If a Smalled print session is active, it is discarded as Smalled exits! Smalled will also exit if CTRL-x or ALT-F4 is pressed. ═══ 4.4. The Edit-menu ═══ The Smalled Edit-menu contains the items used to modify (or used in modifying) the contents of the Smalled edit area. The Edit-menu contains the following items:  Undo  Redo  Cut  Cut line  Copy  Paste  Clear  Goto line  Find  Find again  Replace  Select all  Deselect all ═══ 4.4.1. Undo ═══ Undo will try to undo the last actions. For this Smalled has 64 Undo and 64 Redo buffers. By using these in an intelligent way (joining them), Smalled has a virtually infinite Undo/Redo buffer. Undo always undoes a block of actions that are catenated. Character undo isn't implemented yet. It will be in future releases. ═══ 4.4.2. Redo ═══ Redo will try to redo all the actions. that were previously undone. Not all actions can be redone! For example you can't redo a delete of text that has already been deleted by hand. Smalled will try to redo most of your undo actions when possible. ═══ 4.4.3. Cut ═══ Cut will delete the currently selected text and move it to the Clipboard. When cut is invoked, any previous text contents of the clipboard are destroyed. You can avoid this by using the Smalled clipboard extensions. Text can be retrieved from the clipboard by other Smalled sessions or other applications (even Win/OS2) by using paste. The maximum amount of text you may cut to the clipboard is limited to 64 Kb in Smalled. If you try to cut more then 64 Kb. Smalled will give an error message and discard the cut operation. This is because Smalled is based on the MLE control which has this restriction. In future releases of smalled this restriction may be overcome. This limitation isn't there if drag-n-drop is used when moving text. Future version of Smalled won't have this limitation. ═══ 4.4.4. Cut line ═══ Since wordstar the CTRL-Y function has become very popular. In Smalled CTRL-Y or Cut-line cuts the current line to the clipboard. It doesn't matter if WRAP is turned on or off. So a line is not a piece of text between two characters but a line as visible on the screen. ═══ 4.4.5. Copy ═══ Copy copies the selected text to the Clipboard so it can be used somewhere else in a paste operation. The selected text remains unchanged although previous text contents of the clipboard are destroyed. Text can be copied from the main edit area and from several dialogs, in which parts of the text can be selected like in the find, replace and the file-dialog. Use mouse or Shift-arrow to select text and copy it to the clipboard by invoking Control-Ins. In Smalled a copy operation is limited to 64Kb. So if you select more then 64 Kb of text and try to copy it to the clipboard an error message is displayed and the copy action will be discarded! This limitation isn't operartional if text is copied by invoking a drag-n-drop operation. Through Drag-n-drop you can copy any amount of text in a document or between documents. So Drag and Drop doesn't have the 64 Kb limit. ═══ 4.4.6. Paste ═══ Paste copies the data from the Clipboard (if there is any) to the current cursor position in the main window . If any text is currently selected, it will be deleted and replaced by the contents of the clipboard. If you want to perform a paste in a dialog window, use Shift-Ins. The amount of text that smalled can paste is limited to 64Kb. If you try to paste more then 64 Kb of text, Smalled will give an error message and the paste operation is discarded. This limitation isn't there when Drag-n-drop is used. ═══ 4.4.7. Clear ═══ Clear deletes the currently selected text. The same effect can be invoked by using the del key. A clear can be undone by Undo. ═══ 4.4.8. Find ═══ If Find is invoked the following dialog will show In the find dialog a find item can be entered with the maximum length of 64 characters. If the find button is hit, a search will be conducted through the text. This search can be tailored by the three check boxes on the dialog.  Global. Normally the search will be conducted from the current cursor position. If Global is checked the search will be conducted from the top of the document (or the bottom is back is checked).  Back. The search will be conducted backwards. Find again will also work in a backwards maner.  Case sensitive. Normally the search is case insensitive. By checking this box it is made case sensitive. As the search is conducrted ans a match is found, it will be hilited (selected). If no matching item is found, a message is displayed. If a find is invoked, Smalled will also set a so-called jumppoint. This enables you to return quickly to the point from where the find was invoked. If an item is found, the find dialog will dissapear. If the entered item has to be searched again, it's possible to invoke the Find option again. Although a simpler aproach is to use the Find again option. It is possible to move the find dialog around. Everytime this dialog is invoked, it will look at the settings you set through Preferences. If the Use last Find-dialog position was checked, the last position will be used to display the dialog. If this setting was not checked, the dialog will be displayed relative to the mouse-pointer. So you can position the dialog in the place you find the most conveniant. Besides the position, the dialog will also remember the last entered search item. ═══ 4.4.9. Find Again ═══ Find again option can only be used if the find action has been invoked at least once. If find has been invoked, the search-text is preserved. Find again will use this search-text. Find again will conduct a non-casesensitive search from the current cursor position until the end off the file or until a matching item is found. If a match is found, it will be hilited (selected). If no match is found, an error message will be displayed. If back has been checkec in the find dialog, the find again action will be conducted backwards (from bottom to top). If Find again is invoked, Smalled will reset the jumppoint.This enables you to return quickly to the point from where the last Find (again) was invoked. ═══ 4.4.10. Replace ═══ The replace dialog can be used to replace textbits in the current Smalled session. If Replace is activated the following dialog will show. In the replace dialog, a target string and a replacement string can be entered. With these strings, several actions can be started.  Next: if an item has already been found and selected, Next will try to find the next match from the cursor on down. If a match has been selected, Next will leave it alone and will try to find the next match.  Replace: if no item has yet been found, the replace action will first locate a possible match and select it. This match isn't replaced yet. If replace is hit again, the selected match will be replaced and Smalled will try to locate the next match from the cursor on down.  All: All will replace all matches from the cursor on down, without prompting the user.  Cancel: cancels the replace action and closes the replace dialog. If no replacement string is entered and the replace action is started, the target string is deleted (when found). The search action the replace dialog conducts, works just like find. (In fact it uses the same code.) So the way it handles replaces can be modified in the same way Find actions can be modified.  Global. Normally the search/replace will be conducted from the current cursor position. If Global is checked the search will be conducted from the top of the document (or the bottom is back is checked).  Back. The search/replace will be conducted backwards. (Bottom to top)  Case sensitive. Normally the search is case insensitive. By checking this box it is made case sensitive. The replace dialog will remember the place it is dragged to, so the next time replace is invoked, the dialog will check the settings in Preferences. If the Use last Rplace-dialog position is checked, the dialog will open at the last used position, if it isn't checked, the dialog will appear relative to the mouse-pointer. This enables you to put the replace dialog in a spot you find the most conveniant. This position will be remembered through sessions. Besides remembering the dialog window place, the target and replacement strings are also remebered (although not between sessions). Replace also sets a jumppoint. So by invoking CTRL-J, the cursor will jump to the last point the cursor was before the replace. ═══ 4.4.11. Select all ═══ Select all will make a selection of all the text entered in Smalled. Don't use this option if you want to delete all text in a large file. This takes a lot of time because the complete file contents will be transfered into the undo buffer! Better and faster is to use the New option from the File menu. ═══ 4.4.12. Deselect all ═══ Deselect all will undo the current text selection. There are two horkey's assigned to this function, The standard OS/2 Ctrl-\ and (more convenient) the ESC key. ═══ 4.4.13. Goto line ═══ There are several ways to go to a specific line. You may use the Goto Line option of the Edit menu or the CTRL-G hot-key to activate the goto line dialog. Besides that, Goto again may also be invoked from the popup-menu if it is configured that way. This dialog can be handled through use of the keyboard or by using the mouse. You may use the up - and down arrow keys to scroll to all the possible line nr's (it automaticly switches between 1 and the maximum linenr and vice versa). It's also possible to click with the mouse on the arrows displayed with the spinbutton. If a goto is invoked, the jumppoint will be reset to the current line before the jump, so that with a stroke of CTRL-J the cursor returns to the last point before goto was invoked. Another (easy) way to change the current line, is to invoke active vertical scrolling . You can grab the vertical scrollbar with the mouse and drag it. The text will then scroll, meanwhile the linenumber of the topmost line will be displayed in the statusbar. ═══ 4.4.14. Jumppoint ═══ Smalled knows a so-called jumppoint. A jumppoint can be used for fast switching between two points in the text. If a file is opened, Smalled will look if it is a file previously saved with Smalled. If this is the case, Smalled will restore the last cursor position. At that moment, the jumppoint is initialized with a 1. If the jumppoint hotkey CTRL-J is pressed, the cursor will jump to line 1 and the corsor position from where the jump took off is saved as the next jumppoint. So if CTRL-J is pressed again, the cursor will return to the place before the jump and the jumppoint is set again to the linenr from where the jump took off. Setting Jumppoints : a jumppoint can be set by invoking a jumppoint. If CTRL-J is pressed, the cursor position from where the jump took off will be the next jumppoint. Find and replace will also set jumppoints. If a find/replace is invoked and the cursor moves to a find match, the place from where the find was invoked is stored as a jumppoint. So pressing CTRL-J will return to the place before the jumppoint. Note that the next jumppoint is the place where find found a match! A jumppoint is also set as goto is invoked. The cursorpoint from where goto took off, is set as jumppoint. ═══ 4.5. The Options menu ═══ The options menu contains items with which the working mode of Smalled can be changed.  Set font  Tab set  Wrap  Indent  Use defaults  Toggle toolbar  Toggle statusbar  Text info  Preferences ═══ 4.5.1. Set font ═══ Set font will start the Standard font dialog. Through this dialog a font can be set as current font. If a font is selected, this will be displayed in the statusbar. You can also activate the conditional cascade after this menu-item. This will give you the extra choice of activating the default or the alternate font as they are set in the text preferences page. A more elegant way is to use Drag-n-Drop. By opening the font palette in the system setup folder, you can select a font and drop it on the edit area. Smalled will change the current font to the dropped font. The new font will be displayed in the statusbar. If the file is saved, this font will be remembered when the file is reopened or retrieved. This way of setting a font can also be appleid to menu's and the statusbar. ═══ 4.5.2. Use default font ═══ If Use default font is selected, the font set as default font in the text preferences page. will be retrieved from the OS2.INI file and activated. This font change is confirmed in the statusbar. ═══ 4.5.3. Use Alternate font ═══ If Use Alternate font is selected, the font set as Alternate font in the text preferences page. will be retrieved from the OS2.INI file and activated. This font change is confirmed in the statusbar. ═══ 4.5.4. tab set ═══ If the Tab set option from the options menu is activated, a dialog will be displayed. In this dialog, the new tabsize in mm can be entered or the tabsize can be restored to the default value. There are two prossible choices possible for tabs, A tab key can generate a tab character, or a number of spaces. If the spaces option is choosen, Smalled will intelligently apply these spaces. For example if the current position is 14 and the space tabsize is 10, Smalled will add 6 spaces. The tab setting used in the edit area will also be used while printing. Besides that it will be saved in EA's of the file when the file is saved. This includes the setting for spaces or tabs and the size for both of them. A document can be set to spaces-tabs, but still contain tab characters. If this is the case the setting in mm for the tabs will be used. The defaults used by the tab dialog can be set in the text preferences ═══ 4.5.5. Wrap ═══ Smalled supports Word-wrap and Line-wrap which can be controlled through the Wrap submenu or by the Statusbar Wrap-popup. By using the Wrap option in the Options menu, the Wrap-toggle button or Ctrl-W, the wrap status will toggle. This will be reflected in the wrap-area of the statusbar. Word-wrap mode (W-Wrap) will wrap the lines that exceed the width of the edit area. window to the next line. Resizing the window will cause a reordering of the text. Word-wrap doesn't add any (newline) characters to the text. Word wrap can be used to set the page width for a print job. If word wrap is turned on, the print routine will calculate the line width and use it while printing. Line-wrap mode (L-Wrap) will automaticly insert a character when a certain linelength is reached. The linelength that is used can be set to a default value with the text-preferences page. If a different value needed in the current document, it can be set by using the Set linelength dialog. If the Line-wrap mode is turned on, the current document won't be reflowed! The Linewrap mode only applies to the current line and will be active when typing in text. If you like to reformat the document or parts of it, use the text-formatting tools. The Wrap submenu is almost identical to the statusbar-wrap-area popup. These menu's contain the following items:  Toggle wrap (submenu only).  Wrap off.  Line-wrap.  Word-wrap.  Default wrap.  Set linelength The Toggle wrap has the effect as using the menuitem wrap in Options without using the submenu arrow. It toggles to the next wrap state (Wrap off, L-Wrap, W-Wrap).on, the setting from the text-preferences will be used. The default setting for wrap can be set using the Text preferences. The default will be used if a new file is created or a file with no smalled ea's attached is loaded. Besides that, the Wrap setting (as well as the linelength) used in a document will be stored in the file ea's when a document is saved. ═══ 4.5.6. Linelength dialog ═══ The Linelength dialog can be activated through the wrap submenu or through the statusbar-wrap popup menu. Through this dialog, the linelength currently used for a document can be changed. This will affect the following parts of Smallled that rely on the linelength setting :  Line-wrap (if on).  the settings in the Text-formatting-dialog.  Action taken by Reflow.  Action taken by Linebreak. The length set in this dialog will be saved in the ea's of a file when the document is saved. ═══ 4.5.7. Indent ═══ Smalled features an automatic indent options which can be toggled on/off. You may use the menu , toolbar or statusbar popup to toggle this setting. The statusbar will show the indent state for the current document. Indenting inserts spaces or tab characters after a character is inserted and so aligning it with the previous line. To do this the indent characters are taken from the previous line. Indenting is fully compatible with the Line-wrap mode This means that if a line is indented and the Line-wrap mode will invoke a , Smalled will advance on to the next line and add an indent. Indenting is not campatible with Word-Wrap. The reason for this is that Word-Wrap does not insert characters in the text. The Indent submenu and the indent statusbar popup contain (almost) the same features:  Toggle indent (Indent submenu only)  Indent on.  Indent off.  Default. The Toggle indent has the effect as using the menuitem indent in Options without using the submenu arrow. It toggles indent state. The on or off item will be checked to show if indent is currently active. By activating the default option, the setting from the text-preferences will be used. The default setting for indent can be set using the Text preferences.. The default will be used if a new file is created or a file with no smalled ea's attached is loaded. The settings for the indent state will be stored in the file's ea's when a document is saved. ═══ 4.5.8. Use defaults ═══ Smalled uses a number of settings regarding the way text is handled. They are set using the Text preferences With the Use defaults menu option all the settings as set in the text prefrences are being set for the current document. This means the Tab, Wrap, Indent and Font settings will be set to default. Any previous settings will be lost. ═══ 4.5.9. Toolbar Toggle ═══ The toolbar can be toggled on and off in Smalled. This can be done by the toolbar menu option in the Options menu or by hitting the CTRL-= Hotkey. To change the default visibility of the toolbar use the Toolbar preference page. ═══ 4.5.10. Statusbar ═══ The statusbar can be toggled on and of by the Statusbar item in the options menu. To change the default visibility of the statusbar use the Statusbar preference page. ═══ 4.5.11. Text info ═══ Text info supplies the user with some information about the text currently loaded. Text info will display the number of characters and the font currently used in the statusbar. It also shows the number of words in the current text. If a selection is active, the number of words in the selection will show. ═══ 4.5.12. Preferences ═══ The Smalled preferences are organized in a notebook in which each page handles a certain cluster of items. If a change is made in one of the settings displayed in this notebook, these changes will take effect immediatly. This means the settings for the current document will be changed!. The Smalled preferences notebook has the following pages:  General  Backup  Text  Toolbar  Popup  Statusbar  Windows  Print  Colors  Dialogs  Default dirs  Tools If the dialog is closed, the page that is on top will be remebered and will be the default page the next time the preferences dialog is opened. The accelerator keys Smalled uses can also be edited. This can't be done through the preferences pages, but is done interactive through the Accelerator editor. This editor is started by holding down the ALT key while selecting a menu item. Changes will be saved and shown in the menu's. ═══ 4.5.12.1. General preferences ═══ The general area contains four logical area's. General  Exit button: This creates an X button in the titlebar next to the max-min buttons. This is a very convenient button, however if you're using utilities like Xit or NPSWPS or if you're using Warp 4.0, this button is unnesecary. Open/New behaviour  Open/New behaviour In this section the action taken on open and new can be modified. If these buttons are checked, New and open will start a new Smalled session. So the current document won't be moved from the current session. Open only starts a new session if the current Smalled session is filled and if a file is selected. Drag-n-Drop behaviour.  Use Smalled drag-n-drop: It is possible to partly deactivate Smalled's d&d interface. If this button is flagged, the full d&d interace of Smalled will be active. If this isn't checked, the d&d interface for the main edit window is turned of. Drag-n-drop from the titlebar-icon will still work. Use this option if you prefer the DragText utility for handling the d&d for Smalled's main window or if you don't want to use drag-n-drop.  Original filename on save This option makes sure the filename of the document currently being edited is used when a save is performed through Drag-n-Drop. If this isn't checked, the system default (data file) will be used as name. EA's  Load cursor position: Smalled saves the cursor-position when a document is saved. If this checkbox is flagged, this position is restored when a file is opened.  Load/save file settings Smalled will save a number of document attributes in the Extended attributes attached to the documents file. If this option is checked the attributes are saved. This means a slightly longer load time for FAT drives. In case of HPFS drives this shouldn't make any difference in load time. If this option isn't checked, no document info is saved or loaded. This means the documents are always displayed with the defaults set in the Text preferences. Saved are: - Font. - Wrap mode. - Indent mode. - Linelength. - Tabsize. - Cursorposition. The attributes saved in a files ea's can be viewed with the File information option from the File menu. ═══ 4.5.12.2. Backup preferences ═══ Backup Preferences let you customize the complete handling of all kinds of backups Smalled supports. Smalled creates backups that are numbered with extensions from B01 to B99. The original extension will be lost. For Smalled to be able to make these backups, a backup directory has to be assigned in the Backup directory section. If no name is entered, or an invalid name, no backup is made. If a backup has to be made in the directory the original resides in, simply add a . (dot) in the backup directory entryfield. (Although for maintenance purposes this isn't the ideal solution. A directory can be entered manually or by using the directory selector. by pressing the small folder button after the entryfield. Smalled can create Backups in several cases:  When the backup command is given  On opening of the file (check backup on fileopen).  When an autosave is executed (check backup on autosave). This will make a backup of the file before it is saved by autosave. This way a roll back system can be created. Autosave will set the default for the autosave behaviour. If on, every document will be automaticly saved after the given number of changes. (Autosave can be togled when you're working on a document.) Autosave will overwrite the original file you're working on! If you want to secure this file, use backup on autosave. Smalled features a separate shred function for the file you're currently working on. As an extra on this function you can copy the file you're removing to a shred-backup directory. If you want this, fill the shred-directory with a valid directory name and click the checkbox. ═══ 4.5.12.3. text preferences ═══ Text Preferences are use to set the default values for the attributes used for text display and handling. The default values are used when:  New is invoked  Smalled is opened without a file  The load/save file setting isn't checked (General preferences)  A file without Smalled ea's is opened Note that every file can have it's own settings for most of the options in this page. They will be saved in the files extended attributes Fonts. Smalled can handle two default fonts which can be switched quickly. (Note that every file can have and remember every possible font of your choice!). To change the fonts click on the buttons labeled 1 or 2. The font under 1 is the default font that is used when a new file is opened. The font under 2 is an alternate font. These fonts can be recalled quicly by using the Default font and Alternate font menu-options. Wrap controls the default wrap mode as described in Wrap The Linelength will be used by L-warp and by some text-formatting tools. Indent controls the default Indent behaviour. (On or off.) Tab controls the way Smalled default handles tab characters. You can set the size a tab character can have in mm, or you can instruct Smalled to use a number of spaces for a tab character. See also the tab dialog for more info on tabs. ═══ 4.5.12.4. Toolbar preferences ═══ Smalled contains a fully configurable toolbar which can be modified in the toolbar preference page. Every change that is made will be effective immediately. This means that if a button is added or removed, the toolbar will instantly change. Listbox: The largest part of this page is filled by a listbox in which all the possible toolbar entries are mentioned. If an entry is selected, the button will appear in the toobar, if it is deselected, it will be removed from the toolbar. The empty spaces between logical groups of buttons are marked as [Empty space] and can also be added or removed. Toolbar: If desired the toolbar can also be turned off. If this chackbox is flagged, the toolbar will be visible, if it is deselected the toolbar will instantly disappear. Bubble help: The Bubble help can be turned of by default. This can also be done by double clicking the right mouse button on the toolbar. By also checking the Delayed button, the help bubble becomes a delayed help bubble. This means you've got to hold your pointer above a button for +- 0.7 seconds before a bubble appears. Compact: This switch is used to make the toolbar more compact in size. The buttons will move closer together. This gives small screens the upportunity to show more buttons. Besides that You may also like it better than the normal toolbar. ═══ 4.5.12.5. Popup preferences ═══ Smalled contains a configurable context popup menu. Items: The popup area contains items that can be added to the context popup. It works in the same fashion as the toolbar preferences, just select the popup items you want in the listbox. The context popup will always contain the cut, clear, copy and paste items. Besides that it is context sensitive. The items that need a selection to be active, will only appear in the popup when a selection is active. The changes made for the popup will take effect immediately. The popup will appear if the Right Mouse Button is pressed (if this isn't changed in the OS/2 settings) while the mousepointer is over the editarea or the main-message area of the Statusbar. ═══ 4.5.12.6. Statusbar preferences ═══ Smalled contains a configurable toolbar since version 1.40. In this preferences page the areas that will show in the statusbar can be set. The Statusbar can also be turned on and of. If you want to change the color or the font of the Statusbar, simply use Drag-n-Drop of a color or a font. Statusbar: This switch turnes the statusbar on and off. This can also be done with the statusbar switch in the options menu. Use icons in statusbar: This determines how the Wrap, Indent, autosave and changed area's are displayed. If this is checked, icons are used instead of text for these markers. Fields: This area contains four fields in the statusbar that can be toggled. The main message area will always be on. If the Wrap, Indent and changed/autosave area's are turned of, the popups attached to these area's can't be invoked. The main-popup can always be invoked from the main-message-area. ═══ 4.5.12.7. window preferences ═══ The window preferences control the way multiple Smalled windows will behave. Window behavior:  Auto-cascade controls the behavior of the Smalled main window when more Smalled instances are opened (see also New Smalled session and starting more Smalled instances). When the autocascade button is checked, new Smalled windows will be shown cascaded on the desktop. If the autocascade button is of, Smalled instances will be show over each other (handy for users with small screens).  User window save turns automatic window save on exit off. This means, the last window position, the dropped on colors and fonts won't be saved. They will be when the menu item ***Save Window*** is activated. This way you can set the place and size your first Smalled window will always open. Keep desktop free for...: This area in the dialog has a set of spinbuttons that define area's on the desktop on which Smalled windows aren't drawn after a Tile, cascade, tall and wide actions. This way you can for example keep Smalled away from the WarpCenter or keep a strip with icons free. ═══ 4.5.12.8. print preferences ═══ The print preferences control the way a Smalled print out will look. The dialog contains 4 areas.  Header/Footer: The header and footer area controls the way the Header and footer area's are drawn on the printed text. The room the header and footer occupy is taken from the text area. So if it's turned of, the header and footer area's can be filled with text. The header and footers can have the following styles: - None: No header/Footer will be drawn. (Even if a pageno etc is checked) - Line: A line is drawn under/above the header/footer information - Box: A box is drawn around the header/footer information. - Grayed box: This is the sane as box, but the box is now filled with a gray background.  Margins This area defines the margins of the print area. The print is cut to the right margin. So everything exceeding this area isn't printed (future versions will see a function reflow to print area's so that text will be printed inside the given margins.)  Stamps This area defines the contents of the header and footer area. - Page no.: Prints the page number. This is always aligned right to the page margin. - Filename: Prints the current filename (always aligned left) - Time: Prints the time of printing (always aligned left) - Date: Prints the date of printing (always aligned left) ═══ 4.5.12.9. color preferences ═══ The color preferences control the for and background colors used by Smalled. Note. In Merlin (Warp 4) Smalled supports and remembers 256 color drops. This means you can change the background color to any color you like when wrap 4 is used by simply using a color drop. In this dialogbox two areas with colored squares are displayed. The left area controls the forground color (text), the right area controls the background color. By single clicking on one of the colored squares, the color of the sample underneath the colored areas will change to the selected color. If Set is clicked, the choosen color combination will be made current in smalled. Besides that the selected color setting will be saved in the OS/2 INI file and become the default color for the next sessions. The colors used in this color dialog are the 16 standard solid colors (first 16 squares). The other nine colors depend on the setting of the system colors on your machine. If these colors are changed (use scheme palettes), the colors in this dialog as well the edit area may change. The next nine colors in the color dialog map to the following system colors. 1 Window background 2 Active titlebar 3 Desktop 4 Active window border 5 Standard MLE background 6 Standard text color 7 Help background 8 Help highlight 9 Neutral color (Text) You may also change the colors of smalled by dropping colors on the smalled window. Every part of the smalled window (title, statusbar, menu etc.)can be changed using 256 colors. These colors will also be saved as default. The main edit area however accepts only 16 basic solid colors in Warp 3.0 and lower. Besides that dropping a color on the edit area will have the same effect as applying a color. ═══ 4.5.12.10. Dialogs preferences ═══ Smalled can save the last position of the find and replace dialogs. If the checkboxes are on, the find and replace dialogs will appear at the last used position. If the check-boxes are off, the dialogs appear relative to the mouse-pointer. In this case, starting a find or replace dialog from the main-menu, the popup or the toolbar will all result in different positions on the screen. The open and the font dialog. are a different story. If a font or open dialog is dragged, the position will be remembered during the session. If Smalled is closed and opened again, the position of these dialogs will again be the left lower corner of the screen. If the chackboxes for these dialogs are set, the position will be remembered through sessions. ═══ 4.5.12.11. Set default dir ═══ Smalled features four default directories that are used by the file-dialog. This dialog is used for opening or saving files. In this dialog a choice can be made of one of the directories. The radiobutton in front of the default directories will determine the directory that is used when the file-dialog is opened. The directories can be entered by hand, or can be quickly selected by pressing the directory button after the entryfields. This button will start the directory selector. ═══ 4.5.12.12. Tools ═══ In the tools section directories can be given for the tools that can be started from within Smalled. If no path is entered, Smalled will think that all the given tools can be found in the current path. A path can be entered manually or by using the directory selector. Note that SMEHTM has to be able to find it's DLL. If it can't find it, it won't start and Smalled will show an error. Refer to the SMEHTM help for more information. ═══ 4.5.12.13. Directory selector ═══ The preferences pages for tools, default directories and Backup contain a button with a folder on it. With this button, the directory selector can be started. This dialog will switch to the directory mentioned in the entryfield and features an easy way to select a directory. To switch to a directory, select this from the the listbox. To switch from drive, select a drive from the drive selector. Cancel shuts-down the dialog without transfering the selected directory to the preference page. OK does transfer the choosen directory to the preference page. ═══ 4.6. The Tools menu ═══ The tools menu contains a number of utilities that can format the text currently selected in a large number of ways. Besides that a number of bolt-ons can be lauched through this menu.  To upper.  To lower.  Wordcount.  Text format.  Stamps.  Strip HTML.  Smalled HTML Extensions.  Smalled clipboard extensions  Smalled floater ═══ 4.6.1. To upper ═══ This menu option performs an uppercase conversion for the selected text. This action can be undone if the selected text doesn't exceed 64 Kb. ═══ 4.6.2. To Lower ═══ This menu option performs an lowercase conversion for the selected text. This action can be undone if the selected text doesn't exceed 64 Kb. ═══ 4.6.3. WordCount ═══ Worcount counts the words in the selected text. If no text is selected, wordcount will count the words for the full document. The result will be displayed in the statusbar .br The Smalled wordcount function takes the following characters as word separators: - . , ( ) < > \ / ! = + By using these chars as separators you might get another count from Smalled than from other editors or wordprocessors because they might use other word-separators. Note: Wordcount is also invoked by Textinformation. ═══ 4.6.4. Text-format ═══ Text-formatting utilities are a set of actions grouped in a programmable dialog, but which can also be used seperatly. These tools make it possible to reformat selected parts in a document in a large number of ways. Textformatting contains 9 different formatting tools. All these are accesable as single action or in combinations of your choice. To use combinations, use the Text-format dialog. It's also possible to create formatting styles through the text-format-dialog. This dialog gives you the possibility to create 4 custom styles which are available in the Text-format submenu.  Text format dialog.  Reflow.  Linebreak.  Remove CR.  Remove tabs/sp.  Insert Indents/Unindent.  Style 1... Style 4 Style 1 .... Style 4 can be programmed in the text format dialog. See programming the styles for more information. If a reformatting action is imvoked on a selected text part smalled then 48 Kb the action can be undo by using UNDO ═══ 4.6.4.1. Text-format dialog ═══ The textformatting dialog contains 9 tools that can be used in one action to reformat the selected text. The dialog is build around three different groups that perform distinctive tasks during reformatting. To perform a function on the selected text, you've got to check this function and hit OK. It is advised to experiment with this dialog to understand it's power. On the bottom of the dialog a set of extra buttons is added. These can be used to preprogram the textformatting styles. The text-format functions are intelligent enough to be combined. Smalled will handle them in a sequence that will secure a problemless reflow of text. At the end of this page the precedence of the several format options is mentioned. Reflow text. This group contains the items that will reflow the selected text.  Remove Returns: This function will remove all the single characters from the selected text. If a double is encountered, they will be left alone. This way paragraphs will be preserved when performing this action. This function can a.o. be used to convert a line-wrapped document to a word-wrapped document.  Remove multiple spaces/tabs This function removes all multiple spaces and tabs or combinations and replaces it with a space or a tab (whatever is last in the replaced block).  Indent This function will indent the selected text with the indent shown in the first line of the selected text. So for this function to work you first have to indent a line and then select and proces it.  Unindent is the opposite of indent. You can select either Indent or unindent. Unindent Will unindent the selected text. For this it calculates the unindent text from the first line in the selection. So if the first line in the selection starts with 10 spaces and only 4 of the, are selected, the whole selected block will be unindented by 4 spaces. So besides doing full indents (select the whole first line) it's also possible to do partial unindents.  Linebreak at: This function searches for the last tab or space within the given linelength and replaces this with a . if there is no space or tab within the given scope, the is entered on the exact position given in the dialog. Text This group has two entries that actually modify the text. It will probably see most of it's use by formatting mail text.  Remove at linestart This removes a string of characters that is currently showing at the start of the selected lines. In most cases this will be used to remove mail markers like >.  Insert at linestart This inserts a new 'flag' at the linestart. This insertion will be performaed after the text is formatted (although for linebreak the length of the insertion string is included). Just like the previous function, this one will most likely be used in mail formatting. Tabs The two entries in this group will perform a conversion from tabs to spaces and vice versa. Both obtions are mutually exclusive.  Tabs to spaces This option converts a tab to a given number spaces.  Spaces to tabs This option converts a given number of spaces to one tab character. Performing a text-format with several options checked has a certain intelligence. Smalled will perform these functions with a certain precedence and exclude functions if they are impossible to perform. (For example an indent that's bigger than the linelength for a linebreak.) Besides that the linebreak will recalculate the linelength according to indents and insert at linestart etc. Smalled will perform the formatting functions with the following presedence.  Unindent  Remove Multiple spaces/tabs  Remove at linestart  Remove CR  Tab to spaces (indent will stay intact)  spaces to Tab (indent will stay intact)  Linebreak  Insert chars at linestart  Insert indents The textformatting dialog also has some intelligence in handling the input. You don't have to check the checkboxes for insert/remove. They are automaticly set when text is entered. If the field is emptied, the checkboxes are automaticly undone. The same kind of behaviour is added for the tab-space conversion section. On the bottom of the dialog a set of extra buttons is added. These can be used to program the textformmatting styles. See programming the styles for more information. ═══ 4.6.4.2. Programming the styles ═══ Smalled features four preprogrammable text formatting styles. A style is a combination of tools filled in in the textformatting dialog. This way you can reformat text with just a single action. To create a style, call the textformat dialog and fill in the formatting tools as you would like them for a particular style. Next select a number from 1...4 from the spinbutton. This will define the slot (Style 1... Style 4) in which this combination is saved. Press save to save the current combination. If you like to add an optional name to your styles, fill it in, in style name the entrybox. After saving the style, the name will be used in the tools->textformat menu. Style can be easily changed. To do this call up the textformat dialog and press one of the buttons 1..4 on the bottom of the dialog. This will recall the style settings saved. You can modify the settings or the name and save it again. ═══ 4.6.4.3. Reflow ═══ Reflow can only be invoked if there is a text selection active. Reflow Will invoke all the formatting options in the reflow text group of the The Text format dialog. This means the functions, Remove CR, Remove multiple tabs/spaces, Linebreak and insert indent will be performad at once. As linelength the current linelength will be used. ═══ 4.6.4.4. Linebreak ═══ Linebreak can only be invoked if there is a text selection active. It can be activated by the Linebreak option from the text-format submenu or by pressing the Ctrl-L hot-key. Linebreak will enter characters at the linelength for the current document. This linelength can be changed by using the Linelength dialog.. ═══ 4.6.4.5. Remove CR ═══ Remove CR can only be invoked if there is a text selection active. It can be activated from the Text-format submenu or by pressing the Ctrl-Backspace hot-key. Remove CR will remove the (return) characters from the selected text. If a double is encountered, it will be left in place. This way Paragraph's are preserved. ═══ 4.6.4.6. Remove Tabs/Sp ═══ Remove Tabs/Sp can only be invoked if there is a text selection active. It can be invoked through the Text-format submenu or by pressing the Ctrl-Space hotkey. Remove tabs/sp removes all multiple spaces and tabs or combinations and replaces it with a space or a tab (whatever is last in the replaced block). ═══ 4.6.4.7. Insert indents ═══ Indenting or unindenting can only be invoked if there is a text selection active. Indent will insert indents in the selected text with the indent shown in the first line of the selected text. So for this function to work you first have to indent a line and then select and proces it. Only the selected part of the indent text will be used to indent the selection. So if the first line is indented by 2 tabs and only 1 of them is selected, the selected text get's indented by one tab. Unindent is the opposite of indent. You can select either Indent or unindent. Unindent Will unindent the selected text. For this it calculates the unindent text from the first line in the selection. So if the first line in the selection starts with 10 spaces and only 4 of the, are selected, the whole selected block will be unindented by 4 spaces. So besides doing full indents (select the whole first line) it's also possible to do partial unindents. ═══ 4.6.4.8. Style 1 ... Style 4 ═══ Smalled enables you to create your own text-formatting styles. Four styles can be stored. These are known as style 1... Style 4 when no name is given to them. Before these styles work they have to be programmed. See programming the styles and Textfomatting for more information. ═══ 4.6.5. Stamps ═══ Stamps are a quick way to insert date, time and filename information into your document. Smalled will use the format preferences for time and date as you set them for your desktop. ═══ 4.6.6. Strip HTML ═══ This function will strip all HTML code from the entire text. If a selection is active, only the selected text is stripped. This action can be undone by using Undo . Besides the fact that all HTML codes between < > are stripped, the codes like &aUmlaut. are also stripped. The unaccented letter is showed inplace of the &xxx. ═══ 4.6.7. Smalled HTML Extensions ═══ This options starts a separate product that can work together with Smalled and which is used to create HTML documents. By the time of the release of this version of Smalled (1.40) the 1.00 version of the Smalled HTML extensions is already out there. It can be fetched as SMEHTM10.ZIP from Hobbes or the BMT sites. If you register Smalled, SMEHTM can be registered for only an additional $7. This means that Smalled +SMEHTM will cost $25. (More about the Smalled HTML Extensions can be found in the Other Bianchi software products section of this help.) BTW. For those of you who've already registered SMEHTM (thanks), the registration codes will change with the next release of SMEHTM. This because some asshole cracked the SMEHTM registration codes and is distributing them freely over Russian BBSes. I don't know why he finds this $7 application important enough to crack. I loath this kind of piracy (It will kill inexpensive shareware) and and I see no other way to fight it than to bother you with a redistribution of new codes, sorry for this Eric ═══ 4.6.8. Smalled Clipboard Extensions ═══ The Smalled clipboard extensions are a separate Bianchi software product. But it is distributed with Smalled. If your a registered Smalled user, you're also a registers Clipboard extensions user. The Smalled clipboard extensions give you 10 virtual clipboards to store text in. It's great for remembering stuff when programming or writing Web pages. (More about the Smalled Clipboard Extensions can be found in the Other Bianchi software products section of this help.) ═══ 4.6.9. Smalled floater ═══ Smalled features a small separate program that functions as a floating toolbar. This floater can be started from within Smalled. The Smalled floater is configurable and can work with multiple Smalled sessions. It simply acts on the one on top. The floater is an alternative for the toolbar, with as extra that it can start a Smalled session on it's own. ═══ 4.7. The windows menu ═══ It is possible to have more than one Smalled session active. Better yet, Smalled is created to have more than one session active. You can drag-n-drop between Smalled sessions and there are a number of ways to start new Smalled sessions from Smalled (see also multiple Smalled instances). The windows menu contains items that will handle multiple Smalled sessions for you, or handle other window related things.  Tile.  Cascade.  Tall.  Wide.  Next.  Previous.  Close all.  Save-n-exit all.  Restore minimized.  New smalled session.  Save window. The way a number of items in this menu work can be modified in the window preferences page of the Smalled preferences. ═══ 4.7.1. Tile ═══ Tile will tile the Smalled sessions, that are not minimized, on the desktop. Smalled will use the whole desktop exept for the free area's defined in the window preferences page. Tile will only work if there is more than one Smalled session open. ═══ 4.7.2. Cascade ═══ Cascade performs a cascade action with all the open Smalled windows that are not minimized. The active Smalled window will end up on top. While cascading the Smalled windows, the free area's defined in the window preferences page are honored. ═══ 4.7.3. Tall ═══ Tall stretches the current Smalled window verically so that the height of the Smalled window is maximal for your screen. Tall is a toggle, so a window can also be untalled by wich it gets it's original heigth back. Tall will honor the top and bottom free area's defined in the window preferences page. ═══ 4.7.4. Wide ═══ Wide stretches the current Smalled window horizontally so that the width of the Smalled window is maximal for your screen. Wide is a toggle, so a window can also be unwided by wich it gets it's original width back. Wide will honor the left and rigth free area's defined in the window preferences page. ═══ 4.7.5. Next ═══ Next selects the next Smalled window in the Z-order. ═══ 4.7.6. Previous ═══ Previous selects the previous Smalled window in the Z-order. ═══ 4.7.7. Close all ═══ Close all invokes an exit in all smalled sessions. This will cause all Smalled sessions to close. If one of these sessions contains a chenged file that isn't saved yet, that session will be brought to the top. You can decide to save the file, abort the close action for that Smalled instance, or to discard the changes and close the session. ═══ 4.7.8. Save-n-Exit all ═══ Save-n-Exit all saves the contents of all open Smalled sessions and closes them. If a session contains an untitled.fil (non saved contents), that session will be brought to the top and you will be asked a name for this file, or to discard the changes. ═══ 4.7.9. Restore minimized ═══ Restore minimized restores all the minimized Smalled sessions to their original size. ═══ 4.7.10. New Smalled session ═══ It is possible to invoke a new instance from Smalled from the tools menu. The new Smalled instance will be placed directly over the current Smalled session, or it will be cascaded depending on the setting in the general preferences. Smalled will locate it's path automaticly, so the Smalled exe file doesn't have to reside in the Path. There are other ways to start multiple Smalled sessions. (These will also be autocascaded if the checkbox in the general page is checked). See Start multiple Smalled instances for more info about creating a Smalled object. ═══ 4.7.11. Save window ═══ Save window is only availbale when the 'user window save' is checked in the window preferences page. This will cause Smalled not to save all the window settings like size, place and presentation parameters when it is closed. To save these settings you must use Save window. This way you can make sure Smalled always opens on the same spot on your desktop. Note: If you change the color of the edit window, or the statusbar, or change the font of the statusbar or the menubar. You must use save window to preserve these settings if 'user window save' is on. ═══ 4.8. The context popup menu ═══ Smalled has a context sensitive popup menu that will be activated as the mouse button2 is clicked on the edit area or on the main-message area of the statusbar. This popup will contain the most used edit functions, Cut, Paste, Copy and Clear. From these items the popup will show only those items that can be activated. So if text is selected, the popup will at least show the functions Copy, Clear and Cut. If no text is selected, those options won't show. For the paste option the clipboard is checked. If it cantains valid data, the paste options will be displayed. If no popup is showing on a right mouse click, there probably isn't any text selected and the clipboard will be empty. The functionality of the context popup is largely expanded in version 1.00. Since this version a number of actions can be added to the popup. Besides the Copy, Cut, Paste and Clear functions, Open, Save, Save as, copy to, Print, Find, Find again, Replace, Goto and Undo can be added. To set your choice of popup functions, use the Preferences dialog. NOTE: There is a great package to enhance the desktop. It's called NPSWPS (check it out). However since version 1.81 of this package there is an incompatibility with Smalled. Having the NPSWPS Entry Field Menu enabled causes Smalled's context popup to disappear. If you want to use Smalled.s popup instead of NPSWPS's popup, you should disable the Entry File Menu in NPSWPS. This option can be found under the OTHERS tab in the NPSWPS package. Note, the main-popup can always be invoked from the main-message area of the statusbar! ═══ 4.9. Accelerator editor ═══ Smalled has a default set of Accelerator keys (also called hotkeys). to quickly execute the items in the menu's. With the Accelerator editor you can assign any accelerator key combination of your choice to every menuitem Smalled has. The changes made will be saved and shown in the Smalled menu's. To start the Smalled Accelerator editor, hold down the ALT key and click on the menu (or toolbar icon) you like to change. This will start the following dialog: The editor will show the current Accelerator setting for the menu-item that is being edited. If no information is showing in the Accelerator box, no Accelerator key is present for the current menu-item. For the key field you can use any key you like. The accelerator is automaticly created for upper and lowercase characters, So creating an accelerator for CTRL-u and CTRL-U is not neccesary. If you want to use an virtual key (ESC, F1, F2...., INS, Del, Tab, etc.) use the dropdown list attached to the key field to select such a key. If you try to set a key that already exist, A beep will sound and the dialog won't disappear after the SET action. Deleting a key can be done by deleting everything in the Key field and using SET. ═══ 5. Disclaimer ═══ ====DISCLAIMER==== This package is provided "as is", without any guarantees or warrantees whatsoever. Eric Slaats / Bianchi Software are not liable or responsible for any loss or damage of any kind whatsoever, including, but not limited to, losses of a financial, physical, emotional, marital, social, or mental nature that may result from the use or the purported use of anything in this package, for any purpose whatsoever. This product is supplied "as is", and without any warranties. You may distribute this shareware version of Smalled if the following conditions are met:  The distributed archive must contain ONLY the files - OS2_2xx.ZIP -The OS/2 2.x version - WARP.ZIP -The Warp version - SMALLED.HLP -Smalled help file - SMECLP.HLP -Clipboard extensions help file - README.SME -This file - FILE_ID.DIZ -Short description - ORDER.SME -Order form - REGISTER.EXE -Needed to register - REGISTER.HLP -Help for register.exe - PURCHASE.ZIP -(online) registration tool  The contents of this archive are NOT MODIFIED in any way.  This version is not to be sold. However, a reasonable disk copying fee is permitted. ====REGISTERING==== If you like Smalled and want to keep using it after the 40 day trial period, you have to register it. In Smalled's case, this means you've got to buy a registration key. This key will unlock Smalleds Save and print possibilities (which lock up after 40 days). To obtain a registration key you first have to run the register.exe program included in this package. The help in the register program or the readme.sme file will show you how to register your personal key. (See also the ORDER.SME file.) Also included in this package is the purchase.exe program. This program makes it possible to register Smalled online through BMT micro. (Check it out very convenient). Registering Smalled costs $18. You may register by sending the order.sme form by mail to: BMT Micro PO Box 15016 Wilmington, NC 28408 U.S.A. Bianchi Software Tongelresestraat 61 5613 DB Eindhoven The Netherlands Ordering by fax or E-mail (credit card) can only be done by BMT Micro. Enjoy and SUPPORT SHARE/FREEWARE! ═══ 6. About the author ═══ If you feel the need to contact me, send your comments, criticism, wishes, bugs and postcards (keep 'em commin' :) ) to: E. Slaats Bianchi Software Tongelresestraat 61 5613 DB Eindhoven The Netherlands EMAIL Eric.Slaats@wxs.nl Support is also supplied through this E-mail nr. ═══ 7. About Smalled ═══ Smalled is a 32 bit multi-threaded PM applet that is written in Borland C++ 2.0. A must in the development of Smalled was to try to incorporate at least all the goodies OS/2 has to offer. Smalled features:  Toolbar with Bubble-help  Statusbar  Complete Drag-n-Drop support  Clipboard support  INI Support (Saving size, place, Etc.)  EA's (Saving fonts, wrap, indent, tab-size)  WYSIWYG Printing  Multi-threading  ATM support  Context popup Just like other Bianchi Software products, Smalled was created out of a need to learn and because I needed the application I was creating. Initialy Smalled was a spinoff from this process, but it has evolved beyond that. This program is the result of the user reactions I've got on earlier (free) versions of Smalled and on the articles written in EDM/2 about it's development. A lot of people have asked for features and encouraged me to expand this program. It has taken so much out of my spare-time (and other resources) that I've decided to make it (cheap) shareware so some of my expenses may become covered. Most of the programming ins and outs are published in EDM/2. Three articles about buidling an editor version 3-4, 3-6 and 3-9. One article in simple buttonbars (EDM/2 issue 3-8) and bubble-help (issue 3-10). Where building Confed learned me the basics, Smalled learned me how to handle EA's, multi-threaded printing, drag-n-drop and device contexts. Real helpfull were:  Code examples  The DEVCON CD's  EDM/2 magazine (GET IT!)  The HOBBES CD's  (BOOK) The art of OS/2 2.11 C programming  (BOOK) Real world programming for OS/2  (BOOK) OS/2 presentation manager programming ═══ 8. What's new / History ═══ Thanks for all the mail, Please keep the comments comming especially if you discover a bug or want something changed. This Version 1.45 has a lot to thank the Beta testers for. A lot of the improvements were changed according to their suggestions. New/changed New/Changed in Smalled 2.00 (Jan 98)  NEW Full set of windowing functions.  NEW Window preferences.  NEW Print preferences.  NEW Programmable texttools.  NEW Unindent.  NEW Backwards search replace.  NEW Multiple Undo/Redo.  NEW Stamps.  NEW Icons in statusbar.  NEW Extra save-popup on statusbar.  NEW Extra toolbar items.  NEW Floating toolbar.  NEW Smalled Clipboard extensions added.  NEW Extra buttons in Smalled help panel.  NEW Floater and SMECLP can be started from SE.  Improved Autocascade.  Improved printing (D&D).  Improved formatting after HTML strip.  Improved selection handling.  Improved file info dialog.  Improved text selected in Goto.  Improved toolbar code.  Fixed Filestar bug. History New/Changed in Smalled 1.45 (Feb 97)  NEW Accelerator editor  NEW Time delayed bubble  NEW Directory selector  NEW Multiple default directories  NEW /H autostarts SMEHTM  NEW Open/New can Spawn a new Smalled session  NEW Dual font imlementation  NEW Autosave  NEW Init in seperate thread (speeds up startup)  NEW Backup preference page  NEW Backup on autosave  NEW Backup on shred  NEW Backup menuitem  NEW Last used preference page remembered.  NEW 256 color drops in Merlin  NEW realtime space tabs  NEW HTML stripper  NEW Use defaults menu item  NEW Last preference page is remembered  Improved EA's only saved when neccesary  Improved 16 files in history  Improved changed the icon  Improved Popup preference changed  Improved Find dialog stays open after fail.  Improved Warp 4.0 style notebook for preferences New/Changed in Smalled version 1.41 (25 Oct 1996) SUBRELEASE  NEW Main popup on Statusbar message-area  NEW Start New Smalled instance in Tools  NEW Bold and Italic attributes in Font dialog  NEW Autocascade  NEW Shred file  NEW Reload file  Improved Tools interface  Improved Remove Read-only on Backup-files New/Changed in Smalled version 1.40 (sept 1996)  NEW Configurable statusbar with popups  NEW Several textformatting utilities  NEW Auto-indent  NEW Real-time linewrap  NEW Compact toolbar switch  NEW Tools menu  NEW Toolbar and Statusbar toggle  NEW Expanded the popup with textitems  NEW Wordcount  NEW EA toggle  NEW Start SMEHTM from Smalled  NEW Extended the toolbar  NEW Added some new hotkeys  NEW Flashier icon  Improved Preferences (3 new pages)  Improved preferences storage in OS2.INI  Improced File information dialog  Improved Tab settings dialog  Improved Print memory management  Fixed CTRL keys work with Caps-lock  Fixed Wildcard filter in fileopen dialog  Fixed Error in Backup path string Smalled 1.30 5 May 1996  NEW Full support for the Dragtext utility  NEW Toolbar is fully configurable  NEW Preferences notebook with new options  NEW Basic backup utility  NEW Linebreak dialog  NEW Expanded the popup  NEW Save and exit  NEW Deselect (esc Ctrl-\)  NEW Added some new hotkeys  Changed Ctrl-A == Save as  Changed Insert file for Retrieve (Ctrl-I)  Changed Ctrl-C == Copy file to.  Improved Flow in save on exit  Improved Multithreading (semaphores)  Improved d:d (preference switches)  Improved Error handling  Fixed Blackline under toolbar icons  Fixed d:d bug with copy/move  Fixed Bug in handling broken ea's Smalled 1.21 9 April 96  NEW Full drag-n-drop interface for selected and complete text Added are. Move, Copy, Print, Shred, Save  NEW File history in file-dialog  NEW Save selected.  NEW Print selected.  NEW Days left in about dialog.  NEW 40 day lockup only for save.  NEW CTRL-Y = Cut line.  NEW Save as in toolbar.  NEW Drop inserts at drop point  NEW Print and Copy to ... in Popup menu.  Changed CTRL-A to Save as  Improved exe size for warp (70 Kb)  Improved multi-threading.  Improved Print-memory-management.  Minor bugfix in loading files Smalled 1.10 25 Jan 96  NEW copy to file...  NEW File Changed flag in Statusline  NEW Nr of lines in Statusline  NEW File attribs in File info dialog  NEW Tab size in File info dialog  NEW Optional load cursorpos  NEW Optional replace-dialog position  NEW Optional Find-dialog position  NEW Dragtext support  Improved Search in opendialog  30 day lockup only for save and print  Fixed black bubbles in 2.1 Smalled 1.00 1 Jan 96  NEW Jumppoints (CTRL-J)  NEW preferences dialog  NEW Popup configurable  NEW Find updated (global and case sens e.o.)  NEW Replace updated (global and case sens e.o.)  NEW Position save for find and replace  NEW Search function in open dialog  NEW Buttonbar optional  NEW Buttonbar status save (including bubble)  NEW Save bubble status  NEW default setting for tabs remembered  NEW CTRL-P for print  NEW CTRL-N for new  NEW Possible to save empty files  NEW Possible to save unchanged files  NEW Fileopen with nonexisting filename sets filename  Improved font handling (dialog)  Improved FileOpen dialog  Improved Default dir dialog  Improved Bubble-help display  Improved All dialogs got Mnemonics control  Improved memory error message  Improved Flow open dialog  Improved fontsize set doesn't destroy tabsize  Bug fix default select standard printer  Bug fix Fixed alt-backspace  Bug fix not display opendlg if default dir is root Smalled 0.96 October 95  New Exit button in titlebar  New context sensitive popup menu  New Bubble-help  New Undo works for font change  Improved flow in conditional save  Improved memory managent in print  Improved error handling clipboard failures  Smaller code  Change F3 function key to exit  F2 function key for search again  Ctrl +/ added for select all  Bug fix (hanged applet) in Cancel in save on exit  Bug fix in opendialog failure because of no start entries in the INI Smalled 0.95 September 95  New go line dialog  New color change dialog  New active vertical scrolling  New Tab size saved in EA  New Save as dialog on exit if untitled.fil  Bugfix fileopen/filesave with long names  Bugfix Protection against EA screwups  Bugfix in drop color  Changed default dir save (last recently used)  Changed fileinfodlg  Changed default dir dialog (remember last dir)  Changed Retrieve function  Error message on clipboard failure  Ctrl+O Open  Open Icon added Smalled 0.9 August 95  New Set default dir dialog  Bug fixed unable to open situations  Bug fix in set defaults  Bug fix in save on exit  Bug fix in Print  CTRL-F = find  CTRL-A = find again  CTRL-R = replace  Set defaults gives statusbar message  Wrap will be saved as default.  Wrap change gives statusbar message  Change flag on font change  Saves cursor position with each file  Modeles find/replace dialogs.  Improved EA's. access  Shortcut keys in menu's  Info in the options hotkey to I but T  New in buttonbar  Limitations of smalled added in Help file Smalled 0.8 Juli 95 Initial release ═══ 9. Future attractions ═══ Futere attractions.  Document organizer  Mail client  Document converter (word, WP, RTF et  Printer preview  Optional page break display  Optional ruler  Keyboard Macro's  Easy access to рстуф, etc.  Spelling checker  Correct spelling-errors in this help  Find, replace for  Extensions for writing INF (separate program is comming)  Support for comment, history and keyword EA's ═══ 10. Other Bianchi Software products ═══ SMEHTM The Smalled HTML Extensions can be uploaded as SMEHTM11.ZIP from the Hobbes, the BMT Micro and other anonymous OS/2 sites. SMEHTM can work with Smalled, E.exe and other MLE based editors and turn them into dedicated HTML editors. It acts as a small notebook that floats on-top and that can be used to insert HTML tags into the text that is being edited It supports a very large part of the HTML code set. Besides that, a version for INF editing being prepared. Here is a screenshot of the bitmapped pagetags to give an impression. Registering SMEHTM costs 15$. However, if it's registered with Smalled, the total package is 25$. This means a discount of 7$ on SMEHTM. SmeClp The Smalled Clipboard Extensions are an extension to the OS/2 (and Win-OS/2) clipboard. SmeClp will extend the number of switchable clipboards to 10. Every clipboard can be filled using a number of apend modes. Besides that, the clipboard contents are fully editable. In essence it is written as an add on to Smalled. However, it can be used with all Os/2 and Win-OS/2 applications. SmeClp is free for registered Smalled users. If you're not a registered Smalled user,you can register SmeClp seperately for the price of $10. You can get SmeClp as part of the Smalled 2.00 package or separate as SMECLP10.ZIP from the Hobbes, BMTMicro or other anonymous sites. Confed Confed, currently in version 0.8, is a config.sys editor. On the outside it has the same look and feel of Smalled. This application makes editing/creating the config.sys real easy. It features custom edit controls for the config commands, on-line help for the config.sys, and most of the features of Smalled like Multithreading, direct manipulation, button-bar, etc. Check it out. Confedxx.zip can be found on several OS/2 sites like ftp.cdrom.com and Hobbes. ═══ 11. EDM/2 ═══ EDM/2 is a publication by developers for developers and is published by IQPac Inc. EDM/2 is largely the work of three people. Editor-in-chief Larry Salomon Jr., Associate editor Carsten Whimster and Contributing editor Gordon Zeglinski. Besides the columns these three add there are articles written by independent authors. EDM/2 is out there for three years now and is a very high standard publication. For me it was one of the most used sources for example code and explanations while building Smalled and the other OS/2 projects I do. If you're working on a OS/2 project now or if you're interested how Smalled was done, check out EDM/2, you won't be disappointed! EDM/2 can be obtained in any of the following ways:  Ftp on the Internet - hobbes.nmsu.edu/os2/newsltr - ftp.luth.se/pub/os2/programming/newsletter - generalhq.pc.cc.cmu.edu/pub/newsletters/edm2  WWW readable on-line on the internet - fttp://www.iqpac.com  The EDM/2 mailing list. Send an empty message to edm2-info@knex.mind.org to receive a file containing (among other things) instructions for subscribing to EDM/2.  On Compuserve all back issues are available in the OS/2 Developers Forum 2. ═══ 12. How do I ..... ═══ Get help fast Use multiple Smalled instances Use Drag-n-Drop in Smalled Edit accelerator keys Use the file-history Set preferences Open a file Save a file Change a font Save a font Print a document Change word wrap Change tab settings Active vertical scroll Find a file ═══ 12.1. Open a file ═══ Opening a file can be done in three different ways. - Using file-menu open (with the filehistory) - Dropping a file object on the Smalled icon - Dropping a file object on the Smalled edit area. ═══ 12.2. Save a font ═══ The font selected by a document will be saved in the Extended attributes of a file, as this file is saved. The default font (font used when a new file is created or a file without smalled ea's is opened) can be set if the Save button is invoked on the Font-Dialog. This dialog is started if the set-font option is choosen from the options-menu or from the button-bar. ═══ 12.3. Print the document ═══ Printing the current document can be done by selecting the Print option of the File menu or by selecting the print button . If a selection has to be printed the "print selected" checkbutton must be flagged. Another way is to drag the titlebar icon to the printer if the whole text has to be printed. If a selection has to be printed the selection can be dragged to the printer. ═══ 12.4. File history ═══ The file-history in Smalled is attached to the Standard file dialog This way it can be used not only for opening a file but also for insert file, save as and copy to. The file-history is attached to a drop-down list that is attached to the file-name entry-field, This list can be operated in the same way a drive can be selected. The cursor-down may be used to circle through the entries or the button on the right of the entry-field can be invoked to show the entire list. ═══ 13. Glossary / What is ... ═══ The following (technical) terms which may need further explanation are used in this help document.  OS/2  Clipboard  Presentation parameters  Drag-n-drop  Multithreading  Direct manipulation  ATM fonts  Extended attributes  Standard file dialog  Standard font dialog  File-history  Bubble-help  DragText  Text-format ═══ 13.1. Multithreading ═══ Multithreading is the capability of OS/2 to perform more than one task at once for one proces. For example you can access the help of this applet, and in the meantime load, save or print a file. Both actions are taking place at the same time . It's like walking and chewing gum at the same time. It's NOT like Windows, which takes a step, performs a chew, takes a step, etc. ═══ 13.2. IBM OS/2 ═══ OS/2 is a registered trademark of International Business Machines. It's the wonderfull operating system you are using at the moment. ═══ 13.3. Presentation parameters ═══ Presentation Parameters are a set of properties which are attached to every OS/2 control. These properties command the way a control looks. The most common use is changing fonts and colors by dropping them on a control using Direct manipulation. If you want to change fonts or colors, you first have to open a font-palette, color-palette or scheme-palette from the system setup folder. ═══ 13.4. Clipboard ═══ The clipboard provides a temporary storage area for a piece of text, a bitmap or a metafile. In Smalled the only interresting part is text. It will enable you to move data within Smalled or share data with other applications. The most common operations on the clipboard are: Cut Copy Paste The data in the clipboard is maintained in memory only. Clipboard data is lost when the computer is turned off. ═══ 13.5. Direct manipulation. ═══ One of the most attractive features of the OS/2 desktop is the possibility to drag objects and drop them on another object and thus start an action involving those two objects. This is called direct manipulation. In Smalled direct manipulation is completely supported. Smalled even understands the DragText rendering method. Besides that it's behaviour can be customized (see general preferences).If Smalled is on the drag-site, selected text can be dragged by starting a drag from anywhere on the edit-area as long as there is a block of selected text. If the whole text has to be dragged, the drag can be started from the title-bar icon. The following actions can be invoked in Smalled by using Drag-n-drop:  Opening a file  Saving a file  Saving selected text  Copy and move of text  Shredding text / invoking new  Printing  Changing Presentation parameters  Working with DragText A drag can be aborted by using the ESC key or the F1 (help) key. If F1 is invoked, this help-page will be displayed. WARNING: The use of drag-n-drop can randomly distort bitmaps and icons on your system if you're using OS/2 2.xx or Warp 3.0. This isn't a Smalled bug, it's a bug in OS/2 and it isn't fatal because everything will work just fine. However it's very anoying. IBM fixed this bug in Fixpack 8. So if you're experiencing trouble of this kind, just install fixpack 8 or higher. ═══ 13.6. DragText. ═══ DragText is a utility written by Rich Walsh. This utility makes it possible to use d&d from virtualy every OS/2 control. Besides that DragText has a lot of extra's and it is an extremely well behaving utility. Smalled understands the rendering method used by DragText, so if DragText is installed it can be used seamlessly with Smalled. Drags are possible from Smalled to DragText supported applications and vice versa. Besides being able to drag text to every possible entryfield, DT also supports drags from *every* OS/2 window. Besides that DT has the following extra's :  drop text on a WPS folder to create a file whose name is based on the first few words of the text. You can drop one of these DragText files on any supported window to insert the text.  if the text you drop on the WPS is a URL, DragText will create a WebExplorer Url object. The object's title will be taken from the URL, minus unnecessary words like "http://", "www", etc.  press Alt as you drop any file on a multiline entryfield to insert its contents.  press Alt as you drop a folder on a multiline entryfield to insert a formatted listing of the directory's files. You can configure the formatting any way you want; you can even use it to write cmd files.  because DT can create files, you can drop text on many programs that won't accept dragged text but will accept a file.  since DT now does so many things, it uses 6 different icons to show you what will happen when you drop your text. You *must* have Fixpack 8 or later installed; if you don't, this feature will be disabled to prevent your system from crashing. ═══ 13.7. Opening a file through drag-n-drop ═══ A file can be opened through drag-n-drop in several ways. - If a file object is dropped on the Smalled icon, Smalled is started and the file-object dropped on the Smalled icon is opened. - A file object can be dropped on the Smalled edit area when Smalled is already open. If Smalled doesn't contain text, the file is simply opened. If Smalled contains text, the text of the dropped object will be inserted at the point it is dropped. The complete dropped text will be selected after the drop. ═══ 13.8. Saving a file through drag-n-drop ═══ Saving text through drag-n-drop is one of the nicest features of Smalled. Saving can simply be achieved by dragging the titlebar-icon or a text selection to the place where you want the text to be saved. the WPS will create a data-file at the drop point containing the complete text currently in Smalled or in the selection. In the preferences dialog, you can set the way Smalled will set the filename. The possibilities are: The original filename (the one that's in the titlebar) is used for the save action or the system default [data file] is used. You don't have to worry about duplicates or overwriting a file, the filesystem simply numberes the file if it has the same name as an already existing file. Future releases may have a dialog for customizing the drop-name. ═══ 13.9. Saving selected text through drag-n-drop ═══ If the selected text has to be saved, simply start a drag operation from anywhere on the edit area as long as a selection is active. You may drag the selection to any place you like. The selection will be saved as data-file on the place you drop it. In the preferences dialog, you can set the way Smalled will set the filename. The possibilities are: The original filename (the one that's in the titlebar) is used for the save action or the system default [data file] is used. You don't have to worry about duplicates or overwriting a file, the filesystem simply numberes the file if it has the same name as an already existing file. ═══ 13.10. Copy and Move text through drag-n-drop ═══ Copying and moving text through drag and drop is supported in one instance of Smalled or between instances of Smalled (or to EPM) and to all DragText supported controls and applications that understand the native DRM_OS2FILE rendering format. A drag can be started from anywhere in the edit area as long as a selection is active. The dragged text will be inserted at the drop point. If the SHIFT key is pressed during the drag, a move is assumed. If this is the case, the dragged selection will be deleted after the drop. After the drop, the complete text will be selected. If a drag has to be discarded, ESC will do the trick. ═══ 13.11. Shredding text / invoking new through drag-n-drop ═══ Shredding (deleting) text is the same as invoking a clear on the selected text with the difference that the selected text is dropped on the shredder. After a shred operation, the deleted text can be retrieved by invoking an undo. It's also possible to delete the whole text. In this case the titlebar-icon must be dragged to the shredder. If this is done, Smalled will act just as if a New operation is invoked. ═══ 13.12. Printing through drag-n-drop ═══ To print the complete contents of Smalled, the titlebar-icon has to be dragged to the printer. If this is done, a normal print operation is started. In this print action the dropped on printer is used. In Smalled it's also possible to print a selection. Simply start a drag from anywhere on the edit area (as long as a selection is active) and drop this selection on the printer. The currently selected text will be printed using the font, tab, etc. currently in use for that text in Smalled. If a drag operation has to be discarded, use ESC. Printing in Smalled through drag and drop will open a small dialog in which a slider and a stop button are displayed. The slider shows the progress that Smalled is making. The Stop button will enable you to abort the printjob. ═══ 13.13. Changing Presentation parameters through drag-n-drop ═══ You can change the color of any part of the Smalled main window (except the smart icons) by dropping a color on it. To do this, open the system setup folder and start the color palette. Choose a color and drop it on the part of your choice For example one of the scrollbars. They will change color. If you exit the application, the change will be remembered. In a simmilar way, the Fonts can be changed. Start the font palette and pick a font. Drop it on the menubar or on the edit area. The font will change. Changes will be saved. You can change both color and font in a single action by dropping a scheme palette on Smalled. The scheme palette is also found in the system setup folder. ═══ 13.14. Working with DragText ═══ Many people use Rich Walsh's DragText package. This nice package can be used with Smalled. Smalled understands the rendering methods used by DragText. This means that Smalled can be used directly with no further changes with DT. You may drag objects from DT supported controls or drag to DT supported controls. Smalled can even be modified so that DT takes control over the d&d in the Smalled edit window (see General preferences). ═══ 13.15. ATM fonts ═══ The most fonts OS/2 uses are Adobe Type Manager fonts. These fonts are scalable in all directions and are supported by Smalled. There are a lot of ATM fonts that are freeware. They can be installed in OS/2. All the ATM fonts installed in OS/2 can be used in Smalled. ═══ 13.16. Extended attributes ═══ In DOS and Windows, files only have 4 attributes (actually it's 6). Files can be hidden, Read only, System or archived. OS/2 however can attach more information (attributes) to a file. This information is known as the extended attributes. They can have a maximum size of 64Kb for each file! The creation date and the last access date are examples of extended attributes. More extended attributes can be found in the settings notebook of a file. Most common are: - History - Comment - Keywords - Icon - long name Besides these standard extended attributes OS/2 has the ability to use custom EA's. Smalled uses four custom EA's to store the used font, the wrap setting, the tab-size and the last used cursor position. The beauty of this approach is that the file contents are pure ASCII and can be handled as such by every other application. Saving in the extended attributes will only be done if this is needed. If you build a document using only the defaults and you don't adjust the font, tab, indent or wrap, this info isn't saved. The next time you use the document, the defaults are used. Future releases of Smalled will probably see more EA access. ═══ 13.17. Standard file dialog ═══ The Standard file dialog is the standard dialog OS/2 provides for disk access actions. It enables you to change directories and drives and select a filename from a listbox. The entered filename will be used to open, save, save as, copy to or insert-files. In Smalled this dialog is modified to support some more functions. The form of the dialog as used in Warp 4 or Warp 3 will be left intact. As you can see in the bitmap some extra controls are added. Hint: Use the default directory preferences in the options menu to set the directories used by the open, save as, insert file and copy to actions. The open dialog used in Smalled has some nice extra's. It has three major extra's. It contains a file history a file find utility and a fast switch for deafult directories. The file entry field contains a drop down list with the 16 last used files. Even files that are opened or saved through drag and drop are added to the list. The list can be activated by using the small button on the right site of the entryfield (just like the drive list), or the cursor keys can be used to walk through the entries one by one. The fileopen dialog is also modified so it can be used to find a file anywhere on the system. If you change the contents of the 'Open filename:' entryfield, the Search button will become available. If search is pressed, Smalled will search the drive mentioned in the 'Drive:' field for the file entered. The search will be conducted recursively from the directory active in 'Directory'. So if the d:\files\smalled directory is current in the open-dialog. All directories under this directory will be searched. The filename entered may contain the wildcards * and ?. The Smalled open dialog also supports other ways of finding a file (since version 1.10). You may also enter a complete path with wildcards. If a complete filepath is entered and a search is conducted, all the subdirectories of the path entered are searched for the file mask. If you only want to search the entered directory, simply press return after entering the filemask (! Not the search button) and the File: listbox will show all the files in the entered directory. If a filemask with only the driveletter is entered, the whole drive is searched from the root. If the search is started, the 'File:' listbox will change to 'Found:'. The files that match the query will be displayed in that listbox. If one is selected it will be displayed in the 'Open filename:' entryfield. If OK is pressed, this file will be opened. If Cancel is pressed, the search will be aborted and the found listbox will dissapear. There is a quicker way to open a found file. Just double-click on one of the found names and Smalled will open it. If the search is conducted in a drive/directory combination isn't of your liking, just change them and press search again. The search currently underway will be aborted and a new search will be started. If no matching files were found, a message stating so will be displayed in the 'Found:' listbox. The dialog also contains the buttons 1, 2, 3 and L. These buttons will activate the directory set in the default directory preferences. The directory activated as default is also determined in these preferences. The buttons switch fast to the chossen dorectories, or the last used directory. ═══ 13.18. Standard font dialog ═══ The standard font dialog is provided by OS/2 for a consistant way of selecting fonts. It enables you to select a font, select its attributes and style and set its point-size. An example of the selected font will be shown in the dialog. Smalled uses a slightly modified version of thsi dialog to make a difference between saving a font as default and applying one. If the save buton is pressed, the font of the text currently loaded is changed and the font is saved as the default. If apply is pressed, the font used in the text loaded is changed. This font is saved with the file in the ea's as the file is saved. ═══ 14. Limitations of Smalled ═══ This help entry is added in version 0.9. It is added to point out to users what can and can't be done with Smalled. With the release of Smalled 0.95 some of these items have become possible. Most noticeble active scrolling and color changing. Smalled is based on the MLE control found in OS/2. As such it can be seen as a shell which makes it possible to acces this control easily. The MLE control (Multi Line Edit) can be found in more places in OS/2, for example in the third page of the file tag of the settings notebook. In this page comments etc. can be added. The control used to do this is the MLE control. MLE was intended to edit small pieces of text, typically 4kb. I found it was able to handle very large amounts of text (several MB's), although performance may suffer as if you try this. If you use Smalled you have to live with the limitations of the MLE control until I find time to write my own MLE control which (of course) won't suffer from these limitations, or until I find a work around. The following items limit the use of smalled. Load and save performance 64Kb clipboard support If you have any comments beside these items please let me know. ═══ 14.1. Load and save performance ═══ In smalled loading (large) files is slow while saving the files is fast. How come? The MLE control was intended to handle small amounts of text. It was never designed to be a full sized editor. So this control is limited to 64Kb of text. Smalled is capable to handle larger files because there is a way around this, load and save the files in chunks of 64 Kb. When saving a file, the MLE control releases the 64 Kb chunks very fast so saving is fast. It seems even faster because it's handled multi threaded. Loading a (large) file is slow because MLE has to prepare a 64 Kb chunk of memory before loading 64 Kb of text. When it does this MLE displayes the clock pointer. With Every consecutive 64 Kb block that has to be prepared the prepare time grows. This makes loading slow and nothing can be done to speed it up (Until I write my own MLE control). If you're using files up to +- 300 Kb you shouldn't even notice this. Files of 1 Mb and larger suffer greatly from this slowing down. ═══ 14.2. 64Kb clipboard support ═══ The MLE control also handles clipboard support. With one message the selected text is copied to the clipboard. This has one limitation, the maximum amount of text that the MLE can copy to the clipboard is 64Kb. This is because the MLE control is limited to handling 64 Kb of text. I haven't found a way around this. You will be noticed if you try to cut, copy or paste more then 64 Kb. ═══ 15. Keys help ═══ As with all good applications there are some `hot keys` defined which will make life a little easier. Also a few mouse actions are defined as shortcuts. Smalled has a nice extra here, Accelerator editor. This editor is started by holding down the ALT key while selecting a menu item. Changes will be saved and shown in the menu's. ┌────────────────┬──────────────────────────────┐ │Key │Action │ ├────────────────┼──────────────────────────────┤ │Shift-Del │Cut selection │ ├────────────────┼──────────────────────────────┤ │Ctrl-Y │Cut current line │ ├────────────────┼──────────────────────────────┤ │Ctrl-Ins │Copy selection │ ├────────────────┼──────────────────────────────┤ │Shift-Ins │Paste │ ├────────────────┼──────────────────────────────┤ │Alt-Bksp │Undo │ ├────────────────┼──────────────────────────────┤ │Shift-arrow │Select text or extend a │ │ │selection in the direction of │ │ │the arrow │ ├────────────────┼──────────────────────────────┤ │Shift-Home │Select text or extend a │ │ │selection to the beginning of │ │ │the current line │ ├────────────────┼──────────────────────────────┤ │Shift-End │Select text or extend a │ │ │selection to the end of the │ │ │current line │ ├────────────────┼──────────────────────────────┤ │Shift-Ctrl-Right│Select text or extend a │ │ │selection to the beginning of │ │ │the next word │ ├────────────────┼──────────────────────────────┤ │Shift+Ctrl+Left │Select text or extend a │ │ │selection to the beginning of │ │ │the previous word │ ├────────────────┼──────────────────────────────┤ │Shift+Ctrl+Home │Select text or extend a │ │ │selection to the beginning of │ │ │the file │ ├────────────────┼──────────────────────────────┤ │Shift+Ctrl+End │Select text or extend a │ │ │selection to the end of the │ │ │file │ ├────────────────┼──────────────────────────────┤ │ESC │Deselect or Cancel a drag │ │ │operation │ ├────────────────┼──────────────────────────────┤ │CTRL-N │New │ ├────────────────┼──────────────────────────────┤ │CTRL-O │Open │ ├────────────────┼──────────────────────────────┤ │CTRL-I │Insert file │ ├────────────────┼──────────────────────────────┤ │CTRL-C │Copy to file... │ ├────────────────┼──────────────────────────────┤ │CTRL-S │Save │ ├────────────────┼──────────────────────────────┤ │CTRL-A │Save as ... │ ├────────────────┼──────────────────────────────┤ │CTRL-P │Print │ ├────────────────┼──────────────────────────────┤ │CTRL-X │Exit │ ├────────────────┼──────────────────────────────┤ │ALT-F4 │Exit │ ├────────────────┼──────────────────────────────┤ │F3 │Exit │ ├────────────────┼──────────────────────────────┤ │CTRL-W │Toggle Wrap │ ├────────────────┼──────────────────────────────┤ │CTRL-D │Toggle Indent │ ├────────────────┼──────────────────────────────┤ │CTRL-= │Toggle Toolbar │ ├────────────────┼──────────────────────────────┤ │CTRL-F │Find │ ├────────────────┼──────────────────────────────┤ │F2 │Find again │ ├────────────────┼──────────────────────────────┤ │CTRL-R │Replace │ ├────────────────┼──────────────────────────────┤ │CTRL-J │Jumppoint │ ├────────────────┼──────────────────────────────┤ │CTRL-T │Text format... │ ├────────────────┼──────────────────────────────┤ │CTRL-< │Reflow │ ├────────────────┼──────────────────────────────┤ │CTRL-> │Insert > │ ├────────────────┼──────────────────────────────┤ │CTRL-L │Linebreak │ ├────────────────┼──────────────────────────────┤ │CTRL-Backsp │Remove CR │ ├────────────────┼──────────────────────────────┤ │CTRL-Space │Remove Tabs/sp │ ├────────────────┼──────────────────────────────┤ │CTRL-Tab │Insert indents │ ├────────────────┼──────────────────────────────┤ │CTRL-/ │Select all │ ├────────────────┼──────────────────────────────┤ │CTRL-\ │Deselect all │ ├────────────────┼──────────────────────────────┤ │CTRL-HOME │Goto top of document. │ ├────────────────┼──────────────────────────────┤ │CTRL-END │Goto end of document. │ ├────────────────┼──────────────────────────────┤ │Tab │Insert a tab character at the │ │ │cursor position │ ├────────────────┼──────────────────────────────┤ │Del │Clear │ ├────────────────┼──────────────────────────────┤ │Insert │Switch between insert and │ │ │replace mode. In insert mode, │ │ │new text is inserted at the │ │ │cursor position, moving the │ │ │existing text to the right. In│ │ │replace mode, the new text │ │ │replaces the existing text. │ ├────────────────┼──────────────────────────────┤ │Mouse │ │ ├────────────────┼──────────────────────────────┤ │Dblclk1 │Select word under the cursor │ ├────────────────┼──────────────────────────────┤ │Snglclk1-drag │Select area │ ├────────────────┼──────────────────────────────┤ │Snglclk2 on edit│Activate popup menu │ │area │ │ ├────────────────┼──────────────────────────────┤ │Dbllclk2 on │Activate Bubble-help │ │Toolbar │ │ └────────────────┴──────────────────────────────┘ ═══ 16. Getting help fast ═══ Smalled is designed with virtually all the OS/2 possiblities on board. So it is possible to jump to a particular help page fast. Help for the toolbar buttons can be obtained by pressing the button and holding the mousekey down. If F1 is pressed while the mousebutton is held down, the help page for the particular button action is displayed. Another quick way to obtain help for buttons is to turn on Bubblehelp. Help for menu items can be obtained in the same fashion. Just hold down the mousekey on a selected menu or menuitem and press the F1 key. Help dialogs can be obtained by the help buttons displayed on the dialogs or by pressing F1. ═══ 17. Multiple Smalled instances ═══ You may start Smalled more then once. You can even use Direct manipulation between the Smalled instances. The easiest way to start multiple instances is to create a new program object anywhere you like from the templates folder and set Smalled.exe as the file to be executed. The next step is setting the "Object open behaviour" in the window tab. If this is set to "Create new window", a new instance of Smalled is started each time the smalled program icon is clicked. Multiple Smalled instances can also be created from within the Smalled interface. This can be done with Open or New depending on the settings in the general preferences page. Besides that a new Smalled session can always be started from the tools menu. Note that mutiple Smalled instances will auto-cascade if the autocascade checkbox is set in the general preferences page. ═══ 18. Bubble-help ═══ In version 0.96 bubble help is included. When bubble-help is activated, a small window appears under a toolbar button when you mouse over it. This window contains a short discription concerning the function of the button currently under the mouse pointer. This function is considered usefull for first time users. In the long run these bubbles tend to irritate. So the default for bubble-help is off! To activate bubble-help doubleclick the mousebutton2 on the toolbar. If bubblehelp is turned on it will be mentioned in the statusbar. To turn bubblehelp off doubleclick again on the toolbar.