home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / wsedit-o.zip / wsedit-e.HLP (.txt) < prev    next >
OS/2 Help File  |  2003-05-22  |  81KB  |  1,379 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5.  WSedit - Write&Set Editor 0.95, Mai 2003 
  6.  
  7. Freeware Editor for OS/2, eCS, Windows95/98/ME/NT/2000/XP and Linux (planned) 
  8. which reads Wordstar (DOS) 4-7 and ASCII (ISO and IBM  codepage) and writes 
  9. Wordstar 4 and ASCII format (ISO and IBM codepage). User Interface CUA (Windows 
  10. Standard) and Wordstar (with Ctrl shortkeys). 
  11.  
  12. Most Wordstar Ctrl commands are supported. The behaviour of WSedit depends on 
  13. the text file extension. In the settings notebook, you can define different 
  14. properties dependent on the file extension of the file. 
  15.  
  16. The idea of WSedit is to have a modern graphical 32-bit application with 
  17. look-and-feel of old Wordstar for DOS and Windows editor behaviour 
  18. simultaneously. You can also use WSedit without knowing Wordstars Ctrl commands 
  19. ("Ctrl" is abbreviated ^) and without knowing about the Wordstar file format: 
  20. if you don't use the Wordstar file format, WSedit is a powerful text editor for 
  21. large ASCII files with/without word wrapping. In this case, it will be 
  22. nevertheless useful for you to take a look at the dot commands for unformatted 
  23. files and at the Ctrl commands. 
  24.  
  25. The WSedit Freeware program is a part of the full-featured Shareware 
  26. wordprocessing suite Write&Set. Write&Set consists of two programs: one for 
  27. writing (WSedit) and one for "setting" - means formatting, previewing and 
  28. printing (WSformat). If you have installed both WSedit and WSformat, you get 
  29. the look-and-feel of a single program. Write&Set is based on Wordstar dot 
  30. commands (formatting commands in the text, beginning with a dot at the 
  31. beginning of a line). You enter a raw text with dot commands and without fixed 
  32. margin in WSedit (WS file). After you have finished writing, WSformat will 
  33. compile the raw text to a formatted text (FMT file) with fixed margins which 
  34. can be viewed again in WSedit. This formatted text can be previewed and printed 
  35. to all printers which are installed on your operating system. Write&Set 
  36. supports contents, index, footnotes, bitmaps, hyphenation. In opposite to 
  37. Winword-like programs, Write&Set won't get problems if text documents gets 
  38. large. For more information, visit http://www.WriteAndSet.com . 
  39.  
  40. To convert Write&Set files to hypertext formats, you are encouraged to download 
  41. Hypermake http://www.hypermake.com . It is a hypertext compiler which compiles 
  42. Write&Set files, Wordstar 4 files or ASCII files with Write&Set syntax to HTML, 
  43. Winhelp, MS HTML-Help or IBM Help. Hypermake is Freeware for a text file length 
  44. up to 20 kB, otherwise Shareware. 
  45.  
  46. To get a short impression how a Write&Set raw text file looks like, you will 
  47. find the raw text of this documentation in the Write&Set archive file 
  48. (docusrc\WSedit-e.WS). You can format and print this raw text by using 
  49. WSformat. I have used Hypermake to generate a Help file from this raw text 
  50. file. 
  51.  
  52. Important note for Wordstar 5-7 users: please note that WSedit always saves 
  53. Wordstar files in Wordstar 4.0 Format. Additional Wordstar 5-7 features get 
  54. lost or, e.g. footnotes, will be converted to Write&Set format. 
  55.  
  56. subchapters: 
  57. Feature list 
  58. (no) installation 
  59. More about Write&Set 
  60. Differences to Wordstar 4 
  61.  
  62. next chapter: 
  63. Essentials of WSedit 
  64.  
  65.  
  66. ΓòÉΓòÉΓòÉ 1.1. Feature list ΓòÉΓòÉΓòÉ
  67.  
  68. WSedit has got the following properties: 
  69.  
  70.      in opposite to Wordstar DOS native Windows or OS/2 program, later also 
  71.       Linux, of course supporting long filenames 
  72.      reading and writing TXT files, reading WS4 and WS5-WS7, writing WS4 
  73.      CUA key support (Windows key commands) 
  74.      detail behaviour appropriate to WS4/5 
  75.      holding different user settings dependent on the file extension of the 
  76.       text file 
  77.      when working with an unformatted file, text is reformatted if the window 
  78.       width is changed (word wrap) 
  79.      switching between different screen fonts (for the whole document) 
  80.      no 80 column limit like Wordstar DOS 
  81.      paragraph formatting with soft characters ("snow characters") like 
  82.       Wordstar 
  83.      nearly no file size limit (there seems to be a limit at approximately 20 
  84.       MB) 
  85.      supports workgroups (one person has write access, the others can only 
  86.       read) 
  87.      contents tree in a separate window like a directory tree to navigate in 
  88.       large documents 
  89.      command highlightning (e.g. for HTML files) 
  90.      marking lines with Hard Return and Soft Return in the rightmost column 
  91.      multi undo, undo slider window 
  92.      TXT Import and Export (IBM and ISO codepage) 
  93.      highlightning spell-checking function where you can let analyse your own 
  94.       already spell-checked files to get a personal dictionary 
  95.      translation functionality if you download separate translation files 
  96.      Macro recorder for defining Function keys 
  97.      last but not least, very fast and stable. 
  98.  
  99.  
  100. ΓòÉΓòÉΓòÉ 1.2. (no) installation ΓòÉΓòÉΓòÉ
  101.  
  102.  
  103. The Write&Set archive file has got an installation program included which 
  104. installs WSedit and WSformat together and creates file associations and entries 
  105. in the start menu. 
  106.  
  107. Using WSedit as an stand-alone application does not need a real installation 
  108. program. Unpack the files of the archive to a new directory of your choice. To 
  109. "install", simply create a new program object (OS/2) or make a shortcut of the 
  110. EXE file (Win) by dragging the WSedit.EXE file to your desktop; while dropping, 
  111. press Shift and Ctrl simultaneously. This will create a shortcut pointing to 
  112. the EXE file. Now you can drag and drop arbitrary text files to the WSedit icon 
  113. on your desktop. (Win) Double clicking to a text file with unknown extension 
  114. like ".WS" will show a dialog where you can choose the WSedit.EXE file as the 
  115. default program to open with. 
  116.  
  117. For installing Write&Set (WSedit together with WSformat), run the INSTALL 
  118. program after unpacking the archive file. 
  119.  
  120.  
  121. ΓòÉΓòÉΓòÉ 1.3. More about Write&Set ΓòÉΓòÉΓòÉ
  122.  
  123.  
  124. WSedit has no formatting and printing ability. This does WSformat. WSedit and 
  125. WSformat together are "Write&Set". This is a full-featured word-processing 
  126. software supporting hyphenation, graphics, footnotes, contents and so on. 
  127. Please visit http://www.WriteAndSet.com 
  128.  
  129. Word processing with Write&Set is very different from those Windows word 
  130. processing programs such as Winword or StarOffice, and also differs in some 
  131. respects from Wordstar for DOS. Word processing operations are closer to Latex 
  132. than to Winword. With Write&Set, the task of 'text content editing' and that of 
  133. 'typesetting' are sequention operations, rather than simultaneously. This 
  134. concept simplifies word processing and enables you compiling a single document 
  135. with hundreds of pages without any problems. The way to get a complex document 
  136. involved some or all of the following steps: 
  137.  
  138. Step 1: Editing Text is prepared as an (unformatted) 'raw' text file (a WS 
  139. file) using WSedit. Such a text file will not include fixed margins. If you use 
  140. WSedit, the margin of the displayed text depends only on the settings of the 
  141. editing window and the screen font. 
  142.  
  143. Step 2: Starting WSformat, formatting the unformatted raw-text WS file to 
  144. produce a formatted FMT file: 
  145.  
  146. The WSformat 'format' function reads the raw-text WS file and writes an FMT 
  147. file. It does not modify the WS file in any way. In the FMT file, which can be 
  148. also viewed using WSedit or Wordstar (DOS), the right margin is now fixed, the 
  149. page breaks are apparent, and words at the end of the line which require 
  150. hyphenation are displayed accordingly. 
  151.  
  152. Step 3: Minor changes by hand on the formatted FMT file 
  153.  
  154. If you are not satisfied with some formatting details, you can make small 
  155. changes to the FMT file. These include such things as incorrect hyphenations, 
  156. and more importantly, page breaks which can be improved. 
  157.  
  158. However, avoid making bigger changes to the FMT file; if these are considered 
  159. necessary, it is more expedient to make the changes to the WS file and run 
  160. WSformat again. Because WSformat formatting is extremely fast (about 100 pages 
  161. per second, depending on your processor and the nature of the text), this does 
  162. not represent a significant delay in production. 
  163.  
  164. The WSformat preview feature helps in locating sections of the text where the 
  165. printout can be improved. The printout in the Preview window mirrors exactly 
  166. page printout. 
  167.  
  168. Step 4: Printing the final version of the document 
  169.  
  170. After making the final changes to the FMT file, select in WSformat the physical 
  171. or virtual printer installed on your computer and print your document. This is 
  172. done the same way as it would be for other current word processors. Besides 
  173. physical printers (laser or inkjet printers), it is possible to use 'virtual' 
  174. printers (FAX and PDF creation programs). 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ 1.4. Differences to Wordstar 4 ΓòÉΓòÉΓòÉ
  178.  
  179.  
  180. I tried to get the same look-and-feel like Wordstar 4. If you find differences, 
  181. please let me know. 
  182.  
  183. But there are some essential differences caused by the different internal 
  184. structure of WSedit. 
  185.  
  186. The WSedit editor is based on a non-wordwrap line-orientated editor written for 
  187. programmers which already supports some Wordstar Ctrl commands. It's an 
  188. object-orientated program, so I had to add or to overwrite some parts like 
  189. word-wrapping, spell-checking, paragraph indention and so on. But I can't 
  190. change some essentials of the editor. These essential properties - different to 
  191. Wordstar DOS - are: 
  192.  
  193.      The editor holds all characters in lines which are limited to 255 
  194.       characters. 
  195.  
  196.      The characters you will see are the same which are stored in the memory 
  197.       of the computer. In consequence, some Wordstar behaviour of showing text 
  198.       is not possible: 
  199.         -  It won't be possible to draw a line behind ".PA", instead WSedit 
  200.            shows the page break by background-highlightning 
  201.         -  ^OD "do not show toggles" is available since 0.92, but pressing any 
  202.            key will show the toggles again: You can't type while toggles are 
  203.            not shown. 
  204.         -  Snow characters (soft spaces) are directly stored in the memory by 
  205.            the ASCII character you will see in WSedit (ALT-176); you can 
  206.            directly enter this character by ALT-176 or ^I. The TAB key is 
  207.            identical to ^OG. 
  208.         -  If you enter ^OB to omit the snow characters, all snow characters of 
  209.            the file are changed from ALT-176 to ALT-255 which is a second SPACE 
  210.            character; after retyping ^OB, ALT-255 is re-changed to ALT-176. So 
  211.            don't use these two characters in your text for other purpose. 
  212.         -  For hyphenation characters at the end of the line, ALT-240 is used. 
  213.  
  214.  
  215.  After saving a WSedit WS file, the file is accurately identical to Wordstar 4. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 2. Essentials of WSedit ΓòÉΓòÉΓòÉ
  219.  
  220.  
  221. subchapters: 
  222. Rightmost Column 
  223. Marking Text 
  224. Titlebar 
  225. Menu Bar, Popup Menu 
  226. Ctrl Menu 
  227. Drag and drop 
  228. Undo 
  229.  
  230. next chapter: 
  231. Dot commands 
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ 2.1. Rightmost Column ΓòÉΓòÉΓòÉ
  235.  
  236.  
  237. The background of the rightmost column of the editor shows different colors if 
  238. this property is enabled (Ctrl-OO settings notebook - highlt): 
  239.  
  240.      Lines beginning with two dots (comment lines) 
  241.      Lines beginning with a single dot (dot commands) 
  242.      Lines with a Hard Return at the end 
  243.      Lines with a Soft Return at the end. 
  244.  
  245.  
  246.  A Hardreturn is the end of a line where you have entered RETURN manually. In 
  247.  any formatting, this Return will exist. 
  248.  
  249.  A Softreturn disappears if the formatting gets different. If you change the 
  250.  window size of WSedit and you edit an unformatted file, the editor let appear 
  251.  and disappear Soft Returns. 
  252.  
  253.  In the "special functions" menubar item, you will find commands where you can 
  254.  transform text with Softreturns into text with Hardreturns and reverse. 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 2.2. Marking Text ΓòÉΓòÉΓòÉ
  258.  
  259. WSedit blocks exists independent from the cursor. In classic graphical text 
  260. editors and wordprocessing applications, a block is a "big cursor" and the 
  261. cursor is no more existing while a block is marked. The WSedit block will only 
  262. disappear if you click with the mouse again into the window, but not with 
  263. Cursor movements by using Cursor keys. 
  264.  
  265. Blocks created by Wordstar Ctrl commands have got different  properties, they 
  266. do not disappear even you click with the mouse into the window again, see 
  267. Chapter Ctrl Commands - Block commands. 
  268.  
  269.  
  270. ΓòÉΓòÉΓòÉ 2.3. Titlebar ΓòÉΓòÉΓòÉ
  271.  
  272.  
  273. The titlebar of the WSedit window shows a lot of information. 
  274.  
  275. (4,226*) in parenthesis means Column 4 and Line 226, the * star shows you that 
  276. the file was modified since the last Save. 
  277.  
  278. The "Par" (german "Abs") number counts the Hard Returns up to the cursor 
  279. position, dot commands are also counted. In unformatted files, the line number 
  280. in parenthesis is dependent on the current formatting, so the "Par" number is 
  281. the only useful orientation you will have in unformatted files! 
  282.  
  283. In Write&Set formatted files (FMT files), an additional "P" and "L" number 
  284. (Page, Line) is shown like Wordstar does (german "S" and "Z"). These values 
  285. depends on the page formatting dot commands. 
  286.  
  287. Then, the filename is shown. 
  288.  
  289. If the column block mode (^KN) is activated, "COLUMN" is shown. 
  290.  
  291.  
  292. ΓòÉΓòÉΓòÉ 2.4. Menu Bar, Popup Menu ΓòÉΓòÉΓòÉ
  293.  
  294.  
  295. WSedit has got a Menu Bar and a Popup menu (activated with the right mouse 
  296. button) which are functionally identical. To get a maximum of room for text, 
  297. you can disable the Menu Bar (Options - Show/Omit Menu Bar). To get the Menu 
  298. Bar back, press the right mouse button and select the same menu item again. 
  299. "Options" - "Windows-like Popup" switches between two appearances of the popup 
  300. menu. 
  301.  
  302. The Menu shows important commands or commands which are not expected in a 
  303. "Wordstar-like" editor. Some functionality which affects the whole file and 
  304. which is not often used is only located in the Menu and is not in reach from 
  305. Ctrl key commands. Macro recording only works with key commands and not with 
  306. the Menu. 
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 2.5. Ctrl Menu ΓòÉΓòÉΓòÉ
  310.  
  311.  
  312. You can activate the Ctrl Menu by typing ^J (means Ctrl-J) or by typing the 
  313. "Wordstar Ctrl-key menu commands" ^K ^Q ^O and ^P. These Ctrl commands expect a 
  314. second character key and are not typed alone. If you type one of these commands 
  315. alone and wait a moment, the Ctrl Menu automatically appears. 
  316.  
  317. If the Ctrl Menu has got the focus, you can type the missing second character 
  318. key or you can doubleclick to the function you want to have executed. 
  319.  
  320. When typing Ctrl commands fast (by heart), the Ctrl Menu does not appear 
  321. automatically. In the settings notebook, page misc, you can define the time 
  322. delay for activating the Ctrl Menu. 
  323.  
  324.  
  325. ΓòÉΓòÉΓòÉ 2.6. Drag and drop ΓòÉΓòÉΓòÉ
  326.  
  327.  
  328. You are allowed to drag and drop a marked block to another text position or to 
  329. another WSedit window. To drag and drop, use the right mouse button. The 
  330. default function is moving the block. Pressing CTRL while dropping will copy 
  331. the block. You are also allowed to drag text file icons to a specific position 
  332. of the text area. This will read the file (Wordstar Ctrl-KR). 
  333.  
  334.  
  335. ΓòÉΓòÉΓòÉ 2.7. Undo ΓòÉΓòÉΓòÉ
  336.  
  337.  
  338. WSedit has got a powerful multi undo functionality. 
  339.  
  340. You can undo your input by typing Alt-Backspace and redo by typing 
  341. Shift-Alt-Backspace or you can open the Undo Slider window by pressing ^OU. 
  342.  
  343. The number of undo events can be set by the user, see Misc Page of the settings 
  344. notebook. The recommendend number of undo events depends on the settings (press 
  345. ^OO) of the Wrap Page. 
  346.  
  347.  
  348. ΓòÉΓòÉΓòÉ 3. Dot commands ΓòÉΓòÉΓòÉ
  349.  
  350. A dot command is part of normal text you type into the editor. A dot command is 
  351. a complete line beginning with a dot, for example 
  352.  
  353. .BD 
  354.  
  355. If there's not dot at the first column, the line will be printed and not 
  356. interpretated. 
  357.  
  358. If you want to use WSedit as an ASCII editor, you can use dot commands 
  359. nevertheless. In the "File - Export" function, there's a dot command filter. 
  360.  
  361. Dot commands aren't case sensitive. Some dot commands require parameters, for 
  362. example 
  363.  
  364. .TB10 
  365.  
  366. will set a tabulator stop at column 10. You can leave a space between the dot 
  367. command and the parameter. 
  368.  
  369. A very useful dot command is a line beginning with a double dot: 
  370.  
  371. ..don't forget to add this and this! 
  372.  
  373. This is a comment line which won't be printed. In the "File - Export" function, 
  374. you can choose whether to export comment lines or not. 
  375.  
  376. subchapters: 
  377. unformatted files 
  378. formatted files 
  379.  
  380. next chapter: 
  381. Ctrl Commands 
  382.  
  383.  
  384. ΓòÉΓòÉΓòÉ 3.1. unformatted files ΓòÉΓòÉΓòÉ
  385.  
  386.  
  387. In comparison to WSformat and Hypermake, WSedit (unformatted) interpretes only 
  388. a few dot commands: 
  389.  
  390.  .TB 5,7,10,20 
  391.  
  392. With ".TB" (a Wordstar 5 command), you can set the tabulator stops: You can let 
  393. jump the cursor to the next tabulator stop by typing TAB or ^OG; up to the 
  394. tabulator stop, "snow characters" are automatically inserted. The default 
  395. setting is ".TB4". With "File - Export", snow characters are converted to 
  396. spaces or ASCII tab characters. 
  397.  
  398. You can change the ".TB" value and then type Ctrl-B on the lines which you want 
  399. to have modified. Ctrl-B is a on-screen formatting command which uses the tab 
  400. stops of the last ".TB" command. 
  401.  
  402.  .BE  (enabling word wrap) 
  403.  .BD  (disable word wrap) (or .BA) 
  404.  
  405. Normally, word wrap is on. In tables, it can be necessary to turn off and on 
  406. word wrap functionality. You can do it by typing the commands ".BE" word wrap 
  407. enabled and ".BD" word wrap disabled. 
  408.  
  409. Because WSedit cannot handle lines larger than 255 chars, ".BA" sets the right 
  410. margin to 250, and this will have (nearly) the effect of turning word wrap off. 
  411.  
  412.  .RM 60 
  413.  
  414. The Wordstar Right Margin command is interpreted while writing an unformatted 
  415. WS file to disk. By default, a WS file created by WSedit will have set the 
  416. right margin to 78, so you can read the WS file with a DOS Wordstar without 
  417. problems. On the WSedit screen, you won't see an effect of ".RM". 
  418.  
  419.  
  420. ΓòÉΓòÉΓòÉ 3.2. formatted files ΓòÉΓòÉΓòÉ
  421.  
  422.  
  423. If you don't use Write&Set or Wordstar (DOS) and use WSedit stand-alone, you 
  424. won't need to work with formatted files. "WSedit (formatted)" means using 
  425. WSedit together with files with extension ".FMT" instead of ".WS" or ".TXT". 
  426. FMT files are automatically created by WSformat. 
  427.  
  428. WSedit (formatted) shows the page breaks like Wordstar does it. For counting 
  429. lines and pages, only four commands are interpreted: 
  430.  
  431.  .PL  (Page length) 
  432.  .MT  (Margin Top) 
  433.  .MB  (Margin Bottom) 
  434.  .LH  (Line Height) 
  435.  
  436. Instead of showing a page break line, WSedit (formatted) shows the page break 
  437. by highlightning the background, dependend on the "Highlightning" settings in 
  438. the Highlt Page of the settings notebook. 
  439.  
  440. In formatted files, automatic word wrapping is disabled. This is defined on the 
  441. "wrap" page of the settings notebook. 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ 4. Ctrl Commands ΓòÉΓòÉΓòÉ
  445.  
  446.  
  447. subchapters: 
  448. "I hate the mouse..." 
  449. Cursor movement 
  450. Quick commands 
  451. Block commands 
  452. Toggles and Special chars 
  453. Delete text 
  454. The Trash Buffer 
  455. On-screen Formatting 
  456.  
  457. next chapter: 
  458. Special Functionality 
  459.  
  460.  
  461. ΓòÉΓòÉΓòÉ 4.1. "I hate the mouse..." ΓòÉΓòÉΓòÉ
  462.  
  463.  
  464. WordStar is a very old editor which was already available before the first IBM 
  465. PC existed. In this time (end of the 70's), the computers had got a Ctrl key 
  466. but nearly nothing more than a typewriter keyboard. Keys like "Page down" were 
  467. not available on all computers this time. The mouse was not invented yet. So it 
  468. was necessary to have the full functionality of a Computer text editor by using 
  469. Ctrl and the character keys from A to Z. 
  470.  
  471. Today, the Wordstar Ctrl commands can be very useful for people who type blind 
  472. to the keyboard. If you can type blind, you should take a look at the Ctrl 
  473. commands. They offer you the ability of blind cursor movement, block 
  474. manipulation and more - all commands where you normally use the mouse. 
  475.  
  476. If you take a look at the Ctrl Dialog window (press Ctrl-J) and you are not 
  477. familiar with Wordstar Ctrl commands, you will think it's difficult to learn 
  478. this. But it is easier than it looks, because there's a logical principle 
  479. behind the key combinations. 
  480.  
  481. Ctrl is abbreviated ^. The Ctrl-keys overview window (Ctrl Menu, press ^J) is 
  482. complete, this overview not. 
  483.  
  484. To locate the text cursor which your eyes lost, press the CTRL key alone 
  485. without another key. This will force Cursor highlightning, if it is enabled 
  486. (^OO settings notebook, page misc). 
  487.  
  488.  
  489. ΓòÉΓòÉΓòÉ 4.2. Cursor movement ΓòÉΓòÉΓòÉ
  490.  
  491.  
  492. Take a look at your keyboard. Between the S and the D key, you have to imagine 
  493. a central point. This is the geometrical center of all cursor movement keys: 
  494.  
  495. ^S, ^D: Cursor left, right 
  496. ^A, ^F: Word left, right 
  497. ^E, ^X: Cursor up, down 
  498. ^R, ^C: Page up, down 
  499. ^W, ^Z: Scroll up, down 
  500.  
  501. (For german users: Z and Y is changed on german keyboards) 
  502.  
  503.  
  504. ΓòÉΓòÉΓòÉ 4.3. Quick commands ΓòÉΓòÉΓòÉ
  505.  
  506. By typing ^Q ("Quick") before some of the commands above, you will get a 
  507. "strong" or "repeat" effect: 
  508.  
  509. ^QS, ^QD: Cursor to the begin, to the end of the line 
  510. ^QE, ^QX: Cursor to top, end of window 
  511. ^QR, ^QC: Cursor to the begin, end of the document 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ 4.4. Block commands ΓòÉΓòÉΓòÉ
  515.  
  516. In addition to the "modern" mouse selection of text, this editor supports the 
  517. Wordstar block commands. Blocks marked by Wordstar commands are not transient. 
  518. The marking of the block disappears only if you delete the block (^KY) or if 
  519. you hide the block (^KH). Marking a block by using the mouse will be transient: 
  520. clicking into the text with the mouse will let go the block. Nevertheless, you 
  521. can mix CUA commands (like Ctrl-Ins for "copy block into clipboard") with 
  522. Wordstar Ctrl commands. 
  523.  
  524. ^KB: mark the beginning of the block 
  525. ^KK: mark the end of the block 
  526.  
  527. ^QB: jump "quick" to the beginning of the block 
  528. ^QK: jump "quick" to the end of the block 
  529.  
  530. ^KC: copy the block to the cursor position 
  531. ^KV: move the block to the cursor position 
  532.  
  533. ^KR: read file into block at the current cursor position 
  534. ^KW: write block into file 
  535.  
  536. ^KY: delete block 
  537. ^KH: hide/show block marking 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 4.5. Toggles and Special chars ΓòÉΓòÉΓòÉ
  541.  
  542. You can enter the ASCII characters with the decimal numbers from 1 up to 26 by 
  543. entering ^P, followed by a character key from A to Z. To get ASCII 1, enter 
  544. ^PA, for ASCII 2 enter ^PB and so on. 
  545.  
  546. There are a few exeptions: 
  547.  
  548.      To get an ASCII character 0 in Wordstar files (^P@), press ^PZ. 
  549.      The ^Z character is not supported, of course. (Some editors interprete 
  550.       this character as "end of file".) 
  551.      ^M and ^J (decimal 13 and 10) is also omitted. These characters 
  552.       represents a Return in an ASCII text. 
  553.  
  554.  
  555.  Write&Set and Wordstar use some of these characters as "toggles", that means 
  556.  they are used in pairs. E.g. ^PS turns underlining on and off. 
  557.  
  558.  Besides ^PZ (Wordstar ^P@), the corresponding character images of the IBM 
  559.  Codepage are shown, e.g. ^PB is a face, ^PS a double exclamation mark. 
  560.  
  561.  If WSedit was loaded with a Wordstar file, a new item "emphasize" appears in 
  562.  the menu bar. With this menu, you can insert toggles and special chars with 
  563.  the mouse. Marking a block before using this command let you insert toggle 
  564.  chars in pairs. 
  565.  
  566.  Only the editor itself accepts ^P commands. If you want to enter these ASCII 
  567.  charcters into an edit field of the search dialog or the search/replace 
  568.  dialog, you can choose one of the following possibilities: 
  569.  
  570.      use the ALT-(Number) commands 
  571.      or put the ^P character from the editor into the clipboard and paste it 
  572.       to the editfield 
  573.      or type the character ^, followed by a letter, e.g. ^B for the "bold" 
  574.       character 
  575.      or type the hash (doublecross) sign, always followed by three digits 
  576.       representing the decimal ASCII value. 
  577.  
  578.  
  579.  By default, WSedit provides syntax highlightning for the toggles 
  580.  
  581.      ^PB bold 
  582.      ^PS underlined 
  583.      ^PT superscript 
  584.      ^PV subscript 
  585.      ^PY italic 
  586.  
  587.  
  588.  but you can change this in the Highlt page of the settings notebook. 
  589.  
  590.  
  591. ΓòÉΓòÉΓòÉ 4.6. Delete text ΓòÉΓòÉΓòÉ
  592.  
  593. The deleting keys are located in the middle of the keyboard: 
  594.  
  595. ^G: delete character on cursor position (same as DEL) 
  596. ^H: delete character left from cursor (same as BACKSPACE) 
  597. ^T: delete word right from cursor 
  598. ^Y: delete line 
  599. ^QY: delete line right from cursor 
  600.  
  601.  
  602. ΓòÉΓòÉΓòÉ 4.7. The Trash Buffer ΓòÉΓòÉΓòÉ
  603.  
  604.  
  605. If you use ^T, ^Y or ^QY for deleting, the deleted text part will be stored in 
  606. a "trash buffer". With ^U, you can paste the content of the trash buffer to the 
  607. current cursor position. This is e.g. useful for changing the position of two 
  608. words: ^T^F^U. The trash buffer is independent from the clipboard. 
  609.  
  610.  
  611. ΓòÉΓòÉΓòÉ 4.8. On-screen Formatting ΓòÉΓòÉΓòÉ
  612.  
  613. ^B reformats a paragraph on-screen. After some special commands, a line can 
  614. exceed the window width. In this case, typing ^B will reformat the current 
  615. paragraph. 
  616.  
  617. If you edit an unformatted file, the text fits always the window width. 
  618. Changing the window size will always reformat the whole file. You can also 
  619. force reformatting the whole file by typing ^OF. 
  620.  
  621. If you want to indent a paragraph, you can enter a TAB or ^OG at the beginning 
  622. of the paragraph. The indention depends on the last ".TB" dot command. 
  623.  
  624.  
  625. ΓòÉΓòÉΓòÉ 5. Special Functionality ΓòÉΓòÉΓòÉ
  626.  
  627.  
  628. subchapters: 
  629. Contents window 
  630. Spell checking 
  631. Function key macros 
  632. Read only files, Workgroups 
  633. Backup functionality 
  634. Translation 
  635.  
  636. next chapter: 
  637. Settings Notebook 
  638.  
  639.  
  640. ΓòÉΓòÉΓòÉ 5.1. Contents window ΓòÉΓòÉΓòÉ
  641.  
  642. The contents window is activated by entering ^OC or ^OI. You enter a heading in 
  643. your text by using the dot commands 
  644.  
  645.  .1 
  646.  This is a level-1 heading 
  647.  .2 
  648.  This is a level-2 heading 
  649.  .3 
  650.  This is a level-3 heading 
  651.  .3 
  652.  This is also a level-3 heading 
  653.  
  654. In the printed document and in the contents window, you will get a structure 
  655. like 
  656.  
  657.  1. This is a level-1 heading 
  658.  1.1 This is a level-2 heading 
  659.  1.1.1 This is a level-3 heading 
  660.  1.1.2 This is also a level-3 heading 
  661.  
  662. If you use "File - Export", the dot command will be interpreted and converted 
  663. e.g. to "1.1.2". 
  664.  
  665. WSformat and Hypermake are based on this heading syntax. 
  666.  
  667. Wordstar dot commands ".i1", ".i2" are automatically converted when loading a 
  668. WS file. 
  669.  
  670. If the contents window is open, you can double click to a line and you will get 
  671. to the editor position where the corresponding heading is located. 
  672.  
  673. If you press ^OC, the contents window will be simply opened. When typing ^OI, 
  674. in addition the heading will be marked where the editor cursor is currently 
  675. located. (In WSedit for OS/2, you have to scroll sometimes to see the marked 
  676. heading line.) 
  677.  
  678. There are some buttons at the bottom of the window: 
  679.  
  680.      expand and collapse the function tree 
  681.      refresh: the contents window and the go-to information for 
  682.       double-clicking to the heading lines will be actualized. If you double 
  683.       click and get to a wrong editor position, use "refresh". 
  684.      >clip: copies the text of the selected heading into the clipboard 
  685.      >file: writes the complete current contents into the file "tempcont.txt" 
  686.       in the current text directory. 
  687.      digit in editfield: represents the heading level which is written into 
  688.       the file. If you enter "3", the heading levels 1, 2 and 3 are written 
  689.       when using >file. 
  690.  
  691.  
  692. ΓòÉΓòÉΓòÉ 5.2. Spell checking ΓòÉΓòÉΓòÉ
  693.  
  694.  
  695. In WSedit, there is a simple but effective spell checking function implemented. 
  696.  
  697. subchapters: 
  698. How to get a dictionary 
  699. Working with the spell checking function 
  700.  
  701. next chapter: 
  702. Function key macros 
  703.  
  704.  
  705. ΓòÉΓòÉΓòÉ 5.2.1. How to get a dictionary ΓòÉΓòÉΓòÉ
  706.  
  707.  
  708. To use the spell checking function, you have to create a dictionary by yourself 
  709. or you can visit http://www.WriteAndSet.com and download the current dictionary 
  710. collected by WSedit users. 
  711.  
  712. All spell checking functionality is available from the Menu, item "spell 
  713. checking". 
  714.  
  715. You can enter a filename for the dictionary in the Dict Page of the settings 
  716. notebook. If you don't enter a directory, the spell checking file has to be 
  717. located at the same directory where WSedit.exe resides. 
  718.  
  719. If you want to create a dictionary by yourself, you need to have existing 
  720. Wordstar or ASCII files which are already spell-checked or where you can be 
  721. sure that there are no incorrect words: Load the file into WSedit and choose 
  722. "spell checking - absorb current file to dictionary". 
  723.  
  724. If you have received another WSedit dictionary file from a friend or from the 
  725. Internet, you can merge this file with "your" dictionary file by using "import 
  726. external directory". 
  727.  
  728. The principle of the WSedit dictionary is quite simple: If a word has to be 
  729. absorbed, the endings 
  730.  
  731. (english) es 's s ions ion ings ing 
  732. (german) es e 's s en em n 
  733.  
  734. are cutted and the first character is converted to lower-case. Then it is 
  735. compared to the contents of the dictionary. If no similar entry is found, it is 
  736. placed into the dictionary. 
  737.  
  738. The dictionary file is a normal ASCII file in IBM codepage. The words are 
  739. sorted by an internal sort algorithm, not by the alphabet. You can add manually 
  740. words at any position. 
  741.  
  742.  
  743. ΓòÉΓòÉΓòÉ 5.2.2. Working with the spell checking function ΓòÉΓòÉΓòÉ
  744.  
  745.  
  746. You can turn on and off spell checking by entering ^QL. The background of 
  747. unknown words is getting red. There's no spell checking dialog window. You 
  748. simply press ^QO, and WSedit learns all words from the beginning of the file up 
  749. to the line of the editor cursor. Some marking of words below the cursor will 
  750. automatically disappear. To go to the next marked (wrong) word, you can simply 
  751. type ^L. (If spell checking is disabled, ^L is the command for "search/replace 
  752. text again".) 
  753.  
  754. If you find an incorrect word which is not highlighted and in consequence the 
  755. wrong word is part of the dictionary, you can correct your dictionary by moving 
  756. the mouse over the wrong word and choosing "remove single word from dictionary" 
  757. in the popup menu. 
  758.  
  759.  
  760. ΓòÉΓòÉΓòÉ 5.3. Function key macros ΓòÉΓòÉΓòÉ
  761.  
  762. Perhaps you have noticed that you won't find "press F7 to get this and this" in 
  763. the WSedit documentation. Function keys are not defined in WSedit, besides some 
  764. function keys used by the operating system (F1 for help, F10 for system menu, 
  765. this depends on your operating system). All other function keys can be defined 
  766. by the user. 
  767.  
  768. subchapters: 
  769. Storing macros 
  770. Recording macros 
  771.  
  772. next chapter: 
  773. Read only files, Workgroups 
  774.  
  775.  
  776. ΓòÉΓòÉΓòÉ 5.3.1. Storing macros ΓòÉΓòÉΓòÉ
  777.  
  778.  
  779. Press ESC to get the "function key macros" window. There are four listboxes: 
  780. FX, Shift-FX, Ctrl-FX and ALT-FX. Combinated keys like Shift-Ctrl-F7 are not 
  781. supported, but 4x12=48 macro definitions should be sufficient! 
  782.  
  783. Clicking to a function key name like "F4=" will show a window where you can 
  784. record and play macros like a music tape. 
  785.  
  786. The macro commands are saved in separate files in a new directory F-MACROS 
  787. located in the directory where WSEDIT.EXE resides. You can copy the files 
  788. located in the F-MACROS directory and send it to another WSedit user. The name 
  789. of the macro file shows the key, e.g. SHIFT-F5.DTA. (When german language is 
  790. set, the file name will also be "SHIFT.." or "CTRL.."). 
  791.  
  792. You can change the allocated key of a macro by renaming the file and reopening 
  793. the function keys window. 
  794.  
  795.  
  796. ΓòÉΓòÉΓòÉ 5.3.2. Recording macros ΓòÉΓòÉΓòÉ
  797.  
  798.  
  799. The function key macro recorder records only keystrokes, with some exceptions. 
  800. So don't use the Menu, don't use the Ctrl menu. Instead, type the key commands. 
  801.  
  802. It is allowed to use the dialog windows 
  803.  
  804.      ^QF find dialog 
  805.      ^QA search/replace dialog 
  806.      ^KR read block from file 
  807.      ^KW write block to file. 
  808.  
  809.  
  810.  If you play the macro, the dialog window won't appear. The information which 
  811.  was produced by the dialog is stored directly in the macro. So you can write a 
  812.  macro "write block to the file TEMP1.WS". While recording, the usage inside 
  813.  the dialog makes no difference. You can click to the filenname or type it. 
  814.  
  815.  It can happen that some specific function keys do not work at all. These 
  816.  function keys are defined by your Operating System and are not available (e.g. 
  817.  Alt-F4 for closing a window). 
  818.  
  819.  
  820. ΓòÉΓòÉΓòÉ 5.4. Read only files, Workgroups ΓòÉΓòÉΓòÉ
  821.  
  822.  
  823. If you are a single-worker, this chapter won't be interested for you. 
  824.  
  825. If serveral persons work with the same text files, you will normally get a 
  826. problem. Some editors like DOS Wordstar do not allow two programs (or users) to 
  827. read a file. So you won't have a problem by overwriting a file, but on the 
  828. other hand reading a file simultaneously won't be possible. Others allow 
  829. reading and writing, but if two persons have opened the text file 
  830. simultaneously, only the changes of the person who saved the file at last are 
  831. written to the file. 
  832.  
  833. The WSedit workgroup functionality is enabled by checking when opening, set 
  834. file to read only (for workgroups) on the Save Page in the settings notebook 
  835. (^OO). 
  836.  
  837. WSedit sets the read-only flag of the text file if a user opens the file. The 
  838. first user has got write-access. All users who open the file later won't have 
  839. write-access, but they can read the file. To remember that writing is not 
  840. possible, the background is gray instead of white or blue and in the title bar 
  841. "READ ONLY" appears. 
  842.  
  843. After the user which had got write-access leaves the file, the WSedit program 
  844. of the other ("read-only") user catches automatically the write-access and the 
  845. window background turns to white (or blue). 
  846.  
  847. If the user with write-access saves the file, the other users will get 
  848. automatically an actualized file content. 
  849.  
  850. In the Menu, you will find a command "File - let go write access". Here you can 
  851. give your write-access to the other user - your WSedit switches to read-only. 
  852.  
  853. To simulate a dual-user mode, open one text file twice by starting WSedit two 
  854. times. 
  855.  
  856. If the workgroup functionality is enabled, the text file which is opened by 
  857. WSedit is set to read-only. If WSedit crashes (what we won't hope!), the text 
  858. file will rest in read-only state. To turn on or off the read-only workgroup 
  859. feature, open the settings notebook of the text file icon (right mouse button, 
  860. properties) and activate/deactivate the "read only" checkbox. 
  861.  
  862.  
  863. ΓòÉΓòÉΓòÉ 5.5. Backup functionality ΓòÉΓòÉΓòÉ
  864.  
  865.  
  866. WSedit supports two kinds of backup functionality which can be set in the Save 
  867. Page of the settings notebook. 
  868.  
  869. With a specific time delay, WSedit saves the content of the editor into an 
  870. ASCII file (even the current file is in WS format). The name of the file is 
  871. always the same. It is located in the directory where the text file resides. 
  872.  
  873. WSedit writes the text to the backup file every e.g. 3 minutes, but waits for a 
  874. moment where for e.g. 5 seconds no character key was pressed. 
  875.  
  876. In addition, you can let rename the old text file to *.BAK when the file is 
  877. saved by the user. 
  878.  
  879.  
  880. ΓòÉΓòÉΓòÉ 5.6. Translation ΓòÉΓòÉΓòÉ
  881.  
  882. WSedit supports two kinds of translation: Bubble Translation and Dialog 
  883. Translation. Normally you will use Bubble Translation when reading a text in a 
  884. foreign language and Dialog Translation when writing a text in a foreign 
  885. language. 
  886.  
  887. To use translation functionality, you have to download the translation 
  888. dictionary files from http://www.WriteAndSet.com (yet only German to English 
  889. and English to German). Then copy the two files to the location where 
  890. WSedit.exe resides and fill out the settings notebook Dict Page. 
  891.  
  892. Bubble Translation: After typing ^OT, words or expressions at the mouse 
  893. position are translated and the result is shown in a yellow bubble help window. 
  894.  
  895. Dialog Translation: ^OV activates a dialog where you can enter the expression 
  896. into the edit field. In the Listbox below, several possible translations are 
  897. shown. If Bubble Translation is also activated, these several possible 
  898. translations are re-translated in parenthesis so it will be easier to select 
  899. the correct translation. 
  900.  
  901. The re-translation has the effect of a Thesaurus: a single expression 
  902. translated to another language and re-translated back will show 10 or 20 
  903. slightly different expressions. 
  904.  
  905. Double clicking to a listbox item or single clicking and pressing OK copies the 
  906. translated expression into the Trash buffer. It can be copied to the cursor 
  907. position by typing ^U. 
  908.  
  909.  
  910. ΓòÉΓòÉΓòÉ 6. Settings Notebook ΓòÉΓòÉΓòÉ
  911.  
  912.  
  913. subchapters: 
  914. General 
  915. File Page 
  916. Wrap Page 
  917. Save Page 
  918. Dict Page 
  919. Misc Page 
  920. Highlt Page 
  921. WS page 
  922.  
  923. next chapter: 
  924. About WSedit 
  925.  
  926.  
  927. ΓòÉΓòÉΓòÉ 6.1. General ΓòÉΓòÉΓòÉ
  928.  
  929.  
  930. WSedit has got a settings notebook: select "Window - WSedit settings" or press 
  931. Ctrl-OO. The information is stored in the binary WSEDIT.DTA file which is 
  932. located in the same directory where WSEDIT.EXE resides. WSEDIT.DTA is read when 
  933. WSedit is started and it is written when you exit WSedit. If several WSedit 
  934. windows are opened, the last window overwrites the settings of the other 
  935. programs. So if you want to make changes, make sure that only one WSedit is 
  936. running. 
  937.  
  938. The contents of the settings notebook is dependent on the file extension. It is 
  939. possible to store entries for up to 20 different file types. 
  940.  
  941. There are also some other settings stored in the WSEDIT.DTA file dependent on 
  942. the file type which are not part of the settings notebook, e.g. window size and 
  943. font size. 
  944.  
  945. You can enter a new file type by pressing the "New" button outside the notebook 
  946. itself. The entry field near the "New" button gets empty and you can enter a 
  947. new file extension. You are allowed to enter more than one file extension for 
  948. one file type, separated by colon and without spaces, e.g. 
  949.  
  950. HTM,HTML 
  951.  
  952. If you define a new file type, the notebook entries of the type which was 
  953. active before pressing "New" rest in the notebook. So choose the file type with 
  954. the closest settings before pressing "New". 
  955.  
  956.  
  957. ΓòÉΓòÉΓòÉ 6.2. File Page ΓòÉΓòÉΓòÉ
  958.  
  959.  
  960. The File Page is the most important page of the settings notebook. Here you can 
  961. define the text file type Wordstar / ASCII and "with word wrap", "no word 
  962. wrap". 
  963.  
  964. ASCII Codepages 
  965.  
  966. The codepage of the ASCII file depends on your operating system: OS/2 and eCS 
  967. uses IBM (DOS) codepage, Windows and Linux ISO codepage. But Wordstar file 
  968. format has always IBM (DOS) codepage. 
  969.  
  970. If you want to save or read a file in the not default codepage, then use the 
  971. file - import/export function in the menu of WSedit. 
  972.  
  973. Wordstar format 
  974.  
  975. "Unformatted" shows Wordstar/Write&Set files like in an ASCII Editor with word 
  976. wrap on; saving an "unformatted Wordstar file" will create a right margin of 
  977. 78, so the file will fit the screen of a DOS Wordstar with its 80 column 
  978. window. While saving a file, "Wordstar formatted" stores the formatting of the 
  979. text (the position of the Soft Returns, the hyphenation), "WordStar 
  980. unformatted" will destroy all Soft Return and hyphenation information! 
  981.  
  982. If you reformat a "Wordstar formatted" file, WSedit fetches the right margin 
  983. value from the last ".RM" (right margin) dot command. 
  984.  
  985. In Wordstar 5, 6 and 7, the data format differs from Wordstar 3.4 and 4. WSedit 
  986. reads Wordstar 3.4 up to 7, but writes always Wordstar 4 format (which can be 
  987. read by Wordstar 5, 6, 7 without problems). But it is possible that some 
  988. formatting information gets lost. Footnotes/endenotes gets converted to 
  989. Write&Set/Hypermake format. 
  990.  
  991. Distinguish WS tabs is only relevant if you have got Wordstar (DOS) files. 
  992. Wordstar knwos two different tabulators: the ^I and the ^OG tab keys. If you 
  993. check this box, the ^I tabs are converted to normal spaces, otherwise they are 
  994. converted to snow chars. 
  995.  
  996. Default checkboxes 
  997.  
  998. The two "Default..." checkboxes can be checked only by one file type. 
  999.  
  1000.  
  1001. ΓòÉΓòÉΓòÉ 6.3. Wrap Page ΓòÉΓòÉΓòÉ
  1002.  
  1003.  
  1004. The Wrap Page has got a great influence to the "feeling" of WSedit. If the file 
  1005. type supports word wrapping (see "file" page), you can choose the personal 
  1006. behaviour of wrapping text: 
  1007.  
  1008.      with time delay is my personal favourite setting. If enabled, you can 
  1009.       select a delay time which omits a continious reformatting while typing 
  1010.       text. I prefer 0 quarter seconds. 
  1011.  
  1012.      after every keypress is the behaviour of most word wrap editors. Because 
  1013.       of the need of reformatting a big paragraph after every keypress, the 
  1014.       amount of processor time becomes noticeable on slow computers. If you 
  1015.       type very fast and your computer is not fast, this setting is not 
  1016.       recommended. 
  1017.  
  1018.      only by hand (^B) is the classic old DOS Wordstar behaviour. A lot of 
  1019.       people get confused if the text is reformatted automatically while 
  1020.       writing. Ctrl-B reformats the paragraph from the cursor to the end of the 
  1021.       paragraph. In any case, the paragraph is reformatted if the cursor 
  1022.       exceeds the line. 
  1023.  
  1024.      not at all deactivates reformatting. Soft Returns are handled like Hard 
  1025.       Returns. Even ^B has no effect. 
  1026.  
  1027.  
  1028.  The undo slider works more efficient if WSedit does not reformat a paragraph 
  1029.  too often: if the text is reformatted every second while typing, there are a 
  1030.  lot of events to remember for the undo functionality: one event per line and 
  1031.  in a 10-lines paragraph for 10 events per second. You can reduce this event 
  1032.  amount by using "with time delay" and a higher delay time value, e.g. 4. 
  1033.  
  1034.  The Cursor left/right checkbox influences the behaviour of cursor movement. If 
  1035.  disabled, the behaviour is like in a programmers editor: you can reach every 
  1036.  point of the screen by using the cursor. If enabled, the cursor follows the 
  1037.  text. Where there is no text, you have to fill the line with spaces to reach a 
  1038.  position where no text is written yet (or simply use the mouse). The behaviour 
  1039.  does remember to the ^OX Wordstar command, but it's not the same. Anyway, you 
  1040.  can toggle this behaviour by typing ^OX. 
  1041.  
  1042.  
  1043. ΓòÉΓòÉΓòÉ 6.4. Save Page ΓòÉΓòÉΓòÉ
  1044.  
  1045.  
  1046. The "Save" Page is related on opening, saving and write access. 
  1047.  
  1048. Starting WSedit without parameter influences the behaviour when starting WSedit 
  1049. without opening a file at the beginning. You can get a file dialog at the 
  1050. beginning or you get an empty editor field with the filename Newtext1, 
  1051. Newtext2, Newtext3 (up to 9). These files are located where WSedit.exe resides. 
  1052.  
  1053. When opening, set file to read only is the read only workgroup functionality of 
  1054. WSedit. This helps you sharing text files with your collegues in the network 
  1055. where several people have got access to a text file: the user which opens the 
  1056. file first has got write access, the others have got only read access. 
  1057.  
  1058. Refresh WSedit if file was written by an external editor is useful for files 
  1059. which are created by another program and are read in WSedit. Every 1,5 seconds, 
  1060. WSedit compares the file date with the date where the file has been read the 
  1061. last time. If the date has changed, WSedit automatically reads the actualized 
  1062. file. If you have changed the text file in the editor, WSedit asks whether to 
  1063. loose changes or not. 
  1064.  
  1065. There are two independent Backup functionalities. 
  1066.  
  1067. Backup helps you to restore a file if your computer or WSedit crashes. WSedit 
  1068. writes the text e.g. every 3 minutes to a TXT file (even Wordstar format is 
  1069. used; use the clipboard to copy the text back). The file is  located in the 
  1070. directory where your current text file resides. You can change the name of the 
  1071. file. If you have got several WSedit files open where the text files shares the 
  1072. same directory, all editors uses the same backup file. (I assume this is not 
  1073. relevant in practice.) 
  1074.  
  1075. Create *.BAK files renames the old text file to *.BAK when the file is saved 
  1076. again. (If you use OS/2 or eCS and start WSedit by double clicking the text 
  1077. file icon, I cannot recommend this setting. The text file icons shows the gray 
  1078. open background after WSedit is closed; this is caused by the object structure 
  1079. of the WPS which is independent from the file names.) 
  1080.  
  1081.  
  1082. ΓòÉΓòÉΓòÉ 6.5. Dict Page ΓòÉΓòÉΓòÉ
  1083.  
  1084.  
  1085. For the spell checking function (^QL), you can enter a file name of the 
  1086. dictionary. It has to be in WSedit/Hypermake format. Before a word is compared 
  1087. with the words in the dictionary, the ending of the word is cutted. You can 
  1088. define other endings if you use WSedit in another language. 
  1089.  
  1090. WSedit supports two different kinds of translation functionality: Bubble 
  1091. Translation (^OT) and Dialog Translation (^OV). 
  1092.  
  1093. If you don't enter a full pathname, the two translation dictionary files are 
  1094. searched in the directory where WSEDIT.EXE resides. 
  1095.  
  1096. Both spell checking and translation files can be downloaded from 
  1097. http://www.WriteAndSet.com 
  1098.  
  1099.  
  1100. ΓòÉΓòÉΓòÉ 6.6. Misc Page ΓòÉΓòÉΓòÉ
  1101.  
  1102.  
  1103. The miscellanneous page holds all settings which are not part of the other 
  1104. topics. 
  1105.  
  1106. WSformat-related bubble help let you turn on and off bubble help for dot 
  1107. commands which is shown in the WSedit editor, but generated by WSformat. This 
  1108. also affects the font sample window when moving the mouse cursor over font dot 
  1109. commands. 
  1110.  
  1111. max Undo steps influences the behaviour of the Undo slider. If you choose a 
  1112. high value (e.g. 10000), a slow motion of the slider will redo a lot of events, 
  1113. so it can get less practicable. If you choose a low value (e.g. 100), the undo 
  1114. functionality will be too limited. 
  1115.  
  1116. delete word right from cursor (^T) influences the behaviour of the ^T command. 
  1117. The middle setting is the same as in Wordstar DOS, auto correct spaces is a 
  1118. self-made further development improving changing the position of two words 
  1119. where one word is located near a dot or a comma, but sometimes it shows a not 
  1120. Wordstar-like behaviour. 
  1121.  
  1122. Ctrl Menu time delay defines the time from pressing e.g. ^K and activating the 
  1123. Ctrl Menu. Experienced users know the commands, and between the first and the 
  1124. second key of the double-key commands like ^KB (mark beginning of block) 
  1125. there's only a close moment. But if the user hesitates, the Ctrl Menu should 
  1126. appear. The time value depends on your knowledge of Wordstar commands and your 
  1127. key typing speed. 
  1128.  
  1129. Cursor highlightning when editor idle 
  1130. If you don't use the editor for a while, it can be visually difficult to detect 
  1131. the cursor position again. WSedit shows a lightblue cross after a while. Enable 
  1132. this setting and enter a smaller time, if you have got problems in detecting 
  1133. the cursor. After every keystroke or mouse click, the counter controlling the 
  1134. appearance the cursor highlightning restarts. Typing the CTRL key without 
  1135. another key forces the highlighted cursor immidiately. 
  1136.  
  1137. If close, save without querying 
  1138. If checked, closing the WSedit window by clicking the Close button in the title 
  1139. bar will automatically save the text file without question. 
  1140.  
  1141.  
  1142. ΓòÉΓòÉΓòÉ 6.7. Highlt Page ΓòÉΓòÉΓòÉ
  1143.  
  1144.  
  1145. The usage of Highlightning depends on the used file type. E.g. in 
  1146. Write&Set/Wordstar/Hypermake files, dot commands and printer characters are 
  1147. shown highlighted. The left checkbox window (double clicking and not 
  1148. single-clicking changes the checkbox state), the Wordstar, Hypermake and 
  1149. Write&Set syntax is supported. On the right window, you can enable and disable 
  1150. HTML syntax. Do you miss other highlightning functionality? 
  1151.  
  1152. Sorry, but the read index dot command ".IC" is BUGGY, please do not use if not 
  1153. really necessary. You can enter a default Index char below instead which is 
  1154. valid for the whole document. 
  1155.  
  1156. Independent from the syntax of the text you write, one highlightning feature is 
  1157. useful anyway: the checkbox rightmost column shows type of line (outside the 
  1158. listboxes) let you distinguish Soft Return lines from Hard Return lines. This 
  1159. is very useful if you use the word wrapping functionality. Lightblue shows Soft 
  1160. Return lines, darkgreen shows Hard Return lines. 
  1161.  
  1162. Note that two different Color settings are accessible for the whole editor 
  1163. (press ^OM). 
  1164.  
  1165. The Syntax highlightning enabled checkbox disables all highlightning 
  1166. functionality in the two listboxes. The Softreturn / Hardreturn (rightmost 
  1167. column shows type of line) function is independent from this main checkbox 
  1168. setting. 
  1169.  
  1170. The first two Wordstar highlightning functions (Toggles, Highlightning toggles) 
  1171. are dependent on the Toggle characters defined below (toggle chars). The 
  1172. toggles itself are shown red and between two toggle characters, the text is 
  1173. shown blue. You can also define special characters which are simply shown 
  1174. colored (special chars). If you enter normal letters here, the function is 
  1175. related to the corresponding Ctrl key, e.g. to enter ^B (Wordstar bold print), 
  1176. simply enter a B capital letter. 
  1177.  
  1178.  
  1179. ΓòÉΓòÉΓòÉ 6.8. WS page ΓòÉΓòÉΓòÉ
  1180.  
  1181.  
  1182. The "WS" page does not hold separately data for each file type. It stores 
  1183. settings related to Wordstar/Write&Set file format and about the WSformat 
  1184. program. 
  1185.  
  1186. The dot command default groupbox stores the dot command default values which 
  1187. are necessary to calulate the page breaks in files with file type "Wordstar 
  1188. formatted". These values should be identical to the default values in the 
  1189. WSformat settings notebook, page "Layout". Otherwise, the page breaks shown in 
  1190. WSedit and previewed/printed by WSformat are not the same. 
  1191.  
  1192. Full filename of WSformat executable: If you want to use the ^KF command "Save 
  1193. file and run WSformat", WSedit has to know the filename of WSformat. 
  1194.  
  1195.  
  1196. ΓòÉΓòÉΓòÉ 7. About WSedit ΓòÉΓòÉΓòÉ
  1197.  
  1198.  
  1199. subchapters: 
  1200. Freeware - Disclaimer 
  1201. Why do I have written WSedit? 
  1202. How this program help file was created 
  1203. Bugs and Versions 
  1204. How to contact the author 
  1205. Other Freeware/Shareware 
  1206.  
  1207.  
  1208. ΓòÉΓòÉΓòÉ 7.1. Freeware - Disclaimer ΓòÉΓòÉΓòÉ
  1209.  
  1210.  
  1211. WSedit is Freeware. You are allowed to distribute this program on 
  1212. Freeware/Shareware CD's, to place it on Internet Servers, to bundle it with new 
  1213. Computers and so on. But all rights to the program remain with the author. 
  1214.  
  1215. WSedit is provided as is and comes with no warranty of any kind, either 
  1216. expressed or implied. In no event will the author be liable for any damages 
  1217. resulting from the use of this software. 
  1218.  
  1219. The full featured Wordprocessing suite Write&Set containing both WSedit and 
  1220. WSformat is Shareware. 
  1221.  
  1222.  
  1223. ΓòÉΓòÉΓòÉ 7.2. Why do I have written WSedit? ΓòÉΓòÉΓòÉ
  1224.  
  1225.  
  1226. I had got different reasons for writing WSedit. 
  1227.  
  1228.      I do a lot of word processing and I like Wordstar. But today, a DOS 
  1229.       program is no more acceptable. And I missed some functionality in 
  1230.       Wordstar. 
  1231.  
  1232.      For my Shareware program Hypermake, I need a powerful integrated editor. 
  1233.       It is much more efficient to develop the editor as a separate project. 
  1234.       Hypermake and WSedit shares a lot of program code. Fixing a bug in WSedit 
  1235.       will fix the same bug in the Hypermake editor and reverse. 
  1236.  
  1237.      The majority of editor code was already available in the program 
  1238.       developing environment I use. So the amount of work was not as much as it 
  1239.       looks like. The WSedit project is based on a programmers editor without 
  1240.       wordwrap functionality which is part of the cross-platform Pascal 
  1241.       developing environment "Sibyl". See http://www.speedsoft-online.de 
  1242.  
  1243.      WSedit is an important part of the wordprocessing suite Write&Set. I 
  1244.       think it is necessary to offer a non Winword-like wordprocessing software 
  1245.       which is not "Tex". Too much users are frustrated with Winword and 
  1246.       Winword-like programs. 
  1247.  
  1248.  
  1249. ΓòÉΓòÉΓòÉ 7.3. How this program help file was created ΓòÉΓòÉΓòÉ
  1250.  
  1251.  
  1252. Hypermake is a hypertext compiler which compiles Write&Set (Wordstar 4) files 
  1253. or ASCII files with dot commands and toggles to HTML, Winhelp, MS HTML-Help or 
  1254. IBM Help. The source of this help file is a WS file with dot commands which can 
  1255. be formatted and printed with Write&Set. You will find this source file in the 
  1256. Write&Set archiv file, subdirectory DOCUSRC. 
  1257.  
  1258. Hypermake has got a lot of dot commands similar to Write&Set, many are the 
  1259. same. The commands for fonts, footnotes, line drawing, headings, index are 
  1260. identical! 
  1261.  
  1262. The Hypermake 4.0 editor does not yet have the ability of reading and writing 
  1263. Wordstar 4/5 format, but it understands the majority of Wordstar Ctrl commands 
  1264. (if you choose Wordstar in the popup menu of the Hypermake editor window). I 
  1265. plan to implement WS reading/writing support in Hypermake 4.10. 
  1266.  
  1267. Please visit http://www.WriteAndSet.com 
  1268. http://www.hypermake.com 
  1269.  
  1270.  
  1271. ΓòÉΓòÉΓòÉ 7.4. Bugs and Versions ΓòÉΓòÉΓòÉ
  1272.  
  1273. Bugs 
  1274.  
  1275. Because auf continously problems with screen fonts in the Windows version and 
  1276. my interest in publishing a Linux version, I plan to change the development 
  1277. environment for WSedit. After changing, I hope not having problems with screen 
  1278. fonts anymore. So you will select different screen fonts without problems. 
  1279.  
  1280. Then, there are sometimes problems when typing an indented paragraph. These 
  1281. problems cannot be reproduced, so I was not able to fix it. 
  1282.  
  1283. Improvements, changes or bugfixes in WSedit 0.95 (May 2003) 
  1284.  
  1285.      the WSedit search and search/replace dialog accepts printer characters 
  1286.       (enter ^ and B or write a hash, followed by three digits for the ASCII 
  1287.       decimal code) 
  1288.      more communication between WSedit and WSformat 
  1289.  
  1290.  
  1291.  Improvements, changes or bugfixes in WSedit 0.94 (March 2003) 
  1292.  
  1293.      Communication between WSedit and WSformat to get part of Write&Set 
  1294.      Menu bar (can be switched off, see menuitem Options) 
  1295.      Alternate appearance of popup menu (see menuitem Options) 
  1296.      "highlighted cursor": after a while with no cursor movement, the cursor 
  1297.       is marked by a lightblue cross; pressing CTRL without another key forces 
  1298.       the highlighted cursor immediately 
  1299.      modified behaviour when starting WSedit without a file (see Settings 
  1300.       notebook - page Save). 
  1301.  
  1302.  
  1303.  Improvements, changes or bugfixes in WSedit 0.92 (November 2002) 
  1304.  
  1305.      A great number of small bugfixes, not worth to mention all. 
  1306.      ^OD "do not show toggles" is available now, but pressing any key will 
  1307.       show the toggles again: You can't type while toggles are not shown. The 
  1308.       old ^OD command (show translation window) has moved to ^OV. 
  1309.      The cursor gets highlighted if WSedit is idle for a specific time. See 
  1310.       Settings Notebook, page misc. 
  1311.      If spell checking is enabled, ^L goes to the next marked (wrong) word. 
  1312.      WSedit is adapted now for use together with WSformat. The look and feel 
  1313.       is like a single program. E.g. pointing with the cursor to a font dot 
  1314.       command in WSedit opens a font example window near the cursor which is 
  1315.       drawn by WSformat. All documentation refering to communication between 
  1316.       these two programs is hold in the WSformat documentation. 
  1317.  
  1318.  
  1319.  Fixed bugs and improvements in WSedit 0.91 (June 2000) 
  1320.  
  1321.      Improved reading of Wordstar 5, 6, 7 files (footnotes, style sheets) 
  1322.      recording a macro which exits WSedit now possible 
  1323.      in "popup menu - options", you can set the background and (default) 
  1324.       foreground color for each file type 
  1325.  
  1326.  
  1327.  Version 0.90 (March 2000) was the first version of WSedit, available only for 
  1328.  OS/2. 
  1329.  
  1330.  If you will get a window "error found at address..., Exit program Yes/No ?" or 
  1331.  something like that, then press "no" for do not exit, save your file 
  1332.  immediately, exit and restart WSedit. If you can reproduce this bug, please 
  1333.  send me an E-Mail with a description of the bug. 
  1334.  
  1335.  I will also publish a Linux version in the future. 
  1336.  
  1337.  
  1338. ΓòÉΓòÉΓòÉ 7.5. How to contact the author ΓòÉΓòÉΓòÉ
  1339.  
  1340. Dr. Martin Vieregg, 37. I've studied economics. My main job is working in my 
  1341. own consulting company  http://www.vr-transport.com . Our special subject is 
  1342. public transport: railways and airports. The title of my doctoral (PhD) thesis 
  1343. was "increasing efficiency of railway long-distance passenger traffic". 
  1344.  
  1345. E-Mail: Martin@hypermake.de 
  1346.  
  1347. Homepage: 
  1348. http://www.hypermake.com 
  1349. WSedit Homepage: 
  1350. http://www.WriteAndSet.com 
  1351.  
  1352.  
  1353. ΓòÉΓòÉΓòÉ 7.6. Other Freeware/Shareware ΓòÉΓòÉΓòÉ
  1354.  
  1355.  
  1356. I've written some other programs, Freeware and Shareware. Please visit my 
  1357. Homepage 
  1358.  
  1359. http://www.Hypermake.com 
  1360.  
  1361.      Simple Zipshell (Freeware) Using the Info-Zip Freeware packer from the 
  1362.       Windows 95/NT4 desktop 
  1363.      Tiny Alarm (Freeware) A slider from 0 to 60 minutes, alarm and chime. 
  1364.      cd-shortcut (Freeware) is a substitute for the "CD" command in the 
  1365.       command line. It is sufficient to enter substrings. 
  1366.      pmCalc (Shareware) is a pocket calculator with a separate input and 
  1367.       output field and no "=" button: while editing your input, the output is 
  1368.       actualized immediately. Calculating with variables, regression, 
  1369.       programmers functions, scientific functions. Works together with WSedit 
  1370.       (Clipboard and column block mode ^KN) 
  1371.      Hypermake www.hypermake.de Hypertext builder (Shareware) let you generate 
  1372.       Winhelp, HTML, IBM Help and MS HTML-Help from one source text. This Help 
  1373.       file was generated by HyperMake. The integrated editor is very similar to 
  1374.       WSedit and the Hypertext source file format is Wordstar-like with dot 
  1375.       commands and toggles. 
  1376.  
  1377.  
  1378.  End of text 
  1379.