EXPERIMENTAL - copy of comm-central for forking on github
Перейти к файлу
Mozilla Releng Treescript 7d618a30ae no bug - Bumping Thunderbird l10n changesets r=release a=l10n-bump DONTBUILD
af -> d273c184e3892ddd65eadc9cc3813b7a387609db
ar -> d273c184e3892ddd65eadc9cc3813b7a387609db
ast -> d273c184e3892ddd65eadc9cc3813b7a387609db
be -> d273c184e3892ddd65eadc9cc3813b7a387609db
bg -> d273c184e3892ddd65eadc9cc3813b7a387609db
br -> d273c184e3892ddd65eadc9cc3813b7a387609db
ca -> d273c184e3892ddd65eadc9cc3813b7a387609db
cak -> d273c184e3892ddd65eadc9cc3813b7a387609db
cs -> d273c184e3892ddd65eadc9cc3813b7a387609db
cy -> d273c184e3892ddd65eadc9cc3813b7a387609db
da -> d273c184e3892ddd65eadc9cc3813b7a387609db
de -> d273c184e3892ddd65eadc9cc3813b7a387609db
dsb -> d273c184e3892ddd65eadc9cc3813b7a387609db
el -> d273c184e3892ddd65eadc9cc3813b7a387609db
en-CA -> d273c184e3892ddd65eadc9cc3813b7a387609db
en-GB -> d273c184e3892ddd65eadc9cc3813b7a387609db
es-AR -> d273c184e3892ddd65eadc9cc3813b7a387609db
es-ES -> d273c184e3892ddd65eadc9cc3813b7a387609db
es-MX -> d273c184e3892ddd65eadc9cc3813b7a387609db
et -> d273c184e3892ddd65eadc9cc3813b7a387609db
eu -> d273c184e3892ddd65eadc9cc3813b7a387609db
fi -> d273c184e3892ddd65eadc9cc3813b7a387609db
fr -> d273c184e3892ddd65eadc9cc3813b7a387609db
fy-NL -> d273c184e3892ddd65eadc9cc3813b7a387609db
ga-IE -> d273c184e3892ddd65eadc9cc3813b7a387609db
gd -> d273c184e3892ddd65eadc9cc3813b7a387609db
gl -> d273c184e3892ddd65eadc9cc3813b7a387609db
he -> d273c184e3892ddd65eadc9cc3813b7a387609db
hr -> d273c184e3892ddd65eadc9cc3813b7a387609db
hsb -> d273c184e3892ddd65eadc9cc3813b7a387609db
hu -> d273c184e3892ddd65eadc9cc3813b7a387609db
hy-AM -> d273c184e3892ddd65eadc9cc3813b7a387609db
id -> d273c184e3892ddd65eadc9cc3813b7a387609db
is -> d273c184e3892ddd65eadc9cc3813b7a387609db
it -> d273c184e3892ddd65eadc9cc3813b7a387609db
ja -> d273c184e3892ddd65eadc9cc3813b7a387609db
ja-JP-mac -> d273c184e3892ddd65eadc9cc3813b7a387609db
ka -> d273c184e3892ddd65eadc9cc3813b7a387609db
kab -> d273c184e3892ddd65eadc9cc3813b7a387609db
kk -> d273c184e3892ddd65eadc9cc3813b7a387609db
ko -> d273c184e3892ddd65eadc9cc3813b7a387609db
lt -> d273c184e3892ddd65eadc9cc3813b7a387609db
lv -> d273c184e3892ddd65eadc9cc3813b7a387609db
mk -> d273c184e3892ddd65eadc9cc3813b7a387609db
ms -> d273c184e3892ddd65eadc9cc3813b7a387609db
nb-NO -> d273c184e3892ddd65eadc9cc3813b7a387609db
nl -> d273c184e3892ddd65eadc9cc3813b7a387609db
nn-NO -> d273c184e3892ddd65eadc9cc3813b7a387609db
pa-IN -> d273c184e3892ddd65eadc9cc3813b7a387609db
pl -> d273c184e3892ddd65eadc9cc3813b7a387609db
pt-BR -> d273c184e3892ddd65eadc9cc3813b7a387609db
pt-PT -> d273c184e3892ddd65eadc9cc3813b7a387609db
rm -> d273c184e3892ddd65eadc9cc3813b7a387609db
ro -> d273c184e3892ddd65eadc9cc3813b7a387609db
ru -> d273c184e3892ddd65eadc9cc3813b7a387609db
sk -> d273c184e3892ddd65eadc9cc3813b7a387609db
sl -> d273c184e3892ddd65eadc9cc3813b7a387609db
sq -> d273c184e3892ddd65eadc9cc3813b7a387609db
sr -> d273c184e3892ddd65eadc9cc3813b7a387609db
sv-SE -> d273c184e3892ddd65eadc9cc3813b7a387609db
th -> d273c184e3892ddd65eadc9cc3813b7a387609db
tr -> d273c184e3892ddd65eadc9cc3813b7a387609db
uk -> d273c184e3892ddd65eadc9cc3813b7a387609db
uz -> d273c184e3892ddd65eadc9cc3813b7a387609db
vi -> d273c184e3892ddd65eadc9cc3813b7a387609db
zh-CN -> d273c184e3892ddd65eadc9cc3813b7a387609db
zh-TW -> d273c184e3892ddd65eadc9cc3813b7a387609db
2024-08-31 18:54:40 +00:00
build No bug, trigger build. rs=me 2024-08-23 12:22:57 +02:00
calendar Bug 1914792 - Port bug 1870226 to Thunderbird - Update eslint-plugin-jsdoc. r=freaktechnik 2024-08-26 08:29:10 +00:00
chat Bug 1914633 - Fix conversation-message-parted XMPP message string placeholder replacement. r=clokep 2024-08-28 22:59:17 +00:00
docs Bug 1910346 - Update calendar and mailnews core peers/owners emeritus r=wsmwk,zeid 2024-07-31 21:28:43 +00:00
mail no bug - Bumping Thunderbird l10n changesets r=release a=l10n-bump DONTBUILD 2024-08-31 18:54:40 +00:00
mailnews No bug - Remove some pointless abbreviations of Ci members. rs=me 2024-08-30 16:32:45 +12:00
other-licenses/7zstub Bug 1840940 - Update Windows installer icon. r=aleca 2023-06-30 19:24:56 +02:00
python Bug 1915288 - Include platform-specific Rust dependencies when copying deps from mozilla-central. r=rjl,thunderbird-reviewers,tobyp DONTBUILD 2024-08-28 16:33:23 +00:00
rust Bug 1878375 - Synchronize vendored Rust libraries with mozilla-central. r=tobyp 2024-08-31 12:56:39 +00:00
suite Update configs. IGNORE BROKEN CHANGESETS CLOSED TREE NO BUG a=release ba=release 2024-08-05 15:25:54 +00:00
taskcluster Bug 1691802 - Build win-arm64 only on comm-central. r=dandarnell 2024-08-26 17:21:45 +00:00
testing Backed out changeset 30c2520e5b0e (bug 1893603) by request DONTBUILD 2024-08-01 15:10:19 +01:00
third_party Bug 1878375 - Synchronize vendored Rust libraries with mozilla-central. r=tobyp 2024-08-31 12:56:39 +00:00
tools/lint Bug 1899602 - remove obsolete Telemetry testing probes. r=aleca 2024-06-28 12:44:02 +03:00
.arcconfig Bug 1460372 - Update .arcconfig to make history mutable. r=Fallen 2018-05-09 13:56:23 -04:00
.clang-format-ignore Bug 1787097 - Remove libical. r=leftmostcat 2022-08-25 15:54:49 +12:00
.cron.yml Bug 1905803 - Enable l10n_bumper on comm central. r=dandarnell 2024-07-31 18:23:14 +00:00
.eslintignore Bug 1893718 - Configure jsdoc with a javascript file rather than JSON. r=aleca 2024-04-29 15:37:21 -07:00
.eslintrc.js Bug 1801529 - Enable valid-jsdoc linter on inappnotifications component. rs=me 2024-07-03 18:42:03 +02:00
.gecko_rev.yml Backed out changeset ae4312567478 (bug 1810211) for including unwanted changes. r=backout a=rjl 2023-01-16 20:06:52 -05:00
.hg-annotate-ignore-revs Bug 1833949 - Follow-up: Add reformatting revs to .hg-annotate-ignore-revs. r=aleca 2023-05-24 20:38:01 +10:00
.hgignore Bug 1893718 - Configure jsdoc with a javascript file rather than JSON. r=aleca 2024-04-29 15:37:21 -07:00
.hgtags No bug - tagging 891259bdd81accd3390cb76fc18522ec503d6561 with NIGHTLY_130_END a=release DONTBUILD CLOSED TREE 2024-08-05 15:25:53 +00:00
.prettierignore Bug 1889348 - Ignore built documentation with prettier. r=rjl 2024-04-05 11:47:41 +02:00
.readthedocs.yaml Bug 1872974 - Add sphinx-js to in-tree docs. r=rjl 2024-02-03 11:09:04 +00:00
.stylelintignore Bug 1832130 - Port bug 1508369: Add stylelint to mach commlint. r=aleca 2023-05-24 18:49:33 +00:00
.stylelintrc.js Bug 1858972 - Port bug 1857565: Remove leftover mention of moz-image-rect. r=john.bieling 2023-10-13 13:34:08 -04:00
.taskcluster.yml Bug 1891451 - Port bug 1868440: Upgrade Gecko to Taskgraph 7.x. r=rjl 2024-04-19 11:28:31 +01:00
.yamllint Bug 1793921 - Don't add local code as explicit dependency to storybook. r=rjl 2022-10-07 23:56:22 +00:00
.ycm_extra_conf.py Bug 1185540 - Support YouCompleteMe vim plugin in comm-central. r=mkmelin a=SM CLOSED TREE 2015-07-20 17:31:37 +02:00
AUTHORS Bug 1138689 - /me and /action should fire a sending-message notification before actually sending the action. r=clokep 2015-03-13 13:04:26 -07:00
README.md Bug 1896483 - Part 2: Update get-involved links to participate. r=aleca,dandarnell 2024-06-10 22:27:15 +02:00
mots.yaml Bug 1910346 - Update calendar and mailnews core peers/owners emeritus r=wsmwk,zeid 2024-07-31 21:28:43 +00:00
moz.build Fix bug 1139679 - Make use of BUG_COMPONENT metadata. r=jcranmer 2015-03-17 13:50:09 +01:00
pyproject.toml Bug 1822061 - Port bug 1811850: Replace isort linter with ruff. r=dandarnell 2023-03-20 22:40:28 +00:00

