[an error occurred while processing this directive]
[<a href="index.shtml">Package Index</a></code> | <a href="index_std.shtml">Mudlib Index</a></code> | <a href="index_eff.shtml">Effect Index</a></code>]<br><h2>Includes</h2>
This class includes the following files /include/deity.h, /include/board.h, /include/morpork.h, /include/tune.h, /include/player_handler.h, /include/playtesters.h, /include/guilds.h, /include/player.h and /d/am/path.h<h2>Class Index</h2>
<ul><li><a href="#class_deity_cache">deity_cache</a>
</ul><h2>Method index</h2>
<ul>
<li><a href="#add_command">add_command</a>(string, string, int)<br/>
This method adds a command to be given to the priests.
<li><a href="#add_excommunicated">add_excommunicated</a>(string, string, string)<br/>
This method adds a priest or worshipper to the list of excommunicated players and posts a message to the board
<li><a href="#add_faith_rod">add_faith_rod</a>(string, string, string, int, int)<br/>
This method adds a faith rod to the set used by the deity.
<li><a href="#add_highpriest_ability">add_highpriest_ability</a>(string, string)<br/>
This method adds an ability to the set given by the deity to high priests.
<li><a href="#add_highpriest_command">add_highpriest_command</a>(string, string, int)<br/>
This method adds a command into the set of commands that high priests
learn.
<li><a href="#add_highpriest_prayer">add_highpriest_prayer</a>(string, string, string, int, string)<br/>
This method adds a ritual to the set given by the deity to high priests.
<li><a href="#add_position">add_position</a>(string, string, int, string *)<br/>
This method adds a new position for the guild.
<li><a href="#add_prayer">add_prayer</a>(string, string)<li><a href="#add_priest">add_priest</a>(string, string)<br/>
This method adds a priest to the deity
<li><a href="#add_ritual">add_ritual</a>(string, string, string, int, string)<br/>
This method adds a ritual to the set given by the deity.
<li><a href="#add_worshipper">add_worshipper</a>(string, string, int)<br/>
This method adds the information associated with the
non-priest worshipper.
<li><a href="#add_worshipper_ritual">add_worshipper_ritual</a>(string, string, string, int, string)<br/>
Add a worshipper ritual!
<li><a href="#adjust_points">adjust_points</a>(string, int, mixed, string)<br/>
This method adjusts the number of points associated with the
deity.
<li><a href="#adjust_priest_rating">adjust_priest_rating</a>(string, string, int, int)<br/>
This method adjusts the rating for the priest.
<li><a href="#adjust_rating">adjust_rating</a>(string, int)<br/>
This method adjusts the rating for the deity.
<li><a href="#align_string">align_string</a>(int)<br/>
This method gives a string represtentation of the the
alignment level.
<li><a href="#appoint_position">appoint_position</a>(string, string, string)<br/>
This method appoints a player to a position in the guild.
<li><a href="#challenge_high_priest">challenge_high_priest</a>(string)<br/>
This method starts voting for a schism, retaining the current high priest.
<li><a href="#check_deity">check_deity</a>(string, int)<li><a href="#clear_ritual">clear_ritual</a>(string)<li><a href="#clear_worshipper_rituals">clear_worshipper_rituals</a>(string)<br/>
Clear all worshippe rituals!
<li><a href="#delete_command">delete_command</a>(string, string)<br/>
This method deletes a command to be given to the priests.
<li><a href="#delete_creator_set_data">delete_creator_set_data</a>(string, string)<li><a href="#delete_excommunicated">delete_excommunicated</a>(string, string)<br/>
This method reinstates a priest or worshipper to the church, from the list of excommunicated players
<li><a href="#delete_faith_rod">delete_faith_rod</a>(string, string)<br/>
This method deletes a faith rod from the deity.
<li><a href="#delete_highpriest_ability">delete_highpriest_ability</a>(string, string)<br/>
This method removes an ability from the list which is given to high
priests of the deity.
<li><a href="#delete_highpriest_command">delete_highpriest_command</a>(string, string)<br/>
This method deletes a command from the set of commands high
priests can learn.
<li><a href="#delete_highpriest_prayer">delete_highpriest_prayer</a>(string, string)<br/>
This method removes a ritual from the list which is given to high
preists of the deity.
<li><a href="#delete_player_set_data">delete_player_set_data</a>(string, string)<li><a href="#delete_prayer">delete_prayer</a>(string, string)<li><a href="#delete_priest">delete_priest</a>(string, string)<br/>
This method removes a priest fromt he clergy.
<li><a href="#delete_ritual">delete_ritual</a>(string, string)<br/>
This method deletes a ritual from the deity.
<li><a href="#delete_worshipper">delete_worshipper</a>(string, string)<br/>
This method deletes the given non-priest worshipper.
<li><a href="#delete_worshipper_ritual">delete_worshipper_ritual</a>(string, string)<br/>
This method deletes a ritual from the deity.
<li><a href="#dismiss_position">dismiss_position</a>(string, string, string)<br/>
This method dismiss a player from a position in the guild.
<li><a href="#elect_high_priest">elect_high_priest</a>(string)<br/>
This method starts an election and clears the high priest.
<li><a href="#end_election">end_election</a>(string)<br/>
This method finishes off the election and elects the new high priest.
<li><a href="#get_random_faith_rod">get_random_faith_rod</a>(string, int, int)<br/>
This method returns the path of a randomly selected faith rod that deity
may use.
<li><a href="#initiate_schism">initiate_schism</a>(string, string)<br/>
This method starts voting for a schism but keeps the high priest the same.
<li><a href="#is_allowed_to_be_minister">is_allowed_to_be_minister</a>(string)<br/>
This method is here to check the 'minister' titles to make sure
the people who have them are allowed to have them.
<li><a href="#is_high_priest">is_high_priest</a>(string)<br/>
This method checks to see if the player is a high priest.
<li><a href="#query_aka">query_aka</a>(string)<br/>
This method queries an alternate deity as the recipent for points
and such.
<li><a href="#query_al_lower">query_al_lower</a>(string)<br/>
This method returns the lower alignment limit for the
given deity.
<li><a href="#query_al_middle">query_al_middle</a>(string)<br/>
This method returns the middle alignment for the
given deity.
<li><a href="#query_al_upper">query_al_upper</a>(string)<br/>
This method returns the upper alignment limit for the
given deity.
<li><a href="#query_all_creator_set_data">query_all_creator_set_data</a>(string)<li><a href="#query_all_player_set_data">query_all_player_set_data</a>(string)<li><a href="#query_commands">query_commands</a>(string)<br/>
Thie method queries the commands given to priests.
<li><a href="#query_creator_set_data">query_creator_set_data</a>(string, string)<li><a href="#query_current_deities">query_current_deities</a>()<br/>
This method is the returns the current list of available deities.
<li><a href="#query_current_nationality_deities">query_current_nationality_deities</a>(string)<br/>
This method returns the list of deities from a certain location.
<li><a href="#query_deity">query_deity</a>(string)<br/>
This method tells us if the deity exists.
<li><a href="#query_deity_cap_name">query_deity_cap_name</a>(string)<li><a href="#query_deity_finger">query_deity_finger</a>(string)<br/>
This method returns the string used when fingering a deity.
<li><a href="#query_deity_nationalities">query_deity_nationalities</a>()<br/>
This method returns the list of nationalities currently noted
against deities.
<li><a href="#query_deity_short">query_deity_short</a>(string, int)<li><a href="#query_distance_rating">query_distance_rating</a>(string)<li><a href="#query_election">query_election</a>(string)<br/>
This method queries the current election statistics.
<li><a href="#query_election_status">query_election_status</a>(string)<br/>
This method tells us what state the election is in.
<li><a href="#query_excommunicated">query_excommunicated</a>(string, string)<br/>
This method checks to see if the player has been excommunicated from the given deity
<li><a href="#query_excommunicateds">query_excommunicateds</a>(string)<br/>
This method returns the names of everyone excommunicated from a priesthood.
<li><a href="#query_excommunication_reason">query_excommunication_reason</a>(string, string)<br/>
This method returns the given reason for a player's excommunication
<li><a href="#query_extra_finger_info">query_extra_finger_info</a>(string)<li><a href="#query_faith_rods">query_faith_rods</a>(string)<li><a href="#query_favour_rating">query_favour_rating</a>(string)<li><a href="#query_gender">query_gender</a>(string)<br/>
This method returns the gender of the deity.
<li><a href="#query_high_priest">query_high_priest</a>(string)<br/>
This method returns the current high priest for the deity.
<li><a href="#query_highpriest_commands">query_highpriest_commands</a>(string)<br/>
This method queries the commands given to the high priests.
<li><a href="#query_highpriest_prayers">query_highpriest_prayers</a>(string)<br/>
This method queries the rituals given by this deity to high preists.
<li><a href="#query_info">query_info</a>(string)<br/>
This method returns information about the deity.
<li><a href="#query_last_high_priest">query_last_high_priest</a>(string)<br/>
This method returns the former high priest for the deity, until a new one
is elected.
<li><a href="#query_max_points">query_max_points</a>(string)<br/>
This method returns the maximum number of points associated with the
deity.
<li><a href="#query_nationality">query_nationality</a>(string)<br/>
This method returns the deity's nationality.
<li><a href="#query_objective">query_objective</a>(string)<br/>
This method returns the objective for the deity.
<li><a href="#query_player_ability">query_player_ability</a>(string, string, string)<br/>
This method returns whether a player has a specific ability.
<li><a href="#query_player_position">query_player_position</a>(string, string)<br/>
This method returns the position help by a player.
<li><a href="#query_player_set_data">query_player_set_data</a>(string, string)<li><a href="#query_points">query_points</a>(string)<br/>
This method returns the number of points associated with the
deity.
<li><a href="#query_position">query_position</a>(string, string)<br/>
This method returns the appointments for a position.
<li><a href="#query_position_abilities">query_position_abilities</a>(string, string)<br/>
This method returns the abilities for a position.
<li><a href="#query_position_appointments">query_position_appointments</a>(string, string)<br/>
This method returns the appointments for a position.
<li><a href="#query_positions">query_positions</a>(string)<br/>
This method returns all positions for this guild.
<li><a href="#query_possessive">query_possessive</a>(string)<br/>
This method returns the possessive for the deity.
<li><a href="#query_prayers">query_prayers</a>(string, string)<li><a href="#query_priest">query_priest</a>(string, string)<br/>
This method checks to see if the player is a priest of the given
deity.
<li><a href="#query_priest_rating">query_priest_rating</a>(string, string)<br/>
This method returns the current rating for the priest.
<li><a href="#query_priesthood">query_priesthood</a>(string)<br/>
This method returns the current ratings mapping for the deity.
<li><a href="#query_priests">query_priests</a>(string)<br/>
This method returns the names of everyone in the priesthood.
<li><a href="#query_pronoun">query_pronoun</a>(string)<br/>
This method returns the pronoun for the deity.
<li><a href="#query_rating">query_rating</a>(string)<br/>
This method returns the rating for the deity.
<li><a href="#query_rituals">query_rituals</a>(string)<br/>
This method queries the rituals given by this deity.
<li><a href="#query_schism">query_schism</a>(string)<br/>
This method queries the current schisms statistics.
<li><a href="#query_short">query_short</a>()<li><a href="#query_title">query_title</a>(string)<br/>
This method returns the title for the deity.
<li><a href="#query_title_type">query_title_type</a>(string)<br/>
This method returns the title type for the deity.
<li><a href="#query_totem_chats">query_totem_chats</a>(string)<br/>
This method returns the chats of the deities totem figure.
<li><a href="#query_totem_description">query_totem_description</a>(string)<br/>
This method returns the description of the deities totem figure.
<li><a href="#query_valid_al">query_valid_al</a>(string, int, int)<br/>
This method determines if the alignment is valid for the deity.
<li><a href="#query_voted">query_voted</a>(string)<br/>
This method returns a list of the priests who have voted for the
the high priests.
<li><a href="#query_want_priests">query_want_priests</a>(string)<br/>
This method tells us if the deity wants priests or not.
<li><a href="#query_want_worshippers">query_want_worshippers</a>(string)<br/>
This method tells us if the deity wants worshippers or not.
<li><a href="#query_worshipper">query_worshipper</a>(string, string)<br/>
This method returns the information associated with the
non-priest worshipper.
<li><a href="#query_worshipper_quests">query_worshipper_quests</a>(string)<br/>
This method queries the list of worshipper quests.
<li><a href="#query_worshipper_rituals">query_worshipper_rituals</a>(string)<li><a href="#query_worshippers">query_worshippers</a>(string)<br/>
This method queries the mapping of non-priest worshippers.
<li><a href="#random_al">random_al</a>(string)<br/>
This method returns a random alignment between the limits for the
given deity.
<li><a href="#recheck_worshipper">recheck_worshipper</a>(string)<br/>
This method figures out the number of rituals the worshipper
should know based on the number of quests they have done.
<li><a href="#remove_high_priest">remove_high_priest</a>(string, string)<br/>
This method is a generic form of removing the incumbent high priest
through some external means (they have died, resigned, become inactive,
etc).
<li><a href="#remove_position">remove_position</a>(string, string)<br/>
This method removes a position for the guild.
<li><a href="#reset_positions">reset_positions</a>(string)<br/>
This method removes all appointments for a guild.
<li><a href="#schism_stand">schism_stand</a>(string, string)<li><a href="#schism_support">schism_support</a>(string, string, string)<li><a href="#schism_withdraw">schism_withdraw</a>(string, string)<li><a href="#set_aka">set_aka</a>(string, string)<br/>
This method sets an alternate deity as the recipent for points
and such.
<li><a href="#set_al_lower">set_al_lower</a>(string, int)<br/>
This method sets the lower alignment limit for the
given deity.
<li><a href="#set_al_upper">set_al_upper</a>(string, int)<br/>
This method sets the upper alignment limit for the
given deity.
<li><a href="#set_creator_set_data">set_creator_set_data</a>(string, string, mixed)<li><a href="#set_extra_finger_info">set_extra_finger_info</a>(string, mixed)<li><a href="#set_gender">set_gender</a>(string, int)<br/>
This method sets the gender of the deity.
<li><a href="#set_high_priest">set_high_priest</a>(string, string)<br/>
This method sets the current high priest for the deity.
<li><a href="#set_info">set_info</a>(string, string)<br/>
This method sets information about the deity.
<li><a href="#set_nationality">set_nationality</a>(string, string)<br/>
This method sets the deity's nationality.
<li><a href="#set_player_set_data">set_player_set_data</a>(string, string, mixed)<li><a href="#set_points">set_points</a>(string, int)<br/>
This method sets the number of points associated with the
deity.
<li><a href="#set_rating">set_rating</a>(string, int)<br/>
This method sets the rating for the deity.
<li><a href="#set_short">set_short</a>(string)<li><a href="#set_title">set_title</a>(string, string, int)<br/>
This method sets the title for the deity.
<li><a href="#set_totem_chats">set_totem_chats</a>(string, mixed *)<br/>
This method sets the chats of the deities totem figure.
<li><a href="#set_totem_description">set_totem_description</a>(string, string, string, string, string, mixed)<br/>
This method sets the description of the deities totem figure.
<li><a href="#set_vote">set_vote</a>(string, string, string)<br/>
This method sets the current vote for the priest to the given
candidate.
<li><a href="#set_want_priests">set_want_priests</a>(string, int)<br/>
This method sets if the deity wants priests or not.
<li><a href="#set_want_worshippers">set_want_worshippers</a>(string, int)<br/>
This method sets if the deity wants worshippers or not.
<li><a href="#set_worshipper">set_worshipper</a>(string, string, int)<br/>
This method sets the information associated with the
non-priest worshipper.
<li><a href="#set_worshipper_quests">set_worshipper_quests</a>(string, mixed *)<br/>
This method sets the list of worshipper quests.
<li><a href="#set_worshippers">set_worshippers</a>(string, mapping)<br/>
This method sets the mapping of non-priest worshippers.
<li><a href="#valid_high_priest">valid_high_priest</a>(string)<br/>
This method checks to see if the high priest is valid.
<li><a href="#valid_priest">valid_priest</a>(string)<br/>
This method checks to see if the priest is valid.
<li><a href="#valid_worshipper">valid_worshipper</a>(string)<br/>
This method checks to see if the worshipper is valid.
<li><a href="#withdraw_candidate">withdraw_candidate</a>(string, string)<br/>
This method withdraws a candidate from the high priest election.
</ul>
<h2>Public Functions</h2>
These are functions that everyone can access.<p>
<dl>
<dt class="autodocfuncname"><a name="add_command">
add_command</a><pre class="autodocfuncdef">
int add_command(string word1,
                string word2,
                int number)
