You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: DEBUGGING.md
+10-6
Original file line number
Diff line number
Diff line change
@@ -3,13 +3,13 @@
3
3
4
4
Thank you for considering helping me debug a problem with [It's All Text!](http://github.com/docwhat/itsalltext).
5
5
6
-
This document will help you set up debugging and then remove it once you're done. You'll probably want to remove some of these debugging methods when you finish because it slows down Firefox. Unless you debug regularly (you're a web or extension developer) you probably don't need these tools day-to-day.
6
+
This document will help you set up debugging and then remove it once you're done. You'll probably want to undo some of the debugging when you finish because it slows down Firefox. Unless you debug regularly (you're a web or extension developer) you probably don't need these tools day-to-day.
7
7
8
8
## Preparation
9
9
10
10
You may want to save a copy of this document to disk or open it in a different browser so you can read it while you're restarting and debugging Firefox.
11
11
12
-
You'll also want at text editor or an open email to collect any interesting information.
12
+
You'll also want a text editor or a new open email to collect any interesting information.
13
13
14
14
### Setting up a new profile (optional)
15
15
@@ -19,12 +19,12 @@ There are several advantages to setting up a new profile for debugging IAT:
19
19
20
20
1. You won't change your normal settings.
21
21
2. Cleanup is easy, just switch profiles back to your normal profile.
22
-
3. It makes debugging problems caused by extensions interacting with IAT.
22
+
3. It makes debugging problems caused by extensions interacting with IAT possible without destroying your day-to-day profile.
23
23
4. You start with default settings for your platform.
24
24
25
25
If this sounds good to you, then go read the [managing profiles article](http://support.mozilla.com/en-US/kb/Managing-profiles) in the Mozilla knowledge-base.
26
26
27
-
Once you've set up a new debugging profile and are running it by restarting Firefox, then you'll want to go install the version of It's All Text! you'll be debugging. You should have either gotten an `.xpi` file directly from Christian Höltje or you can get any previously released version from [Addons.Mozzilla.Org](https://addons.mozilla.org/en-US/firefox/addon/its-all-text/versions/).
27
+
Once you've set up a new debugging profile and are running it by restarting Firefox and activating that profile you'll want to go install the version of It's All Text! you'll be debugging. You should have either gotten an `.xpi` file directly from Christian Höltje or you can get any previously released version from [Addons.Mozilla.Org](https://addons.mozilla.org/en-US/firefox/addon/its-all-text/versions/).
28
28
29
29
The TL;DR version is to run the following command (for Windows and Linux only, alas):
30
30
@@ -48,13 +48,13 @@ You open the Error Console via <kbd>CTRL</kbd>+<kbd>SHIFT</kdb>+<kbd>J</kbd>.
48
48
49
49
1. Verify that it is set to show "all" errors, messages, etc. Click the "all" tab/button.
50
50
2. Check the Error Console for any errors from It's All Text! during startup. If there are any, then you should copy and paste them into your notes and mark them as start-up errors.
51
-
3. Clear the console. This is to make finding problems easier.
51
+
3. Clear the console. This is to make finding subsequent problems easier.
52
52
53
53
### Debug
54
54
55
55
If you're debugging "normal usage" of IAT, then you can go to [http://docwhat.org/files/iat] and walk through those tests one by one.
56
56
57
-
After each step check your Error Console and see if any errors from IAT have appeared. Make note of any that do appear. It's okay to record too much, we can clean up the info later.
57
+
After each step check your Error Console and see if any errors from IAT have appeared and make a note of them. It's okay to record too much, we can clean up the info later.
58
58
59
59
You may want to clear the Error Console regularly to make finding new messages easier.
60
60
@@ -155,6 +155,10 @@ If you're proficient enough to do this, I won't need to explain too much to you.
155
155
156
156
You'll also want to install [Venkman](https://developer.mozilla.org/en/Venkman), even if you use Firebug to do JS debugging.
157
157
158
+
Since you are knowledgable enough to be using a debugger, I assume you'll figure out how to continue from here.
159
+
160
+
The latest source (and tagged releases) are all on [github](http://github.com/docwhat/itsalltext).
161
+
158
162
## Getting Help
159
163
160
164
You can contact me via [email](http://docwhat.org/email/) or via IM or IRC. See [my homepage](http://docwhat.org/) for my "Alter Egos" (in the sidebar) to find a way to talk to me directly.
0 commit comments