README.md

Thunderbird

Thunderbird is a powerful and customizable open source email client with lots of users. It is based on the same platform that Firefox uses.

Getting Started

This README will try and give you the basics that you need to get started, more comprehensive documentation is available on the Thunderbird Developer Website.

Mozilla Code Base

Thunderbird is built on the Mozilla platform, the same base that Firefox is built from. As such the two projects share a lot of code and much of the documentation for one will apply, in many ways, to the other.

In order to be able to build Thunderbird - you will need the mozilla-central repository as well as the comm-central repository (where this README lives). Check out our Getting Started documentation for instructions on how and where to get the source code.

mozilla-central vs. comm-central

The mozilla-central repostitory contains the Firefox codebase and all of the platform code. The comm-central repository is added as a subdirectory "comm/" under mozilla-central. This contains the code for Thunderbird.

Building Thunderbird

Build Prerequisites

This README assumes that you already have the prerequisite software required to build Thunderbird. If you have not already done so, please complete the instructions for your operating system and then continue following this guide:

Build Configuration

To build Thunderbird, you need to create a file named mozconfig (can also be .mozconfig) to the root directory of the mozilla-central checkout that contains the option comm/mail enabled. You can create a file with this line by doing this in the root source directory:

echo 'ac_add_options --enable-project=comm/mail' > mozconfig

