Mozilla Source Code Directory Structure

  • Revision slug: Mozilla_Source_Code_Directory_Structure
  • Revision title: Mozilla Source Code Directory Structure
  • Revision id: 40266
  • Created:
  • Creator: Andreas Wuest
  • Is current revision? No
  • Comment /* docshell */

Revision Content

The code for all projects in the Mozilla family (such as Firefox, Thunderbird, etc.) is combined into a single source tree. The tree contains the source code as well as the code required to build each project on supported platforms (Linux, Windows, Mac OS, etc).

To simply take a look at the Mozilla source code, you do not need to download it. You can look at the source directly with your web browser using Bonsai.

In order to modify the source, you have to acquire it by either downloading a snapshot of the sources or by checking out the current sources from CVS.

This document describes the directory structure that can be pulled by client.mk -- i.e., directories that are used by at least some of the Mozilla project's client products. There are other directories in the Mozilla CVS repository, such as those for Web tools and those for the Classic codebase.

See source code directories overview for a somewhat different version of the same information.

accessible

Files for accessibility (i.e. MSAA (Microsoft Active Accessibility), ATK (Accessibility Toolkit, used by GTK+ 2) support files)

browser

Contains the front end code (in XUL, Javascript, XBL, and C++) for the Firefox browser. Many of these files started off as a copy of files in xpfe.

build

Miscellaneous files used by the build process. See also config.

calendar

Implementation of the Calendar, originally created by OEone. See also extensions/lightning.

caps

Capability-based web page security management.

caps contains C++ interfaces and code for determining the capabilities of content based on the security settings or certificates (e.g. VeriSign). See Component Security.

chrome

Chrome registry used with toolkit/. These files were originally copies of files in rdf/chrome/.

composer

The front end code (XUL and Javascript) for the standalone composer application.

config

More files used by the build process, common includes for the makefiles, etc. See also build.

content

The data structures that represent the structure of Web pages (documents, elements, text nodes, etc.). These objects contain the implementation of many DOM interfaces and also implement some behaviors associated with those objects, such as link handling, form control behavior and form submission.

This directory also contains the code for XUL templates, XBL, XSLT, XTF, and other related standards.

db

Container for database-accessing modules. Currently contains mork and sqlite.

db/mdb and db/mork

Implementation of Mork, a textual format for databases. Used for example to store the global history.

db/sqlite3

The SQLite database, used by storage. Planned to supersede mork.

dbm

Source code of the berkeley database library, hacked from the 4.4BSD version. Used mainly by NSS code as certificate store.

directory

LDAP support for Mozilla. Used in mailnews.

docshell

Implementation of the docshell, the main object managing things related to a document window. Each frame has its own docshell. Contains methods for loading URIs, managing URI content listeners, etc. It is the outermost layer of the embedding API used to embed a Gecko browser into an application. See also webshell/.

dom

Contains:

  • IDL definitions of the interfaces defined by the DOM specifications and Mozilla extensions to those interfaces (implementations of these interfaces are primarily, but not completely, in content).
  • The parts of the connection between JavaScript and the implementations of DOM objects that are specific both to JavaScript and to the DOM. (The parts that are not DOM-specific, i.e., the generic binding between XPCOM and Javascript, live in XPConnect.)
  • implementations of a few of the core "DOM Level 0" objects, such as window, navigator, location, etc.

editor

embedding

XXX this needs a description

extensions

Contains several extensions to mozilla, which can be enabled at compile-time using the --enable-extensions configure argument.

Note that some of these are now built specially and not using the --enable-extensions option. For example, disabling xmlextras is done using --disable-xmlextras.

extensions/access-builtin

XXX document me

extensions/auth

Implementation of the negotiate auth method for HTTP and other protocols. Has code for SSPI, GSSAPI, etc.

extensions/cck

The Client Customization Kit, Firefox version. This is actually a rewrite of Netscape's CCK which shares little more than the name and purpose with the code in cck/.

extensions/content-packs

Content- and locale-pack switching user interface.

extensions/cookie

Permissions backend for cookies, images etc, as well as the user interface to these permissions and other cookie features.

extensions/cview

Component viewer, which allows to view the currently registered components and interfaces.

extensions/datetime

Support for the datetime protocol.

extensions/editor

csseditor support (?)

extensions/finger

Support for the finger protocol

extensions/gnomevfs

Interface to gnome-vfs to allow using all protocols supported by gnome-vfs inside of mozilla.

extensions/help

Help viewer and help content.

extensions/inspector

DOM Inspector is a tool that can be used to inspect and edit the live DOM of any web document or XUL file.

extensions/irc

This is ChatZilla, the IRC (Internet Relay Chat) component.

extensions/java

XPCOM<->Java bridge ("JavaXPCOM", formerly known as Javaconnect). Unrelated to the code in java/.

extensions/layout-debug

Layout debugger. Intended as replacement for "viewer". Can be used to run layout regression tests and has support for other layout debugging features.

extensions/lightning

The Lightning project, "an extension to tightly integrate calendar functionality (scheduling, tasks, etc.) into Thunderbird."

extensions/manticore

C# based Gecko embedding. Also embeds Trident. Probably obsolete?

extensions/mono

A two-way bridge between the CLR/.NET/Mono/C#/etc. world and XPCOM.

extensions/p3p

Implementation of W3C's Platform for Privacy Preferences standard.

extensions/permissions

XXX writeme

extensions/pref

Preference-related extensions:

autoconfig

XXX what does this do? is it the lock_pref stuff? Could be downloading preferences from remote servers (like LDAP)

system-pref

Support for using OS-wide preferences in Mozilla, mainly for GConf (Gnome)

extensions/python

Support for implementing XPCOM components in python.

