<commit_before><?php
	#
	# $Id: faq.php,v 1.1.2.74 2005-06-25 17:59:48 dan Exp $
	#
	# Copyright (c) 1998-2003 DVL Software Limited
	#

	require_once($_SERVER['DOCUMENT_ROOT'] . '/include/common.php');
	require_once($_SERVER['DOCUMENT_ROOT'] . '/include/freshports.php');
	require_once($_SERVER['DOCUMENT_ROOT'] . '/include/databaselogin.php');
	require_once($_SERVER['DOCUMENT_ROOT'] . '/include/getvalues.php');

	freshports_Start('FAQ',
					'freshports - new ports, applications',
					'FreeBSD, index, applications, ports');

	$ServerName = str_replace('freshports', 'FreshPorts', $_SERVER['SERVER_NAME']);

	GLOBAL $FreshPortsName;
	GLOBAL $FreshPortsSlogan;

?>
	<?php echo freshports_MainTable(); ?>

	<tr><td valign="top" width="100%">

	<?php echo freshports_MainContentTable(NOBORDER); ?>


<tr>
	<?php echo freshports_PageBannerText("FAQ"); ?>
</tr>
<TR><TD>
<P>This page contains the FAQ for FreshPorts. Hopefully the questions
are arranged from general to specific.  The more you know, the further
down you must read to find something you didn't already know.</P>
</TD></TR>
<TR><TD>&nbsp;</TD></TR>

<TR>

<?php echo freshports_PageBannerText("What is this website about?"); ?>

	<TR><TD>
	This website will help you keep up with the latest releases of your
	favorite software.  When a new version of the software is available,
	FreshPorts will send you an email telling you about the change.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do I use this?"); ?>
</TR>

	<TR><TD>
	<p>
	Your primary FreshPorts tool is your <b>watch list</b>.  This is the
	collection of ports which you have selected for FreshPorts to
	keep track of.  You will be emailed when a change is found
	for one of your watched ports.

	<p>
	You can have more than one watch list.  Most people would have
	one watch list for each machine they administer.  I suggest giving
	the watch list the same name as the machine.  Email notifications
	will contain headers with the list name.  You can use that for any
	filtering you may want to do (e.g. procmail).
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do I modify my watch list?"); ?>
</TR>

	<TR><TD>
	There are three easy ways to modify your watch list:
	<OL>
	<LI>Wherever you see a port, you can click on the Add 
		(<?php echo freshports_Watch_Icon_Add(); ?>) /
		Remove (<?php echo freshports_Watch_Icon(); ?>)
		link as necessary (i.e. one-click watch list maintenance).</LI>
	<LI>The 'watch list categories' link provides you with a list
		of categories.  Select the category, and then the ports within
		that category.</LI>
	<LI>Use the 'upload' link to upload your pkg_info data into your
		watch list staging area and then into your watch list.</LI>
	</OL>

	<p>
	One-click watch list maintenance operates only upon your default
	watch lists.  You can set one or more watch lists as being default.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do I empty my watch list?"); ?>
</TR>

	<TR><TD>
	Via <a href="/watch-list-maintenance.php">Watch List Maintenance</a>.
	Select the watch lists you wish to empty, and follow the instructions
	provided.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do delete my account?"); ?>
</TR>

	<TR><TD>
	You can't.  But you can unsubscribe from all of the reports
	and you'll never hear from us again.
	</TD></TR><TR><TD>&nbsp;</TD></TR>



<TR>
<?php echo freshports_PageBannerText("What is a port?"); ?>
</TR>

	<TR><TD>
	A port is a simple easy way to install an application.
	A port is a collection of files.  These files contain the location
	of the source file, any patches which must be applied,
	instructions for building the application, and the installation
	procedure.  Removing an installed port is also easy.  For full
	details on how to use ports, please refer to the official port
	documents in the <A HREF="http://www.FreeBSD.org/handbook/">FreeBSD
	Handbook</A>.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("Where do ports come from?"); ?>
</TR>

	<TR><TD>Ports are created by other FreeBSD volunteers, just like you
	and just like the creators of FreshPorts.  The FreshPorts team does
	not create ports; we just tell you about the latest changes.  The
	FreeBSD Ports team creates, maintains, and upgrades the ports.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("Who do I talk to about a port?"); ?>
</TR>

	<TR><TD>The official mailing list is freebsd-ports&#64;freebsd.org.
		More information all FreeBSD mailing lists can be obtained
		from <A HREF="http://www.FreeBSD.org/handbook/eresources.html#ERESOURCES-MAIL">FreeBSD Mailing Lists</A>.
		You can ask for help there and in our <A HREF="/phorum/">Support
		Forum</A>.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do I get these ports?"); ?>
