1 files changed, 31 insertions, 0 deletions
diff --git a/devtools/shared/acorn/UPGRADING.md b/devtools/shared/acorn/UPGRADING.md
new file mode 100644
index 000000000..f744ece7f
--- /dev/null
+++ b/devtools/shared/acorn/UPGRADING.md
@@ -0,0 +1,31 @@
+Assuming that acorn's dependencies have not changed, to upgrade our tree's
+acorn to a new version:
+
+1. Clone the acorn repository, and check out the version you want to upgrade
+to:
+
+       $ git clone https://github.com/marijnh/acorn.git
+       $ cd acorn
+       $ git checkout <version>
+
+2. Make sure that all tests pass:
+
+       $ npm install .
+       $ npm test
+
+   If there are any test failures, do not upgrade to that version of acorn!
+
+3. Copy acorn.js to our tree:
+
+       $ cp acorn.js /path/to/mozilla-central/devtools/shared/acorn/acorn.js
+
+4. Copy acorn_loose.js to our tree:
+
+       $ cp acorn_loose.js /path/to/mozilla-central/devtools/shared/acorn/acorn_loose.js
+
+5. Copy util/walk.js to our tree:
+
+       $ cp util/walk.js /path/to/mozilla-central/devtools/shared/acorn/walk.js
+
+6. Check and see if javascript pretty-printing and scratchpad work without any errors.  As of version 2.6.4 we need to comment out lines in acorn_loose.js that attempt to extend the acorn object, like `acorn.parse_dammit = parse_dammit`.
+