From: Finn B. <bc...@us...> - 2000-11-12 22:47:44
|
Update of /cvsroot/jython/htdocs In directory slayer.i.sourceforge.net:/tmp/cvs-serv19901 Added Files: download.ht index.ht install.ht platform.ht users.ht Log Message: First version. --- NEW FILE --- Title: Download Jython <h3>Download Jython</h3> <em><b>Developers note:</b> The latest snapshopts of the Jython source code is now <a href="http://sourceforge.net/cvs/?group_id=12867"> available via CVS</a>!</em> <p>Here are the steps you need to perform in order to download Jython. Once you've done this, you should read the <a href="install.html">installation instructions</a>. <ol> <li><b>Check that you have a working Java 1.1 or 1.2 compatible JVM installed</b> <P>If you already know that you have a JVM which is Java 1.1 or 1.2 compliant, go on to step 2. Otherwise, you should read this information on <A HREF="platform.html">finding and installing an appropriate JVM for your platform</A>. <p><li><b>Download Jython</b> <p>Please use the following links to view and accept the licenses for Jython 2.0. <p><ul> <li><a href="license.html">Read the license</a> <li><a href="http://sourceforge.net/project/showfiles.php?group_id=12867"> Download Jython 2.0 alpha 1</a> <li><a href="install.html">View Installation instructions</a> </ul> <p><li><b>Subscribe to the Jython-users mailing list (<i>optional</i>)</b> <P>The <A HREF="http://lists.sourceforge.net/mailman/listinfo/jython-users"> Jython-users</a> mailing list is used to discuss using Jython effectively, what features Jython needs, and to make announcements of new releases. The web page below will allow you to subscribe to the list. It will also let you view the past archives of the list. This mailing list is managed by <a href="http://www.list.org/">Mailman</a>. <p><li><b>Send a short note telling us what you're doing/what you need (<i>optional</i>)</b> <P>We'd really like to hear what people are doing with Jython as well as what they'd like to do but can't because some feature is missing. You can drop us a note at <a href="mailto:jyt...@li...">jython-dev</a>. Example comments: <p><HR ALIGN="CENTER"> <TT>I'd love to build an amazing new FooBar with Jython, but I can't because it's too slow/doesn't support applets well enough/has a too restrictive license/needs to support the foo.py module/has too many bugs/doesn't have enough documentation/...</TT> <BR> <HR ALIGN="CENTER"> <TT>I'm building an amazing FooBar with Jython by doing X, Y, and Z, and it is so easy in Jython that my boss thinks I'm a genius!</TT><BR> <HR ALIGN="CENTER"> <p>We'd love it too, if you send a short blurb about yourself, your project, or your company, so we can add it to the <a href="users.html">Jython Users</a> page. <p><li><b>Join the PSA (<i>optional</i>)</b> <p>Show you support for Python and Jython by joining the <a href="http://www.python.org/psa/">Python Software Activity</a>! </UL> <p> --- NEW FILE --- Title: Jython Home Page <p>Welcome to the Jython homepage. Jython is an implementation of the high-level, dynamic, object-oriented language <a href="http://www.python.org/">Python</a> written in 100% Pure Java, and seamlessly integrated with the <a href="http://www.javasoft.com">Java</a> platform. It thus allows you to run Python on any Java platform. <ul> <li>What is <A HREF="docs/whatis.html">Jython</A> <li><A HREF="download.html">Download</a> the lastest version. <li><A HREF="docs/index.html">Documentation</A> <li>The Jython <A HREF="docs/faq.html">FAQ</A>. </ul> <h3><em><font size=+1 color="red">Jython News</font></em></h3> <em><b>Note that these pages does not correctly reflect the current state of Jython. Most importantly, there does not yet exists a downloadable version. </b></em> <dl> <!-- <dt><b>Jython 2.0 alpha 1 released!</b> <dd>Download Jython <a href="download.html">here</a>, or <a href="NEWS">read a summary</a> of recent changes. (XX-oct-2000). --> <p><dt>Jython project announced <dd>The Jython project have started on sourceforge. Read the <a href="http://www.python.org/pipermail/jpython-interest/2000-October/006417.html"> announcement</a>. </dl> <h3><em><font size=+1 color="red">Jython In the press</font></em></h3> <dl> <dt>2000-11-08 <dd>JPython is mentioned in an <a href="http://www.javasoft.com/features/2000/11/dotnetvsms.html?frontpage-banner"> article</a> that compares the Java platform with MicroSoft's .NET </dl> --- NEW FILE --- Title: Installing Jython <H3>Installation</H1> <P>Jython is distributed as a self-extracting .class file created by <A HREF="http://liftoff.sourceforge.net">LiftOff</A>. To install Jython, open the command line to the directory in which you have placed the Jython-20a1.class file and then type: <BLOCKQUOTE> <P><java interpreter> Jython-20a1</P> </BLOCKQUOTE> <P>You will probably type one of the following three lines, depending on your system. <b>Be sure <em>not</em> to put ".class" at the end of the file name.</b> <BLOCKQUOTE> <P><TT>java Jython-20a1</TT></P> <P><TT>jre Jython-20a1</TT></P> <P><TT>jview Jython-20a1</TT> </BLOCKQUOTE> <p>It can be necessay to set the CLASSPATH to include the current directory <BLOCKQUOTE> <P><TT>env CLASSPATH=. java Jython-20a1</TT> <P><TT>java -cp . Jython-20a1</TT> <P><TT>java -classpath . Jython-20a1</TT> <P><TT>jview /cp:. Jython-20a1</TT> </BLOCKQUOTE> <P>Which command to use depends on your operating system and java version. <P>If you do not have a GUI, then add <tt>-o dir_to_install_to</tt> to the command above. Jython will install to the specified directory without bringing up the graphical installer. E.g. to install all modules to a Jython-2.0 subdirectory in the current directory do: <BLOCKQUOTE> <P><TT><java interpreter> Jython-20a1 -o Jython-2.0 demo lib source</TT> </BLOCKQUOTE> <P>After completing installation, you should be able to run Jython by typing:</P> <BLOCKQUOTE> <P><TT>jython</TT></P> </BLOCKQUOTE> <H3>What Can Go Wrong</H3> <P>You should check out this section if your Jython installation doesn't quite work right. It will contain tips for solving the most common problems. <H4>Can't Access Standard Python Modules</H4> <P>By default, Jython only installs a small collection of the standard Python modules. This is due the fact that much of the functionality of these modules is duplicated by Java packages. If you want to use parts standard Python library that are not included with Jython, you have select the "Library" during installation or add pointer in python.path to the Lib directory of a preexisting Python 2.0 distribution. This requires editing your "registry" file. <H4>Other Problems</H4> <P>Any other problems with the installation should be reported to <A HREF="mailto:pyt...@li...">jython-dev</A>. <P>As a workaround you can extract the jython-20a1.class manually. The class file is basicly a .zip file and most unzip programs can manage to extract the contents of the class into a directory. After doing that, you must <ul> <li>Remove the <tt>net</tt> directory. It isn't needed. <li>Create the startup script by hand. Use the <tt>template*</tt> files as a starting point in doing so. </ul> <H4>Platform Specific Notes</H4> <P>If all else fails, you might find that your problem is unique to your platform, and has a solution mentioned on the <A HREF="platform.html">Platform Specific Information</A> page. <p> --- NEW FILE --- Title: Platform Specific Notes</TITLE> <H2>Platform Specific Information: <I>Finding a Good JVM</I></H2> <P>Jython is 100% Pure Java and should run successfully on any bug-free fully 1.1 or 1.2 compliant JVM. Unfortunately, such a beast can sometimes be hard to find. The following is a collection of notes for getting Jython to run (and run well) on specific OS's and JVM's. Since performance can also vary considerably across JVM implementations, this page will also contain information regarding Jython's performance on different platforms. <P>This list of platform specific information is clearly incomplete. If you find this information to be incorrect for your particular platform, or if you have tips for running Jython on a platform not mentioned on this page, please send that information to <A REF="mailto:jyt...@li...">jython-dev</A>. If your platform is not included in the list below, you might be able to get useful information from SUN's <A HREF="http://www.javasoft.com/cgi-bin/java-ports.cgi"> list of third-party JVM's</A>. <H3 ALIGN="CENTER">Operating Systems</H3> <H3>Irix</H3> <H4><A HREF="http://www.sgi.com/developers/devtools/languages/java.html"> Java Development Environment 3.1.1 from SGI</A></H4> <P>Jython will work with the 3.0.1 version of the JDE (which is based on the 1.1.3 JVM), but there are a number of significant known bugs in this release. I strongly recommend using to the 3.1 release on this platform. <P> <H3>Linux</H3> <H4><A HREF="http://www.blackdown.org/java-linux.html">JDK 1.1.6 from blackdown.org</A></H4> <P>There should be no problems running Jython on this JVM. <H3>Macintosh</H3> <P>Mizutori Tetsuya has made available an application called JPython Runner to make it easier to use JPython on this system. More details on this system can be found at <A HREF="http://www.bekkoame.ne.jp/~mizutori/java/index.html#jpythonrunner"> JPython Runner for Macintosh</A>. This link also contains pointers to the lastest JVM for Macintosh. <P>Hopefully, future releases of Jython will be able to incorporate either this technology or something like it to make life easier for Macintosh users. <H3>Solaris</H3> <H4><A HREF="http://www.sun.com/solaris/jre/index.html">JRE 1.1.6 from SUN</A></H4> <P>Solaris 2.6 comes with JDK 1.1.3. The JIT compiler in this release has a number of serious bugs that can lead to confusing errors. You can type "java -version" to determine what release you have installed on your machine. While Jython will generally work with the 1.1.3 JVM, I strongly recommend that Solaris users upgrade to this latest version to avoid being bitten by hard to track down JIT related bugs. <H3>Windows NT, 95, and 98, Windows 2000</H3> <H4><A HREF="http://java.sun.com/j2se/1.3/"> JDK/JRE 1.3 from SUN</A> <I>(My recommendation for this platform)</I></H4> <P>This is amoung the fastest of the JVM's for Windows, and it also the most compatible with the official Java specification. I'd strongly encourage people to start with this VM, and only consider trying alternatives if they find performance to be a serious problem for their application. <H4><A HREF="http://www.microsoft.com/java/">JView from Microsoft</A></H4> <P>If you have IE 4.0 installed, you almost certainly already have this VM. Type "jview" at a command prompt to be sure. Note: if the copyright dates you see when you type "jview" do not include 1998, you have an older VM. Either download a recent version of IE 4.0, or download the VM directly from the site above. <P>If you want to write Jython code that takes advantage of Windows specific functionality (using win32 api's, interacting with COM objects, ...) then this VM will give you all of the platform specific functionality you could desire. <H3 ALIGN="CENTER">Cross-Platform JVM's</H3> <H3>Kaffe</H3> <P>Jython does not work with the current version available from transvirtual. This appears to be both due to some small incompatibilities between this Java VM and SUN's version, as well as at least one serious issue which is the lack of a java.math.BigInteger class -- this lack will be a problem for any VM that only implements the PersonalJava subset of the full Java spec. It should be possible to get Jython working on this VM if someone has the time to invest, please let us know if you have any success here or need any help. --- NEW FILE --- Title: Who uses Jython <h3>Who uses JPython?</h3> Here's a partial list of projects and users of Jython. If you are aware of any others, or would like to get your projects listed here, just drop us a message at jyt...@li.... |