</pre><dd><br />
This method adds a command to be given to the priests.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the deity to add the commands for<br />
word2 - the name of the command<br />
number - the level at which it is to be taught<br />
<br />
<dd><b>Returns:</b>
<br />1 if success, 0 if not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_excommunicated">
add_excommunicated</a><pre class="autodocfuncdef">
int add_excommunicated(string deity,
                       string who,
                       string reason)
</pre><dd><br />
This method adds a priest or worshipper to the list of excommunicated players and posts a message to the board<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the deity<br />
who - the player name to add<br />
the - reason given for excommunicating them<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_FAIL if the player has already been excommunicated or does
not belong to the church, DEITY_OK if not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_faith_rod">
add_faith_rod</a><pre class="autodocfuncdef">
int add_faith_rod(string deity,
                  string name,
                  string path,
                  int chance,
                  int unique)
</pre><dd><br />
This method adds a faith rod to the set used by the deity.
<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the name of the deity<br />
name - the name of the rod to add<br />
path - the file name of the rod<br />
chance - the relative commonness of the rod<br />
unique - whether the rod should be handed out as a matter of course
<br />
<br />
<dd><b>Returns:</b>
<br />always returns 1
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_highpriest_ability">
add_highpriest_ability</a><pre class="autodocfuncdef">
int add_highpriest_ability(string deity,
                           string ability)
