Sardisson: /* Assorted Tools */ add TC here

2011-01-09T20:57:37Z

Assorted Tools: add TC here

Sardisson: /* Crash Reporting */ deep-six Talkback parts; change links to 2.0.3

2010-05-27T03:14:46Z

Crash Reporting: deep-six Talkback parts; change links to 2.0.3

Sardisson: move Development#Tools section to its own page

2010-05-27T03:10:48Z

move Development#Tools section to its own page

New page

{{draft}}

This page contains descriptions of various webtools that help with coding, regression hunting, checking in, crash management, and other Camino activities.

''link to tools and explanations; currently links are all to explanations of some degree of usefulness''

==MXR==
[http://mxr.mozilla.org/ MXR] is a source cross-reference, or an advanced, web-based Spotlight for source code. It contains a browseable, searchable copy of the current source code, complete with syntax highlighting, hyperlinks for functions and various identifiers, and more. Once you’ve found a piece of code you’re interested in, you can also use MXR to find when the code last changed (“blame”) and the changelog for the file. Using these linked tools (bonsai and hgweb, depending on the version of Camino and the MXR “root”), you can also travel back in time and see what your code or file looked like at various points in the past.

* For Camino 2.1 based on Mozilla 1.9.2, you want the [http://mxr.mozilla.org/camino/ camino] root for Camino code (updated daily) and the [http://mxr.mozilla.org/mozilla1.9.2/ mozilla1.9.2] root for Gecko.
* For Camino 2.1 based on cvs trunk, you want the [http://mxr.mozilla.org/seamonkey/ seamonkey] root (updated hourly).
* For Camino 2.0, there is no discrete root. However, you can access the current CAMINO_2_0_BRANCH version of a file by finding the file in the seamonkey root, choosing the “CVS Graph” link (in the box at the top right of the page), and then selecting the revision for the CAMINO_2_0_BRANCH from the graph. For Core checkins related to Camino 2.0.x (aside from <code>client.mk</code>), use the seamonkey root.
* For Camino 1.6.x (MOZILLA_1_8_BRANCH), you want the [http://mxr.mozilla.org/mozilla1.8/ mozilla1.8] root.
* For Camino 1.5, as with Camino 2.0, there is no MXR root. For Core checkins to Camino 1.5.x, you want the mozilla1.8 root; for Camino code on the CAMINO_1_5_BRANCH, you can use the method described for the CAMINO_2_0_BRANCH above to find CAMINO_1_5_BRANCH files.
* For Camino 1.0.x (MOZILLA_1_8_0_BRANCH), you want the [http://mxr.mozilla.org/mozilla1.8.0/ mozilla1.8.0] root.
* For Camino 0.8 (MOZILLA_1_7_BRANCH) and some access to really old files that may have been renamed with history loss (e.g., to track additions to the project over time, from Project Builder to Xcode 1.x to Xcode 2.x), you want the [http://mxr.mozilla.org/mozilla1.7/ mozilla1.7] root.

'''N.B.''' Non-seamonkey roots are only updated daily and might be out-of-date if there were lots of checkins since the last update.

==pushloghtml and Bonsai==
Before Mercurial, Mozilla had sophisticated, interconnected tree-management tools known as [http://www.mozilla.org/bonsai.html Bonsai].

Bonsai offered a way to [http://www-archive.mozilla.org/events/lugod/4c_bonsai.html query for checkins (by file, author, or time), show the code changes in a checkin, show what checkins touched a file, and figure out who or what was responsible for a given line of code]. Bonsai also integrated with Tinderbox to show what checkins were present in a given build and integrated with MXR to allow MXR to show blame and historical versions of source code files. An example Bonsai query is http://bonsai.mozilla.org/cvsquery.cgi?treeid=default&module=Camino&sortby=Date&hours=2&date=day (cvs trunk checkins to most, but not all, code that Camino pulls).

CVS log (checkins that touched a file), CVS blame (who or what was responsible for a given line of code), and CVS graph (a visual representation of CVS log, across all CVS branches where a file existed) were generally accessed via MXR. For example, see the links in the box on the inside upper right of [http://mxr.mozilla.org/mozilla/source/camino/src/application/main.m main.m]’s MXR page.

CVS query was usually accessed via checkin and guilty links on Tinderbox, or via the query page, but it could also be accessed via MXR, as illustrated by the links in the box on the inside upper right of [http://mxr.mozilla.org/mozilla/source/camino/src/application/main.m main.m]’s MXR page.

Bonsai’s replacement for Mercurial repositories is a series of tools from multiple systems, held together with baling wire.

* To see which checkins occurred between a given time, use [http://hg.mozilla.org/camino/pushloghtml pushloghtml] (and the corresponding pushloghtml for the appropriate Gecko repository). If you’re regression-hunting and have the changesets of two builds, pushloghtml has a hidden changeset mode you can access by using URLs like http://hg.mozilla.org/camino/pushloghtml?fromchange=tip&tochange=tip. pushloghtml is a Mozilla-specific Hg customization.

* To see which checkins touched a particular file (log), use hgweb’s “revisions” link (or “HG Log” from MXR): http://hg.mozilla.org/camino/log/tip/src/application/main.m

* To see which checkin was responsible for a particular line of code (blame), use hgweb’s “annotate” link (or “HG Blame” from MXR): http://hg.mozilla.org/camino/annotate/tip/src/application/main.m
*: Note that if the last change on a particular line is not relevant (e.g., whitespace) or not the change you are looking for, you can go back to previous revision of the file (repository) and see the blame for the most recent change before that.

==Tinderbox==
* [http://developer.mozilla.org/en/docs/Tinderbox Tinderbox] (tree status, also for [http://wiki.mozilla.org/Performance:Tinderbox_Tests perf results]) [http://www.mozilla.org/events/lugod/4b_tinderbox.html] [http://www-archive.mozilla.org/tinderbox.html]
** http://tinderbox.mozilla.org/showbuilds.cgi?tree=Camino (see note below)
*** [[IT:Tinderboxen]] provides more detailed configuration information on our tinderboxen
** http://www.ardisson.org/smokey/moz/perf.html?size=50&days=2&avg=1&autoscale=1 provides a quick overview of tinderbox performance tests (and lets us see the status of the perf box, boxset, when he's having mail issues)
* Camino oddities:
**ardissone|away: there's one particularity about the Camino tinderbox
**ardissone|away: because we show all branches on the same page
**ardissone|away: the "Guilty" column and the "C" link on each build
**ardissone|away: are only correct for the trunk
**ardissone|away: if something regresses or busts on 1.8 or 1.8.0, we have to manually compare the times to bonsai

==Crash Reporting==
* Crash Reporting (Breakpad+Socorro and Talkback)
** General documents
*** [http://wiki.mozilla.org/QA/Talkback/Topcrash_Analysis Looking at a report/Filing topcrash bugs] (site navigation is for Talkback but applies broadly to Socorro)
*** [http://wiki.mozilla.org/QA/Topcrashes MoCo Topcrasher tracking]
** [http://wiki.mozilla.org/Breakpad Breakpad+Socorro] (Camino 2.0b3 and newer):
*** http://crash-stats.mozilla.com (search for crashes or stacks)
*** <s>http://crash-stats.mozilla.com/topcrasher/byversion/Camino/2.0b3pre (report: topcrashers by version) [broken]</s>
*** [http://crash-stats.mozilla.com/query/query?do_query=1&product=Camino&version=Camino%3A2.0b3pre&platform=mac&date=&range_value=2&range_unit=weeks&query_search=signature&query_type=exact&query= Query by version] (last 2 weeks, 2.0b3pre)
*** http://crash-stats.mozilla.com/topcrasher/byurl/Camino/2.0b3pre (report: topcrashers by url)
** [http://wiki.mozilla.org/QA:Talkback Talkback] (Camino 1.6):
*** http://talkback-public.mozilla.org/ (search for crashes or stacks)
*** http://talkback-public.mozilla.org/reports/camino/ (reports)

==Assorted Tools==
* http://pastebin.mozilla.org

* [http://colloquy.info/extras/details.php?file=47 Linkzilla] plug-in for Colloquy, which translates <code>bug 377248</code> or <code>bug 377248 comment 28</code> into live links (written by [[User:SteveJacobs|encro]]).

← Older revision		Revision as of 20:57, 9 January 2011
Line 63:		Line 63:

	* [http://colloquy.info/extras/details.php?file=47 Linkzilla] plug-in for Colloquy, which translates <code>bug 377248</code> or <code>bug 377248 comment 28</code> into live links (written by [[User:SteveJacobs\|encro]]).		* [http://colloquy.info/extras/details.php?file=47 Linkzilla] plug-in for Colloquy, which translates <code>bug 377248</code> or <code>bug 377248 comment 28</code> into live links (written by [[User:SteveJacobs\|encro]]).
		+
		+	* [http://pimpmycamino.com/parts/troubleshoot-camino Troubleshoot Camino] makes testing with a fresh profile a click or drop away.

@@ Line 49: / Line 49: @@
 ==Crash Reporting==
-* Crash Reporting (Breakpad+Socorro and Talkback)
+* Crash Reporting (Breakpad+Socorro)
 ** General documents
 *** [http://wiki.mozilla.org/QA/Talkback/Topcrash_Analysis Looking at a report/Filing topcrash bugs] (site navigation is for Talkback but applies broadly to Socorro)
@@ Line 55: / Line 55: @@
 ** [http://wiki.mozilla.org/Breakpad Breakpad+Socorro] (Camino 2.0b3 and newer):
 *** http://crash-stats.mozilla.com (search for crashes or stacks)
-*** <s>http://crash-stats.mozilla.com/topcrasher/byversion/Camino/2.0b3pre (report: topcrashers by version) [broken]</s>
+*** http://crash-stats.mozilla.com/topcrasher/byversion/Camino/2.0.3 (report: topcrashers by version)
-*** [http://crash-stats.mozilla.com/query/query?do_query=1&product=Camino&version=Camino%3A2.0b3pre&platform=mac&date=&range_value=2&range_unit=weeks&query_search=signature&query_type=exact&query= Query by version] (last 2 weeks, 2.0b3pre)
+*** [http://crash-stats.mozilla.com/query/query?do_query=1&product=Camino&version=Camino%3A2.0.3&platform=mac&date=&range_value=2&range_unit=weeks&query_search=signature&query_type=exact&query= Query by version] (last 2 weeks, 2.0.3)
-*** http://crash-stats.mozilla.com/topcrasher/byurl/Camino/2.0b3pre (report: topcrashers by url)
+*** http://crash-stats.mozilla.com/topcrasher/byurl/Camino/2.0.3 (report: topcrashers by url)
 ==Assorted Tools==

Development:Tools - Revision history

Sardisson: /* Assorted Tools */ add TC here

Sardisson: /* Crash Reporting */ deep-six Talkback parts; change links to 2.0.3

Sardisson: move Development#Tools section to its own page