From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 01:20:03 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CD4DB106568F for ; Sun, 9 Nov 2008 01:20:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id AABA68FC19 for ; Sun, 9 Nov 2008 01:20:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mA91K3oT008786 for ; Sun, 9 Nov 2008 01:20:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mA91K3iE008785; Sun, 9 Nov 2008 01:20:03 GMT (envelope-from gnats) Resent-Date: Sun, 9 Nov 2008 01:20:03 GMT Resent-Message-Id: <200811090120.mA91K3iE008785@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, Eitan Adler Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3A8B6106567B for ; Sun, 9 Nov 2008 01:19:31 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 2A3AB8FC0C for ; Sun, 9 Nov 2008 01:19:31 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id mA91JUPS009108 for ; Sun, 9 Nov 2008 01:19:30 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id mA91JU1B009107; Sun, 9 Nov 2008 01:19:30 GMT (envelope-from nobody) Message-Id: <200811090119.mA91JU1B009107@www.freebsd.org> Date: Sun, 9 Nov 2008 01:19:30 GMT From: Eitan Adler To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/128711: Re: [patch] for handbook browsers page 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: Sun, 09 Nov 2008 01:20:03 -0000 >Number: 128711 >Category: docs >Synopsis: Re: [patch] for handbook browsers page >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: Sun Nov 09 01:20:03 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Eitan Adler >Release: N/A >Organization: >Environment: N/A >Description: 1) the list at the top of handbook/desktop-browsers.html is changed to a list of major browsers in the system 2) An Entry for dillo and links is added 4) some "ids" are added so that works properly 5) A note of support for linux flash9 on -STABLE is added 6) Made links to port pkg-descr 7) Some other minor changes that I don't remember Patch attached. >How-To-Repeat: >Fix: Patch attached with submission follows: --- chapter.sgml.orig 2008-10-25 13:16:32.000000000 -0400 +++ chapter.sgml.try.2 2008-11-05 20:44:02.000000000 -0500 @@ -118,13 +118,7 @@ Please refer to for more information on how to set up these complete desktops. - If you are looking for light-weight browsers, you should - investigate the Ports Collection for - www/dillo, - www/links, or - www/w3m. - - This section covers these applications: + The following browsers can be found using the freeBSD ports system: @@ -139,14 +133,14 @@ - Mozilla + www/mozilla heavy heavy Gtk+ - Opera + www/opera light light FreeBSD and Linux versions available. The Linux @@ -155,23 +149,50 @@ - Firefox + www/firefox3 medium heavy Gtk+ - - Konqueror - medium - heavy - KDE Libraries + + konqueror + medium + heavy + KDE Libraries + + + www/dillo + light + light + FLTK2 + + + + www/lynx + light + light + - + + + www/links + light + light + - + + + www/w3m + light + light + ? + + - + Mozilla Mozilla @@ -228,7 +249,7 @@ &prompt.user; mozilla -mail - + Firefox Firefox @@ -306,8 +327,27 @@ large port. The next step is to install the www/linux-flashplugin7 port. Once - this port is installed, the plugin must be installed by each + role="package">www/linux-flashplugin7 port. + If you are running 7-STABLE or later then www/linux-flashplugin9 will also work. + However you need certain prerequisites. + 1) You need to be running -STABLE from at least Mon Oct 20 11:15:57 2008 UTC + 2) You nead change to the 2.6.16 version of the linux kernel: + &prompt.root sysctl compat.linux.osrelease=2.6.16 + Adding this line to sysctl.conf should also work. + 3) Make sure linprocfs is mounted to /compat/linux/proc + 4) Make sure www/nspluginwrapper, www/linux-flashplugin9 and dependencies are installed and up to date. + (the default emulators/linux_base-fc4 should work, if you want to use a later one don't forget to set + compat.linux.osrelease=2.6.16 in sysctl.conf and OVERRIDE_LINUX_BASE_PORT + to whichever version you use in make.conf. Note however that on 6, only the default compat.linux.osrelease=2.4.2 really works.) + + To run flash from native firefox you need www/nspluginwrapper. + If the plugin doesnt show up in firefox' about:plugins, run + &prompt.user nspluginwrapper -i /usr/local/lib/npapi/linux-flashplugin/libflashplayer.so + and restart firefox. + + + + Once this port is installed, the plugin must be installed by each user with nspluginwrapper: &prompt.user; nspluginwrapper -v -a -i @@ -380,6 +420,28 @@ Konqueror is available at . + + Dillo + + + Dillo + + + + Dillo is a stand-alone lightweight web browser which is known for its fast speed and small size. + + To browse the Web with Dillo, install the package: + + &prompt.root; pkg_add -r dillo + + Some FTP sites do not have all the packages, but Dillo can still be obtained + through the Ports Collection by typing: + + &prompt.root; cd /usr/ports/www/dillo +&prompt.root; make install clean + + + >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 08:30:05 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E1C6E1065677 for ; Sun, 9 Nov 2008 08:30:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D027F8FC17 for ; Sun, 9 Nov 2008 08:30:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mA98U5cb067522 for ; Sun, 9 Nov 2008 08:30:05 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mA98U57v067519; Sun, 9 Nov 2008 08:30:05 GMT (envelope-from gnats) Date: Sun, 9 Nov 2008 08:30:05 GMT Message-Id: <200811090830.mA98U57v067519@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Cc: Subject: Re: docs/128711: Re: [patch] for handbook browsers page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 09 Nov 2008 08:30:06 -0000 The following reply was made to PR docs/128711; it has been noted by GNATS. From: Marc Fonvieille To: Eitan Adler Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/128711: Re: [patch] for handbook browsers page Date: Sun, 9 Nov 2008 09:25:07 +0100 On Sun, Nov 09, 2008 at 01:19:30AM +0000, Eitan Adler wrote: > > >Number: 128711 > >Category: docs > >Synopsis: Re: [patch] for handbook browsers page > >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: Sun Nov 09 01:20:03 UTC 2008 > >Closed-Date: > >Last-Modified: > >Originator: Eitan Adler > >Release: N/A > >Organization: > >Environment: > N/A > >Description: > 1) the list at the top of handbook/desktop-browsers.html is changed to a list of major browsers in the system The goal of this section is indeed talking about major browsers, the audience is the newcomer to FreeBSD. Firefox (and Mozilla, well Mozilla part should be removed since Firefox is now preferred), Opera and Konqueror can be seen as major browsers since they can really render any site. Dillo, links, lynx, w3m, etc. are light-weight browsers, they can't be seen as major browsers for obvious reasons... The current layout of the page is not bad and I don't see the need to add links, lynx, w3m to the table since we don't talk about them. I've no objection about adding something regarding Dillo, but we must be honest with the reader: Dillo cannot render correctly and be used on every websites around the world. > 2) An Entry for dillo and links is added > 4) some "ids" are added so that works properly > 5) A note of support for linux flash9 on -STABLE is added [...] This part is a bit "messy", it must be reworked and be sure it's working and stable. I have to do some tests. -- Marc From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 08:31:31 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BF2A31065676; Sun, 9 Nov 2008 08:31:31 +0000 (UTC) (envelope-from blackend@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 95DA88FC1B; Sun, 9 Nov 2008 08:31:31 +0000 (UTC) (envelope-from blackend@FreeBSD.org) Received: from freefall.freebsd.org (blackend@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mA98VVkD075060; Sun, 9 Nov 2008 08:31:31 GMT (envelope-from blackend@freefall.freebsd.org) Received: (from blackend@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mA98VVvX075056; Sun, 9 Nov 2008 08:31:31 GMT (envelope-from blackend) Date: Sun, 9 Nov 2008 08:31:31 GMT Message-Id: <200811090831.mA98VVvX075056@freefall.freebsd.org> To: blackend@FreeBSD.org, freebsd-doc@FreeBSD.org, blackend@FreeBSD.org From: blackend@FreeBSD.org Cc: Subject: Re: docs/128711: Re: [patch] for handbook browsers page 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: Sun, 09 Nov 2008 08:31:31 -0000 Synopsis: Re: [patch] for handbook browsers page Responsible-Changed-From-To: freebsd-doc->blackend Responsible-Changed-By: blackend Responsible-Changed-When: Sun Nov 9 08:30:57 UTC 2008 Responsible-Changed-Why: I'll work on an update of the browsers page. http://www.freebsd.org/cgi/query-pr.cgi?pr=128711 From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 08:45:53 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C6F091065680; Sun, 9 Nov 2008 08:45:53 +0000 (UTC) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (ns0.blackend.org [82.227.222.164]) by mx1.freebsd.org (Postfix) with ESMTP id 3BD268FC0A; Sun, 9 Nov 2008 08:45:52 +0000 (UTC) (envelope-from marc@blackend.org) Received: from gothic.blackend.org (gothic.blackend.org [192.168.1.203]) by abigail.blackend.org (8.13.4/8.13.3) with ESMTP id mA98jpCw070225; Sun, 9 Nov 2008 09:45:51 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: from gothic.blackend.org (localhost [127.0.0.1]) by gothic.blackend.org (8.14.3/8.14.1) with ESMTP id mA98jpFg001227; Sun, 9 Nov 2008 09:45:51 +0100 (CET) (envelope-from marc@gothic.blackend.org) Received: (from marc@localhost) by gothic.blackend.org (8.14.3/8.14.3/Submit) id mA98jppN001226; Sun, 9 Nov 2008 09:45:51 +0100 (CET) (envelope-from marc) Date: Sun, 9 Nov 2008 09:45:51 +0100 From: Marc Fonvieille To: Chin-San Huang Message-ID: <20081109084551.GB1058@gothic.blackend.org> References: <200811090424.mA94OlN6087438@repoman.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200811090424.mA94OlN6087438@repoman.freebsd.org> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 7.1-PRERELEASE User-Agent: Mutt/1.5.18 (2008-05-17) Cc: freebsd-doc@FreeBSD.org, doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: doc/share/misc docbook.css 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: Sun, 09 Nov 2008 08:45:53 -0000 On Sun, Nov 09, 2008 at 04:24:47AM +0000, Chin-San Huang wrote: > chinsan 2008-11-09 04:24:47 UTC > > FreeBSD doc repository > > Modified files: > share/misc docbook.css > Log: > - Decorating BLOCKQUOTE box. > This is something we needed but we have to think about the colours and fix the layout for Notes. Let's compare both: http://people.freebsd.org/~blackend/doc/en_US.ISO8859-1/books/handbook/x-config.html and http://www.netbsd.org/docs/guide/en/chap-x.html I think NetBSD way is a bit cleaner than ours. Our Note appears more as a "warning" than just a note. The way they render keyboard inputs and programlisting is also more elegant than ours. It'd be great if everyone could think about all this and if we could reach a consensus with a great docbook.css that also fits with colors set used on http://www.freebsd.org/ website. -- Marc From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 09:12:11 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 514ED1065677 for ; Sun, 9 Nov 2008 09:12:11 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.26]) by mx1.freebsd.org (Postfix) with ESMTP id D19598FC0A for ; Sun, 9 Nov 2008 09:12:10 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ey-out-2122.google.com with SMTP id 6so730393eyi.7 for ; Sun, 09 Nov 2008 01:12:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=924XcBJQT1qybVVRiQkoGlym7E2PqjoXxjGu3vGYLG0=; b=Qhzf1OOgeZMsXCJAYHZ1qJY++KqU3Pxa/dctZCkkmp42QyM7NuO1QLfoze9UVN73Ql W8pGJfLg9ESd8tBXaOdlnLa6qUIPgR0/pG66Sj2UiM6Lchd8KslfweNQ2H11H1ot85nc 7zUthmqOjXNJBqWNs1KXTLsqZ0qrdtBd8iqZ0= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=VBgdvI6R64x7RjqcIwQ77Vx44M1rn1USMvB8wzV2tq1YInrxHUOOAuXGACpi02XeXt neS2JRzwPlZHg25TsxKO2CTZrVBFSh4d8s4dfvly835jlPK24rLShiMvfGz8Wi8YOqWH LwrhKsAYkVEdl3KMkpA6rwDJj6KjzOD05hYbU= Received: by 10.210.121.8 with SMTP id t8mr6185969ebc.143.1226220705825; Sun, 09 Nov 2008 00:51:45 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-67918.home.otenet.gr [87.203.146.156]) by mx.google.com with ESMTPS id 20sm7767056eyc.9.2008.11.09.00.51.44 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 09 Nov 2008 00:51:44 -0800 (PST) Message-ID: <4916A49F.8030709@gmail.com> Date: Sun, 09 Nov 2008 10:51:43 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: blackend@FreeBSD.org References: <200811090831.mA98VVvX075056@freefall.freebsd.org> In-Reply-To: <200811090831.mA98VVvX075056@freefall.freebsd.org> Content-Type: text/plain; charset=ISO-8859-7; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/128711: Re: [patch] for handbook browsers page 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: Sun, 09 Nov 2008 09:12:11 -0000 blackend@FreeBSD.org wrote: > Synopsis: Re: [patch] for handbook browsers page > > Responsible-Changed-From-To: freebsd-doc->blackend > Responsible-Changed-By: blackend > Responsible-Changed-When: Sun Nov 9 08:30:57 UTC 2008 > Responsible-Changed-Why: > I'll work on an update of the browsers page. > > http://www.freebsd.org/cgi/query-pr.cgi?pr=128711 > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > > While you are at it, it might also be worth mentioning that firefox3 plug-ins directory is /usr/local/lib/firefox3/plugins and plug-ins might have to be symlinked from the usual browser_plugins place. I am not certain whether this is a temporary condition though. From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 17:14:57 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0CFF4106564A; Sun, 9 Nov 2008 17:14:57 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id 5D6958FC08; Sun, 9 Nov 2008 17:14:56 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (adsl202-73.kln.forthnet.gr [79.103.15.73]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mA9HEkLt028237 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 9 Nov 2008 19:14:52 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mA9HEkDr033559; Sun, 9 Nov 2008 19:14:46 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mA9HEkkk033558; Sun, 9 Nov 2008 19:14:46 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Marc Fonvieille References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> Date: Sun, 09 Nov 2008 19:14:46 +0200 In-Reply-To: <20081109084551.GB1058@gothic.blackend.org> (Marc Fonvieille's message of "Sun, 9 Nov 2008 09:45:51 +0100") Message-ID: <87hc6gbz3t.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-MailScanner-ID: mA9HEkLt028237 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.113, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.29, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org, doc-committers@freebsd.org, Chin-San Huang , cvs-doc@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: doc/share/misc docbook.css 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: Sun, 09 Nov 2008 17:14:57 -0000 On Sun, 9 Nov 2008 09:45:51 +0100, Marc Fonvieille wrote: > On Sun, Nov 09, 2008 at 04:24:47AM +0000, Chin-San Huang wrote: >> chinsan 2008-11-09 04:24:47 UTC >> >> FreeBSD doc repository >> >> Modified files: >> share/misc docbook.css >> Log: >> - Decorating BLOCKQUOTE box. >> > > This is something we needed but we have to think about the colours and > fix the layout for Notes. > > Let's compare both: > http://people.freebsd.org/~blackend/doc/en_US.ISO8859-1/books/handbook/x-config.html Maybe something like this? http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css.diff I don't really like ``width: 800px;'' in our current stylesheet. In wide monitors, or with lagre font sizes, explicitly using pixels for the width of document elements means that the reader may end up with stuff like this screenshot: http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-bug.png The current elements stand out too much for my taste too, so I removed ``background-color: #DEE3E7;'' from , but added a border (similar to the one of elements) to . You can see the effect of the stylesheet changes of `css.diff' in the two sets of pages: [before] http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-old/install-pre.html http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-old/x-config.html [after] http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-new/install-pre.html http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-new/x-config.html If these changes look ok, I can commit them some time later this week. From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 19:25:10 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E86C61065676; Sun, 9 Nov 2008 19:25:10 +0000 (UTC) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (ns0.blackend.org [82.227.222.164]) by mx1.freebsd.org (Postfix) with ESMTP id 3D6328FC08; Sun, 9 Nov 2008 19:25:09 +0000 (UTC) (envelope-from marc@blackend.org) Received: from gothic.blackend.org (gothic.blackend.org [192.168.1.203]) by abigail.blackend.org (8.13.4/8.13.3) with ESMTP id mA9JP7gX076019; Sun, 9 Nov 2008 20:25:07 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: from gothic.blackend.org (localhost [127.0.0.1]) by gothic.blackend.org (8.14.3/8.14.1) with ESMTP id mA9JP7q8021550; Sun, 9 Nov 2008 20:25:07 +0100 (CET) (envelope-from marc@gothic.blackend.org) Received: (from marc@localhost) by gothic.blackend.org (8.14.3/8.14.3/Submit) id mA9JP7hn021549; Sun, 9 Nov 2008 20:25:07 +0100 (CET) (envelope-from marc) Date: Sun, 9 Nov 2008 20:25:07 +0100 From: Marc Fonvieille To: Giorgos Keramidas Message-ID: <20081109192507.GB1030@gothic.blackend.org> References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> <87hc6gbz3t.fsf@kobe.laptop> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <87hc6gbz3t.fsf@kobe.laptop> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 7.1-PRERELEASE User-Agent: Mutt/1.5.18 (2008-05-17) Cc: freebsd-doc@freebsd.org, doc-committers@freebsd.org, Chin-San Huang , cvs-doc@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: doc/share/misc docbook.css 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: Sun, 09 Nov 2008 19:25:11 -0000 On Sun, Nov 09, 2008 at 07:14:46PM +0200, Giorgos Keramidas wrote: > On Sun, 9 Nov 2008 09:45:51 +0100, Marc Fonvieille wrote: > > On Sun, Nov 09, 2008 at 04:24:47AM +0000, Chin-San Huang wrote: > >> chinsan 2008-11-09 04:24:47 UTC > >> > >> FreeBSD doc repository > >> > >> Modified files: > >> share/misc docbook.css > >> Log: > >> - Decorating BLOCKQUOTE box. > >> > > > > This is something we needed but we have to think about the colours and > > fix the layout for Notes. > > > > Let's compare both: > > http://people.freebsd.org/~blackend/doc/en_US.ISO8859-1/books/handbook/x-config.html > > Maybe something like this? > > http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css.diff > > I don't really like ``width: 800px;'' in our current stylesheet. In > wide monitors, or with lagre font sizes, explicitly using pixels for the > width of document elements means that the reader may end up with stuff > like this screenshot: > > http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-bug.png > > The current elements stand out too much for my taste too, so I > removed ``background-color: #DEE3E7;'' from , but added a border > (similar to the one of elements) to . > > You can see the effect of the stylesheet changes of `css.diff' in the > two sets of pages: > > [before] > http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-old/install-pre.html > http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-old/x-config.html > > [after] > http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-new/install-pre.html > http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-new/x-config.html > The new x-config.html is fine for me. For the new install-pre.html, the way is rendered looks oldish, maybe using the same scheme as for might do the trick. -- Marc From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 20:37:33 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7740A106568B; Sun, 9 Nov 2008 20:37:33 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id E0BDC8FC0C; Sun, 9 Nov 2008 20:37:32 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (adsl202-73.kln.forthnet.gr [79.103.15.73]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mA9KbOgn008817 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 9 Nov 2008 22:37:29 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mA9KbOlV044807; Sun, 9 Nov 2008 22:37:24 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mA9KbNbT044802; Sun, 9 Nov 2008 22:37:23 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Marc Fonvieille References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> <87hc6gbz3t.fsf@kobe.laptop> <20081109192507.GB1030@gothic.blackend.org> Date: Sun, 09 Nov 2008 22:37:23 +0200 In-Reply-To: <20081109192507.GB1030@gothic.blackend.org> (Marc Fonvieille's message of "Sun, 9 Nov 2008 20:25:07 +0100") Message-ID: <87k5bc4ovw.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-MailScanner-ID: mA9KbOgn008817 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.099, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.30, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org, doc-committers@freebsd.org, Chin-San Huang , cvs-doc@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: doc/share/misc docbook.css 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: Sun, 09 Nov 2008 20:37:33 -0000 On Sun, 9 Nov 2008 20:25:07 +0100, Marc Fonvieille wrote: >> Maybe something like this? >> >> http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css.diff >> >> I don't really like ``width: 800px;'' in our current stylesheet. In >> wide monitors, or with lagre font sizes, explicitly using pixels for the >> width of document elements means that the reader may end up with stuff >> like this screenshot: >> >> http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-bug.png >> >> The current elements stand out too much for my taste too, so I >> removed ``background-color: #DEE3E7;'' from , but added a border >> (similar to the one of elements) to . >> >> You can see the effect of the stylesheet changes of `css.diff' in the >> two sets of pages: >> >> [before] >> http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-old/install-pre.html >> http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-old/x-config.html >> >> [after] >> http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-new/install-pre.html >> http://people.freebsd.org/~keramida/bsd-css/2008.11.09/css-new/x-config.html > > The new x-config.html is fine for me. > For the new install-pre.html, the way is > rendered looks oldish, maybe using the same scheme as for > might do the trick. The bold red text is kind of `old school' for me too. I'll wait to see if there are flames^W^H err, objections about the rest and update the style too :) From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 20:43:34 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 453271065688 for ; Sun, 9 Nov 2008 20:43:34 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.186]) by mx1.freebsd.org (Postfix) with ESMTP id CDDB28FC1E for ; Sun, 9 Nov 2008 20:43:33 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by nf-out-0910.google.com with SMTP id h3so1005457nfh.33 for ; Sun, 09 Nov 2008 12:43:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:subject:x-enigmail-version:content-type :content-transfer-encoding; bh=kTnriQD/dVtMTEbRNifjRyI+DOWlJ6dxnB0hZJ9reEo=; b=Bjw/LkNDfKpsqwwGl8MxjFzQhgjqYgCdoC+uBcVvQ/q1V67Clm7lgeNxg5xwRwIx5N S2RpjpuwgUiUizSl8OtD8SrtYy99g+sXCJedrrnEy4JDPB+X/XGJ8oCBNzPxQVmpSFqv usXGxomjvJn/Xzfb/C3VcHymRjPWJew3L8I1Q= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:subject :x-enigmail-version:content-type:content-transfer-encoding; b=UMDLGCHbAim/pZEh2yp9fPw4Z0PCCevSDLPut4qd9vh9q7frpRhHDn/WBApIQp3iUJ 2bmjDl2imoYwHGqR71uEd57gwkuDXukR51Y92E6sazo96oZiiA5Gorcr1Aeq3pToL2iN N/UeCCPVWsP5xe278BMIrCFR2n4MUERHnR2to= Received: by 10.210.34.2 with SMTP id h2mr2086463ebh.120.1226263412325; Sun, 09 Nov 2008 12:43:32 -0800 (PST) Received: from self.rene-ladan.nl ([77.163.174.49]) by mx.google.com with ESMTPS id c24sm182217ika.11.2008.11.09.12.43.30 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 09 Nov 2008 12:43:31 -0800 (PST) Message-ID: <49174B71.9080800@gmail.com> Date: Sun, 09 Nov 2008 21:43:29 +0100 From: Rene Ladan User-Agent: Thunderbird 2.0.0.17 (X11/20080927) MIME-Version: 1.0 To: doc@freebsd.org X-Enigmail-Version: 0.95.6 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Subject: [RFC] Committers guide: replace CVS by SVN where appropiate 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: Sun, 09 Nov 2008 20:43:34 -0000 Hi, the current version of the Committers Guide (1.278 2008-08-16 21:42:35 pgj) uses CVS for everything, but as of last June the src repository uses SVN. I can write a preliminary patch for the article if you want me too. I think it would be possible to just refer to the wiki in some cases. Regards, Rene -- http://www.rene-ladan.nl/ GPG fingerprint = E738 5471 D185 7013 0EE0 4FC8 3C1D 6F83 12E1 84F6 (subkeys.pgp.net) From owner-freebsd-doc@FreeBSD.ORG Sun Nov 9 21:06:53 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 796C11065698 for ; Sun, 9 Nov 2008 21:06:53 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.26]) by mx1.freebsd.org (Postfix) with ESMTP id 10B9E8FC0C for ; Sun, 9 Nov 2008 21:06:52 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ey-out-2122.google.com with SMTP id 6so777361eyi.7 for ; Sun, 09 Nov 2008 13:06:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=M0n7RXUw5F9I4MkhAzUXRoiqAUOWc6kTGRlTcfUIdTU=; b=QY/jFrS1MHaQBF9suMc49U6ke+CKJwA41ZtTm5KYMdykc8OPEX8ew7VU52V/5Ik1GE iI8/65KXKJqkVKjil/sqAoR9aO2bEuQF+fWZhVePkIk9MlgUz/aB3zoxC9KjsRcDbzlu d9n1G+hITbYYt2R31CbZUNM4huB9hq11OYZX4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=umb38AfL1Ch+AdrbMqWRcrK/LKxH6aHm+CDOOR0T+SJ+Ch2TBoPdwYQCzNiZFLY6Qg BYpjZbf5kYTrYfDacIYfOddV+XLWpInovt7px2M8J8Pq3aQYxDUVqr2p5biaBxifw7WG yRq6GqyngEUKbtfHNZTjxgV+G/1gH1af8oUdM= Received: by 10.210.104.20 with SMTP id b20mr6903062ebc.94.1226264811752; Sun, 09 Nov 2008 13:06:51 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-67918.home.otenet.gr [87.203.146.156]) by mx.google.com with ESMTPS id z40sm849372ikz.4.2008.11.09.13.06.50 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 09 Nov 2008 13:06:51 -0800 (PST) Message-ID: <491750E9.4070204@gmail.com> Date: Sun, 09 Nov 2008 23:06:49 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Rene Ladan References: <49174B71.9080800@gmail.com> In-Reply-To: <49174B71.9080800@gmail.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org Subject: Re: [RFC] Committers guide: replace CVS by SVN where appropiate 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: Sun, 09 Nov 2008 21:06:53 -0000 Rene Ladan wrote: > Hi, > > the current version of the Committers Guide (1.278 2008-08-16 21:42:35 > pgj) > uses CVS for everything, but as of last June the src repository uses SVN. > > I can write a preliminary patch for the article if you want me too. That would be nice :) > I think > it would be possible to just refer to the wiki in some cases. IMHO, it would serve better if the guide is self contained, so someone can print it and keep as reference without having to resort to the wiki. Though the wiki should appear as a link of course. From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 10:34:14 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2C19A1065672; Mon, 10 Nov 2008 10:34:14 +0000 (UTC) (envelope-from gavin@FreeBSD.org) Received: from mail-gw2.york.ac.uk (mail-gw2.york.ac.uk [144.32.128.247]) by mx1.freebsd.org (Postfix) with ESMTP id A16A98FC16; Mon, 10 Nov 2008 10:34:13 +0000 (UTC) (envelope-from gavin@FreeBSD.org) Received: from mail-gw7.york.ac.uk (mail-gw7.york.ac.uk [144.32.129.30]) by mail-gw2.york.ac.uk (8.13.6/8.13.6) with ESMTP id mAAA27OU009712; Mon, 10 Nov 2008 10:02:07 GMT Received: from buffy-128.york.ac.uk ([144.32.128.160] helo=buffy.york.ac.uk) by mail-gw7.york.ac.uk with esmtps (TLSv1:AES256-SHA:256) (Exim 4.68) (envelope-from ) id 1KzTax-0002xV-J3; Mon, 10 Nov 2008 10:02:07 +0000 Received: from buffy.york.ac.uk (localhost [127.0.0.1]) by buffy.york.ac.uk (8.14.2/8.14.2) with ESMTP id mAAA27DV084450; Mon, 10 Nov 2008 10:02:07 GMT (envelope-from gavin@FreeBSD.org) Received: (from ga9@localhost) by buffy.york.ac.uk (8.14.2/8.14.2/Submit) id mAAA276C084449; Mon, 10 Nov 2008 10:02:07 GMT (envelope-from gavin@FreeBSD.org) X-Authentication-Warning: buffy.york.ac.uk: ga9 set sender to gavin@FreeBSD.org using -f From: Gavin Atkinson To: Giorgos Keramidas In-Reply-To: <87k5bc4ovw.fsf@kobe.laptop> References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> <87hc6gbz3t.fsf@kobe.laptop> <20081109192507.GB1030@gothic.blackend.org> <87k5bc4ovw.fsf@kobe.laptop> Content-Type: text/plain Content-Transfer-Encoding: 7bit Date: Mon, 10 Nov 2008 10:02:06 +0000 Message-Id: <1226311326.84196.1.camel@buffy.york.ac.uk> Mime-Version: 1.0 X-Mailer: Evolution 2.22.2 FreeBSD GNOME Team Port X-York-MailScanner: Found to be clean X-York-MailScanner-From: gavin@freebsd.org Cc: freebsd-doc@FreeBSD.org, doc-committers@FreeBSD.org, Chin-San Huang , Marc Fonvieille , cvs-doc@FreeBSD.org Subject: Re: cvs commit: doc/share/misc docbook.css 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, 10 Nov 2008 10:34:14 -0000 On Sun, 2008-11-09 at 22:37 +0200, Giorgos Keramidas wrote: > On Sun, 9 Nov 2008 20:25:07 +0100, Marc Fonvieille wrote: > > The new x-config.html is fine for me. > > For the new install-pre.html, the way is > > rendered looks oldish, maybe using the same scheme as for > > might do the trick. > > The bold red text is kind of `old school' for me too. I'll wait to see > if there are flames^W^H err, objections about the rest and update the > style too :) FWIW, I like the look of the new style sheet nore than the old one, but do agree with Marc about the new font used on - I assume this is due to the removal of "font-family: arial;" from BLOCKQUOTE.IMPORTANT. Gavin From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 11:06:06 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3879C1065676 for ; Mon, 10 Nov 2008 11:06:06 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1F13D8FC1F for ; Mon, 10 Nov 2008 11:06:06 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mAAB667L048777 for ; Mon, 10 Nov 2008 11:06:06 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mAAB65aL048773 for freebsd-doc@FreeBSD.org; Mon, 10 Nov 2008 11:06:05 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 10 Nov 2008 11:06:05 GMT Message-Id: <200811101106.mAAB65aL048773@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: gnats set sender to owner-bugmaster@FreeBSD.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Cc: Subject: Current unassigned doc problem reports 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, 10 Nov 2008 11:06:06 -0000 (Note: an HTML version of this report is available at http://www.freebsd.org/cgi/query-pr-summary.cgi?category=doc .) The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Tracker Resp. Description -------------------------------------------------------------------------------- o docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages o docs/128325 doc README.snapshots still refers to snaphots as "alpha-te o docs/128222 doc [patch] man page truss(1) claims that init(8) can be t o docs/128129 doc Sysinstall color problem in xterm o docs/128128 doc Sysinstall not mentioned in 4.4 "Using the Packages Sy o docs/128032 doc pthread(3) mentions libkse which has been removed in 8 o docs/127952 doc man for locate(1) is missing o docs/127923 doc Please mention qemu in the FreeBSD Handbook o docs/127908 doc [PATCH] readdir(3) error documentation o docs/127890 doc socket(2) man page should explain that protocol can be p docs/127866 doc Typos found in ifconfig(8) man page o docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/127842 doc list of hardware devices missing from the relnotes o docs/127840 doc [patch] fix entity references in release/doc/en_US.ISO o docs/127602 doc [patch] Incomplete information in nsswitch.conf(5) o docs/127575 doc [patch] Update to ports (7) as it is missing a few mak o docs/127406 doc [patch] update umodem man page: Sony Ericsson W810i o docs/126934 doc missing 'crit' in usr.sbin/syslogd/syslog.conf.5 o docs/126921 doc [patch] History section of cpuset(1) incorrect o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126487 doc fix language on atol(3) manpage o docs/126484 doc libc function res-zonscut2 is not documented o docs/126445 doc discussion on WEP settings in wpa_supplicant.conf(5) m o docs/126227 doc [patch] kthread(9) refers to non-existent manpage, des o docs/125921 doc lpd(8) talks about blocks in minfree while it is KB in o docs/125896 doc [PATCH] arp manual and syntax synchronisation o docs/125751 doc man 3 pthread_getschedparam section ERRORS incomplete o docs/125639 doc [patch] kldunloadf(2) does not mention about possible p docs/124166 doc fortune: instant-workstation tip should go o docs/123400 doc gvinum startup in handbook o docs/123035 doc [patch] bugs in refuse.README o docs/122470 doc [patch] exit status on fetch(1) manual page o docs/122053 doc [patch] update on vinum(4) reference to newfs(8) o docs/122052 doc minor update on handbook section 20.7.1 o docs/121952 doc Handbook chapter on Network Address Translation wrong o docs/121871 doc ftpd does not interpret configuration files as documen o docs/121585 doc [handbook] Wrong multicast specification o docs/121565 doc dhcp-options(5) manpage incorrectly formatted omitting s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121197 doc [patch] edits to books/porters-handbook o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120628 doc PAE documentation errror in handbook o docs/120539 doc Inconsistent ipfw's man page o docs/120456 doc ath(4) needs to specify requirement on wlan_scan_sta o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120040 doc handbook: diskless operation: populate root doesn't po o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119907 doc Ports compatibility o docs/119746 doc l10n chapter of handbook (Russian Language) o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting a docs/119536 doc a few typos in French handbook (basics) s docs/119404 doc [request] events page should list only last 2 years wo o docs/119338 doc gprof(1) refers to unmentioned option "-c" o docs/119329 doc [patch] Fix misleading man 1 split o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118545 doc loader tunables kern.dfldsiz and friends nearly undocu o docs/118332 doc man page for top does not describe STATE column wait e o docs/118214 doc close(2) error returns incomplete o docs/118020 doc ipfilter(4): man pages query for man 4 ipfilter return o docs/117798 doc formatting oddity in sysmouse(4) o docs/117747 doc 'break' system call needs a man page o docs/117013 doc mount_smbfs(8) doesn't document -U (username) argument o docs/116480 doc sysctl(3) description of kern.file no longer applies s o docs/116116 doc mktemp (3) re/move note o docs/116080 doc PREFIX is documented, but not the more important LOCAL o docs/115921 doc Booting from pst(4) is not supported o docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114184 doc [patch] [ndis]: add info to man 4 ndis o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/112804 doc groff(1) command should be called to explicitly use "p o docs/112682 doc Handbook GEOM_GPT explanation does not provide accurat o docs/112481 doc bug in ppp.linkup example o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/111263 doc [request] Information on $EDITOR variable in section 3 o docs/111147 doc hostapd.conf is not documented o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110253 doc [patch] rtprio(1): remove processing starvation commen o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit o docs/110061 doc [PATCH] tuning(7) missing reference to vfs.read_max o docs/109983 doc No manual entry for protoize o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/109975 doc No manual entry for elf2aout o docs/109973 doc No manual entry for c++filt o docs/109972 doc No manual entry for zless/bzless f docs/109226 doc [request] No manual entry for sntp o docs/109201 doc [request]: manual for callbootd o docs/109115 doc add Ultra 450 to hardware list for sparc64 a docs/108980 doc list of missing man pages o docs/108101 doc /boot/default/loader.conf contains an incorrect commen o docs/106135 doc [request] articles/vinum needs to be updated o docs/105997 doc sys/kern/sys_pipe.c refer to tuning(7), but there is n o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/104403 doc man security should mention that the usage of the X Wi o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/102148 doc The description of which Intel chips have EM64T is out o docs/101464 doc sync ru_RU.KOI8-R/articles/portbuild/article.html with o docs/100242 doc sysctl(3) description of KERN_PROC is not correct anym o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98759 doc [patch] sbp_targ(4) man page missing reference to devi o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/95139 doc FAQ to move filesystem to new disk fails: incorrect pe o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91174 doc [REQUEST] Handbook: Addition of Oracle 9i installation o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/86342 doc bikeshed entry of Handbook is wrong o docs/85187 doc [patch] find(1) manpage missing block info for -ls o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/85118 doc [PATCH] opiekey(1) references non-existing opiegen(1) o docs/85100 doc NOTES: ICH audio device support statement is ambiguous o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84806 doc mdoc(7) manpage has section ordering problems o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84538 doc [patch] sk(4) driver supports Marvell 88E800x chip too o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84268 doc chmod(1) manpage's BUGS entry is either wrong or too c o docs/84265 doc [patch] chmod(1) manpage omits implication of setting f docs/82595 doc 25.5.3 Configuring a bridge section of the handbook ne o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/78240 doc [patch] handbook: replace with aroun o docs/78138 doc [patch] Error in pre-installation section of installat o docs/76333 doc [patch] ferror(3): EOF indicator can be cleared by not o docs/75865 doc comments on "backup-basics" in handbook o docs/70652 doc [patch] New man page: portindex(5) o docs/70583 doc [patch] Update freebsd-glossary o docs/69861 doc [patch] usr.bin/csplit/csplit.1 does not document POSI o docs/63570 doc [patch] Language cleanup for the Handbook's DNS sectio o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour o docs/57388 doc [patch] INSTALL.TXT enhancement: mention ok prompt s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/50211 doc [PATCH] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] add documentation on the fixit disk to the FAQ o docs/47818 doc [patch] ln(1) manpage is confusing o docs/43823 doc [PATCH] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples o docs/36449 doc symlink(7) manual doesn't mention trailing slash, etc. s docs/35678 doc docproj Makefiles for web are broken for paths with sp s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. a docs/30008 doc [patch] French softupdates document should be translat o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 170 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 12:08:53 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C33E41065672 for ; Mon, 10 Nov 2008 12:08:53 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from wa-out-1112.google.com (wa-out-1112.google.com [209.85.146.179]) by mx1.freebsd.org (Postfix) with ESMTP id 8FCCA8FC27 for ; Mon, 10 Nov 2008 12:08:53 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by wa-out-1112.google.com with SMTP id m34so1255545wag.27 for ; Mon, 10 Nov 2008 04:08:53 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to :subject:cc:in-reply-to:mime-version:content-type :content-transfer-encoding:content-disposition:references; bh=kJLVF/mdMWeYPkLnVFUc/o7UrQmFD2G/iXUvwI0HKxY=; b=WGXr7wFxdNmDIWAf+jao//JYWEThwgaKeiLr9cR7D+9anD/NpJ0DORsi6QHR3BQ7j0 EG5Irp3DucChGF7jpPkmaD+j0VxZ69mip+QW+1qRy91NNmrSe2LMxQMfas/4AzctijXE HmOjaebOnlfjfCeUroN/rxXbn5ZTwh0YRyAwE= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version :content-type:content-transfer-encoding:content-disposition :references; b=NR75KXqPJZozIg4ekGarRZTPfh+Kl0+lYGq/0dT2NxOXz47or1URb+2x3UiP3eukko 5ETNsrtpwSU3oIck8Ha5Weh7iWSkRoPi2yGAY3qT+WCMzsZT8ju0BQicqKGdddMNLssm 8pTMBQMYMvR+SLsMwr3NzAfypg9brG+sYFd4A= Received: by 10.114.203.20 with SMTP id a20mr4204061wag.167.1226318933067; Mon, 10 Nov 2008 04:08:53 -0800 (PST) Received: by 10.114.94.7 with HTTP; Mon, 10 Nov 2008 04:08:52 -0800 (PST) Message-ID: Date: Mon, 10 Nov 2008 13:08:52 +0100 From: "Rene Ladan" To: "Manolis Kiagias" In-Reply-To: <491750E9.4070204@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <49174B71.9080800@gmail.com> <491750E9.4070204@gmail.com> Cc: doc@freebsd.org Subject: Re: [RFC] Committers guide: replace CVS by SVN where appropiate 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, 10 Nov 2008 12:08:53 -0000 2008/11/9 Manolis Kiagias : > Rene Ladan wrote: >> >> Hi, >> >> the current version of the Committers Guide (1.278 2008-08-16 21:42:35 >> pgj) >> uses CVS for everything, but as of last June the src repository uses SVN. >> >> I can write a preliminary patch for the article if you want me too. > > That would be nice :) > Nobody seems to object (or I'm too fast concluding it ;) ), so I'll start working on a patch after I've finished the translation of the "Contributing to FreeBSD" article. Keep an eye on //depot/projects/docproj_nl/... in perforce for progress. >> I think >> it would be possible to just refer to the wiki in some cases. > > IMHO, it would serve better if the guide is self contained, so someone can > print it and keep as reference without having to resort to the wiki. Though > the wiki should appear as a link of course. > Sound ok to me. I think the Committers Guide should cover the basic/common operations, the more exotic ones can be in the wiki. Regards, Rene -- http://www.rene-ladan.nl/ GPG fingerprint = E738 5471 D185 7013 0EE0 4FC8 3C1D 6F83 12E1 84F6 (subkeys.pgp.net) From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 15:29:51 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 803A7106567E for ; Mon, 10 Nov 2008 15:29:51 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.26]) by mx1.freebsd.org (Postfix) with ESMTP id 07C128FC13 for ; Mon, 10 Nov 2008 15:29:50 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by ey-out-2122.google.com with SMTP id 6so927274eyi.7 for ; Mon, 10 Nov 2008 07:29:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; bh=VkX6L4VPpG/uRvxmqmTcBN4oirgxRr/gY/lk1BMgR4Q=; b=LV2rZ7yh/6MZXS4LZMCDSLN72ew2S97nSiVcY+eSe9UpdaptECGctUkvUvzEqlhKW0 Box5j2Kfw+Qd0bc9PNIkhKJA4ilecAjFVCvZaCDXm2ahjjk5uvU/TaV8zuweANJRC6nV jaVXn6QjE/HtpkpiFfv8rYpV+XezBTAik5F9w= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to:cc :subject:references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; b=JJgyZGV3qIPJup7Qojp3pz99OfDc3bdRjL4VlnSvzXow/qKyoPMUuSJGiaHrkGx9Rr HzLtcz83GNIEyPfwabvMeVz1o8LzZAlr+OvfmS+5lWpEtFT77YnHyxe0pE5dZXMnwHUo Waa7eAZdxR/6Ty9LqFgaeXpKdeBDGAEvWZBo8= Received: by 10.86.51.10 with SMTP id y10mr7327650fgy.51.1226329072938; Mon, 10 Nov 2008 06:57:52 -0800 (PST) Received: from ?192.168.1.20? (oktnb24.inf.elte.hu [157.181.167.24]) by mx.google.com with ESMTPS id e20sm10862805fga.1.2008.11.10.06.57.50 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 10 Nov 2008 06:57:51 -0800 (PST) Message-ID: <49184BDB.5070707@FreeBSD.org> Date: Mon, 10 Nov 2008 15:57:31 +0100 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.17 (X11/20081023) MIME-Version: 1.0 To: Rene Ladan References: <49174B71.9080800@gmail.com> In-Reply-To: <49174B71.9080800@gmail.com> X-Enigmail-Version: 0.95.7 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Cc: doc@freebsd.org Subject: Re: [RFC] Committers guide: replace CVS by SVN where appropiate 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, 10 Nov 2008 15:29:51 -0000 Hello, Rene Ladan wrote: > the current version of the Committers Guide (1.278 2008-08-16 21:42:35 pgj) > uses CVS for everything, but as of last June the src repository uses SVN. Yeah, but do not forget many committers (two out of three kinds) still using and going to use CVS for a time being. Merging des's SVN Primer [1] into this guide would be a good idea, but note that some of its parts have been already put into developers-handbook [2]. While you are at committers-guide, it would be worth to mention FreeBSD wiki accounts [3] too, because it is "default" for developers now. I also wanted to revise some other sections of the committers-guide, for example (without the claim of completeness): - "Note: If you are a developer but not a committer, you will not be subscribed to the committers or developers mailing lists; the subscriptions are derived from the access rights." -- Is it still true? For example, bug busters are not committers but members of the developers' mailing list. - CVS Tags should be updated. - I am sure that contents of "Who's Who" should be also updated. - There is some information needed about the servers (i.e. freefall, hub, pointyhat etc.) a developer may access, at least their hostname. I remember it did not find these servers first time :) Of course, they are listed on the Project's internal page, but at least a link would be welcome to that page. - I am not sure that "A Free 4-CD Set or DVD Subscription" is still available for committers. :g [1] http://wiki.freebsd.org/SubversionPrimer [2] http://www.freebsd.org/doc/en/books/developers-handbook/policies-contributed.html [3] http://wiki.freebsd.org/AboutWiki From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 17:28:18 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 701691065670; Mon, 10 Nov 2008 17:28:18 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id D2FF68FC14; Mon, 10 Nov 2008 17:28:17 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (adsl58-130.kln.forthnet.gr [77.49.185.130]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mAAHS8Pe007380 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 10 Nov 2008 19:28:14 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mAAHS8oO009479; Mon, 10 Nov 2008 19:28:08 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mAAHS80v009478; Mon, 10 Nov 2008 19:28:08 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Gavin Atkinson References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> <87hc6gbz3t.fsf@kobe.laptop> <20081109192507.GB1030@gothic.blackend.org> <87k5bc4ovw.fsf@kobe.laptop> <1226311326.84196.1.camel@buffy.york.ac.uk> Date: Mon, 10 Nov 2008 19:28:08 +0200 In-Reply-To: <1226311326.84196.1.camel@buffy.york.ac.uk> (Gavin Atkinson's message of "Mon, 10 Nov 2008 10:02:06 +0000") Message-ID: <87fxlza3tj.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-MailScanner-ID: mAAHS8Pe007380 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.307, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.09, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org, doc-committers@freebsd.org, Chin-San Huang , cvs-doc@freebsd.org Subject: Re: cvs commit: doc/share/misc docbook.css 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, 10 Nov 2008 17:28:18 -0000 On Mon, 10 Nov 2008 10:02:06 +0000, Gavin Atkinson wrote: >On Sun, 2008-11-09 at 22:37 +0200, Giorgos Keramidas wrote: >>On Sun, 9 Nov 2008 20:25:07 +0100, Marc Fonvieille wrote: >>> The new x-config.html is fine for me. >>> For the new install-pre.html, the way is >>> rendered looks oldish, maybe using the same scheme as for >>> might do the trick. >> >> The bold red text is kind of `old school' for me too. I'll wait to see >> if there are flames^W^H err, objections about the rest and update the >> style too :) > > FWIW, I like the look of the new style sheet nore than the old one, but > do agree with Marc about the new font used on - I assume > this is due to the removal of "font-family: arial;" from > BLOCKQUOTE.IMPORTANT. It's the line-height that makes things look funny. How about something that makes Important notes stand out a bit like this version? http://people.freebsd.org/~keramida/bsd-css/2008.11.10/install-pre.html The changes to the `blockquote.IMPORTANT' class are: * Remove `color: red', `font-family: arial', `font-weight: bold' and the custom `line-height'. * Add a bit of padding to avoid bumping into any
borders. * Add a red border with a thick left side that highlights the block. This way the font family is the same as the rest of the text and it doesn't look weird if your default sans-serif font is, say, DejaVu instead of Arial :) [ I'm undecided between making .IMPORTANT stand out with a red background and this. A red background seems like something that can hurt my eyes if I stare at it for a long time. This is _different_ that the rest of the .NOTE, .EXAMPLE and so on. ] From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 17:31:47 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 51E97106567E for ; Mon, 10 Nov 2008 17:31:47 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from rn-out-0910.google.com (rn-out-0910.google.com [64.233.170.184]) by mx1.freebsd.org (Postfix) with ESMTP id B917E8FC0A for ; Mon, 10 Nov 2008 17:31:46 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by rn-out-0910.google.com with SMTP id j71so1831980rne.12 for ; Mon, 10 Nov 2008 09:31:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to :subject:cc:in-reply-to:mime-version:content-type :content-transfer-encoding:content-disposition:references; bh=9pyTR8MeYjr9Wx40sg1qIzcQldUDxA2vMMBXQwxHHIY=; b=Mr2oXAE9sVdqDUp9k5AlHCVPlA136IO9crkDmQkGgTPT+fFgAOHWg6q1H5UzCt/APF 58EkqoxoV7R9iGmXmFIU+2bZlOHjiFiYFXxDRmg7e3Dqsw0mgftKTk1yQ8eZZNQdBiT2 tgpm3M6Yr4whAT25TYuMwsZ1H/53WHvWwtUaI= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version :content-type:content-transfer-encoding:content-disposition :references; b=c4jm229M+7JpjeJ20Srdt5bsTf4TURgdDojAm52ckghNiIVSvUF4DBJe7wt+qrz9aj rJaJeVRS0Dzh6PfyL8MEtVXNCdn47dnRxTB67E8GUnOJmMofqPn+5AaIydAeT8VZmzuu yTWOzql2AHc8YUWTS/gI+GpQGFw3viUSxkFO4= Received: by 10.150.92.13 with SMTP id p13mr10218415ybb.37.1226338305604; Mon, 10 Nov 2008 09:31:45 -0800 (PST) Received: by 10.150.206.6 with HTTP; Mon, 10 Nov 2008 09:31:45 -0800 (PST) Message-ID: Date: Mon, 10 Nov 2008 18:31:45 +0100 From: "Rene Ladan" To: "Giorgos Keramidas" In-Reply-To: <87fxlza3tj.fsf@kobe.laptop> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> <87hc6gbz3t.fsf@kobe.laptop> <20081109192507.GB1030@gothic.blackend.org> <87k5bc4ovw.fsf@kobe.laptop> <1226311326.84196.1.camel@buffy.york.ac.uk> <87fxlza3tj.fsf@kobe.laptop> Cc: cvs-doc@freebsd.org, freebsd-doc@freebsd.org, Gavin Atkinson , doc-committers@freebsd.org, Chin-San Huang Subject: Re: cvs commit: doc/share/misc docbook.css 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, 10 Nov 2008 17:31:47 -0000 2008/11/10 Giorgos Keramidas : > On Mon, 10 Nov 2008 10:02:06 +0000, Gavin Atkinson wrote: >>On Sun, 2008-11-09 at 22:37 +0200, Giorgos Keramidas wrote: >>>On Sun, 9 Nov 2008 20:25:07 +0100, Marc Fonvieille wrote: >>>> The new x-config.html is fine for me. >>>> For the new install-pre.html, the way is >>>> rendered looks oldish, maybe using the same scheme as for >>>> might do the trick. >>> >>> The bold red text is kind of `old school' for me too. I'll wait to see >>> if there are flames^W^H err, objections about the rest and update the >>> style too :) >> >> FWIW, I like the look of the new style sheet nore than the old one, but >> do agree with Marc about the new font used on - I assume >> this is due to the removal of "font-family: arial;" from >> BLOCKQUOTE.IMPORTANT. > > It's the line-height that makes things look funny. How about something > that makes Important notes stand out a bit like this version? > > http://people.freebsd.org/~keramida/bsd-css/2008.11.10/install-pre.html > > The changes to the `blockquote.IMPORTANT' class are: > > * Remove `color: red', `font-family: arial', `font-weight: bold' and > the custom `line-height'. > > * Add a bit of padding to avoid bumping into any
borders. > > * Add a red border with a thick left side that highlights the block. > > This way the font family is the same as the rest of the text and it > doesn't look weird if your default sans-serif font is, say, DejaVu > instead of Arial :) > > [ I'm undecided between making .IMPORTANT stand out with a red > background and this. A red background seems like something that can > hurt my eyes if I stare at it for a long time. This is _different_ that > the rest of the .NOTE, .EXAMPLE and so on. ] > > The result looks reasonable to me. I would not use an entirely red background for the warnings: they scream too much that way. I wonder if there are any standards on text formatting... Regards, Rene -- http://www.rene-ladan.nl/ GPG fingerprint = E738 5471 D185 7013 0EE0 4FC8 3C1D 6F83 12E1 84F6 (subkeys.pgp.net) From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 18:33:34 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 58A4E1065679 for ; Mon, 10 Nov 2008 18:33:34 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id B0D8D8FC1D for ; Mon, 10 Nov 2008 18:33:33 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (adsl58-130.kln.forthnet.gr [77.49.185.130]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mAAIXOWi011736 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 10 Nov 2008 20:33:29 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mAAIXNIu010085; Mon, 10 Nov 2008 20:33:23 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mAAIXMPM010084; Mon, 10 Nov 2008 20:33:22 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: "Rene Ladan" References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> <87hc6gbz3t.fsf@kobe.laptop> <20081109192507.GB1030@gothic.blackend.org> <87k5bc4ovw.fsf@kobe.laptop> <1226311326.84196.1.camel@buffy.york.ac.uk> <87fxlza3tj.fsf@kobe.laptop> Date: Mon, 10 Nov 2008 20:33:22 +0200 In-Reply-To: (Rene Ladan's message of "Mon, 10 Nov 2008 18:31:45 +0100") Message-ID: <87fxlz4ej1.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-MailScanner-ID: mAAIXOWi011736 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.305, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.09, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org Subject: Re: cvs commit: doc/share/misc docbook.css 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, 10 Nov 2008 18:33:34 -0000 CC list trimmed a bit. This is freebsd-doc material, AFAICT. On Mon, 10 Nov 2008 18:31:45 +0100, "Rene Ladan" wrote: >2008/11/10 Giorgos Keramidas : >> [ I'm undecided between making .IMPORTANT stand out with a red >> background and this. A red background seems like something that can >> hurt my eyes if I stare at it for a long time. This is _different_ that >> the rest of the .NOTE, .EXAMPLE and so on. ] > > The result looks reasonable to me. I would not use an entirely red background > for the warnings: they scream too much that way. Right. That's what I thought too :) > I wonder if there are any standards on text formatting... CSS formatting or just text formatting in general, including styles for print output? From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 19:14:47 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C95D9106567D; Mon, 10 Nov 2008 19:14:47 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.189]) by mx1.freebsd.org (Postfix) with ESMTP id 2518C8FC1B; Mon, 10 Nov 2008 19:14:46 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by nf-out-0910.google.com with SMTP id h3so1246954nfh.33 for ; Mon, 10 Nov 2008 11:14:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :x-enigmail-version:content-type:content-transfer-encoding; bh=RFiqrYBfmYiMuQl6ATBnAX3TnWll5rVzE7AyrPpeOYM=; b=Fu034ksrrM/0kJDLwaiTWuYjU7n+HPF2F5CM/AYlqokhG7tfTwQRk65/UWAwmjRpg2 EhW6AJuRU+JzFjKsR+Nc99cSQA452hhcgf4n2n30X94WDwVZCk2VZj6GlDOj2IKw6Bgr 78G9NoJG85kuVC86OWAaxFbSgU/GsV/S+2/iI= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; b=sHSXYl5PeSu+/iBlWD2r+PT/jKJxJza+/44vdrXClYa3Vb3usdubRxT/L+gAOiHrks JwC97x/fF412COsLUFvjEdHfmIiZop3KQ2SIoZejJ9nyjrj1g0YDrdtZ0Yj4IjgOhwM7 KVM0xRoMatUb9fwKqIB4slTB2R3y0Ns+Ks5U0= Received: by 10.210.113.16 with SMTP id l16mr7288073ebc.91.1226344485438; Mon, 10 Nov 2008 11:14:45 -0800 (PST) Received: from self.rene-ladan.nl ([77.163.174.49]) by mx.google.com with ESMTPS id c24sm1176136ika.11.2008.11.10.11.14.43 (version=TLSv1/SSLv3 cipher=RC4-MD5); Mon, 10 Nov 2008 11:14:44 -0800 (PST) Message-ID: <49188822.60400@gmail.com> Date: Mon, 10 Nov 2008 20:14:42 +0100 From: Rene Ladan User-Agent: Thunderbird 2.0.0.17 (X11/20080927) MIME-Version: 1.0 To: Giorgos Keramidas References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> <87hc6gbz3t.fsf@kobe.laptop> <20081109192507.GB1030@gothic.blackend.org> <87k5bc4ovw.fsf@kobe.laptop> <1226311326.84196.1.camel@buffy.york.ac.uk> <87fxlza3tj.fsf@kobe.laptop> <87fxlz4ej1.fsf@kobe.laptop> In-Reply-To: <87fxlz4ej1.fsf@kobe.laptop> X-Enigmail-Version: 0.95.6 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@freebsd.org Subject: Re: cvs commit: doc/share/misc docbook.css 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, 10 Nov 2008 19:14:47 -0000 Giorgos Keramidas schreef: > CC list trimmed a bit. This is freebsd-doc material, AFAICT. > > On Mon, 10 Nov 2008 18:31:45 +0100, "Rene Ladan" wrote: >> 2008/11/10 Giorgos Keramidas : >>> [ I'm undecided between making .IMPORTANT stand out with a red >>> background and this. A red background seems like something that can >>> hurt my eyes if I stare at it for a long time. This is _different_ that >>> the rest of the .NOTE, .EXAMPLE and so on. ] >> The result looks reasonable to me. I would not use an entirely red background >> for the warnings: they scream too much that way. > > Right. That's what I thought too :) > We could make warnings all red and add some arrows in 5 colors pointing to them :-p >> I wonder if there are any standards on text formatting... > > CSS formatting or just text formatting in general, including styles for > print output? > (Printed) Text formatting in general. Regards, Rene -- http://www.rene-ladan.nl/ GPG fingerprint = E738 5471 D185 7013 0EE0 4FC8 3C1D 6F83 12E1 84F6 (subkeys.pgp.net) From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 20:24:44 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C7C611065670 for ; Mon, 10 Nov 2008 20:24:44 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id 39B648FC12 for ; Mon, 10 Nov 2008 20:24:43 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (adsl58-130.kln.forthnet.gr [77.49.185.130]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mAAKOZ5f019402 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 10 Nov 2008 22:24:41 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mAAKOZDk010957; Mon, 10 Nov 2008 22:24:35 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mAAKOZxR010956; Mon, 10 Nov 2008 22:24:35 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Rene Ladan References: <200811090424.mA94OlN6087438@repoman.freebsd.org> <20081109084551.GB1058@gothic.blackend.org> <87hc6gbz3t.fsf@kobe.laptop> <20081109192507.GB1030@gothic.blackend.org> <87k5bc4ovw.fsf@kobe.laptop> <1226311326.84196.1.camel@buffy.york.ac.uk> <87fxlza3tj.fsf@kobe.laptop> <87fxlz4ej1.fsf@kobe.laptop> <49188822.60400@gmail.com> Date: Mon, 10 Nov 2008 22:24:35 +0200 In-Reply-To: <49188822.60400@gmail.com> (Rene Ladan's message of "Mon, 10 Nov 2008 20:14:42 +0100") Message-ID: <87iqqvs518.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-MailScanner-ID: mAAKOZ5f019402 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.304, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.10, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org Subject: Re: cvs commit: doc/share/misc docbook.css 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, 10 Nov 2008 20:24:44 -0000 On Mon, 10 Nov 2008 20:14:42 +0100, Rene Ladan wrote: >Giorgos Keramidas schreef: >>> I wonder if there are any standards on text formatting... >> >> CSS formatting or just text formatting in general, including styles >> for print output? > > (Printed) Text formatting in general. Not `standards' in Internet sense, no. But I have insinuated most of my typesetting experience from tinkering with groff, Texinfo, TeX and LaTeX, and by reading books mentioned in their documentation. From owner-freebsd-doc@FreeBSD.ORG Mon Nov 10 22:20:02 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8EE31106567E for ; Mon, 10 Nov 2008 22:20:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6CEB58FC0C for ; Mon, 10 Nov 2008 22:20:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mAAMK2Jg054349 for ; Mon, 10 Nov 2008 22:20:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mAAMK2Zq054348; Mon, 10 Nov 2008 22:20:02 GMT (envelope-from gnats) Resent-Date: Mon, 10 Nov 2008 22:20:02 GMT Resent-Message-Id: <200811102220.mAAMK2Zq054348@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, Victor Balada Diaz Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 391C41065670 for ; Mon, 10 Nov 2008 22:14:49 +0000 (UTC) (envelope-from victor@bsdes.net) Received: from alf.bsdes.net (244.Red-217-126-240.staticIP.rima-tde.net [217.126.240.244]) by mx1.freebsd.org (Postfix) with ESMTP id E12898FC26 for ; Mon, 10 Nov 2008 22:14:48 +0000 (UTC) (envelope-from victor@bsdes.net) Received: by alf.bsdes.net (Postfix, from userid 1001) id F021D119D91; Mon, 10 Nov 2008 22:58:17 +0100 (CET) Message-Id: <20081110215817.F021D119D91@alf.bsdes.net> Date: Mon, 10 Nov 2008 22:58:17 +0100 (CET) From: Victor Balada Diaz To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/128768: Missing documentation about tmpfs mount options X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Victor Balada Diaz List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 10 Nov 2008 22:20:02 -0000 >Number: 128768 >Category: docs >Synopsis: Missing documentation about tmpfs mount options >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 Nov 10 22:20:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Victor Balada Diaz >Release: FreeBSD 7.1-BETA2 amd64 >Organization: >Environment: FreeBSD 7.1 -BETA2 amd64 >Description: tmpfs have mount options that should be documented in mount(8). This options are uid, gid, size, owner, inodes, mode. You can find a detailed description of what they do in: http://netbsd.gw.com/cgi-bin/man-cgi?mount_tmpfs+8+NetBSD-current Also i find weird that FFS man page is no section 7 and tmpfs man page is on section 5. Shouldn't tmpfs be on 4 or 7? >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Nov 12 01:20:54 2008 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AF5741065676 for ; Wed, 12 Nov 2008 01:20:54 +0000 (UTC) (envelope-from webmaster@psy.miami.edu) Received: from daemonite.psy.miami.edu (daemonite.psy.miami.edu [129.171.236.11]) by mx1.freebsd.org (Postfix) with ESMTP id 93A818FC13 for ; Wed, 12 Nov 2008 01:20:54 +0000 (UTC) (envelope-from webmaster@psy.miami.edu) Received: from [129.171.236.60] (dandelion [129.171.236.60]) by daemonite.psy.miami.edu (Postfix) with ESMTP id 370D524AAB5 for ; Tue, 11 Nov 2008 20:05:29 -0500 (EST) Message-ID: <491A2B3D.5050107@psy.miami.edu> Date: Tue, 11 Nov 2008 20:02:53 -0500 From: Webmaster User-Agent: Thunderbird 1.5 (X11/20060419) MIME-Version: 1.0 To: doc@FreeBSD.org Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Subject: relevance of FreeBSD From Scratch 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: Wed, 12 Nov 2008 01:20:54 -0000 Jens, I am getting ready to utilize your scripts for FreeBSD from scratch. I just wondered whether you are still installing/upgrading your systems with these scripts for FreeBSD 7 releases or if there is something cooler you have moved onto. Any tips would be appreciated. Thanks, Derek From owner-freebsd-doc@FreeBSD.ORG Wed Nov 12 01:30:01 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C57861065676 for ; Wed, 12 Nov 2008 01:30:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id A5C848FC18 for ; Wed, 12 Nov 2008 01:30:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mAC1U1fo011178 for ; Wed, 12 Nov 2008 01:30:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mAC1U1hr011177; Wed, 12 Nov 2008 01:30:01 GMT (envelope-from gnats) Resent-Date: Wed, 12 Nov 2008 01:30:01 GMT Resent-Message-Id: <200811120130.mAC1U1hr011177@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, Winder Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CD940106567A for ; Wed, 12 Nov 2008 01:21:55 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id C04A88FC12 for ; Wed, 12 Nov 2008 01:21:55 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id mAC1LtYQ082840 for ; Wed, 12 Nov 2008 01:21:55 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id mAC1LtSF082839; Wed, 12 Nov 2008 01:21:55 GMT (envelope-from nobody) Message-Id: <200811120121.mAC1LtSF082839@www.freebsd.org> Date: Wed, 12 Nov 2008 01:21:55 GMT From: Winder To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/128804: Gmirror handbook instructions convert boot-drive to gmirror, truncating last sector 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: Wed, 12 Nov 2008 01:30:01 -0000 >Number: 128804 >Category: docs >Synopsis: Gmirror handbook instructions convert boot-drive to gmirror, truncating last sector >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Nov 12 01:30:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Winder >Release: 7.1-PRERELEASE >Organization: >Environment: FreeBSD DEV2 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #3: Fri Nov 7 19:54:41 MST 2008 windrider@DEV2:/usr/obj/usr/src/sys/packetcheckv1-fileserv amd64 >Description: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-mirror.html This geom mirroring documentation shows a way to convert the boot drive into a gmirror raid. This guide misleads in assuming your whole drive has not been used. The problem is that gmirror truncates the last sector of the drive for metadata; thus, any data stored in that sector when adding the drive into the RAID is lost. Sysinstall uses the entire drive by default. Following these instructions, then, could cause loss of data or a corrupt partition, as it will reach one sector beyond the end of the geom mirror device. mightn't it be better to make an example from a blank disk? >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Nov 12 08:00:12 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9CD371065672 for ; Wed, 12 Nov 2008 08:00:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 8F61D8FC14 for ; Wed, 12 Nov 2008 08:00:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mAC80CbV038382 for ; Wed, 12 Nov 2008 08:00:12 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mAC80Cm2038380; Wed, 12 Nov 2008 08:00:12 GMT (envelope-from gnats) Date: Wed, 12 Nov 2008 08:00:12 GMT Message-Id: <200811120800.mAC80Cm2038380@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Tom Rhodes Cc: Subject: Re: docs/128804: Gmirror handbook instructions convert boot-drive to gmirror, truncating last sector X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Tom Rhodes List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 12 Nov 2008 08:00:12 -0000 The following reply was made to PR docs/128804; it has been noted by GNATS. From: Tom Rhodes To: Winder Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/128804: Gmirror handbook instructions convert boot-drive to gmirror, truncating last sector Date: Wed, 12 Nov 2008 02:18:59 -0500 On Wed, 12 Nov 2008 01:21:55 GMT Winder wrote: Hi, > > >Number: 128804 > >Category: docs > >Synopsis: Gmirror handbook instructions convert boot-drive to gmirror, truncating last sector > >Confidential: no > >Severity: non-critical > >Priority: medium > >Responsible: freebsd-doc > >State: open > >Quarter: > >Keywords: > >Date-Required: > >Class: doc-bug > >Submitter-Id: current-users > >Arrival-Date: Wed Nov 12 01:30:01 UTC 2008 > >Closed-Date: > >Last-Modified: > >Originator: Winder > >Release: 7.1-PRERELEASE > >Organization: > >Environment: > FreeBSD DEV2 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #3: Fri Nov 7 19:54:41 MST 2008 windrider@DEV2:/usr/obj/usr/src/sys/packetcheckv1-fileserv amd64 > >Description: > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-mirror.html > > This geom mirroring documentation shows a way to convert the boot drive into a gmirror raid. This guide misleads in assuming your whole drive has not been used. > > The problem is that gmirror truncates the last sector of the drive for metadata; thus, any data stored in that sector when adding the drive into the RAID is lost. Sysinstall uses the entire drive by default. Following these instructions, then, could cause loss of data or a corrupt partition, as it will reach one sector beyond the end of the geom mirror device. > > mightn't it be better to make an example from a blank disk? I would think that converting the disk device to a software RAID, at least the boot disk, would be the way most people wanted to use it. And in most cases, I think that it's one of the first things done during an installation - though, YMMV. If the last sector is filled with user data - there are larger problems, possibly, than just where GEOM places metadata. If you feel a warning is required here, I'll gladly add one, but it never crossed my mind initially that someone would actually be using the last sector on the drive for data. Thanks, -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Wed Nov 12 13:25:27 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 665BD106564A for ; Wed, 12 Nov 2008 13:25:27 +0000 (UTC) (envelope-from fender0107401@gmail.com) Received: from ti-out-0910.google.com (ti-out-0910.google.com [209.85.142.190]) by mx1.freebsd.org (Postfix) with ESMTP id 0373B8FC0A for ; Wed, 12 Nov 2008 13:25:26 +0000 (UTC) (envelope-from fender0107401@gmail.com) Received: by ti-out-0910.google.com with SMTP id a1so262695tib.3 for ; Wed, 12 Nov 2008 05:25:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:subject:from:to:content-type :date:message-id:mime-version:x-mailer; bh=OFIzrp+5PuMWVHCujCHnmIQ+8671Db9xMKWx3iGS1fM=; b=YcSkzyzIAJ9LPb46JvOs9KzHaEFoPysLJ8ncmCBvoFu3kWXRR2Zrpl2Jlma5iVD2v9 n1R3MaoyDcIhTzYzr/xHLUwq+v5domeNK/xUpXl0Ho7QNVbvPnETkt/OTfC5MXhfZtIS wiUOhBzXNUV+KS64jtuYwY225VfKdUJU4/Ges= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=subject:from:to:content-type:date:message-id:mime-version:x-mailer; b=SXwNkXFaCULqnbxvkh8o5j/VROc9ir9G4hvVKMUnuGxhoHf6+fLOoVoSqhu0B7wpTW lRHdl9mhT1ORRWoZlX8r1vz8Nb92yQAt3X+I/AS+u2F+ZbyArRItSOb9WZ7o17KER+0l rB85bkHBuKoThA1BZBLwdw7B4yDX7R/+rzutM= Received: by 10.110.60.2 with SMTP id i2mr11002247tia.28.1226494709917; Wed, 12 Nov 2008 04:58:29 -0800 (PST) Received: from ?192.168.0.250? ([219.243.32.29]) by mx.google.com with ESMTPS id 22sm753958tim.7.2008.11.12.04.58.27 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 12 Nov 2008 04:58:29 -0800 (PST) From: Li To: FreeBSD doc list Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-HlawcShe79KO04fGXXkK" Date: Wed, 12 Nov 2008 20:58:13 +0800 Message-Id: <1226494693.1809.10.camel@localhost> Mime-Version: 1.0 X-Mailer: Evolution 2.22.3.1 FreeBSD GNOME Team Port Cc: Subject: Preface need update. 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: Wed, 12 Nov 2008 13:25:27 -0000 --=-HlawcShe79KO04fGXXkK Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Hello Everyone: I am a FreeBSD fan, and I like reading the . Recently, I note that some new contents(chapter 20 File Systems Support, chapter 25 Dtrace, and chapter 26 Updating FreeBSD) added to the book. But the preface section have not corresponding introduction. http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/book-preface.html fender --=-HlawcShe79KO04fGXXkK Content-Type: application/pgp-signature; name=signature.asc Content-Description: This is a digitally signed message part -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (FreeBSD) iEYEABECAAYFAkka0uUACgkQmVapie7+cWywBACeJpDCYgqGP8/ZFN3asCLozvmM xSkAniFY/MaKEBw4VJ4A8vTPkct5bCkO =5pn+ -----END PGP SIGNATURE----- --=-HlawcShe79KO04fGXXkK-- From owner-freebsd-doc@FreeBSD.ORG Wed Nov 12 13:40:02 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 340A9106568B for ; Wed, 12 Nov 2008 13:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 188B58FC12 for ; Wed, 12 Nov 2008 13:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mACDe1bP095291 for ; Wed, 12 Nov 2008 13:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mACDe1j7095290; Wed, 12 Nov 2008 13:40:01 GMT (envelope-from gnats) Resent-Date: Wed, 12 Nov 2008 13:40:01 GMT Resent-Message-Id: <200811121340.mACDe1j7095290@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, Roland Smith Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E3C7A106567A for ; Wed, 12 Nov 2008 13:30:03 +0000 (UTC) (envelope-from rsmith@xs4all.nl) Received: from smtp-vbr16.xs4all.nl (smtp-vbr16.xs4all.nl [194.109.24.36]) by mx1.freebsd.org (Postfix) with ESMTP id 9BF228FC12 for ; Wed, 12 Nov 2008 13:30:03 +0000 (UTC) (envelope-from rsmith@xs4all.nl) Received: from slackbox.xs4all.nl (slackbox.xs4all.nl [213.84.242.160]) by smtp-vbr16.xs4all.nl (8.13.8/8.13.8) with ESMTP id mACDG24O043668 for ; Wed, 12 Nov 2008 14:16:06 +0100 (CET) (envelope-from rsmith@xs4all.nl) Received: by slackbox.xs4all.nl (Postfix, from userid 1001) id 5B44CBA8A; Wed, 12 Nov 2008 14:15:59 +0100 (CET) Message-Id: <20081112131559.5B44CBA8A@slackbox.xs4all.nl> Date: Wed, 12 Nov 2008 14:15:59 +0100 (CET) From: Roland Smith To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/128816: [PATCH] Enhance the explanation of using of mount options in fstab(5) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Roland Smith List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 12 Nov 2008 13:40:02 -0000 >Number: 128816 >Category: docs >Synopsis: [PATCH] Enhance the explanation of using of mount options in fstab(5) >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Wed Nov 12 13:40:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Roland Smith >Release: FreeBSD 7.1-PRERELEASE amd64 >Organization: >Environment: System: FreeBSD slackbox.xs4all.nl 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #0: Thu Sep 25 16:47:48 CEST 2008 rsmith@slackbox.xs4all.nl:/usr/obj/usr/src/sys/QUADSLACK amd64 >Description: The fstab manual page (and others) imply that only the -o options of different mount commands can be used in fstab. Other flags can be used as well, but this is not documented. >How-To-Repeat: Read fstab(5) >Fix: Apply one of the following patches to /usr/src/share/man/man5/fstab.5. The first patch is against HEAD (r1.30), while the second is against 7.1-PRERELEASE (r1.26). ----- patch for fstab.5 (r1.30) ----- --- fstab.5.orig 2008-11-12 13:32:14.000000000 +0100 +++ fstab.5 2008-11-12 14:02:58.000000000 +0100 @@ -32,7 +32,7 @@ .\" @(#)fstab.5 8.1 (Berkeley) 6/5/93 .\" $FreeBSD: src/share/man/man5/fstab.5,v 1.30 2008/02/11 09:36:43 mpp Exp $ .\" -.Dd February 11, 2008 +.Dd November 12, 2008 .Dt FSTAB 5 .Os .Sh NAME @@ -91,15 +91,29 @@ It is formatted as a comma separated list of options. It contains at least the type of mount (see .Fa fs_type -below) plus any additional options -appropriate to the file system type. +below) plus any additional options appropriate to the file system type. See the options flag .Pq Fl o in the .Xr mount 8 page and the file system specific page, such as .Xr mount_nfs 8 , -for additional options that may be specified. +for additional options that may be specified. All options that can be given +to the file system specific mount commands can be used in +.Nm +as well. They just need to be formatted differently. The arguments of the +.Fl o +option can be used without the preceding +.Fl o +flag. Other options need the flag and its argument separated by an equal +sign. So for e.g. mounting an +.Xr msdosfs 5 +filesystem, the options +.Dq -o sync -o noatime -m 644 -M 755 -u foo -g bar +on the command-line become +.Dq sync,noatime,-m=644,-M=755,-u=foo,-g=bar +in +.Nm . .Pp If the options ``userquota'' and/or ``groupquota'' are specified, the file system is automatically processed by the ----- patch for fstab.5 (r1.30) ----- ----- patch for fstab.5 (r1.26) ----- --- fstab.5.orig 2008-11-12 14:09:39.000000000 +0100 +++ fstab.5 2008-11-12 14:10:53.000000000 +0100 @@ -32,7 +32,7 @@ .\" @(#)fstab.5 8.1 (Berkeley) 6/5/93 .\" $FreeBSD: src/share/man/man5/fstab.5,v 1.26 2004/07/03 18:29:22 ru Exp $ .\" -.Dd June 5, 1993 +.Dd November 12, 2008 .Dt FSTAB 5 .Os .Sh NAME @@ -98,15 +98,29 @@ It is formatted as a comma separated list of options. It contains at least the type of mount (see .Fa fs_type -below) plus any additional options -appropriate to the file system type. +below) plus any additional options appropriate to the file system type. See the options flag .Pq Fl o in the .Xr mount 8 page and the file system specific page, such as .Xr mount_nfs 8 , -for additional options that may be specified. +for additional options that may be specified. All options that can be given +to the file system specific mount commands can be used in +.Nm +as well. They just need to be formatted differently. The arguments of the +.Fl o +option can be used without the preceding +.Fl o +flag. Other options need the flag and its argument separated by an equal +sign. So for e.g. mounting an +.Xr msdosfs 5 +filesystem, the options +.Dq -o sync -o noatime -m 644 -M 755 -u foo -g bar +on the command-line become +.Dq sync,noatime,-m=644,-M=755,-u=foo,-g=bar +in +.Nm . .Pp If the options ``userquota'' and/or ``groupquota'' are specified, the file system is automatically processed by the ----- patch for fstab.5 (r1.26) ----- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Nov 12 15:16:37 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C25471065673 for ; Wed, 12 Nov 2008 15:16:37 +0000 (UTC) (envelope-from fbsdlists@gmail.com) Received: from yw-out-2324.google.com (yw-out-2324.google.com [74.125.46.28]) by mx1.freebsd.org (Postfix) with ESMTP id 7EC4E8FC1B for ; Wed, 12 Nov 2008 15:16:37 +0000 (UTC) (envelope-from fbsdlists@gmail.com) Received: by yw-out-2324.google.com with SMTP id 9so183634ywe.13 for ; Wed, 12 Nov 2008 07:16:36 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to :subject:cc:in-reply-to:mime-version:content-type :content-transfer-encoding:content-disposition:references; bh=bn6QCRQgQ/6F58sCPdbRzDuMh2H2VG69rbHSddqdZCU=; b=lp2FMpIQe+L9yMO1oGeD5r1Ivz6cQd8l+cKB5TIPkBxz3MLBeRyQDCITOMmS8jBhoI lbkJWdIIkULary65xMZise8buoX4sIq0lXay0HfJsixfdKunavuA5HynCwOyglf535kk eiB8cHeYzkXzzw3LxH6I41fybOSxt3lE51uTk= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version :content-type:content-transfer-encoding:content-disposition :references; b=VIHz7X4/JAaBOqapUSYcpYXsxs9eHHvYZqsWItc03l2aUncxrsshRxPY8/Rs8zq0Oi 3i2knuX3OU4wPLAdLbiM3IxAW8qT1PbWQ0gFpeRXj/oNapeY1XwOW7Iythl5L4q81izK i/qFEOBAB7GRmkVOLiFmFiXD7/odcQbaOFCKM= Received: by 10.90.30.2 with SMTP id d2mr8274812agd.58.1226501689536; Wed, 12 Nov 2008 06:54:49 -0800 (PST) Received: by 10.90.101.15 with HTTP; Wed, 12 Nov 2008 06:54:49 -0800 (PST) Message-ID: <54db43990811120654l213596f1j844c3f185c3eb577@mail.gmail.com> Date: Wed, 12 Nov 2008 09:54:49 -0500 From: "Bob Johnson" To: "Tom Rhodes" In-Reply-To: <200811120800.mAC80Cm2038380@freefall.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <200811120800.mAC80Cm2038380@freefall.freebsd.org> Cc: freebsd-doc@freebsd.org Subject: Re: docs/128804: Gmirror handbook instructions convert boot-drive to gmirror, truncating last sector 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: Wed, 12 Nov 2008 15:16:37 -0000 The user has no control over whether the last sector of the drive is used for data. Data is scattered all over the drive, in something that resembles a random fashion, and I know of no reason the last sector is not just as likely to have data stored to it as any other sector on the drive (but I am certainly not an authority on the filesystem algorithms). I think a warning is very much in order (that there is a small chance that data will be lost by this procedure). - Bob On 11/12/08, Tom Rhodes wrote: > The following reply was made to PR docs/128804; it has been noted by GNATS. > > From: Tom Rhodes > To: Winder > Cc: freebsd-gnats-submit@FreeBSD.org > Subject: Re: docs/128804: Gmirror handbook instructions convert boot-drive > to gmirror, truncating last sector > Date: Wed, 12 Nov 2008 02:18:59 -0500 > > On Wed, 12 Nov 2008 01:21:55 GMT > Winder wrote: > > Hi, > > > > > > >Number: 128804 > > >Category: docs > > >Synopsis: Gmirror handbook instructions convert boot-drive to > gmirror, truncating last sector > > >Confidential: no > > >Severity: non-critical > > >Priority: medium > > >Responsible: freebsd-doc > > >State: open > > >Quarter: > > >Keywords: > > >Date-Required: > > >Class: doc-bug > > >Submitter-Id: current-users > > >Arrival-Date: Wed Nov 12 01:30:01 UTC 2008 > > >Closed-Date: > > >Last-Modified: > > >Originator: Winder > > >Release: 7.1-PRERELEASE > > >Organization: > > >Environment: > > FreeBSD DEV2 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #3: Fri Nov 7 > 19:54:41 MST 2008 > windrider@DEV2:/usr/obj/usr/src/sys/packetcheckv1-fileserv amd64 > > >Description: > > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-mirror.html > > > > This geom mirroring documentation shows a way to convert the boot drive > into a gmirror raid. This guide misleads in assuming your whole drive has > not been used. > > > > The problem is that gmirror truncates the last sector of the drive for > metadata; thus, any data stored in that sector when adding the drive into > the RAID is lost. Sysinstall uses the entire drive by default. Following > these instructions, then, could cause loss of data or a corrupt partition, > as it will reach one sector beyond the end of the geom mirror device. > > > > mightn't it be better to make an example from a blank disk? > > I would think that converting the disk device to a software > RAID, at least the boot disk, would be the way most people > wanted to use it. And in most cases, I think that it's one > of the first things done during an installation - though, > YMMV. If the last sector is filled with user data - there > are larger problems, possibly, than just where GEOM places > metadata. > > If you feel a warning is required here, I'll gladly add one, > but it never crossed my mind initially that someone would > actually be using the last sector on the drive for data. > > Thanks, > > -- > Tom Rhodes > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > -- -- Bob Johnson fbsdlists@gmail.com From owner-freebsd-doc@FreeBSD.ORG Wed Nov 12 16:13:23 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E2307106564A for ; Wed, 12 Nov 2008 16:13:23 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.190]) by mx1.freebsd.org (Postfix) with ESMTP id 764208FC13 for ; Wed, 12 Nov 2008 16:13:23 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by nf-out-0910.google.com with SMTP id h3so360821nfh.33 for ; Wed, 12 Nov 2008 08:13:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=yWv1p3D9PprGCI8D/xZ/Meg0S0XBtAFpzwhaPEIjlsw=; b=gl4VE94XWVEaIfkafe19uuGcDW477aqqLxEZsK4srRNDEind3ZFATMo2MpCJ4eMZck y4s9j9SgS6xzeqrzAoxbkfj9yNRvZ6WBDA1KOVyeZAu14bUnZc/GvDZ7AUZGPebZaJqj QxUDjjXbDqodfu5GZiS+Yz1vJHnAztq+dSs/Y= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=n21odDRKnESDEdruaP1Au43y6pekhgsIoPqYN7eilDMC8DNi73OM6BeX1EcdtnXoXU Pd11HP6Q1V0JGRamJ32HCwFcKDwcwjPVbT6DkW31BG3a4V1u+pMy38MdJUcl9B09A8Yr vV5lgUHCsiSaXLV0T7lOZdCy4JXZnhcOLVE10= Received: by 10.210.49.19 with SMTP id w19mr10474113ebw.149.1226506402112; Wed, 12 Nov 2008 08:13:22 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-4442731.home.otenet.gr [79.129.186.91]) by mx.google.com with ESMTPS id c24sm1165134ika.4.2008.11.12.08.13.20 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 12 Nov 2008 08:13:20 -0800 (PST) Message-ID: <491B009E.8050408@gmail.com> Date: Wed, 12 Nov 2008 18:13:18 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Li References: <1226494693.1809.10.camel@localhost> In-Reply-To: <1226494693.1809.10.camel@localhost> Content-Type: text/plain; charset=ISO-8859-7; format=flowed Content-Transfer-Encoding: 7bit Cc: FreeBSD doc list Subject: Re: Preface need update. 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: Wed, 12 Nov 2008 16:13:24 -0000 Li wrote: > Hello Everyone: > > I am a FreeBSD fan, and I like reading the . > > Recently, I note that some new contents(chapter 20 File Systems Support, > chapter 25 Dtrace, and chapter 26 Updating FreeBSD) added to the book. > > But the preface section have not corresponding introduction. > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/book-preface.html > > fender > You are right, the "Organization of this book" section jumps from chapter 19 to chapter 21 and from 24 to 27, exactly the places of the new chapters. I will try to create a patch for this Thanks! manolis@ From owner-freebsd-doc@FreeBSD.ORG Wed Nov 12 21:47:51 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 6459D1065677 for ; Wed, 12 Nov 2008 21:47:51 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.174]) by mx1.freebsd.org (Postfix) with ESMTP id DFA538FC14 for ; Wed, 12 Nov 2008 21:47:50 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ug-out-1314.google.com with SMTP id 30so1170446ugs.39 for ; Wed, 12 Nov 2008 13:47:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=Ll9Z1dce4PTtTYWl4OyNUqEerefNxqfwdzwIoKGKSRs=; b=FHDj7Xz1NGBgD1pihCB2uCbzg3wH5vIlBNfvMuYjVc6gM6giXHHUQS9s4Qbob3SKg3 iKlpg6grX2frPNup6BR3oBIH2SA2YSxq7NWLAKPBUzQfHZLPReJMnbm2+4sZXS01na4D 0eKL/5cJ/kJuQruTI90zNAeXgF2HWi5CyZQcM= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=Wz0eGJ36ZlrDcn+zQStR8W5Df2e8ldH7aHx/E8fK3KcAlOAqCP9PEnQUwKTVqFWZh+ 1881kDRcrD3jCqwzyy4/btqqsqE7LqaHwI5UQuUsHITfzLMYop2JZWyD40H6OfBt6BCS sCQ66iVKeaTzrZySIOYM6bBwpaQdRJi/D9VLU= Received: by 10.67.115.14 with SMTP id s14mr3755545ugm.57.1226526469218; Wed, 12 Nov 2008 13:47:49 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-4442731.home.otenet.gr [79.129.186.91]) by mx.google.com with ESMTPS id 24sm1780053ugf.36.2008.11.12.13.47.46 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 12 Nov 2008 13:47:47 -0800 (PST) Message-ID: <491B4F01.9020403@gmail.com> Date: Wed, 12 Nov 2008 23:47:45 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Li References: <1226494693.1809.10.camel@localhost> In-Reply-To: <1226494693.1809.10.camel@localhost> Content-Type: text/plain; charset=ISO-8859-7; format=flowed Content-Transfer-Encoding: 7bit Cc: FreeBSD doc list Subject: Re: Preface need update. 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: Wed, 12 Nov 2008 21:47:51 -0000 Li wrote: > Hello Everyone: > > I am a FreeBSD fan, and I like reading the . > > Recently, I note that some new contents(chapter 20 File Systems Support, > chapter 25 Dtrace, and chapter 26 Updating FreeBSD) added to the book. > > But the preface section have not corresponding introduction. > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/book-preface.html > > fender > A fix has just been committed, and will appear on the website in the next 24 hours. Thanks for reporting this! manolis@ From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 00:36:54 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C9D16106567A for ; Thu, 13 Nov 2008 00:36:54 +0000 (UTC) (envelope-from murray@stokely.org) Received: from rv-out-0506.google.com (rv-out-0506.google.com [209.85.198.224]) by mx1.freebsd.org (Postfix) with ESMTP id A7A828FC0C for ; Thu, 13 Nov 2008 00:36:54 +0000 (UTC) (envelope-from murray@stokely.org) Received: by rv-out-0506.google.com with SMTP id b25so613440rvf.43 for ; Wed, 12 Nov 2008 16:36:54 -0800 (PST) Received: by 10.141.86.14 with SMTP id o14mr5164508rvl.233.1226534755161; Wed, 12 Nov 2008 16:05:55 -0800 (PST) Received: by 10.141.151.6 with HTTP; Wed, 12 Nov 2008 16:05:55 -0800 (PST) Message-ID: <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> Date: Wed, 12 Nov 2008 16:05:55 -0800 From: "Murray Stokely" To: "Manolis Kiagias" In-Reply-To: <491B4F01.9020403@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com> Cc: FreeBSD doc list Subject: Re: Preface need update. 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: Thu, 13 Nov 2008 00:36:54 -0000 Thanks Manolis. Maybe we should add a comment to the Makefile so that when authors commit new chapters they remember to also update the preface summary. Or alternatively, we could put some kind of one sentence chapter description in of each chapter and pull it out of each file dynamically when building the preface. I'd probably recommend the low tech first suggestion as good enough. - Murray On Wed, Nov 12, 2008 at 1:47 PM, Manolis Kiagias wrote: > Li wrote: >> >> Hello Everyone: >> >> I am a FreeBSD fan, and I like reading the . >> >> Recently, I note that some new contents(chapter 20 File Systems Support, >> chapter 25 Dtrace, and chapter 26 Updating FreeBSD) added to the book. >> >> But the preface section have not corresponding introduction. >> >> >> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/book-preface.html >> >> fender >> > > A fix has just been committed, and will appear on the website in the next 24 > hours. > > Thanks for reporting this! > manolis@ > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 01:04:58 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AF400106567F; Thu, 13 Nov 2008 01:04:58 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (pittgoth.com [205.134.163.206]) by mx1.freebsd.org (Postfix) with ESMTP id 800138FC17; Thu, 13 Nov 2008 01:04:57 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6]) (authenticated bits=0) by pittgoth.com (8.14.2/8.14.2) with ESMTP id mAD14umj082348 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 12 Nov 2008 20:04:57 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Wed, 12 Nov 2008 20:04:54 -0500 From: Tom Rhodes To: "Bob Johnson" Message-Id: <20081112200454.3ddb9b89.trhodes@FreeBSD.org> In-Reply-To: <54db43990811120654l213596f1j844c3f185c3eb577@mail.gmail.com> References: <200811120800.mAC80Cm2038380@freefall.freebsd.org> <54db43990811120654l213596f1j844c3f185c3eb577@mail.gmail.com> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: trhodes@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/128804: Gmirror handbook instructions convert boot-drive to gmirror, truncating last sector 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: Thu, 13 Nov 2008 01:04:58 -0000 On Wed, 12 Nov 2008 09:54:49 -0500 "Bob Johnson" wrote: > The user has no control over whether the last sector of the drive is > used for data. Data is scattered all over the drive, in something that > resembles a random fashion, and I know of no reason the last sector is > not just as likely to have data stored to it as any other sector on > the drive (but I am certainly not an authority on the filesystem > algorithms). > > I think a warning is very much in order (that there is a small chance > that data will be lost by this procedure). > > - Bob Don't Unix file systems attempt to lump data closer together in order to reduce this fragmentation which scatters data across the entire drive, making it unlikely to have data in that last sector unless one went beyond the 8% boundry? > > > On 11/12/08, Tom Rhodes wrote: > > The following reply was made to PR docs/128804; it has been noted by GNATS. > > > > From: Tom Rhodes > > To: Winder > > Cc: freebsd-gnats-submit@FreeBSD.org > > Subject: Re: docs/128804: Gmirror handbook instructions convert boot-drive > > to gmirror, truncating last sector > > Date: Wed, 12 Nov 2008 02:18:59 -0500 > > > > On Wed, 12 Nov 2008 01:21:55 GMT > > Winder wrote: > > > > Hi, > > > > > > > > > > >Number: 128804 > > > >Category: docs > > > >Synopsis: Gmirror handbook instructions convert boot-drive to > > gmirror, truncating last sector > > > >Confidential: no > > > >Severity: non-critical > > > >Priority: medium > > > >Responsible: freebsd-doc > > > >State: open > > > >Quarter: > > > >Keywords: > > > >Date-Required: > > > >Class: doc-bug > > > >Submitter-Id: current-users > > > >Arrival-Date: Wed Nov 12 01:30:01 UTC 2008 > > > >Closed-Date: > > > >Last-Modified: > > > >Originator: Winder > > > >Release: 7.1-PRERELEASE > > > >Organization: > > > >Environment: > > > FreeBSD DEV2 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #3: Fri Nov 7 > > 19:54:41 MST 2008 > > windrider@DEV2:/usr/obj/usr/src/sys/packetcheckv1-fileserv amd64 > > > >Description: > > > > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-mirror.html > > > > > > This geom mirroring documentation shows a way to convert the boot drive > > into a gmirror raid. This guide misleads in assuming your whole drive has > > not been used. > > > > > > The problem is that gmirror truncates the last sector of the drive for > > metadata; thus, any data stored in that sector when adding the drive into > > the RAID is lost. Sysinstall uses the entire drive by default. Following > > these instructions, then, could cause loss of data or a corrupt partition, > > as it will reach one sector beyond the end of the geom mirror device. > > > > > > mightn't it be better to make an example from a blank disk? > > > > I would think that converting the disk device to a software > > RAID, at least the boot disk, would be the way most people > > wanted to use it. And in most cases, I think that it's one > > of the first things done during an installation - though, > > YMMV. If the last sector is filled with user data - there > > are larger problems, possibly, than just where GEOM places > > metadata. > > > > If you feel a warning is required here, I'll gladly add one, > > but it never crossed my mind initially that someone would > > actually be using the last sector on the drive for data. > > > > Thanks, > > > > -- > > Tom Rhodes > > _______________________________________________ > > freebsd-doc@freebsd.org mailing list > > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > > > > > -- > -- Bob Johnson > fbsdlists@gmail.com > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 01:07:58 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D49011065670 for ; Thu, 13 Nov 2008 01:07:58 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (pittgoth.com [205.134.163.206]) by mx1.freebsd.org (Postfix) with ESMTP id 978128FC17 for ; Thu, 13 Nov 2008 01:07:58 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6]) (authenticated bits=0) by pittgoth.com (8.14.2/8.14.2) with ESMTP id mAD17wuM082372 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 12 Nov 2008 20:07:58 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Wed, 12 Nov 2008 20:07:55 -0500 From: Tom Rhodes To: "Murray Stokely" Message-Id: <20081112200755.66c52a48.trhodes@FreeBSD.org> In-Reply-To: <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com> <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org Subject: Re: Preface need update. 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: Thu, 13 Nov 2008 01:07:58 -0000 On Wed, 12 Nov 2008 16:05:55 -0800 "Murray Stokely" wrote: > Thanks Manolis. Maybe we should add a comment to the Makefile so that > when authors commit new chapters they remember to also update the > preface summary. Or alternatively, we could put some kind of one > sentence chapter description in of each chapter and pull > it out of each file dynamically when building the preface. I'd > probably recommend the low tech first suggestion as good enough. > > - Murray Yea, because I forget this every time I add a new chapter. :( > > On Wed, Nov 12, 2008 at 1:47 PM, Manolis Kiagias wrote: > > Li wrote: > >> > >> Hello Everyone: > >> > >> I am a FreeBSD fan, and I like reading the . > >> > >> Recently, I note that some new contents(chapter 20 File Systems Support, > >> chapter 25 Dtrace, and chapter 26 Updating FreeBSD) added to the book. > >> > >> But the preface section have not corresponding introduction. > >> > >> > >> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/book-preface.html > >> > >> fender > >> > > > > A fix has just been committed, and will appear on the website in the next 24 > > hours. > > > > Thanks for reporting this! > > manolis@ > > _______________________________________________ > > freebsd-doc@freebsd.org mailing list > > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > > > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 03:04:43 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 90A1F106568C; Thu, 13 Nov 2008 03:04:43 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (pittgoth.com [205.134.163.206]) by mx1.freebsd.org (Postfix) with ESMTP id 6044C8FC13; Thu, 13 Nov 2008 03:04:43 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6]) (authenticated bits=0) by pittgoth.com (8.14.2/8.14.2) with ESMTP id mAD34b9e082753 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 12 Nov 2008 22:04:37 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Wed, 12 Nov 2008 22:04:31 -0500 From: Tom Rhodes To: Tom Rhodes Message-Id: <20081112220431.3e451c3e.trhodes@FreeBSD.org> In-Reply-To: <20081112200454.3ddb9b89.trhodes@FreeBSD.org> References: <200811120800.mAC80Cm2038380@freefall.freebsd.org> <54db43990811120654l213596f1j844c3f185c3eb577@mail.gmail.com> <20081112200454.3ddb9b89.trhodes@FreeBSD.org> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/128804: Gmirror handbook instructions convert boot-drive to gmirror, truncating last sector 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: Thu, 13 Nov 2008 03:04:43 -0000 On Wed, 12 Nov 2008 20:04:54 -0500 Tom Rhodes wrote: > On Wed, 12 Nov 2008 09:54:49 -0500 > "Bob Johnson" wrote: > > > The user has no control over whether the last sector of the drive is > > used for data. Data is scattered all over the drive, in something that > > resembles a random fashion, and I know of no reason the last sector is > > not just as likely to have data stored to it as any other sector on > > the drive (but I am certainly not an authority on the filesystem > > algorithms). > > > > I think a warning is very much in order (that there is a small chance > > that data will be lost by this procedure). > > > > - Bob > > > Don't Unix file systems attempt to lump data closer together > in order to reduce this fragmentation which scatters data > across the entire drive, making it unlikely to have data in > that last sector unless one went beyond the 8% boundry? Sorry, I really hope this didn't come off as rude. While I know the user has no control over where data is stored on the hard disk, I would also assume a warning about this to be in the manual page as well. It's very possible that the metadata is stored in a location not touchable by a filesystem. Thus, I have sent an email to Pawel for further examination. Thanks, > > > > > > > > On 11/12/08, Tom Rhodes wrote: > > > The following reply was made to PR docs/128804; it has been noted by GNATS. > > > > > > From: Tom Rhodes > > > To: Winder > > > Cc: freebsd-gnats-submit@FreeBSD.org > > > Subject: Re: docs/128804: Gmirror handbook instructions convert boot-drive > > > to gmirror, truncating last sector > > > Date: Wed, 12 Nov 2008 02:18:59 -0500 > > > > > > On Wed, 12 Nov 2008 01:21:55 GMT > > > Winder wrote: > > > > > > Hi, > > > > > > > > > > > > > > >Number: 128804 > > > > >Category: docs > > > > >Synopsis: Gmirror handbook instructions convert boot-drive to > > > gmirror, truncating last sector > > > > >Confidential: no > > > > >Severity: non-critical > > > > >Priority: medium > > > > >Responsible: freebsd-doc > > > > >State: open > > > > >Quarter: > > > > >Keywords: > > > > >Date-Required: > > > > >Class: doc-bug > > > > >Submitter-Id: current-users > > > > >Arrival-Date: Wed Nov 12 01:30:01 UTC 2008 > > > > >Closed-Date: > > > > >Last-Modified: > > > > >Originator: Winder > > > > >Release: 7.1-PRERELEASE > > > > >Organization: > > > > >Environment: > > > > FreeBSD DEV2 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #3: Fri Nov 7 > > > 19:54:41 MST 2008 > > > windrider@DEV2:/usr/obj/usr/src/sys/packetcheckv1-fileserv amd64 > > > > >Description: > > > > > > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/geom-mirror.html > > > > > > > > This geom mirroring documentation shows a way to convert the boot drive > > > into a gmirror raid. This guide misleads in assuming your whole drive has > > > not been used. > > > > > > > > The problem is that gmirror truncates the last sector of the drive for > > > metadata; thus, any data stored in that sector when adding the drive into > > > the RAID is lost. Sysinstall uses the entire drive by default. Following > > > these instructions, then, could cause loss of data or a corrupt partition, > > > as it will reach one sector beyond the end of the geom mirror device. > > > > > > > > mightn't it be better to make an example from a blank disk? > > > > > > I would think that converting the disk device to a software > > > RAID, at least the boot disk, would be the way most people > > > wanted to use it. And in most cases, I think that it's one > > > of the first things done during an installation - though, > > > YMMV. If the last sector is filled with user data - there > > > are larger problems, possibly, than just where GEOM places > > > metadata. > > > > > > If you feel a warning is required here, I'll gladly add one, > > > but it never crossed my mind initially that someone would > > > actually be using the last sector on the drive for data. > > > > > > Thanks, > > > > > > -- > > > Tom Rhodes > > > _______________________________________________ > > > freebsd-doc@freebsd.org mailing list > > > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > > > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > > > > > > > > > -- > > -- Bob Johnson > > fbsdlists@gmail.com > > _______________________________________________ > > freebsd-doc@freebsd.org mailing list > > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > > > > > -- > Tom Rhodes > -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 04:13:33 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 879D3106567A for ; Thu, 13 Nov 2008 04:13:33 +0000 (UTC) (envelope-from fender0107401@gmail.com) Received: from ti-out-0910.google.com (ti-out-0910.google.com [209.85.142.184]) by mx1.freebsd.org (Postfix) with ESMTP id 19E338FC13 for ; Thu, 13 Nov 2008 04:13:32 +0000 (UTC) (envelope-from fender0107401@gmail.com) Received: by ti-out-0910.google.com with SMTP id a1so407242tib.3 for ; Wed, 12 Nov 2008 20:13:31 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:subject:from:to:cc :in-reply-to:references:content-type:date:message-id:mime-version :x-mailer; bh=rgDQ8iK6FUrVCZp42xXEB2skNm3dWXRFXJxFc8uQH3c=; b=D6jagXx1x8/cDSG899uhAdIeS1ElgI2qD9EHjB1ZCjHRzj+Vi+UZA6XsiZle4ku6o8 eulS/qWl98J7AwWlrQuLZb/WsCwyzVLDnGWdGgmIW2qjkvQDpc3CENBgZ4nH3LO6rHp+ N/jKbyMl/F4CFoTwvAfGERI/g+rkZJi5rXsus= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=subject:from:to:cc:in-reply-to:references:content-type:date :message-id:mime-version:x-mailer; b=QATAvdQgXGovP4mWp9x5uZ6ZCpa7c3m6tMIBfpJCp+/wzw4nHkmzcm9i93+Yp4hdjE qcEF7Fk+dLBayAMTU6+IPieFgOG9RdxDSZwWOCLwmGIn01w6FXHXq9GW+C1icULi2uAC HQLCK+G7+WCK3/9fNed8SLXnz0Q3pz4I180dc= Received: by 10.110.42.17 with SMTP id p17mr946043tip.40.1226549611596; Wed, 12 Nov 2008 20:13:31 -0800 (PST) Received: from ?192.168.0.250? ([219.243.32.29]) by mx.google.com with ESMTPS id i6sm2855516tid.5.2008.11.12.20.13.27 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 12 Nov 2008 20:13:30 -0800 (PST) From: Li To: Manolis Kiagias In-Reply-To: <491B009E.8050408@gmail.com> References: <1226494693.1809.10.camel@localhost> <491B009E.8050408@gmail.com> Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-Bo4f8eCEezEOpmNwjUV9" Date: Thu, 13 Nov 2008 12:13:20 +0800 Message-Id: <1226549600.1571.2.camel@localhost> Mime-Version: 1.0 X-Mailer: Evolution 2.22.3.1 FreeBSD GNOME Team Port Cc: FreeBSD doc list Subject: Re: Preface need update. 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: Thu, 13 Nov 2008 04:13:33 -0000 --=-Bo4f8eCEezEOpmNwjUV9 Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Thank you very much for the reply, I will see it. :)=20 fender On Wed, 2008-11-12 at 18:13 +0200, Manolis Kiagias wrote: > Li wrote: > > Hello Everyone: > > > > I am a FreeBSD fan, and I like reading the . > > > > Recently, I note that some new contents(chapter 20 File Systems Support= , > > chapter 25 Dtrace, and chapter 26 Updating FreeBSD) added to the book. > > > > But the preface section have not corresponding introduction. > > > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/book-preface.= html > > > > fender > > =20 > You are right, the "Organization of this book" section jumps from=20 > chapter 19 to chapter 21 and from 24 to 27, exactly the places of the=20 > new chapters. > I will try to create a patch for this >=20 > Thanks! >=20 > manolis@ --=-Bo4f8eCEezEOpmNwjUV9 Content-Type: application/pgp-signature; name=signature.asc Content-Description: This is a digitally signed message part -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (FreeBSD) iEYEABECAAYFAkkbqWAACgkQmVapie7+cWwYcwCffKslARxkXGpnKqZ0VtbHxNV7 rPQAn0LPvOjA7vKLxhtAm+u71PcZMREv =G0Ct -----END PGP SIGNATURE----- --=-Bo4f8eCEezEOpmNwjUV9-- From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 06:18:04 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 903FB10656A8 for ; Thu, 13 Nov 2008 06:18:04 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.175]) by mx1.freebsd.org (Postfix) with ESMTP id 141F18FC08 for ; Thu, 13 Nov 2008 06:18:03 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ug-out-1314.google.com with SMTP id 30so1254802ugs.39 for ; Wed, 12 Nov 2008 22:18:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=cVqWFWSifICYjTKRKNjY7r4IYT4e/StDS9sFXqG83BA=; b=F7XjlJUOyH9GGbtL7V/QbJ2ocq0jh6hDRqHPXZkOUQa8dXkf+2CdM1kdIXOuXmTWAo MCo8K+X1//VmQFkf8QMRtaBGosZsnZXQGAr2p3VQV2PN9q+39XPQOV6sFxoMtJSSZJEN scuQrQ2N/fQzCfiL2uvrbDmjvesiTTXA1NTx4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=OGI8EJMhYeRhS7HNsGAXstDVTSVqsLhqCP2hylvfg5DJn53htRYDiqh4oWgTHmzzj0 7m7PlFVHUNUEl25bNrjWIXeblVFNtoNV1WPH89HZuRKU9P4DE0ZAm4GwUB2kFTxgFXcd F89O+MAQ0AbUzq0jtD7ESge1lsvX112VqA1zQ= Received: by 10.67.40.15 with SMTP id s15mr3907488ugj.89.1226557082917; Wed, 12 Nov 2008 22:18:02 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-4442731.home.otenet.gr [79.129.186.91]) by mx.google.com with ESMTPS id m1sm2323131uge.20.2008.11.12.22.18.01 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 12 Nov 2008 22:18:01 -0800 (PST) Message-ID: <491BC698.6030701@gmail.com> Date: Thu, 13 Nov 2008 08:18:00 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Murray Stokely References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com> <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> In-Reply-To: <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: FreeBSD doc list Subject: Re: Preface need update. 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: Thu, 13 Nov 2008 06:18:04 -0000 Murray Stokely wrote: > Thanks Manolis. Maybe we should add a comment to the Makefile so that > when authors commit new chapters they remember to also update the > preface summary. Or alternatively, we could put some kind of one > sentence chapter description in of each chapter and pull > it out of each file dynamically when building the preface. I'd > probably recommend the low tech first suggestion as good enough. > > - Murray > > Yes, I think the Makefile solution is good enough. I always read the comments on important files, and hopefully most committers do, so it won't go unnoticed. Cheers, Manolis From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 14:30:04 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 33CA51065687 for ; Thu, 13 Nov 2008 14:30:04 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.26]) by mx1.freebsd.org (Postfix) with ESMTP id B58468FC08 for ; Thu, 13 Nov 2008 14:30:03 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ey-out-2122.google.com with SMTP id 6so389795eyi.7 for ; Thu, 13 Nov 2008 06:30:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=hXJ7FUSNxlW/p9Vy3xvkCGuchwkrH34gURjLDilE8L4=; b=mA3KrqwFZvY2RqBQHIdY/gwIPjOI8bPND67o6EkkGp2RXsGA93BED3kY48XiKrVQK2 TB9aI4nGk0tcJclQ/zaqF1rye/+8xcmsq4tzgzBYJOMnK5eqMxR60whHr13S3kmhrBHJ jmziSu2K+dw3HcaCaEeWLkFyrlfF28zZJKi3Q= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=w6tEFM1D93kuz6CWzNmcldrAoeTlFtT9NaiMZonYMsmuyzG5oS6IbZx3pBfndNR1mo 9a0r3jt81iVz59fLm3tTcsME7KTzGoo4xlN5ff4jkn3tZEqEElhraHGWtRvuLFpMgTlD MQS9055v7e3lqeKC1BS2DWNnlmMBEc4rIsR3o= Received: by 10.210.25.19 with SMTP id 19mr11231684eby.114.1226586602401; Thu, 13 Nov 2008 06:30:02 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-4442731.home.otenet.gr [79.129.186.91]) by mx.google.com with ESMTPS id c25sm6303160ika.14.2008.11.13.06.30.00 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 13 Nov 2008 06:30:01 -0800 (PST) Message-ID: <491C39E7.7040609@gmail.com> Date: Thu, 13 Nov 2008 16:29:59 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Tom Rhodes References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com> <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> <20081112200755.66c52a48.trhodes@FreeBSD.org> In-Reply-To: <20081112200755.66c52a48.trhodes@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, Murray Stokely Subject: Re: Preface need update. 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: Thu, 13 Nov 2008 14:30:04 -0000 Tom Rhodes wrote: > On Wed, 12 Nov 2008 16:05:55 -0800 > "Murray Stokely" wrote: > > >> Thanks Manolis. Maybe we should add a comment to the Makefile so that >> when authors commit new chapters they remember to also update the >> preface summary. Or alternatively, we could put some kind of one >> sentence chapter description in of each chapter and pull >> it out of each file dynamically when building the preface. I'd >> probably recommend the low tech first suggestion as good enough. >> >> - Murray >> > > Yea, because I forget this every time I add a new chapter. :( > > > To take this idea one step further, I suggest we add the following comment to the Makefile: ----------------------------------------------------------------------------------------------------------------- To add a new chapter to the Handbook: - Update this Makefile, chapters.ent and book.sgml - Add a descriptive entry for the new chapter in preface/preface.sgml ----------------------------------------------------------------------------------------------------------------- Do you think this is good enough? Manolis From owner-freebsd-doc@FreeBSD.ORG Thu Nov 13 23:53:36 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7A9A01065670 for ; Thu, 13 Nov 2008 23:53:36 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (pittgoth.com [205.134.163.206]) by mx1.freebsd.org (Postfix) with ESMTP id 382DF8FC17 for ; Thu, 13 Nov 2008 23:53:36 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6]) (authenticated bits=0) by pittgoth.com (8.14.2/8.14.2) with ESMTP id mADNrZee016135 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 13 Nov 2008 18:53:35 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Thu, 13 Nov 2008 18:53:33 -0500 From: Tom Rhodes To: Manolis Kiagias Message-Id: <20081113185333.25a73ebf.trhodes@FreeBSD.org> In-Reply-To: <491C39E7.7040609@gmail.com> References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com> <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> <20081112200755.66c52a48.trhodes@FreeBSD.org> <491C39E7.7040609@gmail.com> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd8.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, murray@stokely.org Subject: Re: Preface need update. 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: Thu, 13 Nov 2008 23:53:36 -0000 On Thu, 13 Nov 2008 16:29:59 +0200 Manolis Kiagias wrote: > Tom Rhodes wrote: > > On Wed, 12 Nov 2008 16:05:55 -0800 > > "Murray Stokely" wrote: > > > > > >> Thanks Manolis. Maybe we should add a comment to the Makefile so that > >> when authors commit new chapters they remember to also update the > >> preface summary. Or alternatively, we could put some kind of one > >> sentence chapter description in of each chapter and pull > >> it out of each file dynamically when building the preface. I'd > >> probably recommend the low tech first suggestion as good enough. > >> > >> - Murray > >> > > > > Yea, because I forget this every time I add a new chapter. :( > > > > > > > To take this idea one step further, I suggest we add the following > comment to the Makefile: > > ----------------------------------------------------------------------------------------------------------------- > To add a new chapter to the Handbook: > > - Update this Makefile, chapters.ent and book.sgml > - Add a descriptive entry for the new chapter in preface/preface.sgml > ----------------------------------------------------------------------------------------------------------------- > > Do you think this is good enough? Yes. And I need to look at the "changes since the third edition" data as well. :) -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Fri Nov 14 08:07:02 2008 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9254C1065680 for ; Fri, 14 Nov 2008 08:07:02 +0000 (UTC) (envelope-from joeb@a1poweruser.com) Received: from mail-03.name-services.com (mail-03.name-services.com [69.64.155.195]) by mx1.freebsd.org (Postfix) with ESMTP id 75FE68FC19 for ; Fri, 14 Nov 2008 08:07:02 +0000 (UTC) (envelope-from joeb@a1poweruser.com) Received: from laptop ([202.69.172.7]) by mail-03.name-services.com with Microsoft SMTPSVC(6.0.3790.3959); Thu, 13 Nov 2008 23:49:18 -0800 From: "joeb" To: Date: Fri, 14 Nov 2008 15:50:36 +0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="Windows-1252" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) Importance: Normal X-OriginalArrivalTime: 14 Nov 2008 02:13:22.0092 (UTC) FILETIME=[917196C0:01C945FE] X-Sender: fbsd1@a1poweruser.com X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Sender: joeb@a1poweruser.com Cc: Subject: updateing splash screen faq X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: joeb@a1poweruser.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 14 Nov 2008 08:07:02 -0000 Would like to update this FAQ. http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/x.html#INSTALL-SPLASH The current FAQ documentation on activating the boot splash screen is not up to date. It was written for FreeBSD 3.1 and is missing some undocumented functions. Change the FAQ to say; FreeBSD has a feature to allow the display of a "splash screen" in place of seeing the boot messages rolling by. This makes for a visually cleaner experience getting to the Xorg Desktop Display Manager logon screen and/or virtual console logon prompt. The "splash screen" function only supports 256 color bitmap (*.bmp) or ZSoft PCX (*.pcx) files. In addition, the splash image files must have a resolution of 320x200 or less to work because that is the default video support FreeBSD provides during the boot process. Your 320x200 "splash screen" image will be displayed as a small block in the center of a solid white background screen. If you want support for larger video resolutions up to the max of your video card you have to add VESA support by loading the VESA module during system boot. VESA support gives you the ability to display a "splash screen" image that fills the whole display screen. While the "splash screen" is being displayed during the booting process you can hit any keyboard key to return to the boot message display. The "splash screen" defaults to becoming your screen saver. After a time period of non-use your screen will change to the "splash screen" and cycles through steps of changing intensity of the image, from bright intensity to a very dark intensity and over again. You can override this default "splash screen" (screen saver) behavior by adding the saver= option (screen saver) statement in /etc/rc.conf. The saver= option has several built-in screen savers to choose from. Such as saver="warp". This default "splash screen" screen saver and /etc/rc.conf, saver= option screen saver only applies to virtual consoles. It has no effect on Xorg desktop display managers. At boot time you still see a few boot messages leading up to and including the boot options menu and the timed wait count down prompt before the "splash screen" is displayed. For default boot display resolution (256 color, 320x200 or less); Your "splash screen" (*.bmp) or (*.pcx) file has to be placed in the /boot directory. Edit /boot/loader.conf so it contains the following: bitmap_load="YES" bitmap_name="/boot/splash.bmp" or bitmap_name="/boot/splash.pcx" For larger video resolutions up to the max of your video card; Your "splash screen" (*.bmp) or (*.pcx) file has to be placed in the /boot directory. Edit /boot/loader.conf so it contains the following: vesa_load="YES" bitmap_load="YES" bitmap_name="/boot/splash.bmp" or bitmap_name="/boot/splash.pcx" You are not restricted to using "splash" as the file name. You can name it anything you want as long as it's a .bmp or .pcx file type. Such as splash_640x400.bmp There are 2 another loader.conf options you may be interested in. Loader_logo="beastie" This will replace the default words "FREE BDS" which are displayed to the right of the boot menu with the colored beastie logo like releases in the past had. beastie_disable="YES" Will stop the boot options menu from being displayed. You will still get the timed wait count down prompt. Now all you need is a splash screen. For that you can surf on over to the gallery at http://www.baldwin.cx/splash/. From owner-freebsd-doc@FreeBSD.ORG Fri Nov 14 08:23:41 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CDB3D10656A5 for ; Fri, 14 Nov 2008 08:23:41 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from fk-out-0910.google.com (fk-out-0910.google.com [209.85.128.186]) by mx1.freebsd.org (Postfix) with ESMTP id 51B618FC24 for ; Fri, 14 Nov 2008 08:23:41 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by fk-out-0910.google.com with SMTP id k31so1412313fkk.11 for ; Fri, 14 Nov 2008 00:23:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; bh=i+FecVvK29604T6Bk9FbQ0zCZRUKaWkoaq10J7iuhKo=; b=DT/YmufrmuVZxTtG4Kn1vALcivMyWeVe5gTxmALayojQOUeZKFeEQJ/DfcPlUpWXH+ br0E9/sC6DOVvrHxMeutL9puK/Xlhe97nA7Kf2tGY8t2pYvXinZfFGOXem4tJ1PURHQm GbLlS66dpramE8gTs4WC5Rb1IrbGJvk23SyM8= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to:cc :subject:references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; b=RrQjW+5xlNzWHbCa4biQLdO5fXsZWIq0G+Yb15Cw1w4NlQbU3VjMNEhp6DbSZjaMk4 zgB/aj4kuuJ7xmciBbWwq/IH4sgga3yjQXHQt9sKlQO6v2v3U1zzZIS9h3jcjFePAUgp v+tqn03et3OrzT4Eg90VMeWVmnmLD4wxbwhEY= Received: by 10.180.204.10 with SMTP id b10mr173407bkg.201.1226651019894; Fri, 14 Nov 2008 00:23:39 -0800 (PST) Received: from ?192.168.1.29? (oktnb24.inf.elte.hu [157.181.167.24]) by mx.google.com with ESMTPS id d13sm427939fka.19.2008.11.14.00.23.37 (version=TLSv1/SSLv3 cipher=RC4-MD5); Fri, 14 Nov 2008 00:23:38 -0800 (PST) Message-ID: <491D3577.3090208@FreeBSD.org> Date: Fri, 14 Nov 2008 09:23:19 +0100 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.17 (X11/20081023) MIME-Version: 1.0 To: joeb@a1poweruser.com References: In-Reply-To: X-Enigmail-Version: 0.95.7 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Cc: doc@FreeBSD.org Subject: Re: updateing splash screen faq 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: Fri, 14 Nov 2008 08:23:41 -0000 joeb wrote: > Would like to update this FAQ. > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/x.html#INSTALL-SPLASH > > The current FAQ documentation on activating the boot splash screen is not up > to date. It was written for FreeBSD 3.1 and is missing some undocumented > functions. Okay, thanks for the report! I will work on it, and let you know when it is fixed. Cheers, :g From owner-freebsd-doc@FreeBSD.ORG Fri Nov 14 09:12:25 2008 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 38F7E1065697 for ; Fri, 14 Nov 2008 09:12:25 +0000 (UTC) (envelope-from joeb@a1poweruser.com) Received: from mail-03.name-services.com (mail-03.name-services.com [69.64.155.195]) by mx1.freebsd.org (Postfix) with ESMTP id 21DA08FC1B for ; Fri, 14 Nov 2008 09:12:24 +0000 (UTC) (envelope-from joeb@a1poweruser.com) Received: from laptop ([202.69.172.7]) by mail-03.name-services.com with Microsoft SMTPSVC(6.0.3790.3959); Fri, 14 Nov 2008 01:11:40 -0800 From: "joeb" To: "Gabor PALI" Date: Fri, 14 Nov 2008 17:12:58 +0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="Windows-1252" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 In-Reply-To: <491D3577.3090208@FreeBSD.org> X-OriginalArrivalTime: 14 Nov 2008 09:11:40.0925 (UTC) FILETIME=[018392D0:01C94639] X-Sender: joeb@a1poweruser.com Cc: doc@FreeBSD.org Subject: RE: updateing splash screen faq X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: joeb@a1poweruser.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 14 Nov 2008 09:12:25 -0000 Sorry just found another hidden function so corrected the faq I posted before. Change the FAQ to say; FreeBSD has a feature to allow the display of a "splash screen" in place of seeing the boot messages rolling by. This makes for a visually cleaner experience getting to the Xorg Desktop Display Manager logon screen and/or virtual console logon prompt. The "splash screen" function only supports (*.bmp) or (*.pcx) files of any resolution supported by VESA. An 320x200 "splash screen" image will be displayed as a small block in the center of a solid white background screen. An 640x400 or larger "splash screen" image fills the whole display screen. The "splash screen" function will interrogate the "splash screen" file pointed to by the (bitmap_name=) option and auto load VESA to support the required resolution for you. While the "splash screen" is being displayed during the booting process you can hit any keyboard key to return to the boot message display. The "splash screen" defaults to becoming your screen saver. After a time period of non-use your screen will change to the "splash screen" and cycles through steps of changing intensity of the image, from bright intensity to a very dark intensity and over again. You can override this default "splash" screen" (screen saver) behavior by adding the saver= option (screen saver) statement in /etc/rc.conf. The saver= option has several built-in screen savers to choose from. Such as saver="warp". This default "splash screen" screen saver and /etc/rc.conf, saver= option screen saver only applies to virtual consoles. It has no effect on Xorg desktop display managers. At boot time you still see a few boot messages leading up to and including the boot options menu and the timed wait count down prompt before the "splash screen" is displayed. To enable the "splash screen" function; Place your "splash screen" (*.bmp) or (*.pcx) file in the /boot directory. Edit /boot/loader.conf so it contains the following: bitmap_load="YES" bitmap_name="/boot/splash.bmp" or bitmap_name="/boot/splash.pcx" You are not restricted to using "splash" as the file name. You can name it anything you want as long as it's a .bmp or .pcx file type. Such as splash_640x400.bmp There are 2 another loader.conf options you may be interested in. Loader_logo="beastie" This will replace the default words "FREE BDS" which are displayed to the right of the boot menu with the colored beastie logo like releases in the past had. beastie_disable="YES" Will stop the boot options menu from being displayed. You will still get the timed wait count down prompt. Now all you need is a splash screen. For that you can surf on over to the gallery at http://www.baldwin.cx/splash/. From owner-freebsd-doc@FreeBSD.ORG Fri Nov 14 16:26:18 2008 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E9B6E1065673 for ; Fri, 14 Nov 2008 16:26:17 +0000 (UTC) (envelope-from dovid.lubin@veryant.com) Received: from smtp117.sbc.mail.sp1.yahoo.com (smtp117.sbc.mail.sp1.yahoo.com [69.147.64.90]) by mx1.freebsd.org (Postfix) with SMTP id D19438FC14 for ; Fri, 14 Nov 2008 16:26:17 +0000 (UTC) (envelope-from dovid.lubin@veryant.com) Received: (qmail 93473 invoked from network); 14 Nov 2008 15:59:37 -0000 Received: from unknown (HELO gwpc06) (dovid.lubin@69.231.22.64 with login) by smtp117.sbc.mail.sp1.yahoo.com with SMTP; 14 Nov 2008 15:59:35 -0000 X-YMail-OSG: 48bk97oVM1mqwqZeKeaAo0bxFYPWmCCpnL8rlW_ijgIeHN4OPke6CC_xBTQyufSdlhg11z16qBXwkoDzcq4wnphOm1l47qUx7c3fGZytoSzKLpWxhyCvfJP0sRqqcn7Cx7cJKvErEWE230x1oMl3Z88n X-Yahoo-Newman-Property: ymail-3 From: "Dovid Lubin" To: Date: Fri, 14 Nov 2008 07:59:36 -0800 Organization: Veryant LLC Message-ID: <03E6D62726AA40068685998B0874EFDF@gwpc06> MIME-Version: 1.0 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AclGcf4ggu+3HRzaTPeOFHQYUgRGPg== X-MimeOLE: Produced By Microsoft MimeOLE V6.0.6000.16669 X-Mailman-Approved-At: Fri, 14 Nov 2008 17:35:29 +0000 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: what tool did you use X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Dovid.Lubin@veryant.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 14 Nov 2008 16:26:18 -0000 Hi, I like your online docs, especially the load speed. What tool(s) did you use to create the online docs? Dovid Lubin | Veryant 2415 East Camelback Road, Suite 700 Phoenix, AZ 85016 USA | www.veryant.com T +1.708.912.2723 | F +1.602.391.2415 From owner-freebsd-doc@FreeBSD.ORG Fri Nov 14 17:41:46 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E26661065686 for ; Fri, 14 Nov 2008 17:41:46 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from ik-out-1112.google.com (ik-out-1112.google.com [66.249.90.177]) by mx1.freebsd.org (Postfix) with ESMTP id 008278FC0A for ; Fri, 14 Nov 2008 17:41:45 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ik-out-1112.google.com with SMTP id c21so1258488ika.3 for ; Fri, 14 Nov 2008 09:41:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=SKu5VeYle73DlQnHhYQCrvxj6dkqvJnM0NBRyAFaZVQ=; b=SgBCTLhbmRBmg20pHCdflP+PSMjWHDZ8mIzvn19s61+90tbIF+yI5TNnJCBF/0pxDN mW7K2WLuajIItGgNG2NqPQa8fm4VQaT61NVsjyBqeyy82xSNR9Q25qzZ2f8O3UteLSKX mPUGhd2+l/4bW0cEwqKWiFezmTOQXy3Bsuaj0= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=qUIXEfK4USRN5ICapv1pAqLOfT+w5xuJvcSuGwZydvF7TVeN86Tz+K3I5MyTvhwD9n 7n2vANVQPjZ/+yJELLhRXaRt+dfc4dyt/ZXWtb4GWyFbQl0vMSj4HDr4qjjtNFAkiNCE CpRPVQS8te6Jqh5W8Fm/nPT+3oAhrHXzc6elM= Received: by 10.210.81.3 with SMTP id e3mr1312369ebb.112.1226684504702; Fri, 14 Nov 2008 09:41:44 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-4448860.home.otenet.gr [79.129.210.76]) by mx.google.com with ESMTPS id 5sm1178382eyf.8.2008.11.14.09.41.42 (version=TLSv1/SSLv3 cipher=RC4-MD5); Fri, 14 Nov 2008 09:41:43 -0800 (PST) Message-ID: <491DB853.4040700@gmail.com> Date: Fri, 14 Nov 2008 19:41:39 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Dovid.Lubin@veryant.com References: <03E6D62726AA40068685998B0874EFDF@gwpc06> In-Reply-To: <03E6D62726AA40068685998B0874EFDF@gwpc06> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@FreeBSD.org Subject: Re: what tool did you use 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: Fri, 14 Nov 2008 17:41:47 -0000 Dovid Lubin wrote: > Hi, > > > > I like your online docs, especially the load speed. What tool(s) did you use > to create the online docs? > > Dovid Lubin | Veryant > 2415 East Camelback Road, Suite 700 Phoenix, AZ 85016 USA | > www.veryant.com > T +1.708.912.2723 | F +1.602.391.2415 > > > > Have a look at this: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ and feel free to ask any questions you may have ;) From owner-freebsd-doc@FreeBSD.ORG Fri Nov 14 17:49:50 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0A159106568D for ; Fri, 14 Nov 2008 17:49:50 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from ey-out-2122.google.com (ey-out-2122.google.com [74.125.78.24]) by mx1.freebsd.org (Postfix) with ESMTP id 519448FC12 for ; Fri, 14 Nov 2008 17:49:48 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by ey-out-2122.google.com with SMTP id 6so620166eyi.7 for ; Fri, 14 Nov 2008 09:49:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :x-enigmail-version:content-type:content-transfer-encoding; bh=nGXwclod7kNSIrbNIgXwPVLmpJdDP2sJPXDeXVWZ+Xg=; b=uKgk9H/D93aUYQ2Hyw6RvMeiiZmjL6B0bdEy4vb58iztl2/0Ih8S4xHtVU5Bxng8hg xV7oSWLoAXXKiPLAhZ4PoxHVbEQCBDSE9gpMM+mmTU2M2X6ZfK9sbG7K/rjUmNJcqaIj EKeIBPA3/U0gHtRGZkMSbryB9x5GM5no0ZWhY= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; b=gojeWybxGHoYLhsMVCpM5X3Wa+Pf6vFC1beAs7KQDdo2HghcHu+iHs8WfpNZRh5rvi mhbidC0OlEqGWTaDqYIy8Ta3QepdmYDagIO0DanxGrEkugVWns+IbJrXrkYle03mKRC2 e1XbDOX8ark5WFJFxNFNoto1fvMNexovnayNk= Received: by 10.210.45.14 with SMTP id s14mr1329839ebs.72.1226684988141; Fri, 14 Nov 2008 09:49:48 -0800 (PST) Received: from self.rene-ladan.nl ([77.163.174.49]) by mx.google.com with ESMTPS id z33sm521760ikz.16.2008.11.14.09.49.46 (version=TLSv1/SSLv3 cipher=RC4-MD5); Fri, 14 Nov 2008 09:49:47 -0800 (PST) Message-ID: <491DBA39.9060008@gmail.com> Date: Fri, 14 Nov 2008 18:49:45 +0100 From: Rene Ladan User-Agent: Thunderbird 2.0.0.17 (X11/20080927) MIME-Version: 1.0 To: Dovid.Lubin@veryant.com References: <03E6D62726AA40068685998B0874EFDF@gwpc06> In-Reply-To: <03E6D62726AA40068685998B0874EFDF@gwpc06> X-Enigmail-Version: 0.95.6 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@FreeBSD.org Subject: Re: what tool did you use 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: Fri, 14 Nov 2008 17:49:50 -0000 Dovid Lubin schreef: > Hi, > > > > I like your online docs, especially the load speed. What tool(s) did you use > to create the online docs? > /usr/ports/textproc/docproj see also http://www.freebsd.org/doc/en/books/fdp-primer/tools.html Rene -- http://www.rene-ladan.nl/ GPG fingerprint = E738 5471 D185 7013 0EE0 4FC8 3C1D 6F83 12E1 84F6 (subkeys.pgp.net) From owner-freebsd-doc@FreeBSD.ORG Fri Nov 14 20:06:17 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B5E4B106564A for ; Fri, 14 Nov 2008 20:06:17 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from fg-out-1718.google.com (fg-out-1718.google.com [72.14.220.152]) by mx1.freebsd.org (Postfix) with ESMTP id 445DB8FC0C for ; Fri, 14 Nov 2008 20:06:17 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by fg-out-1718.google.com with SMTP id l26so1141167fgb.35 for ; Fri, 14 Nov 2008 12:06:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; bh=Xm+JwQRUsCLbcrSQ2zRYe/pmlO8FN2GqjWjge8gUZHQ=; b=U+g3EDQCzqIG8mKOMXva1zFFk3b72P4NzVius+uII7bhlNU5ZnQLLYVTt8qtxiZVrp R4HQyOKSF1ywZyWnAWteUVXohQrfTIQPDzeRBDh1Eg4HdLnHOm07rK/6ZoPeGhgakpcW /lFnsLckgJOWVaBCPsN3u6o5K8oEG91CJlQaA= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to:cc :subject:references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding:sender; b=egzlPYcFwCMyF5g41NbSbWGvUgAnD7cW9FGzYjsLuj9I+SK67S0DMmnSSs1+5KZ+lO uK9F9fMMHRqPipNa3k4mhIwl+n0JTbwDIS5J0Yl2nTSJ78oGaIpp/gQUuSkU4jKdvPcH GOmATT1q9tlvj/Kt7DGt4D1P9snpEQKBR+bFA= Received: by 10.181.220.19 with SMTP id x19mr353053bkq.136.1226693175617; Fri, 14 Nov 2008 12:06:15 -0800 (PST) Received: from ?192.168.1.29? (oktnb24.inf.elte.hu [157.181.167.24]) by mx.google.com with ESMTPS id g28sm1196744fkg.8.2008.11.14.12.06.13 (version=TLSv1/SSLv3 cipher=RC4-MD5); Fri, 14 Nov 2008 12:06:14 -0800 (PST) Message-ID: <491DDA22.7070801@FreeBSD.org> Date: Fri, 14 Nov 2008 21:05:54 +0100 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.17 (X11/20081023) MIME-Version: 1.0 To: joeb@a1poweruser.com References: In-Reply-To: X-Enigmail-Version: 0.95.7 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Cc: doc@FreeBSD.org Subject: Re: updateing splash screen faq 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: Fri, 14 Nov 2008 20:06:17 -0000 Hi joeb, I started to review your proposed changes, and I have some comments: > "This makes for a visually cleaner experience getting to the Xorg > Desktop Display Manager logon screen and/or virtual console logon > prompt." Sorry, I do not understand this sentence. > The "splash screen" function only supports (*.bmp) or (*.pcx) files > of any resolution supported by VESA. An 320x200 "splash screen" image > will be displayed as a small block in the center of a solid white > background screen. An 640x400 or larger "splash screen" image fills > the whole display screen. The "splash screen" function will > interrogate the "splash screen" file pointed to by the (bitmap_name=) > option and auto load VESA to support the required resolution for you. > > [..] I do not think you should mention every detail. In my opinion, it would be better to put all the text into the Handbook, then reference it from the FAQ (if you want to write all these things down step by step). Or why do not simply reference the corresponding manual pages for example? I think your changes make the answer too long, a FAQ entry should be more compact, a quick way to answer a problem, as it is the original version. To be honest, I am reluctant a bit to include all of your text in the FAQ in the first round. I would prefer a simple fix to remove the /boot/loader.rc part and include some manual page references. Well, here is my recommendation: 11.18. How do I install a splash screen and where do I find them? FreeBSD have a feature to allow the display of "splash" screens during the boot messages. The splash screens currently must be a 256 color bitmap (*.BMP) or ZSoft PCX (*.PCX) file. In addition, they must have a resolution of 320x200 or less to work on standard VGA adapters. If you compile VESA support into your kernel (see vga(4)), then you can use larger bitmaps up to 1024x768. The actual VESA support can either be compiled directly into the kernel with the VESA kernel config option or by loading the VESA kernel module during bootup. To use a splash screen, you need to modify /boot/loader.conf to contain the following: splash_bmp_load="YES" bitmap_load="YES" This assumes you are using /boot/splash.bmp for your splash screen. If you would rather use a PCX file, copy it to /boot/splash.pcx, modify /boot/loader.conf to contain: splash_pcx_load="YES" bitmap_load="YES" bitmap_name="/boot/splash.pcx" Now all you need is a splash screen. For that you can surf on over to the gallery at http://www.baldwin.cx/splash/. For further options, please see the splash(4), loader.conf(5) manual pages. Cheers, :g From owner-freebsd-doc@FreeBSD.ORG Sat Nov 15 10:02:01 2008 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 92DF71065695; Sat, 15 Nov 2008 10:02:01 +0000 (UTC) (envelope-from fbsd1@a1poweruser.com) Received: from mail-03.name-services.com (mail-03.name-services.com [69.64.155.195]) by mx1.freebsd.org (Postfix) with ESMTP id 7B58C8FC14; Sat, 15 Nov 2008 10:02:01 +0000 (UTC) (envelope-from fbsd1@a1poweruser.com) Received: from [10.0.10.6] ([202.69.173.137]) by mail-03.name-services.com with Microsoft SMTPSVC(6.0.3790.3959); Sat, 15 Nov 2008 01:44:16 -0800 Message-ID: <491E9A3E.2070201@a1poweruser.com> Date: Sat, 15 Nov 2008 17:45:34 +0800 From: Fbsd1 User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: pgj@FreeBSD.org References: In-Reply-To: Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 8bit X-OriginalArrivalTime: 15 Nov 2008 09:44:16.0338 (UTC) FILETIME=[B971AB20:01C94706] X-Sender: fbsd1@a1poweruser.com Cc: doc@FreeBSD.org Subject: Re: Adding splash screen section to handbook 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: Sat, 15 Nov 2008 10:02:01 -0000 Had to use my other email address so i could bottom post. > > -----Original Message----- > From: PÁLI Gábor János [mailto:pali.gabor@googlemail.com]On Behalf Of Gabor > PALI > Sent: Saturday, November 15, 2008 4:06 AM > To: joeb@a1poweruser.com > Cc: doc@FreeBSD.org > Subject: Re: updateing splash screen faq > > Hi joeb, > > I started to review your proposed changes, and I have some comments: > > >> "This makes for a visually cleaner experience getting to the X11 >> Desktop Display Manager login screen and/or virtual console login >> prompt." > > Sorry, I do not understand this sentence. > > There are 2 basic environments available in Freebsd, The first is the default command line environment which has 8 virtual consoles controlled by the F1 - F8 keys. When you boot the system you arrive at the F1 virtual console login prompt. The is the environment a user would see after a new install from cd. The second environment is the X11 Desktop environment. After a user installs Xorg and one of the desktop managers, gnome, kde, or Xfce like explained in the handbook they can launch the desktop from the command line by using the startx command. Some X11 users may select NOT to stop at the virtual console login prompt at boot time but go directlly to the X11 desktop. They would use the display manager of Xorg called xdm, or the the display manager of gnome called gdm or the the display manager of kde called kdm. These display managers basically provides a graphical login screen in place of the virtual console login prompt. In virtual console command line environment the splash screen would hide all the boot probe messages and startup messages before displaying the login prompt. In X11 environments the users would get a visually clearer system start up experience resembling something closer to what an ms/xp user would see. > > I do not think you should mention every detail. In my opinion, it would > be better to put all the text into the Handbook, then reference it from > the FAQ (if you want to write all these things down step by step). Or > why do not simply reference the corresponding manual pages for example? > > I think your changes make the answer too long, a FAQ entry should be > more compact, a quick way to answer a problem, as it is the original > version. To be honest, I am reluctant a bit to include all of > your text in the FAQ in the first round. > > I would prefer a simple fix to remove the /boot/loader.rc part and > include some manual page references. Well, here is my recommendation: > First of all, the handbook does not have any reference to the splash screen function. The only documentation on the splash screen is in the FAQ. You should know that all ready. I agree with you that the splash screen documentation should be removed from the FAQ and placed in the handbook. Complete and full documentation is what is needed and the handbook is the place it belongs. On that point I do not think the splash screen belongs under the section dealing with X11 because it really has nothing to do with X11. I think it should be in a new sub-section, in section "3.0 UNIX Basics" after 3.2 Virtual Consoles and Terminals, titled 3.3 Boot time Splash screen. So I have rewritten what I posted before and made some technical corrections and added some more explanation background text. If you check out the handbook Chapter 31 Firewalls you will see that I wrote the whole chapter. I don't have the time nor the patiences to work through the handbook SGML coding and approval process. So I am going to hand off this new handbook section to you to do as you want with it. Just give me my credit do as "Contributed by Joseph J. Barbish". Handbook Section 3.0 UNIX Basics - 3.3 Boot time Splash screen FreeBSD has a feature to allow the display of a "splash screen" in place of seeing the boot messages rolling by. This makes for a clearer visually experience getting to the legacy UNIX virtual console text login prompt and/or the X-Display Manager graphical login screen. There are 2 basic environments available in FreeBSD. The first is the default legacy UNIX virtual console text command line environment that has 8 virtual consoles controlled by the F1 - F8 keyboard keys. When you boot the system you arrive at the F1 virtual console text login prompt. The second environment is the X11 Desktop graphical environment. After a user installs X11. http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x-install.html And one of the graphical desktop managers, gnome, kde, or Xfce. http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x-xdm.html They can launch the X11 desktop from the command line by using the startx command. Some X11 users may select NOT to stop at the virtual console login prompt at boot time, but go directly to the X11 desktop display manager's graphical login screen. They could use the display manager of Xorg called xdm, or the display manager of gnome called gdm or the display manager of kde called kdm or one of the other display managers provided in the ports system. These display managers basically provides a graphical login screen in place of the default legacy UNIX virtual console text login prompt and after a successful login, puts the user in their graphical windowed desktop. In the virtual console text command line environment the splash screen would hide all the boot probe messages and task startup messages before displaying the login prompt. In X11 environment the users would get a visually clearer system start up experience resembling something closer to what a (Microsoft Windows or non-unix type system) user would experience. 3.3.1 Splash Screen Function; The "splash screen" function only supports 256 color bitmap (*.bmp) or ZSoft PCX (*.pcx) files. In addition, the splash image files must have a resolution of 320x200 or less to work because that is the default video support FreeBSD provides. Your 320x200 "splash screen" image will be displayed as a small block in the center of a solid white background screen. If you want support for larger video resolutions up to the max of your video card you have to add VESA support by loading the VESA module during system boot. VESA support gives you the ability to display a "splash screen" image that fills the whole display screen. While the "splash screen" is being displayed during the booting process you can hit any keyboard key to return to the boot message display. The "splash screen" defaults to becoming your screen saver. After a time period of non-use your screen will change to the "splash screen" and cycles through steps of changing intensity of the image, from bright intensity to a very dark intensity and over again. You can override this default "splash screen" (screen saver) behavior by adding the saver= option (screen saver) statement in /etc/rc.conf. The saver= option has several built-in screen savers to choose from. Such as saver="warp". This default "splash screen" screen saver and /etc/rc.conf, saver= option screen saver only applies to virtual consoles. It has no effect on X11 desktop display managers. At boot time with the "splash screen" enabled you still see a few boot loader messages leading up to and including the boot options menu and the timed wait count down prompt before the "splash screen" is displayed. Sample splash screen files can be downloaded from the gallery at http://www.baldwin.cx/splash/. 3.3.2 Enabling the Splash Screen Function; Your "splash screen" (*.bmp) or (*.pcx) file has to be placed in the /boot directory. For default boot display resolution (256 color, 320x200 or less); Edit /boot/loader.conf so it contains the following: splash_bmp_load="YES" bitmap_load="YES" bitmap_name="/boot/splash.bmp" For larger video resolutions up to the max of your video card; Edit /boot/loader.conf so it contains the following: vesa_load="YES" splash_bmp_load="YES" bitmap_load="YES" bitmap_name="/boot/splash.bmp" The above assumes you are using /boot/splash.bmp for your splash screen. If you would rather use a PCX file, use these statements plus the vesa_load="YES" statement depending on the resolution. splash_pcx_load="YES" bitmap_load="YES" bitmap_name="/boot/splash.pcx" You are not restricted to using "splash" as the file name. You can name it anything you want as long as it's a .bmp or .pcx file type. Such as splash_640x400.bmp or blue_wave.bmp. There are 2 another loader.conf options you may be interested in. beastie_disable="YES" Will stop the boot options menu from being displayed. You will still get the timed wait count down prompt. Even with the display of the boot options menu disabled, entering an 1-6 option selection at the timed wait count down prompt will enact that boot option. Loader_logo="beastie" This will replace the default words "FREE BDS" which are displayed to the right of the boot options menu with the colored beastie logo like releases in the past had.