</pre><dd><br />
This method adds an ability to the set given by the deity to high priests.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the name of the deity<br />
ability - the ability to add<br />
<br />
<dd><b>Returns:</b>
<br />always returns 1
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_highpriest_command">
add_highpriest_command</a><pre class="autodocfuncdef">
int add_highpriest_command(string word1,
                           string word2,
                           int number)
</pre><dd><br />
This method adds a command into the set of commands that high priests
learn.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the deity to add the commands for<br />
word2 - the name of the command to add<br />
number - the level at which it will be taught<br />
<br />
<dd><b>Returns:</b>
<br />1 if it was successful, 0 if it was not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_highpriest_prayer">
add_highpriest_prayer</a><pre class="autodocfuncdef">
int add_highpriest_prayer(string word1,
                          string word2,
                          string word3,
                          int number,
                          string word4)
</pre><dd><br />
This method adds a ritual to the set given by the deity to high priests.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deith<br />
word2 - the name ritual to add<br />
word3 - the file name of the ritual<br />
number - the level to teach the ritual at<br />
word4 - the skill to check for the level<br />
<br />
<dd><b>Returns:</b>
<br />always returns 1
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_position">
add_position</a><pre class="autodocfuncdef">
int add_position(string deity_name,
                 string position,
                 int max,
                 string * abilities)
</pre><dd><br />
This method adds a new position for the guild.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
position - position to add<br />
max - the maximum number of people appointed to this position<br />
abilities - the abilities assiciated with this position<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_POSITION_OK if successful, DEITY_POSITION_FAIL if the
position already exists<br /><br />
<dd><b>See also:</b>
<br /><a href="#remove_position">remove_position()</a>, <a href="#query_position">query_position()</a> and <a href="#query_positions">query_positions()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="add_prayer">
add_prayer</a><pre class="autodocfuncdef">
void add_prayer(string deity,
                string name)
</pre>
<dt class="autodocfuncname"><a name="add_priest">
add_priest</a><pre class="autodocfuncdef">
int add_priest(string word1,
               string word2)
</pre><dd><br />
This method adds a priest to the deity<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the deity<br />
word2 - the player name to add<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_FAIL if the player already exists, DEITY_OK if not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_ritual">
add_ritual</a><pre class="autodocfuncdef">
int add_ritual(string word1,
               string word2,
               string word3,
               int number,
               string word4)
</pre><dd><br />
This method adds a ritual to the set given by the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deith<br />
word2 - the name ritual to add<br />
word3 - the file name of the ritual<br />
number - the level to teach the ritual at<br />
word4 - the skill to check for the level<br />
<br />
<dd><b>Returns:</b>
<br />always returns 1
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_worshipper">
add_worshipper</a><pre class="autodocfuncdef">
void add_worshipper(string deity_name,
                    string word2,
                    int number)
</pre><dd><br />
This method adds the information associated with the
non-priest worshipper.  This corresponds to the number of
rituals learnable.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity<br />
word2 - the non-priest whorshipper to check<br />
number - the number of extra rituals to learn
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#set_worshipper">set_worshipper()</a>, <a href="#delete_worshipper">delete_worshipper()</a> and <a href="#query_worshipper">query_worshipper()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="add_worshipper_ritual">
add_worshipper_ritual</a><pre class="autodocfuncdef">
int add_worshipper_ritual(string word1,
                          string word2,
                          string word3,
                          int number,
                          string word4)
</pre><dd><br />
Add a worshipper ritual!
<br />

<dt class="autodocfuncname"><a name="adjust_points">
adjust_points</a><pre class="autodocfuncdef">
int adjust_points(string deity_name,
                  int number,
                  mixed who,
                  string type)
</pre><dd><br />
This method adjusts the number of points associated with the
deity.  The points are a measure of the total amount prayer that
has been directed to the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to adjust the points for<br />
number - the amount to adjust the points by<br />
who - the player who altered the points<br />
type - the method by which the points where altered
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="adjust_priest_rating">
adjust_priest_rating</a><pre class="autodocfuncdef">
int adjust_priest_rating(string word1,
                         string word2,
                         int number1,
                         int number2)
</pre><dd><br />
This method adjusts the rating for the priest.  The rating is calculate
as min(max((number1 + old_rating), 0), (2 * number2)).<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the dieyt<br />
word2 - the priest<br />
number1 - the number1 as defined above<br />
number2 - the number2 as defined above<br />
<br />
<dd><b>Returns:</b>
<br />the new rating
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="adjust_rating">
adjust_rating</a><pre class="autodocfuncdef">
void adjust_rating(string deity_name,
                   int number)
</pre><dd><br />
This method adjusts the rating for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of deity to adjust the rating for<br />
number - the amount to change the rating by
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="align_string">
align_string</a><pre class="autodocfuncdef">
string align_string(int alignment)
</pre><dd><br />
This method gives a string represtentation of the the
alignment level.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
alignment - the alignment to return<br />
<br />
<dd><b>Returns:</b>
<br />the string name fo the alignment
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="appoint_position">
appoint_position</a><pre class="autodocfuncdef">
int appoint_position(string deity_name,
                     string position,
                     string player)
</pre><dd><br />
This method appoints a player to a position in the guild.
If the player is already appointed to some other position, that
position's lost.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
position - position to appoint player to<br />
player - player to appoint<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_POSITION_OK if successful, DEITY_POSITION_TOO_MANY if the
position is filled, DEITY_POSITION_ALREADY_APPOINTED if that player
already holds that position, DEITY_POSITION_FAIL if the position doesn't
exist<br>
NB!  There's NO check for the player being a priest, a follower, or
even a player<br /><br />
<dd><b>See also:</b>
<br /><a href="#dismiss_position">dismiss_position()</a> and <a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="challenge_high_priest">
challenge_high_priest</a><pre class="autodocfuncdef">
void challenge_high_priest(string deity)
</pre><dd><br />
This method starts voting for a schism, retaining the current high priest.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the deity
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="check_deity">
check_deity</a><pre class="autodocfuncdef">
void check_deity(string deity,
                 int next_time)
