[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [O] Bug: :noexport: tag prevents table functionin g as babel code bl

From: András Major
Subject: Re: [O] Bug: :noexport: tag prevents table functionin g as babel code block input [7.7 (release_ 7.7.167.gfceb)]
Date: Tue, 23 Aug 2011 22:44:01 +0000 (UTC)
User-agent: Loom/3.14 (http://gmane.org/)

Hi Bastien,

> > I think that anything that works despite being designed and documented
> > otherwise is confusing to the user and should be considered a bug.
> > I'm happy that it no longer works and hope that it stays that way.
> I think tags are clearly documented as being properties of the
> headlines -- if there is places in the manual that we can improve 
> in this respect, please suggest a patch.

I'm not talking about the manual.  In my opinion, if there is a
function that works only on headlines according to the manual, then it
*must not* work in any other place.  Otherwise some users might try
the function they once heard of in a sense not specified in the
documentation (here: in a table) and see that it works, and be
surprised when it no longer does (in a future version of org-mode, or
on a different computer).  Therefore such "ghost features" must
actively be eliminated.

To me, the documentation is the leading specification of a piece of
software.  Anything the software doesn't do that is in the docs is a
bug, but likewise anything it does do which the docs don't cover is
also a bug.

> I don't think it's reasonable to document the fact that tags are
> not meant to be used in tables, blocks, lists, timestamps, etc.

I fully agree.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]