extensions/reporter

An extension to report problems with web pages. Client-side part.

extension/schema-validation

Allows validating XML trees according to specified XML Schemas.

extension/spatialnavigation

Spatial navigation, navigating between links of a document according to their on-screen position.

extensions/spellcheck

Spellchecker for mailnews and composer.

extensions/sql

Support for accessing SQL databases from XUL applications.

extensions/sroaming

Session roaming, i.e. support for storing a profile on a remote server.

extensions/tasks

Support for launching OS-provided tasks, like a calendar.

extensions/transformiix

XSLT support. XSL Transformations is a language used to transform XML document into other XML documents.

extensions/tridentprofile

Support for importing profiles from MSIE.

extensions/typeaheadfind

Find As You Type allows quick web page navigation when you type a succession of characters in the body of the displayed page

extensions/universalchardet

Universal character set detector.

extensions/venkman

The JavaScript Debugger.

extensions/wallet

Password and Form Manager

extensions/webdav

WebDAV code; exposes special APIs for accessing WebDAV servers. Used by the Calendar project.

extensions/webservices

Support for Webservices.

extensions/xforms

Code for the XForms extension.

extensions/xmlextras

Several XML-related extensions.

extensions/xml-rpc

XML Remote Procedure Calls. Unowned these days.

extensions/xmlterm

XMLTerm, a terminal implemented using mozilla technology. Only available on GTK builds.

gc

Container for garbage collection libraries, currently only boehm GC.

gc/boehm

Source code of boehm gc, not compiled by default. Used to be used for leak detection.

gfx

Contains interfaces that abstract the capabilities of platform graphics toolkits, along with implementations on various platforms. These interfaces provide methods for things like drawing images, text, and basic shapes. It also contains basic data structures such as points and rectangles used here and in other parts of Mozilla.

It's also the home of the new graphics architecture based on cairo (via a C++ wrapper called thebes).

intl

Internationalization and localization support.

bidi 
Obsolete.
chardet 
Code for "sniffing" the character encoding of Web pages.
ctl 
Code for dealing with Complex Text Layout, related to shaping of south Asian languages (not built by default, needs --enable-ctl)
locale 
Code related to determination of locale information from the operating environment
lwbrk 
Code related to line breaking and word breaking
strres 
Code related to string resources used for localization.
uconv 
Code that converts (both ways: encoders and decoders) between UTF-16 and many other character encodings.
unicharutil 
Code related to implementation of various algorithms for Unicode text, such as case conversion

ipc

Container for implementations of IPC (Inter-Process Communication) mechanisms.

ipc/ipcd

The IPC daemon that's used for communication between several mozilla processes to support profile sharing. (Note that at the time of this writing (Dec 2005), profile sharing is not supported by mozilla).

jpeg

Source code of libjpeg, used by the mozilla image library.

js/src

The JavaScript engine, also known as Spidermonkey. See

js/jsd

JavaScript debugging library.

js/src/xpconnect

Support code for calling JS Code from C++ code and C++ code from JS Code, using XPCOM interfaces.

js/src/liveconnect

Liveconnect, the bridge between JS and Java code.

l10n

Basically empty and not used by the mozilla build.

layout

Code that implements a tree of rendering objects that describe the types and locations of the objects that are displayed on the screen (such as CSS boxes, tables, form controls, XUL boxes, etc.), and code that manages operations over that rendering tree (such as creating and destroying it, doing layout, painting, and event handling). See documentation and other information.

base 
Code that deals with the rendering tree.
generic 
The basic rendering object interface and the rendering tree objects for basic CSS boxes.
forms 
Rendering tree objects for HTML form controls.
tables 
Rendering tree objects for CSS/HTML tables
mathml 
Rendering tree objects for MathML.
svg 
Rendering tree objects for SVG
xul 
Additional rendering object interfaces for XUL and the rendering tree objects for XUL boxes

lib

Mostly unused; might be used on mac?

mail

Thunderbird frontend files. Note that many thunderbird files are shared with Mozilla Mailnews and can be found under mailnews/.

mailnews

The mail and news backend code (e.g., code that manages folders, manages databases, or interacts with mail servers) and the frontend code for the SeaMonkey mail client, some of which is shared by Thunderbird.

modules/libimg

Contains libpng, used by the image library for PNG Image decoding.

modules/libjar

Code to read zip files, used for reading the .jar files that contain the files for the mozilla frontend.

modules/libpr0n

Image rendering library. Contains decoders for the image formats mozilla supports.

modules/libpref

Library for reading and writing preferences.

modules/libreg

Library for reading the netscape binary registry files, used for the ~/.mozilla/appreg file (registry.dat on windows).

modules/libutil

XXX what's this??

modules/oji

Support for the java plugin.

modules/plugin

Plugin support. Implements the Netscape Plugin-API NPAPI

modules/staticmod

Helper files for static mozilla builds

modules/zlib

Source code of zlib, used at least in the networking library for compressed transfers.

netwerk

Networking library, also known as Necko. Responsible for doing actual transfers from and to servers, as well as for URI handling and related stuff.

nsprpub

Netscape Portable Runtime. Used as an abstraction layer to things like threads, file I/O and socket I/O.

other-licenses

Contains libraries that are not covered by the MPL but used in some mozilla code.

parser/expat

Copy of the expat source code, which is the XML parser used by mozilla.

parser/htmlparser

Contains the html parser used by Mozilla, which parses HTML source code and calls the appropriate methods on a content sink.

plugin

Mostly obsolete. All that's left in this directory is code related to Java plugins on the Mac.

profile

Code for profile handling, the profile manager backend and frontend.

rdf

RDF handling APIs. RDF,