</pre>
<dt class="autodocfuncname"><a name="clear_ritual">
clear_ritual</a><pre class="autodocfuncdef">
int clear_ritual(string deity)
</pre>
<dt class="autodocfuncname"><a name="clear_worshipper_rituals">
clear_worshipper_rituals</a><pre class="autodocfuncdef">
int clear_worshipper_rituals(string deity)
</pre><dd><br />
Clear all worshippe rituals!
<br />

<dt class="autodocfuncname"><a name="delete_command">
delete_command</a><pre class="autodocfuncdef">
int delete_command(string word1,
                   string word2)
</pre><dd><br />
This method deletes a command to be given to the priests.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deity<br />
word2 - the name of the command to delete<br />
<br />
<dd><b>Returns:</b>
<br />1 if success, 0 if not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="delete_creator_set_data">
delete_creator_set_data</a><pre class="autodocfuncdef">
void delete_creator_set_data(string deity,
                             string key)
</pre>
<dt class="autodocfuncname"><a name="delete_excommunicated">
delete_excommunicated</a><pre class="autodocfuncdef">
int delete_excommunicated(string deity,
                          string who)
</pre><dd><br />
This method reinstates a priest or worshipper to the church, from the list of excommunicated players<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the deity<br />
who - the player name to add<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_FAIL if the player has not been excommunicated, DEITY_OK if they have and were recommunicated
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="delete_faith_rod">
delete_faith_rod</a><pre class="autodocfuncdef">
int delete_faith_rod(string deity,
                     string name)
</pre><dd><br />
This method deletes a faith rod from the deity.
<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the name of the deity<br />
name - the rod to delete
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="delete_highpriest_ability">
delete_highpriest_ability</a><pre class="autodocfuncdef">
int delete_highpriest_ability(string deity,
                              string ability)
</pre><dd><br />
This method removes an ability from the list which is given to high
priests of the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deity<br />
word2 - the name of the ability
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="delete_highpriest_command">
delete_highpriest_command</a><pre class="autodocfuncdef">
int delete_highpriest_command(string word1,
                              string word2)
</pre><dd><br />
This method deletes a command from the set of commands high
priests can learn.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deity<br />
word2 - the name of the command to delete<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_OK if it was successful, DEITY_FAIL if it was not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="delete_highpriest_prayer">
delete_highpriest_prayer</a><pre class="autodocfuncdef">
int delete_highpriest_prayer(string word1,
                             string word2)
</pre><dd><br />
This method removes a ritual from the list which is given to high
preists of the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deity<br />
word2 - the name of the ritual
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="delete_player_set_data">
delete_player_set_data</a><pre class="autodocfuncdef">
void delete_player_set_data(string deity,
                            string key)
</pre>
<dt class="autodocfuncname"><a name="delete_prayer">
delete_prayer</a><pre class="autodocfuncdef">
void delete_prayer(string deity,
                   string name)
</pre>
<dt class="autodocfuncname"><a name="delete_priest">
delete_priest</a><pre class="autodocfuncdef">
int delete_priest(string deity,
                  string who)
</pre><dd><br />
This method removes a priest fromt he clergy.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the deity<br />
who - the player to delete<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_OK if successful, DEITY_FAIL if not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="delete_ritual">
delete_ritual</a><pre class="autodocfuncdef">
int delete_ritual(string word1,
                  string word2)
</pre><dd><br />
This method deletes a ritual from the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deity<br />
word2 - the ritual to delete
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="delete_worshipper">
delete_worshipper</a><pre class="autodocfuncdef">
int delete_worshipper(string deity,
                      string who)
</pre><dd><br />
This method deletes the given non-priest worshipper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the name of the deity<br />
who - the non-priest whorshipper to delete<br />
<br />
<dd><b>Returns:</b>
<br />1 if the operation was successful, 0 if it failed
<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_worshipper">add_worshipper()</a>, <a href="#set_worshipper">set_worshipper()</a> and <a href="#query_worshipper">query_worshipper()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="delete_worshipper_ritual">
delete_worshipper_ritual</a><pre class="autodocfuncdef">
int delete_worshipper_ritual(string word1,
                             string word2)
</pre><dd><br />
This method deletes a ritual from the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deity<br />
word2 - the ritual to delete
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="dismiss_position">
dismiss_position</a><pre class="autodocfuncdef">
int dismiss_position(string deity_name,
                     string position,
                     string player)
</pre><dd><br />
This method dismiss a player from a position in the guild.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
position - position to appoint player to<br />
player - player to appoint<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_POSITION_OK if successful, DEITY_POSITION_FAIL if the
player didn't have that position.<br /><br />
<dd><b>See also:</b>
<br /><a href="#appoint_position">appoint_position()</a> and <a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="elect_high_priest">
elect_high_priest</a><pre class="autodocfuncdef">
void elect_high_priest(string word)
</pre><dd><br />
This method starts an election and clears the high priest.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the deity
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="end_election">
end_election</a><pre class="autodocfuncdef">
void end_election(string word)
</pre><dd><br />
This method finishes off the election and elects the new high priest.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the deity
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="get_random_faith_rod">
get_random_faith_rod</a><pre class="autodocfuncdef">
string get_random_faith_rod(string deity,
                            int chance_generic,
                            int allow_unique)
</pre><dd><br />
This method returns the path of a randomly selected faith rod that deity
may use.
<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the name of the deity<br />
name - the rod to delete
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="initiate_schism">
initiate_schism</a><pre class="autodocfuncdef">
void initiate_schism(string deity,
                     string bringer)
</pre><dd><br />
This method starts voting for a schism but keeps the high priest the same.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the deity
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="is_allowed_to_be_minister">
is_allowed_to_be_minister</a><pre class="autodocfuncdef">
int is_allowed_to_be_minister(string player)
</pre><dd><br />
This method is here to check the 'minister' titles to make sure
the people who have them are allowed to have them.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
player - the player name to check
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="is_high_priest">
is_high_priest</a><pre class="autodocfuncdef">
int is_high_priest(string player)
</pre><dd><br />
This method checks to see if the player is a high priest.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
player - the player name to check
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_aka">
query_aka</a><pre class="autodocfuncdef">
string query_aka(string deity_name)
</pre><dd><br />
This method queries an alternate deity as the recipent for points
and such.  (Like the Tsortian God of Thunder is really Blind Io,
with a false beard and another hammer).<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to get the aka for<br />
<br />
<dd><b>Returns:</b>
<br />the aka for the deity
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_al_lower">
query_al_lower</a><pre class="autodocfuncdef">
int query_al_lower(string deity_name)
</pre><dd><br />
This method returns the lower alignment limit for the
given deity.  Note that that's the limit to how good the
deity accepts followers.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to query<br />
<br />
<dd><b>Returns:</b>
<br />the lower alignment limit
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_al_middle">
query_al_middle</a><pre class="autodocfuncdef">
int query_al_middle(string deity_name)
</pre><dd><br />
This method returns the middle alignment for the
given deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to query<br />
<br />
<dd><b>Returns:</b>
<br />the middle alignment value
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_al_upper">
query_al_upper</a><pre class="autodocfuncdef">
int query_al_upper(string deity_name)
</pre><dd><br />
This method returns the upper alignment limit for the
given deity.  Note that that's the limit to how evil the
deity accepts followers.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to query<br />
<br />
<dd><b>Returns:</b>
<br />the upper alignment limit
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_all_creator_set_data">
query_all_creator_set_data</a><pre class="autodocfuncdef">
mapping query_all_creator_set_data(string deity)
</pre>
<dt class="autodocfuncname"><a name="query_all_player_set_data">
query_all_player_set_data</a><pre class="autodocfuncdef">
mapping query_all_player_set_data(string deity)
</pre>
<dt class="autodocfuncname"><a name="query_commands">
query_commands</a><pre class="autodocfuncdef">
mapping query_commands(string word)
</pre><dd><br />
Thie method queries the commands given to priests.  The keys of the
mapping are the commands given and the value associated with the
key is the level at which it is taught.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the deity to get the commands for<br />
<br />
<dd><b>Returns:</b>
<br />the commands mapping
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_creator_set_data">
query_creator_set_data</a><pre class="autodocfuncdef">
mixed query_creator_set_data(string deity,
                             string key)
