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