annotate src/protocols/silc/README @ 12468:6faefbebcd24

[gaim-migrate @ 14778] SF Patch #1372898 from charkins "This patch updates the unseen conversation api in gtkconv to ensure consistancy and avoid code duplication. The ...first_unseen() function is renamed and expanded to return a list of conversations that match the specified criteria. A max_count parameter is used to allow this to short circuit early (using 1 gives old behavior). An additional flag was added to allow this function to only consider hidden conversations (used by the buddy list). The blist is currently inconsistant in which conversations it loops over for showing the menu tray icon, creating the tooltip and the unseen menu. This patch fixes that. The ...find_unseen_list() now handles contact-aware conversations correctly as well (based on sadrul's patches in #1362579 which are obsoleted by this patch). I also included the fix from #1362579 which increments unseen_count only when state>=UNSEEN_TEXT." committer: Tailor Script <[e-mail]>

SILC Gaim Plugin
================

This is Gaim protocol plugin of the protocol called Secure Internet Live 
Conferencing (SILC).  The implementation will use the SILC Toolkit, 
freely available from the http://silcnet.org/ site, for the actual SILC 
protocol implementation.

To include the SILC into Gaim, one needs to first compile and install 
the SILC Toolkit.  It is done as follows:

	./configure --enable-shared
	make
	make install

This will compile shared libraries of the SILC Toolkit.  If the --prefix 
is not given to ./configure, the binaries are installed into the 
/usr/local/silc directory.

Once the Toolkit is installed one needs to tell for the Gaim ./configure
script where the SILC Toolkit is located.  It is done as simply as:

	./configure

if pkg-config is installed in your system.  If it is isn't it's done as:

	./configure --with-silc-libs=/path/to/silc/lib
		    --with-silc-includes=/path/to/silc/include

If the Toolkit cannot be located the SILC will not be compiled into the 
Gaim.