From owner-freebsd-doc@FreeBSD.ORG Mon Sep 19 18:00:46 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3F82716A41F for ; Mon, 19 Sep 2005 18:00:46 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 94B7043D6E for ; Mon, 19 Sep 2005 18:00:38 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j8JI0cQe077894 for ; Mon, 19 Sep 2005 18:00:38 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j8JI0cXM077893; Mon, 19 Sep 2005 18:00:38 GMT (envelope-from gnats) Resent-Date: Mon, 19 Sep 2005 18:00:38 GMT Resent-Message-Id: <200509191800.j8JI0cXM077893@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Mikhail Teterin Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DFB4116A41F for ; Mon, 19 Sep 2005 17:54:28 +0000 (GMT) (envelope-from mi@blue.virtual-estates.net) Received: from blue.virtual-estates.net (aldan.algebra.com [216.254.65.224]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7221543D45 for ; Mon, 19 Sep 2005 17:54:26 +0000 (GMT) (envelope-from mi@blue.virtual-estates.net) Received: from blue.virtual-estates.net (blue [127.0.0.1]) by blue.virtual-estates.net (8.13.4/8.13.4) with ESMTP id j8JHsNGp025963 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 19 Sep 2005 13:54:25 -0400 (EDT) (envelope-from mi@blue.virtual-estates.net) Received: (from mi@localhost) by blue.virtual-estates.net (8.13.4/8.13.4/Submit) id j8JHsNCe025962; Mon, 19 Sep 2005 13:54:23 -0400 (EDT) (envelope-from mi) Message-Id: <200509191754.j8JHsNCe025962@blue.virtual-estates.net> Date: Mon, 19 Sep 2005 13:54:23 -0400 (EDT) From: Mikhail Teterin To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/86342: bikeshed entry of Handbook is wrong X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Sep 2005 18:00:46 -0000 >Number: 86342 >Category: docs >Synopsis: bikeshed entry of Handbook is wrong >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Sep 19 18:00:38 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Mikhail Teterin >Release: FreeBSD 5.4-STABLE i386 >Organization: Virtual Estates, Inc. >Environment: >Description: The doc on the "bikeshed" term, such as: http://www.freebsd.org/doc/en_US.ISO8859-1/articles/mailing-list-faq/bikeshed.html is wrong. It wrongly describes the "bikeshed" argument as anything, where there is no consensus -- "sh vs. csh" would qualify. The correct explanation in FAQ is linked to, and is quite different from that of the Handbook. >How-To-Repeat: >Fix: How about: "... However, in FreeBSD parlance, the word is a derogatory term that refers to any argument about a non-essential part of a proposed change, fix, or idea. Sometimes such arguments overshadow the discussion of the essential parts much to the detriment of progress. (The genesis of the ..." The second paragraph -- beginning with "More generally..." -- should be removed altogether. >Release-Note: >Audit-Trail: >Unformatted: