SSSS d // 3333 2222 S S d // 3 3 2 2 S d // 3 2 S d // 3 2 SSSS qqqq eeee ddddd // 3333 22222 S q q e e d d // 3 2 S q q eeeee d d // 3 2 S S q q e d d // 3 3 2 2 SSSS qqqqq eeeee dddd // 3333 222222 q q q q 1 0000 11 0 0 1 1 0 0 1 1 0 0 v v 1 0 0 v v 1 0 0 v v 1 0 0 v v 1 oo 0 0 v 1111111 oo 0000 Date of Print: 18. December 1993 ---------------------------------------------------------------------- Page 1 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Table of Contents Table of Contents ......................................2 Introduction ...........................................9 Support/Registration sites ............................10 Germany: .........................................10 USA: .............................................10 System Requirements ...................................11 Installing Sqed/32 ....................................12 Menu Structure ........................................13 Message ..........................................13 New .........................................13 Reply .......................................13 Change ......................................13 Forward .....................................13 Delete ......................................13 Copy ........................................13 Move ........................................13 Exit ........................................13 Edit .............................................13 Undo ........................................13 Cut .........................................14 Copy ........................................14 Paste .......................................14 Import ......................................14 Find ........................................14 View .............................................14 Messagelist .................................14 Arealist ....................................14 Options ..........................................14 Settings ....................................14 Help .............................................14 Product information .........................14 Configurating Sqed/32 .................................15 Main .............................................16 Squish.Cfg ..................................16 Description: ...........................16 Syntax: ................................16 Examples: ..............................16 Limitations: ...........................16 Main zone ...................................16 Description: ...........................16 ---------------------------------------------------------------------- Page 2 - Table of Contents Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Syntax: ................................16 Examples: ..............................16 Limitations: ...........................16 Ignore duplicate areas ......................16 Description: ...........................16 Syntax: ................................17 Examples: ..............................17 Limitations: ...........................17 Scan areas on startup .......................17 Description: ...........................17 Syntax: ................................17 Examples: ..............................17 Limitations: ...........................17 Drive mapping ...............................17 Description: ...........................17 Syntax: ................................18 Examples: ..............................18 Limitations: ...........................18 Names ............................................18 Names .......................................18 Description: ...........................18 Syntax: ................................19 Examples: ..............................19 Limitations: ...........................19 Registername ................................19 Description: ...........................19 Syntax: ................................19 Examples: ..............................19 Limitations: ...........................19 Registerkey .................................20 Description: ...........................20 Syntax: ................................20 Examples: ..............................20 Limitations: ...........................20 Areas ............................................20 .SQL offset .................................20 Description: ...........................20 Syntax: ................................20 Examples: ..............................20 Limitations: ...........................20 Windows ..........................................21 Messagelist .................................21 Description: ...........................21 Syntax: ................................21 Examples: ..............................21 Limitations: ...........................21 Arealist ....................................21 Description: ...........................21 Syntax: ................................21 Examples: ..............................21 Limitations: ...........................21 Replylist ...................................21 Description: ...........................22 Syntax: ................................22 Examples: ..............................22 Limitations: ...........................22 ---------------------------------------------------------------------- Page 3 - Table of Contents Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Within Bad Areas ............................22 Description: ...........................22 Syntax: ................................22 Examples: ..............................22 Limitations: ...........................22 Within Dupe Areas ...........................22 Description: ...........................22 Syntax: ................................22 Examples: ..............................22 Limitations: ...........................23 Colours ..........................................23 Subject .....................................23 Description: ...........................23 Syntax: ................................23 Examples: ..............................23 Limitations: ...........................23 Messages to you .............................23 Description: ...........................23 Syntax: ................................23 Examples: ..............................23 Limitations: ...........................23 Messages from you ...........................24 Description: ...........................24 Syntax: ................................24 Examples: ..............................24 Limitations: ...........................24 Editor ...........................................24 Editor foreground ...........................24 Description: ...........................24 Syntax: ................................24 Examples: ..............................24 Limitations: ...........................24 Editor background ...........................24 Description: ...........................25 Syntax: ................................25 Examples: ..............................25 Limitations: ...........................25 Font ........................................25 Description: ...........................25 Syntax: ................................25 Examples: ..............................25 Limitations: ...........................25 ^A-Kludges ..................................25 Description: ...........................25 Syntax: ................................26 Examples: ..............................26 Limitations: ...........................26 Path-Kludges ................................26 Description: ...........................26 Syntax: ................................26 Examples: ..............................26 Limitations: ...........................26 Seen-By-Kludges .............................26 Description: ...........................26 Syntax: ................................26 Examples: ..............................27 Limitations: ...........................27 ---------------------------------------------------------------------- Page 4 - Table of Contents Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Priorities .......................................27 Direct ......................................27 Description: ...........................27 Syntax: ................................27 Examples: ..............................27 Limitations: ...........................27 Crash .......................................27 Description: ...........................27 Syntax: ................................28 Examples: ..............................28 Limitations: ...........................28 Macro ............................................28 CTRL+1 bis CTRL+0 ...........................28 Description: ...........................28 Syntax: ................................28 Examples: ..............................28 Limitations: ...........................28 CarbonCopy .......................................28 Group .......................................29 Description: ...........................29 Syntax: ................................29 Examples: ..............................29 Limitations: ...........................29 Mitglieder ..................................29 Description: ...........................29 Paths ............................................30 Echotoss.Log ................................30 Description: ...........................30 Syntax: ................................30 Examples: ..............................30 Limitations: ...........................30 Tempfile ....................................30 Description: ...........................30 Syntax: ................................30 Examples: ..............................30 Limitations: ...........................30 Messages .........................................31 Tearline in Netmails ........................31 Description: ...........................31 Syntax: ................................31 Examples: ..............................31 Limitations: ...........................31 Origin in Netmails ..........................31 Description: ...........................31 Syntax: ................................31 Examples: ..............................31 Limitations: ...........................31 PID benutzen ................................31 Description: ...........................31 Syntax: ................................32 Examples: ..............................32 Limitations: ...........................32 insert Re: ..................................32 Description: ...........................32 Syntax: ................................32 ---------------------------------------------------------------------- Page 5 - Table of Contents Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Examples: ..............................32 Limitations: ...........................32 Column wrap .................................32 Description: ...........................32 Syntax: ................................32 Examples: ..............................33 Limitations: ...........................33 Insert initials .............................33 Description: ...........................33 Syntax: ................................33 Examples: ..............................33 Limitations: ...........................33 Token ............................................33 Header of new message .......................34 Description: ...........................34 Syntax: ................................34 Examples: ..............................34 Limitations: ...........................34 Header of message in other area .............34 Description: ...........................34 Syntax: ................................34 Examples: ..............................34 Limitations: ...........................35 Header of reply .............................35 Description: ...........................35 Syntax: ................................35 Examples: ..............................35 Limitations: ...........................35 Header of forwarded message .................35 Description: ...........................35 Syntax: ................................35 Examples: ..............................35 Limitations: ...........................36 Footer of forwarded message .................36 Description: ...........................36 Syntax: ................................36 Examples: ..............................36 Limitations: ...........................36 Footer of message ...........................36 Description: ...........................36 Syntax: ................................36 Examples: ..............................36 Limitations: ...........................36 The Tokens ..................................37 Original sender + First name ...........37 Original sender + Last name ............37 Original sender + Name .................37 Original receiver + First name .........37 Original receiver + Last name ..........37 Original receiver + Name ...............37 New sender + First name ................37 New sender + Last name .................37 New sender + Name ......................37 New receiver + First name ..............38 New receiver + Last name ...............38 New receiver + Name ....................38 Area + Original Area ...................38 Area + Reply Area ......................38 ---------------------------------------------------------------------- Page 6 - Table of Contents Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Adress + Sender ........................38 Adress + Receiver ......................38 Misc + Original date ...................38 Alias ............................................38 Description: ................................38 Syntax: .....................................39 Examples: ...................................39 Limitations: ................................39 Nodelist .........................................39 Miscellaneous informationen ...........................40 Errorlevel .......................................40 Origins ..........................................40 Description: ................................40 Syntax: .....................................40 Examples: ...................................41 Limitations: ................................41 Dialogs ...............................................42 Find .............................................42 Replylist ........................................42 Export file ......................................43 Filerequest dialog ...............................43 Import ...........................................43 Export ...........................................43 Kludges ..........................................43 Messagelist ......................................44 Nodelist .........................................45 About Sqed/32 ....................................45 Shortcuts .............................................46 The Toolbar ...........................................48 The Video Wlayer .................................48 Message attributes ...............................48 Context menus .........................................49 ---------------------------------------------------------------------- Page 7 - Table of Contents Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Main window, reading messages ....................49 Main window, writing messages ....................49 Messagelist ......................................49 Arealist .........................................50 History of Sqed/32 ....................................51 Beta tester ...........................................52 Special thanks ........................................53 Index .................................................54 ---------------------------------------------------------------------- Page 8 - Table of Contents Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Introduction Sqed/32 is a Fidonet compatible message editor for IBM OS/2 2.1. This program is still a beta. Version 1.0, however, is expected very soon. This documentation is in beta, too. As J”rg-Stefan is creating new features very fast, it is very hard to keep this documentation up to date. I compiled this English version during the last two weeks and was not able to spend enough time on the translation. Please excuse all mistakes and flaws. I will keep working on it and should have a better version ready by mid January 1994. [Jan-Peter Koopmann] ---------------------------------------------------------------------- Page 9 - Introduction Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Support/Registration sites Germany: Fidonet 2:242/404; 2:242/405 VirNet 9:492/7500 9:492/7510 9:492/7511 GerNet 21:100/4920.102 BBS The Velvet Underground +49-5251-179404 (UISDNC) Home of Sqed +49-5251-179405 (ZYX) CompuServe 100275,367 Internet jss@uni-paderborn.de Mail J”rg-Stefan Sell Pankratiusstr. 28 33098 Paderborn Germany USA: Fidonet 1:2801/10 (Richard Douglas) BBS ZyMax/2 +1-913-867-2587 (ZYX) ---------------------------------------------------------------------- Page 10 - Support Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- System Requirements * IBM OS/2 2.1 or higher; * 386DX/25; * 8MB RAM; * Squish by Scott J. Dudley; * MSGAPI.DLL revision 0 or higher; * VGA graphic card, SVGA is suggested; * Mouse or equivalent pointing device ---------------------------------------------------------------------- Page 11 - System Requirements Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Installing Sqed/32 Since you are reading this section of the documentation you either are one of the persons who really read the documentation before trying to install the program, or you experienced difficulties installing Sqed/32. (By the way, the first case appears to be quit improbable) This program is really easy to install. Just follow these steps: 1) Create a directory just for Sqed/32 (not really necessary but recommended !). 2) Now unarchive the Sqed/32 package into this directory. However, since you are reading this manual you obviously already unarchived the file. Therefore move all Sqed/32 files to this directory. 3) Sqed/32 requires a file called SQED.DLL where all language definitions for windows, dialogs and menus are defined. The package should contain at least two language files, DEUTSCH.DLL and ENGLISH.DLL . Simply rename the desired language file to SQED.DLL. Remove the other language files if you want, you do not need them anymore. 4) Start Sqed/32. The first time you start Sqed/32 it will open the Settings notebook and ask for your name, node adress and path to your squish.cfg. Please continue with section "Configurating Sqed/32" on page 15 for more details on the Settings notebook. You need a correct SQUISH.CFG since Sqed/32 will get a lot of information out of this file. Sqed/32 will not work without it ! Sqed/32 should now be ready for work ! Have fun ! Sqed/32 keeps data in its own INI files which are located in the Sqed/32 directory as well as in the OS2.INI file. If you install a new version of Sqed/32 or if you reinstall your current version it might be necessary to delete the "Sqed/32" application from the OS2.INI as well as all INI files in the Sqed/32 directory. To edit the OS2.INI file, usw INIMAINT.EXE (c) Garry Associates. INIMT21F.ZIP is the most recent version of this OS/2 Utility. ---------------------------------------------------------------------- Page 12 - Installing Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Menu Structure Message New Reply With quoting Without quoting Change Forward Delete Copy Move Exit Edit Undo ---------------------------------------------------------------------- Page 13 - Menu Structure Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Cut Copy Paste Import Find View Messagelist Arealist Options Settings Help Product information ---------------------------------------------------------------------- Page 14 - Menu Structure Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Configurating Sqed/32 Unlike most other editors for Fido-Net mailing systems, Sqed/32 is not configurated by cryptic textfiles. Sqed/32 is a PM-Application and therefore all necessary information is managed in a PM-style notebook dialog. This dialog truly is the heart of Sqed/32. Areas, paths, adresses etc. are defined here, but also miscellaneous information about windows, dialogs, fonts and colours. Starting Sqed/32 for the first time, you will have to provide the editor with some necessary information before you can start working. Some basic entries are the complete path to your SQUISH.CFG and at least one name and adress. All entries are stored in OS/2 style INI- files that can be edited with all common INI-tools. Most of the notebook-fields are not case sensitive. That means 'f:\point\squish\squish.cfg' will be treated the same way as 'F:\POINT\SQUISH\SQUISH.CFG'. Tokens are the big exception. All Tokens have to be upper case. Moreover, names are, of course, case sensitive. Paths and file names can be entered two different ways. Either you type in the desired path or file name directly or you enter a file dialog by pressing the corresponding push button. The file dialog, however, will make your life a lot easier The following section describes all notebook-pages of Sqed/32. Common OS/2 limitations (e.g. length) apply for all entries in the notebook. Conventions Parameters are surrounded by '<..>' - Optional parameters are surrounded by square brackets [<..>] Die Notebook Seiten und Felder: ---------------------------------------------------------------------- Page 15 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Main Squish.Cfg Description: Here you have to enter the complete path to the Squish configuration file SQUISH.CFG. Sqed/32 will gain information such as names, origins, adresses and areas from this file. This entry is mandatory. Syntax: [] Examples: E:\POINT\SQUISH\SQUISH.CFG Limitations: 1 Main zone Description: Your main zone is defined here. Default value: Zone 2 Syntax: [] Examples: 2 1 Limitations: 1 Ignore duplicate areas Description: Some programs unfortunately tend to define areas twice. By enableing this option, duplicate area definitions are ignored. ---------------------------------------------------------------------- Page 16 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Default: Show duplicate areas Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Scan areas on startup Description: If you want Sqed/32 to scan all areas on startup, enable this options. By scanning an area, Sqed/32 determines the number of messages and the last read message in that area. Scanning is done in the background. The corresponding thread's priority is REGULAR, -5. Default: Areas are scanned only at manual request. Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Drive mapping Description: This function gives you the capability of emulating/renaming specific drive letters in a network environment. Running a Mailbox on an IBM LAN SERVER/Microsoft LAN Manager is no longer an exception. If you access files on the server you might have to create two configuration files due to different drive letters. This is because drive letters on the server and on the workstation may differ due to your drive mapping. ---------------------------------------------------------------------- Page 17 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Let's assume the Squish files for the area OS2 are on the server drive E:. Therefore your SQUISH.CFG on the server would read something like this: EchoArea OS2.GER E:\ECHOMAIL\097 2:242/400 -$ On your workstation you mapped this drive to be drive H: In order to access the area OS2 you then would have to create yet another configuration file with the following line: EchoArea OS2.GER H:\ECHOMAIL\097 -$ However, if you use the drive remapping facility of Sqed/32, you can tell Sqed/32 to interpret drive E: as drive H: and therefore you can use your configuration file on the server on the workstation as well. With the above example you would define the following: H: -> E: To do this, click on the 'Add' button. Sqed/32 now prompts you to enter the two drive letters (in this example H and E). Drive mapping also works with file attaches. If Sqed/32 discovers a path that would be different on the server, the path is adjusted. Syntax: [ ] Examples: H: -> E: L: -> C: Limitations: 10 Names Names Description: Here you define names. Sqed/32 uses these names to detect messages for you. Names are case sensitive. ---------------------------------------------------------------------- Page 18 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- To add a new name just click on the 'Add' button and a window will pop up, asking you for the new name. Click on the 'Remove' button in order to delete a name. You have to enter at least one name. Syntax: . . . [] Examples: J”rg-Stefan Sell SYSOP Point J”rg Stefan Sell Sell j”rg-stefan sell Limitations: 50 Registername Description: You will receive the necessary information in order to register by sending a NetMail to SqedRegister at 2:242/405. Registration is for statistic purposes only and is not bound to any fees. If you really want to donate a few bucks , however, you are of course very welcome to do so ! :-) Syntax: [] Examples: Dirk Billerbeck Volker Weber Limitations: 1 ---------------------------------------------------------------------- Page 19 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Registerkey Description: You will reveive your register key together with the register name. Syntax: [] Examples: AA38DFBBC9255E2 Limitations: 1 Areas On this notebook page you will find information about all areas defined in SQUISH.CFG. The list-box displays the areas in the same order they are defined in SQUISH.CFG. Moreover you will obtain more data about the kind and type of the currently marked area. Refer to your mail-processor documentation for a more detailed explanation of the two groups 'INFORMATION' and 'TYPE'. .SQL offset Description: This Keyword defines the offset Sqed/32 will use to store the lastread-pointer in squish areas. Lastread- pointer in Squish areas are kept in the .SQL files, whereas is the area definition in your SQUISH.CFG (NetArea, BadArea, DupeArea, EchoArea). Default value is 0 (for the first user). Syntax: Examples: 2 Limitations: 1 ---------------------------------------------------------------------- Page 20 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Windows Messagelist Description: If this button is enabled, the messagelist ist displayed on startup. You can also activate the messagelist choosing 'Messagelist' in the 'Views' menu or by pressing CTRL+L. You can find a detailed description of the messagelist in section 'Dialogs' on page 44. Default value: enabled Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Arealist Description: Activates or deactivates the arealist on startup. You can also enable the arealist with the 'Views' menu ('Arealist'), or by pressing CTRL+A. The arealist is discussed in section 'Dialogs' on page 43 Default value: Enabled Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Replylist ---------------------------------------------------------------------- Page 21 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Description: Activates or deavtivates the replylist. The replylist is explained on page 42 Default value: enabled Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Within Bad Areas Description: Shows all kludges in a seperate window if you are within a "Bad Area". Default value: on Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Within Dupe Areas Description: Shows all kludges in a seperate window if you are within a "Dupe Area". Default value: of Syntax: inapplicable Examples: inapplicable ---------------------------------------------------------------------- Page 22 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Limitations: inapplicable Colours These three choices allow you to define different colours for the different line types in the messagelist. This will help you to spot messages from you or messages adressed to you very fast. The example window will display the effects of your changes immediately. Subject Description: Colour of the subject line in the message list window. Default colour: black Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Messages to you Description: Within the message list window, the name of someone who wrote a message to you is displayed in this colour. Default colour: red Syntax: inapplicable Examples: inapplicable Limitations: ---------------------------------------------------------------------- Page 23 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- inapplicable Messages from you Description: Within the message list window messages from you are displayed in this colour. Default colour: blue Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Editor These options influence the appearance of the main window where all messages are displayed and edited. Editor foreground Description: Defines the foreground colour (the font colour) of the main window. Default colour: Current layout-colour for window text Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Editor background ---------------------------------------------------------------------- Page 24 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Description: Defines the background colour of the main window. Default colour: Currently selected colour for entry fields in the layout-palette. Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Font Description: This button activates yet another window where the font, font-style and font-size are defined. All currently installed fonts can be used. Default: 'System Proportional', 10 points Moreover you can change the fonts in all windows by OS/2's drag&drop technique. Simply drag the wanted font out of OS/2's font palette onto the corresponding window. Syntax: inapplicable Examples: inapplicable Limitations: inapplicable ^A-Kludges Description: If this checkbox is enabled, all ^A-kludges as well as MSGID, REPLY and PID-kludges are displayed in the main window. ---------------------------------------------------------------------- Page 25 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- You can also toggle this value using the context-menu in the main window (View -> ^A-kludges). Default value: off Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Path-Kludges Description: Determines whether or not path kludges are displayed in the main window. This value can also be toggled using the context-menu of the main window (View -> Path-kludges) Default value: on Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Seen-By-Kludges Description: If enabled, seen-by-kludges are displayed in the main window. Guess what ! Even this value can be changed using the context-menu in the main window (View -> Seen-By kludges). WOW ! Isn't that just great ? :-) Default value: on Syntax: ---------------------------------------------------------------------- Page 26 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- inapplicable Examples: inapplicable Limitations: inapplicable Priorities This selection defines the priorities of the automatically generated filerequest messegas. Look on page 43 for details on the filerequest dialog. Direct Description: Determines whether or not automatically generated file-request mails (more details on page 43) have the direct-flag enabled. If the direct-flag is enabled, the message is sent to the destination adress without routing. Your mailer determines at what time this message is sent. Refer to the Squish documentation for more details. Default value: on Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Crash Description: This message attribute is very similar. Again, your request messages are sent to the destination adress without routing. This attribute, however, tell your mailer to sent these messages as soon as possible. Again, have a look at the Squish documentation if you are curious and want some more information. ---------------------------------------------------------------------- Page 27 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Macro CTRL+1 bis CTRL+0 Description: You can define up to 10 macros which are inserted in your message by pressing CTRL-. Just click your mouse within the listbox and enter the desired text. Macros may expand over several lines. Empty spaces and lines are inserted as they appear in the listbox. Therefore, if a macro ends with an empty line, this will also be inserted in the message. Syntax: [] . . . [] Examples: ----------- Cut ---------- ----------- Cut ---------- Limitations: 10 CarbonCopy A Carbon Copy (CC) is an exact copy of a NetMail which is sent to one ore more persons in addition to the original recipient. Sqed/32 uses a group oriented structure. You group all recipients you want to adress into a Carbon Copy ---------------------------------------------------------------------- Page 28 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- group. Choose your group members wisely since this technique is only helpful if your groups do not change too much. In order to create a CC Netmail simply enter the name of the desired CC group into the 'To:' field. When you save this message, Sqed/32 creates an original copy of the message with the SENT flag already set. Moreover one copy is created for each group member with the KILL flag set. Your mail processor will send the message to all recipients. After the messages have been sent, only the original copy remains in your messagebase. Group Description: By pressing the 'New' you activate another window. Enter the name of the new CC-Group here. This new group will then be inserted at the end of the combo- box. The 'delete' button deletes a group with all its members (surprise !). Syntax: [] Examples: OS/2 User Group Boston Monkey Island Fan association :-) Limitations: ? Mitglieder Description: This lisbox contains all members (and adresses) of the selected CC-group. In case you just created a new CC-group, the 'Add'- Button is enabled. By choosing this button, the nodelist-dialog (page 45) appears. This dialog helps you finding the adresses of the desired members. New members are inserted in the 'members' listbox. If you want to add a member to an existing group, first select on of the members and then choose 'Add'. ---------------------------------------------------------------------- Page 29 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- In order to delete an entry simply select this entry and click the 'Delete' button. Paths Here you specify some paths crucial to Sqed/32. Echotoss.Log Description: When writing a new message in an echoarea Sqed/32 adds the areatag to the file ECHOTOSS.LOG. By telling Squish about this file (using the - f parameter) you might speed up your echo-processing dramatically, since Squish no longer searches all echoareas but only the areas with new messages. Syntax: [] Examples: E:\POINT\TEMP\ECHOTOSS.LOG Limitations: 1 Tempfile Description: ? Syntax: [] Examples: F:\TEMP\Sqed.tmp Limitations: 1 ---------------------------------------------------------------------- Page 30 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Messages Tearline in Netmails Description: Decides whether or not Sqed/32 attaches tearlines to your netmail. Default value: off Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Origin in Netmails Description: Decides whether or not Sqed/32 attaches an origin line to your netmail. Default value: off Syntax: inapplicable Examples: inapplicable Limitations: inapplicable PID benutzen Description: If this checkbox is enabled, Sqed/32 creates a PID- line (PID = Product IDentification) within the ^A- ---------------------------------------------------------------------- Page 31 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- kludges. Otherwise Sqed/32 attaches 'SQED ' to the tearline. Default value: off Syntax: inapplicable Examples: inapplicable Limitations: inapplicable insert Re: Description: If enabled, Sqed/32 adds 'Re: ' (Reply) to the beginning of the subject line when you reply to a message. Default value: off Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Column wrap Description: Word wrapping starts in this column. This only affects quoting messages. Possible values: 10 to 75 Default value: 65 Syntax: [] ---------------------------------------------------------------------- Page 32 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Examples: 66 34 Limitations: 1 Insert initials Description: Again, this only effects quoting messages. If enabled, all quoted lines will begin with the initials of the quoted author. Otherwise, quoting behaves just like in CIS, meaning all quoted lines start with '>'. Default value: on Syntax: inapplicable Examples: inapplicable Limitations: inapplicable Token Sqed/32 tries to make life as easy as possible for you. Therefore Sqed/32 gives you the capability of using templates in order to do some typing for you. Sqed/32 can enter text automatically at the following positions: - at the beginning of new messages - at the beginning of replies in other areas - at the beginning of replies in the same area - at the beginning of forwarded messages - at the end of forwarded messages - at the end of all other messages To make templates more flexible Sqed/32 offers variables, so called tokens. Tokens are replaced with the corresponding values at the time of the message creation. The [DATE] token, e.g., is replaced with the date and time of the message, which you are replying to. ---------------------------------------------------------------------- Page 33 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- If you want to define text to one of the sections mentioned above, simply select this section in the combobox and enter the textbox using your mouse. Now enter the desired Text. If you want to insert a token into the text, select a generic term from the lower listbox and choose from the corresponding tokens. The selected token is then entered at the current cursor position in the upper textbox. Header of new message Description: The text you define here is being placed at the beginning of new messages. Syntax: [ ...] . . . [ ...] Examples: Hello [N_AN_V]! Limitations: ? Header of message in other area Description: Text you define here will be placed at the beginning of replies, if you choose to reply in a different area. Syntax: [ ...] . . . [ ...] Examples: * Reply to a message in [O_AREA] Hi [N_AN_V]! ---------------------------------------------------------------------- Page 34 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Limitations: ?? Header of reply Description: This text is placed at the beginning of replies within the same area. Syntax: [ ...] . . . [ ...] Examples: Hi [N_AN_V]! Regarding your message to [O_AN]: Limitations: ? Header of forwarded message Description: This text if placed in front of forwarded messages. Syntax: [ ...] . . . [ ...] Examples: * Original area : [O_AREA] * Destination area : [N_AREA] * Original sender : [O_VON], [O_VON_A] * Original recipient: [O_AN], [O_AN_A] * Date of orig.msg. : [DATE] ========== FORWARDED MESSAGE FOLLOWS ========== ---------------------------------------------------------------------- Page 35 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Limitations: 1 Footer of forwarded message Description: This text is appended to all forwarded messages. WARNING: The text defined at 'Footer of message' is at the very end of the message nevertheless. Syntax: [ ...] . . . [ ...] Examples: ========== END OF FORWARDED MESSAGE ========== Limitations: ?? Footer of message Description: This text is appended at the end of new and forwarded messages. Syntax: [ ...] . . . [ ...] Examples: reg. Jan-Peter Limitations: ?? ---------------------------------------------------------------------- Page 36 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- The Tokens Original sender + First name Symbol: [O_VON_V] Description: The first name of the person who wrote the original message. Original sender + Last name Symbol: [O_VON_N] Description: The surname of the person who wrote the original message. Original sender + Name Symbol: [O_VON] Description: The complete name of the person who wrote the original message. Original receiver + First name Symbol: [O_AN_V] Description: The first name of the person that the original message was adressed to. Original receiver + Last name Symbol: [O_AN_N] Description: The surname of the person that the original message was adressed to. Original receiver + Name Symbol: [O_AN] Description: The complete name of the person that the original message was adressed to. New sender + First name Description: The first name of the person writing the new message. New sender + Last name Symbol: [N_VON_N] Description: The surname of the person writing the new message. New sender + Name Symbol: [N_VON] ---------------------------------------------------------------------- Page 37 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Description: The surname of the person writing the new message. New receiver + First name Symbol: [N_AN_V] Description: The first name of the new recipient. New receiver + Last name Symbol: [N_AN_N] Description: The surname of the new recipient. New receiver + Name Symbol: [N_AN] Description: The complete name of the new recipient. Area + Original Area Symbol: [O_AREA] Description: The name of the original area. Area + Reply Area Symbol: [N_AREA] Description: The name of the area where your reply will be placed in. Adress + Sender Symbol: [O_VON_A] Description: The adress of the original message's sender. Adress + Receiver Symbol: [O_AN_A] Description: The adress of the original message's recipient. Misc + Original date Symbol: [DATE] Description: Date of the original message. Alias Description: ---------------------------------------------------------------------- Page 38 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Here you can define aliases. Aliases are abbreviations. Each alias stands for a recipient and maybe even his adress and a subject. When you enter an alias in the recipient field and press the [tabulator] key, the corresponding name, adress and subject are filled in automatically. This makes life a lot easier if you happen to write a lot to some people. Syntax: ALIAS ;;[Recipient's adress];[Subject] Examples: ALIAS bug;J”rg-Stefan Sell;2:242/405;Bugreport ALIAS af;Areafix;2:242/400; ALIAS vowe;Volker Weber;2:2405/111; Limitations: 20 Nodelist Will be done soon.... :-( ---------------------------------------------------------------------- Page 39 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Miscellaneous informationen Errorlevel When exiting Sqed/32 one or more of the following errorlevel may be returned : 1: New NetMail has been entered 2: New EchoMail has been entered 4: New LocalMail has been entered Of course combinations of these errorlevels are possible also. For example, an errorlevel of 3 means that both, new NetMail and new EchoMail have been entered. Origins Description: Origins are attached to the end of messages in echo areas (for netmail areas look at page 31). Your origin should give a small description of your mailbox. A more or less silly sentence or joke appears to be the real standard, though. Sqed/32 uses the origin defined in SQUISH.CFG as the default origin. However, you can define specific origins for each echo area if you like. In order to specify an origin line for a squish-area, simply add a file .SQO and put the origin at the first line of this file. Example: Let's assume your SQUISH.CFG contains the following definition: EchoArea OS2 F:\POINT\MESSAGES\OS2\OS2INTL -$ 2:2405/111 Now create the file OS2INTL.SQO in the directory F:\POINT\MESSAGES\OS2 and enter the desired origin line. In case you use SEADOG-Echos, Sqed/32 looks for a file called ORIGIN. The rest is similar to Squish- areas. Syntax: ---------------------------------------------------------------------- Page 40 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- inapplicable Examples: inapplicable Limitations: inapplicable ---------------------------------------------------------------------- Page 41 - Configurating Sqed/32 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Dialogs Find You can invoke the find-dialog by pressing [CTRL+F] within the main window. With the find-dialog you can easily find messages by specifying one or more search criteria. In the left upper part of the dialog you will find four checkboxes. You can select all checkboxes at the same time. These checkboxes tell Sqed/32 where to search: - 'From' -> From field - 'To' -> To field - 'Subject' -> Subject field - 'Text' -> Message text By pressing the 'Add' button the currently selected search pattern is added to the search criteria window in the lower left part of the dialog. A search pattern always consists of two elements: Where to search and what to search for. The four checkboxes tell Sqed/32 where to search. The 'Contents' field tells Sqed/32 what to search for. If you define more than one search pattern, these patterns are combined with an OR operation. Therefore all messages that satisfy at least one of the conditions are found. Search is not case sensitive. You control the search process with the Video Wlayer on the lower left edge of the dialog. The leftmost button starts searching backwards, the middle button stops searching and the rightmost button starts searching forwards. Messages that satisfy at least one of the search patterns are displayed in the 'search results' listbox at the right side. You can go to one of these messages by simply clicking on it even if the search process is not finished yet, as the search process is a background operation with its own thread. You end the query by pressing the 'End query' button. Replylist This dialog appears only when reading through messages using the keyboard or the Video Wlayer. Moreover the Replylist-Option (page 21) has to be enabled. If a message has more than one reply and you ---------------------------------------------------------------------- Page 42 - Dialogs Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- press [CTRL-RIGHT] or the corresponding Video Wlayer button, the replylist dialog pops up and shows you all replies to the current message. Now choose which reply you want to read. Export file You can activate this dialog using the main menu (Edit Export) or the context menu in the messaglist window. Simply enter path and filename and the currently marked messages are exported to this file in ASCII-Format. Filerequest dialog This dialog is activated by pressing CTRL-G within the main window. This dialog actually is a file request assistant and makes file requesting nice and easy. The first half of the dialog provides information about the system that you are requesting the files from. This data is retrieved from the current message and the nodelist. You cannot alter these fields. The combo box in the middle helps you choosing the area, where the request message is places. Usualle this is your netmail area. All filenames Sqed/32 could discover in the message text are listed in the listbox at the bottom of the dialog. Simply select one or more files and click on the 'Request'-Button to automatically generate a request-message that can be processed by your mail processor (e.g. Squish). This message has the KILL- flag set. The priority of this message is set according to the default values in the options notebook (see page 27). The 'Cancel'-button aborts the current operation and therefore no request message will be generated. Import Export Kludges This dialog is available only in bad areas and dupe areas. You will only see it if you enabled the corresponding checkboxes in the options notebook (see page 22). All kludges of the current message are displayed in this dialog. This might help you discover the reasons for dupes or bad messages. ---------------------------------------------------------------------- Page 43 - Dialogs Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Messagelist This window contains all unread messages of the current area. This is the fastest way to get an overview about messages and replies. For each message its subject line and sender are displayed. After the sender, all replies to this message are shown, represented by their senders. WARNING: Each message is only displayed once in the message list. If a message is already displayed in the reply list of another message, it will not appear again. Replies are indented a bit. Actually you may find the resulting structure similar to a message- tree. Since describing this technique is quite difficult, how about an example: ----------------------- Very stupid subject! Jan-Peter Koopmann J”rg-Stefan Sell Volker Weber Bill Clinton Next stupid subject! Volker Weber ----------------------- Explanation: The first message with the subject "Very stupid subject" was written by Jan-Peter Koopmann and has two direct replies: J”rg-Stefan Sell and Bill Clinton . Volker Weber, again, replied to J”rg-Stefan Sell's message... I hope you get the picture ! Just watch the message window a bit and you will find out yourself ! By the way: Does anybody really read this documentation ? If you really happen to read this, write me a small message. Just curious if this work pays off.... In order to work correctly, messages have to be linked to their replies. Linking messages by comparing their subject lines is not a very suitable solution. Therefore please forget Squish's linking feature. It will not provide the linking necessary for Sqed/32. It does not provide real message linking at all, by the way. Several message kludges provide a much better way of linking messages. All good fido message editors should make use of the REPLY kludge. If you reply to a message, your reply should therefore contain a REPLY kludge and the message id of the message you are refering to. If we could somehow link all messages using their MSGIDs and REPLY kludges, we would really have the sort of linking Sqed/32 needs. In fact this appears to be the only reasonable way of linking messages at all. Several utilities provide ---------------------------------------------------------------------- Page 44 - Dialogs Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- just this. One utility is SQMLINK. Please refer to the corresponding documentation for more detail. Now if you want to change to a specific message, simply double click on the sender of the message and the Sqed/32 will display the desired message in the main window. Of course you can mark one or more messages using standard OS/2 procedures. Then you can use the context menu to process all marked messages at the same time. You will find a detailed explanation of the message window context menu on page 49. Nodelist This dialog will be completely redesigned in the near future. Hold on ! About Sqed/32 This dialog provides some information about Sqed/32 (version, date of compilation, programmer, beta tester, copyright etc.) ---------------------------------------------------------------------- Page 45 - Dialogs Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Shortcuts Key Function Menu item ----- -------- --------- F1 Help on Sqed/32 Help F2 Save message F3 End Sqed/32 Message Quit Alt+F6 Switches between open Sqed/32 windows Strg+A Activate arealist View arealist Strg+C Change message Message Change Strg+F Find somethin within messages Strg+G Automatically request files Strg+I Import file into Edit message text Import Strg+K Copy message to Message other area Copy Strg+L Activate View messagelist Messagelist Strg+M Move message to Message other area Move Strg+N Create new message Message New Strg+Q Reply with quoting Message Reply With quoting Strg+R Reply without Message quoting Reply Without quoting Strg+T Mark current message in the messagelist [Pos1] Go to the first message in the current area [Ende] Go to the last message in the current area [Links] previous message [Rechts] next message + change to the next area Taste Funktion Menpunkt ----- -------- --------- - change to the previous area CTRL+ Go to the message [Links] the current message refers to. ---------------------------------------------------------------------- Page 46 - Shortcuts Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- CTRL+ Go to reply (or [Rechts] replies) of the current message CTRL+ Insert macro SHIFT Open context-menu +F10 Esc Discard message DEL Delete message Message Delete SHIFT Paste contents of Edit +[Einfg] the clipboard Paste (TEXT only!) CTRL+ Copy marked text Edit [Einfg] to clipboard Copy CTRL+ Move marked text Edit [Entf] to clipboard Cut ---------------------------------------------------------------------- Page - Shortcuts 47 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- The Toolbar The Video Wlayer The Video Wlayer is located in the upper right corner of the main window and consists of six buttons. |< Go to the first message of this area << One message back in the current message thread < Go to the previous message > Go to the next message >> Go to the next message in the current message thread If the current message has more than one reply and you enabled the 'Reply list' option (page 21) a dialog box with all available replies will pop up. >| Go to the last message of this area While editing messages the Video Wlayer is replaced by two buttons: - Save The current message is saved. - Discard Cancels current operation and discards all changes Message attributes ---------------------------------------------------------------------- Page 48 - Toolbar Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Context menus Most of the entries in the context menus refer to corresponding menu items and therefore need no more explanation at this point. Main window, reading messages New Reply -> With quoting -> Without quoting Forward Change Delete Current message will be deleted. You have to confirm this action ! View -> Path Kludges -> ^A Kludges -> Seen By Kludges Quit Main window, writing messages Save Discard Messagelist Delete All marked messages / threads will be deleted. Move ny/a Copy ny/a Export A marked message will be exported to an ASCII-file using the Export dialog. ---------------------------------------------------------------------- Page 49 - Context menus Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Refresh Rebuilds the messagewindow starting with the currently active message. Arealist ---------------------------------------------------------------------- Page 50 - Context menus Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- History of Sqed/32 Version Remarks ------- --------- 0.0,0.1 First steps 16 bit application 0.2x First 32 bit Version vowe starts working on the design 0.3x First internal beta 0.4x ---------------------------------------------------------------------- Page - History of Sqed/32 51 Sqed/32 for the OS/2 Presentation Manager, Version 1.0 ---------------------------------------------------------------------- Beta tester Peter Bankmann Oliver Ludwig Dirk Billerbeck Mario Martelli Andreas Braukmann Andrea Mennini Oliver Bruckauf Roland Mhlst„dt Vince Coen Carsten Mller Bernd Dammrose Carsten Pragst J”rg Dreffein Hermann Reissig roland gautschi (rol+) Hanspeter Roos Thorsten Grimme Peter Scheffer Oliver Hart Leonhard Scheiber Dirk Heind”rfer Roland Schiradin Heinrich Kern Carsten Schmidt Jan-Peter Koopmann Jochen Schnrle G”tz Kopmann Thomas Swoboda Jrgen Koslowski Wilfried Tresp Thomas Krause Eberhard Wagner Marco Kremer Volker Weber (vowe) Frank Kppers Peter Wienandt Michael Linse Peter van Wiggen I am afraid this list is not totally complete. In case I forgot someone: I am really sorry. Contact me! ---------------------------------------------------------------------- Page 52 - Beta tester Sqed/32 fr den OS/2 2.1 Pr„sentations Manager, Version 1.0 ================================================================================ Special thanks Special thanks to my parents needs no explanations, does it? Volker Weber who created 95% of the editor's design and hence made it useful ! Dirk Billerbeck for his great documentation roland gautschi who always provided me with great tips and examples at any time of the day (and night). His MSGED/EE experience really helped a lot ! [please come back!!!], Tom Jennings for FidoNet, Jim Nutt for the first usable FidoNet editor Scott J. Dudley for his perfect Squish messagebase and its API Achim, Annette, who always coped with my Carlo, Martin moods IBM Corp. for all OS/2 versions and the CSet/2 Compiler ================================================================================ Seite 53 - Special thanks Sqed/32 fr den OS/2 2.1 Pr„sentations Manager, Version 1.0 ================================================================================ Index Arealist, 14 Beta tester, 52 CompuServe, 10 Context menu main window, 49 messagelist, 49 Discard, 48 EchoMail, 40 ENGLISH.DLL, 12 Errorlevel, 40 Fido, 9; 10; 15 FidoNet, 9; 10; 15 GerNet, 10 IBM, 9; 11; 53 INI-files, 15 Internet, 10 LocalMail, 40 Message Delete, 13; 49 Messagelist, 14 MSGAPI, 11 NetMail, 40 OS/2, 9; 11; 53 REPLY, 44 Save, 48 Sqed/32, 9; 45 Quit, 49 Registration, 10 Support, 10 Squish, 11; 16 SQUISH.CFG, 12; 15 ================================================================================ Page 54 - Index Sqed/32 fr den OS/2 2.1 Pr„sentations Manager, Version 1.0 ================================================================================ Video Wlayer, 48 VirNet, 10 ================================================================================ Page 55 - Index