Marmelator/pdf.js
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Updated Bisecting a Regression (markdown)

Brendan Dahl 2013-08-29 11:28:03 -07:00
parent fa6fe45eaa
commit aa2b78e952
1 changed files with 18 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
Bisecting-a-Regression.md

@ -1,13 +1,15 @@
# Bisecting a Regression # Bisecting a Regression
## At a minimum you'll need: ## 1) At a minimum you'll need:
-git (on windows http://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git) - 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 - a server, if you have python installed that will work
## Getting pdf.js ## 2) Getting pdf.js
-startup the git command line from above - 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 - 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` - `git clone https://github.com/mozilla/pdf.js.git`
## 3) Open pdf.js
### Option 1 - Python Server ### Option 1 - Python Server
- `cd pdf.js/test` - `cd pdf.js/test`
@ -15,16 +17,16 @@
- open firefox and check http://localhost:8080/web/viewer.html goes to the pdf viewer - open firefox and check http://localhost:8080/web/viewer.html goes to the pdf viewer
### Option 2 - Other Server ### Option 2 - Other Server
- go to http://<yourserver>/pdf.js/web/viewer.html - go to `http://<yourserver>/pdf.js/web/viewer.html`
## Verify the Regression ## 4) Verify the Regression
- Download Bad PDF and save it in pdf.js/test/pdfs - Download the bad PDF and save it in pdf.js/test/pdfs
- go to <url from above>?file=../test/pdfs/<name of pdf> and verify the PDF works - go to `<url from above>?file=../test/pdfs/<name of pdf>` and verify the PDF is broken
## Start the bisecting process ## 5) Start the bisecting process
- Mark the current version is bad using `git bisect start` and `git bisect bad` - 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 ### Option 1 - Detecting version / commit of the pdf.js installed in the Firefox
- Open resource://pdf.js/build/pdf.js - 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 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 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 <commit id that you found above>` - `git checkout <commit id that you found above>`
- Full refresh(ctr+shift+r) Firefox and verify the PDF no longer works. - Full refresh(ctr+shift+r) Firefox and verify the PDF no longer works.
- Mark it as good `git bisect good` - Mark it as good `git bisect good`
## Continue bisecting ## 8) Continue bisecting
- Full refresh(ctr+shift+r) of the viewer in Firefox - Full refresh(ctr+shift+r) of the viewer in Firefox
- If the current version works `git bisect good` - If the current version works `git bisect good`
- If it fails `git bisect bad` - If it fails `git bisect bad`