</TR>

	<TR><TD>For full information on how to obtain the ports which appear on
	this website, please see <A HREF="http://www.FreeBSD.org/ports/">FreeBSD Ports</A>.
	The easiest way to get a port is via cvsup.  An abbreviated example is

	<BLOCKQUOTE>
	<CODE CLASS="code">cvsup -h cvsup.your.fav.server /usr/share/examples/cvsup/ports-supfile</CODE>
	</BLOCKQUOTE>
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How is the website updated?"); ?>
</TR>

	<TR><TD>
	The source code for the entire FreeBSD operating system and the Ports tree
	are stored in the official <A HREF="http://www.FreeBSD.org/cgi/cvsweb.cgi">FreeBSD 
	repository</A>.  Each time a change is committed to this <A HREF="http://cvshome.org/">CVS</A>
	repository, a mail message is sent out to the cvs-all mailing list.  FreshPorts
	takes these mail messages, parses them, and then loads them into a database.
	In theory, it's fairly straight forward.  In practice, there's much more to
	it than first meets the eye.  The website is updated as soon as the message
	arrives.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("What does unknown mean for a revision number?"); ?>
</TR>

	<TR><TD>It means the data has been converted from an earlier
		version of the FreshPorts database that did not record this information.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How can I link to your site?"); ?>
</TR>

	<TR><TD>Yes, thank you, you can.  No need to ask us.  Just go ahead and do it.
		We prefer the name FreshPorts (one word, mixed case). The following 
		HTML is a good place to start:

		<BLOCKQUOTE>
		<CODE CLASS="code">&lt;A HREF="http://www.freshports.org/"&gt;FreshPorts&lt;/A&gt;</CODE>
		</BLOCKQUOTE>

		<P>Here is a banner which you are free to use to link to this site:</P>

		<P ALIGN="center">
		<img src="images/freshports-banner.gif" alt="<?php echo "$FreshPortsName -- $FreshPortsSlogan"; ?>" title="<?php echo "$FreshPortsName -- $FreshPortsSlogan"; ?>" width="468" height="60">
		</P>

		Here is the HTML for that graphic.

		<BLOCKQUOTE>
		<CODE CLASS="code">&lt;img src="images/freshports-banner.gif" alt="<?php echo "$FreshPortsName -- $FreshPortsSlogan"; ?>" title="<?php echo "$FreshPortsName -- $FreshPortsSlogan"; ?>" width="468" height="60"&gt;</CODE>
		</BLOCKQUOTE>


		<P>Please save this graphic on your website.</P>
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("Why do I need a different login for the Forums?"); ?>
</TR>

	<TR><TD>
	You only need a login for the <A HREF="/phorum/">forums</A> if
	you want to use a login.  A login will ensure that only you can
	post under the name you enter.  It is a separate login because
	we didn't write the <A HREF="http://www.phorum.org/">Phorum software</A>
	used to implement for forums.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("What do these symbols mean?"); ?>
</TR>

	<TR><TD>
	There are a few symbols you will see in this website.
	<BLOCKQUOTE>
	<P><?php echo freshports_New_Icon() ?>
		New: This port has been recently added.  A port is marked as new for 10 days.</P>

	<P><a name="forbidden"><?php echo freshports_Forbidden_Icon() ?></a>
		Forbidden: The port is marked as forbidden.  If you view the port details,
		you will see why.  Most often, it is because of a security exploit. Packages for a forbidden port are not built
        by the package cluster.  Therefore, <code>pkg_add</code> will not work.</P>

	<P><a name="broken"><?php echo freshports_Broken_Icon() ?></a>
		Broken: The port is marked as broken.  Perhaps it won't compile.  Maybe
		it doesn't work under FreeBSD right now.  If you view the port details,
		you will see the reason why. Packages for a broken port are not built
        by the package cluster.  Therefore, <code>pkg_add</code> will not work.</P>

	<P><a name="deprecated"><?php echo freshports_Deprecated_Icon() ?></a>
		Deprecated: The port is marked as deprecated.  Perhaps it has exceeded
		its lifetime or is obselete. </P>

	<P><a name="ignore"><?php echo freshports_Ignore_Icon() ?></a>
		Ignore: The port is marked as ignore.  It probably does not build. Packages for an ignored port are not built
        by the package cluster.  Therefore, <code>pkg_add</code> will not work.</P><commit_msg>Add explanations for expired and expiration.<commit_after><?php
	#
	# $Id: faq.php,v 1.1.2.75 2005-06-26 23:46:40 dan Exp $
	#
	# Copyright (c) 1998-2003 DVL Software Limited
	#

	require_once($_SERVER['DOCUMENT_ROOT'] . '/include/common.php');
	require_once($_SERVER['DOCUMENT_ROOT'] . '/include/freshports.php');
	require_once($_SERVER['DOCUMENT_ROOT'] . '/include/databaselogin.php');
	require_once($_SERVER['DOCUMENT_ROOT'] . '/include/getvalues.php');

	freshports_Start('FAQ',
					'freshports - new ports, applications',
					'FreeBSD, index, applications, ports');

	$ServerName = str_replace('freshports', 'FreshPorts', $_SERVER['SERVER_NAME']);

	GLOBAL $FreshPortsName;
	GLOBAL $FreshPortsSlogan;

