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