From mboxrd@z Thu Jan  1 00:00:00 1970
From: Bastien <bzg@altern.org>
Subject: Re: Bug: :noexport: tag prevents table functioning	as	babel	code
 block input [7.7 (release_7.7.167.gfceb)]
Date: Wed, 24 Aug 2011 10:34:33 +0200
Message-ID: <87fwkrf7ad.fsf@altern.org>
References: <CALPHr6xSA5tjUbS+-y=Z96CeqFesWccJ3EiBNUy_qXWq+H+OTA@mail.gmail.com>
	<87pqjwfb0b.fsf@gmail.com> <loom.20110823T170600-48@post.gmane.org>
	<87bovgf7tc.fsf@gmail.com> <loom.20110823T175634-441@post.gmane.org>
	<87sjosxft3.fsf@gnu.org> <loom.20110824T003644-61@post.gmane.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([140.186.70.92]:34417)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bastienguerry@googlemail.com>) id 1QwAQF-0003Nz-Ju
	for emacs-orgmode@gnu.org; Wed, 24 Aug 2011 06:11:00 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bastienguerry@googlemail.com>) id 1QwAQE-00064q-0E
	for emacs-orgmode@gnu.org; Wed, 24 Aug 2011 06:10:59 -0400
Received: from mail-fx0-f41.google.com ([209.85.161.41]:37883)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bastienguerry@googlemail.com>) id 1QwAQC-00062a-PR
	for emacs-orgmode@gnu.org; Wed, 24 Aug 2011 06:10:57 -0400
Received: by mail-fx0-f41.google.com with SMTP id 9so1029756fxg.0
	for <emacs-orgmode@gnu.org>; Wed, 24 Aug 2011 03:10:56 -0700 (PDT)
In-Reply-To: <loom.20110824T003644-61@post.gmane.org> (=?iso-8859-1?Q?=22A?=
	=?iso-8859-1?Q?ndr=E1s?= Major"'s
	message of "Tue, 23 Aug 2011 22:44:01 +0000 (UTC)")
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: </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: =?iso-8859-1?Q?Andr=E1s?= Major <andras.g.major@gmail.com>
Cc: emacs-orgmode@gnu.org

Hi András,

András Major <andras.g.major@gmail.com> writes:

> 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, 

Yes, a *major documentation bug*.

> but likewise anything it does do which the docs don't cover is
> also a bug.

I would call this a *minor documentation bug* (depending on the
importance of the side-effects, of course).

For example, not all variables get documented in the manual, and each
variable plays a role somewhere, as documented in its docstring -- it
would not be reasonable to try to document each variable in the manual
because it would make it completely unreadable.

So I'd rephrase your statement above:

  "Features that the user needs to know about and is not covered by the
  documentation is a bug."

But again, this is stating the obvious :)

Let's not spend too much time discussing theoretically -- patches
welcome!  :)

Best,

-- 
 Bastien