From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: Re: Bug: :noexport: tag prevents table functioning as babel code block input [7.7 (release_7.7.167.gfceb)] Date: Tue, 23 Aug 2011 13:38:12 -1000 Message-ID: References: <87pqjwfb0b.fsf@gmail.com> <87bovgf7tc.fsf@gmail.com> <87sjosxft3.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([140.186.70.92]:43967) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qw0Y1-0005yl-BV for emacs-orgmode@gnu.org; Tue, 23 Aug 2011 19:38:22 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qw0Y0-0006j2-97 for emacs-orgmode@gnu.org; Tue, 23 Aug 2011 19:38:21 -0400 Received: from oproxy1-pub.bluehost.com ([66.147.249.253]:46467) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1Qw0Xz-0006in-Vp for emacs-orgmode@gnu.org; Tue, 23 Aug 2011 19:38:20 -0400 In-Reply-To: (=?utf-8?Q?=22Andr?= =?utf-8?Q?=C3=A1s?= Major"'s message of "Tue, 23 Aug 2011 22:44:01 +0000 (UTC)") 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: =?utf-8?Q?Andr=C3=A1s?= Major Cc: emacs-orgmode@gnu.org Andr=C3=A1s Major writes: > 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. >>=20 >> I think tags are clearly documented as being properties of the >> headlines -- if there is places in the manual that we can improve=20 >> 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. Aloha Andras, As an avocational programmer who has had the pleasure of making small changes to the Org-mode manual and on-line documentation, this last bit seems to raise the bar impractically high. Part of Org-mode's appeal to me is that people frequently find new, and at least to me unexpected, ways to use it productively. I find it interesting to see how best to change the documentation to incorporate the new "discovery." That said, the idea that the docs cover *everything* that Org-mode is capable of doing is wonderful and I'll be happy to chip in when I can to help you achieve that goal. All the best, Tom > >> 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. > > Andr=C3=A1s > > > > --=20 Thomas S. Dye http://www.tsdye.com