home *** CD-ROM | disk | FTP | other *** search
/ HTML - Publishing on the Internet / html_cdrom.iso / editoren / os_2 / ww2 / readme.txt < prev    next >
Text File  |  1995-08-18  |  16KB  |  410 lines
  1.  
  2.  
  3. W e b W r i t e r / 2
  4.  
  5. Version 1.0
  6.  
  7.  
  8. A HyperText Markup Language editor for OS/2.
  9.  
  10. Don't write Home without it!
  11.  
  12.  
  13. Written by John Blumel.
  14.  
  15. (C) Copyright 1995 John Blumel.
  16. All rights reserved.
  17.  
  18. ================================================================================
  19.  
  20.  
  21. INTRODUCTION
  22.  
  23.     WebWriter/2 is an HTML editor designed and written for OS/2.
  24.  
  25.     Currently WebWriter/2 directly supports the creation of HTML version 2.0 
  26. documents.  It also includes the capability for the user to define tags which 
  27. are not currently supported, allowing users to include tags from more recent 
  28. HTML specifications.  At least some knowledge of HTML is assumed and no syntax 
  29. checking of documents is performed.
  30.  
  31.     This version of WebWriter/2 was released on August 19, 1995.  If this 
  32. version of WebWriter/2 is more than a couple of month's old or if you just want 
  33. to make sure that you are up to date you may wish to check for the latest 
  34. version at:
  35.  
  36.         http://www.wilmington.net/bmtmicro/ww2.htm
  37.  
  38. Or you may contact me through one of the methods listed in the Getting Technical
  39. Support section below.
  40.  
  41.     WebWriter/2 is shareware and its use and distribution are subject to the
  42. terms specified in the license.txt file and the license panel of the on-line 
  43. help.
  44.  
  45.     Thank you for trying WebWriter/2.  I hope you find it both useful and easy 
  46. to use.  If you have suggestions for enhancements or useability improvements, 
  47. or if you discover defects in WebWriter/2, please contact me through one of the
  48. methods listed in the Getting Technical Support section below.
  49.  
  50.     WebWriter/2 is implemented in REXX using Watcom International Corporation's
  51. VX-REXX.
  52.  
  53. ________________________________________________________________________________
  54.  
  55. NOTE
  56.  
  57.     The file README.HTM is an HTML version of this document which can be loaded
  58. into a WWW client.  
  59.  
  60. ________________________________________________________________________________
  61.  
  62. INSTALLATION
  63.  
  64. Prerequisites:
  65.  
  66.     1. You must have installed OS/2 REXX support.
  67.        REXX support is installed automatically with OS/2 version 3.0 (i.e., 
  68.        Warp).  If you have using  a 2.x version of OS/2 you will need to
  69.        install REXX support using the Selective Install utility if you have 
  70.        not already done so.
  71.  
  72.     2. You must have the file vrobj.dll.
  73.        If the .zip file containing this file did not include vrobj.dll, you
  74.        can retrieve vrobj21c.zip from:
  75.  
  76.                 http://www.watcom.on.ca/fix_vxrexx/vrobj21c.zip
  77.  
  78.        It is also available via anonymous ftp from:
  79.  
  80.                 ftp.watcom.on.ca/pub/bbs/wrexxpf/vrobj21c.zip
  81.  
  82. --------------------------------------------------------------------------------
  83.  
  84. Installing WebWriter/2:
  85.  
  86.     1. Install OS/2 REXX support, using the OS/2 Selective Install utility if 
  87.        necessary.
  88.  
  89.     2. Unzip ww2_100.zip into a temporary directory.
  90.  
  91.     3. Make sure that 
  92.        a. vrobj.dll exists in a directory in your LIBPATH.
  93.       or 
  94.        b. You have the file vrobj.dll in the directory that you unzipped 
  95.           ww2_100.zip into.
  96.  
  97.     4. If you are reinstalling WebWriter/2, delete the WebWriter/2 Folder and 
  98.        Program objects before continuing.
  99.  
  100.     5. Run Install.exe.
  101.  
  102.     6. You may wish to view the readme file that is loaded in the WebWriter/2 -
  103.        Installation window before you continue.
  104.  
  105.     7. Select Install/Install from the WebWriter/2 - Installation menu to start
  106.        the installation process.
  107.  
  108.     8. Fill in the Install WebWriter/2 options and click Continue.  You may wish
  109.        to install VROBJ.DLL to the C:\OS2\DLL directory rather than another
  110.        directory which will need to be added to your LIBPATH statement in your
  111.        CONFIG.SYS file.
  112.  
  113.     9. WebWriter/2 will be installed using the entries you have made and a
  114.        WebWriter/2 folder and program objects will be created on your desktop.
  115.  
  116.    10. If your CONFIG.SYS was updated you will need to shutdown and restart your
  117.        system for the changes to take effect.
  118. ________________________________________________________________________________
  119.  
  120. USING WebWriter/2
  121.  
  122.     WebWriter/2 allows you to create HTML documents from scratch or to markup 
  123. existing text documents.  You may also preview documents using either IBM's 
  124. WebExplorer or another WWW client including Netscape.  If you use IBM's 
  125. WebExplorer as your WWW client you can use WebWriter/2 as your viewer for HTML
  126. document source.  For more information on how  to do this consult the 
  127. WebWriter/2 on-line help. 
  128.  
  129.     WebWriter/2 uses a MSDI (Multiple Single Document Interface) method of 
  130. editing multiple documents.  You can open as many WebWriter/2 windows as you 
  131. want as long as you can keep track of what you are doing.  To help manage the 
  132. open documents you may wish to display the WebWriter/2 - Window list.  You can
  133. do this by selecting it from the Windows menu or from the OS/2 window list.  
  134. Clicking mouse button 2 on the WebWriter/2 - Window list will bring up a context
  135. menu of options.
  136.  
  137.     To insert HTML tags, select the desired tag from the Tags menu.  Tags which 
  138. have additonal or optional elements will present the user with a dialog 
  139. prompting for the necessary information.  Additional tags may be defined and 
  140. inserted by selecting Tags/More tags... .  Special characters can be selected 
  141. from the Characters menu or from the Character entities dialog which is 
  142. displayed by selecting Characters/More characters... .  When inserting HTML 
  143. tags, selected text will be wrapped by the tag if it is two sided.  One sided 
  144. tags will be inserted before selected text.  Character entities will be inserted
  145. before selected text.  
  146.  
  147.     More detailed information on specific features of WebWriter/2 can be found 
  148. in the on-line help which is now available.
  149.  
  150.     If you are not familiar with HTML you may wish to obtain one of the many 
  151. books available on this topic.  "Teach Yourself Web Publishing with HTML in a 
  152. Week" by Laura Lemay ( SAMS Publishing, 1995 ) is a good book for beginners.  
  153. By the time you read this "Teach Yourself More Web Publishing with HTML in a 
  154. Week" by Laura Lemay ( SAMS Publishing, 1995 ) should be on the shelves.  There 
  155. are also many WWW sites which provide up to date HTML documentation and 
  156. examples.  Although these are too numerous to list here, one good site is:
  157.  
  158.                 http://www.w3.org/hypertext/WWW/MarkUp/MarkUp.html  
  159.  
  160. You can refer to the HTML20.HTM file included with this .ZIP for basic HTML 
  161. information.
  162.  
  163. ________________________________________________________________________________
  164.  
  165. WHAT'S NEW
  166.  
  167.  
  168. NEW IN VERSION 1.0
  169.  
  170. Enhancements:
  171.  
  172.     1. WebWriter/2 now has full context sensitive help.  Most of the help 
  173.        information that was previously in this readme file can now be found in 
  174.        the on-line help.
  175.    
  176.     2. The Tag manager & Character manager dialogs are now resizable and no 
  177.        longer resize themselves when columns are displayed and hidden.  This 
  178.        can allow these dialogs to be used as palettes for Tags and Character 
  179.        entities by resizing them to display only the tag or character name and 
  180.        making them as tall as desired to display many tags or characters at once.
  181.  
  182.     3. The speed of the "Change all" option of the Find dialog has been 
  183.        increased considerably.
  184.  
  185.     4. The "Change to" string in the Find dialog is now saved between 
  186.        invocations of this function.
  187.  
  188.     5. You can now preview without saving from the default document directory.  
  189.        This option can be specified on the Paths page of the settings notebook.  
  190.        This is particularly useful for previewing documents with images which 
  191.        are stored in the default directory or for testing links to other 
  192.        documents in the default directory.
  193.  
  194.     6. The Printer setup dialog now allows you to specify wrapping of printed 
  195.        output at up to 106 columns.  This defaults to wrapping at 80 columns.
  196.  
  197.     7. Accelerators were added to several menu items in the Tags menu.  
  198.        The following accelerator keys can now be used for inserting tags:
  199.                 
  200.         a. Headings
  201.            - Alt+1,2,3,4,5 or 6 will insert the
  202.              corresponding heading tag (<Hn></Hn>).
  203.         b. Paragraph
  204.            - Alt+P will insert the the paragraph tag
  205.              (<P></P>).
  206.            - Ctrl+Enter will insert a newline then the 
  207.              paragraph tag.
  208.         c. Horizontal rule
  209.            - Alt+H will insert a <HR> tag.
  210.         d. Line break
  211.            - Alt+B will insert a <BR> tag.
  212.         e. List item
  213.            - Alt+I will insert a <LI> tag.
  214.            - Shift+Enter will insert a newline and then a
  215.              <LI> tag.
  216.         f. Unordered list
  217.            - Alt+L will insert the <UL></UL> tag.
  218.         g. Ordered list
  219.            - Alt+O will insert the <OL></OL> tag.
  220.  
  221.     8. Technical support has moved to: 
  222.  
  223.         jblumel@gs.net    
  224.  
  225.  
  226.  
  227. Fixes:
  228.  
  229.     1. Fixed a problem where the document path used in file dialogs would be 
  230.        changed to the TMP directory following previewing a document.
  231.  
  232.     2. If Cancel was clicked in the "Save as" dialog when previewing a document,
  233.        the preview would continue.  This was changed so that the preview 
  234.        operation is now cancelled as well as the save.
  235.  
  236.     3. The "Printer setup" dialog would get lost behind other open windows if 
  237.        another window was clicked on while the dialog was open.  The "Printer 
  238.        setup" dialog is now system modal and must be closed to continue.
  239.  
  240.     4. Fixed a problem with the Edit window not refreshing properly following no
  241.        more occurences for a "Change then find" operation.  This along with the 
  242.        not found message  was somewhat confusing.
  243.  
  244.     5. If the settings notebook was opened while many Edit windows were open, 
  245.        the open windows would not properly refresh their settings when the 
  246.        notebook was closed.  This resulted in the preview applications 
  247.        disappearing from the File/Preview menu.  This was changed  so that the
  248.        Edit windows refresh their settings the next time they become active 
  249.        rather than immediately.  This avoids the problem which seems to have 
  250.        been caused by sharing conflicts when accessing the .ini file.
  251.  
  252.  
  253. --------------------------------------------------------------------------------
  254.  
  255. NEW IN VERSION 0.9 BETA 2
  256.  
  257. Enhancements:
  258.  
  259.     1. You can now define and insert your own tags using the Tag manager dialog.  
  260.  
  261.     2. Enhanced drag and drop support.
  262.  
  263.     3. Enhanced support for non-English characters.
  264.  
  265.     4. Multiple preview applications may now be configured.
  266.  
  267.     5. You may now, optionally, display a status bar which will display hint text 
  268.        describing menu items.  For tags and character entities the element 
  269.        inserted when the menu option is selected is displayed.
  270.  
  271.     6. You can now select the printer you wish to print to including direct 
  272.        printing to an LPT device using the OS/2 print command.  Direct to LPT 
  273.        printing can be useful if you are having trouble printing to an OS/2 
  274.        printer.  This can also allow 2 & 4 up printing if you have a utility 
  275.        that supports this.
  276.  
  277.     7. WebWriter/2 now uses the C level patch version of VROBJ.DLL.
  278.  
  279.  
  280. Fixes:
  281.  
  282.     1. A problem with WebWriter/2 locking up on startup including locking up the 
  283.        entire OS/2 system has been fixed.
  284.  
  285.     2. A problem with the edit window contents sometimes not redisplaying 
  286.        properly when a document was inserted or opened has been fixed.
  287.  
  288.     3. Problems with locating the exact position of text in the edit window 
  289.        during find and replace operations have, I believe, been resolved by the
  290.        Patch level C version of VROBJ.DLL and minor code changes.
  291.  
  292.     4. Many annoying little problems which somehow manged to slip through to the 
  293.        first beta release.
  294.  
  295.  
  296. ───────────────────────────────────
  297.  
  298. REGISTERING WebWriter/2
  299.  
  300.     If you decide that you wish to continue using WebWriter/2 beyond the 30 day
  301. evaluation period, you will need to register it.  The registation fee is $30.00 
  302. U.S.  When you register you will be sent a registration code.  After you enter
  303. your registration information WebWriter/2 will display your name in the Product 
  304. information dialog, the Registration menu will no longer appear on the Edit 
  305. window menu bar and dialogs reminding you to register will no longer be
  306. displayed.
  307.  
  308.     Please print and fill out the register.txt file included with WebWriter/2.
  309. If the copy of WebWriter/2 you obtained did not include the register.txt file,
  310. send the following information:
  311.  
  312.     - Your name
  313.     - Postal address
  314.     - Email address
  315.     - Phone (Home/Work)
  316.     - WebWriter/2 version number
  317.     - How you obtained WebWriter/2
  318.     - Any other comments you may have
  319.  
  320.     To register send a check or money order in the amount of the registration 
  321. fee(s) payable to John Blumel and drawn on a U.S. bank to:
  322.  
  323.     John Blumel
  324.     1949 Green Oak Drive
  325.     Terrytown, LA  70056
  326.     USA
  327.  
  328. --------------------------------------------------------------------------------
  329.  
  330.     For convenience of payment, you may wish to register WebWriter/2 through 
  331. BMT Micro.  BMT Micro will accept the following forms of payment:
  332.  
  333.         - Visa
  334.         - MasterCard
  335.         - Discover
  336.         - American Express
  337.         - Money Order
  338.         - Cashiers Check
  339.         - Personal Check
  340.  
  341.     Checks and money orders should be made payable to BMT Micro.  Registration
  342. through BMT Micro may be done in any of the following ways:
  343.  
  344.         Mail Orders:  BMT Micro
  345.                       452 Horn Road
  346.                       Wilmington, NC 28412-2411
  347.                       U.S.A.
  348.  
  349.        Voice Orders:  9:00am - 7:00pm EST (-5 GMT)
  350.                       (800) 414-4268 (orders only)
  351.                       (910) 791-7052
  352.  
  353.          Fax Orders:  (910) 350-2937  24 hours / 7 Days
  354.  
  355.                 BBS:  (910) 350-8061  10 lines, all 14.4K
  356.                       (910) 799-0923  Direct 28.8K line
  357.  
  358.     If you wish to place the order through BMT Micro via Mail or Fax, please 
  359. print and fill out the BMTOrder.txt file which was included in the WebWriter/2 
  360. archive.
  361.  
  362.  
  363. --------------------------------------------------------------------------------
  364.  
  365.     Corporations and/or organizations interested in site licenses should contact 
  366. the author (John Blumel) prior to registering.
  367.  
  368. ________________________________________________________________________________
  369.  
  370. TECHNICAL SUPPORT
  371.  
  372. Known Problems
  373.  
  374.     1. Some characters do not display properly in the "Character entity" dialog.
  375.        These characters have been replaced with a text description equivalent in 
  376.        the Character column.  The character entity inserted when one of these 
  377.        characters is selected is however correct.
  378.  
  379.        This problem is due to the fact that codepage 437 which is the default 
  380.        for English language installations of OS/2 does not support display of 
  381.        these characters.  I am currently exporing options for a workaround for 
  382.        this problem.  This would involve use of codepage 850 and would require 
  383.        that this codepage be specified as either the primary or alternate 
  384.        codepage in the CONFIG.SYS.
  385.  
  386.  
  387. --------------------------------------------------------------------------------
  388.  
  389. Getting Technical Support
  390.  
  391.     For technical support, suggestions or to report bugs in WebWriter/2, I can 
  392. be reached at:
  393.  
  394.         jblumel@gs.net
  395.  
  396.     Or:
  397.  
  398.         John Blumel
  399.         1949 Green Oak Drive
  400.         Terrytown, LA  70056
  401.  
  402.     Technical support will not be available from 2 weeks preceding Mardis Gras 
  403. until after Ash Wednesday.
  404.  
  405. ________________________________________________________________________________
  406. ________________________________________________________________________________
  407.  
  408. (C) Copyright 1995 John Blumel.
  409. All rights reserved.
  410.