From mboxrd@z Thu Jan  1 00:00:00 1970
From: Michael Brand <michael.brand@alumni.ethz.ch>
Subject: doc about Link abbreviations
Date: Tue, 18 May 2010 20:27:54 +0200
Message-ID: <4BF2DC2A.40803@alumni.ethz.ch>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from [140.186.70.92] (port=49543 helo=eggs.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1OERWX-0006hM-TZ
	for emacs-orgmode@gnu.org; Tue, 18 May 2010 14:28:15 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69)
	(envelope-from <michael.brand@alumni.ethz.ch>) id 1OERWW-00039V-Lk
	for emacs-orgmode@gnu.org; Tue, 18 May 2010 14:28:13 -0400
Received: from mail01.solnet.ch ([212.101.4.135]:62170)
	by eggs.gnu.org with esmtp (Exim 4.69)
	(envelope-from <michael.brand@alumni.ethz.ch>) id 1OERWW-00038u-Fw
	for emacs-orgmode@gnu.org; Tue, 18 May 2010 14:28:12 -0400
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/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: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Carsten Dominik <carsten.dominik@gmail.com>
Cc: Org Mode <emacs-orgmode@gnu.org>

Hi Carsten

In the doc about Link abbreviations the limitation for the first linkword 
char is missing which I stumbled upon when I used #+LINK. I suggest to sync 
the doc more with the docstring of the variable org-link-abbrev-alist like this:

----------------------------------------------------------------------------
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -3088,8 +3088,9 @@ abbreviated link looks like this

  @noindent
  @vindex org-link-abbrev-alist
-where the tag is optional.  The @i{linkword} must be a word; letter, numbers,
-@samp{-}, and @samp{_} are allowed here.  Abbreviations are resolved
+where the tag is optional.
+The @i{linkword} must be a word, starting with a letter, followed by
+letters, numbers, @samp{-}, and @samp{_}.  Abbreviations are resolved
  according to the information in the variable @code{org-link-abbrev-alist}
  that relates the linkwords to replacement text.  Here is an example:

----------------------------------------------------------------------------

Michael