</pre>
<dt class="autodocfuncname"><a name="query_current_deities">
query_current_deities</a><pre class="autodocfuncdef">
string * query_current_deities()
</pre><dd><br />
This method is the returns the current list of available deities.<br />
<br /><dl>
<dd><b>Returns:</b>
<br />the available deity names
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_current_nationality_deities">
query_current_nationality_deities</a><pre class="autodocfuncdef">
string * query_current_nationality_deities(string nationality)
</pre><dd><br />
This method returns the list of deities from a certain location.<br />
<br /><dl>
<dd><b>Returns:</b>
<br />the deity names from the nationality
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_deity">
query_deity</a><pre class="autodocfuncdef">
int query_deity(string deity_name)
</pre><dd><br />
This method tells us if the deity exists.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to check<br />
<br />
<dd><b>Returns:</b>
<br />1 if the deity exists, 0 if not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_deity_cap_name">
query_deity_cap_name</a><pre class="autodocfuncdef">
string query_deity_cap_name(string deity_name)
</pre>
<dt class="autodocfuncname"><a name="query_deity_finger">
query_deity_finger</a><pre class="autodocfuncdef">
string query_deity_finger(string deity_name)
</pre><dd><br />
This method returns the string used when fingering a deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to finger<br />
<br />
<dd><b>Returns:</b>
<br />the information relating to the deity
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_deity_nationalities">
query_deity_nationalities</a><pre class="autodocfuncdef">
string * query_deity_nationalities()
</pre><dd><br />
This method returns the list of nationalities currently noted
against deities.<br />
<br /><dl>
<dd><b>Returns:</b>
<br />the list of current nationalities
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_deity_short">
query_deity_short</a><pre class="autodocfuncdef">
varargs string query_deity_short(string deity_name,
                                 int mid_sentence)
</pre>
<dt class="autodocfuncname"><a name="query_distance_rating">
query_distance_rating</a><pre class="autodocfuncdef">
float query_distance_rating(string name)
</pre>
<dt class="autodocfuncname"><a name="query_election">
query_election</a><pre class="autodocfuncdef">
mapping query_election(string word)
</pre><dd><br />
This method queries the current election statistics.  The keys of
mapping are the list of candiates and the values are the number of
votes collected for them so far.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the name of the deity to check<br />
<br />
<dd><b>Returns:</b>
<br />the election mapping
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_election_status">
query_election_status</a><pre class="autodocfuncdef">
int query_election_status(string deity)
</pre><dd><br />
This method tells us what state the election is in.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the name of the deity to check<br />
<br />
<dd><b>Returns:</b>
<br />the election status
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_excommunicated">
query_excommunicated</a><pre class="autodocfuncdef">
int query_excommunicated(string deity,
                         string who)
</pre><dd><br />
This method checks to see if the player has been excommunicated from the given deity<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the deity to test<br />
who - the player name to check<br />
<br />
<dd><b>Returns:</b>
<br />1 if the player is excommunicated, 0 if not.
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_excommunicateds">
query_excommunicateds</a><pre class="autodocfuncdef">
string * query_excommunicateds(string deity)
</pre><dd><br />
This method returns the names of everyone excommunicated from a priesthood.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the deity to get the excommunicated for<br />
<br />
<dd><b>Returns:</b>
<br />the string array of excommunicated priests and worshippers
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_excommunication_reason">
query_excommunication_reason</a><pre class="autodocfuncdef">
string query_excommunication_reason(string deity,
                                    string who)
</pre><dd><br />
This method returns the given reason for a player's excommunication<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the deity to test<br />
who - the player name to check<br />
<br />
<dd><b>Returns:</b>
<br />the reason for excommunication
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_extra_finger_info">
query_extra_finger_info</a><pre class="autodocfuncdef">
void query_extra_finger_info(string deity)
</pre>
<dt class="autodocfuncname"><a name="query_faith_rods">
query_faith_rods</a><pre class="autodocfuncdef">
mapping query_faith_rods(string deity)
</pre>
<dt class="autodocfuncname"><a name="query_favour_rating">
query_favour_rating</a><pre class="autodocfuncdef">
float query_favour_rating(string name)
</pre>
<dt class="autodocfuncname"><a name="query_gender">
query_gender</a><pre class="autodocfuncdef">
int query_gender(string deity_name)
</pre><dd><br />
This method returns the gender of the deity.  The gender is the same
as used elsehwere in the game.  0 for neuter, 1 for male and 2 for female.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity name<br />
<br />
<dd><b>Returns:</b>
<br />the gender of the deity
<br /><br />
<dd><b>See also:</b>
<br />/std/living/gender.c and <a href="#set_gender">set_gender()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_high_priest">
query_high_priest</a><pre class="autodocfuncdef">
string query_high_priest(string deity_name)
</pre><dd><br />
This method returns the current high priest for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the high priest for<br />
<br />
<dd><b>Returns:</b>
<br />the name of the high priest
<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_high_priest">set_high_priest()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_highpriest_commands">
query_highpriest_commands</a><pre class="autodocfuncdef">
mapping query_highpriest_commands(string word)
</pre><dd><br />
This method queries the commands given to the high priests.  the
keys of the mapping are the commands to be taught and the value
of the mapping is the level at which they will be taught.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the name of the deity<br />
<br />
<dd><b>Returns:</b>
<br />the high priest mapping<br /><br />
<dd><b>See also:</b>
<br /><a href="#query_priest_commands">query_priest_commands()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_highpriest_prayers">
query_highpriest_prayers</a><pre class="autodocfuncdef">
mapping query_highpriest_prayers(string word)
</pre><dd><br />
This method queries the rituals given by this deity to high preists.  The
keys of the
mapping is the name of the ritual, the values is an array.  The
array is 3 elements long, the first is the file name associated
with the ritual, the second is the level at which the ritual will
be taught and the third is the skill to check for the level.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the deity to get the prayers for<br />
<br />
<dd><b>Returns:</b>
<br />the rituals mapping
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_info">
query_info</a><pre class="autodocfuncdef">
string query_info(string deity_name)
</pre><dd><br />
This method returns information about the deity.  This is used
in the finger information and when querying about joining the
priesthood.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get information on<br />
<br />
<dd><b>Returns:</b>
<br />information about the deity
<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_info">set_info()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_last_high_priest">
query_last_high_priest</a><pre class="autodocfuncdef">
string query_last_high_priest(string deity_name)
</pre><dd><br />
This method returns the former high priest for the deity, until a new one
is elected.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the high priest for<br />
<br />
<dd><b>Returns:</b>
<br />the name of the high priest
<br /><br />
<dd><b>See also:</b>
<br /><a href="#set__high_priest">set__high_priest()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_max_points">
query_max_points</a><pre class="autodocfuncdef">
int query_max_points(string deity_name)
</pre><dd><br />
This method returns the maximum number of points associated with the
deity.  This limit is increased by having more followers.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the points for<br />
<br />
<dd><b>Returns:</b>
<br />the number of points for the deity.
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_nationality">
query_nationality</a><pre class="autodocfuncdef">
string query_nationality(string deity_name)
</pre><dd><br />
This method returns the deity's nationality.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get information on<br />
<br />
<dd><b>Returns:</b>
<br />deity's nationality, or 0 if non-specific
<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_nationality">set_nationality()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_objective">
query_objective</a><pre class="autodocfuncdef">
string query_objective(string deity_name)
</pre><dd><br />
This method returns the objective for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the objective of<br />
<br />
<dd><b>Returns:</b>
<br />the objective of the deity
<br /><br />
<dd><b>See also:</b>
<br /><a href="std.living.gender.c.shtml#query_objective">/std/living/gender->query_objective()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_player_ability">
query_player_ability</a><pre class="autodocfuncdef">
int query_player_ability(string deity_name,
                         string player,
                         string ability)
