
DCLICK.PRG, the double klick organizer.
----------

Because there are similar programs available everywhere
(for other systems, too, e.g. REGEDIT for Windows95),
here are some reasons why you could want to use DCLICK.PRG:

* installing of many applications in the NEWDESK.INF or DESKTOP.INF
  increases the size of that file dramatically. But sooner or later
  (depending on the TOS version of your computer), the file exceeds
  the limits of the AES and there will be severe errors...
* DCLICK is able to look at the names of files, not only at their suffixes.
  This makes it more flexible than e.g. Win-Regedit. A possible case
  are applications that start when there is a file with their name.
* If you are using different NEWDESK.INF or DESKTOP.INF files for
  e.g. different screen resolutions, the installing of applications
  can be real hard work. With DCLICK.PRG you only have to edit one
  file.
* DCLICK.PRG is small and loads quickly. The size of DCLICK isn't enormous
  (usually..), so it works even with very memory-hungry applications.
* DCLICK.PRG allows the start of applications that want to be started
  in their own directory.
* DCLICK.PRG is able to give additional parameters to programs
* Programs that ask AES for their path and command line can be started with
  DCLICK, too (using SHEL_WRITE).
* TOS- and GEM- programs are seperated and started differently.
* DCLICK.INF is usually smaller than the comparable NEWDESK.INF/DESKTOP.INF.
* DCLICK.PRG is freeware; to give it to other people you are allowed only
  if you give them all files (unmodified) and don't earn money from that;
  companies may sell DCLICK only with my personal permission.


So. Convinced? If you are, here comes the installation description:
1. copy DCLICK.PRG to somewhere (example: C:\TOOLS)
2. using a editor program (e.g. the supplied ED_E.PRG) modify the files
   NEWDESK.INF or DESKTOP.INF:
   (start ED_E.PRG, load with CTRL-O and the file selector box
    the file NEWDESK.INF or DESKTOP.INF; to save it again later on
    press CTRL-S; other commands are shown by pressing the HELP key)
   Somewhere in that file there start lines with
   #G ...
   there stand programs that are already installed in the normal way
   or the standard recognized program types (*.GEM etc.)
   Insert a line directly above the first #G line (to do so, place the
    cursor to the start of the first #G line, press RETURN and move the
    cursor to this new free line) and type in:

#G 03 04 000 C:\TOOLS\DCLICK.PRG@ *.*@ @ 

   (replace C:\TOOLS by the path you have choosen for DCLICK.PRG)
   Of course you can delete installed applications right now -
   just delete the corresponding lines.
3. Now copy the file DCLICK.INF to C:\ or create a file DCLICK.INF there.
   The contents of DCLICK.INF (example):

#& *.MOD *.S3M *.WAV #
	!E:\MUSIC\ULTRASND.PRG : *
#& READ_ME.* README.* *.TXT #
	!C:\TOOLS\ED_E.PRG : *
#& *.ZOO #
	C:\PACKER\ZOO.TTP : -view *
#& *.C #
	@C:\MY_C\
	!C:\TOOLS\ED_E.PRG : *
	+
	CC.TTP : -v *
#& *.RSC #
	<C:\RCS30\RCS30.PRG : *
#& EDIT #
	!C:\TOOLS\ED_E.PRG
#& *.* #
	!C:\TOOLS\VIEW_ALL.PRG : *


The "#&" starts a list of file masks, the "#" marks the end of that list.
If the double-klicked file name fits to an element of that list,
the next line will be executed; otherwise DCLICK.PRG searches for the
next list (the next '#&' chars).
At the end of the file DCLICK.INF you should set a list consisting of
the *.* mask, so that every file leads to some action (the 'default' case).

The actions:
*.MOD - files start in GEM mode (because of the '!' before the program)
        ULTRASND.PRG; the file name is passed as a parameter to that program
        (as it is done when a TTP-program is started)
README.NOW starts ED_E.PRG in GEM mode with parameter README.NOW .
TST.ZOO starts ZOO.TTP in TOS mode (no '!'). Because of the additional
        parameter '-view' there is only view mode selected
C:\RT.C first sets the actual path (for TOS programs) to C:\MY_C.
        The file name is expanded by its path..
        Now ED_E.PRG is started in GEM mode, then (because of the '+')
        CC.TTP -v C:\RT.C is started in TOS mode.
O.RSC   starts RCS30.PRG via SHEL_WRITE in GEM mode.
EDIT    starts ED_E.PRG in GEM mode without any parameters.
HACK.HCK starts the viewer VIEW_ALL (default..).

   more detailed:

#& <m1> <m2> <m3> ... #
	<path, if necessary>
	<type><program><parameter>
	+ (if a 2nd program should be called)
	<path, if necessary>
	...
#& <m4> <m5> ... #
	...
(short before end-of-file:)
#& *.* #
	<default application, e.g. a editor>

Symbole: 
<m1> usw.  : file mask
<path>     : @X:\TESTDIR\   sets the (GEMDOS-)path to X:\TESTDIR\
<type>     : empty for TOS programs; ! for GEM programs;
             ^ for TOS programs using SHEL_WRITE;
             < for GEM programs using SHEL_WRITE;
<program>  : path and file name of the executable program
<parameter>: empty or a ':', indicating following parameter(s).
             A '*' stands for the complete file name.
             ** Important: Length of parameters has to be <=125 chars!

After that (yes, not a nice job) procedure you'll have a short NEWDESK.INF/
DESKTOP.INF. At that point, you'll never see the "show or print" dialog
box of TOS any more.
To test your results, RESET your computer or read in NEWDESK.INF.

I'm not responsible for any damage resulting of the use of DCLICK. The
function of this program was only checked extensively on TOS1.04 and 4.04.

Have fun with DCLICK,

Christian Peppermller
(Christian.Peppermueller@rzmail.uni-erlangen.de)
Ebrardstr. 23
91054 Erlangen
Germany
