<!-- ##### SECTION Title ##### -->
gnome-triggers

<!-- ##### SECTION Short_Description ##### -->

Hierarchical signal mechanism for application events.

<!-- ##### SECTION Long_Description ##### -->
<para>
The GNOME triggers API was intended to provide a general way for the
application to tell GNOME about "interesting events".  Most of it is
presently deprecated - at the present time, the application writer
should only use gnome_triggers_do and gnome_triggers_vdo for the purpose
of firing application sound events (in conjunction with .soundlist files).
</para>

<para>
Please see the "GNOME configuration files" white paper for more information
on .soundlist files.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### ENUM GnomeTriggerType ##### -->
<para>
Deprecated.
</para>


<!-- ##### USER_FUNCTION GnomeTriggerActionFunction ##### -->
<para>
Deprecated.
</para>

@msg: 
@level: 
@supinfo: 


<!-- ##### STRUCT GnomeTrigger ##### -->
<para>
Deprecated.
</para>


<!-- ##### FUNCTION gnome_triggers_init ##### -->
<para>
Deprecated.
</para>



<!-- ##### FUNCTION gnome_triggers_readfile ##### -->
<para>
Deprecated.
</para>

@infilename: 
@Returns: 


<!-- ##### FUNCTION gnome_triggers_add_trigger ##### -->
<para>
Deprecated.
</para>

@nt: 
@Varargs: 


<!-- ##### FUNCTION gnome_triggers_vadd_trigger ##### -->
<para>
Deprecated.
</para>

@nt: 
@supinfo: 


<!-- ##### FUNCTION gnome_triggers_do ##### -->
<para>
This function tells the GNOME framework that an event has occurred inside 
the application that GNOME might be interested in.
Currently this is just used to trigger user-configurable sound events.
</para>

@msg: A string describing the event. This is not used by sound events, and can thus be the empty string ("").
@level: Valid levels are "warning", "error", "question", "info", or "generic". You can also pass in NULL, which is recommended if you are triggering an application-specific sound event.
@Varargs: Zero or more strings that provide an event classification. The last argument after these strings needs to be NULL.


<!-- ##### FUNCTION gnome_triggers_vdo ##### -->
<para>
This function is the same as gnome_triggers_do, except the supinfo is
passed as an array of strings, rather than as a variable number of
arguments.
</para>

@msg: 
@level: 
@supinfo: