@database CassLabel.guide ## To have a look at this document, you should have installed AmigaGuide @width 72 @node Main "CassLabel Help" CassLabel Version 1.2 (20-Oct-93) (c) Copyright 1993 by Dirk Nehring - FreeWare - @{" About MUI " link MUI} @{" Overview " link Overview} @{" Starting CassLabel " link Start} @{" Keystrokes " link Keystrokes} @{" Menus " link Menus} @{" Problems " link Problems} @{" Technical Information " link TechInfo} @{" Credits " link Credits} @endnode @node MUI "CassLabel/MUI" This application uses MUI - MagicUserInterface (c) Copyright 1993 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXX.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 20.- or US$ 15.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY @endnode @node Overview "CassLabel/Overview" @{" Author " link Author} @{" Copyright " link Copyright} @{" Disclaimer " link Disclaimer} @{" History " link History} @{" Features " link Features} @{" TODO " link TODO} @endnode @node Author "CassLabel/Overview/Author" CassLabel was written by Dirk Nehring Hörster Bruch 57 D-32791 Lage GERMANY e-mail: dnehring@TechFak.Uni-Bielefeld.DE Bug reports, criticism, suggestions, comments etc. are always welcome (in English or German). @endnode @node Copyright "CassLabel/Overview/Copyright" The program CassLabel is copyrighted © 1993 by the author. All rights reserved worldwide. CassLabel is FREEWARE. This program may be freely distributed as long as all executables and documentation remain unchanged and are included in the distribution. You can use this program without paying a fee to the author. CassLabel may be freely distributed as long as no more than a nominal fee is charged to cover time and copying costs. This fee MUST NOT be more than US $5. @endnode @node Disclaimer "CassLabel/Overview/Disclaimer" The author cannot be held liable for the suitability or accuracy of this software and/or this manual. Any damage directly or indirectly caused by the use of this software is the sole responsibility of the user. @endnode @node History "CassLabel/Overview/History (* = New)" Version 1.0 (21.09.93) - First official release Version 1.1 (04.10.93) * Now CassLabel uses its own Icon as Diskobject when iconified - Improved GUI (the window was too big) - File format changed (Sorry ;-( ) - Better ARexx-Script * Included tape type and tape length * Disabled Checking - From now on no back text - LaTeX output: back side changed (tape type and tape length) * New ISO-Latin 1 to LaTeX Source-Converter * Error text when CassLabel can't open the Main Window * New LaTex output formats * LaTeX output: if you have not enough songs, the second page will not be printed - Catalogs changed - Divide source in some parts Version 1.2 (20.10.93) - Action buttons moved into the Window Menu (=> smaller Window) - 'rexx/Start_LateX.rexx' changed (now handles PasTeX and AmigaTeX correctly) * Now handles as * Listview-Stringgadgets are now disabled at Startup * Online Help can be invoked by pressing * ARexx-Script will now be called with System() instead of Execute() @endnode @node Features "CassLabel/Overview/Features" CassLabel is an Editor for Audio Cassette labels. The main features are: - MUI Interface :-). You need the MUI-distribution to run this program - Needs Kickstart 2.1 (V38+ of asl.library, locale.library) - Needs ARexx (comes with 2.0+) to call LaTeX - Needs TeX (AmigaTeX, PasTeX) for high quality Output - Supports Localisation (until now only Englisch and German) - Supports an ASCII and some LaTex Outputs - Compiles directly a LateX file using ARexx - Flexible GUI with keyboard support (Thanks to Stefan Stuntz, the author of MUI) - Online Help with one keystroke @endnode @node TODO "CassLabel/Overview/TODO" Unfortunately, I have something to do on CassLabel. I think the new features will be in the next release. - More Languages (If I find anyone to translate ;-) - Converting Program for other Cassette Cover Programs - Some Problems in the GUI (I think this are problems of MUI 1.3) @endnode @node Keystrokes "CassLabel/Keystrokes" Use the 'TAB' or 'RETURN' Key to jump to the next gadget. On the right border you see some gadgets with a underlined letter. Press this letter to activate the button. You can clear string gadget by pressing or , jump to the left/right with /. Look into the Commodore and MUI documentations for closer explanations. @endnode @node Start "CassLabel/Starting CassLabel" You should start CassLabel from Workbench. You can always start it from any shell, but you should be in the right directory (all path settings are relative, not absolute!). Do the following things: 1. "Stack 10000" (when starting in a shell) 2. "Assign C: DH0:rexxc add" (for "rx") 3. "latex -R" in a shell and "preview" (AmigaTeX) or set the env-Variables for your LaTeX macro packet (PasTeX) 4. Start CassLabel @endnode @node MainWindow "CassLabel/Main Window" Here you see the GUI (Graphical User Interface). The left listview is for the first side of your Cassette, the right listview shows you the entries of the second side. You can currently put in 30 entries on each side. Take a look to the @{" Problems " link Problems} which you will have with this GUI. Here you can always choose the Cassette Position, the Cassette Number and the Cassette Length. If you are very confused, you can press 'HELP' for Online Help. @endnode @node Print "CassLabel/Printing LaTeX output" Before printing a LaTeX Output with AmigaTeX, please start the compiler and previewer in the background. CassLabel doesn't do this automatically. If you use PasTeX, you have to do nothing. If you want to print your Cassette Cover in LaTeX format, the LaTeX compiler will be invoked automatically by executing the ARexx-Scipt "rexx/Start_LaTeX.rexx". Change this file for your need (i.e you want to print your file immediately on the printer). CassLabel *DOES NOT* handle your Command Path (the directories, which you have set with the AmigaDos Command 'Path'). Try instead "Assign"! Example for you Startup-Sequence: "Assign C: DH0:rexxc add" CassLabel supports 3 LaTeX outputs: - Standard: Date on the same page as the songs - Enhanced: Date on the back side - Rotated: Cover is rotated by 180 degrees, the other things like the 'Enhanced' format If you don't enter the Side B group and title, the Side A group and title will be center on the cover. If there are not enough entries, the second page of the cover won't be printed. @endnode @node Menus "CassLabel/Menus" Project Menu: @{" New " link MENU_New} @{" Load " link MENU_Load} @{" Save " link MENU_Save} @{" Print " link MENU_Print} @{" Create " link MENU_Create} @{" About... " link MENU_About} @{" Quit " link MENU_Quit} @endnode @node MENU_New "CassLabel/Menus/New" Clears all entries. @endnode @node MENU_Load "CassLabel/Menus/Load" Here you can load a previous saved cassette cover. @endnode @node MENU_Save "CassLabel/Menus/Save" Here you can save your cassette cover. @endnode @node MENU_Print "CassLabel/Menus/Print" Print an ASCII or a LaTeX output with "Print". If you want to print a @{" LaTeX output " link Print}, you have to start a TeX previewer (AmigaTeX or PasTeX) in the background. @endnode @node MENU_Create "CassLabel/Menus/Create" Create an ASCII or a LaTeX output, which you can save anywhere. @endnode @node MENU_About "CassLabel/Menus/About" An about window appears containing information about the current version and the address of the author. @endnode @node MENU_Quit "CassLabel/Menus/Quit" Leaves the program. You can always leave the program by pressing or . There is actually no 'safety Requester', because I think it is unnecessary (germans say 'overfluenty' :-> ). @endnode @node Problems "CassLabel/Problems" One Problem of CassLabel is that after pressing in the string gadget under any listview, the Keybutton "New" won't be activated because of a possible error in MUI 1.3. If you want to make some entries (you certainly want), you have to press , then to jump to the Keybutton "New" and then to make a new entry. I hope Stefan Stuntz will fix this problem in one of his next releases. When starting CassLabel from a shell window, you should set the stack size to 10000 or greater. Don't forget to make an Assign like "Assign C: DH0:rexxc add" when you want to print a LaTeX output. @endnode @node TechInfo "CassLabel/Technical Information" CassLabel is compiled using SAS/C 6.3. This is IMHO the best C Compiler on the Amiga. Waiting for 6.50 (partially C++ support :-) ! @endnode @node Credits "CassLabel/Credits" Special thanks to - Stefan Stuntz for MUI - Jörn Clausen for beta testing and his suggestions for new LaTeX formats - Rüdiger Dreier and Henning Sauer for beta testing - Commodore for Intuition (but why you haven't implement Resource Tracking and Memory Protection in this OS? :-( ) Thanks also to all the people sending me bug reports, suggestions etc. @endnode