Disk Labeller Pro Version 1.1 by Dave Touvell Documentation File January, 1988 GEnie Mail address: D.TOUVELL This is a public domain program. You may give copies of it away, and are encouraged to do so. Disk Labeller Pro runs on any Apple II capable of running ProDOS 8, with at least one disk drive, lowercase capability, and a dot matrix printer that will print Condensed Superscript (17 CPI, 1/2 height) characters. This program will read a ProDOS disk volume directory, then print a label consisting of the Volume name or Disk Title, Number of Free Blocks, and the Name, Type, and Size of the files in the volume directory. You can let Disk Labeller Pro print all of the files on the disk, or you can choose to be shown the catalog entry for each file, and asked whether you wish to include it on the label. Several printers are supported, and may be selected from the "Select Printer" menu. The program may be configured for other printers capable of printing compressed superscript text that are not listed through the "Custom Printer" option. You may print on standard 3-1/2 X 15/16 inch or 4 X 1-7/16 inch labels. Disk Labeller Pro is menu driven for ease of use. The menu selection pointer may be moved with the Left/Right arrow keys, the Up/Down arrow keys, or by pressing a number key. When the pointer is on the option that you wish to choose, press the RETURN key. At most places in the program where you are asked to press a key to continue, or at any menu, you can return to the previous menu by pressing the ESC key. If Disk Labeller Pro can't find the file DLP.SETUP when it is run, you will automatically be shown the Setup Menu. Select the first item on this menu, "See Current Setup", to see how the program is configured. Press a key to return to the Setup Menu. Move the menu pointer to the next option, "Select Drive", and press the RETURN key. You will then be asked for the slot and drive number of the disk drive in which the disks to be labelled will be. Press RETURN if you want to leave them as the numbers displayed. You will then be returned to the "Setup" menu. Choose the next option, "Set Printer Slot", and enter the slot number that your printer is in, or press RETURN for no change from the slot displayed. You will again be at the "Setup" menu. The next option is "Printer Interface Setup". Choose this option and the current interface setup string will be displayed in its decimal ASCII form. When the program is run for the first time this string will be "009 054 053 078". This is the decimal ASCII representation of "65N", the string needed by the Apple Parallel (and most other parallel) interface card. Press RETURN to leave it as it is, or enter a new setup string in the same form that will set the interface card to allow a 65 character line. The leading zeroes are not necessary, but each value should be separated by a space. After you enter this string you will again be at the "Setup" menu. Next, select the "Choose Printer" option, and you will see the "Choose Printer" menu. If your printer type is listed in this menu, just move the pointer to that line and press RETURN. The correct values for your printer will be installed and you will be returned to the "Setup" menu. If your printer is not listed here, and is capable of Condensed Superscript print mode (17 characters per inch, half height), you can configure Disk Labeller Pro for it by choosing the "Custom Printer" option. You will then be asked for the printer command codes needed to implement various print functions. Consult your printer manual for the codes needed to implement each function, then enter each set of codes as a series of DECIMAL numbers; one decimal number per ASCII character in the command set. Separate each number by a space. For example, to set Superscript mode on an Epson RX-80 printer the code set is:"S0". This would be entered as: 27 83 48. (The Decimal ASCII code for ESC is 27, for S is 83, and for 0 is 48.) If Disk Labeller Pro has been configured before, the current values of each code will be shown. You may press RETURN alone to keep the values shown. You must enter a value for each function or Disk Labeller Pro will not work properly. When you are done, you will be asked to press RETURN if the values are correct, or to press ESC to re-enter the values if you made a mistake. If you press RETURN you will be returned to the "Setup" menu. Next, select "Other Options" and you will be presented with a menu that lets you select the label size, turn the key click on or off, and specify whether or not to print the number of free blocks on the label. Change the ones you want, then press ESC or select "Return to Setup Menu". You are now finished installing Disk Labeller Pro. Select the "Return to Main Menu" option or press ESC. The disk drive will come on as Disk Labeller Pro saves the configuration in a VAR file named "DLP.SETUP", and you will be at the "Main Menu". You are now ready to label disks. Select "Label Disks" from the Main Menu, and you will be shown the "Label Disks" menu. Here you have the option of having all of the files in the disk catalog on the printed label, or being shown the entry for each file and asked whether or not to include it on the label. If you choose to print all the files, you will be prompted to put the disk to be labelled into the drive that you selected during configuration and press a key. The volume name and number of files on the disk will be displayed. If there are more files on the disk than will fit on the label you will be returned to the "Label Disks" menu and prompted to use the "Select Files" option. Otherwise, you will shown the volume name and asked to enter a title for the top line of the label. Just press RETURN if you want to leave it as the volume shown. You will then be asked to enter the number of copies of this label that you want to print. Make sure that the printer is ready and then enter a number from 1 to 9, or enter 0 or ESC to abort the printing and return to the "Print Labels" menu. If you choose the "Select Files to Print" option you will be shown the catalog entry for each file and asked if this file is to be included on the label. You can press Y for yes, or N for no; or you may press ESC to abort and return to the "Label Disks" menu, or press RETURN to stop selecting files and print the label. The Volume name and the number of files selected so far are shown above the file entry. When all files have been displayed or you have selected the maximum number of files that will fit on the label, you will be asked for the disk title and number of copies, as explained above. After the label has been printed you will be returned to the "Label Disks" menu. You may then label another disk or return to the Main menu. The "See Documentation" option on the Main menu displays this file. Select whether you want it displayed to the screen or printed out on the printer in the slot that Disk Labeller Pro is configured for. Make sure that the file DLP.DOC is available in the same prefix as the program was run from, or you will get an error. After the screen is full, you will be prompted to press any key for the next screenful, or you may press the ESC key to return to the Main Menu. The "Catalog a Disk" option shows the directory of the disk in the current drive. If you select the Quit to BASIC option from the Main Menu, you will be asked to verify that you wish to do this. If you answer Y then you will be in BASIC. Any other key will return you to the Main Menu. If you have any problems, suggestions, or comments, please leave E-Mail to me on GEnie, GE-mail address "D.TOUVELL". I am particularly interested in hearing of any problems with printers, and of the printer codes needed to make other printers work, so that I can include more ready-made printer setups in the next version, and of suggested improvements to the program.