?>
	<?php echo freshports_MainTable(); ?>

	<tr><td valign="top" width="100%">

	<?php echo freshports_MainContentTable(NOBORDER); ?>


<tr>
	<?php echo freshports_PageBannerText("FAQ"); ?>
</tr>
<TR><TD>
<P>This page contains the FAQ for FreshPorts. Hopefully the questions
are arranged from general to specific.  The more you know, the further
down you must read to find something you didn't already know.</P>
</TD></TR>
<TR><TD>&nbsp;</TD></TR>

<TR>

<?php echo freshports_PageBannerText("What is this website about?"); ?>

	<TR><TD>
	This website will help you keep up with the latest releases of your
	favorite software.  When a new version of the software is available,
	FreshPorts will send you an email telling you about the change.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do I use this?"); ?>
</TR>

	<TR><TD>
	<p>
	Your primary FreshPorts tool is your <b>watch list</b>.  This is the
	collection of ports which you have selected for FreshPorts to
	keep track of.  You will be emailed when a change is found
	for one of your watched ports.

	<p>
	You can have more than one watch list.  Most people would have
	one watch list for each machine they administer.  I suggest giving
	the watch list the same name as the machine.  Email notifications
	will contain headers with the list name.  You can use that for any
	filtering you may want to do (e.g. procmail).
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do I modify my watch list?"); ?>
</TR>

	<TR><TD>
	There are three easy ways to modify your watch list:
	<OL>
	<LI>Wherever you see a port, you can click on the Add 
		(<?php echo freshports_Watch_Icon_Add(); ?>) /
		Remove (<?php echo freshports_Watch_Icon(); ?>)
		link as necessary (i.e. one-click watch list maintenance).</LI>
	<LI>The 'watch list categories' link provides you with a list
		of categories.  Select the category, and then the ports within
		that category.</LI>
	<LI>Use the 'upload' link to upload your pkg_info data into your
		watch list staging area and then into your watch list.</LI>
	</OL>

	<p>
	One-click watch list maintenance operates only upon your default
	watch lists.  You can set one or more watch lists as being default.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do I empty my watch list?"); ?>
</TR>

	<TR><TD>
	Via <a href="/watch-list-maintenance.php">Watch List Maintenance</a>.
	Select the watch lists you wish to empty, and follow the instructions
	provided.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do delete my account?"); ?>
</TR>

	<TR><TD>
	You can't.  But you can unsubscribe from all of the reports
	and you'll never hear from us again.
	</TD></TR><TR><TD>&nbsp;</TD></TR>



<TR>
<?php echo freshports_PageBannerText("What is a port?"); ?>
</TR>

	<TR><TD>
	A port is a simple easy way to install an application.
	A port is a collection of files.  These files contain the location
	of the source file, any patches which must be applied,
	instructions for building the application, and the installation
	procedure.  Removing an installed port is also easy.  For full
	details on how to use ports, please refer to the official port
	documents in the <A HREF="http://www.FreeBSD.org/handbook/">FreeBSD
	Handbook</A>.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("Where do ports come from?"); ?>
</TR>

	<TR><TD>Ports are created by other FreeBSD volunteers, just like you
	and just like the creators of FreshPorts.  The FreshPorts team does
	not create ports; we just tell you about the latest changes.  The
	FreeBSD Ports team creates, maintains, and upgrades the ports.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("Who do I talk to about a port?"); ?>
</TR>

	<TR><TD>The official mailing list is freebsd-ports&#64;freebsd.org.
		More information all FreeBSD mailing lists can be obtained
		from <A HREF="http://www.FreeBSD.org/handbook/eresources.html#ERESOURCES-MAIL">FreeBSD Mailing Lists</A>.
		You can ask for help there and in our <A HREF="/phorum/">Support
		Forum</A>.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How do I get these ports?"); ?>
</TR>

	<TR><TD>For full information on how to obtain the ports which appear on
	this website, please see <A HREF="http://www.FreeBSD.org/ports/">FreeBSD Ports</A>.
	The easiest way to get a port is via cvsup.  An abbreviated example is

	<BLOCKQUOTE>
	<CODE CLASS="code">cvsup -h cvsup.your.fav.server /usr/share/examples/cvsup/ports-supfile</CODE>
	</BLOCKQUOTE>
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How is the website updated?"); ?>
</TR>

	<TR><TD>
	The source code for the entire FreeBSD operating system and the Ports tree
	are stored in the official <A HREF="http://www.FreeBSD.org/cgi/cvsweb.cgi">FreeBSD 
	repository</A>.  Each time a change is committed to this <A HREF="http://cvshome.org/">CVS</A>
	repository, a mail message is sent out to the cvs-all mailing list.  FreshPorts
	takes these mail messages, parses them, and then loads them into a database.
	In theory, it's fairly straight forward.  In practice, there's much more to
	it than first meets the eye.  The website is updated as soon as the message
	arrives.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("What does unknown mean for a revision number?"); ?>