</pre><dd><br />
This method returns whether a player has a specific ability.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
player - the name of the player<br />
ability - the ability to test for:)<br />
<br />
<dd><b>Returns:</b>
<br />0 if that player don't have that ability, 1 if he does<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_player_position">
query_player_position</a><pre class="autodocfuncdef">
string query_player_position(string deity_name,
                             string player)
</pre><dd><br />
This method returns the position help by a player.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
player - whose position should be returned<br />
<br />
<dd><b>Returns:</b>
<br />the position help or 0 if the player doesn't hold one<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_player_set_data">
query_player_set_data</a><pre class="autodocfuncdef">
mixed query_player_set_data(string deity,
                            string key)
</pre>
<dt class="autodocfuncname"><a name="query_points">
query_points</a><pre class="autodocfuncdef">
int query_points(string deity_name)
</pre><dd><br />
This method returns the number of points associated with the
deity.  The points are a measure of the total amount prayer that
has been directed to the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the points for<br />
<br />
<dd><b>Returns:</b>
<br />the number of points for the deity.
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_position">
query_position</a><pre class="autodocfuncdef">
string * query_position(string deity_name,
                        string position)
</pre><dd><br />
This method returns the appointments for a position.
You should really use query_position_appointments() instead<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
position - position to return<br />
<br />
<dd><b>Returns:</b>
<br />0 if the position don't exist, an array of appointments
if is does, with 0's for unfilled positions<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_position_abilities">
query_position_abilities</a><pre class="autodocfuncdef">
string * query_position_abilities(string deity_name,
                                  string position)
</pre><dd><br />
This method returns the abilities for a position.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
position - position to return<br />
<br />
<dd><b>Returns:</b>
<br />0 if the position don't exist, an array of appointments
if is does, with 0's for unfilled positions<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_position_appointments">
query_position_appointments</a><pre class="autodocfuncdef">
string * query_position_appointments(string deity_name,
                                     string position)
</pre><dd><br />
This method returns the appointments for a position.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
position - position to return<br />
<br />
<dd><b>Returns:</b>
<br />0 if the position don't exist, an array of appointments
if is does, with 0's for unfilled positions<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_positions">
query_positions</a><pre class="autodocfuncdef">
mapping query_positions(string deity_name)
</pre><dd><br />
This method returns all positions for this guild.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
<br />
<dd><b>Returns:</b>
<br />0 if the position don't exist, an array of appointments
if is does, with 0's for unfilled positions<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_possessive">
query_possessive</a><pre class="autodocfuncdef">
string query_possessive(string deity_name)
</pre><dd><br />
This method returns the possessive for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the possessive of<br />
<br />
<dd><b>Returns:</b>
<br />the possessive of the deity
<br /><br />
<dd><b>See also:</b>
<br /><a href="std.living.gender.c.shtml#query_possessive">/std/living/gender->query_possessive()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_prayers">
query_prayers</a><pre class="autodocfuncdef">
string * query_prayers(string deity,
                       string name)
</pre>
<dt class="autodocfuncname"><a name="query_priest">
query_priest</a><pre class="autodocfuncdef">
int query_priest(string word1,
                 string word2)
</pre><dd><br />
This method checks to see if the player is a priest of the given
deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the deity to test<br />
word2 - the player name to chec<br />
<br />
<dd><b>Returns:</b>
<br />1 if the player is a priest, 0 if not.
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_priest_rating">
query_priest_rating</a><pre class="autodocfuncdef">
int query_priest_rating(string word1,
                        string word2)
</pre><dd><br />
This method returns the current rating for the priest.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word1 - the deity<br />
word2 - the player name to get the rating of<br />
<br />
<dd><b>Returns:</b>
<br />the current rating
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_priesthood">
query_priesthood</a><pre class="autodocfuncdef">
mapping query_priesthood(string word)
</pre><dd><br />
This method returns the current ratings mapping for the deity.
The keys of the mapping are the names of the worshippers and
the values are their current ratings.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the name of the deity to query<br />
<br />
<dd><b>Returns:</b>
<br />the ratings mapping
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_priests">
query_priests</a><pre class="autodocfuncdef">
string * query_priests(string word)
</pre><dd><br />
This method returns the names of everyone in the priesthood.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the deity to get the preists for<br />
<br />
<dd><b>Returns:</b>
<br />the string array of priests
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_pronoun">
query_pronoun</a><pre class="autodocfuncdef">
string query_pronoun(string deity_name)
</pre><dd><br />
This method returns the pronoun for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the pronoun of<br />
<br />
<dd><b>Returns:</b>
<br />the pronoun of the deity
<br /><br />
<dd><b>See also:</b>
<br /><a href="std.living.gender.c.shtml#query_pronoun">/std/living/gender->query_pronoun()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_rating">
query_rating</a><pre class="autodocfuncdef">
int query_rating(string deity_name)
</pre><dd><br />
This method returns the rating for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of deity to get the rating for<br />
<br />
<dd><b>Returns:</b>
<br />the current rating
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_rituals">
query_rituals</a><pre class="autodocfuncdef">
mapping query_rituals(string word)
</pre><dd><br />
This method queries the rituals given by this deity.  The keys of the
mapping is the name of the ritual, the values is an array.  The
array is 3 elements long, the first is the file name associated
with the ritual, the second is the level at which the ritual will
be taught and the third is the skill to check for the level.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the deity to get the prayers for<br />
<br />
<dd><b>Returns:</b>
<br />the rituals mapping
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_schism">
query_schism</a><pre class="autodocfuncdef">
mapping query_schism(string word)
</pre><dd><br />
This method queries the current schisms statistics.  The keys of
mapping are the list of challengers and the values are the priests
who are supporting their bid.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
word - the name of the deity to check<br />
<br />
<dd><b>Returns:</b>
<br />the schism mapping
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_short">
query_short</a><pre class="autodocfuncdef">
string query_short()
</pre>
<dt class="autodocfuncname"><a name="query_title">
query_title</a><pre class="autodocfuncdef">
string query_title(string deity_name)
</pre><dd><br />
This method returns the title for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to get the title of<br />
<br />
<dd><b>Returns:</b>
<br />the title of the deity
<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_title">set_title()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_title_type">
query_title_type</a><pre class="autodocfuncdef">
int query_title_type(string deity_name)
</pre><dd><br />
This method returns the title type for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to get the title of<br />
<br />
<dd><b>Returns:</b>
<br />the title type of the deity: 0 for comma, 1 for no comma, 2 for a
pre-title
<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_title">set_title()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_totem_chats">
query_totem_chats</a><pre class="autodocfuncdef">
mixed * query_totem_chats(string deity_name)
</pre><dd><br />
This method returns the chats of the deities totem figure.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the chat for<br />
<br />
<dd><b>Returns:</b>
<br />the chats of the deities totem figure
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_totem_description">
query_totem_description</a><pre class="autodocfuncdef">
mixed * query_totem_description(string deity_name)
</pre><dd><br />
This method returns the description of the deities totem figure.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the description for<br />
<br />
<dd><b>Returns:</b>
<br />the description of the deities totem figure
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_valid_al">
query_valid_al</a><pre class="autodocfuncdef">
varargs int query_valid_al(string deity_name,
                           int number,
                           int imbue)
