I have installed this new version three times.  Using your faq.html was more straightforward.  When I tried it by hand, I failed.  I have taken the liberty to edit a copy of org-annotation-helper.el in my git repository of org-mode.  I have tried to clarify the explanation of how to get this tool running.  When I figure out how to make a patch, I will attempt that.  Meanwhile, the explanation for Firefox 3 can use some clarifcation, as follows:

;; Step 3: Browser set-up - add the protocol handlers for the
;;                          "remember://" and "annotation://" URIs.
;;
;;  [Firefox]
;;
;;  To add a protocol handler (eg: remember://) in Firefox, take the
;;  following steps:
;;
;;  * For Firefox 2 and 3, type "about:config" in the location bar. 
;;
;;    [What happens in Firefox 2?]
;;
;;  * In firefox 3, you will will receive a warning: you will have to
;;    click on "I'll be careful, I promise!"  A screen will appear with a
;;    list of
;;   
;;    Right click on the screen anywhere to get the pop-up menu. 
;;    Select New --> String.

;;    A window will appear titled "New String Value". 
;;    You are asked to "Enter the preference name." 
;;    In the field enter "network.protocol-handler.app.remember".
;;    The window appears again, with a title "Enter String Value." 
;;    A text message says "network.protocol-handler.app.remember" with a
;;    blue diamond to the left with a "?" (question mark).
;;    Enter as the value, the name of the shell script.  In GNU/Linux is
;;    unnecessary to include the path.
;;  
;;  * Lather, rinse, repeat for the annotation protocol. The string to
;;    add is, in this case, "network.protocol-handler.app.annotation",
;;    The value will be the same  script name as above, "org-annotation-helper".
;;
;;      [I am uncertain what the next means.  Does this mean you HAVE TO
;;       use a file selection protocol to navigate to the script?  Does it
;;       mean that you can OPTIONALLY edit the about:config list, or that this is
;;       the appropriate next action?]
;;  
;;   | In Firefox 3, when you first click on the button associated with
;;   | the bookmarklet, you should get a pop-up asking if you'd like to
;;   | associate the bookmarklet with a particular file. Use the
;;   | file-select process to navigate to the org-annotation-helper
;;   | script and select it.  You can still edit the about:config
;;   | list directly as in Firefox 2.
;;
;;  * the value should be the name of the file containing the shell
;;    script, e.g. in Step 1, we called it "org-annotation-helper".
;;    At least under Linux this does not need to be the full path to
;;    the script.
;;
;;
;;  You should have two new entries like this:
;; 
;;   network.protocol-handler.app.annotation user set string <path>
;;   network.protocol-handler.app.remember   user set string <path>
;;
;;   where <path> is the location where org-annotation-helper is
;;   for example, in my case it is /home/dmg/bin/org-annotation-helper

;;  See http://kb.mozillazine.org/Register_protocol for more details.
;;

I don't know the procedure for Firefox 2, but perhaps they should be clearly differentiated, or not at all.  I, at least, need the extra clarification, as I stumbled over the instructions every time I have installed org-annotation-helper, version 0.3 and version 0.4. 

The package you provided as an attachment to the list is far easier to install, and less problematical.  I suggest, once again, that in contrib, this entire package would best be included under packages.


Thank you for this package.  It works.

Alan


--
Alan Davis

"An inviscid theory of flow renders the screw useless, but the need for one non-existent."                     ---Lord Raleigh (John William Strutt), or else his son, who was also a scientist.

It is undesirable to believe a proposition when
there is no ground whatsoever for supposing it is true.
    ---- Bertrand Russell