home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 1347.dms / in.adf / LabelPrint / English_Doc / Documentation < prev    next >
Encoding:
Text File  |  1990-02-23  |  14.1 KB  |  305 lines
  1.                      Documentation of LabelPrint
  2.                      ---------------------------
  3.  
  4.  
  5.               LabelPrint v1.9 (c) 2/1989 by Andreas Krebs
  6.  
  7. Following files and drawers are parts of the LabelPrint package and have
  8. to be also copied, when you copy LabelPrint.
  9.  
  10.   -LabelPrint          (The program itself)
  11.   -LabelPrintE         (The program for the EPSON LQ-850 and compatible
  12.                         printers)
  13.   -LabelPrint.info     (1. icon for LabelPrint: large version)
  14.   -LabelPrintE.info    (2. icon for LabelPrint: small version)
  15.  
  16.   -Deutsche_Anleitung  (Drawer with the German Documentation)
  17.   -English_Doc         (Drawer with the English Documentation)
  18.  
  19. The program LabelPrint was written to allow you easily to print Labels for
  20. your disks. For that you have a great variety of options you can use
  21. to make your Labels.
  22. I wrote the program, because I was fed up with writing my Labels by hand.
  23. And so I decided to write a program making this task almost alone.
  24.  
  25. Choise of LabelPrint version:
  26.   You have two versions of LabelPrint: LabelPrint and LabelPrintE
  27.   This two versions are totally the same except the printing routine.
  28.   LabelPrint uses the PCPrtCommand-command of the printer.device to send
  29.   a command to the printer, and is so working with each printer.
  30.   This printing routine has the effekt, that when you print the first
  31.   time with it a number of idiotic things is printed. But all further
  32.   prints will be correct. (If someone knows the reason for this and how
  33.   to solve this problem, I would be pleased if he writes it to me.)
  34.   LabelPrintE hasen't got this bug, because its printing routine uses
  35.   the RawWrite-command. But for this it works only correct with an
  36.   EPSON LQ-850 or a compatible printer.
  37.   The source-code of the program can be ordered by me (look README_first)
  38.   and so you can make the program to work correct with your own printer.
  39.   For compiling you need an C-compiler (I use the Aztec-C compiler v3.6a
  40.   from Manx, but I don't know if it is also compilable with another
  41.   compiler)
  42.  
  43. How to start LabelPrint:
  44.   You can start LabelPrint as well from the CLI as from the Workbench by
  45.   a double click on the icon. I've made two icons for LabelPrint, because
  46.   the first one is a very large and needs a lot of memory on your disk.
  47.   Therefore you can also use the second icon, when installing LabelPrint
  48.   on your own disk. The second icon is about ten times smaller than the
  49.   first, so you can save a lot of memory on your disk.
  50.  
  51. The menu-functions of LabelPrint:
  52.   Afer starting LabelPrint there appears a information-window, that you
  53.   can close by a click on the OK-gadget. Afterwards you see the main-
  54.   window of LabelPrint, in its menu bar you see this menues:
  55.      (c), Spezial, Print, Clear, Input, Block
  56.  
  57.   (c):
  58.   This menu has no use, it only contains the Copyright-notice.
  59.  
  60.   Spezial:
  61.   -About: This menu item opens the information-window.
  62.   -Prefs: This memu item opens the preferences-window. (explained later)
  63.   -Quit: With this menu item you can leave the program, but before you
  64.          are asked, if you really want to quit it.
  65.  
  66.   Print:
  67.   -Search: If this function is activ, the entries are sorted in
  68.            alphabetical order, before they are printed. This function
  69.            is activated or deactivated by picking the ON or OFF item.
  70.   -First: With this function you can determine, if the files or dirs
  71.           should be printed first. When no type is selected, the entries
  72.           are printed in alphabetical order without considering their
  73.           type.
  74.   -Dirstyle / Filestyle: With this two items you can determine how the
  75.           dirs / files are written.
  76.           If capital is activated, then all entries of the selected type
  77.           are written in capital letters. The small item effects, that
  78.           all entries of the selected type are written in small letters.
  79.           Mixed allows as well small letters as capital letter.
  80.  
  81.   Clear:
  82.   -All: This function clears all entries. Before clearing them the program
  83.         asks you, if you really want to clear them.
  84.   -Files: This function clears all entries, that are of the file type.
  85.           Before clearing them the program asks you.
  86.   -Dirs: This function clears all entries, that are of the dir type. Before
  87.          clearing them the program asks you.
  88.   -Type: With this function you can determine of which type the cleared
  89.          entries should be.
  90.  
  91.   Input:
  92.   -ReadIn: With this function you can determine types LabelPrint should
  93.            read in.
  94.            e.g.: Is only dirs activated, then only dirs are read in.
  95.            At least one type should be activated, because otherwise nothing
  96.            is read in.
  97.   -Sort: This function determines in which way the entries are sorted.
  98.          If UP is selected, the entries are sort in alphabetical order.
  99.          If DOWN is selected, the entries are sort against alphabetical
  100.          order.
  101.  
  102.   Block:
  103.   -Last: This function shows the last block (4). As LabelPrint is only able
  104.          to show 30 entries at onces on the screen, I've created for
  105.          blocks, so that you can control 120 entries.
  106.   -First: This function shows the first block (1).
  107.   -"+": This function shows the next block.
  108.   -"-": This function shows the block before.
  109.  
  110. The gadget-functions of LabelPrint:
  111.   On the LabelPrint-window you can see a lot of different gadgets. The
  112.   following section of the documentation explains their functions.
  113.  
  114.   -Close-gadget: This gadget is placed in the left part of the top border.
  115.     This gadget ends the programm. (same function as Quit in the Spezial-
  116.     menu)
  117.  
  118.   -DiskName-gadget: This string gadget shows the name of the actual drawer.
  119.     In this gadget you can put in the name of a drawer or volume to read
  120.     in.
  121.  
  122.   -Drive-gadgets: This 6 gadgets are placed in the right bottom of the
  123.     LabelPrint-window. They contain the names of different volumes, that
  124.     are read in by click on the gadget. Attention, this will clear all
  125.     entries.
  126.  
  127.   -About-gadget: This gadget is placed in the right top of the window.
  128.     It will open the information-window. (same function as About of the
  129.     Spezial-menu)
  130.  
  131.   -Prefs-gadget: This gadget is placed right of the About-gadget and has
  132.     the function to open the Preferences-window. (same function as Prefs
  133.     of the Spezial-menu)
  134.  
  135.   -Entry-gadgets: This are 30 long gadgets in the middle of the window.
  136.     Each of this gadgets contains one entry, which you can change the way
  137.     you like it. The length of each entry is limited to 17 characters.
  138.     The maximum number of entries is 120 in 4 blocks.
  139.  
  140.   -EntryType-gadgets: Behind each Entry-gadget you see a small gadget with
  141.     a D or F in it. This 30 gadgets are the EntryType-gadgets, with this
  142.     gadgets you can change the type of each entry.
  143.     When clicking on one of the gadgets, there alternately appears a D or
  144.     F. D stands for directory, whereas F stands for file, so that you can
  145.     easily change or create a entry type.
  146.     The type of the empty Enrty-gadgets is determined by the Type-item of
  147.     the Clear-menu.
  148.  
  149.   -"+"- / "-"-gadget: This two gadgets are placed in the left bottom of the
  150.     window. They have the function to increase / decrease the block number.
  151.     (same function as "+" / "-" in the Block-menu)
  152.  
  153.   -No.-gadget: This gadgets is placed right of the "-"-gadget and shows the
  154.     number of the active block (shown on the window). By typing in a number
  155.     between 1 and 4 you can change the active block.
  156.  
  157.   -"Kill Entries"-gadget: This gadget makes it possible to kill easily one
  158.     spezial entry, such as .info-files. When clicking on the OFF-text, a
  159.     ON-text appear showing that the Kill-mode is active. When this mode
  160.     is active you can kill an entry by a click on its EnrtyType-gadget.
  161.     Make sure that you turn off this mode after use, or you could kill an
  162.     entry when you try to change its type.
  163.  
  164.   -Print-gadget: This gadget starts the printing of your labels. To print
  165.     them the program uses the parameters, that are defined in the
  166.     Preferences-window. (see below)
  167.  
  168.   -Sort-gadget: This gadget has the function to sort all entries in
  169.     alphabetical order. The way in that it sorts is defined in the Sort-
  170.     item of the Input-menu.
  171.  
  172.   -Clear-gadget: This gadget has the function to clear all entries, after
  173.     asking you, if you really want it. (same function as All of the
  174.     Clear-menu)
  175.  
  176.   -"Append to"-gadget: This gadget contains the name of the file to that
  177.     the actual enties are appended in the ASCII-format.
  178.  
  179.   -Append-gadget: This gadget appends the actual entries to the file named
  180.     in the "Append to"-gadget. If the file doesn't exist, the program will
  181.     create it. This function was made to create huge lists of the files on
  182.     a disk by appending the entries several times to the same file.
  183.  
  184.   -"Read In"-gadget: This gadgets reads in the drawer named in the
  185.     DiskName-gadget. Before reading in a volume you have to add a double
  186.     point.
  187.  
  188. The Preferences-window:
  189.   This window appears when you click on the Prefs-gadgets or select Prefs
  190.   from the Spezial-menu. This window has a similar function as the
  191.   preferences-window of the workbench. It has the function to define the
  192.   parameters for the printing of your labels.
  193.  
  194.   The Preferences-gadgets:
  195.   (from the left top of the window to the right bottom)
  196.  
  197.   -Columns-gadget: With this gadget you can define the number of columns
  198.     used for printing the entries. The number has to be between 1 and 6.
  199.  
  200.   -"Left / Right Margin"-gadget: With this two gadgets you can define the
  201.     left/right margin of your printing area. But when changing the numbers
  202.     you must consider that each printing column is 20 characters wide.
  203.     Be careful and don't make the distance to small, except you really
  204.     need it.
  205.  
  206.   -"LINE FEED"-gadget: This gadget defines the number of free lines before
  207.     starting the print. (This functions is very useful when you are
  208.     printing labels for 3.5"-disks.)
  209.  
  210.   -"Lines to print"-gadget: This gadget defines the minimum of lines to
  211.     print. The "LINE FEED"-lines and the line for the disk name are not
  212.     counted. (This function is of importance, when you use continuous
  213.     labels to make sure that the printer stops printing at the beginning
  214.     of the next label)
  215.  
  216.   -PrintStyle-gadgets: This two gadgets define the way in that directories
  217.     and files are printed. You can choose between 4 possibilities:
  218.     Normal:  no spezial printing effects
  219.     Italic:  print italic
  220.     Bold:    print bold
  221.     Ita+Bo:  print italic and bold
  222.  
  223.   -"Defines Name"-gadget: This gadgets contains the name of the file
  224.     used for saving your own defined values.
  225.  
  226.   -Quality-gadget: This gadget defines the printing quality. You can choose 
  227.     between Draft and Letter quality.
  228.     
  229.   -Spacing-gadget: This gadget defines the line spacing. You can choose   
  230.     between 6 LPI (1/6" line spacing) and 8 LPI (1/8" line spacing).
  231.     
  232.   -Pitch-gadget: This gadget defines the size of the characters. There
  233.     3 sizes you can choose:
  234.     15-Fine:  In this size 15 characters were printed per inch (15 CPI).
  235.     12-Elite: In this size 12 characters were printed per inch (12 CPI).
  236.     10-Pica:  In this size 10 characters were printed per inch (10 CPI).
  237.     
  238.   -"Form Feed"-gadget: When this function is activated, LabelPrint makes
  239.     after each printing a form feed. This function is very usefull when
  240.     you are using a cut sheet feeder to make sure that each printing starts  
  241.     with a new label. When this function is activated, LabelPrint neglects
  242.     the "Lines to print"-function.
  243.     
  244.   -Doublestrike-gadget: When this function is active, each line is printed
  245.     twice. This makes it look better, but it slows down the printer.
  246.     
  247.   -Defines-gadgets: With this gadgets you can activate predefined values
  248.     for 3.5"- or 5.25"disks. At the beginning the defines for 3.5"-disks are
  249.     active. The 3.5"-disk values are for normal continuous labels.
  250.     The 5.25"-disk values are not for the normal 5.25"-disk labels, because
  251.     I think they are to small for printing all contents of a disk on them.
  252.     So I decided to use greater labels, that use the whole breadth of the
  253.     disks. But I couldn't buy them as continuous labels so use a cut sheet
  254.     feeder for printing on them.
  255.     
  256.   -OK-gadget: With this gadget you can close the Preferences-window, at which
  257.     LabelPrint uses the new defined values for printing.
  258.  
  259.   -Cancel-gadget: With this gadget you can close the Preferences-window, at
  260.     which LabelPrint neglects the new defined values and still uses the old
  261.     ones.
  262.  
  263.   The Preferences-menus:
  264.  
  265.   Defines: With this menu you can control your own defines.
  266.   -Save: This function saves your values using the name shown in the
  267.     "Define Name"-gadget as file name.
  268.   -Load: With function you can load your saved values. As file name
  269.     LabelPrint uses the name shown in the "Defines Name"-gadget.
  270.   -Use: This function allows you to activate one out of four defines by
  271.     selecting it.
  272.   -Set: This function allows you to set four defines, that you can recall
  273.     afterwards by using the Use-item.
  274.     To set a define you only have to select one of the four defines. It
  275.     automatical will save all values in the Preferences-window to its
  276.     buffer.
  277.     
  278.   Title-Style: With this menu you can define how the disk name should be  
  279.                printed.
  280.   -Underlined: When this function is active, the disk name is printed 
  281.      underlined.
  282.   -Normal: This function deactivates the three following functions (Italic,
  283.      Bold, Enlarged). It has no effect on the Underlined-function.
  284.   -Italic: When this function is active, the disk name is printed italic.
  285.   -Bold: When this function is active, the disk name is printed bold.
  286.   -Enlarged: When this function is active, the disk name is printed enlarged.
  287.  
  288.  
  289. I hope LabelPrint will help you to print your labels faster and better,
  290. and don't forget to send me $10 US or 20 DM, when you decide to use it.
  291. (read README-first)
  292. If you have comments or bug reports please send them also to me.
  293. (Please add a detailed description of it)
  294.  
  295. Send your comments or bug reports also to 
  296.  
  297.   Andreas Krebs
  298.   Mittelweg 9
  299.   7110 Öhringen 2
  300.   FRG
  301.   
  302. (PS.: Sorry, my English is not the best, but I hope you understood it.
  303.       If not, feel free to write a better documentation and add it to the
  304.       program.)
  305.