=head1 NAME

LinPopUp - A Linux port of Winpopup, running over Samba.


=head1 SYNOPSIS

B<linpopup> [ B<-min> ] [ B<-info> ]


=head1 DESCRIPTION

B<LinPopUp> is a Xwindow port of Winpopup, running over Samba.
It permits to communicate with a Windows computer that runs Winpopup,
sending or receiving message. (It also provides an alternative way
to communicate between Linux computers that run Samba).


=head1 OPTIONS

=over 8

=item B<-min>

Will start LinPopUp minimized. LinPopUp will maximize itself each time 
a new message arrives. This feature was specially implemented to
automatically start LinPopUp via .Xclient or .xinitrc file.

=item B<-info>

LinPopUp will give some useful information about system configuration and
immediately exits. Use it if something goes wrong or/and when reporting a
bug.

=back


=head1 FILES

=item F<THIS_DATA_FILE>

Where message are kept.

=item F<~/.linpopuprc> 

Configuration file, where the preferences are stored. Not an ASCII file, 
so don't try to edit it.

=item F<~.linpopup.history>
History file where are kept last used send address. Will be automatically
created/updated.


=head1 INSTALLATION

To be able to receive messages that are sent to you, you will need to
edit the B<smb.conf> file (generally found in /etc directory) and to add
this line to the B<[global settings]> section :

B<message command = THIS_DESTDIR/bin/linpopup "%f" "%m" %s; rm %s>

B<PLEASE NOTE> that B<">%fB<"> is not the same thing as %f , B<'>%fB<'> 
or B<`>%fB<`>. If you enter a wrong message command, you will probably 
not receive some (only a few in fact) of the messages that are sent to you.
 

=head1 RESTRICTIONS

Running LinPopUp with three arguments may give imprevisible results. Only 
Samba can run it this way via the message command.


=head1 NOTES

=head2 Receiving message :

LinPopUp doesn't need to always run. If you close it, it will continues to 
receive all messages that are send to you. You can even quit Xwindow, 
and still receive messages. In fact, the only way to miss a message that 
was sent to you is to have your computer turned off.

=head2 Message management :

Messages are kept from session to session. You will always retrieve a 
message that was sent to you, ... if you have not deleted it. 

=head2 More help :

You will obtain more information about using and configuring LinPopUp 
by running it under Xwindow and looking at the B<Help menu>.

=head2 Requirements :

B<Samba> as well as the Gimp ToolKit B<GTK+> >= 1.2.0 are required. 


=head1 BUGS

None known, ...  that I was able to reproduce ;-)


=head1 COPYRIGHT

B<LinPopUp Copyright (C)1998-1999 Little Igloo Org> is freely distributable 
under the B<GNU Public License>, a copy of which you should have received 
with this software (in a file called F<COPYING>).


=head1 AVAILABILITY

You can get the last LinPopUp version, sources or binaries distribution,
RedHat or Debian Packages, at : F<http://www.littleigloo.org>


=head1 AUTHOR

Jean-Marc Jacquet <jm@littleigloo.org>


=head1 CREDITS

This man page was originally writen by B<Paul Slootman> <paul@debian.org>.
But, as I made some changes to it, any grammar/spelling errors are exclusively
copyrighted by B<ME>. 

=head1 SEE ALSO

F<samba>(7), F<smbclient>(1), F<smb.conf>(5), F<testparm>(1).