Also contains the chrome registry code used by SeaMonkey, although toolkit apps (such as Firefox and Thunderbird) use the copy forked into chrome.

security

Contains NSS and PSM, to support cryptographic functions in mozilla (like S/MIME, SSL, etc).

storage

Storage: XPCOM wrapper for sqlite. Wants to unify storage of all profile-related data. Supersedes mork.

suite

Newer parts of SeaMonkey-specific code. Older parts live in {{template.Source("xpfe/")}}.

sun-java

XXX another java directory?

themes

Contains the themes shipped with SeaMonkey. Classic and Modern at the time of this writing.

toolkit

The "new toolkit" used by Thunderbird, Firefox, etc. This contains numerous front-end components shared between applications as well as most of the XBL-implemented parts of the XUL language (most of which was originally forked from versions in #xpfe/).

tools

Some tools which are optionally built during the mozilla build process, mostly used for debugging.

uriloader/base

Content dispatch in Mozilla. Used to load uris and find an appropriate content listener for the data. Also manages web progress notifications.

uriloader/exthandler

Used to handle content that Mozilla can't handle itself. Responsible for showing the helper app dialog, and generally for finding information about helper applications.

uriloader/prefetch

Service to prefetch documents in order to have them cached for faster loading.

view

View manager. Contains cross-platform code used for painting, scrolling, event handling, z-ordering, and opacity. Soon to become obsolete, gradually.

webshell

Mostly obsolete, and being merged into docshell.

widget

A cross-platform API, with implementations on each platform, for dealing with Operating system/environment widgets, i.e., code related to creation and handling of windows, popups, and other native widgets and to converting the system's messages related to painting and events into the messages used by other parts of Mozilla (e.g., view and content, the latter of which converts many of the messages to yet another API, the DOM event API).

xpcom

Cross-Platform Component Object Model. Also contains data structures used by the rest of the mozilla code.

xpfe

XPFE is the SeaMonkey frontend. It contains the XUL files for the browser interface, common files used by the other parts of the mozilla suite, and the XBL files for the parts of the XUL language that are implemented in XBL. Much of this code has been copied to browser and toolkit for use in Firefox, Thunderbird, etc.

xpfe/components

Components used by the Mozilla frontend, as well as implementations of interfaces that other parts of mozilla expect.

xpfe/bootstrap

Startup code for Mozilla. This contains the main/WinMain function. (Not used by "new toolkit" apps; for those, see toolkit/xre and the "app" directory for each specific app)

xpinstall

The installer, which contains code for installing Mozilla and for installing XPIs/extensions. This directory also contains code needed to build installer packages. See XPInstall and the XPInstall project page.

xulrunner

Code for XULRunner.

Revision Source

<p>The code for all projects in the Mozilla family (such as <a class="external" href="http://www.mozilla.org/projects/firefox/">Firefox</a>, <a class="external" href="http://www.mozilla.org/projects/thunderbird/">Thunderbird</a>, <a class="external" href="http://www.mozilla.org/products/">etc.</a>) is combined into a single source tree. The tree contains the source code as well as the code required to build each project on supported platforms (Linux, Windows, Mac OS, etc).
</p><p>To simply take a look at the Mozilla source code, you do not need to download it. You can look at the source directly with your web browser using <a href="en/Bonsai_(external)">Bonsai</a>.
</p><p>In order to modify the source, you have to acquire it by either downloading a <a href="en/Download_Mozilla_Source_Code">snapshot</a> of the sources or by <a href="en/Mozilla_Source_Code_Via_CVS">checking out the current sources from CVS</a>.
</p><p>This document describes the directory structure that can be pulled by <code>client.mk</code> -- i.e., directories that are used by at least some of the Mozilla project's client products.  There are other directories in the Mozilla CVS repository, such as those for Web tools and those for the Classic codebase.
</p><p>See <a class="external" href="http://www.mozilla.org/docs/source-directories-overview.html">source code directories overview</a> for a somewhat different version of the same information.
</p>
<h4 name="accessible"> accessible </h4>
<p>Files for accessibility (i.e. MSAA (Microsoft Active Accessibility), ATK (Accessibility Toolkit, used by GTK+ 2) support files) <a class="external" href="http://www.mozilla.org/projects/ui/accessibility/">
</a></p><a class="external" href="http://www.mozilla.org/projects/ui/accessibility/">
<h4 name="browser"> browser </h4>
</a><p><a class="external" href="http://www.mozilla.org/projects/ui/accessibility/">Contains the front end code (in XUL, Javascript, XBL, and C++) for the Firefox browser. Many of these files started off as a copy of files in </a><a href="#xpfe">xpfe</a>.
</p>
<h4 name="build"> build </h4>
<p>Miscellaneous files used by the build process. See also <a href="#config">config</a>.
</p>
<h4 name="calendar"> calendar </h4>
<p>Implementation of the <a class="external" href="http://www.mozilla.org/projects/calendar">Calendar</a>, originally created by OEone. See also <a href="#extensions.2Flightning">extensions/lightning</a>.
</p>
<h4 name="caps"> caps </h4>
<p>Capability-based web page security management.
</p><p>caps contains C++ interfaces and code for determining the capabilities of content based on the security settings or certificates (e.g. VeriSign). See <a class="external" href="http://www.mozilla.org/projects/security/components/">Component Security</a>.
</p>
<h4 name="chrome"> chrome </h4>
<p>Chrome registry used with <a href="#toolkit">toolkit</a>/.  These files were originally copies of files in <a href="#rdf">rdf</a>/chrome/.
</p>
<h4 name="composer"> composer </h4>
<p>The front end code (XUL and Javascript) for the standalone composer application.
</p>
<h4 name="config"> config </h4>
<p>More files used by the build process, common includes for the makefiles, etc. See also <a href="#build">build</a>.
</p>
<h4 name="content"> content </h4>
<p>The data structures that represent the structure of Web pages (documents, elements, text nodes, etc.). These objects contain the implementation of many DOM interfaces and also implement some behaviors associated with those objects, such as link handling, form control behavior and form submission.
</p><p>This directory also contains the code for XUL templates, XBL, XSLT, XTF, and other related standards.
</p>
<h4 name="db"> db </h4>
<p>Container for database-accessing modules. Currently contains mork and sqlite.
</p>
<h5 name="db.2Fmdb_and_db.2Fmork"> db/mdb and db/mork </h5>
<p>Implementation of Mork, a textual format for databases. Used for example to store the global history.
</p>
<h5 name="db.2Fsqlite3"> db/sqlite3 </h5>
<p>The SQLite database, used by <a href="en/Storage">storage</a>. Planned to supersede mork.
</p>
<h4 name="dbm"> dbm </h4>
<p>Source code of the berkeley database library, hacked from the 4.4BSD version.  Used mainly by NSS code as certificate store.
</p>
<h4 name="directory"> directory </h4>
<p>LDAP support for Mozilla. Used in mailnews.
</p>
<h4 name="docshell"> docshell </h4>
<p>Implementation of the docshell, the main object managing things related to a document window. Each frame has its own docshell. Contains methods for loading URIs, managing URI content listeners, etc. It is the outermost layer of the embedding API used to embed a Gecko browser into an application. See also <a href="#webshell">webshell</a>/.
</p>
<h4 name="dom"> dom </h4>
<p>Contains:
</p>
<ul><li> IDL definitions of the interfaces defined by the DOM specifications and Mozilla extensions to those interfaces (implementations of these interfaces are primarily, but not completely, in <a href="#content">content</a>).
</li><li> The parts of the connection between JavaScript and the implementations of DOM objects that are specific both to JavaScript and to the DOM.  (The parts that are not DOM-specific, i.e., the generic binding between XPCOM and Javascript, live in <a href="#xpconnect">XPConnect</a>.)
</li><li> implementations of a few of the core "DOM Level 0" objects, such as window, navigator, location, etc.
</li></ul>
<h4 name="editor"> editor </h4>
<ul><li> The backend for HTML and text editing.  This is not only used for mail composer and the page editor composer, but also for rich text editing inside webpages <a class="external" href="http://www.mozilla.org/editor/midas-spec.html">, and each textarea or input field is also using such an editor (in the plaintext variant).  </a><a class="external" href="http://www.mozilla.org/editor/">
</a></li><li><a class="external" href="http://www.mozilla.org/editor/"> The frontend for the HTML editor that is part of SeaMonkey.
</a></li></ul><a class="external" href="http://www.mozilla.org/editor/">
<h4 name="embedding"> embedding </h4>
</a><p><a class="external" href="http://www.mozilla.org/editor/">XXX this needs a description
</a><a class="external" href="http://www.mozilla.org/projects/embedding/">
</a></p><a class="external" href="http://www.mozilla.org/projects/embedding/">
<h4 name="extensions"> extensions </h4>
<p>Contains several extensions to mozilla, which can be enabled at compile-time using the --enable-extensions configure argument.
</p><p>Note that some of these are now built specially and not using the --enable-extensions option. For example, disabling xmlextras is done using --disable-xmlextras.
</p>
<h5 name="extensions.2Faccess-builtin"> extensions/access-builtin </h5>
<p>XXX document me
</p>
<h5 name="extensions.2Fauth"> extensions/auth </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/embedding/">Implementation of the negotiate auth method for HTTP and other protocols. Has code for SSPI, GSSAPI, etc.  </a><a class="external" href="http://www.mozilla.org/projects/netlib/integrated-auth.html">
</a></p><a class="external" href="http://www.mozilla.org/projects/netlib/integrated-auth.html">
<h5 name="extensions.2Fcck"> extensions/cck </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/netlib/integrated-auth.html">The Client Customization Kit, Firefox version. This is actually a rewrite of Netscape's CCK which shares little more than the name and purpose with the code in cck/.  </a><a class="external" href="http://www.mozilla.org/projects/cck/firefox/">
</a></p><a class="external" href="http://www.mozilla.org/projects/cck/firefox/">
<h5 name="extensions.2Fcontent-packs"> extensions/content-packs </h5>
<p>Content- and locale-pack switching user interface.
</p>
<h5 name="extensions.2Fcookie"> extensions/cookie </h5>
<p>Permissions backend for cookies, images etc, as well as the user interface to these permissions and other cookie features.
</p>
<h5 name="extensions.2Fcview"> extensions/cview </h5>
<p>Component viewer, which allows to view the currently registered components and interfaces.
</p>
<h5 name="extensions.2Fdatetime"> extensions/datetime </h5>
<p>Support for the datetime protocol.
</p>
<h5 name="extensions.2Feditor"> extensions/editor </h5>
<p>csseditor support (?)
</p>
<h5 name="extensions.2Ffinger"> extensions/finger </h5>
<p>Support for the finger protocol
</p>
<h5 name="extensions.2Fgnomevfs"> extensions/gnomevfs </h5>
<p>Interface to gnome-vfs to allow using all protocols supported by gnome-vfs inside of mozilla.
</p>
<h5 name="extensions.2Fhelp"> extensions/help </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/cck/firefox/">Help viewer and help content.  </a><a class="external" href="http://www.mozilla.org/projects/help-viewer/">
</a></p><a class="external" href="http://www.mozilla.org/projects/help-viewer/">
<h5 name="extensions.2Finspector"> extensions/inspector </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/help-viewer/">DOM Inspector is a tool that can be used to inspect and edit the live DOM of any web document or XUL file.  </a><a class="external" href="http://www.mozilla.org/projects/inspector/">
</a></p><a class="external" href="http://www.mozilla.org/projects/inspector/">
<h5 name="extensions.2Firc"> extensions/irc </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/inspector/">This is ChatZilla, the IRC (Internet Relay Chat) component.  </a><a class="external" href="http://www.mozilla.org/projects/rt-messaging/chatzilla/">
</a></p><a class="external" href="http://www.mozilla.org/projects/rt-messaging/chatzilla/">
<h5 name="extensions.2Fjava"> extensions/java </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/rt-messaging/chatzilla/">XPCOM&lt;-&gt;Java bridge ("</a><a href="en/JavaXPCOM">JavaXPCOM</a>", formerly known as Javaconnect).
Unrelated to the code in java/.
</p>
<h5 name="extensions.2Flayout-debug"> extensions/layout-debug </h5>
<p>Layout debugger. Intended as replacement for "viewer". Can be used to run layout regression tests and has support for other layout debugging features.
</p>
<h5 name="extensions.2Flightning"> extensions/lightning </h5>
<p>The Lightning project, "an extension to tightly integrate calendar functionality (scheduling, tasks, etc.) into Thunderbird." <a class="external" href="http://wiki.mozilla.org/Calendar:Lightning">
</a></p><a class="external" href="http://wiki.mozilla.org/Calendar:Lightning">
<h5 name="extensions.2Fmanticore"> extensions/manticore </h5>
<p>C# based Gecko embedding. Also embeds Trident. Probably obsolete?
</p>
<h5 name="extensions.2Fmono"> extensions/mono </h5>
<p>A two-way bridge between the CLR/.NET/Mono/C#/etc. world and XPCOM.
</p>
<h5 name="extensions.2Fp3p"> extensions/p3p </h5>
</a><p><a class="external" href="http://wiki.mozilla.org/Calendar:Lightning">Implementation of W3C's Platform for Privacy Preferences standard.  </a><a class="external" href="http://www.mozilla.org/projects/p3p/">
</a></p><a class="external" href="http://www.mozilla.org/projects/p3p/">
<h5 name="extensions.2Fpermissions"> extensions/permissions </h5>
<p>XXX writeme
</p>
<h5 name="extensions.2Fpref"> extensions/pref </h5>
<p>Preference-related extensions:
</p>
<h6 name="autoconfig"> autoconfig </h6>
<p>XXX what does this do? is it the lock_pref stuff?
Could be downloading preferences from remote servers (like LDAP)
</p>
<h6 name="system-pref"> system-pref </h6>
<p>Support for using OS-wide preferences in Mozilla, mainly for GConf (Gnome)
</p>
<h5 name="extensions.2Fpython"> extensions/python </h5>
<p>Support for implementing XPCOM components in python.
</p>
<h5 name="extensions.2Freporter"> extensions/reporter </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/p3p/">An extension to report problems with web pages. Client-side part.  </a><a class="external" href="http://reporter.mozilla.org/app/">
</a></p><a class="external" href="http://reporter.mozilla.org/app/">
<h5 name="extension.2Fschema-validation"> extension/schema-validation </h5>
<p>Allows validating XML trees according to specified XML Schemas.
</p>
<h5 name="extension.2Fspatialnavigation"> extension/spatialnavigation </h5>
</a><p><a class="external" href="http://reporter.mozilla.org/app/">Spatial navigation, navigating between links of a document according to their on-screen position.  </a><a class="external" href="http://www.mozilla.org/access/keyboard/snav/">
</a></p><a class="external" href="http://www.mozilla.org/access/keyboard/snav/">
<h5 name="extensions.2Fspellcheck"> extensions/spellcheck </h5>
<p>Spellchecker for mailnews and composer.
</p>
<h5 name="extensions.2Fsql"> extensions/sql </h5>
</a><p><a class="external" href="http://www.mozilla.org/access/keyboard/snav/">Support for accessing SQL databases from XUL applications.  </a><a class="external" href="http://www.mozilla.org/projects/sql/">
</a></p><a class="external" href="http://www.mozilla.org/projects/sql/">
<h5 name="extensions.2Fsroaming"> extensions/sroaming </h5>
<p>Session roaming, i.e. support for storing a profile on a remote server.
</p>
<h5 name="extensions.2Ftasks"> extensions/tasks </h5>
<p>Support for launching OS-provided tasks, like a calendar.
</p>
<h5 name="extensions.2Ftransformiix"> extensions/transformiix </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/sql/">XSLT support. XSL Transformations is a language used to transform XML document into other XML documents.  </a><a class="external" href="http://www.mozilla.org/projects/xslt/">
</a></p><a class="external" href="http://www.mozilla.org/projects/xslt/">
<h5 name="extensions.2Ftridentprofile"> extensions/tridentprofile </h5>
<p>Support for importing profiles from MSIE.
</p>
<h5 name="extensions.2Ftypeaheadfind"> extensions/typeaheadfind </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/xslt/">Find As You Type allows quick web page navigation when you type a succession of characters in the body of the displayed page </a><a class="external" href="http://www.mozilla.org/projects/ui/accessibility/typeaheadfind.html">
</a></p><a class="external" href="http://www.mozilla.org/projects/ui/accessibility/typeaheadfind.html">
<h5 name="extensions.2Funiversalchardet"> extensions/universalchardet </h5>
<p>Universal character set detector.
</p>
<h5 name="extensions.2Fvenkman"> extensions/venkman </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/ui/accessibility/typeaheadfind.html">The </a><a href="en/Venkman">JavaScript Debugger</a>.
</p>
<h5 name="extensions.2Fwallet"> extensions/wallet </h5>
<p>Password and Form Manager
</p>
<h5 name="extensions.2Fwebdav"> extensions/webdav </h5>
<p>WebDAV code; exposes special APIs for accessing WebDAV servers. Used by the Calendar project.
</p>
<h5 name="extensions.2Fwebservices"> extensions/webservices </h5>
<p>Support for Webservices.  <a class="external" href="http://www.mozilla.org/projects/webservices/">
</a></p><a class="external" href="http://www.mozilla.org/projects/webservices/">
<h5 name="extensions.2Fxforms"> extensions/xforms </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/webservices/">Code for the XForms extension.  </a><a class="external" href="http://www.mozilla.org/projects/xforms/">
</a></p><a class="external" href="http://www.mozilla.org/projects/xforms/">
<h5 name="extensions.2Fxmlextras"> extensions/xmlextras </h5>
</a><p><a class="external" href="http://www.mozilla.org/projects/xforms/">Several XML-related extensions.  </a><a class="external" href="http://www.mozilla.org/xmlextras/">
</a></p><a class="external" href="http://www.mozilla.org/xmlextras/">
<h5 name="extensions.2Fxml-rpc"> extensions/xml-rpc </h5>
</a><p><a class="external" href="http://www.mozilla.org/xmlextras/">XML Remote Procedure Calls. Unowned these days.  </a><a class="external" href="http://www.mozilla.org/projects/xmlrpc/">
</a></p><a class="external" href="http://www.mozilla.org/projects/xmlrpc/">
<h5 name="extensions.2Fxmlterm"> extensions/xmlterm </h5>
<p>XMLTerm, a terminal implemented using mozilla technology. Only available on GTK builds.
</p>
<h4 name="gc"> gc </h4>
<p>Container for garbage collection libraries, currently only boehm GC.
</p>
<h4 name="gc.2Fboehm"> gc/boehm </h4>
<p>Source code of boehm gc, not compiled by default.  Used to be used for leak detection.
</p>
<h4 name="gfx"> gfx </h4>
<p>Contains interfaces that abstract the capabilities of platform graphics toolkits, along with implementations on various platforms.  These interfaces provide methods for things like drawing images, text, and basic shapes.  It also contains basic data structures such as points and rectangles used here and in other parts of Mozilla.
</p></a><p><a class="external" href="http://www.mozilla.org/projects/xmlrpc/">It's also the home of the new graphics architecture based on cairo (via a C++ wrapper called thebes).  </a><a class="external" href="http://wiki.mozilla.org/Mozilla2:NewGFXAPIs"> </a><a class="external" href="http://wiki.mozilla.org/Mozilla2:GFXEvolution">
</a></p><a class="external" href="http://wiki.mozilla.org/Mozilla2:GFXEvolution">
<h4 name="intl"> intl </h4>
</a><p><a class="external" href="http://wiki.mozilla.org/Mozilla2:GFXEvolution">Internationalization and localization support. </a><a class="external" href="http://www.mozilla.org/projects/intl/index.html">
</a></p><a class="external" href="http://www.mozilla.org/projects/intl/index.html">
<dl><dt> bidi </dt><dd> Obsolete.
</dd><dt> chardet </dt><dd> Code for "sniffing" the character encoding of Web pages.
</dd><dt> ctl </dt><dd> Code for dealing with Complex Text Layout, related to shaping of south Asian languages (not built by default, needs <code>--enable-ctl</code>)
</dd><dt> locale </dt><dd> Code related to determination of locale information from the operating environment
</dd><dt> lwbrk </dt><dd> Code related to line breaking and word breaking
</dd><dt> strres </dt><dd> Code related to string resources used for localization.
</dd><dt> uconv </dt><dd> Code that converts (both ways: encoders and decoders) between UTF-16 and many other character encodings.
</dd><dt> unicharutil </dt><dd> Code related to implementation of various algorithms for Unicode text, such as case conversion
</dd></dl>
<h4 name="ipc"> ipc </h4>
<p>Container for implementations of IPC (Inter-Process Communication) mechanisms.
</p>
<h4 name="ipc.2Fipcd"> ipc/ipcd </h4>
<p>The IPC daemon that's used for communication between several mozilla processes to support profile sharing.  (Note that at the time of this writing (Dec 2005), profile sharing is not supported by mozilla).
</p>
<h4 name="jpeg"> jpeg </h4>
<p>Source code of libjpeg, used by the mozilla image library.
</p>
<h4 name="js.2Fsrc"> js/src </h4>
</a><p><a class="external" href="http://www.mozilla.org/projects/intl/index.html">The JavaScript engine, also known as Spidermonkey.  See </a><a class="external" href="http://www.mozilla.org/js/">
</a></p><a class="external" href="http://www.mozilla.org/js/">
<h4 name="js.2Fjsd"> js/jsd </h4>
</a><p><a class="external" href="http://www.mozilla.org/js/">JavaScript debugging library. </a><a class="external" href="http://www.mozilla.org/js/jsd/">
</a></p><a class="external" href="http://www.mozilla.org/js/jsd/">
<h4 name="js.2Fsrc.2Fxpconnect"> js/src/xpconnect </h4>
</a><p><a class="external" href="http://www.mozilla.org/js/jsd/">Support code for calling JS Code from C++ code and C++ code from JS Code, using XPCOM interfaces.  </a><a class="external" href="http://www.mozilla.org/scriptable/">
</a></p><a class="external" href="http://www.mozilla.org/scriptable/">
<h4 name="js.2Fsrc.2Fliveconnect"> js/src/liveconnect </h4>
</a><p><a class="external" href="http://www.mozilla.org/scriptable/">Liveconnect, the bridge between JS and Java code.  </a><a class="external" href="http://www.mozilla.org/js/liveconnect/">
</a></p><a class="external" href="http://www.mozilla.org/js/liveconnect/">
<h4 name="l10n"> l10n </h4>
<p>Basically empty and not used by the mozilla build.
</p>
<h4 name="layout"> layout </h4>
</a><p><a class="external" href="http://www.mozilla.org/js/liveconnect/">Code that implements a tree of rendering objects that describe the types and locations of the objects that are displayed on the screen (such as CSS boxes, tables, form controls, XUL boxes, etc.), and code that manages operations over that rendering tree (such as creating and destroying it, doing layout, painting, and event handling).  See </a><a class="external" href="http://www.mozilla.org/newlayout/doc/">documentation</a> and <a class="external" href="http://www.mozilla.org/newlayout/">other information</a>.
</p>
<dl><dt> base </dt><dd> Code that deals with the rendering tree.
</dd><dt> generic </dt><dd> The basic rendering object interface and the rendering tree objects for basic CSS boxes.
</dd><dt> forms </dt><dd> Rendering tree objects for HTML form controls.
</dd><dt> tables </dt><dd> Rendering tree objects for CSS/HTML tables
</dd><dt> mathml </dt><dd> Rendering tree objects for <a href="en/MathML">MathML</a>.
</dd><dt> svg </dt><dd> Rendering tree objects for <a href="en/SVG">SVG</a>
</dd><dt> xul </dt><dd> Additional rendering object interfaces for <a href="en/XUL">XUL</a> and the rendering tree objects for XUL boxes
</dd></dl>
<h4 name="lib"> lib </h4>
<p>Mostly unused; might be used on mac?
</p>
<h4 name="mail"> mail </h4>
<p>Thunderbird frontend files. Note that many thunderbird files are shared with Mozilla Mailnews and can be found under mailnews/.
</p>
<h4 name="mailnews"> mailnews </h4>
<p>The mail and news backend code (e.g., code that manages folders, manages databases, or interacts with mail servers) and the frontend code for the SeaMonkey mail client, some of which is shared by Thunderbird.
</p>
<h4 name="modules.2Flibimg"> modules/libimg </h4>
<p>Contains libpng, used by the image library for PNG Image decoding.
</p>
<h4 name="modules.2Flibjar"> modules/libjar </h4>
<p>Code to read zip files, used for reading the .jar files that contain the files for the mozilla frontend.
</p>
<h4 name="modules.2Flibpr0n"> modules/libpr0n </h4>
<p>Image rendering library. Contains decoders for the image formats mozilla supports.
</p>
<h4 name="modules.2Flibpref"> modules/libpref </h4>
<p>Library for reading and writing preferences.
</p>
<h4 name="modules.2Flibreg"> modules/libreg </h4>
<p>Library for reading the netscape binary registry files, used for the ~/.mozilla/appreg file (registry.dat on windows).
</p>
<h4 name="modules.2Flibutil"> modules/libutil </h4>
<p>XXX what's this??
</p>
<h4 name="modules.2Foji"> modules/oji </h4>
<p>Support for the java plugin.  <a class="external" href="http://www.mozilla.org/oji/">
</a></p><a class="external" href="http://www.mozilla.org/oji/">
<h4 name="modules.2Fplugin"> modules/plugin </h4>
</a><p><a class="external" href="http://www.mozilla.org/oji/">Plugin support. Implements the Netscape Plugin-API NPAPI </a><a class="external" href="http://www.mozilla.org/projects/plugins/">
</a></p><a class="external" href="http://www.mozilla.org/projects/plugins/">
<h4 name="modules.2Fstaticmod"> modules/staticmod </h4>
<p>Helper files for static mozilla builds
</p>
<h4 name="modules.2Fzlib"> modules/zlib </h4>
<p>Source code of zlib, used at least in the networking library for compressed transfers.
</p>
<h4 name="netwerk"> netwerk </h4>
</a><p><a class="external" href="http://www.mozilla.org/projects/plugins/"></a><a href="en/Necko">Networking library</a>, also known as Necko. Responsible for doing actual transfers from and to servers, as well as for URI handling and related stuff.  <a class="external" href="http://www.mozilla.org/projects/netlib/">
</a></p><a class="external" href="http://www.mozilla.org/projects/netlib/">
<h4 name="nsprpub"> nsprpub </h4>
</a><p><a class="external" href="http://www.mozilla.org/projects/netlib/">Netscape Portable Runtime. Used as an abstraction layer to things like threads, file I/O and socket I/O.  </a><a class="external" href="http://www.mozilla.org/projects/nspr/">
</a></p><a class="external" href="http://www.mozilla.org/projects/nspr/">
<h4 name="other-licenses"> other-licenses </h4>
<p>Contains libraries that are not covered by the MPL but used in some mozilla code.
</p>
<h4 name="parser.2Fexpat"> parser/expat </h4>
<p>Copy of the expat source code, which is the XML parser used by mozilla.
</p>
<h4 name="parser.2Fhtmlparser"> parser/htmlparser </h4>
<p>Contains the html parser used by Mozilla, which parses HTML source code and calls the appropriate methods on a content sink.
</p>
<h4 name="plugin"> plugin </h4>
<p>Mostly obsolete.  All that's left in this directory is code related to Java plugins on the Mac.
</p>
<h4 name="profile"> profile </h4>
<p>Code for profile handling, the profile manager backend and frontend.
</p>
<h4 name="rdf"> rdf </h4>
</a><p><a class="external" href="http://www.mozilla.org/projects/nspr/">RDF handling APIs. </a><a href="en/RDF">RDF</a>, <a class="external" href="http://www.mozilla.org/rdf/doc/">
</a></p><p><a class="external" href="http://www.mozilla.org/rdf/doc/">Also contains the chrome registry code used by SeaMonkey, although toolkit apps (such as Firefox and Thunderbird) use the copy forked into </a><a href="#chrome">chrome</a>.
</p>
<h4 name="security"> security </h4>
<p>Contains NSS and PSM, to support cryptographic functions in mozilla (like S/MIME, SSL, etc).  <a class="external" href="http://www.mozilla.org/projects/security/pki/nss/"> </a><a class="external" href="http://www.mozilla.org/projects/security/pki/psm/">
</a></p><a class="external" href="http://www.mozilla.org/projects/security/pki/psm/">
<h4 name="storage"> storage </h4>
</a><p><a class="external" href="http://www.mozilla.org/projects/security/pki/psm/"></a><a href="en/Storage">Storage</a>: XPCOM wrapper for sqlite. Wants to unify storage of all profile-related data. Supersedes mork.  <a class="external" href="http://wiki.mozilla.org/Mozilla2:Unified_Storage">
</a></p><a class="external" href="http://wiki.mozilla.org/Mozilla2:Unified_Storage">
<h4 name="suite"> suite </h4>
<p>Newer parts of SeaMonkey-specific code. Older parts live in {{template.Source("xpfe/")}}.
</p>
<h4 name="sun-java"> sun-java </h4>
<p>XXX another java directory?
</p>
<h4 name="themes"> themes </h4>
<p>Contains the themes shipped with SeaMonkey. Classic and Modern at the time of this writing.
</p>
<h4 name="toolkit"> toolkit </h4>
</a><p><a class="external" href="http://wiki.mozilla.org/Mozilla2:Unified_Storage">The "new toolkit" used by Thunderbird, Firefox, etc.  This contains numerous front-end components shared between applications as well as most of the XBL-implemented parts of the XUL language (most of which was originally forked from versions in </a><a href="#xpfe.2F">#xpfe/</a>).
</p>
<h4 name="tools"> tools </h4>
<p>Some tools which are optionally built during the mozilla build process, mostly used for debugging.
</p>
<h4 name="uriloader.2Fbase"> uriloader/base </h4>
<p>Content dispatch in Mozilla. Used to load uris and find an appropriate content listener for the data. Also manages web progress notifications.  <a class="external" href="http://www.mozilla.org/docs/docshell/uri-load-start.html"> </a><a class="external" href="http://www.mozilla.org/docs/url_load.html">
</a></p><a class="external" href="http://www.mozilla.org/docs/url_load.html">
<h4 name="uriloader.2Fexthandler"> uriloader/exthandler </h4>
<p>Used to handle content that Mozilla can't handle itself. Responsible for showing the helper app dialog, and generally for finding information about helper applications.
</p>
<h4 name="uriloader.2Fprefetch"> uriloader/prefetch </h4>
<p>Service to prefetch documents in order to have them cached for faster loading.
</p>
<h4 name="view"> view </h4>
<p>View manager.  Contains cross-platform code used for painting, scrolling, event handling, z-ordering, and opacity.  Soon to become obsolete, gradually.
</p>
<h4 name="webshell"> webshell </h4>
</a><p><a class="external" href="http://www.mozilla.org/docs/url_load.html">Mostly obsolete, and being merged into </a><a href="#docshell">docshell</a>.
</p>
<h4 name="widget"> widget </h4>
<p>A cross-platform API, with implementations on each platform, for dealing with Operating system/environment widgets, i.e., code related to creation and handling of windows, popups, and other native widgets and to converting the system's messages related to painting and events into the messages used by other parts of Mozilla (e.g., <a href="#view">view</a> and <a href="#content">content</a>, the latter of which converts many of the messages to yet another API, the DOM event API).
</p>
<h4 name="xpcom"> xpcom </h4>
<p><a href="en/XPCOM">Cross-Platform Component Object Model</a>. Also contains data structures used by the rest of the mozilla code.  <a class="external" href="http://www.mozilla.org/projects/xpcom/">
</a></p><a class="external" href="http://www.mozilla.org/projects/xpcom/">
<h4 name="xpfe"> xpfe </h4>
</a><p><a class="external" href="http://www.mozilla.org/projects/xpcom/">XPFE is the SeaMonkey frontend. It contains the XUL files for the browser interface, common files used by the other parts of the mozilla suite, and the XBL files for the parts of the XUL language that are implemented in XBL.  Much of this code has been copied to </a><a href="#browser">browser</a> and <a href="#toolkit">toolkit</a> for use in Firefox, Thunderbird, etc.
</p>
<h5 name="xpfe.2Fcomponents"> xpfe/components </h5>
<p>Components used by the Mozilla frontend, as well as implementations of interfaces that other parts of mozilla expect.
</p>
<h5 name="xpfe.2Fbootstrap"> xpfe/bootstrap </h5>
<p>Startup code for Mozilla. This contains the main/WinMain function.  (Not used by "new toolkit" apps; for those, see toolkit/xre and the "app" directory for each specific app)
</p>
<h4 name="xpinstall"> xpinstall </h4>
<p>The installer, which contains code for installing Mozilla and for installing XPIs/extensions. This directory also contains code needed to build installer packages. See <a href="en/XPInstall">XPInstall</a> and the <a class="external" href="http://www.mozilla.org/projects/xpinstall/">XPInstall project page</a>.
</p>
<h4 name="xulrunner"> xulrunner </h4>
<p>Code for <a class="external" href="http://wiki.mozilla.org/XUL:Xul_Runner">XULRunner</a>.
</p>
Revert to this revision