<commit_before><html>
	<head>
		<title>SubEtha for Developers</title>
		
		<style type="text/css">
			/* <![CDATA[ */ 
			@import "http://www.tigris.org/branding/css/tigris.css"; 
			@import "http://www.tigris.org/branding/css/inst.css"; 
			/*  ]]> */
		</style>
		<link rel="stylesheet" type="text/css" href="http://www.tigris.org/branding/css/print.css" media="print" />
		<script src="http://www.tigris.org/branding/scripts/tigris.js" type="text/javascript">
		</script>
	</head>

	<body>
<div class="app">
		<h2>Setup Instructions for Development</h2>
		<ul>
			<li>
				Install <a href="http://labs.jboss.com/portal/jbossas/download">JBoss 4.04GA</a> 
				using the installer.  Choose the non-clustered ejb3
				install option, it boots much faster than the clustered option.  Do not
				enable call-by-value.  You do not need to secure your JBoss if you do not
				publicly expose your development server.
			</li>
			<li>
				If you install to a directory other than the default /java/jboss-VERSION,
				you will need to set the ${jboss.dir} property.  Copy build.properties to
				a file called user.properties and edit ${jboss.dir}.
			</li>
			<li>
				Edit ${jboss.dir}/server/default/deploy/mail-service.xml.  Set the
				following parameters:
				<ul>
					<li>mail.smtp.host - the name of your outgoing smtp mail server</li>
					<li>mail.smtp.port - (25) the port number of your outgoing smtp mail server</li>
					<li>mail.smtp.allow8bitmime - (true) optional, makes javamail more efficient</li>
				</ul>
				
				If you wish to run unit tests, you must have these two values:
				<ul>
					<li>mail.smtp.host set to localhost</li>
					<li>mail.smtp.port set to 2525 (you will have to create this line)</li>
				</ul>
			</li>
			<li>
				Download MySQL JDBC driver (MySQL Connector/J) from <a href="http://dev.mysql.com/downloads/">here</a>.
				Copy to ${jboss.dir}/server/default/lib.  The file should be mysql-connector-java-X.X.XX-bin.jar.
				You can use a different RDBMS but you'll need to use a different -ds.xml file
				than the one described below.
			</li>
			
			<li>
				If you need/want to support international character sets
				in Subetha, it is probably a good idea to read through
				the <a href="i18n.html">I18N configuration
				documentation</a> at this point as there are steps that
				must be completed there before going further in this
				setup.
			</li>
			<li>
				Create the data source by creating ${jboss.dir}/server/default/deploy/subetha-ds.xml.
				Use ${jboss.dir}/docs/examples/jca/mysql-ds.xml as a template.  The jndi-name must
				be SubEthaDS:
				<blockquote>&lt;jndi-name&gt;SubEthaDS&lt;/jndi-name&gt;</blockquote>
			</li>
			<li>
				One might also wish to define a database name as well. We like to use 
				the name 'subetha'. This is also defined in the subetha-ds.xml file: 
			    <blockquote>&lt;connection-url&gt;jdbc:mysql://localhost:3306/subetha&lt;/connection-url&gt;</blockquote>

			</li>
			<li>
				Create a database schema called 'subetha' which can be accessed by the host, user
				and password specified in the -ds.xml file.
			</li>
		</ul>

		<h2>Eclipse Setup</h2>
		
		<p>
		The 3 of the 4 core developers use <a href="http://eclipse.org/">Eclipse</a> as 
		their IDE of choice. We suggest you do as well. =)
		</p>
		
		<p>
		In order to setup Eclipse, you should first make sure to install the 
		<a href="http://subclipse.tigris.org/">Subclipse</a> plugin.
		Once you have installed that plugin. Select
		File->Import->Checkout projects from SVN. Select "Create a new
		repository location". Enter the URL for SubEtha's repository:
		http://subetha.tigris.org/svn/subetha
		</p>
		
		<p>
		Once you have the project checked out you need to define the
		location of JBOSS_HOME in Eclipse. Select Project->Properties.
		Java Build Path->Add Variable. Configure Variables->New and set
		the name to JBOSS_HOME and the folder location where you
		installed JBoss (ie: ${jboss.dir} mentioned above). 
		Now, Eclipse should properly find all the right
		libraries it needs.
		</p>
		
		<p>
		The next step is to build SubEtha. From the Java perspective,
		select Window->Show View->Ant. Right click in the Ant view and Add
		buildfiles. Then look for the top level SubEtha build file and
		add it. Once that is done, you can double click the 'deploy'
		target which will build SubEtha and install it in the right
		JBoss directory location.
		</p>
		
		<h2>Startup</h2>
		<p>
			Start up JBoss.  The default web interface is 
			<a href="http://localhost:8080/se/">http://localhost:8080/se/</a>
			When SubEtha runs for the first time, it creates a site administrator
			account named <strong>root@localhost</strong>, with the password
			<strong>password</strong>.
		</p>

		<h2>Directory Layout</h2>
		<p><commit_msg>added comment about tigris guest account.<commit_after><html>
	<head>
		<title>SubEtha for Developers</title>
		
		<style type="text/css">
			/* <![CDATA[ */ 
			@import "http://www.tigris.org/branding/css/tigris.css"; 
			@import "http://www.tigris.org/branding/css/inst.css"; 
			/*  ]]> */
		</style>
		<link rel="stylesheet" type="text/css" href="http://www.tigris.org/branding/css/print.css" media="print" />
		<script src="http://www.tigris.org/branding/scripts/tigris.js" type="text/javascript">
		</script>
	</head>

	<body>