If you omit this line, the build system will build Firefox instead. Other build configuration options can be added to this file, although it's strongly recommended that you only use options that you fully understand. For example, to create a debug build instead of a release build, that file would also contain the line:

ac_add_options --enable-debug

Each of these ac_add_options entries needs to be on its own line.

For more on configuration options, see the page Configuring build options. Note that if you use an MOZ_OBJDIR it cannot be a sibling folder to the root source directory. Use an absolute path to be sure!

Building

Before you start, make sure that the version you checked out is not busted. For hg tip, you should see green Bs on https://treeherder.mozilla.org/#/jobs?repo=comm-central

To start the build, cd into the root source directory, and run:

./mach build

mach is our command-line tool to streamline common developer tasks. See the mach article for more.

Building can take a significant amount of time, depending on your system, OS, and chosen build options. Linux builds on a fast box may take under 15 minutes, but Windows builds on a slow box may take several hours.

Make Your Build Faster

Follow this guide to rely on ccache and other Tips for making builds faster.

Running Thunderbird

To run your build, you can use:

./mach run

There are various command line parameters you can add, e.g. to specify a profile, such as: -no-remote -P testing --purgecaches

Various temporary files, libraries, and the Thunderbird executable will be found in your object directory under `comm-central/`, which is prefixed with obj-. The exact name depends on your system and OS. For example, a Mac user may get an object directory name of obj-x86_64-apple-darwin10.7.3/.

