Re: org link to OCaml comment
On 2020-02-19 18:49, Nicolas Goaziou writes: > Alan Schmitt writes: > >> I understand, and I can be careful (and easily fix the link if needed). >> If `org-store-link' could do it for me, that would be perfect. > > I pushed some changes to `org-store-link' in order to fix this. Please > report if there is anything wrong. Thanks a lot! Best, Alan
Re: org link to OCaml comment
Hello, Alan Schmitt writes: > I understand, and I can be careful (and easily fix the link if needed). > If `org-store-link' could do it for me, that would be perfect. I pushed some changes to `org-store-link' in order to fix this. Please report if there is anything wrong. Regards, -- Nicolas Goaziou
Re: org link to OCaml comment
On 2020-02-07 15:33, Nicolas Goaziou writes: > *shivers* Please never suggest again url-encoding links in Org! ;) We > only got out of this hell recently. I don't want to dive in again. Sorry, I should have put a smiley there. > There is some specific syntax in links. More specifically, the > following are meaningful: > > - a star at the beginning of the link (or search option) > - a hash at the beginning of the link > - forward slashes around the link > - parenthesis around the link > > I think that `org-store-link' should be careful about it and prevent > these pathological cases if necessary. > > In any other situation, however, I think the user is responsible for > not using these specific constructs. > > WDYT? I understand, and I can be careful (and easily fix the link if needed). If `org-store-link' could do it for me, that would be perfect. Thanks again for the explanation. Best, Alan
Re: org link to OCaml comment
Hello, Alan Schmitt writes: > Thank you for the explanation. Is there a way to either escape the > parentheses (maybe url-encode them), *shivers* Please never suggest again url-encoding links in Org! ;) We only got out of this hell recently. I don't want to dive in again. > or to automatically not include the closing one as you suggest when > creating the link? There is some specific syntax in links. More specifically, the following are meaningful: - a star at the beginning of the link (or search option) - a hash at the beginning of the link - forward slashes around the link - parenthesis around the link I think that `org-store-link' should be careful about it and prevent these pathological cases if necessary. In any other situation, however, I think the user is responsible for not using these specific constructs. WDYT? Regards, -- Nicolas Goaziou
Re: org link to OCaml comment
Hello Nicolas, On 2020-02-06 18:10, Nicolas Goaziou writes: > Link enclosed within parens meant coderef links, i.e., the syntax is > reserved. You can probably remove the closing parenthesis to avoid this. Thank you for the explanation. Is there a way to either escape the parentheses (maybe url-encode them), or to automatically not include the closing one as you suggest when creating the link? (I'm asking someone who does not know org-mode to document his code, use links to point to the relevant code. I'm afraid it will be tricky to ask him to tweak the links that org create so that they work.) Thanks again, Alan
Re: org link to OCaml comment
Hello, Alan Schmitt writes: > The strange part is that linking to arbitrary code works. It seems that > the OCaml comment syntax is problematic here. Link enclosed within parens meant coderef links, i.e., the syntax is reserved. You can probably remove the closing parenthesis to avoid this. Regards, -- Nicolas Goaziou
Re: org link to OCaml comment
Hello John, On 2020-02-06 09:58, John Kitchin writes: > I think you need to do it like this: > > #+BEGIN_SRC test.ml -r > > (* Object projection functions *) (ref:opf) > > > #+END_SRC > > [[file:2020-02-05.org::(opf)]] > > The -r in the header removes the coderef when you run it. Thank you for the suggestion. Unfortunately I need to link to an external ml file. I can change it, but I need to get a syntactically valid file. I tried putting the ref part inside the comment and unfortunately it does not work. The strange part is that linking to arbitrary code works. It seems that the OCaml comment syntax is problematic here. Best, Alan
Re: org link to OCaml comment
I think you need to do it like this: #+BEGIN_SRC test.ml -r (* Object projection functions *) (ref:opf) #+END_SRC [[file:2020-02-05.org::(opf)]] The -r in the header removes the coderef when you run it. John --- Professor John Kitchin Doherty Hall A207F Department of Chemical Engineering Carnegie Mellon University Pittsburgh, PA 15213 412-268-7803 @johnkitchin http://kitchingroup.cheme.cmu.edu On Thu, Feb 6, 2020 at 9:48 AM Alan Schmitt wrote: > Hello, > > I'm trying to create an org link to a specific place in an OCaml file. I > thought I would use some specific target in an OCaml comment, but it > does not work. > > Here is an OCaml comment: > > (* Object projection functions *) > > Here is the link create by `org-store-link` (I put it here with no > description) > > [[file:~/work/jsexplain/jsexplain/jsref/JsSyntax.ml::(* Object projection > functions *)]] > > When I try to follow this link, I get the following error (note the > missing parentheses): > > org-open-file: No match for coderef: * Object projection functions * > > and I am moved to the top of the file (instead of where I stored the > link). > > Is there an escape problem here? And if so, is it a bug of > `org-store-link` of not doing the escaping? > > Thanks, > > Alan > >
org link to OCaml comment
Hello, I'm trying to create an org link to a specific place in an OCaml file. I thought I would use some specific target in an OCaml comment, but it does not work. Here is an OCaml comment: (* Object projection functions *) Here is the link create by `org-store-link` (I put it here with no description) [[file:~/work/jsexplain/jsexplain/jsref/JsSyntax.ml::(* Object projection functions *)]] When I try to follow this link, I get the following error (note the missing parentheses): org-open-file: No match for coderef: * Object projection functions * and I am moved to the top of the file (instead of where I stored the link). Is there an escape problem here? And if so, is it a bug of `org-store-link` of not doing the escaping? Thanks, Alan