From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:20:07 2003 Return-Path: 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 AF65C37B401 for ; Fri, 23 May 2003 10:20:07 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 46B5743FB1 for ; Fri, 23 May 2003 10:20:07 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4NHK7Up016137 for ; Fri, 23 May 2003 10:20:07 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4NHK72A016136; Fri, 23 May 2003 10:20:07 -0700 (PDT) Date: Fri, 23 May 2003 10:20:07 -0700 (PDT) Message-Id: <200305231720.h4NHK72A016136@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:20:08 -0000 The following reply was made to PR docs/52547; it has been noted by GNATS. From: Marc Fonvieille To: "Simon L.Nielsen" Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article Date: Fri, 23 May 2003 19:11:57 +0200 On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote: > General cleanup of the laptop article : > > * Add id attributes to all sect1 tags This is far to be mandatory on a so little article. > * s/FreeBSD/&os;/g This tag should be used on new submission, but a full commit does not worth since it brings nothing new to the reader. > * Add application tags around XFree86 references > * Minor markup cleanups... Hope they right > * Refer to more files/programs using manual page references > * Remove some redundant words/sentences (inspired by FDP Writing style section) > > Note: This article is in need of a whitespace cleanup. > >How-To-Repeat: > >Fix: > --- doc-article-laptop-cleanup.patch begins here --- [...] > > - > - Option "Emulate3Buttons" > - > + Option "Emulate3Buttons" It's not good: no whitespace/wrapline change with content change. And this one is quite useless. [...] > - cards is in the file /etc/defaults/pccard.conf. > + cards is in &man.pccard.conf.5;. /etc/defaults/pccard.conf is always up to date, it's not the case of the manual page. > Look through it, and preferably buy cards listed there. Cards not > listed may also work as generic devices: in > particular most modems (16-bit) should work fine, provided they > @@ -128,39 +126,38 @@ > card, remove irq 5 (otherwise you may experience hangs when you > insert a card). Check also the available memory slots; if your > card is not being detected, try changing it to one of the other > - allowed values (listed in the manual page &man.pccardc.8;). > + allowed values (listed in &man.pccardc.8;). manual page was good there. > > > - If it is not running already, start the pccardd daemon. > + If it is not running already, start the &man.pccardd.8; daemon. > (To enable it at boot time, add > pccard_enable="YES" to > - /etc/rc.conf.) Now your cards should be > + &man.rc.conf.5;). Now your cards should be Well /etc/rc.conf is a better choice there, for obvious reason. > detected when you insert and remove them, and you should get > log messages about new devices being enabled. > > There have been major changes to the pccard code > (including ISA routing of interrupts, for machines whose > - PCI BIOS FreeBSD can not seem to use) before the FreeBSD 4.4 > + PCI BIOS &os; can not seem to use) before the &os; 4.4 > release. If you have problems, try upgrading your system. > > > > - > + > > Power management > > Unfortunately, this is not very reliably supported under > - FreeBSD. If you are lucky, some functions may work reliably; > + &os;. If you are lucky, some functions may work reliably; > or they may not work at all. > > To enable this, you may need to compile a kernel with > power management support (device apm0) or > add the option enable apm0 to > - /boot/loader.conf, and > - also enable the apm daemon at boot time (line > + &man.loader.conf.5;, and > + also enable the &man.apm.8; daemon at boot time (line /boot/loader.conf is not bad here, and &man.apmd.8; seems better. Marc