How to use this help

<h1>How to use this help</h1><br>

<h2>The Table Of Content</h2>
The use this help browser is very simple;
on the left side you have a directory of the help
file. This directory is devided in main- and sub-
topics. If you double-click a main directory-entry,
it will open and show you more topics. Single-Click 
on a topic and you will get there.

<h2>The Search Field</h2>
To search for a word, enter it and press the search
button. You can also use *,?,[],+ operators.

<h1>Introduction</h1>

<h2>Some personal notes</h2>

First I want to excuse my bad English, and I hope
not to have made too many mistakes in this text.
I have disigned this program to make X more comfor-
table to use. Furthermore I have tried to make the
program as easy to configure as I could.

<h2>About This Program</h2>

This program bases on the normal mount and umount
commands. It only delivers a fast possibility to
mount a device with a single button press under X.
I tried to design it that way, that not to much 
space is wasted by the program. I also tried to make
it very easy to configure with the help of dialogs,
as you may have seen.
Especially for CD-Roms I have added a function, 
which tries to mount the device for some time. In 
that way you can first take the cady out and then 
press the mount-button together with the pressed Con-
trol key. Than you can change the CD, it put it back 
into the device and the computer will mount it auto-
maticly, if you have been not too slow.

<h1>The Main Window</h1>

<h2>The Classic style</h2>

Depending on the style, you have choosen (pictured
or classic) the outfit of the mainwindow is differ-
ent. In the classic version you can see the devices,
which are configured in the program. On the left side
you have the button, which you can press to mount and 
unmount the device. On the right side, the status
of the device is displayed (when you have enabled
this function).

<h2>The pictured style</h2>

If you have choosen the default style you see some
pictures, which are the symbols for your devices. You 
can mount and unmount the devices by clicking on
those pictures. The status is displayed by the pic-
tures itselves. Depending on your settings the 
divice-names are shown.

<h2>Functions in the main window</h2>

You can mount and unmount the devices simply by 
clicking on them.
If you press Control while you are pressing a devi-
ce-button, it will try to mount the device for a
short while. Please read also "Options-Automounting"
entry.
Depending on your settings you can choose the differ-
ent dialogs by the menu or with the help of the button-
bar.

<h1>The Option Dialog</h1>

<h2>General settings</h2>

Here you can enable settings concerning the starting
of the program. "Start iconified" will start the program
as Icon. When you enable "Remember position" the main
window will always be displayed on the same position.
To save the position you must close the program and re-
open it or change to the configuration or the option dia-
log to save your settings!
Because the program should not waste too much space,
you can hide the menubar. 
The same goal has the "Only show buttons" checkbox.

<h2>Automounting</h2>

This function is desingned especially for CD-Roms with a 
long mountting time. To use this function unmount and open
the device. Then press the mount button while you hold the
Control-key down and close the device. You can continue
working while the program tries to mount the device for the
length of the period you have set in the options-dialog.
Attention: This function only tries to mount the device all
           1000 milisec for the period you have set in the 
           options dialog. Therefor it executes the mount com-
           mand on your system, which you normaly use to 
           mount a device.
           I do not know whether this function has some
           negative effects.

<h2>The setting control</h2>

Here you can choose whether or not the program should de-
tect the status of your devices. If you only use this pro-
gram to mount and unmount, it is enough to enable "Only
start control". If you use other programs, such as a CD-
Player and you change for example a CD, the program must re-
detect the status. Because this needs CPU-Power, you can
controll the period length ("Control frequence") in mili-
seconds.

<h2>Iconbaroptions</h2>

Of course the user can decide whether or not there should
be an iconbar and how this one should react. You have the 
choise between a static and a dynamic iconbar.

<h2>The style</h2>

This option controls the look and feel of the main window.
Depending on your choise some options are diabled.

</h3>Pictured style options</h3>

<h4>Enable Names</h4>

You can choose whether the names of the devices should be
displayed or not. If you only have a CD-Rom and a Disk-Drive
configured, it would not mak a lot of sense to enable this 
function.

<h4>The orientation</h4>

If you have enabled the pictured style, you can choose
whether the icons should be arranged in a horizontal or
in a vertical direction.

</h3>Classic style options</h3>

<h4>Only show buttons</h4>

To prevent wasting too much place you can switch the status
display off.

<h1>The Configuration Dialog</h1>

In this dialog you can configure the devices. Remember that
you must be root to use the options. If you are not
root, the entry will be ignored.

<h2>General notes</h2>

To delete an entry simply press "Delete". To add press "Add".
The "..." - button will show you special options.

<h2>Mount options</h2>

If you are root you can enable special mount options. If there
are some otions, which are not in the option-dialog you can 
add them manualy, but if you press the button for the option
dialog again, your additional entry will be lost.
For more information concerning the options please read the
man-entry. Therefor type "man mount" or "man umount", when you
are in a shell.

<h2>Devicename, Mountpoint, Buttonname, Picture</h2>

