home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / wp4 / phlbl142.lzh / PHLBL.DOC next >
Text File  |  1990-06-27  |  46KB  |  1,279 lines
  1.  
  2.  
  3.                   PHLBL
  4.  
  5.  
  6.  
  7.                   ASCII Label Printer
  8.  
  9.  
  10.  
  11.                   Version  1.42
  12.                   Released 06-25-90
  13.  
  14.  
  15.  
  16.  
  17.                   Herron Software
  18.                   P.O. Box 1288
  19.                   Battle Ground, Washington  USA  98604
  20.  
  21.  
  22.  
  23.  
  24.          COPYRIGHT 1990 Phil Herron.  ALL RIGHTS RESERVED.
  25.  
  26.  
  27.                   DISCLAIMER OF WARRANTY
  28.          __________________________________________
  29.  
  30.  
  31.  
  32.          THIS PRODUCT IS PROVIDED FOR EVALUATION, AS IS
  33.          AND WITHOUT WARRANTY OF ANY KIND.  THE AUTHOR
  34.          MAKES NO EXPRESS OR IMPLIED WARRANTIES,
  35.          INCLUDING BUT NOT LIMITED TO MERCHANTABILITY
  36.          OR FITNESS FOR ANY PURPOSE.  IN NO EVENT SHALL
  37.          THE AUTHOR BE LIABLE FOR LOSS OF PROFIT OR ANY
  38.          OTHER COMMERCIAL DAMAGE ARISING FROM EITHER
  39.          THE USE OF OR THE INABILITY TO USE THIS PRODUCT.
  40.  
  41.  
  42.  
  43.          This product should be thoroughly evaluated
  44.          using backed up or noncritical data and files.
  45.  
  46.  
  47.  
  48.  
  49.    ______________________________________________________________
  50.  
  51.    Evaluation Preface                                     Section
  52.    ______________________________________________________________
  53.  
  54.    Shareware............................................... 0.1.0
  55.      What it is............................................ 0.1.1
  56.      License Terms......................................... 0.1.2
  57.      Registration.......................................... 0.1.3
  58.        Benefits, Forms, Fees, Quantity discounts
  59.  
  60.    Evaluation.............................................. 0.2.0
  61.      Evaluation Version.................................... 0.2.1
  62.      Evaluation Menu....................................... 0.2.2
  63.      Virus Prevention...................................... 0.2.3
  64.  
  65.  
  66.  
  67.    _____________________________
  68.  
  69.    0.1.0          Shareware
  70.    _____________________________
  71.  
  72.  
  73.  
  74.    0.1.1   The SHAREWARE Concept
  75.    _____________________________
  76.  
  77.    "Shareware" is a software distribution method which enables
  78.    the potential user to obtain software at very low initial
  79.    cost, for evaluation on a trial basis.
  80.  
  81.    You can evaluate the software in your own environment, on your
  82.    own machine, with the programs and data that you normally use.
  83.    You're not required to become a registered user unless the
  84.    software meets your needs.
  85.  
  86.    Another benefit of Shareware is lower pricing.  By minimizing
  87.    the marketing and advertising expenses associated with more
  88.    traditional software distribution methods, Shareware products
  89.    can be priced lower.  You don't pay for what you don't need or
  90.    use.
  91.  
  92.    You are encouraged to share the evaluation version of this
  93.    software with others, so long as you follow the limitations
  94.    set forth in the LICENSE TERMS section below.
  95.  
  96.  
  97.    0.1.2   LICENSE TERMS
  98.    _____________________
  99.  
  100.    This product and its documentation are copyrighted and owned
  101.    solely by the author, who reserves all rights to any benefits
  102.    derived from it.  It is distinctly separate from, and should
  103.    not be confused with, those categories of software known as
  104.    "public domain" or "freeware."
  105.  
  106.    You are granted the right to use the evaluation version of
  107.    this software on a trial basis for a limited amount of time,
  108.    to decide whether to continue using (and therefore whether
  109.    to register) the product.
  110.  
  111.    You can transmit this evaluation version to associates by
  112.    copying on diskette or uploading to electronic bulletin
  113.    board services, so long as the program, documentation
  114.    and any associated files are distributed together, and
  115.    not altered in any way.
  116.  
  117.  
  118.    0.1.3   REGISTRATION
  119.    ____________________
  120.  
  121.    When you send in the registration form and fee, you'll
  122.    receive by return mail a diskette containing the latest
  123.    REGISTERED version of the program and documentation.
  124.  
  125.  
  126.    BENEFITS OF REGISTRATION
  127.  
  128.      The registered version WILL NOT include the Evaluation Menu
  129.      front end, start-up time delay or forms printing sections of
  130.      this version.  Thus it will be more convenient to use, from
  131.      either the DOS prompt or from batch files.  It will also be
  132.      12K-15K bytes smaller, for more efficient disk storage and
  133.      faster loading.
  134.  
  135.      The registered version WILL include any new functions
  136.      or enhancements made to date.
  137.  
  138.      You will receive notification of future updates and
  139.      new products.
  140.  
  141.      You will be able to upgrade to newer versions at a
  142.      reduced cost.
  143.  
  144.  
  145.    REGISTRATION FORM
  146.  
  147.      The registration form and a pre-addressed mailing cover
  148.      can be printed from the "Forms Printing" selection of
  149.      the Evaluation menu, discussed in section 0.2.2 below.
  150.  
  151.  
  152.    FEES
  153.  
  154.      The single-quantity registration fee is displayed on the
  155.      initial Evaluation Menu screen.  Higher quantities are
  156.      discussed below.
  157.  
  158.  
  159.    QUANTITY DISCOUNTS
  160.  
  161.      Each registered copy of this software will be licensed for
  162.      operation at a single location (on a single terminal or
  163.      computer) at any one time.  If you need to run the software
  164.      on more than one terminal or computer at the same time, the
  165.      appropriate number of registrations must be made.
  166.  
  167.      Multiple-quantity registration fees are displayed in the
  168.      "QUANTITY DISCOUNT" section of the Evaluation menu.
  169.  
  170.      You can take advantage of quantity discounts by ordering
  171.      multiple registrations of one program or single
  172.      registrations of several different programs at the same
  173.      time.  You also save on shipping and handling charges
  174.      by registering several products together.
  175.  
  176.  
  177.  
  178.    _____________________________
  179.  
  180.    0.2.0          Evaluation
  181.    _____________________________
  182.  
  183.  
  184.  
  185.    0.2.1   EVALUATION VERSION
  186.    __________________________
  187.  
  188.    This software contains the complete and fully functional version
  189.    of the program, the latest available at the time of this release.
  190.  
  191.    The program itself is identical to the REGISTERED version.
  192.    An Evaluation Menu and forms printing section were added
  193.    to ensure that:
  194.  
  195.      (a)   Registration information and forms will not
  196.            become separated from the program file.
  197.  
  198.      (b)   Users who might be unfamiliar with the process
  199.            of displaying a file's contents on the screen or
  200.            printer will have no difficulty learning about,
  201.            evaluating or registering this product.
  202.  
  203.  
  204.    0.2.2   EVALUATION MENU
  205.    _______________________
  206.  
  207.    The program is invoked from the DOS prompt by typing its name
  208.    and pressing the RETURN or ENTER key.
  209.  
  210.    The initial screen displays the warranty section and some
  211.    information about the program:
  212.  
  213.      Program name,
  214.      Version number,
  215.      Release date,
  216.      Single-quantity registration fee.
  217.  
  218.    It next displays the Shareware Product EVALUATION MENU.
  219.    A single key press will select the following functions
  220.    from the menu:
  221.  
  222.      ESC - EXIT to DOS without evaluating this program
  223.       R  - READ the documentation (THIS file)
  224.       x  - EVALUATE this program
  225.       Q  - QUANTITY Discount information
  226.       F  - FORMS printing menu - registration & mailer
  227.  
  228.    When you press "R" to READ the documentation, this file will
  229.    be shown one screen at a time.  The display pauses whenever the
  230.    screen becomes full, and prompts...
  231.  
  232.                      <downArrow> or Esc
  233.  
  234.    The <downArrow> character is similar to the "MORE" prompt in
  235.    other DOS utilities.  It indicates that more is available.
  236.    Press ESCape to exit back to the Evaluation Menu, or any normal
  237.    typing key to continue (space bar is a convenient key to use).
  238.  
  239.  
  240.    0.2.3   VIRUS PREVENTION
  241.    ________________________
  242.  
  243.    If you'd like to evaluate this software but you're not sure
  244.    where it's been, you can order a copy straight from the source.
  245.    See the SHAREWARE PRODUCT CATALOG section at the end of this file.
  246.  
  247.  
  248.  
  249.  
  250.    _________________________________________________________________
  251.  
  252.    Table of Contents                                         Section
  253.    _________________________________________________________________
  254.  
  255.    PhLBL...................................................... 1.0
  256.       Introduction............................................ 1.1
  257.       Explanation............................................. 1.2
  258.       System Requirements..................................... 1.3
  259.          Installing........................................... 1.3.1
  260.       Help.................................................... 1.4
  261.       Syntax.................................................. 1.5
  262.          Wildcard Characters.................................. 1.5.1
  263.       File Selection Window................................... 1.6
  264.       Examples................................................ 1.7
  265.          Operating Screen..................................... 1.7.1
  266.       Data Storage Files...................................... 1.8
  267.       Printing................................................ 1.9
  268.          Printer Attributes................................... 1.9.1
  269.          Label Sizes...........................................1.9.2
  270.       Miscellaneous notes..................................... 2.4
  271.       Applications............................................ 2.5
  272.       DOS ErrorLevel.......................................... 2.8
  273.       Future Additions........................................ 2.9
  274.       Version History......................................... 3.0
  275.  
  276.    Support.................................................... 9.0
  277.       Problem Resolution...................................... 9.1
  278.       Before Reporting........................................ 9.2
  279.       Reporting a problem..................................... 9.3
  280.       Custom Modifications.................................... 9.4
  281.       Correspondence.......................................... 9.5
  282.  
  283.    Shareware Product Catalog................................. 10.0
  284.  
  285.  
  286.  
  287.  
  288.          **********************************************
  289.                   NEW in this version
  290.          **********************************************
  291.  
  292.          *** Wide printer attribute (8.5 cpi)
  293.  
  294.          *** "Pick" window for data file selection
  295.  
  296.          *** Printer number selection & assignment
  297.  
  298.  
  299.  
  300. _________________________________________________________________
  301.  
  302.                PHLBL
  303. 1.0
  304.                ASCII Label Printer
  305. _________________________________________________________________
  306.  
  307.  
  308.  
  309.  
  310.  
  311. 1.1   INTRODUCTION
  312. __________________
  313.  
  314.   When you need labels only occasionally, it would be nice to
  315.   get them quickly, with a minimum of bother and frustration.
  316.  
  317.   Label printers generally seem to come in two forms: too simple
  318.   to be useful, or too complex for occasional use without a
  319.   refresher course.
  320.  
  321.   This program began life as a "quick and easy" label printer.
  322.   It's still that, but has gained some features along the way.
  323.  
  324.   PHLBL was written to handle a relatively small number of labels.
  325.   If you have extensive mailing lists or need labels sorted by name
  326.   or zip code, you may need a dedicated mailing list manager.
  327.  
  328.   If you regularly need singles or multiples of only a few dozen
  329.   different labels, then PHLBL will probably meet your requirements.
  330.  
  331.  
  332.  
  333.  
  334. 1.2   EXPLANATION
  335. _________________
  336.  
  337.    PHLBL is simple because it only prints labels; it doesn't have
  338.    provisions for maintaining, sorting, or editing.  You do that using
  339.    a word processor or text editor that you already know, so there
  340.    won't be any strange new word processor commands to learn.
  341.  
  342.    PHLBL allows the use of different printer attributes for each line
  343.    of each label.  Line Attribute commands ("@Axxx...", discussed
  344.    later) are stored with the labels in a data file.
  345.  
  346.    Any editor that can write standard ASCII (American Standard Code
  347.    for Information Interchange) files can be used to add or edit
  348.    labels.  Although any such editor (even the DOS EDLIN utility) can
  349.    be used, there are some advantages to using one of the memory-
  350.    resident utility packages available as Shareware or otherwise.
  351.    A few of the available desktop accessory programs are:
  352.  
  353.        ALT                 HomeBase
  354.        Desk Commando       My-Desk
  355.        DeskMate            PC DeskTeam
  356.        DeskUtil            Right Hand Man
  357.        EZDesk              SideKick
  358.  
  359.    Using a memory-resident editor, you can edit or enter new labels
  360.    while PHLBL is running, then reload the data file with the "H"
  361.    or HOME key.
  362.  
  363.    With an editor having import capabilities, you can "cut" label text
  364.    from other applications or files and "paste" it into a data file.
  365.  
  366.    Another possibility is a standard text editor with jump (shell)-
  367.    to-DOS capability.  Such an editor can be used to create or edit
  368.    a data file, then you can shell to DOS to run PHLBL.
  369.  
  370.  
  371.  
  372.  
  373. 1.3   SYSTEM REQUIREMENTS
  374. _________________________
  375.  
  376.    PC, XT, AT or compatible.
  377.    DOS version 2.1 or later.
  378.    At least 128K of free RAM.
  379.  
  380.    An Epson-compatible dot-matrix printer is needed if
  381.    printer attributes are used; any printer will work
  382.    for plain labels.
  383.  
  384.    PHLBL was designed using an Epson FX-85 dot-matrix
  385.    printer with this default configuration at power-up:
  386.  
  387.       Default pitch ......... Draft Pica
  388.       Horizontal spacing .... 10 Chars per inch
  389.       Vertical spacing ......  6 Lines per inch
  390.  
  391.  
  392.  
  393.  
  394. 1.3.1   INSTALLING
  395. __________________
  396.  
  397.    The program can be run from diskette or from hard disk.
  398.    No installation is necessary, other than copying the
  399.    files to a drive and directory of your choosing.
  400.  
  401.  
  402.  
  403.  
  404. 1.4   HELP
  405. __________
  406.  
  407.    Can't remember the command line syntax?
  408.    Issue the program's name without any parameters; it will load the
  409.    default label data file PHLBL.LBL, or if not found, will display a
  410.    file selection window containing files and subdirectories available
  411.    from this point.
  412.  
  413.  
  414.  
  415.  
  416. 1.5   SYNTAX
  417. ____________
  418.  
  419.     PHLBL [filespec]
  420.  
  421.       If filespec is not entered, PHLBL will try to load the default
  422.       data file, PHLBL.LBL, if it exists in the current directory.
  423.       If not, it will display a file selection window.
  424.  
  425.  
  426.  
  427.  
  428. 1.5.1   WILDCARD CHARACTERS
  429. ___________________________
  430.  
  431.   Wildcard characters * and ? are legal for use in specifying
  432.   filenames and extensions.
  433.  
  434.  
  435.  
  436.  
  437. 1.6   FILE SELECTION WINDOW
  438. ___________________________
  439.  
  440.   A file selection or "pick" window is displayed:
  441.  
  442.     - Whenever the command line argument includes wildcard characters;
  443.  
  444.     - Whenever the main menu "NewFile" command prompt is answered by
  445.       pressing the <Return> key with no filespec, or when the filespec
  446.       entered includes wildcard characters.
  447.  
  448.   The window will display a sorted list of files and/or directory
  449.   names (500 maximum) that match the filespec entered.
  450.  
  451.   Selection is made by moving the reverse-video block to the desired
  452.   entry, then pressing the <Return> key.
  453.  
  454.   Directory names are displayed in higher intensity than files.
  455.   "..\" is the "parent" directory to the current one, so if you're in
  456.   C:\LA and select "..\", you will get a list of files in C:\, the
  457.   root directory.  By selecting directory names, you can get a file
  458.   list from anywhere on the current drive.
  459.  
  460.  
  461.  
  462.  
  463. 1.7   EXAMPLES
  464. ______________
  465.  
  466.   Valid command lines:
  467.  
  468.     PHLBL            - tries to load default file PHLBL.LBL
  469.  
  470.     PHLBL *.*        - file selection window of currrent dir.
  471.  
  472.     PHLBL A:*.*      - file selection window of A: root.
  473.  
  474.     PHLBL C:\LA\*.L* - file selection window of C:\LA, files *.L*
  475.  
  476.     PHLBL MyFile.Txt - tries to load MyFile.Txt; halts if not found.
  477.  
  478.  
  479.   Filespecs shown above are also valid from the main menu "NewFile"
  480.   command prompt.
  481.  
  482.  
  483.  
  484.  
  485. 1.7.1   OPERATING SCREEN
  486. ________________________
  487.  
  488.   The operating screen appears whenever "PHLBL" is issued from the DOS
  489.   prompt with a valid file specification; assuming that PHLBL.EXE and
  490.   default data file PHLBL.LBL are both located in subdirectory \LA,
  491.   and it is the current directory, no command line argument is needed:
  492.  
  493.            PhLbL
  494.  
  495.   loads PHLBL.LBL, and the screen displays:
  496.  
  497.  
  498.    1    __PhLbl_______________________
  499.    2   |                              |
  500.    3   |______________________________|
  501.    4   File: C:\LA\PHLBL.LBL
  502.    5   Lbl# 1    Margin 0    Lines/Skip 5/1    Attr bdddd
  503.    6   . This is a comment line
  504.    7   ┌─────────────────────────────────────────────────────────┐
  505.    8   Label 1, line 1
  506.    .   Label 1, line 2
  507.    .   ...
  508.    .   └─────────────────────────────────────────────────────────┘
  509.   25   F1-help   -next  Print  Margin  Home  Newfile  Ruler  Esc
  510.  
  511.  
  512.   Lines displayed:
  513.     1  - \
  514.     2  -  Program name/copyright block
  515.     3  - /
  516.  
  517.     4  - Filespec of current data file.
  518.  
  519.     5  - Label number in current data file.
  520.        - Margin setting:
  521.            May be embedded in the data file; can be changed from
  522.            the main menu at bottom of screen.
  523.        - Lines/Skip setting: defaults are 5/1.
  524.            Both can be embedded in data files;
  525.              Lines: height of label or other printing stock.
  526.              Skip:  lines between labels. Usually left at default.
  527.        - Printer Attributes assigned to this label:
  528.            One character for each line in the current label.
  529.            Default is D)raft; others may be embedded in the
  530.            data file using the "@Axxx..." command.
  531.  
  532.     6  - one-line comment (if any) attached to current label.
  533.  
  534.     7  - Label top border; can be switched to a ruler.
  535.     8  - One to fifteen lines display current label contents,
  536.     .    depending on label length and Lines setting (described
  537.     .    above). Label lines up to 160 characters can be handled,
  538.     .    although only the first 79 characters will be displayed on
  539.     .    screen.  Optimal line length depends on label width and
  540.     .    printer attribute selected; 160 characters will fit only on a
  541.     .    label at least 8 inches wide, using the S)mall (20 chars per
  542.     .    inch) attribute.
  543.     ?
  544.     ?+1  Label bottom border; can be switched to a ruler.
  545.  
  546.    25  - Bottom line on the screen is the main menu:
  547.  
  548.       Menu key                    Function
  549.       --------------------------  --------------------------
  550.       F1                          Help screens.
  551.       <DownArrow>, <PgDn>         Advance to next label.
  552.             or <Spacebar>
  553.       P)rint                      Printing sub-menu.
  554.       M)argin                     Enter new left Margin.
  555.       H)ome or <Home>             Reload; back to top of data file.
  556.       N)ewfile                    Load a different data file.
  557.       R)uler                      Toggle ruler on or off.
  558.       <Esc>                       Quit.
  559.  
  560.  
  561.  
  562.  
  563. 1.8   Data Storage Files
  564. ________________________
  565.  
  566.   PHLBL will work with any number of data storage files, so labels
  567.   can be split into as many files as you need to keep them
  568.   conveniently grouped.  Labels can be grouped by filename,
  569.   extension, subdirectory, and even by disk drive.
  570.   Some examples:
  571.  
  572.     Subdirectory \BIZ-INT      (Business, internal)
  573.     Label files   Inv.LBL      (product inventory labels)
  574.                   DiskLabl     (diskette labels)
  575.                   FileLabl     (file folder labels)
  576.                   RoloLabl     (rotary file cards)
  577.                   Govt.LBL     (taxing authorities)
  578.  
  579.     Subdirectory \BIZ-EXT      (Business, external)
  580.     Label files   Distr.LBL    (distributors of your product)
  581.                   Vendors.LBL  (suppliers to your business)
  582.                   Customer.LBL (customer list)
  583.                   MailList.1   (mailing list 1)
  584.                   MailList.2   (mailing list 2)
  585.  
  586.     Subdirectory \PERSONAL
  587.     Label files   Personal.LBL (personal contacts)
  588.                   Xmas.LBL     (Christmas card list)
  589.                   Tape         (audio, video cassette labels)
  590.  
  591.  
  592.   BASIC LABELS
  593.     Labels are stored in ASCII text files.  The most basic data file,
  594.     containing two labels:
  595.  
  596.       Label One, line 1
  597.  
  598.       Label Two, line 1
  599.  
  600.     At least one blank line must separate a label from its neighbors.
  601.     Any block of text without a blank line is considered one label.
  602.  
  603.  
  604.   COMMENT LINES
  605.     A comment line is any beginning with a period (".") in column 1,
  606.     and is ignored by the label printer.  Any number of comment lines
  607.     can be put in a data file.
  608.  
  609.     Only the first 79 characters of a comment line will be displayed
  610.     on screen.
  611.  
  612.     Comment lines separated from any label by a blank line are not
  613.     attached to any label, so are never seen on the label printer
  614.     screen.
  615.  
  616.     Comment lines without a blank line below them are attached to the
  617.     following label; the first (top) comment line in a block above a
  618.     label will be displayed on the screen with that label.
  619.  
  620.       .     This comment block is not attached to a label.
  621.       ..... It can be used for internal notes...
  622.  
  623.       .This comment will be displayed with Label One
  624.       Label One, line 1
  625.  
  626.       . This comment line will be displayed on screen
  627.       . This comment line will NOT be shown on screen
  628.       Label Two, line 1
  629.  
  630.  
  631.   BLANK LINES within LABELS
  632.     These are any that begin with a dash, "-" in column one, and have
  633.     no other characters.  They force a blank line within the label
  634.     when it is printed.
  635.  
  636.       Label One, line 1
  637.       -
  638.       Label One, line 3
  639.  
  640.  
  641.   PRINTER ATTRIBUTE LINE
  642.     A printer attribute command line begins with @A in column one,
  643.     and is used to change the default settings of the printer.
  644.  
  645.       Cmd  Attr      CPI       Printer Setup
  646.       ─── ───────── ─────── ────────────────────────
  647.        B   Bold      10      Pica + Emphasized
  648.        C   Compress  17.125  Compressed
  649.        D   Draft     10      Pica (power-on default)
  650.        E   Elite     12      Elite
  651.        H   Huge       5      Expanded + Emphasized
  652.        I   Italic    10      Italic + Emphasized
  653.        N   NLQ       10      Near Letter Quality
  654.        S   Small     20      Compressed + Elite
  655.        U   UnderLin  10      Underlined + Emphasized
  656.        W   Wide       8.5    Expanded + Compressed
  657.  
  658.     An attribute command line for a 5-line label will contain 5
  659.     letters from the table above (one for each line in the label).
  660.     Case is not significant.  The line can also contain spaces or tabs
  661.     to make groups of letters easier to read.
  662.  
  663.       @Aiiiii        Sets all five lines to ITALIC attribute.
  664.       @A I I I I I   Duplicate of above.
  665.  
  666.       @A bcdeh       Sets line 1 to BOLD attribute,
  667.                           line 2 to COMPRESSED,
  668.                           line 3 to DRAFT,
  669.                           line 4 to ELITE,
  670.                           line 5 to HUGE.
  671.  
  672.  
  673.   MARGIN SETTING
  674.     A margin setting line begins with @M in column one, and is used to
  675.     set the left margin to other than the default of zero.  Left
  676.     margins are set in 0.10 inch increments, and can range from 0 to
  677.     255.  Default is zero.  This example sets the left margin to 42
  678.     for all subsequent labels (or until another @M line is
  679.     encountered):
  680.  
  681.       @M42
  682.  
  683.  
  684.   LABEL HEIGHT SETTING
  685.     A label height setting line begins with @L in column one, and
  686.     sets the maximum number of lines in a label.  It can range from 1
  687.     to 15; default is 5 lines.  This example sets the number of lines
  688.     to 12:
  689.  
  690.       @L12
  691.  
  692.  
  693.   INTER-LABEL SKIP
  694.     A skip setting line begins with @S in column one, and sets the
  695.     number of lines to be skipped between labels.  It can range from 0
  696.     to 99; default is 1 line.
  697.  
  698.       @S3
  699.  
  700.  
  701.   Embedded DATE & TIME COMMANDS
  702.     An embedded date command !@DATE or time command !@TIME can be
  703.     placed in any column.  These cause the current system date or
  704.     time to be displayed on screen (and printed when the associated
  705.     label is printed).  Example:
  706.  
  707.       Label One, line 1 printed on date !@DATE, at time !@time.
  708.  
  709.  
  710.  
  711.   A complete list of commands and formats is available from within
  712.   PHLBL by pressing the F1 help key.
  713.  
  714.   For a label file containing examples of many of the above commands
  715.   and settings, see the default data file PHLBL.LBL.
  716.  
  717.  
  718.  
  719.  
  720. 1.9   PRINTING
  721. ______________
  722.  
  723.   Only the label currently displayed on screen can be printed.
  724.  
  725.   Press "P" to access the Printing sub-menu:
  726.  
  727.       Print single    Multiple    Other printer    Esc-exit
  728.       ____________    ________    _____________    ________
  729.  
  730.   P)rint single is a shortcut that allows fast printing of single
  731.     labels with a double press of the "P" key from the main menu.
  732.  
  733.   M)ultiple allows you to print from 1 to 999 duplicate labels.
  734.     If you change your mind here, enter 0.
  735.  
  736.   O)ther printer allows selecting printer 1, 2 or 3, if you have more
  737.     than one printer installed.  Default is printer number 1.
  738.  
  739.  
  740.  
  741.  
  742. 1.9.1   PRINTER ATTRIBUTES
  743. __________________________
  744.  
  745.   If you want only plain labels, you need never deal with attribute
  746.   commands.  Without them, all labels in a data file will use the
  747.   default "Draft" mode.
  748.  
  749.   If you decide to use attributes other than draft, they can be placed
  750.   permanently in your data files.  The format for the printer attribute
  751.   commands is
  752.  
  753.     @Axxx...  where up to 15 attributes can be assigned, one for each
  754.               line in the longest label.  Examples can be found in
  755.               PHLBL.LBL.
  756.  
  757.   Each attribute stays in effect until changed, so if all labels in a
  758.   given file will use the same set of attributes, only one command is
  759.   needed at the top of the file.  Alternately, each label can be given
  760.   different attributes by embedding a new attribute command above each
  761.   label.
  762.  
  763.   A complete list of attributes and associated pitches is available
  764.   within PHLBL by pressing the F1 help key.
  765.  
  766.  
  767.   KNOWN LIMITATIONS with OLDER PRINTERS
  768.  
  769.     Epson FX-85 (and possibly other models):
  770.       "Elite" mode is not available in IBM mode.
  771.  
  772.     Epson FX-80 and its wide version, the FX-100:
  773.       "Small" mode will not print at 20 characters per inch, since
  774.       these printers don't accept Compressed and Elite attributes at
  775.       the same time.  When sent a line with the attribute of "Small",
  776.       they print in Elite mode. To get the most compact printing, you
  777.       must use the Compressed attribute.
  778.  
  779.       "NLQ" mode prints in draft on these printers, since they don't
  780.       include Near-Letter-Quality capability from the factory.
  781.  
  782.  
  783.  
  784.  
  785. 1.9.2   LABEL SIZES
  786. ___________________
  787.  
  788.   Maximum line length for comment lines and label lines is 160
  789.   characters.  Only the first 79 chars in each line will be displayed
  790.   on screen, but up to 160 characters can be used for labels.
  791.  
  792.   When using a label line of 160 characters, you must also be using an
  793.   attribute of "S" ("Small" print) to get 160 characters into an 8
  794.   inch width on the printer (160 / 20CPI = 8.0 inches).  You must also
  795.   have the Left Margin set at zero, or the printer will wrap the text
  796.   around onto the following line.
  797.  
  798.   Label height in lines       : default is 5; maximum is 15.
  799.   Lines to skip between labels: default is 1; maximum is 15.
  800.  
  801.   If a data file does not include the "@Lnn" command to set label
  802.   height, or "@Snn" for lines to skip between labels, defaults are
  803.   used.  Default label height is 5 lines; default skip size is 1 line.
  804.   These dimensions cover common labels with height of 15/16 of an
  805.   inch; on a 6 line per inch printer, they work perfectly with five
  806.   lines of text and one skip line between labels.
  807.  
  808.  
  809.  
  810.  
  811. 2.4   MISCELLANEOUS NOTES
  812. _________________________
  813.  
  814.   The most efficient application of PHLBL is as a companion program to
  815.   a memory-resident pop-up notepad utility; the notepad can be used to
  816.   enter, edit, import and view labels.  When labels are setup as
  817.   required, switch back to PHLBL, press the "Home" key to reload the
  818.   modified data file, then advance to the desired label.
  819.  
  820.  
  821.   To gain familiarity with PHLBL...
  822.     Print the sample labels to see the available printing attributes.
  823.     Experiment with the Left Margin settings to find those useful with
  824.     your labels.  You can conserve label/card stock by printing on
  825.     standard printer paper during experimentation.
  826.  
  827.  
  828.   SPECIAL ITEMS in a data file...
  829.     Access Help Screens in the program with the "F1" function key.
  830.  
  831.  
  832.   To stop printing immediately: turn off the printer's power switch.
  833.  
  834.  
  835.   LEFT MARGIN
  836.     If a margin setting is needed for your standard label/card stock,
  837.     you should only have to set it once, with an embedded command near
  838.     the top of each data file.
  839.  
  840.     The menu "M" command can also be used to set the Left Margin to
  841.     another value.  This might be necessary when first setting up
  842.     data files, or when you need to print on nonstandard stock that
  843.     requires a different left margin.
  844.  
  845.     Another time the left margin might be changed manually is when
  846.     you're printing on label sheets that have more than one row of
  847.     labels.  Print the left-most row of labels with the standard
  848.     margin setting, then run the labels through the printer again,
  849.     this time using a greater margin setting to print the second row
  850.     of labels.
  851.  
  852.     A manually-set margin will remain in effect until you exit
  853.     the program or load a new data file.  To keep it permanently,
  854.     it must be entered into the data file.
  855.  
  856.     You generally won't need to have more than one Left Margin or
  857.     Lines/Skip setting in each data file.
  858.  
  859.  
  860.   CREATING a NEW LABEL DATA FILE:
  861.     Using your text editor, create a new file with an appropriate
  862.     name, then enter the label text (or cut and paste from another
  863.     application).
  864.  
  865.  
  866.   EDITING an EXISTING DATA FILE:
  867.     If you currently have the data file loaded into PHLBL, its full
  868.     filespec will be shown near the top of the screen.  Load that file
  869.     into your text editor.
  870.  
  871.  
  872.   VIEWING NEW labels or CHANGES to existing labels:
  873.     Save the editor file, then either run PHLBL and load that file, or
  874.     if the file is already running in PHLBL, reload it by pressing the
  875.     "H" key, or the keypad "Home" key.  Finally, scan down until you
  876.     find the label of interest.
  877.  
  878.  
  879.   DATA FILE LINE LENGTHS
  880.     PHLBL does no checking to see if text lines found in data files
  881.     will fit on the output form (labels, rotary file cards, etc.).
  882.     You must determine that by using the ruler (menu "R" command) and
  883.     the CPI (characters per inch) specification of the line attributes
  884.     you're currently using.
  885.  
  886.     EXAMPLE:
  887.       Finding the maximum line length for a particular application...
  888.       Given: CPI for default Draft mode   10
  889.              Label width                   3.5 inches
  890.              Left Margin setting           5
  891.  
  892.       At 10 CPI, the left margin setting shortens the label
  893.       printing area by 5/10 or one-half inch, to 3.0 inches.
  894.       3 inches multiplied by 10 chars per inch equals 30
  895.       characters that will fit on the remaining label width.
  896.  
  897.  
  898.   Label Height (LINES) SETTING
  899.     Before or immediately following an @L command, an @A command
  900.     should assign attributes for each line.  Otherwise, each line
  901.     will use the default "draft" attribute.
  902.  
  903.  
  904.  
  905.  
  906. 2.5   APPLICATIONS
  907. __________________
  908.  
  909.   PHLBL will find application in low-volume, high-variety uses, and
  910.   in high-volume uses such as inventory-handling, where many similar
  911.   or identical labels are needed.
  912.  
  913.   Possible output formats:
  914.  
  915.     Name tags
  916.     Index ("3x5") cards
  917.     Post cards
  918.     Rotary file and Rolodex(tm) cards
  919.     Diskette labels
  920.     Tape cassette labels
  921.     Inventory labels
  922.     Storage container labels
  923.     File folder labels
  924.     Mailing address labels
  925.     Warning labels
  926.     Library circulation cards, catalog cards, book labels
  927.     Report, binder and notebook cover labels
  928.     Address book entries
  929.  
  930.   Reusable labels:
  931.     Compose a letter using your standard text editor.
  932.     Pop up a memory-resident notepad utility,
  933.       load the appropriate label data file,
  934.       import the address from the letter.
  935.     Quit the text editor, run PHLBL, print label(s).
  936.  
  937.   One-shot labels:
  938.     For one-shot applications, you can avoid loading label stock in
  939.     the printer and just print directly on the envelope.  First you'll
  940.     need to experiment to find the margin setting that will shift the
  941.     address over the correct distance.
  942.  
  943.     Compose correspondence and save it to a disk file.
  944.     Run PHLBL and load the file as if it were a data file.
  945.     If the file has at least one blank line above and below the
  946.     inside address, PHLBL will display it as a standard label
  947.     (probably the second label; the date block will be the first).
  948.  
  949.     The only limitation here is that the label will be printed in
  950.     draft mode, since most correspondence doesn't contain any
  951.     "@Axxx..." attribute commands.
  952.  
  953.  
  954.  
  955.  
  956. 2.8   DOS ERRORLEVEL
  957. ____________________
  958.  
  959.   Upon termination, the program returns a DOS ErrorLevel value
  960.   which indicates how the program ended, and which can be used for
  961.   subsequent operations in a batch file.  For further information,
  962.   see the "IF ERRORLEVEL" batch command in your DOS manual.
  963.  
  964.    ErrorLevel List:
  965.  
  966.       0 - Successful
  967.       2 - Specified file not found
  968.       3 - Input parameter is out of range.
  969.       4 - Input parameter contains an illegal character.
  970.       5 - Missing parameters.
  971.      27 - ESCaped out of a file selection window.
  972.  
  973.  
  974.  
  975.  
  976. 2.9   FUTURE ADDITIONS
  977. ______________________
  978.  
  979.   Some future enhancements being explored:
  980.  
  981.     Alternate (European, ISO) date and time formats for the
  982.     "!@DATE" and "!@TIME" commands.
  983.  
  984.     !@SN     command for Serial/sequence numbering.
  985.     !@SERIES command for quantity numbering ("nn of nn").
  986.  
  987.  
  988.  
  989.  
  990. 3.0   VERSION HISTORY
  991. _____________________
  992.  
  993.   1.0  Initial release.
  994.   1.1  Added @Lnn command to handle larger labels, index and
  995.          rotary cards.
  996.   1.2  Added provision for selecting printer number.
  997.   1.3  Added a "pick" window for selecting data file.
  998.   1.4  Added Wide printer attribute (8.5 cpi).
  999.   1.42 Printer selection was not assigning correct printer.
  1000.  
  1001.  
  1002.  
  1003.  
  1004. _________________________________________________________________
  1005.  
  1006. 9.0            Support
  1007. _________________________________________________________________
  1008.  
  1009.  
  1010.  
  1011.  
  1012. 9.1   PROBLEM RESOLUTION
  1013. ________________________
  1014.  
  1015.    Please document and report any anomaly in program operation,
  1016.    whether it's a genuine "bug" or just some feature of the
  1017.    program that particularly "bugs" you.
  1018.  
  1019.    If you're the first person to document and report a problem
  1020.    that we agree needs attention, you'll receive a free upgrade
  1021.    with the correction when it's been made.  If you're a
  1022.    registered user, you'll get the upgraded registered version;
  1023.    if you haven't yet registered, you'll get the upgraded
  1024.    evaluation version.
  1025.  
  1026.  
  1027.  
  1028.  
  1029. 9.2   BEFORE REPORTING
  1030. ______________________
  1031.  
  1032.    Things to try prior to reporting a problem:
  1033.  
  1034.       1 - Reread the documentation to make sure you understand
  1035.           what we thought we understood when we wrote it.
  1036.  
  1037.       2 - If the system reports "Bad command or file name" when
  1038.           you attempt to run the program, its executable file
  1039.           (or at least the file name you specified) was not found.
  1040.  
  1041.           First, make sure no typos or misspellings have crept
  1042.           into your command line; next, try changing your PATH
  1043.           setting, or make the drive & directory where the program
  1044.           resides the "current" drive & directory.
  1045.  
  1046.       3 - If the program is being run from a batch file, try
  1047.           deleting lines previous to the line that actually
  1048.           invokes the program, to see if some prior activity
  1049.           is causing the problem.
  1050.  
  1051.       4 - If you have any memory-resident or "TSR" utilities
  1052.           installed (pop-up calculators/note pads, keyboard
  1053.           enhancements, etc.), try removing them from memory
  1054.           and running the program again to see if the problem
  1055.           reoccurs.
  1056.  
  1057.  
  1058.  
  1059.  
  1060. 9.3   REPORTING A PROBLEM
  1061. _________________________
  1062.  
  1063.    If the problem persists, please document it as completely and
  1064.    accurately as possible; we have to be able to duplicate it
  1065.    before we can begin to resolve it.
  1066.  
  1067.    Include at least the following:
  1068.  
  1069.       1 - Version of DOS you are using.
  1070.       2 - Machine type, drives, memory, etc.
  1071.       3 - Programs executed prior to the problem.
  1072.       4 - Problem program's name and version number.
  1073.       5 - Where and how you obtained the problem program.
  1074.       6 - Address and/or phone number where you can be contacted.
  1075.       7 - Anything you can think of that might relate to the problem;
  1076.           for example, listings of your AUTOEXEC.BAT and CONFIG.SYS
  1077.           files, or any batch files used to run the program.
  1078.       8 - Any relevant printouts.
  1079.  
  1080.  
  1081.    NOTE: If you're a registered user, you'll find the utility
  1082.          UserResp.Exe on the distribution diskette; it can be used
  1083.          to print a pre-addressed mailer and a problem report.
  1084.  
  1085.          If you have not yet registered, send problem reports to the
  1086.          address below (or print the pre-addressed mailer from the
  1087.          Evaluation Menu).
  1088.  
  1089.  
  1090.  
  1091.  
  1092. 9.4   CUSTOM MODIFICATIONS
  1093. __________________________
  1094.  
  1095.    If you need custom modifications to this software for your
  1096.    particular application, please write to the below address
  1097.    with complete details of your requirements.
  1098.  
  1099.  
  1100.  
  1101.  
  1102. 9.5   CORRESPONDENCE
  1103. ____________________
  1104.  
  1105.    We welcome any comments or suggestions you might have
  1106.    concerning improvements and future enhancements to this
  1107.    product.  Send all correspondence and orders to:
  1108.  
  1109.              Phil Herron
  1110.              P.O. Box 1288
  1111.              Battle Ground, Washington  USA  98604
  1112.  
  1113.  
  1114.  
  1115.  
  1116. _________________________________________________________________
  1117.  
  1118. 10.0           Shareware Product Catalog
  1119. _________________________________________________________________
  1120.  
  1121.  
  1122.   This section contains a list of our other Shareware products;
  1123.   it may be updated whenever products are added or changed.
  1124.           ____________________________________________
  1125.  
  1126.   If you'd like to try any of the programs in this catalog, but
  1127.   can't find them locally, you can order evaluation copies
  1128.   straight from the source...
  1129.  
  1130.   The basic fee of $4.00 covers the cost of the first disk, shipping
  1131.   and handling.  Each disk (5.25" DSDD 362kb) can hold up to five
  1132.   programs and associated documentation files.
  1133.  
  1134.   Add $2.00 for each additional disk of programs you want to evaluate
  1135.   (Example: $4.00 for 1 to 5 programs, $6.00 for 6-10, $8.00 for 11-
  1136.   15, etc.  All payments in U.S. funds).  Washington State residents
  1137.   please add 7.6% sales tax.  If your address is outside the U.S. and
  1138.   Canada, include an additional $6.00 shipping.
  1139.  
  1140.   Include your mailing address and the names of the programs you
  1141.   want to try.  By return mail you'll receive the latest versions
  1142.   for evaluation.
  1143.           ____________________________________________
  1144.  
  1145.   Or, you can download them from several online services...
  1146.  
  1147.     GENIE  - in the IBM PC Software Library (menu 616)
  1148.     DELPHI - in the GROUP/PC compat/ DATABASE/GEN area
  1149.  
  1150.     Once in the download areas, search for keyword HERRON.
  1151.           ____________________________________________
  1152.  
  1153.           PROGRAM SPECIFICATIONS AND REGISTRATION FEES
  1154.                    MAY CHANGE WITHOUT NOTICE.
  1155.           ____________________________________________
  1156.  
  1157. ChkD - Check_Disk_space reports disk drive space usage.  It reports
  1158.   drive cluster size, then drive space TOTAL, FREE and USED by actual
  1159.   value and by percentage.  Faster and more convenient than the DOS
  1160.   "dir" or "chkdsk" utilities for displaying drive information.
  1161.  
  1162. ChkM - Check_Memory_space reports standard system memory (RAM) space
  1163.   usage.  It reports memory space TOTAL, FREE and USED by actual value
  1164.   and by percentage.  Faster and more convenient than the DOS
  1165.   "chkdsk" utility for displaying system memory information.
  1166.  
  1167. CleanOut - Clean_Out_files searches all directories of the default
  1168.   drive for file(s) specified on command line (wildcards * and ? are
  1169.   legal).  Each time a matching file is found, the user is prompted
  1170.   for disposition: Delete or Save.  File contents, either text or
  1171.   binary, can be VIEWED before deciding.  A single press of the "S"
  1172.   key saves a file; a double press of the "D" key deletes it.  An
  1173.   optional mode allows deletions without confirmation.  Useful for
  1174.   cleaning out .BAK file leftovers, among others.
  1175.  
  1176. CleanTxt - Clean_Text converts WordStar text files to straight ASCII.
  1177.   It strips out certain control characters, and will optionally expand
  1178.   tab characters to the appropriate number of spaces.
  1179.  
  1180. CleanZ - Most text editors won't read files beyond the first control-Z
  1181.   end-of-file character.  Control-Z's can become embedded in a text
  1182.   file when several files are combined using the DOS "type" command.
  1183.   CleanZ will strip out each control-Z, or it will optionally replace
  1184.   each with a seldom-used character, to ease the task of locating the
  1185.   former boundaries in combined files.
  1186.  
  1187. DiskInit - Diskette_Initialize erases all files and subdirectories on
  1188.   a 5.25 inch 362k DSDD diskette in about two seconds. It does not
  1189.   initialize marked bad sectors, but tells you to reformat instead.
  1190.  
  1191. ErrLev - ErrLev is a utility for testing batch file "if errorlevel"
  1192.   statements.  During testing, executable program calls are commented
  1193.   out and replaced with "ErrLev nn", where nn is the DOS errorlevel to
  1194.   be simulated.  The simulated errorlevel then exercises branching
  1195.   commands in the batch file under test.
  1196.  
  1197. FindD - Find_Directory searches the default drive for specified
  1198.   subdirectory names, and lists the complete path to those found.
  1199.  
  1200. FindF - Find_File searches the default drive for specified files, and
  1201.   writes the file information to screen or disk.  Useful for locating
  1202.   misplaced files or for generating a listing of all files and
  1203.   subdirectories on the default drive.
  1204.  
  1205. FreqCh - Letter-frequency analysis of text or binary files; handles
  1206.   the full 256-character extended Ascii set; display is sorted in
  1207.   order of Ascii code or frequency of occurence.
  1208.  
  1209. Gen - Generate_file replaces several trial-and-error methods of
  1210.   building specific-sized files for printer, storage or timing tests.
  1211.   It generates files of any size from zero to twenty million bytes,
  1212.   much faster than typing random characters into a text editor.
  1213.   Besides generating files on disk, it can send characters directly to
  1214.   the console screen, printer or other DOS device.
  1215.  
  1216. KeyCode - KeyCode responds to each press of a key or combination of
  1217.   keys by displaying the key or combination pressed, its associated
  1218.   Ascii character (if any), key type (normal or extended), Ascii code
  1219.   and Scan code.
  1220.  
  1221. KeySet - KeySet's interactive mode displays the current settings of
  1222.   the CapsLock, NumLock, ScrollLock and PrtSc (Print Screen) keys, and
  1223.   allows them to be changed.  The command line mode directly sets the
  1224.   keys to specified states, allowing use of a batch file for
  1225.   presetting at system boot-up or between applications.
  1226.  
  1227. PhLBL - Ph_Label prints label text stored in easily-maintained ASCII
  1228.   files.  Each label/card/tag can contain embedded commands for date,
  1229.   time, left margin, and selectable printer attribute for each line;
  1230.   5, 8.5, 10, 12, 17 or 20 characters per inch pitch, normal/bold/
  1231.   underlined on Epson compatible dot-matrix printers.
  1232.  
  1233. PrinTest - PrinTest repetitively displays the status of ports assigned
  1234.   to parallel printer interfaces. It can be used to isolate problems
  1235.   to the printer interface card, the cable or the printer itself.  It
  1236.   reports printer and port number, status byte and status condition.
  1237.  
  1238. Qscr - QuickScreen converts a single text screen to an executable file
  1239.   for more rapid display.  The resulting .COM file will write a screen
  1240.   of text much faster than batch file ECHO statements.  Useful for
  1241.   setting up compact menu systems, demos and tutorials.
  1242.  
  1243. ScanF - Scan_File speeds up the search for ASCII text strings within
  1244.   executable files.  It filters out the unintelligible control and
  1245.   extended characters, allows user definition of minimum string length
  1246.   for display, and pauses after each screen of information.
  1247.  
  1248. ScanM - Scan_Memory speeds up the search for ASCII text such as ROM
  1249.   copyright statements and machine identification, anywhere within
  1250.   standard system memory space. It filters out the unintelligible
  1251.   control and extended characters, displays each string longer than
  1252.   three characters, and pauses after each screen of information.
  1253.  
  1254. Split - Split_file breaks huge text files down into smaller ones that
  1255.   will fit into your text editor or onto a diskette.  Useful for
  1256.   working on large files with a limited-filesize memory-resident
  1257.   notepad utility.
  1258.  
  1259. StoRm - STOrage_RooM reports the amount of disk space required for
  1260.   storage of a specified file or group of files on any disk, using any
  1261.   version of DOS.  It takes into account all of the factors involved
  1262.   in determining file storage size.  It locates files specified on the
  1263.   command line and determines their actual total size and the amount
  1264.   of room needed to store them.  Useful for determining the number of
  1265.   files that will fit on a disk.
  1266.  
  1267.           _____________ Future releases ______________
  1268.  
  1269. AcctSort - Fast entry of dollar amounts & assignment to
  1270.   user-designed charts of accounts; user-selected limit
  1271.   checking of $ and account numbers.
  1272.  
  1273. 1099 - Entry/editing/printing of 1099-MISC forms
  1274.  
  1275.  _______________________________________________________________
  1276. |                                                               |
  1277. |       COPYRIGHT 1990 Phil Herron.  ALL RIGHTS RESERVED        |
  1278. |_______________________________________________________________|
  1279.