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
_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
address@hidden
http://lists.gnu.org/mailman/listinfo/emacs-orgmode