<html>
<head>
<title>
a l t h e a .
</title>
</head>
<body bgcolor=white topmargin="0" rightmargin="0" leftmargin="0" marginwidth="0" marginheight="0">
<STYLE TYPE="text/css">
<!--
A:hover { color: olive}
A { color: #000000; text-decoration: none;}
.color { color: #CCFF01; text-decoration: none;}
.blueish { color: #4A5572; text-decoration: none;}
.title { color: cornsilk; text-decoration: none;}
.white { color: white; text-decoration: none;}
.black { color: black; text-decoration: none;}
-->
</STYLE>
<font face='arial, helvetica' color=black>
<table width=100% bgcolor=slategray cellspacing=0 cellpadding=0 border=0>
<tr>
<td align=center width=100%>
<br>
<font face='arial, helvetica' color=white size=2>
v. 0.5<br>
</font>
<font face='arial, helvetica' color=white size=7>
<b>
A
l
t
h
e
a
.
</b>
</font>
</td>
<td nowrap>
<font face='arial, helvetica' color=white size=2>
hosted by
<a href="http://www.sourceforge.net"><img align=middle border=0 src="images/sf.gif"></a>
</td>
</tr>
</table>
<!-- BLACK LINE TABLE -->
<TABLE BORDER=0 WIDTH=100% CELLPADDING=0 CELLSPACING=0><TR><TD BGCOLOR=#000000 HEIGHT=1>
<TABLE BORDER=0 WIDTH=100% CELLPADDING=0 CELLSPACING=0><TR><TD></TD></TR></TABLE>
</TD></TR></TABLE>
<!-- CLOSE BLACK LINE TABLE -->
<table cellpadding=0 cellspacing=0 border=0>
<tr>
<td width=100%>
<font face='arial, helvetica' color=white size=7>
<b> <b>
</font>
</td>
<td nowrap bgcolor=white>
<font face='arial, helvetica' color=black size=3>
<a href=http://althea.sourceforge.net>homepage</a>
</td>
<td nowrap bgcolor=white>
<font face='arial, helvetica' color=black size=3>
<a href=http://prdownloads.sourceforge.net/althea/althea-0.5.3.tgz>download</a><b>
</td>
<td bgcolor=4a4a4a>
<font face='arial, helvetica' color=white size=3>
<a href=mailto:althea-developers@list.sourceforge.net class=white>e-mail</a>
</td>
<td bgcolor=black>
<font face='arial, helvetica' color=white size=3>
</td>
</tr>
</table>
<br><br><br><br><br>
<img align=right src=images/althea.png>
<!-- --------------- table of contents ------------------ -->
<!-- --------------- table of contents ------------------ -->
<!-- --------------- table of contents ------------------ -->
<!-- --------------- table of contents ------------------ -->
<font size=4 face='arial, helvetica' color=black>
<div align=right><b>:: table of contents</b><br>
</font>
<!-- small BLACK LINE TABLE -->
<TABLE BORDER=0 WIDTH=50% CELLPADDING=0 CELLSPACING=0><TR><TD BGCOLOR=#000000 HEIGHT=1>
<TABLE BORDER=0 WIDTH=100% CELLPADDING=0 CELLSPACING=0><TR><TD></TD></TR></TABLE>
</TD></TR></TABLE>
<!-- CLOSE BLACK LINE TABLE -->
</div>
<font size=3 face='arial, helvetica' color=black>
<ul>
<b> <a href=#whatIsAlthea>What Is Althea?</a></b><br>
<br>
<br>
<b> <a href=#gettingStarted>Getting Started</a></b><br>
<ul>
<br>
<b><a href=#download>Download</a></b><br>
<b><a href=#installation>Installation</a></b><br>
<b><a href=#sslhelp>SSL Help</a></b><br>
<br>
<br>
</ul>
<b> <a href=#typicalSession>A Typical Session</a></b><br>
<br>
<br>
<b> <a href=#configuration>Configuration</a></b><br>
<ul>
<br>
<b><a href=#configfileformat>File Format</a></b><br>
<b><a href=#guiconfig>Configuration Tool</a></b><br>
<br>
<br>
</ul>
<b> <a href=#toolbar>Toolbar</a></b><br>
<ul>
<br>
<br>
</ul>
<b> <a href=#menus>Menus</a></b><br>
<ul>
<br>
<b><a href=#altheaMenu>Althea menu</a></b><br>
<b><a href=#messageMenu>Message menu</a></b><br>
<b><a href=#helpMenu>Help menu</a></b><br>
<br>
<br>
</ul>
<b> <a href=#moreinfo>More Info</a></b><br>
<ul>
<br>
<br>
</ul>
<b> <a href=#credits>Credits</a></b><br>
<ul>
<br>
<b> <a href=#history>History</a></b><br>
<b> <a href=#name>Althea's Name</a></b><br>
<b> <a href=#devTeam>the Althea Development Team</a></b><br>
<b> <a href=#contact>Contact</a></b><br>
<br>
<br>
</ul>
<br><br>
<br><br>
<br><br>
<!-- BLACK LINE TABLE -->
<TABLE BORDER=0 WIDTH=100% CELLPADDING=0 CELLSPACING=0><TR><TD BGCOLOR=#000000 HEIGHT=1>
<TABLE BORDER=0 WIDTH=100% CELLPADDING=0 CELLSPACING=0><TR><TD></TD></TR></TABLE>
</TD></TR></TABLE>
<!-- CLOSE BLACK LINE TABLE -->
<br><br>
<!-- --------------- What Is Althea? ------------------ -->
<!-- --------------- What Is Althea? ------------------ -->
<!-- --------------- What Is Althea? ------------------ -->
<!-- --------------- What Is Althea? ------------------ -->
<font size=4>
<b> <a name=whatIsAlthea>What Is Althea?</a></b><br>
</font>
<ul>
The designers of Althea felt that there wasn't a stable, easy to use, GUI, IMAP (Internet Message Access Protocol) e-mail client for X Windows. The design goal was a stable e-mail client with the richness of usability of Microsoft's Outlook, Qualcomm's Eudora, and Cyrusoft's Mulberry.
<br><br>
Questions, comments, and code welcome at: althea-developers@lists.sourceforge.net
<br>
<br>
<br>
</ul>
<!-- --------------- Getting Started ------------------ -->
<!-- --------------- Getting Started ------------------ -->
<!-- --------------- Getting Started ------------------ -->
<!-- --------------- Getting Started ------------------ -->
<font size=4>
<b> <a name=gettingStarted>Getting Started</a></b><br>
</font>
<ul>
<b><a name=download>Download</a></b><br>
Althea is available for download from <a href=http://prdownloads.sourceforge.net/althea/althea-0.5.3.tgz><b>http://prdownloads.sourceforge.net/althea/althea-0.5.3.tgz</b></a> <br>
<br>
<b><a name=installation>Installation</a></b><br>
Type the following commands: <br><br>
# unzip and untar althea-x.x.x.tgz<br>
tar xvzf althea-x.x.x.tgz<br><br>
# make and install the program<br>
make<br>
make install<br><br>
And you are done!<br>
<br>
<b><a name=sslhelp>SSL Help</a></b><br>
As of version 0.5, Althea has support for IMAP over SSL. Due to the overwhelming amount of support requests for installation, we need to make some things clear on how to use SSL with Althea. <br>
First, you can disable SSL support by editing the Makefile. Also, many people report trouble with finding the openssl libraries and header files. If you are using some kind of packaging system (like RedHat or Mandrake) to install openssl, you will need the openssl-devel package. This package contains those header files that are necessary to compile althea. If you aren't using a packaging system to install openssl (you are building from source), then you need to make sure that the openssl gets install, that is, you type make install. If you have any problems compiling, let us know at: althea-developers@lists.sourceforge.net. When Althea starts to use autoconf (near future) this will be easier. We promise!<br>
<br>
<br>
<br>
</ul>
<!-- --------------- A Typical Session ------------------ -->
<!-- --------------- A Typical Session ------------------ -->
<!-- --------------- A Typical Session ------------------ -->
<!-- --------------- A Typical Session ------------------ -->
<font size=4>
<b> <a name=typicalSession>A Typical Session</a></b><br>
</font>
<ul>
<a href=images/typicalSession.png>
<img border=0 src=images/typicalSessionSmall.png align=right>
</a>
When Althea first starts, it checks for a configuration file in your
home directory named .althearc file. If that fails the program looks in
/etc/althearc for the default configuration information. After loading
this information, Althea is ready to use. <br><br>
On the left side of Althea's main window is a directory tree of servers. Each server can have several subfolders each of which contain mail. Generally the subfolder titled INBOX is where your new mail is located. On the right side of Althea's main window is a list of messages in the currently selected folder. When select a message, the contents are displayed in the text area below. Most of the actions you'll want to perform in a typical session is availble from the <a href=#toolbar><b>toolbar</b></a>. <br>
<br>
<br>
<br>
<br>
<br>
</ul>
<!-- --------------- Configuration ------------------ -->
<!-- --------------- Configuration ------------------ -->
<!-- --------------- Configuration ------------------ -->
<!-- --------------- Configuration ------------------ -->
<b> <a name=configuration>Configuration</a></b><br>
</font>
<ul>
<br>
<b><a name=configfileformat>File Format</a></b><br>
<ul>
With the release of our new XMLish configuration scheme and GUI configuration tool in v 0.4, we have, hopefully, made configuration a ton easier than previous versions.<br><br>
You still have a .althearc file in your home directory that gets read in, but you also have a utility in althea to edit those preferences. The format of the new XML scheme is thus for Servers: <br><br>
<Server><br>
<name>MyServer</name><br>
<smtpserver>smtp.fsf.com</smtpserver><br>
<imapserver>imap.fsf.com</imapserver><br>
<imapport>143</imapport><br>
<username>myUsername</username><br>
<password>myPassword</password><br>
<mailbox>~/mail</mailbox><br>
<fccfolder>sent-mail</fccfolder><br>
</Server><br><br>
There is more information on the new format in the althearc.example file that comes with the package. And in fact, you should not need to edit your .althearc file by hand anymore due to the Configuration Tool<br><br>
</ul>
<b><a name=guiconfig>Configuration Tool (Setup Menu Item)</a></b>
<img border=0 align=right src=images/configSession.png><br>
<ul>
The "setup" menu item, aka GUI configuration, is a tool that will edit your .althearc file. Here is a typical session of the configuration window. There are buttons to "add", "edit", and "delete" servers. As of 0.4, this server configuration screen is the only one that has any effect. <br><br>
You can modify your servers and then click the "Ok" button to save your saves out to your .althearc file. Clicking cancel will save none of your changes.<br><br>
<b>NOTE:</b> When you click "Ok" to save your changes, it writes your changes out to your .althearc file but does not reload those preferences. You will have to close althea and restart to see the changes.
</ul>
<br>
<br>
<br>
<br>
</ul>
<!-- --------------- Toolbar ------------------ -->
<!-- --------------- Toolbar ------------------ -->
<!-- --------------- Toolbar ------------------ -->
<!-- --------------- Toolbar ------------------ -->
<font size=4>
<b> <a name=toolbar>Toolbar</a></b><br>
</font>
<img border=0 align=right src=images/toolbar.png>
<ul>
<br><b> New</b><br>
Open a new window for creating a new message.
<br><br><b> Save</b><br>
Save the currently opened message to your hard disk.
<br><br><b> Print</b><br>
Print the currently opened message. Defaults to 'lpr %s'.
Allows you to change the print command. The user can include '%s' in the
print command to indicate where the filename should go.
<br><br><b> Reply</b><br>
Compose a reply to the currently open message.
<br><br><b> Forward</b><br>
Compose a message with the currently open message included at the end.
<br><br><b> Delete Mail</b><br>
Mark the currently selected message for deletion.
<br><br><b> Check Mail</b><br>
Check the currently selected server for new mail.
<br>
<br>
<br>
</ul>
<!-- --------------- Menus------------------ -->
<!-- --------------- Menus------------------ -->
<!-- --------------- Menus------------------ -->
<!-- --------------- Menus------------------ -->
<font size=4>
<b> <a name=menus>Menus</a></b><br>
</font>
<ul>
<br>
<!-- --------------- althea menu ------------------ -->
<b><a name=altheaMenu>Althea menu</a></b><br>
<img border=0 align=right src=images/altheaMenu.png>
<ul>
<br><br><b>Check Mail </b><br>
Check the currently selected server for new mail.
<br><br><b>Setup </b><br>
Open the Configuration window to edit preferences.
<br><br><b>Exit </b><br>
Exit Althea.
<br>
<br>
<br>
</ul>
<!-- --------------- message menu ------------------ -->
<b><a name=messageMenu>Message menu</a></b><br>
<img border=0 align=right src=images/messageMenu.png>
<ul>
<br><br><b>New Message </b><br>
Open a new window for composing a new message.
<br><br><b>Save Message </b><br>
Save the currently opened message to your hard disk.
<br><br><b>Reply</b> <br>
Reply to currently open message.
<br><br><b>Forward</b><br>
Forward the currently open message.
<br><br><b>Print </b><br>
Print the currently opened message. Before printing starts, you will be given the chance to change the default print command ('lpr %s', where %s will be replaced by the message's name) to something more suitable for your system (for example, 'lpr -P myprinter %s').
<br><br><b>Delete</b><br>
Mark the currently selected message for deletion.
<br><br><b>Undelete</b><br>
Unmark the currently selected message for deletion.
<br>
<br><br><b>Expunge</b><br>
Delete all messages marked for deletion.
<br>
<br>
<br>
</ul>
<!-- --------------- help menu ------------------ -->
<b><a name=helpMenu>Help menu</a></b><br>
<img border=0 align=right src=images/helpMenu.png>
<ul>
<br><br><b>Contents</b><br>
Opens this help document.
<br>
<br><br><b>About</b><br>
Opens the About dialog box (with credits and such of the like).
<br>
<br>
<br>
</ul>
</ul>
<!-- --------------- Address Book ------------------ -->
<!-- --------------- Address Book ------------------ -->
<!-- --------------- Address Book ------------------ -->
<!-- --------------- Address Book ------------------ -->
<!-- --------------- More Info -------------------- -->
<!-- --------------- More Info -------------------- -->
<!-- --------------- More Info -------------------- -->
<!-- --------------- More Info -------------------- -->
<font size=4>
<b> <a name=moreinfo>More Info<a></b><br>
</font>
<br>
<ul>
If you want more information about the project, including the latest news and CVS source, go to <b><a href="http://sourceforge.net/projects/althea/">http://sourceforge.net/projects/althea/</a></b>.<br>
</ul>
<br>
<br>
<!-- --------------- Credits ------------------ -->
<!-- --------------- Credits ------------------ -->
<!-- --------------- Credits ------------------ -->
<!-- --------------- Credits ------------------ -->
<font size=4>
<b> <a name=credits>Credits</a></b><br>
</font>
<ul>
<a name=history><b>History</b></a><br>
Althea began as a independent study project at Carleton College in February 2000 with Jeff Ondich, advisor and six students, Bryan Dotzour, Eric Johnson, Nate Kohl, Will Mulvihill, Keith Resar, and Ethan Sommer. It has since been carried on by some of those members and is working toward supporting all the features the original authors designed for it.<br>
<br>
<a name=name><b>Althea's Name</b></a><br>
Several names were tossed around. The recursive acronym had its attractions, but in the end, Althea was chosen in honor of Bryan Dotzour's wife. <br>
<br>
<a name=devTeam><b>the Althea Development Team</b></a><br>
Bryan Dotzour <Dwighthammer><br>
Eric Johnson <soupMonkey> <br>
Nate Kohl<br>
Will Mulvihill <Thriller><br>
Jeff Ondich <br>
Keith Resar <Heavy><br>
Ethan Sommer<br>
<br>
<a name=contact><b>Contact</b></a><br>
Questions, comments, and code welcome at: althea-developers@lists.sourceforge.net
<br>
<br>
<br>
</ul>
<br><br>
</font>
</body>
</html>