</TR>

	<TR><TD>It means the data has been converted from an earlier
		version of the FreshPorts database that did not record this information.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("How can I link to your site?"); ?>
</TR>

	<TR><TD>Yes, thank you, you can.  No need to ask us.  Just go ahead and do it.
		We prefer the name FreshPorts (one word, mixed case). The following 
		HTML is a good place to start:

		<BLOCKQUOTE>
		<CODE CLASS="code">&lt;A HREF="http://www.freshports.org/"&gt;FreshPorts&lt;/A&gt;</CODE>
		</BLOCKQUOTE>

		<P>Here is a banner which you are free to use to link to this site:</P>

		<P ALIGN="center">
		<img src="images/freshports-banner.gif" alt="<?php echo "$FreshPortsName -- $FreshPortsSlogan"; ?>" title="<?php echo "$FreshPortsName -- $FreshPortsSlogan"; ?>" width="468" height="60">
		</P>

		Here is the HTML for that graphic.

		<BLOCKQUOTE>
		<CODE CLASS="code">&lt;img src="images/freshports-banner.gif" alt="<?php echo "$FreshPortsName -- $FreshPortsSlogan"; ?>" title="<?php echo "$FreshPortsName -- $FreshPortsSlogan"; ?>" width="468" height="60"&gt;</CODE>
		</BLOCKQUOTE>


		<P>Please save this graphic on your website.</P>
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("Why do I need a different login for the Forums?"); ?>
</TR>

	<TR><TD>
	You only need a login for the <A HREF="/phorum/">forums</A> if
	you want to use a login.  A login will ensure that only you can
	post under the name you enter.  It is a separate login because
	we didn't write the <A HREF="http://www.phorum.org/">Phorum software</A>
	used to implement for forums.
	</TD></TR><TR><TD>&nbsp;</TD></TR>

<TR>
<?php echo freshports_PageBannerText("What do these symbols mean?"); ?>
</TR>

	<TR><TD>
	There are a few symbols you will see in this website.
	<BLOCKQUOTE>
	<P><?php echo freshports_New_Icon() ?>
		New: This port has been recently added.  A port is marked as new for 10 days.</P>

	<P><a name="forbidden"><?php echo freshports_Forbidden_Icon() ?></a>
		Forbidden: The port is marked as forbidden.  If you view the port details,
		you will see why.  Most often, it is because of a security exploit. Packages for a forbidden port are not built
        by the package cluster.  Therefore, <code>pkg_add</code> will not work.</P>

	<P><a name="broken"><?php echo freshports_Broken_Icon() ?></a>
		Broken: The port is marked as broken.  Perhaps it won't compile.  Maybe
		it doesn't work under FreeBSD right now.  If you view the port details,
		you will see the reason why. Packages for a broken port are not built
        by the package cluster.  Therefore, <code>pkg_add</code> will not work.</P>

	<P><a name="deprecated"><?php echo freshports_Deprecated_Icon() ?></a>
		Deprecated: The port is marked as deprecated.  Perhaps it has exceeded
		its lifetime or is obselete. </P>

	<P><a name="expiration"><?php echo freshports_Expiration_Icon() ?></a>
		Expiration Date: The port has an expiration date. A port may be removed from the
        tree after this date. Often added in conjunction with Deprecated. </P>

	<P><a name="expired"><?php echo freshports_Expired_Icon() ?></a>
		Expired: The port has passed the expiration date. A port may be removed from the
        tree after this date. Often added in conjunction with Deprecated. </P>

	<P><a name="ignore"><?php echo freshports_Ignore_Icon() ?></a>
		Ignore: The port is marked as ignore.  It probably does not build. Packages for an ignored port are not built
        by the package cluster.  Therefore, <code>pkg_add</code> will not work.</P>
{'fraction_non_alphanumeric': 0.13503058183909247, 'fraction_numerical': 0.004600345025876941, 'mean_word_length': 4.231063713426305, 'pattern_counts': {'":': 0, '<': 515, '<?xml version=': 0, '>': 515, 'https://': 0, 'lorem ipsum': 0, 'www.': 12, 'xml': 0}, 'pii_count': 2, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2742045', 'n_tokens_mistral': 6538, 'n_tokens_neox': 6118, 'n_words': 2360}