gecko-dev/testing/release/minotaur
..
README.txt
checkBookmarks.py
checkReleaseChannel.py
diffBookmarks.py
getOsInfo.py
logAppender.py
minotaur.sh
minotaur.xul
quit.js
quit.xul
sb.js
tests.manifest
user.js

README.txt

 == Steps to Install Minotaur ==
 1. Drop all the Minotaur files into a directory - this is the MINOTAUR_DIR folder
 2. Change the tests.manifest file to also point to this directory
    DO NOT FORGET TRAILING SLASH!!:
    Windows: content minotaur file:///c:/code/minotaur/
    Mac/Linux: content minotaur file:///Users/clint/code/Minotaur/workspace/
 3. Run Minotaur - run it without commands to get a usage statement
 4. Run Minotaur - results will be in <buildname>-<locale> directory in the
    MINOTAUR_DIR folder

 == To get verification files for a first run of a build ==
 1. Run Minotaur without the "verification" args, this means without -b -o and
    -c options
 2. The output.xml and bookmarks.html will be placed in <buildname>-<locale>
    directory in the MINOTAUR_DIR folder
 3. View the http.log that was generated (or partner specs) and create a
    release.txt file where the first (and only) line is the release channel name
 4. Edit these files if needed, and copy them to a verification directory.
 5. Run Minotaur again with using these as your verification files for the
    -b -o and -c options
 6. Submit those files for review and check-in so that future runs will use
    those files to diff against.

== Known Issues and Troubleshooting ==
* On Windows, there is no Http Debug Log: Depending on which bash shell you
  use on Windows, the settings to turn on HTTP Debug logging may not be
  properly exported. If this is the case, you will need to export those two
  variables by hand.  The variables are:
  export NSPR_LOG_MODULES=nsHttp:5,nsSocketTransport:5,nsHostResolver:5
  export NSPR_LOG_FILE=c:/tmp/http.log

* No Firefox windows appear when I run Minotaur, and the Firefox process (may)
  hang out in the system process list after the test finishes:  If you see this
  then Firefox is trying to tell you that your tests.manifest file is messed up.
  Either it has the wrong path, or you forgot the trailing slash.