The Thunderbird executable in particular, and its dependencies are located under the dist/bin folder under the object directory. To run the executable from your comm-central working directory:

  • Windows: obj-.../dist/bin/thunderbird.exe
  • Linux: obj-.../dist/bin/thunderbird
  • macOS: obj-.../dist/Daily.app/Contents/MacOS/thunderbird

Update and Build Again

To pull down the latest changes, in the mozilla directory run the following commands:

hg pull -u
cd comm
hg pull -u
cd ..

or to do it via one command:

hg pull -u && cd comm && hg pull -u

The just run the ./mach build command detailed in the Buildinginstructions above. This will only recompile files that changed, but it may still take a long time.

Rebuilding

To build after changes you can simply run:

./mach build

Rebuilding Specific Parts

If you have made many changes, but only want to rebuild specific parts, you may run the following commands.

C or C++ Files:

./mach build binaries

JavaScript or XUL Files Windows Only:

./mach build path/to/dir

Replace path/to/dir with the directory with the files changed.

This is the tricky bit since you need to specify the directory that installs the files, which may be a parent directory of the changed file's directory. For example, to just rebuild the Lightning calendar extension:

./mach build comm/calendar/lightning

Contributing

Getting Plugged into the Community

We have a complete listing of the ways in which you can get involved with Thunderbird on our website. Below are some quick references from that page that you can use if you are looking to contribute to Thunderbird core right away.

Mailing Lists

If you want to participate in discussions about Thunderbird development, there are two main mailing lists you want to join.

  1. TB-Planning: This mailing list is higher level topics like: the future of Thunderbird, potential features, and changes that you would like to see happen. It is also used to discuss a variety of broader issues around community and governance of the project.
  2. Maildev: A moderated mailing list for discussing engineering plans for Thunderbird. It is a place where you can raise questions and ideas for core Thunderbird development.

IRC

If you want to ask questions about how to hack on Thunderbird, the IRC channel you want to join is #maildev on irc.mozilla.org.

Report a Bug and Request Features

Bugzilla

Thunderbird uses bugzilla for reporting and tracking bugs as well as enhancement requests. If you want to become a contributor to Thunderbird, you will need an account on Bugzilla.

Fixing a Bug and Submitting Patches

All the issues, bugs, work in progress patches, or updates related to Thunderbird, are listed on Bugzilla and are properly organized per Product, Component, and Status. For instance you can see how they are listed by looking at recent bugs for Thunderbird.

Create a Bugzilla account

Creating an account is necessary in order to submit patches, leave comments, and interact with any other aspect of Bugzilla. If you're currently using an IRC username in the #maildev channel, we recommend saving your profile name with the current format Firstname Lastname (:username) in order to be easily searchable and allow the Thunderbird team to offer better support.

Find a Bug

Use the Advanced Search section to find bugs you want to take care of, and be sure that the bug doesn't currently have any user listed as Assignee and the Status is set to NEW. You can see a list of "easy" bugs for beginners via this query. However, we assume you came here to fix your "pet hate" bug, so you already likely have a bug to work with.

Search for Code References

Making sense of the Thunderbird source code, and knowing where to look, will take some time. The code base is pretty big and if you never worked with XBL or Custom Elements it can be overwhelming at first. We recommend using our code search engine, Searchfox, to inspect the source code and find snippets and references to help you out while investigating a bug.

Mercurial Workflow

Mercurial is pretty flexible in terms of allowing you to write your own code and keep it separate from the main code base. You can use Mercurial Bookmarks or Mercurial Queues for managing your work. We have guides created for bookmarks and queues on our developer website. While some find Mercurial Queues easier to work with, support for them is being deprecated in various Mozilla tools.

Once you finished taking care of your favorite bug and using Mercurial to commit and export your patch, you can upload it to Bugzilla for review.

Upload a Patch

Open your patch file in your code editor and be sure it includes all your code changes, and your name and commit message at the top. You can see an example of a patch for this README here.

If everything looks good, you can access the selected bug in Bugzilla and click on the Attach File link located above the first comment.

Ask for a Review

When uploading a patch to Bugzilla, you can request a review from the user who opened the bug or another developer. Simply select the ? in the dropdown selector in the review option of the Flags section. An input field will appear which will allow you to type the name or username of the user you want to review your patch. You can see an example of a patch on Bugzilla here.