<div class="app">
		<h2>Setup Instructions for Development</h2>
		<ul>
			<li>
				Install <a href="http://labs.jboss.com/portal/jbossas/download">JBoss 4.04GA</a> 
				using the installer.  Choose the non-clustered ejb3
				install option, it boots much faster than the clustered option.  Do not
				enable call-by-value.  You do not need to secure your JBoss if you do not
				publicly expose your development server.
			</li>
			<li>
				If you install to a directory other than the default /java/jboss-VERSION,
				you will need to set the ${jboss.dir} property.  Copy build.properties to
				a file called user.properties and edit ${jboss.dir}.
			</li>
			<li>
				Edit ${jboss.dir}/server/default/deploy/mail-service.xml.  Set the
				following parameters:
				<ul>
					<li>mail.smtp.host - the name of your outgoing smtp mail server</li>
					<li>mail.smtp.port - (25) the port number of your outgoing smtp mail server</li>
					<li>mail.smtp.allow8bitmime - (true) optional, makes javamail more efficient</li>
				</ul>
				
				If you wish to run unit tests, you must have these two values:
				<ul>
					<li>mail.smtp.host set to localhost</li>
					<li>mail.smtp.port set to 2525 (you will have to create this line)</li>
				</ul>
			</li>
			<li>
				Download MySQL JDBC driver (MySQL Connector/J) from <a href="http://dev.mysql.com/downloads/">here</a>.
				Copy to ${jboss.dir}/server/default/lib.  The file should be mysql-connector-java-X.X.XX-bin.jar.
				You can use a different RDBMS but you'll need to use a different -ds.xml file
				than the one described below.
			</li>
			
			<li>
				If you need/want to support international character sets
				in Subetha, it is probably a good idea to read through
				the <a href="i18n.html">I18N configuration
				documentation</a> at this point as there are steps that
				must be completed there before going further in this
				setup.
			</li>
			<li>
				Create the data source by creating ${jboss.dir}/server/default/deploy/subetha-ds.xml.
				Use ${jboss.dir}/docs/examples/jca/mysql-ds.xml as a template.  The jndi-name must
				be SubEthaDS:
				<blockquote>&lt;jndi-name&gt;SubEthaDS&lt;/jndi-name&gt;</blockquote>
			</li>
			<li>
				One might also wish to define a database name as well. We like to use 
				the name 'subetha'. This is also defined in the subetha-ds.xml file: 
			    <blockquote>&lt;connection-url&gt;jdbc:mysql://localhost:3306/subetha&lt;/connection-url&gt;</blockquote>

			</li>
			<li>
				Create a database schema called 'subetha' which can be accessed by the host, user
				and password specified in the -ds.xml file.
			</li>
		</ul>

		<h2>Eclipse Setup</h2>
		
		<p>
		The 3 of the 4 core developers use <a href="http://eclipse.org/">Eclipse</a> as 
		their IDE of choice. We suggest you do as well. =)
		</p>
		
		<p>
		In order to setup Eclipse, you should first make sure to install the 
		<a href="http://subclipse.tigris.org/">Subclipse</a> plugin.
		Once you have installed that plugin. Select
		File->Import->Checkout projects from SVN. Select "Create a new
		repository location". Enter the URL for SubEtha's repository:
		http://subetha.tigris.org/svn/subetha
		</p>
		<p>Note: The default svn username and password for <PASSWORD> are Guest with no password.</p>
		
		<p>
		Once you have the project checked out you need to define the
		location of JBOSS_HOME in Eclipse. Select Project->Properties.
		Java Build Path->Add Variable. Configure Variables->New and set
		the name to JBOSS_HOME and the folder location where you
		installed JBoss (ie: ${jboss.dir} mentioned above). 
		Now, Eclipse should properly find all the right
		libraries it needs.
		</p>
		
		<p>
		The next step is to build SubEtha. From the Java perspective,
		select Window->Show View->Ant. Right click in the Ant view and Add
		buildfiles. Then look for the top level SubEtha build file and
		add it. Once that is done, you can double click the 'deploy'
		target which will build SubEtha and install it in the right
		JBoss directory location.
		</p>
		
		<h2>Startup</h2>
		<p>
			Start up JBoss.  The default web interface is 
			<a href="http://localhost:8080/se/">http://localhost:8080/se/</a>
			When SubEtha runs for the first time, it creates a site administrator
			account named <strong>root@localhost</strong>, with the password
			<strong>password</strong>.
		</p>

		<h2>Directory Layout</h2>
		<p>
{'fraction_non_alphanumeric': 0.11683778234086242, 'fraction_numerical': 0.0075975359342915815, 'mean_word_length': 3.118816067653277, 'pattern_counts': {'":': 0, '<': 174, '<?xml version=': 0, '>': 188, 'https://': 0, 'lorem ipsum': 0, 'www.': 8, 'xml': 12}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 10, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4470400', 'n_tokens_mistral': 3810, 'n_tokens_neox': 3157, 'n_words': 1114}