Changes

# ; The type of device in use : (ex: Geeksphone Keon, Geeksphone Peak, Unagi device, etc.), the "Build Identifier" of the build you are using (taken from the Settings app under "Device Information", "More Information"), the first 12 digits of the "git commit info" hash that looks like 79e92f6baa09 (taken from the Settings app under "Device Information", "More Information")# ; Confirm the net connection is working: If the e-mail app is experiencing trouble talking to a server, confirmation that you can use the browser app to access websites from the device *immediately after* the failure in the e-mail app to talk to a server. Sometimes the device is simply experiencing network problems and the e-mail app currently is not smart enough to distinguish between a problem talking to a specific server and a problem talking to any servers.# ; The e-mail domain you used/are using to create the account. : So if you typed in "foo@gmail.com", please tell us "gmail.com". If you typed in "foo@vanitydomain.com", please tell us "vanitydomain.com".## * This allows us to try and reproduce any autoconfiguration problems as well as manually investigate DNS entries, etc. It also helps us identify the specific type of mail server in use (Dovecot, Cyrus, etc.)# ; If this was a problem creating the account: , The error code from the account creation failure. : A human-readable error string will be displayed in white text on a black background. Below and to the right, the error code will be displayed in brackets. It will be something like "[no-config-info(mx404)]". We want/need the value in brackets.# ; If this is not a problem creating the account: , the account type the e-mail client thinks it is using. : This can be accessed by bringing up the settings page for the app, clicking on the account in question, finding the line label "Account type", and reporting the value to the right in blue. The value should be one of "Activesync" or "IMAP+SMTP".## * The settings menu is accessed by: 1) bringing up the folder list by clicking the three parallel horizontal lines in the top left of the message list card, then 2) clicking on the gear icon in the lower left of the folder list tray.# ; A log of what was happening around the time the problem happened. : This can take the form of the GeckoDump logcat category or a log generated by the secret debug mechanism.## * logcat log of what the e-mail app was doing:### ** First, you need to make sure that your build is running with the "browser.dom.window.dump.enabled" preference is set to true for your build. You will know this is the case if your logcat output shows "LOG: got localized!" and "LOG: Mail universe/bridge created, notifying" when you start the e-mail app. It appears that nightly builds do have this setting on by default, but it's very confusing.#### *** You can enable the preference in your own gaia builds by creating a file GAIA/build/custom-prefs.js (note: this used to be GAIA/custom-prefs.js, but it changed) and making sure it includes the line: pref("browser.dom.window.dump.enabled", true);#### *** I hope there's a better way, but if not, if you just want to change the setting on the device, you will need to modify /data/b2g/mozilla/PROFILEDIR/prefs.js to include the line. See below for one way to do this.### *** Please provide the logcat by running '''adb logcat -v time -s GeckoDump:V Gecko:V| tee FILENAME-TO-LOG-TO'''. This filters Please start running this command BEFORE you attempt to reproduce the problem. logcat uses a circular buffer that discards older entries when the buffer fills up, so if you run logcat only after the problem happens, you may not have all of the logic. Once you are done, hit control-C and send us the file. **** The logcat arguments filter out garbage a lot of the noise that we don't care aboutand gives us timestamps.**** The "tee" command lets you see the output while also logging the output directly to a file. This way you don't have to copy and paste the log.**** Also, please only include portions of the log from the e-mail app; searching for "LOG: Mail universe/bridge created" is a good way to find out when the e-mail app started. Apparently, other apps are much more likely to reveal private data, and we do not want any of that. We do try to avoid doing that, but please also skim the contents of the log to make sure there are no obvious reveals of personal information. Currently, we expect the e-mail domain you are signing up for to be exposed in the log if your problem occurs during the configuration process, but we really need that info anyways.## * Secret debug: For now, logcats are usually still good enough, but if we request or you would like to provide the more detailed structured logging output, please see https://wiki.mozilla.org/Gaia/Email/SecretDebugMode# ; If the problem involves a specific message and the problem is not duplicated for other messages, it would be great if you could look at the message in an alternate mail client : (like webmail or Thunderbird) and see if the message has anything special about it. If you can't tell and the message is not private, attaching a copy of the message to the bug can be very helpful.