From mboxrd@z Thu Jan  1 00:00:00 1970
From: Suvayu Ali <fatkasuvayu+linux@gmail.com>
Subject: Re: variable names in manual
Date: Fri, 26 Apr 2013 10:41:03 +0200
Message-ID: <20130426084103.GD2769@kuru.dyndns-at-home.com>
References: <94889.1366933045@greg-minshalls-mbp.local>
	<20130425234809.GC12340@kuru.dyndns-at-home.com>
	<FC50E84E-6D2C-42BF-96E0-983DF00841EE@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([208.118.235.92]:60054)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <fatkasuvayu+linux@gmail.com>) id 1UVeDP-0003Xi-2g
	for emacs-orgmode@gnu.org; Fri, 26 Apr 2013 04:41:13 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <fatkasuvayu+linux@gmail.com>) id 1UVeDM-0006et-1O
	for emacs-orgmode@gnu.org; Fri, 26 Apr 2013 04:41:11 -0400
Received: from mail-wg0-x22b.google.com ([2a00:1450:400c:c00::22b]:37629)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <fatkasuvayu+linux@gmail.com>) id 1UVeDL-0006ek-RB
	for emacs-orgmode@gnu.org; Fri, 26 Apr 2013 04:41:07 -0400
Received: by mail-wg0-f43.google.com with SMTP id c11so2003291wgh.22
	for <emacs-orgmode@gnu.org>; Fri, 26 Apr 2013 01:41:06 -0700 (PDT)
Content-Disposition: inline
In-Reply-To: <FC50E84E-6D2C-42BF-96E0-983DF00841EE@gmail.com>
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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Carsten Dominik <carsten.dominik@gmail.com>
Cc: emacs-orgmode@gnu.org

Hi Carsten,

On Fri, Apr 26, 2013 at 10:10:32AM +0200, Carsten Dominik wrote:
> 
> I suspect that the cases you are talking about here are due
> to incorrect use of the texinfo command @var{}.  This should
> only be used for metasyntactical variables, when they stand
> for something else in a description. 
> 
> Here is an example from the current manual.
> 
>   You can customize this behavior using the option
>   @var{org-table-use-standard-references}.} to use another, more general
>   representation that looks like this:
>   @example
>   @@@var{row}$@var{column}
>   @end example
> 
> The first use of @var is incorrect, @code should be used here.  But
> the use in @var{row} and @var{column} is correct.
> 
> I believe that a while ago we did use @var and @code correctly, but
> someone went through and changed the @code{org-...} to @var{org-...}
> at some point.  We need to change this back.

I believe reverting this commit should do it:

  commit 7ed97e767dd4f4fbceac39a9758dbf594a4fd2fd
  Author: Bastien Guerry <bzg@altern.org>
  Date:   Mon Apr 15 00:51:20 2013 +0200
  
      org.texi: Use @var{...} instead of @code{...} for variables
      
      * org.texi: Use @var{...} instead of @code{...} for variables.}}}}

Cheers,

-- 
Suvayu

Open source is the future. It sets us free.