From owner-freebsd-questions@FreeBSD.ORG Sat Mar 19 07:18:58 2011 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1A4121065678 for ; Sat, 19 Mar 2011 07:18:58 +0000 (UTC) (envelope-from freebsd@edvax.de) Received: from mx01.qsc.de (mx01.qsc.de [213.148.129.14]) by mx1.freebsd.org (Postfix) with ESMTP id D2E488FC0A for ; Sat, 19 Mar 2011 07:18:57 +0000 (UTC) Received: from r55.edvax.de (port-92-195-86-215.dynamic.qsc.de [92.195.86.215]) by mx01.qsc.de (Postfix) with ESMTP id 6AE303CB6C; Sat, 19 Mar 2011 08:18:56 +0100 (CET) Received: from r55.edvax.de (localhost [127.0.0.1]) by r55.edvax.de (8.14.2/8.14.2) with SMTP id p2J7It4j001566; Sat, 19 Mar 2011 08:18:55 +0100 (CET) (envelope-from freebsd@edvax.de) Date: Sat, 19 Mar 2011 08:18:55 +0100 From: Polytropon To: Michel Talon Message-Id: <20110319081855.bc497dda.freebsd@edvax.de> In-Reply-To: <20110318213641.GA37871@lpthe.jussieu.fr> References: <20110318213641.GA37871@lpthe.jussieu.fr> Organization: EDVAX X-Mailer: Sylpheed 2.4.7 (GTK+ 2.12.1; i386-portbld-freebsd7.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: freebsd-questions@freebsd.org Subject: Re: HAL must die! X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Polytropon List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 19 Mar 2011 07:18:58 -0000 On Fri, 18 Mar 2011 22:36:41 +0100, Michel Talon wrote: > How many new features of FreeBSD are > correctly documented presently? Features of the FreeBSD OS are typically well documented. This high quality affects all kind of documentation, be it the handbook & FAQ, as well as the manpages that are available for system binaries, kernel interfaces, library calls, configuration files and system operations. Also see the high quality of the source code which is, due to its style and content (and its comment) also a source of documentation, mainly designed for programmers instead of end users. HAL, on the other hand, is obsolete as well as not part of the FreeBSD operating system. It's a separate port. Many ports do follow the quality approach for documentation, see "man xmms", "man mplayer" or even "man opera" for examples. Many "modern" software does not provide documentation in the standard way, try "man firefox" or any KDE program. In some cases, documentation is left to the users and scattered across the Internet in web pages and Wikis. -- Polytropon Magdeburg, Germany Happy FreeBSD user since 4.0 Andra moi ennepe, Mousa, ...