Classilla 9.3.2: Installation and Release NotesThis document discusses basic usage and installation instructions for this version of Classilla. For more tips, suggestions and help, you might also want to read the official Classilla FAQ.
Classilla is provided to you under the Mozilla Public License.
Classilla: Now Optimizing For the Mobile WebStarting with version 9.3.0, Classilla is transitioning from a "desktop" browser to a browser focused on accessing mobile content. Mobile content has always been a better fit for OS 9 machines as their CPU and RAM limits are similar to today's mobile devices, and their browsers have similar limitations, particularly feature phones and low-end smartphones. While desktop content will still be accessible with Classilla, Classilla will by default start to advertise a user agent mimicking a typical mobile device in order to preferentially fetch mobile content if available. You will be able to configure this in the preferences as before.
The upshot of this and other related internal changes will not only be to facilitate accessing sites that perform better and have nearly the same functionality, but improved stability and overall utility on our aging but still useful Macintoshes.
System RequirementsClassilla requires any Power Macintosh with at least 64MB of RAM (virtual or physical), 100MB of free hard disk space and MacOS 8.6 or higher. A G3 processor with 128MB of physical RAM and OS 9.1 is the recommended minimum. (Although Classilla will run on OS 8.5, due to various bugs in that version we strongly advise updating to OS 8.6.)
Classilla is compatible with Apple Virtual Memory and Connectix RAM Doubler 9, but this may cause unpredictable performance problems and is recommended only for those systems with low physical RAM ceilings (such as the PowerBook 1400). You will observe better performance with adequate physical memory and Virtual Memory off, and better still if you use a RAM disk for your cache. You should also make sure you have adequate disk cache in the Memory control panel, as poor disk caching can also slow Classilla down.
If you are using a system with 128MB of RAM or less, or want to run Classilla on a system with less than 64MB of physical RAM, please see the section on Running Classilla With Low Memory below.
Upgrading From a Previous Version of ClassillaIf you are upgrading from any previous version of Classilla 9.x, your old profile, bookmarks, preferences, mailbox and other user information will transfer directly to Classilla 9.3.2. You do not need to create a new profile to use this update, although as with any update, you may wish to backup your profile (which is normally stored in your hard disk's Documents folder, under Mozilla).
If you have any special plugins installed, be sure to copy them to a separate folder, and copy them back to the Plug-ins folder after installation, as this process may overwrite them. Be sure to merge the two folders together; Classilla periodically offers updates to plugins and you should make sure you are using the latest versions available.
When updating from versions prior to Classilla 9.2.1, your NoScript whitelist will be erased when you update to this version. The format of the whitelist changed in 9.2.1 with the introduction of Script-B-Gone, and is not compatible with older versions. If you wish to keep your whitelist, take note of the sites you have selected so that you can re-enter them manually after the update. To avoid corrupting the whitelist backing store, Classilla intentionally does not copy your old whitelist to the new whitelist format.
Classilla is provided as a StuffIt archive, compatible with version 5 and later of StuffIt Expander. You can unpack it by dropping the archive on your StuffIt Expander icon, or opening it with StuffIt Expander.
To replace your old Classilla, make sure you have quit Classilla, then drag the Classilla folder inside the unpacked StuffIt archive to your Macintosh's Applications directory to replace the old version. Assuming they have the same name, the Finder will replace the old folder with the new one. You may then delete the archive folder. To start Classilla, open the Classilla folder in your Applications folder and double click the Classilla application. Do not delete or move files in the Classilla folder, as they are essential for its operation.
You can keep multiple versions of Classilla on your computer if you prefer the features of earlier versions, although you should make sure that the desired version opens your saved pages and URLs as they will all have the same creator code. When opening old versions, if you make any changes to the NoScript white list, they will be reset when you restart versions 9.2.1 or later.
If you experience problems with installation, report it with the Classilla Report-A-Bug system. Please do not file issues on Google Code; a triage reviewer will do that for you if needed.
Upgrading From WaMCom, Mozilla or Netscape 7It is recommended that you start with a fresh system and delete previous profiles and versions of WaMCom, Mozilla and Netscape 7 from your Macintosh, as they may conflict with Classilla's proper operation. In addition, there are new recommended default settings that previous profiles will not incorporate and incorrect versions of these settings may cause adverse performance. To clean your system, delete and remove the WaMCom, Mozilla or Netscape folder from your hard disk, then the Mozilla (or Netscape) folder in your hard disk's Documents folder, then the Mozilla Registry (or Netscape Registry) file in your System Folder's Preferences folder, and then empty the Trash. You may also wish to restart your Macintosh and/or rebuild your desktop to complete the process.
If you wish to keep your old bookmarks, you can save the HTML bookmarks file from your profile and replace it after Classilla starts for the first time. You may also decide to keep your mailbox files, although you will need to re-enter your login and server information. Do not keep or alter any other files. Replace these files only when Classilla is not running.
Classilla is provided as a StuffIt archive, compatible with version 5 and later of StuffIt Expander. You can unpack it by dropping the archive on your StuffIt Expander icon, or opening it with StuffIt Expander. Drag the Classilla folder inside the unpacked archive to your Macintosh's Applications directory to copy it, then delete the archive folder. To start Classilla, open the Classilla folder in your Applications folder and double click the Classilla application. Do not delete or move files in the Classilla folder, as they are essential for its operation.
If you have no profiles (which will be the case if you followed the instructions above), a new default one will be created for you with default settings and bookmarks, and Classilla will try to connect to the default Classilla Start Page. If this occurs successfully, your installation is complete.
Otherwise, if you have an existing WaMCom or Mozilla profile and have decided to preserve it anyway, Classilla will attempt to use it. You should make sure that it acts correctly and that your settings were preserved, and read Known Problems below to determine what settings, if any, need to be changed.
If you are attempting to remove a profile (or your old profile), or add a new one for another user, you can access profiles when Classilla has started up by going to Tools > Manage Profiles.
If you wish to keep your old browser, you should still make a separate profile in Classilla so that you still get the benefit of the updated settings. You can still transfer your bookmarks and mailbox files to this new profile once Classilla has started for the first time. Replace these files only when Classilla is not running. To start Classilla in the profile manager, double click Mozilla Profile Wizard, not Classilla. Make sure that the expected application starts, as Classilla uses the same creator code.
If you experience problems with installation, report it with the
Classilla Report-A-Bug system. Please do not
file issues on Google Code; a triage reviewer will do that for you if
For optimum utilization of your Mac's RAM, Classilla uses two forms of memory: preferentially its fixed allocation, assigned in the Finder, for the majority of windows and tabs that are open, but also temporary memory, primarily for images, if it runs out of regular memory. You can access the application's memory settings from the Finder by finding and selecting the Classilla application in the Classilla folder, then pressing Command-I for its Get Info box.
Classilla requires approximately 40MB of RAM to start in a functional state using a single window. You should not set its memory allocation lower than this minimum, or you may make it impossible for Classilla to start up. This minimum is intended for systems that just barely reach the 64MB RAM mark. You should avoid opening multiple windows or large numbers of tabs on these systems, as this may cause the browser to run out of memory and quit unexpectedly.
Classilla prefers at least 60-80MB of RAM in order to keep multiple windows open. The preferred allocation is intended to grab this amount of memory for systems with 128MB of RAM or more, although on systems just at 128MB of RAM it may prevent other applications from getting sufficient memory. In that case, you may reduce it down towards the minimum, but be advised that opening large numbers of simultaneous windows and tabs may cause Classilla to become progressively more unstable as you reduce its fixed memory allocation.
If it is not possible to install more physical RAM in your computer, such as
with systems like the PowerBook 1400 which are limited to 64MB, you can
dramatically increase stability at the cost of performance by using a virtual
memory manager. While this will make your Mac slower, you will be able to
give Classilla more "memory" to use, and this will allow the application to
be more stable. You can use Apple's Virtual Memory under the Memory control
panel, or a third-party system such as Connectix RAM Doubler, both of which
are compatible with Classilla. You should try to create as much virtual space
as your hard drive is able to accommodate; it is recommended that you create
a total of at least 128MB of memory or more (combined between your physical and
virtual memory), and allow Classilla as close to its maximum preferred
allocation as you can.
Nevertheless, some sites have problematic or unacceptably limited feature sets when dealing with mobile devices. Most sites that offer a mobile version also give you a link you can click to select to use the full version of the site. Typically this is set with a cookie in your browser.
If this is not sufficient, you can change the user agent that Classilla sends to servers by going to Preferences and changing the setting in the User Agent panel, including restoring the default user agent Classilla used in 9.2.3 and previous versions. However, this may enable features Classilla may not fully support yet. This setting is sticky and persists until you change it, even if you navigate to a different site or quit the browser. If you start the browser with a custom user agent still selected, you will receive a warning.
In 9.3.2, certain sites are maintained on an internal whitelist and will
automatically use a desktop user agent when they are accessed. You can
change these preferences through the about:config panel; see
Suggestions for the whitelist are solicited and will be used to construct a
default whitelist in these future releases.
The most important issues in this version of Classilla are listed below. If you experience problems, report it with the Classilla Report-A-Bug system. Please do not file issues on Google Code; a triage reviewer will do that for you if needed. For more tips, suggestions and help, you might also want to read the official Classilla FAQ.
New FeaturesThe following new features are introduced in this release of Classilla. Cxx numbers in boldface correspond to the issue number that tracked this issue or feature.
Issues Repaired (Major)The following major issues were addressed in this release of Classilla. Cxx numbers in boldface correspond to the issue number that tracked this issue or feature.
Complete Change ListThe following Classilla and/or Mozilla patches were applied or modified for application to this release of Classilla. Cxx numbers in boldface correspond to the issue number that tracked this issue or feature; Mxx numbers correspond to the relevant Bugzilla number where applicable (/m, /mm = modified for Classilla; /p = partial application). Due to technical differences between Clecko and Gecko, the scope of these changes may be different from that originally intended, and some patches required extensive modification for Classilla/Clecko.
Previous VersionsYou can still download older versions of Classilla "while they last." Because of security and stability improvements in subsequent versions, you should only download the most current version for general use. These older versions are offered only for comparison purposes or for users who require or prefer the functionality of earlier versions. They are no longer supported or updated.
Prior to this version, you can still download: