home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / progs / papyrus / papyru.doc < prev    next >
Text File  |  1993-05-17  |  12KB  |  261 lines
  1.  
  2.  
  3.  
  4. paPYrus (tm) Supplemental instructions for BBS users, sysops, network admins
  5. -------------------------------------------------------------------------------
  6. Note: A product summary appears below, enclosed within a box.
  7.  
  8. Contents:   * General instructions
  9.             * Special instructions for BBS users
  10.             * Special instructions for BBS sysops
  11.             * Special instructions for network administrators
  12.  
  13.  
  14.  
  15. ----- GENERAL INSTRUCTIONS -----
  16.  
  17.  
  18. Contact information:
  19.  
  20.     24 hour, 7 day toll-free voicemail information hotline:    1-800-497-2896
  21.     Currently accessible in the U.S.A. and Canada only.
  22.  
  23.     Jon C. Duringer, Crafter
  24.     142 N. Milpitas Blvd., #190
  25.     Milpitas, CA 95035-4401
  26.     USA
  27.  
  28. Most paPYrus documentation is accessed by opening the paPYrus program object
  29. on your desktop display.  If you do not move the mouse or key anything in the
  30. first 10 seconds that paPYrus is completely open, a message will appear that
  31. directs you to the menu which contains the documentation.
  32.  
  33. paPYrus is distributed within the user community as authors selfpublish their
  34. writings to readers.  paPYrus writing is always "cloned" to diskette rather
  35. than printed on paper.  The recipient of a paPYrus clone diskette "opens" it
  36. to view the writing.  Once this is done, a paPYrus program object will appear
  37. on the desktop, and the recipient has full, permanent access to all paPYrus
  38. functions.
  39.  
  40. Each paPYrus clone diskette is a complete, self-contained, fully functional
  41. distribution package; no other files or documentation are needed.
  42.  
  43.  
  44.  
  45.  
  46. ----- SPECIAL INSTRUCTIONS FOR BBS USERS -----
  47.  
  48.  
  49. paPYrus users ARE supposed to privately distribute entire clone diskettes to
  50. one another, but the following rules and shortcuts can be followed to reduce
  51. file transfer time and to standardize how paPYrus users communicate on BBS's:
  52.  
  53.  
  54.     1. Do not upload an entire clone diskette image onto a public bulletin
  55.        board or network without prior voicemail permission from the crafter.
  56.        (An employer bbs or network is ok if it is not open to the public.)
  57.  
  58.  
  59.     2. If you are granted permission to upload an entire clone diskette, never
  60.        upload it in zip'd or arc'd form; always use a self-extracting diskette
  61.        image file if compression is needed.
  62.  
  63.        Adhering to the "clone diskette" concept makes paPYrus easier for new
  64.        users to understand and eliminates problems related to incorrect manual
  65.        reconstruction of the subfolders (subdirectories) used by LEAF
  66.        references.
  67.  
  68.  
  69.     3. If you are granted permission to upload a clone diskette image,
  70.        always use the following standard file names and descriptions:
  71.  
  72.        For the self extracting clone diskette image:
  73.        +----------------------------------------------------------------------+
  74.        |                                                                      |
  75.        | PAPYRU.EXE "paPYrus (tm) --- An editor for the 21'st century!"       |
  76.        |                                                                      |
  77.        | PAPYRUS HYPERTEXT PUBLISH ROYALTY DRAW PAINT EDITOR WORD WRITE TREE  |
  78.        |                                                                      |
  79.        | Introducing tree writing, an experimental writing form.  Eliminate   |
  80.        | writers' and readers' block by eliminating paragraphs.  Use to read, |
  81.        | write, selfpublish.  Includes interface to payPERview (sm) reading   |
  82.        | fee service.                                                         |
  83.        |                                                                      |
  84.        | Metered shareware.  Approx. annual cost of regular use is $40 U.S.   |
  85.        | plus reading fees (set by authors).  No registration; user pays for  |
  86.        | refills.                                                             |
  87.        |                                                                      |
  88.        | Req: OS/2 2.0; .6Mb perm + 2Mb temp drive C space; diskette drive.   |
  89.        | This image requires a 1.44Mb diskette drive.                         |
  90.        |                                                                      |
  91.        +----------------------------------------------------------------------+
  92.  
  93.        The doc file that you are reading should always be named PAPYRU.DOC and
  94.        then compressed, e.g. zip'd into PAPYRU.ZIP:
  95.        +----------------------------------------------------------------------+
  96.        |                                                                      |
  97.        | PAPYRU.ZIP "paPYrus (tm) doc. for BBS users, sysops, network admins" |
  98.        |                                                                      |
  99.        | PAPYRUS HYPERTEXT PUBLISH ROYALTY DRAW PAINT EDITOR WORD WRITE TREE  |
  100.        |                                                                      |
  101.        | Supplemental doc. for BBS users, sysops, and network administrators. |
  102.        | Download PAPYRU.EXE to obtain all files needed to use paPYrus (tm).  |
  103.        |                                                                      |
  104.        +----------------------------------------------------------------------+
  105.  
  106.  
  107.     4. When uploading your written work, upload only the data file (and leaf
  108.        folders (subdirectories), if any), in a single compressed file.
  109.  
  110.        Generally, you should upload into an area set aside for paPYrus (tm) or 
  111.        for hypertext documents, if available, or into an area reserved for
  112.        creative written work.  Don't upload into an area that is reserved for
  113.        software or for computer support.  To upload:
  114.  
  115.  
  116.        a) CRAFT:  Craft your written work.
  117.  
  118.  
  119.        b) CLONE:  Create a clone diskette by selecting "Clone".
  120.  
  121.  
  122.        c) DESCRIBE:  Include a description text file.  The following can be
  123.        used as an example:
  124.  
  125.        Text file PROS23.DOC:
  126.        +----------------------------------------------------------------------+
  127.        |                                                                      |
  128.        | PROS01.ZIP "An essay on free trade"                                  |
  129.        |                                                                      |
  130.        | PAPYRUS SMITHROBERTO ESSAY TRADE PROTECTIONISM POLITICAL ECONOMY     |
  131.        |                                                                      |
  132.        | "An essay on the benefits of free trade in software for both         |
  133.        | developed and developing regions", by Robert O. Smith.               |
  134.        |                                                                      |
  135.        | Download PAPYRU.EXE and PAPYRU.ZIP to view this document.            |
  136.        | Cost of one full reading:  6 tree branches.                          |
  137.        |                                                                      |
  138.        | ABSTRACT:  Identifies the specific groups likely to benefit or to be |
  139.        | harmed by unrestricted free trade in software.  Analyzes the overall |
  140.        | effect on software production and consumption.                       |
  141.        |                                                                      |
  142.        +----------------------------------------------------------------------+
  143.  
  144.  
  145.        d) ZIP:  Compress ("zip") the "1.TRE" file object on the clone diskette
  146.           into a zip file.  Include the text description (*.DOC) file.  Also
  147.           include any leaf folders that appear on the clone diskette, for their
  148.           presence indicates that they are referenced in the 1.TRE file.
  149.  
  150.           The following naming convention is suggested:  "PiiiNN.ZIP"
  151.  
  152.           where "P" causes all paPYrus documents to sort together, "iii" are
  153.           your initials, and "NN" is a serial number or id for your document.
  154.  
  155.           Hopefully, long file names will soon be supported on bbs's, allowing
  156.           names such as "papyrus.smith.robert.freetrade.rev1.tre".
  157.  
  158.  
  159.        d) UPLOAD:  Upload only the PiiiNN.ZIP file object.
  160.  
  161.  
  162.     4. When downloading someone else's written work (a PiiiNN.ZIP file):  Your
  163.        goal is to recreate, and then open, a clone diskette.  You can do this
  164.        by:
  165.  
  166.         a) CLONE:  Open the paPYrus object on your desktop and clone something
  167.            (any branch will do, but an empty branch is best) onto a diskette.
  168.  
  169.         b) DOWNLOAD:  Download the PiiiNN.ZIP file and unzip into an empty
  170.            temporary folder on your hard drive.  Always create any subfolders
  171.            (subdirectories) stored in the compressed file; this will usually
  172.            not be done for you unless you specify a parameter when unzipping.
  173.  
  174.         c) DELETE:  Delete (or move) any *.DOC text files in the temporary
  175.            folder after reading them.
  176.  
  177.         d) COPY:  Copy the entire contents of this temporary folder, which now
  178.            contains a 1.TRE file and might also contain subfolders, to the
  179.            \PAPYRUS folder on the clone diskette.
  180.  
  181.            Example command:      "xcopy   c:\tmp\*.*   A:\PAPYRUS   /s/e"
  182.  
  183.         e) OPEN:  Open the clone diskette in the normal way.
  184.  
  185.            Example command:      "A:\PAPYRUS\1"
  186.  
  187.  
  188.  
  189.  
  190. ----- SPECIAL INSTRUCTIONS FOR BBS SYSOPS -----
  191.  
  192. The above instructions, if followed by many users on your bbs, will result in
  193. a periodic download of the relatively large PAPYRU.EXE self extracting diskette
  194. image by each paPYrus user who wants to update to the latest version of this
  195. application.  You will also see much up and down traffic in very small
  196. PiiiNN.ZIP (usually compressed, or zip'd) hypertext files which contain
  197. creative writing.  Some of these PiiiNN.ZIP files will be larger because the
  198. hypertext includes simulations, games, and other embedded application programs.
  199.  
  200. Short file name restrictions will hamper users who want to selfpublish
  201. individual works of creative writing on your BBS.  If you start to see an
  202. accumulation of poorly named *.TRE or *.ZIP uploads as writers attempt to find
  203. unique names, please consider the following suggestions:
  204.  
  205.     1. Establish an area reserved for selfpublishing software and a separate
  206.        area reserved for individual selfpublishing documents.
  207.  
  208.     2. Once each month, compress all new document uploads into a single file,
  209.        perhaps named, e.g. "9305.ZIP".
  210.  
  211. The above steps should enable a large number of your BBS users to selfpublish
  212. without leaving files in random areas or running out of meaningful file names,
  213. and is general enough to provide for future (competing) software support for
  214. hypertext selfpublishing.
  215.  
  216.  
  217.  
  218.  
  219. ----- SPECIAL INSTRUCTIONS FOR NETWORK ADMINISTRATORS -----
  220.  
  221.  
  222. To make paPYrus available to network users:
  223.  
  224.     1. Use paPYrus to write up a cover letter that you want to appear whenever
  225.        one of your network users accesses paPYrus for the first time.
  226.  
  227.     2. Clone that cover letter to a diskette.
  228.  
  229.     3. Copy the entire contents of the \papyrus folder, including subfolders
  230.        (subdirectories) if any, on the clone diskette to a folder (directory)
  231.        on a server drive that is accessible to clients.
  232.  
  233. To test your installation, go to a client computer and open (run) the 1.EXE
  234. file object that is among the files that you placed onto the server drive.  You
  235. can do this from any default drive and directory, i.e. you don't need to change
  236. drives or directories.
  237.  
  238. That client should behave just as if you had received a physical clone
  239. diskette; a paPYrus folder will be created on drive C, a paPYrus program object
  240. will appear on the desktop, and your cover letter will appear on the screen.
  241.  
  242.  
  243. To make a paPYrus update available to your network users:
  244.  
  245.     1. Open the clone diskette that has the new version, so that your computer
  246.        is updated.
  247.  
  248.     2. Follow the steps listed above, replacing the folder that you are using
  249.        on the server.
  250.  
  251.     3. Have each client open the 1.EXE file object that is on the server disk.
  252.  
  253. This should result in your cover letter appearing on each client's display,
  254. explaining that they now have a more recent version of paPYrus and explaining
  255. which of the new features might be of special interest to your organization.
  256.  
  257.  
  258.  
  259.  
  260. ----- THE END -----
  261.