home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / SA_V11.ZIP / SA_USERS.DOC < prev    next >
Encoding:
Text File  |  1992-11-28  |  42.9 KB  |  1,456 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                       Shareware Author (tm) Version 1.1
  11.  
  12.                              Copyright (c) 1992
  13.                             All Rights Reserved
  14.  
  15.                                     by
  16.  
  17.                              William Ned Miller
  18.  
  19.                              7504 Saffron Court
  20.                               Hanover MD 21076
  21.                                (410) 766-2365
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55. Section                                                         Page
  56.  
  57.  
  58. 1.0 Introduction ...............................................  1
  59.    1.1 Document Layout .........................................  2
  60.  
  61. 2.0 System Requirements ........................................  3
  62.    2.1 Hardware Requirements ...................................  3
  63.    2.2 Video Adapters ..........................................  3
  64.    2.3 Operating System Limitations ............................  3
  65.  
  66. 3.0 Installation ...............................................  4
  67.  
  68. 4.0 Program Options ............................................  5
  69.    4.1 Add Product .............................................  5
  70.    4.2 Delete Product ..........................................  6
  71.    4.3 Modify Product ..........................................  6
  72.    4.4 Select Product ..........................................  6
  73.       4.4.1 Add User ...........................................  7
  74.       4.4.2 Delete User ........................................  7
  75.       4.4.3 Modify User ........................................  8
  76.       4.4.4 List Users .........................................  8
  77.       4.4.5 View ...............................................  8
  78.       4.4.6 Expenses ...........................................  9
  79.          4.4.6.1 Add Expense ...................................  9
  80.          4.4.6.2 Delete Expense ................................ 10
  81.          4.4.6.3 Modify Expense ................................ 10
  82.          4.4.6.4 List Expenses ................................. 10
  83.          4.4.6.5 View Expenses ................................. 10
  84.          4.4.6.6 Find Expense Record ........................... 11
  85.       4.4.7 Code ............................................... 11
  86.          4.4.7.1 Modify Code ................................... 12
  87.       4.4.8 .................................................... 12
  88.    4.5 Associated Files ........................................ 12
  89.    4.6 BBS ..................................................... 13
  90.    4.7 Miscellaneous ........................................... 13
  91.       4.7.1 Program Colors ..................................... 13
  92.       4.7.2 FILE_ID.DIZ ........................................ 13
  93.       4.7.3 Program Setup ...................................... 14
  94.       4.7.4 Mouse Setup ........................................ 14
  95.    4.8 Extended Help ........................................... 15
  96.  
  97. 5.0 Mouse Support .............................................. 16
  98.  
  99. 6.0 Shareware Author Files ..................................... 17
  100.  
  101. 7.0 Shareware Author Error Messages ............................ 18
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.                                - i -
  109. Section                                                         Page
  110.  
  111.  
  112. 8.0 List Of Bug Fixes .......................................... 19
  113.  
  114. 9.0 Whats New .................................................. 20
  115.  
  116. 10.0 Licensing ................................................. 21
  117.  
  118. 11.0 Disclaimer ................................................ 22
  119.  
  120. 12.0 Where Shareware Author Can Be Found ....................... 23
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.                                - ii -
  163. 1.0 Introduction
  164.  
  165.      Shareware Author is a tool that will allow authors to keep track of
  166. their authored products.  The author will be able to keep track of registered
  167. users, expenses, create a 'file_id.diz' file and display reports.  The
  168. program will allow the author to keep track of fifteen different products.
  169. If there is more than one entry in the list the up and down arrow keys will
  170. allow the user to select the product desired.  Users with a mouse can
  171. position the pointer over the desired entry and press the left mouse button
  172. to select the desired entry.
  173.  
  174.      The following diagram presents the main display for Shareware Author.
  175.  
  176.  
  177.  
  178. █████████████████████████████████████████████████████████████████18:00:00█
  179. █                           Shareware Author                             █
  180. ██████████████████████████████████████████████████████████████████████████
  181. █Product               Version Date     Filename      Price  Type        █
  182. █Power Scanner         V4.2    11/01/92 ps_v42.zip    17.00  File Manager█
  183. █Shareware Author      V1.1    11/01/92 sa_v11.zip    17.00  User Support█
  184. █                                                                        █
  185. █                                                                        █
  186. █                                                                        █
  187. █                                                                        █
  188. █                                                                        █
  189. █                                                                        █
  190. █                             Working Area                               █
  191. █                                                                        █
  192. █                                                                        █
  193. █                                                                        █
  194. █                                                                        █
  195. █                                                                        █
  196. █                                                                        █
  197. █                                                                        █
  198. █                                                                        █
  199. █DOS:5.00█c:\sa████████████████████████████████████████████████████?=Help█
  200. █F1-Add F2-Del F3-Mod F4-Sel F5-Files F6-BBS F7-Misc             F10-Exit█
  201. ██████████████████████████████████████████████████████████████████████████
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.                                - 1 -
  217.      Shareware Author was developed in the programming language Ada and
  218. tested under DOS versions 3.10, 3.30 and 5.00.
  219.  
  220.  
  221. 1.1 Document Layout
  222.  
  223.      The remainder of this document is as follows:
  224.  
  225.      Chapter 2  - System Requirements
  226.  
  227.      Chapter 3  - Installation Procedures
  228.  
  229.      Chapter 4  - Program Options
  230.  
  231.      Chapter 5  - Mouse Support
  232.  
  233.      Chapter 6  - Shareware Author Files
  234.  
  235.      Chapter 7  - Shareware Author Error Messages
  236.  
  237.      Chapter 8  - List Of Bug Fixes
  238.  
  239.      Chapter 9  - Whats New
  240.  
  241.      Chapter 10 - Licensing
  242.  
  243.      Chapter 11 - Disclaimer
  244.  
  245.      Chapter 12 - Where Shareware Author Can Be Found
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.                                - 2 -
  271. 2.0 System Requirements
  272.  
  273.      This chapter describes system requirements necessary to execute
  274. Shareware Author.
  275.  
  276.  
  277. 2.1 Hardware Requirements
  278.  
  279.      Shareware Author is compatible with the XT, AT, PS2 models and other
  280. 100% compatible systems.
  281.  
  282.      Shareware Author has been built to run on the 8086/8088 instructions
  283. set.  Upon request, Shareware Author can be built to run in real mode.  This
  284. is for machines based on the 80826/80386/80486 or similar compatible systems.
  285. These versions tend to be smaller than programs compiled using normal
  286. 8086/8088 instructions.  Authors must register the program to obtain a copy
  287. built for the 286,386 or 486 systems.
  288.  
  289.      Shareware Author will allow the author to keep track of fifteen
  290. different products.  The program will allow an unlimited number of registered
  291. users and expenses for each product.  The only limitation is the capacity of
  292. the disk drive.
  293.  
  294.      Shareware Author will support the mouse user.  Positioning the mouse
  295. pointer over the function key indicator in the function key area and pressing
  296. the left mouse button will activate the indicated function.
  297.  
  298.  
  299. 2.2 Video Adapters
  300.  
  301.      Shareware Author will operate with all type of video adapters.  It has
  302. been designed and tested with Monochrome, EGA, CGA and VGA adapters.
  303.  
  304.  
  305. 2.3 Operating System Limitations
  306.  
  307.      Shareware Author has been designed to execute on systems with DOS
  308. versions 3.00 through 5.00.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                                - 3 -
  325. 3.0 Installation Procedures
  326.  
  327.      The following procedures allow new authors to easily install Shareware
  328. Author on their system.  The following procedures make the assumption that
  329. you have a hard disk as drive "c", boot from that drive and will be using
  330. "c:\sa" as the directory for the program and "c:\sa\database" for the data
  331. files.
  332.  
  333.  
  334. 1) Create a directory on the disk where Shareware Author is to be installed.
  335.    (ie: md c:\sa)
  336.  
  337. 2) Create a directory where Shareware Author's database files will reside.
  338.    (ie: md c:\sa\database)
  339.  
  340. 3) Copy all Shareware Author files to the directory created above.
  341.    (ie: copy *.* c:\sa)
  342.  
  343. 4) Change to Shareware Author directory
  344.    (ie: cd c:\sa)
  345.  
  346. 5) Enter sa at DOS prompt
  347.    (ie: sa)
  348.  
  349. 6) Activate the setup option under the miscellaneous option to define where
  350.    Shareware Author's database files will reside. Under the configuration
  351.    option and then the setup option enter the following for the database
  352.    directory.
  353.    (ie: c:\sa\database)
  354.  
  355.    Users that send in the $17 shareware contribution will receive
  356.    instructions on how to remove the time and shareware request and replace
  357.    it with their own name and registration number.
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.                                - 4 -
  379. 4.0 Program Options
  380.  
  381.      This chapter will explain each of the options available with the
  382. Shareware Author program.
  383.  
  384.  
  385. 4.1 Add Product
  386.  
  387.      This section describes how to add a product to Shareware Author's
  388. database.  Pressing the F1 function key from the main display will activate
  389. the editor.  The author will be able to insert the program's name, version,
  390. release date, filename it is archived under, price of the product and the
  391. product's type.  Once the data has been entered, pressing the F10 function
  392. key will add the record and pressing the escape key will cancel the add
  393. operation.  The following will be presented to the author:
  394.  
  395.  
  396. █████████████████████████████████████████████████████████████████18:00:00█
  397. █                          Shareware Author                              █
  398. ██████████████████████████████████████████████████████████████████████████
  399. █                             Add Product   x                            █
  400. █                                           |                            █
  401. █Program:  _                                |- {x Record Being Added}    █
  402. █Version:                                                                █
  403. █Date:                                                                   █
  404. █Filename:                                                               █
  405. █Price:                                                                  █
  406. █Type:                                                                   █
  407. █                                                                        █
  408. █                                                                        █
  409. █                                                                        █
  410. █                                                                        █
  411. █                                                                        █
  412. █                                                                        █
  413. █                                                                        █
  414. █                                                                        █
  415. █                                                                        █
  416. █                                                                        █
  417. █                                                                        █
  418. █                                                                        █
  419. ██████████████████████████████████████████████████████████████████████████
  420. █F10-Update                                                    ESC-Cancel█
  421. ██████████████████████████████████████████████████████████████████████████
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.                                - 5 -
  433. 4.2 Delete Product
  434.  
  435.      This option will allow the author to delete a product from Shareware
  436. Author's database.  The arrow keys are to be used to position the cursor over
  437. the desired product.  If the user has a mouse, position the mouse pointer
  438. over the desired entry and pressing the left mouse button will select the
  439. desired entry.  Before the product is deleted, the author will be required to
  440. verify the deletion.  Once a product is deleted all of it's associated
  441. database files will be deleted.  If the author wants to save the database
  442. files, then they should be saved in another directory or on another disk.
  443.  
  444.  
  445. 4.3 Modify Product
  446.  
  447.      This option allows the author to modify a product that already exists in
  448. Shareware Author's database.  The arrow keys are to be used to position the
  449. cursor over the desired product.  If the user has a mouse, position the mouse
  450. pointer over the desired entry and pressing the left mouse button to select
  451. the desired entry.  Once the product that is to be modified has been
  452. selected, pressing the F3 function key will display that product so it can be
  453. edited.  Pressing the escape key will cancel the operation without updating
  454. the product and pressing the F10 function key will update the product.
  455.  
  456.  
  457. 4.4 Select Product
  458.  
  459.      This option allows the author to access the registered users of the
  460. selected product.  The up and down arrow keys are to be used to position the
  461. cursor over the desired product.  If the user has a mouse, position the mouse
  462. pointer over the desired entry and pressing the left mouse button will select
  463. the desired entry.  Once the product that is to be selected has been
  464. identified, pressing the F4 function key will display the registered users of
  465. that product.  Pressing the F10 function key will return the author back to
  466. the main display.  The data for each registered users is more than will fit
  467. on one screen, the left and right arrow keys can be used to scroll the screen
  468. left to right and right to left.  Positioning the mouse pointer to the left
  469. or right of the "arrow indicators" and pressing the left mouse button will
  470. also allow the screen to scroll left and right.  The small arrows on the
  471. third line of the display indicated which way the data can be scrolled.  The
  472. name of the selected product will be displayed on the third line of the
  473. display for easy reference.
  474.  
  475.    Home - First Page    Up Arrow   - Up One Entry    PgUp - Page Up
  476.    End  - Last Page     Down Arrow - Down One Entry  PgDn - Page Down
  477.  
  478.              Left Arrow - Pan Left   Right Arrow - Pan Right
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.                                - 6 -
  487.  
  488. █████████████████████████████████████████████████████████████████18:00:00█
  489. █                          Shareware Author                              █
  490. █Selected Product█████████████████████████████████████████████████████████
  491. █     Name                      Address                   City           █
  492. █0001 Ned Miller                7504 Saffron Ct.          Hanover        █
  493. █0002 User 2                    123 Main Street           Anywhere       █
  494. █0003 User 3                    321 Maple Street          Overthere      █
  495. █                                                                        █
  496. █                                                                        █
  497. █                                                                        █
  498. █                                                                        █
  499. █                                                                        █
  500. █                                                                        █
  501. █                                                                        █
  502. █                                                                        █
  503. █                                                                        █
  504. █                                                                        █
  505. █                                                                        █
  506. █                                                                        █
  507. █                                                                        █
  508. █                                                                        █
  509. █                                                                        █
  510. █                                                                        █
  511. ██████████████████████████████████████████████████████████████████████████
  512. █F1-Add F2-Del F3-Mod F4-Lis F5-View F6-Exp F7-Code F8-Find F10-Main_Menu█
  513. ██████████████████████████████████████████████████████████████████████████
  514.  
  515.  
  516. 4.4.1 Add User
  517.  
  518.      This options will allow the author to add registered users into
  519. Shareware Author's database.  Pressing the F1 function key will activated the
  520. add option.  The author will be able to add a users name, address, city,
  521. state, zip, country and if the user paid or not.  The paid field is used in
  522. calculating the total revenues for a product.  A value of "yes" indicates
  523. paid and a value of "no" means the registered user did not pay.
  524.  
  525.  
  526. 4.4.2 Delete User
  527.  
  528.      With this option, the author will be able to delete a user from
  529. Shareware Author's database.  Use the page-up, page-down and arrow keys to
  530. select the desired user.  Pressing F2 function key from the user display will
  531. activate the option.  The user will be prompted to verify the deletion.
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.                                - 7 -
  541. 4.4.3 Modify User
  542.  
  543.      This option will allow the user to modify the record of any user in
  544. Shareware Author's database.  Use the page-up, page-down and arrow keys to
  545. select the desired user.  If the user has a mouse, position the mouse pointer
  546. over the desired entry and pressing the left mouse button will select the
  547. desired entry.  Pressing the F3 function key from the user display will
  548. activate the option.  At this point any field in the users record may be
  549. modified.  Pressing the F10 function key will update the record and pressing
  550. the escape key will cancel the operation.
  551.  
  552.  
  553. 4.4.4 List Users
  554.  
  555.      This option will allow the author to dump all register users to a
  556. specified file.  Once the operation is complete, this file can then be viewed
  557. with an editor or printed.  An example of the output is given below.
  558.  
  559.  
  560.  
  561.                Shareware Author List For XYZ         Page:    1
  562.  
  563. 0001 (P)Ned Miller                         410-766-2365     001
  564.         7504 Saffron Ct.                   08/15/92
  565.         Hanover         MD 21076           0000001
  566.         U.S.A.                             5.25
  567. 0002 (P)John Doe                           111-555-1234     001
  568.         123 Maple Street                   08/16/92
  569.         Anytown         TX 12345           0000002
  570.         U.S.A.                              3.5
  571.  
  572.  
  573. 4.4.5 View
  574.  
  575.      This option allows the user to obtain the total amount of revenue
  576. received from their shareware product.  The following will be displayed for
  577. the author:
  578.  
  579.           Records:             2
  580.  
  581.           Paid Users:          2
  582.  
  583.           Product Price:   17.00
  584.  
  585.           Total Revenue:   34.00
  586.  
  587.      The "records" field is the total number of registered users.  "Paid
  588. users" is the number of registered users that have paid for the product.  The
  589. paid field in the user's record is used to make this distinction.  "Yes"
  590. indicates the user paid and "No" indicates the user did not pay.  The Product
  591. price is obtain from the main display and the "total revenue" is calculated
  592. from the "paid users" and the product price.
  593.  
  594.                                - 8 -
  595. 4.4.6 Expenses
  596.  
  597.      Shareware Author provides the capability so that the author can keep a
  598. record of the expenses associated with each of their shareware products.
  599. This option is activated by pressing the F6 function key from the registered
  600. users display.  The following will be displayed for the author:
  601.  
  602.  
  603. █████████████████████████████████████████████████████████████████18:00:00█
  604. █                          Shareware Author                              █
  605. ██████████████████████████████████████████████████████████████████████████
  606. █     Expense              Type                     Date       Amount    █
  607. █0001 Call To XYZ BBS      Phone Call               11/01/92     3.65    █
  608. █0002 Call To ZYX BBS      Phone Call               11/02/92     2.04    █
  609. █0003 Mail Disk            Postage                  11/02/92     1.08    █
  610. █                                                                        █
  611. █                                                                        █
  612. █                                                                        █
  613. █                                                                        █
  614. █                                                                        █
  615. █                                                                        █
  616. █                                                                        █
  617. █                                                                        █
  618. █                                                                        █
  619. █                                                                        █
  620. █                                                                        █
  621. ██████████████████████████████████████████████████████████████████████████
  622. █F1-Add F2-Del F3-Mod F4-List F5-View                       F10-Main_Menu█
  623. ██████████████████████████████████████████████████████████████████████████
  624.  
  625.      The following keys can be used to page through the expense entries in
  626. the database.
  627.  
  628.    Home - First Page    Up Arrow   - Up One Entry    PgUp - Page Up
  629.    End  - Last Page     Down Arrow - Down One Entry  PgDn - Page Down
  630.  
  631.  
  632. 4.4.6.1 Add Expense
  633.  
  634.      This options will allow the author to add expenses into Shareware
  635. Author's database.  Pressing the F1 function key will activated the add
  636. option.  All entries are added to the bottom of the database.  The author
  637. will be able to add an expense, type, date and the amount of the expense.
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.                                - 9 -
  649. 4.4.6.2 Delete Expense
  650.  
  651.      With this option, the author will be able to delete an expense from
  652. Shareware Author's database.  Use the page-up, page-down and arrow keys to
  653. select the desired expense.  If the user has a mouse, position the mouse
  654. pointer over the desired entry and pressing the left mouse button will select
  655. the desired entry.  Pressing the F2 function key from the expense display
  656. will activate this option.  The user will be prompted to verify the deletion.
  657.  
  658.  
  659. 4.4.6.3 Modify Expense
  660.  
  661.      This option will allow the user to modify the record of any expense item
  662. in Shareware Author's database.  Use the page-up, page-down and arrow keys to
  663. select the desired expense.  If the user has a mouse, position the mouse
  664. pointer over the desired entry and pressing the left mouse button will select
  665. the desired entry.  Pressing the F3 function key from the expense display
  666. will activate the option.  At this point any field in the expense record may
  667. be modified.  Pressing the F10 function key will update the record and
  668. pressing the escape key will cancel the operation.
  669.  
  670.  
  671. 4.4.6.4 List Expenses
  672.  
  673.      This option will allow the author to dump all expenses to a specified
  674. file.  Once the operation is complete, this file can then be viewed with an
  675. editor or printed.  The file will have the following format:
  676.  
  677.  
  678.               Shareware Author Expenses List of XYZ      Page:    1
  679.  
  680.      Type                        Type          Date         Amount
  681. 0001 Programmer's Corner         Phone Call    08/15/92       2.53
  682. 0002 Mail Disk                   Postage       08/21/92       0.29
  683. 0003 5.25 Disks                  Disks         09/21/92       7.02
  684.  
  685.                                                    Total:     9.84
  686.  
  687.  
  688. 4.4.6.5 View Expenses
  689.  
  690.      This option allows the author to view the total amount of expenses for
  691. their shareware product.  The following will be displayed for the author:
  692.  
  693.           Records:        3
  694.  
  695.           Expenses:    9.84
  696.  
  697.      The "records" field is the total number of expenses.  The "Expenses" is
  698. the total of all expenses in the database for the product.
  699.  
  700.  
  701.  
  702.                                - 10 -
  703. 4.4.6.6 Find Expense Record
  704.  
  705.      This options allow the author to located any entry in the registered
  706. users database.  Upon activation of this option the following will be
  707. displayed for the author:
  708.  
  709.  
  710.      Locate:
  711.  
  712.      Name:
  713.      Type:
  714.      Date:
  715.      Amount:
  716.  
  717.  
  718.      To locate a specified expense record position the cursor at the
  719. "Locate:" prompt enter the desired value and press the F10 key.  The program
  720. will position the author at the specified record.
  721.  
  722.      To locate an expense record based upon some search criteria enter the
  723. desired data in one or more of the "Name:" through "Amount:" fields.  Once
  724. the desired search criteria has been entered pressing the F10 key will search
  725. for the next record based on the search criteria.  Pressing the F10 key will
  726. allow the author to search for the next occurrence.
  727.  
  728.  
  729. 4.4.7 Code
  730.  
  731.      This option will allow the user to keep in Shareware Author's database
  732. certain information about a particular product.  The user can keep the
  733. current lines of code count, language, location of source code (disk number),
  734. date of code, time it takes to compile the program and 3 lines of comments.
  735. Pressing the F7 function key from the main display will activate the option.
  736. The escape key will return the author to the main display.  The display will
  737. look like the following:
  738.  
  739.               Lines Of Code: 1,123
  740.  
  741.               Language:      Ada
  742.  
  743.               Location:      #243
  744.  
  745.               Date:          12/12/92
  746.  
  747.               Compile Time:  00:23:45
  748.  
  749.               Comments:      Line 1
  750.                              Line 2
  751.                              Line 3
  752.                              Line 4
  753.                              Line 5
  754.  
  755.  
  756.                                - 11 -
  757. 4.4.7.1 Modify Code
  758.  
  759.      This option allows the author to update the code option.  Pressing the
  760. F1 function key from the Code display will activated the editor and pressing
  761. the escape key will cancel the operation and ignore any input.
  762.  
  763.  
  764. 4.4.8 Find User Entry
  765.  
  766.      This options allow the author to located any entry in the registered
  767. users database.  Upon activation of this option the following will be
  768. displayed for the author:
  769.  
  770.      Locate:
  771.  
  772.      Name:
  773.      Address:
  774.      City:
  775.      State:
  776.      Zip:
  777.      Country:
  778.      Phone:
  779.      Owner:
  780.      Date:
  781.      Paid:
  782.  
  783.  
  784.      To locate a specified record position the cursor at the "Locate:" prompt
  785. enter the desired value and press the F10 key.  The program will position the
  786. author at the specified record.
  787.  
  788.      To locate a record based upon some search criteria enter the desired
  789. data in one or more of the "Name:" through "Paid:" fields.  Once the desired
  790. search criteria has been entered pressing the F10 key will search for the
  791. next record based on the search criteria.  Pressing the F10 key will allow
  792. the author to search for the next occurrence.
  793.  
  794.  
  795. 4.5 Associated Files
  796.  
  797.      This option allows the author to keep within Shareware Author's database
  798. the list of files associated with the selected product.  This is the list of
  799. files that would be archived together for distribution.  Pressing the F5
  800. function key from the main display will activate this option.  The following
  801. is an example for Shareware Author.
  802.  
  803.                    01 sa.exe
  804.                    02 sa_help.exe
  805.                    03 sa_users.doc
  806.                    04 readme.1st
  807.                    05 file_id.diz
  808.  
  809.  
  810.                                - 12 -
  811. 4.6 BBS
  812.  
  813.     This option will allow the user to keep track of the BBSes where the
  814. selected product has been uploaded.  Use the up and down arrow keys, on the
  815. main display, to position over the desired product, press the F6 function key
  816. to activate this option.
  817.  
  818.  
  819. 4.7 Miscellaneous
  820.  
  821.      This option will allow the user to perform a number of miscellaneous
  822. functions.  The user can change and set the directory for database files,
  823. define program's colors or create a 'file_id.diz' file.
  824.  
  825.  
  826. 4.7.1 Program Colors
  827.  
  828.      Pressing the F1 function key from the miscellaneous display will
  829. activate the program colors option.  Once activated, the author will be able
  830. to change the colors of the foreground, background and border.  Positioning
  831. the mouse over the appropriate function key will also allow the author to
  832. make modifications.  The following list delineates the options the author may
  833. take.
  834.  
  835.      F1  - Change Foreground
  836.      F2  - Change Background
  837.      F3  - Change Border
  838.      F4  - Reset Default Colors
  839.      F5  - Update & Log Color Settings
  840.      ESC - Cancel Operation
  841.  
  842.      If the user is using a monochrome monitor, the message 'No Colors On
  843. Monochrome Display' will  be displayed for 3 seconds.
  844.  
  845.      The author's color settings are saved in Shareware Author's
  846. configuration file so that every time the program is run the authors colors
  847. settings will remain in affect.
  848.  
  849.  
  850. 4.7.2 FILE_ID.DIZ
  851.  
  852.      This option will allow the user to create an information file used by
  853. PCBoard BBSes.  The contents of this file is to be a brief description of the
  854. shareware product.  The file can contain up to 10 lines & 45 characters per
  855. line. Shareware Author provides the means so the user can create the file
  856. with very little effort.  Pressing the F7 key from the main screen will
  857. display the miscellaneous screen.  At this point pressing the F2 key will
  858. activate the editor. Once the desired information has been entered, pressing.
  859. the F10 key will create the file 'file_id.diz' & place it in the current
  860. directory.  At this point the file can be move to a desired directory.  If
  861. there is a 'file_id.diz' in the current directory, then it can be modified.
  862.  
  863.  
  864.                                - 13 -
  865. 4.7.3 Program Setup
  866.  
  867.      This option will allow the author to define the directory where
  868. Shareware Author's database files will reside.  The author can have multiple
  869. database directories if more than fifteen products need to be tracked.
  870. Shareware Author should be executed from a single directory because the
  871. configuration file "sa_confg.def" contains information about the authors
  872. colors and mouse settings.
  873.  
  874.  
  875. 4.7.4 Mouse Setup
  876.  
  877.      This option will allow the author to define certain attributes about
  878. their mouse.  Pressing the F10 function will save the author's new settings
  879. and pressing the escape key will cancel the operations.  When this option is
  880. selected the following will be presented to the author:
  881.  
  882.      Mouse Installed: Yes
  883.      Buttons: 3
  884.  
  885.      Mouse Cursor: C
  886.      Mouse On/Off: On
  887.      Mouse Switch: Left  Right
  888.  
  889.      X Coordinate: 8
  890.      Y Coordinate: 16
  891.  
  892.      The following keys will allow the author to modify the attributes of the
  893. mouse:
  894.  
  895.      C - Change the mouse pointer
  896.      O - Toggle the mouse On and Off (Driver must be load before the
  897.                                       mouse can be turned on)
  898.      S - Switch the Left and Right mouse buttons
  899.      X - Change the speed of the mouse pointer as it moves along the
  900.          X-Axis
  901.      Y - Change the speed of the mouse pointer as it moves along the
  902.          Y-Axis
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.                                - 14 -
  919. 4.8 Extended Help
  920.  
  921.      The extended help option will provide on-line help for the Shareware
  922. Author user.  Pressing the '?' key will activate this option.  The following
  923. is an example of the extended help display.
  924.  
  925.  
  926. █████████████████████████████████████████████████████████████████18:00:00█
  927. █                          Shareware Author                              █
  928. ██████████████████████████████████████████████████████████████████████████
  929. █                █             Shareware Author Extended HELP            █
  930. █ Add Product    █                                                       █
  931. █ Delete Product █                   William Ned Miller                  █
  932. █ Modify Product █                   7504 Saffron Court                  █
  933. █ Select Product █                    Hanover MD 21076                   █
  934. █ Add/Mod User   █                                                       █
  935. █ Delete User    █    Shareware Author is a  shareware product  released █
  936. █ Find User      █ under the  shareware concept.  Support  the shareware █
  937. █ List Users     █ concept and send in your $17 payment.                 █
  938. █ Add/Mod Expense█                                                       █
  939. █ Delete Expense █                                                       █
  940. █ Find Expense   █                                                       █
  941. █ Files/BBSes    █                                                       █
  942. █ Program Author █                                                       █
  943. █ Colors         █                                                       █
  944. █ Main Display   █                                                       █
  945. █ File_ID.DIZ    █                                                       █
  946. █ Program Setup  █                                                       █
  947. █ Mouse Help     █                                                       █
  948. ██████████████████████████████████████████████████████████████████████████
  949. █-Up -Down                                                   ESC-Cancel█
  950. ██████████████████████████████████████████████████████████████████████████
  951.  
  952.      The "Mouse Help" option shows the mouse hot spots.
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.                                - 15 -
  973. 5.0 Mouse Support
  974.  
  975.      Shareware provides mouse support for authors that prefer to use a mouse.
  976. This chapter contains information on the use of the mouse with the Shareware
  977. Author program.  The following diagram shows the mouse hot spots for the
  978. various options.  If the mouse buttons have been switched then the mouse
  979. referenced in the rest of this chapter will be reversed.
  980.  
  981.  
  982.      ┌──────────────────────────────────────────────────────────────────┐
  983.      │                         Shareware Author                         │
  984.      │  ┌────────────────────────────────────────────────────────────┐  │
  985.      │  │                         <b><c>  <d><e>                     │  │
  986.      │  ├────────────────────────────────────────────────────────────┤  │
  987.      │  │                                                            │  │
  988.      │  │                                                            │  │
  989.      │  │                                                            │  │
  990.      │  │                                                            │  │
  991.      │  │                                                            │  │
  992.      │  │                                                            │  │
  993.      │  │                                                            │  │
  994.      │  │                                                            │  │
  995.      │  │                                                            │  │
  996.      │  │                                                            │  │
  997.      │  ├────────────────────────────────────────────────────────────┤  │
  998.      │  │                                                        <a> │  │
  999.      │  └────────────────────────────────────────────────────────────┘  │
  1000.      │                                                                  │
  1001.      └──────────────────────────────────────────────────────────────────┘
  1002.  
  1003.      <a>  Pressing the left mouse button over the "?=help" will activate
  1004.           the extended help option.  The mouse help option within the
  1005.           help option shows the hot spots for the mouse.
  1006.  
  1007.      <b>  Pressing the left mouse in this area while on the select
  1008.           option, registered user display, will allow the screen to
  1009.           pan left.
  1010.  
  1011.      <c>  Pressing the left mouse in this area while on the select
  1012.           option, registered user display, will allow the screen to
  1013.           pan right.
  1014.  
  1015.      <d>  Pressing the left mouse button over the up arrow will allow
  1016.           the author to page up through the registered users and the
  1017.           expense display.
  1018.  
  1019.      <e>  Pressing the right mouse button over the up arrow will allow
  1020.           the author to page down through the registered users and the
  1021.           expense display.
  1022.  
  1023.  
  1024.  
  1025.  
  1026.                                - 16 -
  1027. 6.0 Shareware Author Files
  1028.  
  1029.      This section will describe all of the files required by Shareware Author
  1030. during execution.  Some of these files are created during the execution of
  1031. the program.  The files tagged with a "*" are create while selecting various
  1032. Shareware Author options.
  1033.  
  1034. 1)   sa.exe       - Shareware Author Main Program
  1035.  
  1036. 2)   sa_help.exe  - Shareware Author Extended Help
  1037.  
  1038. 3)*  sa_confg.def - Shareware Author Color and Mouse Definitions
  1039.  
  1040. 4)*  sa_main.def  - Shareware Author Main Database
  1041.  
  1042. 5)*  sa_dbX       - Shareware Authors User Database
  1043.  
  1044. 6)*  sa_exX       - Shareware Authors Expenses Database
  1045.  
  1046. 7)*  sa_cdX       - Shareware Authors Code Database
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.                                - 17 -
  1081. 7.0 Shareware Author Error Messages
  1082.  
  1083.      Shareware Author has four error messages.  The following delineates the
  1084. list:
  1085.  
  1086. 1) SA -F- Incorrect DOS Version
  1087.  
  1088.      DOS Version must be 3.0 or higher.
  1089.  
  1090. 2) SA -F- Illegal Video Mode
  1091.  
  1092.      Shareware Author will not execute if the initial video mode is for a 40
  1093. column setup.
  1094.  
  1095. 3) SA -F- Unknown Error
  1096.  
  1097.      This error message will be display if Shareware Author aborts when an
  1098. unknown error occurs.  These types of errors should be reported to the
  1099. author with the condition(s) that caused the error.
  1100.  
  1101. 4) SA -F- Program Has Been Corrupted
  1102.  
  1103.      This error will occur if Shareware Author detects one of its checksum
  1104. values is incorrect.
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.                                - 18 -
  1135. 8.0 List Of Bug Fixes
  1136.  
  1137. The following is the list of bug fixes from SA version 1.0 to 1.1:
  1138.  
  1139.      1) The up and down arrow keys have now been corrected to
  1140.         operate in the correct direction when in the user
  1141.         selection and expense selection.
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.                                - 19 -
  1189. 9.0 Whats New
  1190.  
  1191.      The following is the list of new features to Shareware Author 1.1:
  1192.  
  1193. 1) Authors can now find a specified user based on their defined
  1194.    criteria.
  1195.  
  1196. 2) Authors can now find a specified expense based on their defined
  1197.    criteria.
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.                                - 20 -
  1243. 10.0 Licensing
  1244.  
  1245.      *  A $17 shareware contribution is requested for using the
  1246.         program.
  1247.      *  The author retains the sole right to sell the program.
  1248.      *  The author grants users the right to copy and distribute
  1249.         the program within the following constraints:
  1250.         - All program files remain unaltered and are distributed
  1251.           together.
  1252.         - No attempt is made to sell the program, or to make
  1253.           money from it or any modified version of it.
  1254.         - The program is not bundled with any other hardware or
  1255.           software transactions without the author's permission.
  1256.         - Only the original "non-cloned" version of the program
  1257.         - Recognized user groups may charge a maximum $7
  1258.           duplication or distribution fee.
  1259.      *  Special modified versions of the program can be created by
  1260.         the author for different system configurations or desires.
  1261.         Contact the author for details.
  1262.      *  Continued use of the program (more than 3 weeks) by any
  1263.         individual, corporation or institution without a single
  1264.         user or site license is prohibited.
  1265.      *  Single user licenses are obtained by sending in the $17
  1266.         shareware contribution.
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.                                - 21 -
  1297. 11.0 Disclaimer
  1298.  
  1299.      The author disclaims all warranties expressed or implied as to the
  1300. quality or performance of this program.  The author will not be held liable
  1301. for any lost profits, lost savings or any other direct, indirect,
  1302. incidental or consequential damages resulting from the use of this program.
  1303. Your use of this program constitutes your agreement to this disclaimer and
  1304. your release of the author from any form of liability or litigation.
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.                                - 22 -
  1351. 12.0 Where Shareware Author Can Be Found
  1352.  
  1353.      The latest version of Shareware Author and other products developed by
  1354. this author can be found on the following BBS:
  1355.  
  1356.                        The Programmer's Corner
  1357.                           Columbia Maryland
  1358.  
  1359.                       301-596-7692 through 7697
  1360.                       301-995-6873 through 6877
  1361.                       301-621-3424   and   3436
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.                                - 23 -
  1405.                         Shareware Author (tm) Version 1.1
  1406.                               Copyright (c) 1992
  1407.                               All Rights Reserved
  1408.  
  1409.                               William Ned Miller
  1410.                               7504 Saffron Court
  1411.                                Hanover MD 21076
  1412.                                 (410) 766-2365
  1413.  
  1414.  
  1415.   Single User Registration Form
  1416.  
  1417.   Registration Provides:
  1418.  
  1419.   1) Notification of the next release of Shareware Author
  1420.      (Once Shareware Author has been registered the registration is good
  1421.       for all future releases of the program)
  1422.   2) Instructions on how to remove shareware request and insert the user
  1423.      registration number and name.
  1424.  
  1425.   To register your copy of Shareware Author please fill in the following
  1426.   information and send it along with $17 (US) to:
  1427.  
  1428.   William Ned Miller                     { Please only send }
  1429.   7504 Saffron Court                     { checks drawn on  }
  1430.   Hanover MD 21076                       { U.S. banks or    }
  1431.                                          { postal money     }
  1432.                                          { orders.          }
  1433.  
  1434.   Name: ____________________________________________________________
  1435.  
  1436.  
  1437.   Address: _________________________________________________________
  1438.  
  1439.   __________________________________________________________________
  1440.  
  1441.  
  1442.   Phone: (Optional) (     )______-__________________________________
  1443.  
  1444.  
  1445.   Where Did You Get Shareware Author _______________________________
  1446.  
  1447.   __________________________________________________________________
  1448.  
  1449.   Comments: ________________________________________________________
  1450.  
  1451.   __________________________________________________________________
  1452.  
  1453.   __________________________________________________________________
  1454.  
  1455.   __________________________________________________________________
  1456.