xbrowser-4.2-src.rar_browser_xbrowser

************************************************************************** * XBrowser - eXtended web Browser * * * * Copyright (c) 2000-2001 Armond Avanes * * Refer to Software License For More Information * * * * Version 4.2 August 31, 2001 * * * * * * * * * * By: Armond Avanes * * Armond555@yahoo.com & Armond333@yahoo.com * * http://xbrowser.sourceforge.net/ * ************************************************************************** Table Of Contents --------------------------------- 1. Introduction 2. License Agreement & Copyright 3. Requirements 4. Building XBrowser 5. Running XBrowser 6. Runtime Parameters 7. More Information 8. Problems/Bug Reports & Feature Requests 9. Contact Information 1. Introduction ---------------- XBrowser is totally free and open-source java application for browsing the web. It will execute on any OS supporting Java 2 platform. It is fully multithreaded and it means that you can open several web pages simultaneously in one session. It is customizable, providing options for changing the way XBrowser looks and operates. It provides the basic features that every web browser needs to support plus much more advanced features such as printing and print preview, flexible searching among history, bookmarks and page contents, import/export facility in order to have your bookmarks from other famous browsers (IE, Netscape and Opera). Auto-Complete and Domain-Completion are two of the other useful features to reduce your amount of typing and save your time while surfing the net. Plugins/Extensions are also supported to extend the functionality of XBrowser in many ways. JavaScript and Cookies as well as page-caching are other great facilities being supported. All the program configuration as well as the bookmarks and history are kept in XML format in order to increase the data portability. It has been internationalized and ready to support more languages. 2. License Agreement & Copyright --------------------------------- The contents of this file are subject to the Sun Public License Version 1.0 (the "SunPL"); you may not use this file except in compliance with the SunPL. You may obtain a copy of the SunPL at http://www.sun.com/SPL/ Software distributed under the SunPL is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the SunPL for the specific language governing rights and limitations under the SunPL. * In addition to SunPL terms, I'm adding these terms too : A. Please note that only XBrowser source files and its documentation are distributed under SunPL, not the whole bundle. B. XBrowser and/or its source code and/or its related documentation may not be sold under any circumstances by any second party without the express written permission of Armond Avanes the author of XBrowser. In other word, you should get direct permission for using this product in commercial products/projects. 3. Requirements ---------------- Before you install and run XBrowser you need to install a Java 2 (Standard Edition, v1.2 or later) runtime environment on your computer. Below are some links to help you find Java 2 for your operating system: Windows, Solaris and Linux http://java.sun.com/j2se/1.3/ Linux/x86 http://www.blackdown.org AIX, Linux, AS/400, OS/2, OS/390 and Windows http://www.ibm.com/java/jdk/download/index.html HPUX http://www.enterprisecomputing.hp.com/java/ MacOS http://devworld.apple.com/java/text/download.html Note: It is recommended to use the latest versions of Java Runtime Environment in order to get a better result, performance and get into less bugs since a lot of improvements & bug fixes have been done!! 4. Building XBrowser --------------------- Please ignore this section if you've downloaded the User Release (ready to run). You should build XBrowser before running it so please follow these steps : Build process is now being done by ANT. It's a java based and platform independent scripting tool from Apache/Jakarta and lets you construst your build scripts in platform indepenedent manner. You can find more information about Ant at http://jakarta.apache.org/ant/index.html Well, there are a few files which you should edit them before building the project. Please edit the executable script file (XBrowser.bat if you're using windows base OS, or XBrowser.sh if Unix base) located in "src/bin" directory. Set the value of an environment variable called JAVA_HOME to where you've installed JRE/JDK. An example for windows : If the JRE/JDK is installed in "C:\Java\JRE\1.3" directory, you should edit XBrowser.bat and change JAVA_HOME as: set JAVA_HOME=C:\Java\JRE\1.3 An example for unix base OSes : If the JRE/JDK is installed in "/Java/JRE/1.3" directory, you should edit XBrowser.sh and change JAVA_HOME as: JAVA_HOME=/Java/JRE/1.3 Also edit Ant.bat (or Ant if using unix base OS) located in "bin" directory and set the JAVA_HOME value to where your JDK is installed (see the above instructions). Then go to "bin" directory and run the buildmain.bat (or type "build main" if you're using non-windows OS to build the project. There shouldn't be any other problem. FYI: You can run build.bat (or build) without any or with "help" (or "usage") parameter to get the list of available actions you can perform (such as cleaning up the build directories, generating javadocs, etc). 5. Running XBrowser -------------------- - For Development Release: Please read the previous section first, if you haven't done so! Well, you've already fixed the JAVA_HOME variable on the previous steps. After building the project go to "build/app" directory and run XBrowser.bat (or XBrowser.sh) file! That's all! - For User Release (Ready to Run): First you should edit the executable script file located at the root of the bundled file. XBrowser.bat if you're using windows base OS, XBrowser.sh if Unix base. and change JAVA_HOME variable as described above. Everything is ready for ruuning XBrowser! Just execute XBrowser.bat (or XBrowser.sh) file! Congratulation ;-) You have XBrowser being run! 6. Runtime Parameters ---------------------- Here are the runtime parameters(options) you can use: -language & -country : These two option are used to FORCE XBrowser to run at a particular locale! For example your system is running at "United States English" locale (en_US) by default but you want to have XBrowser run at "Germany German" locale (de_DE). So you should use them as : -language de -country DE If you don't use these parameters, the default locale on your system will be used! Note: You can find the supported countries and languages abbriviation in your JDK/JRE documentation. -debugmode & -debugdestination : You can set these parameters to determine the debug mode and destination. The possible values are as following : debugmode : none, brief & verbose debugdestination : console & file Example : xbrowser.XBrowser -debugmode verbose -debugdestination file 7. More Information -------------------- You can find the l