[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>File /obj/handlers/newspaper.c</h2>
This is a general newspaper edition handler.  It will deal with keeping
track of all the data for all the newspapers on the mud.<p>Written by Pinkfish<p>Started Sat Apr 28 02:30:49 PDT 2001
<h2>Includes</h2>
This class includes the following files /include/housing.h, /include/autodoc.h, /include/player_handler.h, /include/login_handler.h, /include/nroff.h, /include/room/newspaper.h and /include/board.h<h2>Class Index</h2>
<ul><li><a href="#class_edition">edition</a>
<li><a href="#class_paper">paper</a>
</ul><h2>Method index</h2>
<ul>
<li><a href="#add_edition_paper_sold">add_edition_paper_sold</a>(string, int, int)<br/>
This method adds a web paper sold to the specified edition.
<li><a href="#add_edition_revenue">add_edition_revenue</a>(string, int, int)<br/>
This method adds to the total revenue for this edition.
<li><a href="#add_edition_web_hit">add_edition_web_hit</a>(string, int)<br/>
This method adds a web hit to the specified edition.
<li><a href="#add_html_text">add_html_text</a>(string)<li><a href="#add_newspaper_inform">add_newspaper_inform</a>(string, string)<br/>
This method adds an object to be informed of a paper being published.
<li><a href="#add_paper">add_paper</a>(string, string, string, string, string)<br/>
This method adds a paper.
<li><a href="#add_paper_area">add_paper_area</a>(string)<br/>
This method adds a paper area.
<li><a href="#add_paper_to_area">add_paper_to_area</a>(string, string)<br/>
This method adds a paper to a paper area.
<li><a href="#add_subscriber">add_subscriber</a>(string, string, int)<br/>
This method adds a subscriber into the list of people for a specific
edition of the newspaper.
<li><a href="#call_out_np">call_out_np</a>(mixed, string)<li><a href="#close_all">close_all</a>()<li><a href="#close_block">close_block</a>()<li><a href="#close_tag">close_tag</a>()<li><a href="#convert_html">convert_html</a>(string)<br/>
This method changes an input string into a 'nroff' equivilant output
string.
<li><a href="#is_allowed_to_read">is_allowed_to_read</a>(string, string, int)<br/>
This checks and sees if the specified user is subscribed to the edition
in question.
<li><a href="#is_paper">is_paper</a>(string)<br/>
This method checks to see if the paper exists.
<li><a href="#is_paper_area">is_paper_area</a>(string)<br/>
This method checks to see if the area exists or not.
<li><a href="#is_valid_edition">is_valid_edition</a>(string, int)<br/>
This checks to see if the specified edition is valid or not.
<li><a href="#parse_tag">parse_tag</a>(string)<li><a href="#publish_paper">publish_paper</a>(string, string, class article *, string *, class advert *, string *)<br/>
This method publishes a new edition of the specified paper.
<li><a href="#query_all_papers">query_all_papers</a>()<br/>
This method returns the list of all the papers.
<li><a href="#query_article_text">query_article_text</a>(class article)<br/>
This method reads in the data associated with the specified article.
<li><a href="#query_article_text_html">query_article_text_html</a>(class article)<br/>
This method reads in the data associated with the specified article
in html.
<li><a href="#query_article_text_plain">query_article_text_plain</a>(class article)<br/>
This method reads in the data associated with the specified article
in plain output.
<li><a href="#query_current_edition_num">query_current_edition_num</a>(string)<br/>
This method returns the current edition of the paper.
<li><a href="#query_edition_adverts">query_edition_adverts</a>(string, int)<br/>
This method returns the adverts in the specified edition of the
paper.
<li><a href="#query_edition_articles">query_edition_articles</a>(string, int)<br/>
This method returns the articles in the specified edition of the
paper.
<li><a href="#query_edition_date">query_edition_date</a>(string, int)<br/>
This method returns the date at which the specified issue was
published.
<li><a href="#query_edition_num_sold">query_edition_num_sold</a>(string, int)<br/>
This method returns the number of papers which have been sold.
<li><a href="#query_edition_num_web_hits">query_edition_num_web_hits</a>(string, int)<br/>
This method returns the number of web hits for the editon.
<li><a href="#query_edition_revenue">query_edition_revenue</a>(string, int)<br/>
This method returns the total revenue for this edition.
<li><a href="#query_language_for">query_language_for</a>(string)<br/>
This function returns the language for the given newspaper.
<li><a href="#query_last_edition_num">query_last_edition_num</a>(string)<br/>
This method returns the last edition of the paper.
<li><a href="#query_newspaper_informs">query_newspaper_informs</a>(string)<br/>
This method returns the list of objects that want to be informed about
this paper.
<li><a href="#query_paper_cost">query_paper_cost</a>(string)<br/>
This method returns the cost at which the paper will be sold.
<li><a href="#query_paper_description">query_paper_description</a>(string)<br/>
This method returns the description description of the paper.
<li><a href="#query_paper_headline">query_paper_headline</a>(string, int)<br/>
This method returns the headline for the selected edition of the paper.
<li><a href="#query_paper_long">query_paper_long</a>(string)<br/>
This method returns the long description of the paper.
<li><a href="#query_paper_office">query_paper_office</a>(string)<br/>
This method returns the office of the paper.
<li><a href="#query_papers_in_area">query_papers_in_area</a>(string)<br/>
This method returns all the articles in the specified paper area.
<li><a href="#remove_last_edition">remove_last_edition</a>(string)<li><a href="#remove_newspaper_inform">remove_newspaper_inform</a>(string, string)<br/>
This method removes an object to be informed of a paper being published.
<li><a href="#set_article_text">set_article_text</a>(class article, string)<br/>
This moves the data for the article into the correct location.
<li><a href="#set_language_for">set_language_for</a>(string, string)<br/>
This function sets the language for the given paper.
<li><a href="#set_paper_cost">set_paper_cost</a>(string, int)<br/>
This method sets the cost at which the paper will be sold.
<li><a href="#set_paper_description">set_paper_description</a>(string, string)<br/>
This method sets the description of the paper.
<li><a href="#set_paper_headline">set_paper_headline</a>(string, int, string)<br/>
This method returns the headline for the selected edition of the paper.
<li><a href="#set_paper_long">set_paper_long</a>(string, string)<br/>
This method sets the long of the paper.
<li><a href="#set_paper_office">set_paper_office</a>(string, string)<br/>
This method sets the office of the paper.
<li><a href="#validate_html">validate_html</a>(string)</ul>
<h2>Public Functions</h2>
These are functions that everyone can access.<p>
<dl>
<dt class="autodocfuncname"><a name="add_edition_paper_sold">
add_edition_paper_sold</a><pre class="autodocfuncdef">
void add_edition_paper_sold(string paper,
                            int edition,
                            int cost)
</pre><dd><br />
This method adds a web paper sold to the specified edition.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper which was sold<br />
edition - the edition which was sold<br />
cost - the amount it was sold for
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_edition_revenue">
add_edition_revenue</a><pre class="autodocfuncdef">
void add_edition_revenue(string paper,
                         int edition,
                         int revenue)
</pre><dd><br />
This method adds to the total revenue for this edition.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to look up<br />
edition - the edition to look up<br />
revenue - the revenue to add
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_edition_web_hit">
add_edition_web_hit</a><pre class="autodocfuncdef">
void add_edition_web_hit(string paper,
                         int edition)
</pre><dd><br />
This method adds a web hit to the specified edition.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to add a hit on<br />
edition - the edition to add a hit on
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_html_text">
add_html_text</a><pre class="autodocfuncdef">
string add_html_text(string str)
</pre>
<dt class="autodocfuncname"><a name="add_newspaper_inform">
add_newspaper_inform</a><pre class="autodocfuncdef">
void add_newspaper_inform(string paper,
                          string ob)
</pre><dd><br />
This method adds an object to be informed of a paper being published.
When the paper is published, the function event_publish_paper,
is called on all the objects in this list.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to be informed about<br />
ob - the object to be informed
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_paper">
add_paper</a><pre class="autodocfuncdef">
void add_paper(string name,
               string long,
               string desc,
               string office,
               string language)
</pre><dd><br />
This method adds a paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the name of the paper<br />
long - the description on the newspapers themselves<br />
desc - the description on the web page<br />
office - the path to the office
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_paper_area">
add_paper_area</a><pre class="autodocfuncdef">
void add_paper_area(string area)
</pre><dd><br />
This method adds a paper area.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
area - the area to add
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_paper_to_area">
add_paper_to_area</a><pre class="autodocfuncdef">
void add_paper_to_area(string paper,
                       string area)
</pre><dd><br />
This method adds a paper to a paper area.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to add to the area<br />
area - the area to add the paper to
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="add_subscriber">
add_subscriber</a><pre class="autodocfuncdef">
void add_subscriber(string paper,
                    string subscriber,
                    int edition)
</pre><dd><br />
This method adds a subscriber into the list of people for a specific
edition of the newspaper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper they subscribed to<br />
subscriber - the person subscribing<br />
edition - the edition they subscribed to
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="call_out_np">
call_out_np</a><pre class="autodocfuncdef">
void call_out_np(mixed thing,
                 string paper)
</pre>
<dt class="autodocfuncname"><a name="close_all">
close_all</a><pre class="autodocfuncdef">
string close_all()
</pre>
<dt class="autodocfuncname"><a name="close_block">
close_block</a><pre class="autodocfuncdef">
string close_block()
</pre>
<dt class="autodocfuncname"><a name="close_tag">
close_tag</a><pre class="autodocfuncdef">
string close_tag()
</pre>
<dt class="autodocfuncname"><a name="convert_html">
convert_html</a><pre class="autodocfuncdef">
string convert_html(string input)
</pre><dd><br />
This method changes an input string into a 'nroff' equivilant output
string.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
str - the string to convert
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="is_allowed_to_read">
is_allowed_to_read</a><pre class="autodocfuncdef">
int is_allowed_to_read(string paper,
                       string person,
                       int edition)
</pre><dd><br />
This checks and sees if the specified user is subscribed to the edition
in question.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to check<br />
person - the person to check<br />
edition - the edition to find<br />
<br />
<dd><b>Returns:</b>
<br />1 if they are subscribed
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="is_paper">
is_paper</a><pre class="autodocfuncdef">
int is_paper(string paper)
</pre><dd><br />
This method checks to see if the paper exists.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper name to check for
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="is_paper_area">
is_paper_area</a><pre class="autodocfuncdef">
int is_paper_area(string area)
</pre><dd><br />
This method checks to see if the area exists or not.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
area - the area to check for
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="is_valid_edition">
is_valid_edition</a><pre class="autodocfuncdef">
int is_valid_edition(string paper,
                     int edition)
</pre><dd><br />
This checks to see if the specified edition is valid or not.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to check<br />
edition - the edition to check<br />
<br />
<dd><b>Returns:</b>
<br />1 if it ok, 0 if not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="parse_tag">
parse_tag</a><pre class="autodocfuncdef">
string parse_tag(string tag)
</pre>
<dt class="autodocfuncname"><a name="publish_paper">
publish_paper</a><pre class="autodocfuncdef">
int publish_paper(string paper,
                  string headline,
                  class article * articles,
                  string * text,
                  class advert * adds,
                  string * editors)
</pre><dd><br />
This method publishes a new edition of the specified paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to publish an edition of<br />
articles - the articles in the paper<br />
text - the corresponding text to the articles<br />
adds - the adverts in the paper<br />
<br />
<dd><b>Returns:</b>
<br />1 if successful, 0 if not
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_all_papers">
query_all_papers</a><pre class="autodocfuncdef">
string * query_all_papers()
</pre><dd><br />
This method returns the list of all the papers.<br />
<br /><dl>
<dd><b>Returns:</b>
<br />all the papers
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_article_text">
query_article_text</a><pre class="autodocfuncdef">
string query_article_text(class article art)
</pre><dd><br />
This method reads in the data associated with the specified article.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
article - the article to read the text for<br />
<br />
<dd><b>Returns:</b>
<br />the article text
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_article_text_html">
query_article_text_html</a><pre class="autodocfuncdef">
string query_article_text_html(class article art)
</pre><dd><br />
This method reads in the data associated with the specified article
in html.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
article - the article to read the text for<br />
<br />
<dd><b>Returns:</b>
<br />the article text
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_article_text_plain">
query_article_text_plain</a><pre class="autodocfuncdef">
string query_article_text_plain(class article art)
</pre><dd><br />
This method reads in the data associated with the specified article
in plain output.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
article - the article to read the text for<br />
<br />
<dd><b>Returns:</b>
<br />the article text
<br /><br />
<br /></dl>

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

<dt class="autodocfuncname"><a name="query_edition_adverts">
query_edition_adverts</a><pre class="autodocfuncdef">
class advert * query_edition_adverts(string paper,
                                     int edition)
</pre><dd><br />
This method returns the adverts in the specified edition of the
paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to look up<br />
edition - the edition to look up<br />
<br />
<dd><b>Returns:</b>
<br />the adverts in the edition
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_edition_articles">
query_edition_articles</a><pre class="autodocfuncdef">
class article * query_edition_articles(string paper,
                                       int edition)
</pre><dd><br />
This method returns the articles in the specified edition of the
paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to look up<br />
edition - the edition to look up<br />
<br />
<dd><b>Returns:</b>
<br />the articles in the edition
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_edition_date">
query_edition_date</a><pre class="autodocfuncdef">
int query_edition_date(string paper,
                       int edition)
</pre><dd><br />
This method returns the date at which the specified issue was
published.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to check<br />
edition - the edition to look up<br />
<br />
<dd><b>Returns:</b>
<br />the date at which the edition was published
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_edition_num_sold">
query_edition_num_sold</a><pre class="autodocfuncdef">
int query_edition_num_sold(string paper,
                           int edition)
</pre><dd><br />
This method returns the number of papers which have been sold.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper which was sold<br />
edition - the edition to check<br />
<br />
<dd><b>Returns:</b>
<br />the number of papers that have been sold
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_edition_num_web_hits">
query_edition_num_web_hits</a><pre class="autodocfuncdef">
int query_edition_num_web_hits(string paper,
                               int edition)
</pre><dd><br />
This method returns the number of web hits for the editon.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper which was hit<br />
edition - the edition to check<br />
<br />
<dd><b>Returns:</b>
<br />the number of web hits on the edition
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_edition_revenue">
query_edition_revenue</a><pre class="autodocfuncdef">
int query_edition_revenue(string paper,
                          int edition)
</pre><dd><br />
This method returns the total revenue for this edition.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to look up<br />
edition - the edition to look up<br />
<br />
<dd><b>Returns:</b>
<br />the headline of the edition
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_language_for">
query_language_for</a><pre class="autodocfuncdef">
string query_language_for(string paper)
</pre><dd><br />
This function returns the language for the given newspaper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - The name of the paper.<br />
<br />
<dd><b>Returns:</b>
<br />The language for the paper, "general" for none or 0 if for error
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_last_edition_num">
query_last_edition_num</a><pre class="autodocfuncdef">
int query_last_edition_num(string paper)
</pre><dd><br />
This method returns the last edition of the paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to get the edition of<br />
<br />
<dd><b>Returns:</b>
<br />the last edition, 0 if there are no editions
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_newspaper_informs">
query_newspaper_informs</a><pre class="autodocfuncdef">
string * query_newspaper_informs(string paper)
</pre><dd><br />
This method returns the list of objects that want to be informed about
this paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to be informed about<br />
<br />
<dd><b>Returns:</b>
<br />the list of objects to inform
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_paper_cost">
query_paper_cost</a><pre class="autodocfuncdef">
int query_paper_cost(string paper)
</pre><dd><br />
This method returns the cost at which the paper will be sold.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to set the cost of<br />
<br />
<dd><b>Returns:</b>
<br />the cost at which the paper will be sold
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_paper_description">
query_paper_description</a><pre class="autodocfuncdef">
string query_paper_description(string paper)
</pre><dd><br />
This method returns the description description of the paper.  The long
description is used in the newspapers around the place as it's
description.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to get the long for
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_paper_headline">
query_paper_headline</a><pre class="autodocfuncdef">
string query_paper_headline(string paper,
                            int edition)
</pre><dd><br />
This method returns the headline for the selected edition of the paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to look up<br />
edition - the edition to look up<br />
<br />
<dd><b>Returns:</b>
<br />the headline of the edition
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_paper_long">
query_paper_long</a><pre class="autodocfuncdef">
string query_paper_long(string paper)
</pre><dd><br />
This method returns the long description of the paper.  The long
description is used in the newspapers around the place as it's
description.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to get the long for
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_paper_office">
query_paper_office</a><pre class="autodocfuncdef">
string query_paper_office(string paper)
</pre><dd><br />
This method returns the office of the paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to look up<br />
<br />
<dd><b>Returns:</b>
<br />the office of the paper
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="query_papers_in_area">
query_papers_in_area</a><pre class="autodocfuncdef">
string * query_papers_in_area(string area)
</pre><dd><br />
This method returns all the articles in the specified paper area.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
area - the area to lookup<br />
<br />
<dd><b>Returns:</b>
<br />the papers in the area, returns a null array when there are no papers
<br /><br />
<br /></dl>

<dt class="autodocfuncname"><a name="remove_last_edition">
remove_last_edition</a><pre class="autodocfuncdef">
class edition remove_last_edition(string paper)
</pre>
<dt class="autodocfuncname"><a name="remove_newspaper_inform">
remove_newspaper_inform</a><pre class="autodocfuncdef">
void remove_newspaper_inform(string paper,
                             string ob)
</pre><dd><br />
This method removes an object to be informed of a paper being published.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to no longer be informed about<br />
ob - the object to no longer be informed
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_article_text">
set_article_text</a><pre class="autodocfuncdef">
void set_article_text(class article art,
                      string text)
</pre><dd><br />
This moves the data for the article into the correct location.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
article - the article to set the text for<br />
text - the text to set
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_language_for">
set_language_for</a><pre class="autodocfuncdef">
void set_language_for(string paper,
                      string language)
</pre><dd><br />
This function sets the language for the given paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - The name of the paper.<br />
language - The language to use.
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_paper_cost">
set_paper_cost</a><pre class="autodocfuncdef">
void set_paper_cost(string paper,
                    int cost)
</pre><dd><br />
This method sets the cost at which the paper will be sold.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to set the cost of<br />
cost - the new cost of the paper
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_paper_description">
set_paper_description</a><pre class="autodocfuncdef">
void set_paper_description(string paper,
                           string description)
</pre><dd><br />
This method sets the description of the paper.  The description is
what is shown on the web page for the paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to set the long for<br />
long - the new long description of the paper
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_paper_headline">
set_paper_headline</a><pre class="autodocfuncdef">
void set_paper_headline(string paper,
                        int edition,
                        string headline)
</pre><dd><br />
This method returns the headline for the selected edition of the paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to look up<br />
edition - the edition to look up<br />
headline - the headline of the issue
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_paper_long">
set_paper_long</a><pre class="autodocfuncdef">
void set_paper_long(string paper,
                    string long)
</pre><dd><br />
This method sets the long of the paper.  The long description is
used in the newspapers around the place.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to set the long for<br />
long - the new long description of the paper
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="set_paper_office">
set_paper_office</a><pre class="autodocfuncdef">
void set_paper_office(string paper,
                      string office)
</pre><dd><br />
This method sets the office of the paper.<br />
<br /><dl>
<dd><b>Parameters:</b><br />
paper - the paper to look up<br />
office - the new office of the paper
<br />
<br />
<br /></dl>

<dt class="autodocfuncname"><a name="validate_html">
validate_html</a><pre class="autodocfuncdef">
string validate_html(string str)
</pre>
</dl>
<h2>Classes</h2>
These are nice data types for dealing with...  Data!<p>
<ul>
<li><a name="class_edition">
edition</a><pre>
class edition {
                int date_published;
                class article * articles;
                class advert * adverts;
                string headline;
                int num_sold;
                int num_web_hits;
                int total_revenue;
}

</pre>
<li><a name="class_paper">
paper</a><pre>
class paper {
              class edition * published_editions;
              string dir_name;
              string long;
              string description;
              string office;
              int paper_cost;
              string language;
              string owned_room;
              int last_auctioned;
}

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