</pre><dd><br />
This method determines if the alignment is valid for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to check<br />
number - the alignment to check<br />
imbue - If the check is too see if someone can use an imbue, the align
restrictions are relaxed a bit.<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_ALIGN_OK if it is valid, DEITY_ALIGN_EVIL if too evil,
DEITY_ALIGN_GOOD if too good
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_voted">
query_voted</a><pre class="autodocfuncdef">
string * query_voted(string deity_name)
</pre><dd><br />
This method returns a list of the priests who have voted for the
the high priests.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to check<br />
<br />
<dd><b>Returns:</b>
<br />the array of the preist voted
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_want_priests">
query_want_priests</a><pre class="autodocfuncdef">
int query_want_priests(string deity_name)
</pre><dd><br />
This method tells us if the deity wants priests or not.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to check<br />
<br />
<dd><b>Returns:</b>
<br />1 if the deity wants priests, 0 if not
<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_want_priests">set_want_priests()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_want_worshippers">
query_want_worshippers</a><pre class="autodocfuncdef">
int query_want_worshippers(string deity_name)
</pre><dd><br />
This method tells us if the deity wants worshippers or not.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to check<br />
<br />
<dd><b>Returns:</b>
<br />1 if the deity wants worshippers, 0 if not
<br /><br />
<dd><b>See also:</b>
<br /><a href="#set_want_worshippers">set_want_worshippers()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_worshipper">
query_worshipper</a><pre class="autodocfuncdef">
int query_worshipper(string deity_name,
                     string word2)
</pre><dd><br />
This method returns the information associated with the
non-priest worshipper.  This corresponds to the number of
rituals learnable.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity<br />
word2 - the non-priest whorshipper to check<br />
<br />
<dd><b>Returns:</b>
<br />the number of rituals learnable
<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_worshipper">add_worshipper()</a>, <a href="#set_worshipper">set_worshipper()</a> and <a href="#query_worshipper">query_worshipper()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_worshipper_quests">
query_worshipper_quests</a><pre class="autodocfuncdef">
mixed * query_worshipper_quests(string deity_name)
</pre><dd><br />
This method queries the list of worshipper quests.  The arrays
consists of pairs of query_titles and number of rituals given if the
quest is done.  The function recheck_worshipper checks if the
player is a worshipper and in that case it will calculate the
number of rituals taught based on the quests done.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to get the quests for<br />
<br />
<dd><b>Returns:</b>
<br />the array as described above<br /><br />
<dd><b>See also:</b>
<br /><a href="#recheck_worshipper">recheck_worshipper()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="query_worshipper_rituals">
query_worshipper_rituals</a><pre class="autodocfuncdef">
mapping query_worshipper_rituals(string deity)
</pre>
<dt class="autodocfuncname"><a name="query_worshippers">
query_worshippers</a><pre class="autodocfuncdef">
mapping query_worshippers(string deity_name)
</pre><dd><br />
This method queries the mapping of non-priest worshippers.  The keys
of the mapping are the names and the values are number of rituals
learnable.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to query<br />
<br />
<dd><b>Returns:</b>
<br />the mapping of non-priest worshippers
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="random_al">
random_al</a><pre class="autodocfuncdef">
int random_al(string deity_name)
</pre><dd><br />
This method returns a random alignment between the limits for the
given deity.  This is used by the npcs to set themselves up
with a correct alignment.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to query<br />
<br />
<dd><b>Returns:</b>
<br />a random valid alignment
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="recheck_worshipper">
recheck_worshipper</a><pre class="autodocfuncdef">
void recheck_worshipper(string player_name)
</pre><dd><br />
This method figures out the number of rituals the worshipper
should know based on the number of quests they have done.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
player_name - the name of the player to check<br />
<br />
<dd><b>See also:</b>
<br /><a href="#query_worshipper_quests">query_worshipper_quests()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="remove_high_priest">
remove_high_priest</a><pre class="autodocfuncdef">
void remove_high_priest(string deity,
                        string name)
</pre><dd><br />
This method is a generic form of removing the incumbent high priest
through some external means (they have died, resigned, become inactive,
etc).  It handles the appropriate next steps, such as calling an election,
dismissing ministers and aborting any schism.
<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity - the deity they belong to<br />
name - the player name to check
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="remove_position">
remove_position</a><pre class="autodocfuncdef">
int remove_position(string deity_name,
                    string position)
</pre><dd><br />
This method removes a position for the guild.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
position - position to remove<br />
<br />
<dd><b>Returns:</b>
<br />DEITY_POSITION_OK if successful, DEITY_POSITION_FAIL if the
position didn't exist<br /><br />
<dd><b>See also:</b>
<br /><a href="#add_position">add_position()</a>, <a href="#query_position">query_position()</a> and <a href="#query_positions">query_positions()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="reset_positions">
reset_positions</a><pre class="autodocfuncdef">
void reset_positions(string deity_name)
</pre><dd><br />
This method removes all appointments for a guild.  Used when the high
priest dies.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity:)<br />
<br />
<dd><b>See also:</b>
<br /><a href="#add_position">add_position()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="schism_stand">
schism_stand</a><pre class="autodocfuncdef">
int schism_stand(string deity,
                 string name)
</pre>
<dt class="autodocfuncname"><a name="schism_support">
schism_support</a><pre class="autodocfuncdef">
int schism_support(string deity,
                   string name,
                   string challenger)
</pre>
<dt class="autodocfuncname"><a name="schism_withdraw">
schism_withdraw</a><pre class="autodocfuncdef">
int schism_withdraw(string deity,
                    string name)
</pre>
<dt class="autodocfuncname"><a name="set_aka">
set_aka</a><pre class="autodocfuncdef">
void set_aka(string deity_name,
             string word2)
</pre><dd><br />
This method sets an alternate deity as the recipent for points
and such.  (Like the Tsortian God of Thunder is really Blind Io,
with a false beard and another hammer).<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to set the aka for<br />
word2 - the new aka for the deity
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_al_lower">
set_al_lower</a><pre class="autodocfuncdef">
void set_al_lower(string deity_name,
                  int number)
</pre><dd><br />
This method sets the lower alignment limit for the
given deity.  Note that that's the limit to how good the
deity accepts followers.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to query<br />
<br />
<dd><b>Returns:</b>
<br />the lower alignment limit
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_al_upper">
set_al_upper</a><pre class="autodocfuncdef">
void set_al_upper(string deity_name,
                  int number)
</pre><dd><br />
This method sets the upper alignment limit for the
given deity.  Note that that's the limit to how evil the
deity accepts followers.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to query<br />
<br />
<dd><b>Returns:</b>
<br />the upper alignment limit
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_creator_set_data">
set_creator_set_data</a><pre class="autodocfuncdef">
void set_creator_set_data(string deity,
                          string key,
                          mixed value)
</pre>
<dt class="autodocfuncname"><a name="set_extra_finger_info">
set_extra_finger_info</a><pre class="autodocfuncdef">
void set_extra_finger_info(string deity,
                           mixed info)
</pre>
<dt class="autodocfuncname"><a name="set_gender">
set_gender</a><pre class="autodocfuncdef">
void set_gender(string deity_name,
                int number)
</pre><dd><br />
This method sets the gender of the deity.  The gender is the same
as used elsehwere in the game.  0 for neuter, 1 for male and 2 for female.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
the - deity name<br />
number - the gender to set the deity to
<br />
<br />
<dd><b>See also:</b>
<br />/std/living/gender.c and <a href="#query_gender">query_gender()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_high_priest">
set_high_priest</a><pre class="autodocfuncdef">
void set_high_priest(string deity_name,
                     string word)
</pre><dd><br />
This method sets the current high priest for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to set the high priest for<br />
word - the name of the new high priest
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#query_high_priest">query_high_priest()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_info">
set_info</a><pre class="autodocfuncdef">
void set_info(string deity_name,
              string text)
</pre><dd><br />
This method sets information about the deity.  This is used
in the finger information and when querying about joining the
priesthood.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to set information on<br />
text - the new value for the information
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#query_info">query_info()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_nationality">
set_nationality</a><pre class="autodocfuncdef">
void set_nationality(string deity_name,
                     string text)
