How to use this help

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

<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>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.

<h1>Configuration Examples</h1>

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

<h2>Disk-Drive</h2>

-----------------------------------------------------------
|Options:  |Devicename:|Mountpiont:|Buttonaname:|Picture: |
-----------------------------------------------------------
|-a        |/dev/fd0   |/driveA    |Disk A      |Disk     |
-----------------------------------------------------------

<h2>SCSI Zip-Drive</h2>

-----------------------------------------------------------
|Options:  |Devicename:|Mountpiont:|Buttonaname:|Picture: |
-----------------------------------------------------------
|-t msdos  |/dev/sdb4  |/Zip       |Zip         |Zip-Drive|
-----------------------------------------------------------

<h2>SCSI CD-Rom</h2>

-----------------------------------------------------------
|Options:  |Devicename:|Mountpiont:|Buttonaname:|Picture: |
-----------------------------------------------------------
|-t iso9660|/dev/scd0  |/CDRom     |CD-Rom      |CD-Rom   |
-----------------------------------------------------------

<h2>Network</h2>

-----------------------------------------------------------
|Options:  |Devicename:|Mountpiont:|Buttonaname:|Picture: |
-----------------------------------------------------------
|-t nfs    |Compname:/ |/Net       |Network     |Network  |
-----------------------------------------------------------

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:

-----------------------------------------------------------
AddToFunc InitFunction
 +	"I"	Exec TkMount	-geometry +x+y
# end function InitFunction
-----------------------------------------------------------

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:

                 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.