1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

http://fbug.googlecode.com/svn/branches/
eval -- release source (no tracing)
firebug1.1 -- stable source with tracing
firebug1.2 -- feature-add source with tracing
explore -- abandoned
performance -- tests comparing versions and features
-----
Building:

 Each branch has a build.xml for ant.
 Each branch has branch.properties giving the branch version number

ant build.xml files use local.properties file that you must create.

 ant
   builds distribution

 ant dev-setup
   expands install.rdf, and creates links for direct loading of source into firefox

 ant unexplore
   Builds by copy to the branch to branches/eval and removes any line with /*@explore*/,
   changes the branch.properties to remove X from the release number,
   then builds with ant createBranchXPI.  Result in branch subdir "dist".

-----


Setup for development by reading the source directly into Firefox:

 Source:
   make directory 'firebug'
   Use subversion (svn) to checkout http://fbug.googlecode.com/svn/ firebug
   Remember the full path to this 'firebug' directory.

 Profile:
   Create profile:
      cmdline>firefox.exe -ProfileManager
      CreateProfile eg "firebug1.2", use "Choose Folder" then "Make New Folder" so the name is "firebug1.2"
      Start Firefox
      Exit Firefox
   Go back to your source, eg firebug/branches/firebug1.2
      create local.properties, here's mine, adjust for your paths:
        install.dir=C:/Documents and Settings/John J. Barton/Application Data/Mozilla/Firefox/Profiles/firebug1.2
        update.xpi.path=http://fireclipse.xucia.com/files/fireclipse
        update.rdf.path=http://fireclipse.xucia.com/files/fireclipse

 Links:
   ant dev-setup

 Go:
  Start Firefox.
  Every time you change firebug source, exit Firefox and immediately restart.

Tracing:

  On the development branches tracing output can be sent to the OS console (via window.dump()). Some ways
  this can work:
    -- linux, run firefox from command line
    -- win32, run firefox from Windows->Start->Run->cmd prompt
    -- Run from eclipse external tool.
    -- in about:config or in your profile directory user.js set browser.dom.window.dump.enabled
 Tracing is controlled in FBTrace->Options