html/RELEASENOTES.html

   1 <HTML>
   2 <HEAD>
   3    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   4    <META NAME="Author" CONTENT="Ulrich Luckas">
   5    <META NAME="GENERATOR" CONTENT="Mozilla/4.04 [en] (X11; I; SunOS 5.6 sun4m) [Netscape]">
   6    <TITLE>MUMail %VERSION_MAJOR%</TITLE>
   7 </HEAD>
   8 <BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EE" VLINK="#551A8B" ALINK="#FF0000">
   9 &nbsp;
  10 <CENTER><TABLE BORDER=0 WIDTH="100%">
  11 <TR>
  12 <TD><IMG SRC="Title.gif" HEIGHT=120 WIDTH=150 ALIGN=CENTER>&nbsp;</TD>
  13
  14 <TD>
  15 </CENTER>
  16 <H1>
  17 MUMail version %VERSION_MAJOR%</H1></CENTER>
  18 </TD>
  19 </TR>
  20 </TABLE></CENTER>
  21 &nbsp;
  22
  23 <H2>Table of Contents</H2>
  24 <UL>
  25 <LI><a href="#What">What is it</a>
  26 <LI><a href="#New">What's new</a>
  27 <LI><a href="#Features">Features</a>
  28 <LI><a href="#Limitations">Konwn limitations</a>
  29 <LI><a href="#Future">Future plans</a>
  30 <LI><a href="#Parameter">Parameter</a>
  31 <LI><a href="#Try">How to try it</a>
  32 <LI><a href="#Security">Security restrictions</a>
  33 <LI><a href="#Demo">Online demo</a>
  34 <LI><a href="#Download">Download</a>
  35 <LI><a href="#Copyright">Copyright</a>
  36 <LI><a href="#Licensing">Licensing</a>
  37 <LI><a href="#Authors">The designers</a>
  38 </UL>
  39
  40 <H2><a name="What"></a>
  41 What is it</H2>
  42 MUMail is a Java applet designed to let you read your mail from your home
  43 page. So you can read your mail when there is no mail reader available,
  44 or if you don't want to change the configuration of someone else's mail
  45 reader. All you need is a Java 1.1 compliant Web browser.
  46
  47 <H2><a name="New"></a>
  48 What's new</H2>
  49
  50 <UL>
  51 <LI>New <A HREF="#Parameter">Parameter</A> <TT>mailAddress</TT>
  52 </LI>
  53 </UL>
  54
  55 <H2><a name="Features"></a>
  56 Features</H2>
  57
  58 <UL>
  59 <LI>
  60 <A HREF="#Licensing">Free software</A> under the terms of the GNU General Public License</LI>
  61
  62 <LI>
  63 Platform independent</LI>
  64
  65 <LI>
  66 Only %JAR_SIZE% K <A HREF="#Download">JAR file</A></LI>
  67
  68 <LI>
  69 Easy to use GUI</LI>
  70
  71 <LI>
  72 Nice art work</LI>
  73
  74 <LI>
  75 POP3 protocol support</LI>
  76
  77 <LI>
  78 IMAP4 protocol support (for INBOX only)</LI>
  79
  80 <LI>
  81 SMTP protocol support</LI>
  82
  83 <LI>
  84 MIME compliant</LI>
  85
  86 <LI>
  87 Support for most common body part types: text, multipart, image, audio,
  88 application-octetstream</LI>
  89
  90 <LI>
  91 Extendable through user supplied MIME classes</LI>
  92 </UL>
  93
  94 <H2><a name="Limitations"></a>
  95 Konwn limitations</H2>
  96
  97 <UL>
  98 <LI>Maleformed MIME messages can cause Java exceptions.</LI></UL>
  99
 100 <H2><a name="Future"></a>
 101 Future plans</H2>
 102
 103 <UL>
 104 <LI>
 105 Improve GUI with JFC/Swing</LI>
 106
 107 <LI>
 108 IMAP4 (folder) support</LI>
 109
 110 </UL>
 111
 112 <H2><a name="Parameter"></a>
 113 Parameter</H2>
 114
 115 <H4>
 116 Applet:</H4>
 117
 118 Here is a list of all applet parameters MUMail knows:
 119
 120 <TABLE border="1">
 121 <TR>
 122 <TH>
 123 Name
 124 </TH>
 125 <TH>
 126 Typ
 127 </TH>
 128 <TH>
 129 Description
 130 </TH>
 131 </TR>
 132 <TR>
 133 <TD>PopHost</TD>
 134 <TD>String</TD>
 135 <TD>name of POP3 server</TD>
 136 </TR>
 137 <TR>
 138 <TD>SmtpHost</TD>
 139 <TD>String</TD>
 140 <TD>name of SMTP server</TD>
 141 </TR>
 142 <TR>
 143 <TD>PopPort</TD>
 144 <TD>Integer</TD>
 145 <TD>portnumber of POP3 server (usually 110)</TD>
 146 </TR>
 147 <TR>
 148 <TD>SmtpPort</TD>
 149 <TD>Integer</TD>
 150 <TD>portnumber of SMTP server (usually 25)</TD>
 151 </TR>
 152 <TR>
 153 <TD>User</TD>
 154 <TD>String</TD>
 155 <TD>login name for POP3 authentication</TD>
 156 </TR>
 157 <TR>
 158 <TD>Password</TD>
 159 <TD>String</TD>
 160 <TD>password for POP3 authentication (<font color="#FF0000">Warning: Do not use on public webpages!</font>)</TD>
 161 </TR>
 162 <TR>
 163 <TD>showFontChoice</TD>
 164 <TD>boolean</TD>
 165 <TD>true enables changing of fonts of mail bodys view</TD>
 166 </TR>
 167 <TR>
 168 <TD>novice</TD>
 169 <TD>boolean</TD>
 170 <TD>true disables possibility to configure server names und ports  at runtime -
 171 useful for novice users at preconfigured sites.</TD>
 172 </TR>
 173 <TR>
 174 <TD>authorizedSend</TD>
 175 <TD>boolean</TD>
 176 <TD>true disables possibility to send mail without authorizing on POP3 server.
 177 After succesful login, sending is allowed; but not to change
 178 the <em>From:</em> field.</TD>
 179 </TR>
 180 <TR>
 181 <TD>headerListRows</TD>
 182 <TD>Integer</TD>
 183 <TD>changes the number of rows displayed in list of mail headers (1<<em>x</em><20)</TD>
 184 </TR>
 185 <TR>
 186 <TD>MailDomain</TD>
 187 <TD>String</TD>
 188 <TD>domain name part of this sites email adresses</TD>
 189 </TR>
 190 <TR>
 191 <TD>protocolSelect</TD>
 192 <TD>boolean</TD>
 193 <TD>true enables you to select a protocol at login screen,
 194 currently POP3 and IMAP4</TD>
 195 </TR>
 196 <TR>
 197 <TD>MailAddress</TD>
 198 <TD>String</TD>
 199 <TD>complete mail address for sending mail (optional, in case it differs from User@MailDomain)</TD>
 200 </TR>
 201 </TABLE>
 202
 203 <H4>
 204 Application:</H4>
 205
 206 To get a list of parameters simply run MUMail as:
 207
 208 <TT>java&nbsp;mumail.MUMail&nbsp;-h</TT>
 209
 210 <H2><a name="Try"></a>
 211 How to try it</H2>
 212
 213 <H4>
 214 Applet:</H4>
 215 Make sure your browser supports Java 1.1 applets. Browsers known to support
 216 Java:
 217 <UL>
 218 <LI>
 219 Sun's HotJava 1.1/3.0</LI>
 220
 221 <LI>
 222 Netscape Navigator 4.07 and later</LI>
 223
 224 <LI>
 225 Microsoft Internet Explorer 4.01 and later</LI>
 226
 227 <LI>
 228 Opera</LI>
 229
 230 <LI>
 231 Sun JDK 1.1 and later Appletviewer</LI>
 232
 233 <LI>
 234 Also notice Sun's <A HREF="http://java.sun.com/products/activator/">Java Plug-In project</A></LI>
 235 </UL>
 236 Next you need a Web server and a POP3 server. Due to java's applet security
 237 feature both
 238 servers need to be on the same host. This restriction can be worked around
 239 on the Sun products by disabling the corresponding security settings (see&nbsp;
 240 <A HREF="#Security">Security Restrictions</A>).
 241
 242 <P>Download <TT><A HREF="MUMail.%VERSION_MINOR%.zip">MUMail.%VERSION_MINOR%.zip</A></TT>&nbsp;
 243 (~ %ZIP_SIZE%K), <TT><A HREF="MUMail.%VERSION_MINOR%.tar.gz">MUMail.%VERSION_MINOR%.tar.gz</A></TT> (~ %TAR_SIZE%K) or <TT><A HREF="MUMail.%VERSION_MINOR%.tar.bz2">MUMail.%VERSION_MINOR%.tar.bz2</A></TT>
 244 (~ %BZIP_SIZE%K) and unpack it in a directory that is published by your
 245 Web server. This creates a directory called MUMail containing these files:
 246 <UL>
 247 <LI>
 248 <TT>MUMail.html</TT></LI>
 249
 250 <LI>
 251 <TT>MUMail.jar</TT></LI>
 252
 253 <LI>
 254 <TT>MUMail.gif</TT></LI>
 255
 256 <LI>
 257 <TT>Title.gif</TT></LI>
 258
 259 <LI>
 260 <TT>Screenshot.gif</TT></LI>
 261
 262 <LI>
 263 <TT>RELEASENOTES.html</TT></LI>
 264
 265 <LI>
 266 <TT>gpl.html</TT></LI>
 267
 268 <LI>
 269 <TT>philosophical-gnu-sm.jpg</TT></LI>
 270 </UL>
 271 Now load <EM>http://xxx.xxx.xxx/xxx/MUMail/MUMail.html</EM>
 272 into your browser and start reading Mail.
 273 <BR>&nbsp;
 274 <H4>
 275 <A NAME="Application"></A>Application:</H4>
 276 You can also run MUMail as a java application if you have Sun's JRE or
 277 JDK available.
 278
 279 <P>To start MUMail you need to copy MUMail.jar and MUMail.gif into one
 280 directory. Change to that directory and start the class <TT>mumail.MUMail</TT>.
 281 <BR>On a UNIX machine for example you can use a script just like the one
 282 below. Enter the MUMail directory name, your POP3 and your SMTP server
 283 name into the script below. Make it executable and start it.<TT></TT>
 284
 285 <P><TT>#!/bin/sh</TT><TT></TT>
 286
 287 <P><TT>MUDIR="enter your installation directory here"</TT>
 288 <BR><TT>POPSRV="your POP3 server"</TT>
 289 <BR><TT>SMTPSRV="your SMTP server"</TT><TT></TT>
 290
 291 <P><TT>cd "$MUDIR"</TT><TT></TT>
 292
 293 <P><TT>if [ -z "$CLASSPATH" ]; then</TT>
 294 <BR><TT>&nbsp; if [ -n "$JAVA_HOME" ]; then</TT>
 295 <BR><TT>&nbsp;&nbsp;&nbsp; CLASSPATH="$JAVA_HOME"/lib/classes.zip</TT>
 296 <BR><TT>&nbsp; elif [ -n "$JDK_HOME" ]; then</TT>
 297 <BR><TT>&nbsp;&nbsp;&nbsp; CLASSPATH="$JDK_HOME"/lib/classes.zip</TT>
 298 <BR><TT>&nbsp; elif [ -n "$JRE_HOME" ]; then</TT>
 299 <BR><TT>&nbsp;&nbsp;&nbsp; CLASSPATH="$JRE_HOME"/lib/classes.zip</TT>
 300 <BR><TT>&nbsp; fi</TT>
 301 <BR><TT>fi</TT><TT></TT>
 302
 303 <P><TT>java -classpath "$MUDIR"/MUMail.jar:"$CLASSPATH" mumail.MUMail \</TT>
 304 <BR><TT>&nbsp;&nbsp;&nbsp;&nbsp; -pophost "$POPSRV" -smtphost "$SMTPSRV"</TT>
 305 <BR><TT>&nbsp;</TT>
 306 <H2>
 307 <A NAME="Security"></A>Security restrictions</H2>
 308 Java security restriction prevent an applet from connecting to any host
 309 on the network except where the applet was loaded from. This means to MUMail
 310 when run as an applet that it can only connect to a POP3 server on the
 311 same host where your Web server is running.
 312
 313 <P>Sun's HotJava, the Appletviewer from most (SUN-based) JDK's and also
 314 MS InternetExplorer 4/5 have ways to relax
 315 security settings though. If you relax the security settings you will be
 316 able to read mail from any POP3 server on the Internet.
 317
 318 <P>For Appletviewer you select <B><I>Properties...</I></B> from the <B><I>Applet</I></B>
 319 menu and change <B><I>Network access:</I></B> to <B><I>Unrestricted</I></B>.
 320
 321 <P>For HotJava1.x select <B><I>Preferences -> Applet security... </I></B>from
 322 the <B><I>Edit</I></B> menu and select <B><I>Medium Security</I></B> for
 323 <B><I>Unsigned Applets</I></B>. Hit the <B><I>Apply</I></B> button and
 324 you are all set. With medium permission set HotJava will ask permission
 325 for all restricted actions. Just <I>allow this action</I> when you are
 326 asked for permission to connect to your POP server.
 327
 328 <P>For HotJava3.0 select <B><I>Edit -> Security Preferences...</I></B>. In
 329 the upcoming dialog switch to <B><I>Advandced</I></B> Security Administration
 330 Mode. Select the listentry <B><I>Applet and JavaScript</I></B> and switch
 331 to the <B><I>Ask first</I></B> choice.
 332
 333 <P>Microsoft InternetExplorer allows in the <B><I>Internet Option</I></B>
 334 Dialog under tab <B><I>Security</I></B> to change also Java security
 335 restrictions.
 336
 337 <P>So if you relaxed your security settings you can try the applet right
 338 <A HREF="#Demo">here</A>.
 339 <H2>
 340 <A NAME="Demo"></A>Online demo</H2>
 341
 342 <CENTER><APPLET codebase="." code="mumail.MUMail" align="baseline" width="600" height="440" archive="MUMail.jar"><PARAM name="User" value="enter_your_name"><I>your
 343 browser isn't Java-enabled, so you can only see a screenshot of the applet!</I>&nbsp;<IMG SRC="Screenshot.gif" BORDER=1 >&nbsp;</APPLET></CENTER>
 344
 345 <H2><A NAME="Download"></A>Download</H2></H2>
 346
 347 <UL>
 348 <LI><TT><A HREF="MUMail.%VERSION_MINOR%.zip">MUMail.%VERSION_MINOR%.zip</A></TT>&nbsp;(~ %ZIP_SIZE%K)
 349 <LI><TT><A HREF="MUMail.%VERSION_MINOR%.tar.gz">MUMail.%VERSION_MINOR%.tar.gz</A></TT>(~ %TAR_SIZE%K)
 350 <LI><TT><A HREF="MUMail.%VERSION_MINOR%.tar.bz2">MUMail.%VERSION_MINOR%.tar.bz2</A></TT>(~ %BZIP_SIZE%K)
 351 <LI><TT>Source: <A HREF="MUMail.%VERSION_MINOR%.src.tar.gz">MUMail.%VERSION_MINOR%.src.tar.gz</A></TT>(~ %SRC_SIZE%K)
 352 <LI><TT>Old Source: <A HREF="MUMail.1.3.0.src.tar.gz">MUMail.1.3.0.src.tar.gz</A></TT>(~ 20K)
 353 </UL>
 354
 355 <H2><a name="Copyright"></a>
 356 Copyright</H2>
 357 All copyrights by Mark T&uuml;mpfel, Uli Luckas and Steffi Schneider.
 358 <H2>
 359 <A NAME="Licensing"></A>Licensing</H2>
 360
 361 <P>
 362 This program is free software;
 363 you can redistribute it and/or modify it under the terms of the GNU General Public License
 364 as published by the Free Software Foundation;
 365 either version 2 of the License, or (at your option) any later version.
 366
 367 <P>
 368 This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
 369 without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 370
 371 <P>
 372 See the
 373 <A HREF="gpl.html">GNU General Public License</A>
 374 for more details.
 375
 376 <P>The authors kindly request a picture postcard to
 377 <UL><TT>Uli Luckas</TT>
 378 <BR><TT>Derfflingerstr. 29</TT>
 379 <BR><TT>D-10785 Berlin</TT>
 380 <BR><TT>Germany</TT></UL>
 381 from anyone who likes the product.
 382 <H2>
 383 <A NAME="Authors"></A>The designers</H2>
 384
 385 <UL>
 386 <LI>
 387 GUI design and implementation: Mark T&uuml;mpfel
 388 <a href="mailto:">marktop<dummy>[a]<dummy>cs.tu-berlin.de</a></LI>
 389
 390 <LI>
 391 Networking code and mail management: Uli Luckas
 392 <A HREF="mailto:">luckas<dummy>[a]<dummy>cs.tu-berlin.de</A></LI>
 393
 394 <LI>
 395 Art work: Steffi Schneider
 396 <A HREF="mailto:">Schneider.Steffi<dummy>[a]<dummy>web.de</A></LI>
 397 </UL>
 398
 399 <CENTER>
 400 <HR WIDTH="100%"><FONT SIZE=-2>This page has been accessed&nbsp;<accessed>
 401 times.</FONT></CENTER>
 402
 403 </BODY>
 404 </HTML>