17 Bit Software 2: Collection B

home *** CD-ROM | disk | FTP | other *** search

/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 1817.dms / in.adf / HDClick / HDClick.doc < prev next >

Wrap

Text File | 1992-02-02 | 33.5 KB | 789 lines

---------------------------------------------------------------------- | | | ------------------ | | · H D - C L I C K · | | ------------------ | | V e r s i o n 2 . 0 | | | | © 1991 by Claude Mueller | | | ---------------------------------------------------------------------- Use of HDClick: ----------------- HDClick is a program-selector/HD-menu. With HDClick, programs can be started very easy by selecting gadgets with your mouse. ------------------------------------------------------------------------ Copyright: --------- HDClick is Shareware. If you like it, please pay the Shareware fee of... --------------------------- · Sfr. 20 ¹ · --------------------------- ( = US $15 ; UK £10 ) or --------------------------- · US $20 ¹ · -------------------------- if you don't live in Europe (¹ Or appropriate amount in other currency) ...to the author. If you know that the postage is very high, please send me enough money for it. If you want you can pay me more than the amounts listed above of course ! ----------------------------------------------------------------------- YOU HAVE *NO* RIGHT TO LEAVE OUT PAYING THE SHAREWARE-FEE BY USING THE UNREGISTERED VERSION WITH THE DISTURBING-REQUESTER ! The unregistered version with the disturbing-requester is also Shareware. Shareware-payees get the version without requester only as a "present" because of their fairness. ----------------------------------------------------------------------- You can pay cash, per postal order, cheque¹ or if possible on my swiss bank account: ======================================================================= Schweiz. Bankverein CH-4104 Oberwil BL Claude Mueller Auf den Hallen 32 CH-4104 Oberwil Account: 40-854-2 Reference-No: 3 32332 16806 ======================================================================= ¹ Cheques should be for a swiss bank because I have to pay a fee (Sfr.8.-) for cheques of abroad banks. A postal order would be better. ======================================================================= With sending your Shareware-fee, A DISK MUST BE INCLUDED, which will be filled !! F R E E !! with PD-Programs. Of course with the newest version of HDClick without the disturbing copyright-requester. Registered users will get an information as soon as a new version of HDClick is available. The updates are free (disk and postage not included). Address: ------------------------ Claude Mueller Auf den Hallen 32 CH-4104 Oberwil (BL) SWITZERLAND ------------------------ **** Fidonet: 2:302/445.6 "Claude Mueller" **** **** Z-NET : C.MUELLER@LINK-CH1.ZER **** If you have problems to install HDClick or if you find bugs you can call or write me. What is important when paying the Shareware-fee: ------------------------------------------------ - Don't forget to send a disk ! - Shareware-payees can choose an own Hotkey for the iconify-function ! If you want your own you must tell me the description of the key (e.g. "HELP or "F1") and/or the appropriate Hex-code. Please don't use Key-combinations like SHIFT-*** or ALT ***. - Tell me which version number your HDClick has got (important to answer your questions). - If you have problems using or installing HDClick it would be fine if you'd send me all your configfiles and your STARTUP-SEQUENCE. - Tell me which Kickstart/OS version you have got (1.2 / 1.3 / 2.0 ) and if you are planning to upgrade to Kickstart 2.0 if you haven't got it yet. - Why ask me if the problem is stated in this doc already ? Please look carefully ! - Don't forget to give me your name and address ! - The program "Config_Tool" by Manfred Gillert is Freely Distributable and not Shareware. When you pay the Shareware-fee you don't pay for the Config_Tool also. The author Manfred Gillert is very thankful for any donation for his program Config_Tool ! Config_Tool is Copyright (C) by Manfred Gillert. The Color.library is Copyright (C) by Dissidents. The KD_FREQ.library is Copyright (C) by Khalid Aldoseri and may only be distributed with the file 'FR_User.DOC'. Thanks to ========= Josef Egloff for his help. Without him, HDClick wouldn't have many of its new features ! Rolf Boehme for his help with the hotkeys. Lothar Mai which has tested HDClick for bugs. ********!*************!**************!*************!***********!********* D I S C L A I M E R ------------------- Because a German magazine with disk didn't obey my Disclaimer rulers, this chapter is now at the beginning of the doc. Perhaps it will be read then. This disk may only cost the price of a disk plus a small copy-fee. If you pay more than that you have been cheated and you should search an other PD-Source. ------------------------------------------------------------------------- HDClick may be freely copied, as long as this documentation and the program itself are left intact and are distributed together, with the following exeptions: HDClick MAY NOT BE USED OR COPIED COMMERCIALLY without a WRITTEN AUTHORITY OF THE AUTHOR. HDClick may NOT be taken into A PD-SERIES OR SIMILAR without a WRITTEN AUTHORITY OF THE AUTHOR. HDClick may NOT be distributed on a DISK-MAGAZINE or an other PUBLIC PUBLICATION without a WRITTEN AUTHORITY OF THE AUTHOR. The author takes no responsibility for any damage created using HDClick. HDClick is Shareware. If you like this program and/or if you use it often you should read the text "Copyright". HDClick is Copyright by Claude Müller , all rights are reserved to the author. ------------------------------------------------------------------------- ----------------------------------------------------------------------- D O C U M E N T A T I O N ----------------------------------------------------------------------- **** New features of V1.3 **** Version 1.3 has got a new mode "m" which allows to handle sub-menus. **** New features of V2.0 **** - A new EDIT-function. Changing the configfile direct from HDClick without a text-editor is now possible. - The Small-function. A small version of HDClick, implemented in HDClick. - Iconify with (Hotkeys) or without Window. - Own Color specifications possible. - HDClick Preferences which allows to - Start HDClick normal, small or iconified. - Specify the Window-coordinates - Specify Screencolors - Free memory shown in Screentitle. - HDClick can create configfiles itself. - HDClick's output directed to NIL:, HDClick can be started with runback. ** Future Versions ** - OS 2.0-only version with the new features of the new OS. - Improved EDIT and PRefs-Functions with more user-specifications eg. Text/Gadgetcolors and Fonts. - ??? If you have Ideas, please tell me ! ******************** C O N T E N T S --------------- How to start HDClick....................................... ( 1 ) Shell...................................... (1.1) Workbench.................................. (1.2) A few important things..................................... ( 2 ) The Small-Window........................................... ( 3 ) The Iconify-function....................................... ( 4 ) The EDIT-function.......................................... ( 5 ) The column-titles.......................................... ( 6 ) HDClick Preferences........................................ ( 7 ) HDClick startmode.......................... (7.1) Iconify-mode............................... (7.2) Window-coordinates......................... (7.3) Color specifications....................... (7.4) The Configfile............................................. ( 8 ) Program-startmode.......................................... ( 9 ) Launch..................................... (9.1) Run........................................ (9.2) Execute.................................... (9.3) Menu....................................... (9.4) How to create a new configfile......... (9.4) Option..................................... (9.5) Appendix 1: Tips, frequent questions, Error-messages, examples... First I'd like to say that this documentation was written with the Ger- man-English dictionary next to me, I can't write a correct documentation with the English I'm learning at school. So if there are any faults (fault, defect, blemish, flaw, mistake, error blunder - I should buy me a smaller dictionary...) please perceive them. (1) How to start HDClick -------------------- (1.1) Shell "HDClick Configfile" ----- or "HDClick" "Configfile" = Path and Filename of the ASCII configuration-file. If no filename is given, HDClick looks for a file named 'HDCCONFIG' in the actual drawer. Example: "Dh0:c/HDClick Dh0:s/HDCConfig" If the specified configfile was not found, a requester appears. By clicking on the gadget "Create new", a new configfile with the filename named before will be created. In the upper example, a file named "dh0:s/HDCConfig" would be created. You must restart HDClick now. HDClick 2.0 can be started with runback or runbackground. HDClick directs its output to NIL:. If a program which has been started from HDClick makes output, the output will not be shown. (1.2) Workbench --------- If HDClick is started from Workbench, it looks for a file named 'HDCConfig' in the actual drawer. If "HDCConfig" wasn't found, a requester appears. By clicking on the gadget "create", a configfile named "HDCConfig" in the actual drawer will be created. You must restart HDClick now with a double- click on its icon. (2) A few important things : ---------------------- When HDClick is started it looks for the config file. If found, it opens a screen with gadgets. The user can click on a gadget, and a user-defined program is started. Along the normal gadgets there's a QUIT-gadget to quit HDClick, a SMALL-Gadget for the Small-Version of HDClick, a PREFS-Gadget for the Preferences and an EDIT-gadget (will be explained later). HDClick requires the command "Run". If possible, the KD_FReq.library and the Color.library should be in the LIBS: directory. (3) The SMALL-Window ================ HDClick2.0 not only works with a normal screen but with a mini-version also. You can get to this "Small"-Window by clicking on the "Small"-Gadget or by selecting SMALL for the HDClick program-start in the Preferences (see (7)). A small window will be opened on the Workbench Screen. Only one of the four Gadget-rows will be seen at a time. The same configfile will be used. The Arrow-Gadgets: With the Arrow-Gadgets you can switch between the four gadget-rows. The Expand-Gadget: With the Expand-Gadget (the one between the arrow-gadgets), the Small- Window will be closed and the HDClick-Mainscreen will be opened. If you press the right Mousebutton you'll get into the iconify-state which can be with or without a window (see Prefs(7) or Iconify (4)) (4) The Iconify-Function ==================== If the right mousebutton is pressed, the screen closes and a small window opens. You can get back to the main screen by pressing the right mousebut- ton while the window is activated. If a requester or a HDClick-Window like e.g. the EDIT-Window is opened, the Iconify-function doesn't work. In the HDClick Preferences you can choose between two Iconify-Functions. By pressing the right Mousebutton - A window will be opened from which you can get back to the Mainscreen or Small-Window by pressing the right mousebutton. - No window will be opened. You can get back to the Mainscreen or Small-Window by pressing the HELP-Key. On demand, Share- payees can specify an own Hotkey than the HELP-Key, if the key is used by other programs. More about this read "Copyright" on the beginning of the Documentation or under Prefs (7). (5) The EDIT-Function ================= Since version 2.0 of HDClick you don't have to change the Configfile(s) by a Text-Editor. The Gadgets and the Column-Titles can be changed directly from HDClick. Gadgets can be edited by clicking on the EDIT-Gadget and then on the Gadget you want to change. A window opens where you enter your data. With the gadget "Filereq", the Filename of the program can be chosen with the mouse. By clicking on an Arrow-Gadget you can scroll back and forth between the gadget-entries. Now you have to chose a program-startmode (see (9)) with the Cycle-gadget. IF you chose "None", the gadget will have no function. You can use this for creating empty gadgets. With Save/Save As you can save the active Configfile with your changes (always the whole Configfile is saved). After that, the EDIT-Window closes but you are still in the "EDIT-Mode". For leaving the EDIT-Mode, click on the EDIT-Gadget again. (6) The column-Titles ================= The titles above each Gadget-column can also be changed directly from HDClick by clicking on the title you want to change. The gadgets are not visible but a window will be opened in which you can type in your titles. (Maximum 18 Chars). You don't need to be in the EDIT-Mode to do that. Save your changes with Save/Save As. (7) Preferences =========== (7.1) The HDClick-Startmode --------------------- Not to be confounded with the Program-startmode (Launch , Run etc.). Here you can specify in which form HDClick will be started: - Normal: HDClick opens the Mainwindow - Small: HDClick opens the Small-Window - Iconify: HDClick opens the Iconify-Window The changes get active as soon as HDClick is started again. (7.2) The HDClick-Iconify-mode ------------------------ If you press the right Mousebutton in the Mainscreen or Small-Window, an Iconify-Window appears. This can be changed in this version of HDClick. You can chose between - Window: The Iconify-Window opens - Hotkey: No Window opens. HDClick is still in memory. Back to the Mainscreen you get by pressing the HELP-Key. This is good for people who have too many Iconify-Windows (inclusive clocks etc.) on their screen. (7.3) The Window-Coordinates ---------------------- Here you can specify the X/Y coordinates of the Iconify - and Small- Window. Because there exist different Screen-heights/widths on different Amiga-Platforms, HDClick doesn't correct the coordinates if they are too high or too low. Is this the case, you won't see any window, HDClick still exists in memory. You can't get back to HDClick. Sorry for that, I'll fix this as soon as possible. (7.4) The Color Specifications ------------------------ By clicking on the Gadget "Colors", a Colorrequester of the Color.library appears. After clicking on "Save" in this requester, the changed colors will be used but aren't saved in the HDClick-Config- file. You can save them by clicking Save/Save As in the Prefs-Window. Each configfile can have its own colors. (8) The configfile: ============== This part must only be read if you want to change your Configfiles with a Text-Editor. Here a short specification of a Configfile: ---------------------------------------------------------------------- Program,Gadgettitle,l or Program,Gadgettitle,r or Program,Gadgettitle,e or Program,Gadgettitle,o or Configfile-filename,Gadgettitle,m or ,, ... 55 entries n,w, Column-Title1 Column-Title2 Column-Title3 Column-Title4 Window-Positions " " " Colors ---------------------------------------------------------------------- The "Normal"-User changes the configs with the Prefs and EDIT-Functions in HDClick. But sometimes its useful to change it by Texteditor, e.g. if you want to make big changes. If you have problems here you should contact me. Commas between the three entries _____|_____ | | Program,Gadgettitle,x _________________| | |_________________ | | | Exact path and filename of Title-string of the Program start-mode the program to be started gadget(max. 16 chars) -> (9) to. If there are not enough entries or wrong entries, it may be possible that HDClick makes a confusion of the entries or crashes. (9) Programstart-Mode ================= (9.1) Mode Launch: -----------=------ In the mode Launch the program will be started normally and HDClick quits. (9.2) Mode Run: -----------=--- In the mode Run, the program will be started with RUN. HDClick closes the screen and iconifies. For this mode, the command RUN must be on Disk. (9.3) Mode Execute: -----------=------ In the mode Execute, the program will be started with RUN. The HDClick-screen stays open, other programs can be started by clicking on gadgets. (9.4) Mode Menu: -----------=--- In the mode Menu, a new configfile will be loaded after the gadget has been selected. All gadgets,titles and the Prefs- specifications will change to the entries specified in the new configfile. The filename of the configfile to load must stand at the same place as a Program-Filename. Here an example for an entry for Gadget in the EDIT-Window: Title: Graphic Configfiles: Dh0:s/graphicconfig Mode: Menu And here's an example for an entry in the Configfile: Dh0:s/GraphicConfig,GRAPHIC,m | | \ Name of config- Gadget- \- mode "m" for submenus file title After this gadget has been selected, the configfile "Dh0:s/GraphicConfig" will be loaded. All gadgets will now become new functions, declared in the new-loaded configfile ("GraphicConfig"). If the Configfile wasn't found after clicking on the Gadget, a requester appears. By selecting "Create New", a new configfile with the Filename specified before will be created. In the example above, the Configfile "Dh0:s/GraphicConfig" would be created. With this function you have access on an unlimited number of configfiles. In a submenu there can be more submenus, the next can also have submenus and so on. You can get from each menu to all other menus, if the gadgets have been declared for that. See "Examples" for more details. How to create a new Configfile ------------------------------ Go into the EDIT-Mode, chose an empty Gadget and enter the gadgettitle. In the other stringgadget, enter a Path + Filename of a not existing Configfile. Now select mode "Menu" and click Save. Deselect EDIT then click onto the new Gadget. In the appearing Requester, click on "Create new" and a new Configfile will be created. (9.5) Mode Option: -----------=----- In the mode Option, a window with five gadgets opens: The stringgadget: The text which is typed in there will be received as an argument by the declared program. Example: Entry in the configfile: Text in the stringgadget: | | "dh0:c/Ed,Editor,o" "dh0:s/startup-sequence" |___________________________________| | Following will be executed: | "dh0:c/Ed dh0:s/startup-sequence" The editor "ed" loads the text-file "dh0:s/startup- sequence". When one of the following gadgets is clicked on, the defined program will be started (see above) with one of the Programstart-modes, depending on which gadget you click. The "Filereq"-Gadget: After selecting this gadget, a Filerequester of the KD_FReq.library opens. The selected file will be copied to the Stringgadget in the Option-Requester. =========================================================================== Error-Messages, Questions, Tips... ======================================== C O N T E N T S =========================================================================== Questions on installation: The Libraries........................................ 1.1 How can I change my startup-sequence ?............... 1.2 Questions on the HDClick-Start: Configfile not found................................. 2.1 HDClick loads, nothing happens....................... 2.2 Questions on program-gadgets/programstarts: Run more than one command/program with one gadget (Stack, CD, Assign etc., after that the program)..... 3.1 A gadget is selected - nothing happens............... 3.2 A gadget is selected, HDClick "disappears" in the "Run"-Mode.................................... 3.3 Important things and explanations of Configfile-errors .. 4 Known bugs............................................... 5 Special examples for Configfiles......................... 6 =========================================================================== (1) Questions on Installation ========================= (1.1) The Libraries ------------- For using all of HDClick's functions, the "KD_FReq.library" and the "Color.library" must be in the LIBS: Drawer of the Boot disk (SYS:). Both libraries are distributed with HDClick. With the Install-Script in this Drawer the Libs will be installed. If an other Boot-Disk or Harddisk is used, these Libs must be installed again. If the Libs are not found, the gadgets "Filerequester" and "Color-requester" cannot be used, HDClick starts anyway. See "Known Bugs" (5). (1.2) How can I change my Startup-Sequence ? -------------------------------------- This question doesn't belong into this doc but in an AmigaDOS-Book. Because I am asked this sometimes, I explain it here. First, open a CLI or Shell. Now type the following: "SYS:c/ed SYS:s/startup-sequence". The Editor ED now loads the Startup-Sequence. Now you enter the following on the wished place: "SYS:HDClick SYS:s/HDCConfig". Now press the Esc-Button and X. ED now saves the changed file. For functioning correctly, the Program HDClick must be on SYS: (the Bootdisk/HD eg. df0: or dh0:) and the Configfile "HDCCONFIG" must be in SYS:S. If anything doesn't function after reboot... Don't panic and call me/write me... (2) Questions on the HDClick-Start ============================== (2.1) Configfile not found -------------------- HDClick doesn't look in S: for a configfile automatically. If a configfile exists not in the actual drawer, the configfile-drawer must be specified on the start of HDClick or on Menu-Changes. An Example: File HDCConfig in the Drawer dh0:s. HDClick must be started with "HDClick dh0:s/HDCConfig", if this was a Menu-Gadget the entry for it would be "Dh0:s/HDCConfig". (2.2) HDClick loads, nothing happens ------------------------------ If HDClick is started and no Screen/Window opens it could be because of the following. HDClick was started Iconified or Small as specified in the Config- file. The Window-Coordinates are incorrect though, too high for example. Is this the case, the Configfile has to be changed (with a Text-Editor in emergency). It could also be that there's a Configfile-error. HDClick could also crash at this place (sorry). There will be no window of course if the Startmode is "Iconify" and the Iconify-Mode is "Hotkey". You must press the HELP-Key to get back to HDClick. (3) Questions on program-gadgets/programstarts ========================================== (3.1) Run more than one command/program with one gadget ------------------------------------------------- If a program demands a CD, Assign or Stack-Change before its start, this can easily be solved with the program "Config_Tool" by Manfred Gillert. Config_Tool is spread along with HDClick. If there have to be started other programs than CD, Assign or Stack, this can be made with the help of a batch-file. How to create batches will be explained in an AmigaDOS-Book, but here's a short example: Open the CLI/Shell and type the following: "Sys:c/ed s:AnyName". The Editor ED now creates the File "AnyName". Now enter the Path and Filenames of the programs you wish to start line by line (one line per program) and press Esc, then X for saving. Now run HDClick, go to the EDIT-Mode and click on an empty gadget. Click on "Filerequester" and select the file "s:AnyName". Now you must add the following. Before the Filename you must type "Sys:c/Execute". In the Stringgadget (of the EDIT-Window) there's the text "Sys:c/Execute s:AnyName". Now enter a Gadgettitle and a mode (Launch, Run Execute or Option) and click SAVE. After clicking on this new Gadget, all the programs listed in the batchfile will be started one after the other. (3.2) A gadget is selected - nothing happens -------------------------------------- If nothing happens, this can have several causes: The Gadget has no Mode (Mode "None"). Change it with the EDIT-Function. The program was not found or it was run incorrect. Error-Messages will not be visible because HDClick sends the output to NIL:. The Program "Snoopdos" by Eddy Carroll helps by searching for errors. (3.3) A gadget is selected, HDClick "disappears" in the "Run"-Mode ------------------------------------------------------------ Wrong Window-Coordinates have been specified for the Iconify-Window. If the coordinates are too high, no window will be visible. But first, look if you have selected "Hotkey" in the Iconify-Mode. Press the Help-Key to get back to HDClick if this is the case. (4) Configfile-errors ================= Error: Error in configfile: ----- -------------------- - Titles cross themselves - One of the gadgettitles is longer than 16 chars. - In the gadgettitle stands the - A comma was forgotten . string which was declared as a program or a mode (for Example ",r" as title) - One ore more column-titles don't - Not enough entries in the appear configfile - After clicking on a gadget, the - Not enough entries in the wrong programs are executed. configfile or a comma was left out. - After HDClick was started by - Dos received an error Workbench, the selected program (for example File not found) doesn't start. - A gadget has been selected - Too many or not enough entries but nothing happens. in the configfile. - After saving a configfile, the - If the entries are too long, titles are not correct. HDClick doesn't save correctly. - "Error while saving"-Message - The file couldn't be saved. appears. (DOS-Error) - "Configfile not found" - The configfile doesn't exist or the appropriate entry is wrong. The Configfile was not found by DOS. If a filename or a gadget-title contains a comma, there'll be an error,too. (5)Known bugs ---------- Here's a "list" of the (small) bugs I know. No window appears if the coordinates for it are too high. This is so because not all people work with the standard 640*200 / 640*256 resolution. If you have larger screens open, higher coordinates are possible. As soon as I have the possibility to program under OS2.0, this bug will be fixed. A color should NEVER read 000 (black) or it could come to problems in Saving the configfile. Take 111 instead of 000, this is not too bad, isn't it ? I've been trying to solve this problem for a long time, but I didn't made it by now. There can only be one HDClick in memory at a time, so it may be run only one time. If one is already in memory and a second one is tried to run, the second one won't start. This bug never happened to me but I heard it from other people. If you don't install the KD_FReq and/or the Color.library and start HDClick anyway, you could get a few more gadgets in the Prefs-Window which doesn't look nice. The thing I know is that if one of the Libraries is not found, the Filereq Gadget in the EDIT-Window is not ghosted, so HDClick crashes when you click on it. I forgot to disable that gadget...Ups. All I say is: INSTALL THOSE LIBS !!! (6) Special examples for Configfiles -------------------------------- Here a few examples for entries in the configfile. dh0:c/execute s/WB-Batch,Workbench,l -> The script s/WB-batch is execu- ted. HDClick quits. Gadgettitle "Workbench". graphic/Paint,Photolab,o -> First, the requester with stringgadget appears. If one of the three gadgets is se- lected, the program "paint" starts. It will display the picture typed into the stringgadget (for example: "pictures/pic"). Gadgettitle: "Photolab". Dh0:s/GamesConfig,GAMES,m -> The configfile "GamesConfig" in the "s"-drawer of "Dh0:" will be loaded. All gadgets change as specified in the new configfile "GamesConfig". dh0:s/HDCConfig,Reload Config,m -> With this example, the actual configfile will be loaded again after you click on this gadget.This is useful when you've changed your config with an editor ,Execute Command,o | | No entry! Requester opens -> A special but very useful example. After this gadget was selected, the following happens: The Requester opens. Now, type a filename of a program you want to be started into the stringgadget. After clicking on one of the three mode-gadgets (Launch,Run,Execute), the text in the stringgadget is attached to the specified program-name in the configfile. In this case, there's no entry for a program, so the filename typed into the stringgadget will be executed. The best is when you edit the example-configfile (HDCConfig) in this drawer and enter your own data. ------------------------------------------------------------------------- 27.1.1992 Claude Müller