home *** CD-ROM | disk | FTP | other *** search
/ Carousel Volume 2 #1 / carousel.iso / mactosh / da / joliwrit.sit / JoliWrite2.0.rsrc / HELP_-16000_JWHelp < prev    next >
Text File  |  1988-05-03  |  16KB  |  192 lines

  1. *** JoliWrite version 2.0 ***
  2.  
  3.         Ñ "Pure text" processing
  4.  
  5.             ╫ JoliWrite includes several useful commands for quickly preparing a nice layout on a text before printing, or sending it thru a modem.
  6.  
  7.             ╫ JoliWrite can't contain more than 32K of text, althought it can read a part of a longer file. The limit on opening is 28K, to let one type a little more text. In case of partial reading, a "*" is added to the current file name to avoid accidental overwriting on the original file.
  8.  
  9.             ╫ Printing with JoliWrite is fast and simple. You may select the font, size and line spacing; you may print a formated text, or unformat it to use the full paper width, in any printing mode (best, normal or draft).
  10.  
  11.         Ñ Formating and justifying
  12.  
  13.             ╫ JoliWrite doesn't use the standard Mac way for justifying: normally, as everything is drawed on the screen, the full justification is obtained by varying the pixel-space between words (as in MacWrite). As we only use raw text files in JoliWrite, the justification is made here by adding spaces and CRs in the text.
  14.  
  15.             ╫ Formating a text in JoliWrite doesn't necessary means justification. You may use it to automatically add a space after a period, a line after a paragraph, delete unneeded spaces, control-characters╔
  16.  
  17.             ╫ A very few fonts only will display and print a correctly right (or center or full) justified text, as JoliWrite needs non-proportional fonts to perform it (Monaco, Courier). However, the font used doesn't change the way JoliWrite formats the text, neither the justification.
  18.  
  19.         Ñ Convert characters
  20.  
  21.             ╫ ASCII
  22.                 - The ASCII change is primarily intented for french users, as it helps to use the french diacritical letters on networks. You may use it to remove the characters with code >127 (non-ASCII, used in the Mac world to code all the special and diacritical characters).
  23.  
  24.             ╫ TABs
  25.                 - TABs are not used in JoliWrite, and may cause problems with justification. If you open a text containing TABs, it's better to convert them to spaces. If you don't convert, the TABs remain TABs but are displayed as spaces. If you convert, each TAB will be turned to four spaces.
  26.                 - There is no way, in JoliWrite, to type a TAB from the keyboard: the TAB key directly generates a group of four spaces.
  27.  
  28.             ╫ LFs and other control-characters
  29.                 - You may instantly remove or add LFs after CRs, or delete every control-characters.
  30.  
  31.             ╫ Acta¬ outlines
  32.                 - Acta documents may be directly opened with JoliWrite, they are turned to pure text. The indentation is preserved on the first line of each paragraph. JoliWrite won't open Acta documents larger than 28K. A "*" is added to the current file name to avoid accidental overwriting.
  33.                 - David Dunham, creator of Acta, has pointed that garbage was produced if there was a picture in the Acta document╔ The bug is corrected, and I want to thank him for his invaluable help (I definitely extend those thanks to all the MacTutor contributors, hi Joerg!).
  34.  
  35.  
  36.     - Commands
  37.  
  38.         Ñ The four main commands that changes the text ("Format", "Delete╔", "Case change╔" and "ASCII change╔") follow the same rule: if some text is selected, the command will only alter the selected part (that lets you center a title, or change the margins on a single paragraph); otherwise, if there is no selection, the whole text is modified. So, you don't have to select all if you want to format all at once.
  39.  
  40.         Ñ Menu and sub-menus in JoliWrite
  41.  
  42.             ╫ "About╔" sub-menu
  43.  
  44.                 - "╔JoliWrite" brings up a dialog with the version number.
  45.  
  46.                 - "Preferences": this dialog lets you select a few options:
  47.                     * on opening JoliWrite, start on "New" or "Open╔";
  48.                     * where an "Add╔"ed text will be inserted;
  49.                     * how many keystrokes between auto-saves (see below);
  50.                     * document's signature. Default signature is MacWrite (which means that the Finder will launch MacWrite if you double-click on a text created by JoliWrite), but it may be changed freely. The Word "MSWD" signature is now Word3, not anymore Word1.
  51.                     * Those preferences, as well as the font, size, and more generally every options selected, are automatically saved when you close JoliWrite. All is now saved in the system-folder, in a system-file called "JWritePref". If that file is missing when opening, JoliWrite goes back to its default settings and recreates the file upon closing.
  52.  
  53.                 - Instructions
  54.  
  55.                     * The instructions, that you are reading, may not fit if there is already a lot of text in JoliWrite: the menu item is deactivated in that case.
  56.  
  57.             ╫ "File" sub-menu
  58.  
  59.                 - "New", "Open╔", "Save", "Save as╔"
  60.                     * Those commands are totally standards. "New" and "Open╔" may now be undo'ed, which brings you back to the previous document. There was a bug here, which could cause accidental overwrite on the files opened with the <option> key (see below); it's now corrected.
  61.  
  62.                 - "Add╔"
  63.                     * According to the "Preferences" setting, the added text will come on top, bottom or at cursor position. You may undo it. If the added file can't fit in the remaining space, a dialog comes that lets you pick-up only a part of the text.
  64.  
  65.                 - "Auto-save"
  66.                     * Auto-save is never "on" when opening JoliWrite, to be more safe. The menu item is checked when it's "on".
  67.                     * The number of keystrokes between auto-saves is entered in the "Preferences"; it may be any number between 100 and 32767.
  68.                     * Auto-save may be turned on and off anytime. If the file doesn't exists on the disk (in case of a "New" document), the first auto-save will show the standard save dialog.
  69.  
  70.             ╫ "Format" sub-menu
  71.  
  72.                 - "Layout╔"
  73.                     * That command brings up a dialog, in which you can select options and parameters for margins and justification. You may call directly the format command from this dialog.
  74.                     * The full justification algorithm has been changed: the last line of a paragraph is not right justified, and the "-" is not taken as a word-separator (except at the end of line).
  75.  
  76.                 - "Format"
  77.                     * This command directly formats the selected text (or the whole text if there is no selection), using the previously selected parameters and options.
  78.  
  79.                 - "Font"
  80.                     * Shows the Font sub-menu; the current font is checked.
  81.  
  82.                 - "Size"
  83.                     * Shows the Size sub-menu (9 to 24). The current size is checked, and the available sizes for the current font are outlined. You can select an unavailable size, but it gives a bad result and slows-down everything.
  84.  
  85.                 - "Spacing"
  86.                     * Shows the Spacing sub-menu; the selected spacing is used for displaying and printing.
  87.  
  88.             ╫ "Text" sub-menu
  89.  
  90.                 - "Search╔", "Search again", "Replace"
  91.                     * When a "Search╔" or "Search again" command is issued, JoliWrite checks the selection in the text: if something is selected, it will be used as the search key. You may call, by that way, directly "Search again"; otherwise if you call "Search╔" the selected string will appear in the dialog.
  92.                     * If there is no selection, and if the "Search╔" command has not been yet called, the "Search again" item is deactivated.
  93.                     * When the searched string is found, type Cmd-T for replacing it (or pick-up the "Replace" item in the menu). For quickly find and replace the same string several time along the text, simply alternate Cmd-E and Cmd-T. You may undo a "Replace".
  94.                     * In the "Search╔" dialog, you may use the standard keyboard-commands of the "Edit" menu (Cmd-X, C, V) for cutting, copying and pasting.
  95.  
  96.                 - "Delete╔"
  97.                     * The dialog let you select many operations that can be performed at once: delete control-characters, CRs, TABs convert, insert LFs╔ This command operates on the selected text only, or on the whole text if there is no selection.
  98.  
  99.                 - "Case change╔"
  100.                     * Three modes are available: all uppercase, all lowercase, or capitalize. The command operates on the selected text only, or on the whole text if there is no selection. Be aware that the capitalize mode must only be used with non-formated text, otherwise an uppercase will appear on each beginning of line (any poets here?).
  101.  
  102.                 - "ASCII change╔"
  103.                     * You may select the mode (Mac->AFE or AFE->Mac, AFE stands for "ASCII Franìais Etendu", or "extended french ASCII"), and the optional non-ASCII characters filtering (code >127). The command operates on the selected text only, or on the whole text if there is no selection. Even if there are no diacritical characters in the text (êëìÄÅÉö₧¥), you may use the "Mac->AFE" mode with the filter-option selected: any remaining non-ASCII character is converted to space or period, and the text can be sent to any non-Mac computer (there are still some around).
  104.  
  105.             ╫ "Print" sub-menu
  106.  
  107.                 - "Page Setup╔", "Print╔": those commands work as usually. If the text has been justified, it will be printed exactly as displayed on the screen, otherwise the printing process will use the whole available paper width.
  108.  
  109.             ╫ "Edit" commands
  110.  
  111.                 - Application's "Edit" menu is used by JoliWrite for the usual Edit commands (undo, cut, copy, paste, clear). You may use the standard keyboard commands (Z, X, C, V), even if the application doesn't shows an "Edit" menu. "Clear" doesn't have any key-command, the <backspace> key may be used instead. All those commands can be undo'ed; undo'ing a "Copy" restores the previous clipboard (this doesn't exists on "undo cut").
  112.  
  113.         Ñ Other keyboard commands and shortcuts
  114.  
  115.             ╫ A few more commands are available:
  116.  
  117.                 - The <enter> key scrolls the text back to the cursor position;
  118.  
  119.                 - A click in the text with <option> down selects the whole text;
  120.  
  121.                 - Command-a also selects the whole text;
  122.  
  123.                 - Command-i inverts the positions of the last two typed characters, more generally of the two characters on the left of the cursor;
  124.  
  125.                 - A click in "zoom-box" with <option> down sends the window to the extreme bottom of the screen;
  126.  
  127.         Ñ Undo button
  128.  
  129.             ╫ The "Undo button" does exactly the same as the "Undo" item of the "Edit" menu. It may be faster to use, and it displays all the time its exact purpose. Any command can be undo'ed, and redo'ed.
  130.  
  131.         Ñ Memory
  132.  
  133.             ╫ Some commands may be inhibited if the available memory is too short. In most cases, it's possible to format a text in two or three parts, if the format operation is not accepted for the whole text. See below about operating under MultiFinder.
  134.  
  135.  
  136.     - Tricks in JoliWrite
  137.  
  138.         Ñ Communication
  139.  
  140.             ╫╩JoliWrite is invaluable for preparing a text to be sent thru a modem. Margins and justification give a nice layout to uploaded texts, instantly.
  141.  
  142.             ╫ It's extremely easy to operate: first, type the text as you would in MacWrite, that is, using the <return> key only to mark the end of a paragraph. Second, simply type Cmd-F, and see the result.
  143.  
  144.         Ñ Unformating
  145.  
  146.             ╫ The "Delete╔" command may be used to unformat a text, assuming that a blank line separates paragraphs. Select CRs with "keep one if several", also select "extra-spaces". You can then correct the text, and eventually reformat it. If the lines are numbered, the option "top of lines" may also be used in the "Delete╔" dialog to remove the numbers.
  147.  
  148.         Ñ Double paste
  149.  
  150.             ╫ You may use the "Replace" command exactly as "Paste": the replace-string is totally separate from the clipboard. If some text is selected when you call the "Replace" command, the selected text is deleted and replaced; but if there is no selection, the replace-string is simply inserted at the cursor position.
  151.  
  152.         Ñ Hard space
  153.  
  154.             ╫ The hard-space (<option>-space) may be used between two words, to avoid a line-wrap: the two words will be taken as one. Caution: the hard-space is a non-ASCII character (>127), so you may have to turn it back to normal space before sending the text to modem.
  155.  
  156.         Ñ Printing
  157.  
  158.             ╫ To print on the full page width, simply print the text unjustified. You may still want to format it without justify: unselect "Add a CR at end of lines" in the "Layout╔" dialog. This let you use the paragraph indentation, the blank line between paragraphs and the general "cleaning-up" performed on the text by the "Format" command. Of course, margins are not used in this mode.
  159.  
  160.             ╫ To print really fast, use the "Draft" mode. The shape of the font is not respected, but the size remains active, as well as the line spacing.
  161.  
  162.         Ñ <Option> key
  163.  
  164.             ╫ <Option> held down with "New", "Open╔", or while clicking the close-box, will make JoliWrite to not display the "Do you want to save changes?" dialog (use at your own risk!).
  165.  
  166.             ╫ <Option> held down with "Open╔" also bypass the file-filter in the standard "get file" dialog: any file containing a data-fork can be opened. Normally, only the text files and the Acta¬ documents may be opened, and are showed in the "get file" dialog. The "Add╔" command doesn't include that option, and can only open pure text files. If you open a non-text file with the <option>-key down, a "*" is added to the current file name to avoid accidental overwriting.
  167.  
  168.         Ñ Change command-keys
  169.  
  170.             ╫ You can easily change the keyboard-commands and the text of the menus if you need to (call a Search function with Cmd-R is not an ideal choice, but S is Save, F (find?) is Format, L (look for?) is Layout╔). Open A COPY of JoliWrite with ResEdit, the menus are located in STR# resources.
  171.  
  172.             ╫ If you change anything in those resources, please keep the modified copy for yourself and give around only the original.
  173.  
  174.  
  175.     - Compatibility
  176.  
  177.         Ñ JoliWrite runs on Mac 512/800, Mac plus, Mac SE and Mac//, with any System from 4.1. It doesn't work with the old 64K ROM (Mac 128 et 512).
  178.  
  179.         Ñ The initial window width gives a 78 columns display (Monaco-9), whatever the screen size. On the Mac+ or SE standard screen, a zoomed window will be 80 columns wide (Monaco-9 still).
  180.  
  181.         Ñ MultiFinder gives a very small memory space to the DAs, and in the current System version (4.2) the clipboard doesn't works properly with DAs if it gets larger than about 4K (4000 chars) with 1M RAM, or 8K with 4M; this may cause problems for longer texts as the clipboard is used by many functions in JoliWrite. If this happens, you'll see some garbage in your text, fortunately undo'ing the last command will give you a chance to save it clean. In this case, the best is to install JoliWrite in an application which gives it more memory than the System does. Runner is a "shell" exactly written for that purpose, read its "About╔" for installing process. When run from Runner, JoliWrite works perfectly under MultiFinder.
  182.  
  183.  
  184.     - Shareware
  185.  
  186.         Ñ JoliWrite is shareware, it's not free. If you decide to keep it, please send me back $20 at 68, avenue d'Italie, 75013 Paris, France. Any future update is included in the price; they will be available by download from the main networks. Send a disk (or add $5) if you want to receive the next version directly.
  187.  
  188.         Ñ Any feedback or suggestion for improving JoliWrite is welcome...
  189.  
  190. 88/5/3 - ⌐ Benoöt Widemann - Calva: BW10 - Delphi/Pan: BENOITW
  191.  
  192.