It is enough for the program if you only enter the device-
path or the mountpoint to work. Please ask your administrator
(root), if you do not know the device-name or the mountpoint.
In the buttonname field you can enter a name which is display-
ed next to the pictures or on the button.
The picture will only be displayed in the picture-mode (See 
Options-Picture Style"). At the moment you can choose between
five different pictures and you have the oportunity to use
self-defined pictures (See also "Pictures").

<h2>Pictures</h2>

If the user does not like to look at the same five pictures
all the time, he can define a new one under following con-
ditions:
    - it must be a Gif - format
    - there must be alway two pictures:
      if the picturename is xxx, then the two pictures must
      be named as:
         xxxout.gif
         xxxin.gif
    - The following names are used by ther program and can not
      be used:
         Network
         Zip-Drive
         Disk
         Harddisk
         CD-Rom
    - the picture must be in the same directory where all the 
      other pictures are
      
<h2>Submenu - Configuration</h2>

Originally, there has only been the possibility to mount or
unmount devices. But with the help of submenus, which can be
enabled with the middle mousebutton by clicking on a button 
or a picture, you can implement actions, such as eject the CD
with the help of external programs.
By pressing the Add-Button, you can add a new menuitem, and
by pressing the delete-Button, you can remove one.

<h2>Submenu - Configuration Examples</h2>

If you have an SCSI-Zip-Drive you may find it usefull to eject
your disks with a mousklick, or to enable/disable the Write-
Protection, without changeing to the commandline.
A command-line tool, which has this function, can be found
under http://www.torque.net/ziptool.html. You can implement
this features by defining following submenus:
<pre>
-----------------------------------------------------------
|Menucommand:                     |Menuname:              |
-----------------------------------------------------------
|/usr/local/ziptool /dev/sdb eject|Eject   Zip-Disk       |
-----------------------------------------------------------
|/usr/local/ziptool /dev/sdb eject|Enable  WriteProtection|
-----------------------------------------------------------
|/usr/local/ziptool /dev/sdb eject|Disable WriteProtektion|
-----------------------------------------------------------
Attention: The device names may be different on your computer!

<h1>Configuration Examples</h1>

Attention: The device names may be different on your computer!

<h2>Disk-Drive</h2>
<pre>
-----------------------------------------------------------
|Options:  |Devicename:|Mountpiont:|Buttonaname:|Picture: |
-----------------------------------------------------------
|-a        |/dev/fd0   |/driveA    |Disk A      |Disk     |
-----------------------------------------------------------
</pre>
<h2>SCSI Zip-Drive</h2>
<pre>
-----------------------------------------------------------
|Options:  |Devicename:|Mountpiont:|Buttonaname:|Picture: |
-----------------------------------------------------------
|-t msdos  |/dev/sdb4  |/Zip       |Zip         |Zip-Drive|
-----------------------------------------------------------
</pre>
<h2>SCSI CD-Rom</h2>
<pre>
-----------------------------------------------------------
|Options:  |Devicename:|Mountpiont:|Buttonaname:|Picture: |
-----------------------------------------------------------
|-t iso9660|/dev/scd0  |/CDRom     |CD-Rom      |CD-Rom   |
-----------------------------------------------------------
</pre>
<h2>Network</h2>
<pre>
-----------------------------------------------------------
|Options:  |Devicename:|Mountpiont:|Buttonaname:|Picture: |
-----------------------------------------------------------
|-t nfs    |Compname:/ |/Net       |Network     |Network  |
-----------------------------------------------------------
</pre>
Attention: if the network is not present and you try to mount
it, it will course a crash!

<h1>User profiles</h1>

Of course every user has its own profile. Remember that a nor-
mal user (that means not root) can not use the options and
the devices must be first entered in /etc/fstab by root.
The file with the profileinformation is placed in the home-
directory. If it has been deleted, the default settings will be
reloaded.
             
<h1>Configuration of the fvwm2-manager</h1>

If you want to start this program each time you start the fvwm
manager (on linux?), you have to add the following line in the
"fvwm2rc"-file:
<pre>
-----------------------------------------------------------
AddToFunc InitFunction
 +	"I"	Exec TkMount	-geometry +x+y
# end function InitFunction
-----------------------------------------------------------
</pre>
Probably you have allready the entry "AddToFunc InitFunction".
Then you only need to add the second line. After the "Exec" 
command, you have to write down the programname (do not forget
the path, if you have not set the program in your normal bin-
directory!). With the "-geometry" option you can set the window
on a special position.
For x and y you have to set the distance in pixel from the
left upper edge of the screen. The same can be reached by
enabling the "Remember position" button in the option dialog.

<h1>Bug-reports, Email and www-page</h1>

Of course there are probably a lot of mistakes left
in the code, and it would be fine, if you send me 
your bug reports or suggestions of new implementa-
tions. If you think this program is usefull or not, 
please send me your opinion to the following adress:

             vogtg@uni-duesseldorf.de
                 gvogt@mps.de
                           
The newest version can be downloaded under

          http://www.mps.de/tkmount
                    
My own homepage is

           http://www.mps.de/begin
          
<h1>Warranty and License</h1>

For information about the warranty and the license, please se-
lect the menu items Help/Menu and Help/License or read the
Files "License" and "Warranty in the directory, where you have
installed the program files or contact the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

<h1>What's new ...</h1>

<h2>... in Version 0.02b</h2>

I've fixed some bugs and added the options for the iconbar. I've
also improved the helpbrowser in that way, that the html-cood
has no mistaces, when viewed with a normal browser.
Last but not least I've painted some new icons and that's all.

<h2>... in Version 1.0b</h2>

I have decided to set the program version to 1.0 because there
have no more bugs been reported, but I have added some new 
features: 
          - you can now define your own menus, for example you
            can add a menu, which ejects your zip-disks or CDs
          - you can implement user-defined pictures. In that way
            you can also use this program as button bar. May be
            that I improve this function in the next version.