From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: Re: Citation syntax: Underscore MUST(?) be allowed in cite keys? Date: Sun, 08 Mar 2015 07:07:07 -1000 Message-ID: References: <874mq0399a.fsf@gmx.us> <54F75222.8030805@gmail.com> <87pp8o1t9f.fsf@gmx.us> <87pp8o6nt9.fsf@berkeley.edu> <87fv9i9z8s.fsf@nicolasgoaziou.fr> <87bnk60zhc.fsf@berkeley.edu> <54FA9AA9.9070505@gmail.com> <87r3t05okc.fsf@nicolasgoaziou.fr> <87ioeci6f6.fsf@gmx.us> <87r3szk6q9.fsf@gmx.us> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:33610) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YUefn-00028h-Ui for emacs-orgmode@gnu.org; Sun, 08 Mar 2015 13:07:29 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YUefk-0004sI-II for emacs-orgmode@gnu.org; Sun, 08 Mar 2015 13:07:27 -0400 Received: from gproxy10-pub.mail.unifiedlayer.com ([69.89.20.226]:47379) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1YUefk-0004ru-BW for emacs-orgmode@gnu.org; Sun, 08 Mar 2015 13:07:24 -0400 In-Reply-To: <87r3szk6q9.fsf@gmx.us> (rasmus@gmx.us's message of "Sun, 08 Mar 2015 13:34:54 +0100") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Rasmus Cc: emacs-orgmode@gnu.org Aloha Rasmus, Rasmus writes: > tsd@tsdye.com (Thomas S. Dye) writes: > >> Rasmus writes: >> >>> Nicolas Goaziou writes: >>> >>>>> I'm asking because I haven't fully grasped uses for the shorthand. W= hat >>>>> is the use case? >>>> >>>> More readable, I guess. >>> >>> I agree. In time, "org-reftex" would insert @key if no notes are >>> requested at the time of insertion. >> >> I think the OP has a valid point. After we teach org-reftex to insert >> @key if no notes are requested, are we going to convince all key >> generating software to prohibit keys that end in punctuation? > > So just to get it straight: are you advocating for only allowing > [cite:@key]-like constructs to allow punctuation at the end of words? > > Perhaps it's a can of worms, but you can also match keys against a > "punctuation at end of word"-regexp and use the fuller cite command then. > I'm not too happy with having the regexps used in [cite:@=C2=B7] and @=C2= =B7 diverge > too much, though... > > So /given support for end-of-word punctuation/, we'd either have two > abandon a "single" org-element--citation-key-re (yes that's not entirely > correct) or give up short citations. > >> As I currently understand the problem, that seems like a tall order to >> me. > > It's also a tall order to support end of word punctuation cf. above. > > I think another important question is how easy is it to configure the > citation manager in question not to insert punctuation marks at the end? I'm not an advocate at this point. I'm just trying to be clear about a choice that apparently needs to be made. As I see it, the choice boils down to the relative benefit of citation shortcuts vs. the limitation of requiring authors to configure the citation manager so it doesn't produce a key ending in punctuation (or your solution that uses different regexps for full citations and shortcuts). Nicolas guessed that the benefit of citation shortcuts is that they are more "readable" than a full citation, and you agree with his guess. The shortcuts are certainly shorter, so in this sense are more readable. However, having two different representations of the same thing, a shortcut and a full citation, means that, for the author (and the software) recognition is more complex and thus, less readable. For this reason, IMHO the readability benefit is not particularly strong. Richard and Stefan both see keys ending in punctuation marks as corner cases, so the burden imposed on the author to configure the citation manager is relatively infrequent. They know more about this than I do, so I'm heartened by this information. However, in the event the citation manager has to be configured, the author faces a potentially daunting task. The algorithm for automatic key generation in bibtex-mode is summarized in 18 steps, including two near the end that allow arbitrary input! I strongly believe Org mode shouldn't send an author here, unless the corresponding benefits are great. I'm not capable of forming an opinion about your solution that uses different regexps. At this point I think the benefit of citation shortcuts is relatively modest and the limitation of requiring authors to ensure keys don't end in punctuation potentially onerous. On balance, I think strong consideration should be given to the option of not using shortcuts. All the best, Tom --=20 Thomas S. Dye http://www.tsdye.com