diff --git a/Bisecting-a-Regression.md b/Bisecting-a-Regression.md index 0da812e..83f424e 100644 --- a/Bisecting-a-Regression.md +++ b/Bisecting-a-Regression.md @@ -1,13 +1,15 @@ # Bisecting a Regression -## At a minimum you'll need: --git (on windows http://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git) --a server, if you have python installed that will work +## 1) At a minimum you'll need: +- git (on windows http://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git) +- a server, if you have python installed that will work -## Getting pdf.js --startup the git command line from above --move a directory where you want it to live, if you're using a server that isn't python go into the directory where your wwwroot is --`git clone https://github.com/mozilla/pdf.js.git` +## 2) Getting pdf.js +- startup the git command line from above +- move a directory where you want it to live, if you're using a server that isn't python go into the directory where your wwwroot is +- `git clone https://github.com/mozilla/pdf.js.git` + +## 3) Open pdf.js ### Option 1 - Python Server - `cd pdf.js/test` @@ -15,16 +17,16 @@ - open firefox and check http://localhost:8080/web/viewer.html goes to the pdf viewer ### Option 2 - Other Server -- go to http:///pdf.js/web/viewer.html +- go to `http:///pdf.js/web/viewer.html` -## Verify the Regression -- Download Bad PDF and save it in pdf.js/test/pdfs -- go to ?file=../test/pdfs/ and verify the PDF works +## 4) Verify the Regression +- Download the bad PDF and save it in pdf.js/test/pdfs +- go to `?file=../test/pdfs/` and verify the PDF is broken -## Start the bisecting process -- Mark the current version is bad using `git bisect start` and `git bisect bad` +## 5) Start the bisecting process +- Mark the current version as bad using `git bisect start` and `git bisect bad` -## Now find bad commit id +## 6) Find bad commit id ### Option 1 - Detecting version / commit of the pdf.js installed in the Firefox - Open resource://pdf.js/build/pdf.js @@ -42,12 +44,12 @@ Find the line with 'PDFJS.build = ' and copy the value in the single quotes e.g. auora - http://mxr.mozilla.org/mozilla-aurora/source/browser/extensions/pdfjs/content/build/pdf.js#24 beta - http://mxr.mozilla.org/mozilla-beta/source/browser/extensions/pdfjs/content/build/pdf.js#24 -## Verify the Working Version +## 7) Verify the Working Version - `git checkout ` - Full refresh(ctr+shift+r) Firefox and verify the PDF no longer works. - Mark it as good `git bisect good` -## Continue bisecting +## 8) Continue bisecting - Full refresh(ctr+shift+r) of the viewer in Firefox - If the current version works `git bisect good` - If it fails `git bisect bad`