From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: [PATCH] Update documentation on org-protocol template
 placeholders
Date: Tue, 17 Oct 2017 10:01:26 +0200
Message-ID: <87376iyzhl.fsf@nicolasgoaziou.fr>
References: <CAJr1M6ePD5ZMxy4ADd34gg64fiX7=Wsgq=4i+6kRWtmyVEPrsw@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54271)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1e4Mof-0002cn-Sj
	for emacs-orgmode@gnu.org; Tue, 17 Oct 2017 04:01:37 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1e4Moc-0006X5-Nl
	for emacs-orgmode@gnu.org; Tue, 17 Oct 2017 04:01:33 -0400
Received: from relay2-d.mail.gandi.net ([217.70.183.194]:56909)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1e4Moc-0006WW-ID
	for emacs-orgmode@gnu.org; Tue, 17 Oct 2017 04:01:30 -0400
In-Reply-To: <CAJr1M6ePD5ZMxy4ADd34gg64fiX7=Wsgq=4i+6kRWtmyVEPrsw@mail.gmail.com>
	(Allen Li's message of "Sun, 15 Oct 2017 15:55:37 -0700")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Allen Li <vianchielfaura@gmail.com>
Cc: emacs-orgmode@gnu.org, Carl Bolduc <cbol@me.com>, Kaushal Modi <kaushal.modi@gmail.com>

Hello,

Allen Li <vianchielfaura@gmail.com> writes:

> * doc/org.texi (@code{capture} protocol): Fix placeholder names
> (Template expansion): Add org-protocol placeholders
>
> * lisp/org.el (org-store-link-plist): Fix docstring grammar
> (org-store-link-props): Fix docstring grammar

Thank you.

> +The following template placeholders are available:
> +
> +@example
> +%:link          The URL
> +%:description   The webpage title
> +%:annotation    Equivalent to [[%:link][%:description]]
> +%i              The selected text
> +@end example

This is not directly related to your patch, but isn't something wrong
here? 

I.e., shouldn't Org Protocol be able to capture arbitrary keywords
according to the attributes of the "org-protocol" link? What is the
point of using

  ?url=...&title=...&body=...

if you cannot access directly to :url, :title and :body from the capture
template thereafter?

Disclaimer: I'm not using Org Protocol at all so I may be missing
something.

Regards,

-- 
Nicolas Goaziou