removing printf
[mozilla-central.git] / README.txt
blobbc85852ed9b69d7b58cf8cfe0868b36615e3ec48
1 ==============================================================
3 = = = = = = = = = =   Mozilla Read Me    = = = = = = = = = = =
5 ==============================================================
7 Mozilla is subject to the terms detailed in the license
8 agreement accompanying it.
10 This Read Me file contains information about system
11 requirements and installation instructions for the Windows,
12 Mac OS, and Linux builds of Mozilla.
14 For more info on Mozilla, see www.mozilla.org. To submit bugs
15 or other feedback, see the Navigator QA menu and check out
16 Bugzilla at http://bugzilla.mozilla.org for links to known
17 bugs, bug-writing guidelines, and more. You can also get help
18 with Bugzilla by pointing your IRC client to #mozillazine
19 at irc.mozilla.org.
22 ==============================================================
24                       Getting Mozilla
26 ==============================================================
28 You can download nightly builds of Mozilla from the
29 Mozilla.org FTP site at
31   ftp://ftp.mozilla.org/pub/mozilla.org/mozilla/nightly/
33 For the very latest builds, see
35   ftp://ftp.mozilla.org/pub/mozilla.org/mozilla/nightly/latest-trunk
37 Keep in mind that nightly builds, which are used by
38 Mozilla.org developers for testing, may be buggy. If you are
39 looking for a more polished version of Mozilla, Mozilla.org
40 releases Milestone builds of Mozilla every six weeks or so
41 that you can download from
43   http://www.mozilla.org/releases
45 Be sure to read the Mozilla release notes for information
46 on known problems and installation issues with Mozilla.
47 The release notes can be found at the preceding URL along
48 with the milestone releases themselves.
50 Note: Please use Talkback builds whenever possible. These
51 builds allow transmission of crash data back to Mozilla
52 developers, improved crash analysis, and posting of crash
53 information to our crash-data newsgroup.
56 ==============================================================
58                     System Requirements
60 ==============================================================
62 *All Platforms
64         To view and use the new streamlined "Modern" theme,
65         your display monitor should be set to display
66         thousands of colors. For users who cannot set their
67         displays to use more than 256 colors, Mozilla.org
68         recommends using the "Classic" theme for Mozilla.
70         To select the Modern theme after you have installed
71         Mozilla, from the Navigator browser, open the View
72         menu, and then open then open the Apply Theme submenu
73         and choose Modern.
75 *Mac OS
77         -Mac OS X or later
78         -PowerPC processor (266 MHz or faster recommended)
79         -64 MB RAM
80         -36 MB of free hard disk space
82 *Windows
84         -Windows 95, 98, Me, NT4, 2000 or XP
85         -Intel Pentium class processor (233 MHz or faster
86          recommended)
87         -64 MB RAM
88         -26 MB free hard disk space
90 *Linux
92         -The following library versions (or compatible) are
93          required: glibc 2.1, XFree86 3.3.x, GTK 1.2.x, Glib
94          1.2.x, Libstdc++ 2.9.0. Red Hat Linux 6.0,
95          Debian 2.1, and SuSE 6.2 (or later) installations
96          should work.
97         -Red Hat 6.x users who want to install the Mozilla
98          RPM must have at least version 4.0.2 of rpm
99          installed.
100         -Intel Pentium class processor (233 MHz or faster
101          recommended)
102         -64MB RAM
103         -26MB free hard disk space
106 ==============================================================
108                  Installation Instructions
110 ==============================================================
112 For Mac OS and Windows users, it is strongly recommended that
113 you exit all programs before running the setup program. Also,
114 you should temporarily disable virus-detection software.
116 For Linux users, note that the installation instructions use
117 the bash shell. If you're not using bash, adjust the commands
118 accordingly.
120 For all platforms, install into a clean (new) directory.
121 Installing on top of previously released builds may cause
122 problems.
124 Note: These instructions do not tell you how to build Mozilla.
125 For info on building the Mozilla source, see
127   http://www.mozilla.org/source.html
130 Windows Installation Instructions
131 ---------------------------------
133 Note: For Windows NT/2000/XP systems, you need Administrator
134 privileges to install Mozilla. If you see an "Error 5" message
135 during installation, make sure you're running the installation
136 with Administrator privileges.
139     To install Mozilla by downloading the Mozilla installer,
140     follow these steps:
142         1. Click the the mozilla-win32-installer.exe link on
143         the site you're downloading Mozilla from to download
144         the installer file to your machine.
146         2. Navigate to where you downloaded the file and
147         double-click the Mozilla program icon on your machine
148         to begin the Setup program.
150         3. Follow the on-screen instructions in the setup
151         program. The program starts automatically the first
152         time.
155     To install Mozilla by downloading the .zip file and
156     installing manually, follow these steps:
158         1. Click the mozilla-win32-talkback.zip link or the
159         mozilla-win32.zip link on the site you're down-
160         loading Mozilla from to download the .zip file to
161         your machine.
163         2. Navigate to where you downloaded the file and
164         double-click the compressed file.
166         Note: This step assumes you already have a recent
167         version of WinZip installed, and that you know how to
168         use it. If not, you can get WinZip and information
169         about the program at www.winzip.com.
171         3. Extract the .zip file to a directory such as
172         C:\Program Files\mozilla.org\Mozilla.
174         4. To start Mozilla, navigate to the directory you
175         extracted Mozilla to and double-click the Mozilla.exe
176         icon.
179 Mac OS X Installation Instructions
180 ----------------------------------
182     To install Mozilla by downloading the Mozilla disk image,
183     follow these steps:
185         1. Click the mozilla-mac-MachO.dmg.gz link to download
186         it to your machine. By default, the download file is
187         downloaded to your desktop.
189         2. Once you have downloaded the .dmg.gz file, drag it
190         onto Stuffit Expander to decompress it. If the disk
191         image doesn't mount automatically, double-click on the
192         .dmg file to mount it. If that fails, and the file
193         does not look like a disk image file, do a "Show Info"
194         on the file, and, in the "Open with application"
195         category, choose Disk Copy. In Mac OS 10.2, you can
196         use "Open with" from the context menu.
198         3. Once the disk image mounts, open it, and drag the
199         Mozilla icon onto your hard disk.
201         4. We recommend that you copy it to the Applications
202         folder.
204         5. Now Eject the disk image.
206         6. If you like, you can drag Mozilla to your dock to
207         have it easily accessible at all times. You might also
208         wish to select Mozilla as your default browser in the
209         Internet system preferences pane (under the Web tab).
212 Linux Installation Instructions
213 -------------------------------
215 Note: If you install in the default directory (which is
216 usually /usr/local/mozilla), or any other directory where
217 only the root user normally has write-access, you must
218 start Mozilla first as root before other users can start
219 the program. Doing so generates a set of files required
220 for later use by other users.
223     To install Mozilla by downloading the Mozilla installer,
224     follow these steps:
226         1. Create a directory named mozilla (mkdir mozilla)
227         and change to that directory (cd mozilla).
229         2. Click the link on the site you're downloading
230         Mozilla from to download the installer file
231         (called mozilla-1686-pc-linux-gnu-installer.tar.gz)
232         to your machine.
234         3. Change to the mozilla directory (cd mozilla) and
235         decompress the archive with the following command:
237           tar zxvf moz*.tar.gz
239         The installer is now located in a subdirectory of
240         Mozilla named mozilla-installer.
242         4. Change to the mozilla-installer directory
243         (cd mozilla-installer) and run the installer with the
244         ./mozilla-installer command.
246         5. Follow the instructions in the install wizard for
247         installing Mozilla.
249         Note: If you have a slower machine, be aware that the
250         installation may take some time. In this case, the
251         installation progress may appear to hang indefinitely,
252         even though the installation is still in process.
254         6. To start Mozilla, change to the directory where you
255         installed it and run the ./mozilla command.
258     To install Mozilla by downloading the tar.gz file:
260         1. Create a directory named "mozilla" (mkdir mozilla)
261         and change to that directory (cd mozilla).
263         2. Click the link on the site you're downloading
264         Mozilla from to download the non-installer
265         (mozilla*.tar.gz) file into the mozilla directory.
267         3. Change to the mozilla directory (cd mozilla) and
268         decompress the file with the following command:
270           tar zxvf moz*.tar.gz
272         This creates a "mozilla" directory under your mozilla
273         directory.
275         4. Change to the mozilla directory (cd mozilla).
277         5. Run Mozilla with the following run script:
279           ./mozilla
282     To hook up Mozilla complete with icon to the GNOME Panel,
283     follow these steps:
285         1. Click the GNOME Main Menu button, open the Panel menu,
286         and then open the Add to Panel submenu and choose Launcher.
288         2. Right-click the icon for Mozilla on the Panel and
289         enter the following command:
290           directory_name./mozilla
292         where directory_name is the name of the directory
293         you downloaded mozilla to. For example, the default
294         directory that Mozilla suggests is /usr/local/mozilla.
296         3. Type in a name for the icon, and type in a comment
297         if you wish.
299         4. Click the icon button and type in the following as
300         the icon's location:
302           directory_name/icons/mozicon50.xpm
304         where directory name is the directory where you
305         installed Mozilla. For example, the default directory
306         is /usr/local/mozilla/icons/mozicon50.xpm.