From owner-freebsd-doc@FreeBSD.ORG  Sat Dec  7 04:26:10 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 78CA363C
 for <freebsd-doc@freebsd.org>; Sat,  7 Dec 2013 04:26:10 +0000 (UTC)
Received: from mail-qe0-x22f.google.com (mail-qe0-x22f.google.com
 [IPv6:2607:f8b0:400d:c02::22f])
 (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 1A42510E7
 for <freebsd-doc@freebsd.org>; Sat,  7 Dec 2013 04:26:09 +0000 (UTC)
Received: by mail-qe0-f47.google.com with SMTP id t7so1206841qeb.6
 for <freebsd-doc@freebsd.org>; Fri, 06 Dec 2013 20:26:09 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=eitanadler.com; s=0xdeadbeef;
 h=mime-version:in-reply-to:references:from:date:message-id:subject:to
 :cc:content-type;
 bh=w8PactaDwX/kljkPlTOnyMjjXxibHqFWo+y8hA5VppE=;
 b=nqRcXcOI/b00xvtNVVoneG/Lgldm8qOq3DiUvOIrIX7BqqxZNGCnwSTjtKPc+DMc2E
 2bxFX1GihHrDFdVwDUARoWLGsAkwanQalfvQv23kNVwHUHugSbOfvIsXuG48yobVBFay
 cLSXiEoUrUcEVL7IRkqEBzwavZuQsMFwXYVT0=
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20130820;
 h=x-gm-message-state:mime-version:in-reply-to:references:from:date
 :message-id:subject:to:cc:content-type;
 bh=w8PactaDwX/kljkPlTOnyMjjXxibHqFWo+y8hA5VppE=;
 b=ICK+VCvecemBpg3Ck3cFgT+xJ/JBoRoikRGLWpJJSeo1FRxMmhNSKdthc7S83do30p
 f/0eElR69QL5rGvuUCzzvicp4SNNbEsXQSxwl2V7S06uo/q1s9dIusnTGP0rW+XQX67E
 DcCyWpN1gZjQcHMY6kHgCQ+8V4vDASlGCMAETdiLlvAU2GakT8P7t8faKHHaPxKSsAhU
 JfSHyZvjF2uz18SsP4bC/3Lcmv+pRVZbdvJgBBTgTT9G3gZOSf6GRYCHOcE+kx5yZoUB
 gVgLJ9729X2ceAkrvNG1sPLv+D3mn/OmIIrEgKzAut4k8fJwtfhMRucKCTinqyTCy7h7
 M4lg==
X-Gm-Message-State: ALoCoQm9Oi5rPzTuYOMlltSAVO3/1OT1HtLebcoStX/LDZPuzoaFkiapFBzrUOeoGJVUFufd6NEv
X-Received: by 10.49.74.138 with SMTP id t10mr12993711qev.21.1386390369113;
 Fri, 06 Dec 2013 20:26:09 -0800 (PST)
MIME-Version: 1.0
Received: by 10.96.86.42 with HTTP; Fri, 6 Dec 2013 20:25:39 -0800 (PST)
In-Reply-To: <20131207021835.GK20078@glenbarber.us>
References: <201312070107.rB717SAW015758@freefall.freebsd.org>
 <CAF6rxgk50a0gL7_O3t=iFM-XGjnwam07ZNkOOgsWV=Tu7OKDXQ@mail.gmail.com>
 <20131207021835.GK20078@glenbarber.us>
From: Eitan Adler <lists@eitanadler.com>
Date: Fri, 6 Dec 2013 23:25:39 -0500
Message-ID: <CAF6rxgm7qqE5cd-ax7=LipUGJpSA19ZJeJ1+_ZqpCqCfMU_cPw@mail.gmail.com>
Subject: Re: docs/184550: bc -q option not documented in man page
To: Glen Barber <gjb@freebsd.org>
Content-Type: text/plain; charset=UTF-8
Cc: "freebsd-doc@freebsd.org" <freebsd-doc@freebsd.org>,
 Xin LI <delphij@freebsd.org>, "Ronald F. Guilmette" <rfg@tristatelogic.com>
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 07 Dec 2013 04:26:10 -0000

On Fri, Dec 6, 2013 at 9:18 PM, Glen Barber <gjb@freebsd.org> wrote:
> On Fri, Dec 06, 2013 at 09:12:30PM -0500, Eitan Adler wrote:
>> all options should be documented.  An undocumented option is a bug.
>> If we don't want people using it we should document as such.
>>
>
> It is documented.
>
>                 case 'q':
>                         /* compatibility option */
>                         break;

Source code is not documentation.  It it surprising to hear that,
especially on this list.

-- 
Eitan Adler