.TH FIREFOX 1 "November 4, 2004" firefox "Linux User's Manual"
.SH NAME
firefox - a Web browser for X11 derived from the Mozilla browser

.SH SYNOPSIS
.B firefox
[\fIOPTIONS\fR] [\fIURL\fR]

.B /usr/lib/firefox-3.6/firefox\-bin
[\fIOPTIONS\fR] [\fIURL\fR]

.SH DESCRIPTION
\fBFirefox\fR is an open-source web browser, designed for
standards compliance, performance and portability.

.SH USAGE
\fBfirefox\fR is a simple shell script that will set up the
environment for the actual executable, \fBfirefox\-bin\fR.
If there is a Firefox browser already running, \fBfirefox\fR will
arrange for it to create a new browser window; otherwise it will start
the Firefox application.

.SH OPTIONS
A summary of the options supported by \fBfirefox\fR is included below.
.SS "X11 options"
.TP
.BI \-\-display= DISPLAY
X display to use
.TP
.B \-\-sync
Make X calls synchronous
.TP
.B \-\-no\-xshm
Don't use X shared memory extension
.TP
.BI \-\-xim\-preedit= STYLE
.TP
.BI \-\-xim\-status= STYLE
.TP
.B \-\-g\-fatal\-warnings
Make all warnings fatal

.SS "User profile options"
.TP
\fB\-P\fR [\fIprofile\fR]
Start with the profile named \fIprofile\fR. When no profile is given, displays the Profile Manager.
\fIprofile\fR is case sensitive. May require \fB\-no\-remote\fR, see below.
.TP
\fB\-profile\fR \fIprofile\fR
Start with the profile \fIprofile\fR. Similar to \fB\-P\fR, but takes the path of 
a profile instead of a profile name. 
.TP
.B \-ProfileManager, \-P
Start with profile manager. May require \fB\-no\-remote\fR, see below.
.TP
\fB\-CreateProfile\fR \fIprofile\fR
Create a new profile named \fIprofile\fR, but do not start the browser.
.TP
.B \-migration
Start with migration wizard. May require \fB\-no\-remote\fR, see below.
.TP
.B \-no\-remote
Don't connect to a running Firefox instance. This option can be necessary
in conjunction with several of the options. These options won't have any effect
when a Firefox instance is running unless \fB\-no\-remote\fR is used at
the same time.
.TP
\fB\-override \fIfile\fR
Load the specified override.ini file to override the default one.
.SS "Browser options"
.TP
.B \-browser
Open a browser window.
.TP 
\fB[\-url]\fR \fIurl\fR
Open the browser to \fIurl\fR. \fB\-url\fR can be omitted.
.TP
.B \-private
Start Firefox in private browsing mode.
.TP
\fB\-new\-tab\fR \fIurl\fR
Open \fIurl\fR in a new tab.
.TP
\fB\-new-window\fR \fIurl\fR
Open \fIurl\fR in a new window.
.TP
\fB\-search\fR \fIquery\fR
Open Firefox and search for \fIquery\fR using the default search provider. Use quotes ("")
to run a search with spaces.
.TP
.B \-preferences
Open the preferences menu as a separate window, without opening the browser.
.TP
.B \-setDefaultBrowser
Set Firefox as the default web browser.
.SS "Chrome options"
.TP
\fB\-chrome\fR \fIurl\fR
Load the specified chrome.
.TP
\fB\-register\fR \fI\url\fR
Register the specified chrome, but do not start Firefox.
.SS "Locale options"
.TP
\fB\-UILocale\fR \fIlocale\fR
Start with \fIlocale\fR resources as User Interface locale. By default, it is
guessed from environment and available locales for Firefox.
.TP
\fB\-contentLocale \fIlocale\fR
Start with \fIlocale\fR resources as content locale. By default, it is
guessed from environment and available locales for Firefox.
.SS "Other component options"
.TP
.B \-jsconsole
Start Firefox with the Error Console.
.TP
\fB\-inspector\fR \fI[url]\fR
Start with the DOM Inspector and inspect \fIurl\fR, if specified. DOM Inspector
must be installed.
.TP
.B \-venkman
Start with the Venkman JavaScript debugger, if installed.
.TP
.B \-chat
Start with the ChatZilla IRC client, if installed.
.SS "Debugging options"
.B \-safe\-mode
Start Firefox in safe mode, disabling all extensions and
showing a bit more debugging messages.
.TP
.B \-g, \-debug
Start Firefox through a debugger (gdb by default).
.TP
\fB\-\-debugger\fR \fIprogram\fR
Use \fIprogram\fR as a debugger for Firefox. Implies \fB\-debug\fR.
.SS "Miscellaneous options"
.TP
.B \-h, \-help, \-?
Show summary of options.
.TP
.B \-v, \-version
Print Firefox version.
.TP
.B \-silent
Don't open default windows. Useful in combination with options like \fB\-jsconsole\fR
to prevent them from opening browser windows. 

.SH ENVIRONMENT
\fIFIREFOX_DSP\fR - configures the /dev/dsp wrapper to use. Accepted values
are "auto", "artsdsp", "esddsp", "aoss" or "none" (default).

\fIMOZILLA_DISABLE_PLUGINS\fR - when set, totally disables loading browser plugins
(the ones that appear at the about:plugins url)

.SH FILES
\fI/usr/bin/firefox\fR - shell script wrapping
\fBfirefox\-bin\fR
.br

\fI/usr/lib/firefox-3.6/firefox\-bin\fR - \fBfirefox\fR
executable
.br

\fI/etc/firefox/firefoxrc\fR - file containing environment
variables to be passed to Firefox.
.br

\fI${HOME}/.mozilla/firefox/rc\fR - file containing environment variables to
be passed to Firefox. Overrides \fI/etc/firefox/firefoxrc\fR

.SH BUGS
To report a bug, please visit \fIhttp://bugzilla.mozilla.org/\fR and/or report bugs
to the Debian Bug Tracking System, as usual.

.SH AUTHORS
.TP
.B The Mozilla Organization
.I http://www.mozilla.org/about.html