</pre><dd><br />
This method sets the deity's nationality.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to set information on<br />
nationality - deity's nationality, or 0 if non-specific
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#query_nationality">query_nationality()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_player_set_data">
set_player_set_data</a><pre class="autodocfuncdef">
void set_player_set_data(string deity,
                         string key,
                         mixed value)
</pre>
<dt class="autodocfuncname"><a name="set_points">
set_points</a><pre class="autodocfuncdef">
void set_points(string deity_name,
                int number)
</pre><dd><br />
This method sets the number of points associated with the
deity.  The points are a measure of the total amount prayer that
has been directed to the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to set the points for<br />
number - the new value of the points
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_rating">
set_rating</a><pre class="autodocfuncdef">
void set_rating(string deity_name,
                int number)
</pre><dd><br />
This method sets the rating for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of deity to set the rating for<br />
number - the new value of the rating
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_short">
set_short</a><pre class="autodocfuncdef">
void set_short(string str)
</pre>
<dt class="autodocfuncname"><a name="set_title">
set_title</a><pre class="autodocfuncdef">
void set_title(string deity_name,
               string text,
               int type)
</pre><dd><br />
This method sets the title for the deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to set the title of<br />
text - the new title of the deity<br />
type - the new title type of the deity
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#query_title">query_title()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_totem_chats">
set_totem_chats</a><pre class="autodocfuncdef">
void set_totem_chats(string deity_name,
                     mixed * chats)
</pre><dd><br />
This method sets the chats of the deities totem figure.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the chat for<br />
chats - the chats of the totem figure, see
<br />
<br />
<dd><b>See also:</b>
<br /><a href="obj.monster.c.shtml#load_chat">/obj/monster->load_chat()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_totem_description">
set_totem_description</a><pre class="autodocfuncdef">
void set_totem_description(string deity_name,
                           string name,
                           string short,
                           string main_plural,
                           string long,
                           mixed adjectives)
</pre><dd><br />
This method sets the description of the deities totem figure.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to get the description for<br />
name - the name of the figure<br />
short - the short of the figure<br />
main_plural - the main_plural of the figure<br />
long - the long of the figure<br />
adjectives - the adjectives of the figure
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_vote">
set_vote</a><pre class="autodocfuncdef">
int set_vote(string deity_name,
             string candidate,
             string voter)
</pre><dd><br />
This method sets the current vote for the priest to the given
candidate.  This returns 0 if there is no election,
-1 if the preist being voted for does not exist and -2 if
the priest has already voted.  3 votes for a memvber of the
priesthood, 2 if you are worshipping the god and 1 if you
are not.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to vote for<br />
candidate - the high priest to vote for<br />
voter - the priest voting<br />
<br />
<dd><b>Returns:</b>
<br />the status value
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_want_priests">
set_want_priests</a><pre class="autodocfuncdef">
void set_want_priests(string deity_name,
                      int number)
</pre><dd><br />
This method sets if the deity wants priests or not.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to change<br />
number - the value of the flag
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#query_want_priests">query_want_priests()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_want_worshippers">
set_want_worshippers</a><pre class="autodocfuncdef">
void set_want_worshippers(string deity_name,
                          int number)
</pre><dd><br />
This method sets if the deity wants worshippers or not.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to change<br />
number - the value of the flag
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#query_want_worshippers">query_want_worshippers()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_worshipper">
set_worshipper</a><pre class="autodocfuncdef">
void set_worshipper(string deity_name,
                    string word2,
                    int number)
</pre><dd><br />
This method sets the information associated with the
non-priest worshipper.  This corresponds to the number of
rituals learnable.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity<br />
word2 - the non-priest worshipper to check<br />
number - the number of rituals to learn
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#add_worshipper">add_worshipper()</a>, <a href="#delete_worshipper">delete_worshipper()</a> and <a href="#query_worshipper">query_worshipper()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_worshipper_quests">
set_worshipper_quests</a><pre class="autodocfuncdef">
void set_worshipper_quests(string deity_name,
                           mixed * quest_list)
</pre><dd><br />
This method sets the list of worshipper quests.  The arrays
consists of pairs of query_titles and number of rituals given if the
quest is done.  The function recheck_worshipper checks if the
player is a worshipper and in that case it will calculate the
number of rituals taught based on the quests done.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the deity to set the quests for<br />
quest_list - the new list of quests for the deity<br />
<br />
<dd><b>See also:</b>
<br /><a href="#recheck_worshipper">recheck_worshipper()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="set_worshippers">
set_worshippers</a><pre class="autodocfuncdef">
void set_worshippers(string deity_name,
                     mapping map)
</pre><dd><br />
This method sets the mapping of non-priest worshippers.  The keys
of the mapping are the names and the values are number of rituals
learnable.  Except in very special circumstances set_worshipper()
should be used instead.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
deity_name - the name of the deity to set<br />
map - the new value for the mapping
<br />
<br />
<dd><b>See also:</b>
<br /><a href="#add_worshipper">add_worshipper()</a>, <a href="#set_worshipper">set_worshipper()</a>, <a href="#delete_worshipper">delete_worshipper()</a> and <a href="#query_worshipper">query_worshipper()</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="valid_high_priest">
valid_high_priest</a><pre class="autodocfuncdef">
int valid_high_priest(string priest)
</pre><dd><br />
This method checks to see if the high priest is valid.  Checks to make
make sure they exist, their guild object is set to the priest
object and they worship the current deity.  Makes sure they
don't have the "no score" property set and they have been on
recently.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
priest - the player to check<br />
<br />
<dd><b>Returns:</b>
<br />0 if they are not, 1 if they are<br /><br />
<dd><b>See also:</b>
<br /><a href="#test_user">test_user()</a>, <a href="#test_deity">test_deity()</a> and <a href="#test_guild">test_guild()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="valid_priest">
valid_priest</a><pre class="autodocfuncdef">
int valid_priest(string priest)
</pre><dd><br />
This method checks to see if the priest is valid.  Checks to make
make sure they exist, their guild object is set to the priest
object and they worship the current deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
priest - the player to check<br />
<br />
<dd><b>Returns:</b>
<br />0 if they are not, 1 if they are<br /><br />
<dd><b>See also:</b>
<br /><a href="#test_user">test_user()</a>, <a href="#test_deity">test_deity()</a> and <a href="#test_guild">test_guild()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="valid_worshipper">
valid_worshipper</a><pre class="autodocfuncdef">
int valid_worshipper(string worshipper)
</pre><dd><br />
This method checks to see if the worshipper is valid.  This basically
checks to see if they exist and they are worshipping the current
deity.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
worshipper - the worshipper to check<br />
<br />
<dd><b>Returns:</b>
<br />0 if they are not, 1 if they are<br /><br />
<dd><b>See also:</b>
<br /><a href="#test_user">test_user()</a> and <a href="#test_deity">test_deity()
</a><br /><br /><br /></dl>

<dt class="autodocfuncname"><a name="withdraw_candidate">
withdraw_candidate</a><pre class="autodocfuncdef">
int withdraw_candidate(string candidate,
                       string deity)
</pre><dd><br />
This method withdraws a candidate from the high priest election.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
candidate - the candidate<br />
deity - the deity<br />
<br />
<dd><b>Returns:</b>
<br />1 if successful, -1 if not.
<br /><br />
<br /></dl>

</dl>
<h2>Classes</h2>
These are nice data types for dealing with...  Data!<p>
<ul>
<li><a name="class_deity_cache">
deity_cache</a><pre>
class deity_cache {
                    int al_lower;
                    int al_upper;
                    int want_priests;
                    int want_worshippers;
                    string title;
                    int num_priests;
                    int num_worshippers;
                    string high_priest;
                    string short;
                    string info;
                    mixed extra_finger_info;
                    int gender;
                    mixed * totem_chats;
                    mixed * totem_description;
                    int title_type;
                    int points;
                    string aka;
                    int rating;
                    string nationality;
                    mapping excommunicated;
                    mapping pldata;
}

</pre>
</ul>
[an error occurred while processing this directive]

