emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Tom Alexander" <tom@fizz.buzz>
To: emacs-orgmode@gnu.org
Subject: Documentation: Equal sign incorrectly listed as disallowed in plain links
Date: Fri, 21 Jul 2023 20:51:01 -0400	[thread overview]
Message-ID: <a442913f-49ab-4903-9063-4e4daf3f34ea@app.fastmail.com> (raw)

The documentation for plain links states that PATHPLAIN is:

> A string containing non-whitespace non-bracket (()[]<>=) characters, optionally containing parenthesis-wrapped non-whitespace non-bracket substrings up to a depth of two. The string must end with either a non-punctation non-whitespace character, a forwards slash, or a parenthesis-wrapped substring.

but if we create an org-mode document with the following test content:
```
http://foo/bar=baz

http://foo/bar[baz
```

and run a M-x eval-expression (message "%s" (pp-to-string (org-element-parse-buffer)))

Then we can see that it allows the equals sign in the PATHPLAIN (output pasted below)

Link to the documentation: https://orgmode.org/worg/org-syntax.html#org6934900

Syntax tree:
```
(org-data
(:begin 1 :contents-begin 1 :contents-end 40 :end 40 :robust-begin 3 :robust-end 38 :post-blank 0 :post-affiliated 1 :path "/tmp/test/test.org" :mode org-data :CATEGORY "test" :granularity nil)
(section
  (:begin 1 :end 40 :contents-begin 1 :contents-end 40 :robust-begin 1 :robust-end 38 :post-blank 0 :post-affiliated 1 :mode first-section :granularity nil :parent #0)
  (paragraph
   (:begin 1 :end 21 :contents-begin 1 :contents-end 20 :post-blank 1 :post-affiliated 1 :mode top-comment :granularity nil :parent #1)
   (link
    (:type "http" :path "//foo/bar=baz" :format plain :raw-link "http://foo/bar=baz" :application nil :search-option nil :begin 1 :end 19 :contents-begin nil :contents-end nil :post-blank 0 :parent #2))
   #("\n" 0 1
     (:parent #2)))
  (paragraph
   (:begin 21 :end 40 :contents-begin 21 :contents-end 40 :post-blank 0 :post-affiliated 21 :mode nil :granularity nil :parent #1)
   (link
    (:type "http" :path "//foo/bar" :format plain :raw-link "http://foo/bar" :application nil :search-option nil :begin 21 :end 35 :contents-begin nil :contents-end nil :post-blank 0 :parent #2))
   #("[baz\n" 0 5
     (:parent #2)))))
```



             reply	other threads:[~2023-07-22  0:57 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-07-22  0:51 Tom Alexander [this message]
2023-07-22  6:58 ` Documentation: Equal sign incorrectly listed as disallowed in plain links Ihor Radchenko
2023-07-22  7:22   ` Tom Alexander

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=a442913f-49ab-4903-9063-4e4daf3f34ea@app.fastmail.com \
    --to=tom@fizz.buzz \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).