From owner-freebsd-doc@FreeBSD.ORG Sun May 18 08:53:30 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6F82437B401 for ; Sun, 18 May 2003 08:53:30 -0700 (PDT) Received: from harmony.village.org (rover.bsdimp.com [204.144.255.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2638543FBD for ; Sun, 18 May 2003 08:53:19 -0700 (PDT) (envelope-from imp@bsdimp.com) Received: from localhost (warner@rover2.village.org [10.0.0.1]) by harmony.village.org (8.12.8/8.12.3) with ESMTP id h4IFr7kA087851 for ; Sun, 18 May 2003 09:53:12 -0600 (MDT) (envelope-from imp@bsdimp.com) Date: Sun, 18 May 2003 09:52:26 -0600 (MDT) Message-Id: <20030518.095226.115908955.imp@bsdimp.com> To: doc@freebsd.org From: "M. Warner Losh" X-Mailer: Mew version 2.1 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Subject: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 15:53:30 -0000 Is there a good docbook book that people can recommend? Warner From owner-freebsd-doc@FreeBSD.ORG Sun May 18 09:00:41 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DBF3037B401 for ; Sun, 18 May 2003 09:00:41 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id EBBF043FBD for ; Sun, 18 May 2003 09:00:40 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19HQaV-0006ie-00; Sun, 18 May 2003 17:00:39 +0100 Date: Sun, 18 May 2003 17:00:39 +0100 From: Ceri Davies To: "M. Warner Losh" Message-ID: <20030518160039.GA25804@submonkey.net> Mail-Followup-To: Ceri Davies , "M. Warner Losh" , doc@freebsd.org References: <20030518.095226.115908955.imp@bsdimp.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="KsGdsel6WgEHnImy" Content-Disposition: inline In-Reply-To: <20030518.095226.115908955.imp@bsdimp.com> User-Agent: Mutt/1.5.4i Sender: Ceri Davies cc: doc@freebsd.org Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 16:00:42 -0000 --KsGdsel6WgEHnImy Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, May 18, 2003 at 09:52:26AM -0600, M. Warner Losh wrote: > Is there a good docbook book that people can recommend? Although there are others, O'Reilly's DocBook: The Definitive Guide is prob= ably the best, and it's free too (www.docbook.org or the textproc/docbook-tdg po= rt). Ceri --=20 --KsGdsel6WgEHnImy Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+x64nocfcwTS3JF8RAhsGAJ9ikdBPq2AY0PK/cySpweXJlLUm8wCfbUtr PYrxLK3CMDZ9M1ngmXTnwsw= =++Jh -----END PGP SIGNATURE----- --KsGdsel6WgEHnImy-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 09:10:58 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 81C5137B401 for ; Sun, 18 May 2003 09:10:58 -0700 (PDT) Received: from harmony.village.org (rover.bsdimp.com [204.144.255.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id A694843FA3 for ; Sun, 18 May 2003 09:10:57 -0700 (PDT) (envelope-from imp@bsdimp.com) Received: from localhost (warner@rover2.village.org [10.0.0.1]) by harmony.village.org (8.12.8/8.12.3) with ESMTP id h4IGAukA087983; Sun, 18 May 2003 10:10:57 -0600 (MDT) (envelope-from imp@bsdimp.com) Date: Sun, 18 May 2003 10:10:07 -0600 (MDT) Message-Id: <20030518.101007.28787714.imp@bsdimp.com> To: setantae@submonkey.net From: "M. Warner Losh" In-Reply-To: <20030518160039.GA25804@submonkey.net> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> X-Mailer: Mew version 2.1 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit cc: doc@freebsd.org Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 16:10:58 -0000 In message: <20030518160039.GA25804@submonkey.net> Ceri Davies writes: : Although there are others, O'Reilly's DocBook: The Definitive Guide is probably : the best, and it's free too (www.docbook.org or the textproc/docbook-tdg port). Thanks! On a related topic, I notice that we have textproc/docbook-{241,300,310,400,410} in the repo. What's their purpose? Why the different versions of everything? I'm guessing it is different 'standards' of docbook markup that different documents use. Warner From owner-freebsd-doc@FreeBSD.ORG Sun May 18 09:21:22 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 90BF037B401 for ; Sun, 18 May 2003 09:21:22 -0700 (PDT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id C16E443F93 for ; Sun, 18 May 2003 09:21:21 -0700 (PDT) (envelope-from hrs@eos.ocn.ne.jp) Received: from mail.allbsd.org (p4244-adsao12honb4-acca.tokyo.ocn.ne.jp [219.161.186.244]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id 89CDF1A23; Mon, 19 May 2003 01:21:20 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) h4IGKUJp030524; Mon, 19 May 2003 01:20:31 +0900 (JST) (envelope-from hrs@eos.ocn.ne.jp) Date: Mon, 19 May 2003 01:20:28 +0900 (JST) Message-Id: <20030519.012028.74758173.hrs@eos.ocn.ne.jp> To: imp@bsdimp.com From: Hiroki Sato In-Reply-To: <20030518.101007.28787714.imp@bsdimp.com> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> <20030518.101007.28787714.imp@bsdimp.com> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 2.2 on Emacs 20.7 / Mule 4.0 (HANANOEN) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit cc: doc@freebsd.org Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 16:21:22 -0000 "M. Warner Losh" wrote in <20030518.101007.28787714.imp@bsdimp.com>: imp> On a related topic, I notice that we have imp> textproc/docbook-{241,300,310,400,410} in the repo. What's their imp> purpose? Why the different versions of everything? I'm guessing it imp> is different 'standards' of docbook markup that different documents imp> use. Yes, they are different from each other and basically incompatible. -- | Hiroki SATO / From owner-freebsd-doc@FreeBSD.ORG Sun May 18 09:27:50 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8D6A637B401 for ; Sun, 18 May 2003 09:27:50 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id E215D43FA3 for ; Sun, 18 May 2003 09:27:49 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 2A38210BF81; Sun, 18 May 2003 18:27:48 +0200 (CEST) Date: Sun, 18 May 2003 18:27:48 +0200 From: "Simon L. Nielsen" To: freebsd-doc@freebsd.org Message-ID: <20030518162747.GA1697@nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="St7VIuEGZ6dlpu13" Content-Disposition: inline User-Agent: Mutt/1.5.4i Subject: Bad link in freebsd-questions article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 16:27:50 -0000 --St7VIuEGZ6dlpu13 Content-Type: multipart/mixed; boundary="cNdxnHkX5QqsyA0e" Content-Disposition: inline --cNdxnHkX5QqsyA0e Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello I just noticed a broken link in the FreeBSD questions article since Eric S. Raymond's home page have moved. Fix attached. --=20 Simon L. Nielsen --cNdxnHkX5QqsyA0e Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="doc-questions-esr-link.patch" Content-Transfer-Encoding: quoted-printable Index: en_US.ISO8859-1/articles/freebsd-questions/article.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/freebsd-questions/article= =2Esgml,v retrieving revision 1.12 diff -u -d -r1.12 article.sgml --- en_US.ISO8859-1/articles/freebsd-questions/article.sgml 4 Apr 2003 08:2= 6:51 -0000 1.12 +++ en_US.ISO8859-1/articles/freebsd-questions/article.sgml 18 May 2003 18:= 21:50 -0000 @@ -48,7 +48,7 @@ out yet. The FreeBSD hackers disapprove strongly of cracking security, and have nothing to do with it. For a longer description of hackers, see Eric Raymond's How To Become + url=3D"http://www.catb.org/~esr/faqs/hacker-howto.html">How To Become A Hacker =20 --cNdxnHkX5QqsyA0e-- --St7VIuEGZ6dlpu13 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+x7SD8kocFXgPTRwRAk4fAJsFTfG2DCS7hWgsDHOIN/X4kMGlwQCdE2ST eh952vCFgKGrF81h310wePU= =vDrh -----END PGP SIGNATURE----- --St7VIuEGZ6dlpu13-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 09:38:56 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BFB2037B401 for ; Sun, 18 May 2003 09:38:56 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2A72C43F3F for ; Sun, 18 May 2003 09:38:56 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19HRBX-000724-00; Sun, 18 May 2003 17:38:55 +0100 Date: Sun, 18 May 2003 17:38:55 +0100 From: Ceri Davies To: "Simon L. Nielsen" Message-ID: <20030518163855.GB25804@submonkey.net> Mail-Followup-To: Ceri Davies , "Simon L. Nielsen" , freebsd-doc@freebsd.org References: <20030518162747.GA1697@nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ftEhullJWpWg/VHq" Content-Disposition: inline In-Reply-To: <20030518162747.GA1697@nitro.dk> User-Agent: Mutt/1.5.4i Sender: Ceri Davies cc: freebsd-doc@freebsd.org Subject: Re: Bad link in freebsd-questions article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 16:38:57 -0000 --ftEhullJWpWg/VHq Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, May 18, 2003 at 06:27:48PM +0200, Simon L. Nielsen wrote: > Hello >=20 > I just noticed a broken link in the FreeBSD questions article since Eric > S. Raymond's home page have moved. Fix attached. Committed. Thank you. As a side note, although it may not seem worth it most of the time, I'd recommend submitting all of your diffs as PRs. That way we have a record of all your crimes readily accessible when it becomes time to punish you the traditional way. Thanks again, Ceri --=20 --ftEhullJWpWg/VHq Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+x7cfocfcwTS3JF8RArOrAKCQ9kwFPIX/B4H4y3icE+I3gguGtACgm1Kv CHO6HlV3jkq3pByxU4c15nM= =zxLm -----END PGP SIGNATURE----- --ftEhullJWpWg/VHq-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 09:41:45 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 02B1A37B401 for ; Sun, 18 May 2003 09:41:45 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3D05243F85 for ; Sun, 18 May 2003 09:41:44 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 5470210BF81; Sun, 18 May 2003 18:41:43 +0200 (CEST) Date: Sun, 18 May 2003 18:41:43 +0200 From: "Simon L. Nielsen" To: Ceri Davies , freebsd-doc@freebsd.org Message-ID: <20030518164142.GB1697@nitro.dk> References: <20030518162747.GA1697@nitro.dk> <20030518163855.GB25804@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="qtZFehHsKgwS5rPz" Content-Disposition: inline In-Reply-To: <20030518163855.GB25804@submonkey.net> User-Agent: Mutt/1.5.4i Subject: Re: Bad link in freebsd-questions article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 16:41:45 -0000 --qtZFehHsKgwS5rPz Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.18 17:38:55 +0100, Ceri Davies wrote: > As a side note, although it may not seem worth it most of the time, I'd > recommend submitting all of your diffs as PRs. That way we have a record > of all your crimes readily accessible when it becomes time to punish you > the traditional way. OK, will do :-) --=20 Simon L. Nielsen --qtZFehHsKgwS5rPz Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+x7fG8kocFXgPTRwRAialAJ9KRy91R4TH5m6RdyfnSh2dYjpUaQCfbSPQ QS7f6oVrJkevWM4mbVQoV3o= =t8yE -----END PGP SIGNATURE----- --qtZFehHsKgwS5rPz-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 09:43:09 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BD81B37B401 for ; Sun, 18 May 2003 09:43:09 -0700 (PDT) Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251]) by mx1.FreeBSD.org (Postfix) with ESMTP id EDE6243F75 for ; Sun, 18 May 2003 09:43:08 -0700 (PDT) (envelope-from hmp@perrin.int.nxad.com) Received: by perrin.int.nxad.com (Postfix, from userid 1072) id 30BAC21069; Sun, 18 May 2003 09:43:05 -0700 (PDT) Date: Sun, 18 May 2003 09:43:04 -0700 From: Hiten Pandya To: Ceri Davies , "Simon L. Nielsen" , freebsd-doc@freebsd.org Message-ID: <20030518164304.GA29362@perrin.int.nxad.com> References: <20030518162747.GA1697@nitro.dk> <20030518163855.GB25804@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="XsQoSWH+UP9D9v3l" Content-Disposition: inline In-Reply-To: <20030518163855.GB25804@submonkey.net> X-Operating-System: FreeBSD FreeBSD 4.7-STABLE User-Agent: Mutt/1.5.4i Subject: Re: Bad link in freebsd-questions article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 16:43:10 -0000 --XsQoSWH+UP9D9v3l Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, May 18, 2003 at 05:38:55PM +0100, Ceri Davies wrote: > On Sun, May 18, 2003 at 06:27:48PM +0200, Simon L. Nielsen wrote: > > Hello > >=20 > > I just noticed a broken link in the FreeBSD questions article since Eric > > S. Raymond's home page have moved. Fix attached. >=20 > Committed. Thank you. >=20 > As a side note, although it may not seem worth it most of the time, I'd > recommend submitting all of your diffs as PRs. That way we have a record > of all your crimes readily accessible when it becomes time to punish you > the traditional way. >=20 Yeah! Otherwise you can suffer a long `keep them coming...' punishment, as like some of us did. Er, /me ducks and runs 8-) =09 -- Hiten (hmp@FreeBSD.ORG) --XsQoSWH+UP9D9v3l Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- iD8DBQE+x7gYVBcFDV2wzvIRAoobAJ9rd07YTGdZT7pfX2pnxFA+XWYavgCfQBVq 0LscsDLoa2AsWl3Kg57SkYA= =1cnC -----END PGP SIGNATURE----- --XsQoSWH+UP9D9v3l-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 10:06:58 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7BEC837B408; Sun, 18 May 2003 10:06:58 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1925943FA3; Sun, 18 May 2003 10:06:58 -0700 (PDT) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (brueffer@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4IH6vUp086127; Sun, 18 May 2003 10:06:57 -0700 (PDT) (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4IH6vFn086123; Sun, 18 May 2003 19:06:57 +0200 (CEST) Date: Sun, 18 May 2003 19:06:57 +0200 (CEST) From: Christian Brueffer Message-Id: <200305181706.h4IH6vFn086123@freefall.freebsd.org> To: pepper@rockefeller.edu, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/52259: Unmatched parenthesis in /usr/share/man/man5/make.conf.5.gz X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 17:06:58 -0000 Synopsis: Unmatched parenthesis in /usr/share/man/man5/make.conf.5.gz State-Changed-From-To: open->closed State-Changed-By: brueffer State-Changed-When: Sun May 18 19:06:12 CEST 2003 State-Changed-Why: Committed to RELENG_4 (not present in -current), thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=52259 From owner-freebsd-doc@FreeBSD.ORG Sun May 18 12:51:30 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 28E7237B401 for ; Sun, 18 May 2003 12:51:30 -0700 (PDT) Received: from crf-consulting.co.uk (pc-62-31-42-106-hy.blueyonder.co.uk [62.31.42.106]) by mx1.FreeBSD.org (Postfix) with ESMTP id 07AF443F75 for ; Sun, 18 May 2003 12:51:28 -0700 (PDT) (envelope-from nik@crf-consulting.co.uk) Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20]) by crf-consulting.co.uk (8.12.3/8.12.3) with ESMTP id h4IJpCRf020215; Sun, 18 May 2003 20:51:12 +0100 (BST) (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) h4IJpBLG019519; Sun, 18 May 2003 20:51:11 +0100 (BST) (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost) by clan.nothing-going-on.org (8.12.8/8.12.8/Submit) id h4IJpAA4019518; Sun, 18 May 2003 20:51:10 +0100 (BST) Date: Sun, 18 May 2003 20:51:10 +0100 From: Nik Clayton To: "M. Warner Losh" Message-ID: <20030518195110.GA19455@clan.nothing-going-on.org> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> <20030518.101007.28787714.imp@bsdimp.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="d6Gm4EdcadzBjdND" Content-Disposition: inline In-Reply-To: <20030518.101007.28787714.imp@bsdimp.com> User-Agent: Mutt/1.4i Organization: FreeBSD Project cc: doc@freebsd.org Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 19:51:30 -0000 --d6Gm4EdcadzBjdND Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, May 18, 2003 at 10:10:07AM -0600, M. Warner Losh wrote: > On a related topic, I notice that we have > textproc/docbook-{241,300,310,400,410} in the repo. What's their > purpose? Why the different versions of everything? I'm guessing it > is different 'standards' of docbook markup that different documents > use. Different versions of the DTD. Since you might have documents authored using different versions, it made sense to keep them as separate ports, rather than have a single docbook DTD port. N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ (__) FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) \/ \= ^ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/= _) --d6Gm4EdcadzBjdND Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+x+Quk6gHZCw343URAiYcAJ4pabOdTz6ZVWge/jhmg+lHSWaVhQCfeEb4 Bb/jTaQ9MtvXBdx6M0YbA9Q= =6iDJ -----END PGP SIGNATURE----- --d6Gm4EdcadzBjdND-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 12:58:47 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C0F9637B401 for ; Sun, 18 May 2003 12:58:47 -0700 (PDT) Received: from crf-consulting.co.uk (pc-62-31-42-106-hy.blueyonder.co.uk [62.31.42.106]) by mx1.FreeBSD.org (Postfix) with ESMTP id AC95D43FB1 for ; Sun, 18 May 2003 12:58:46 -0700 (PDT) (envelope-from nik@crf-consulting.co.uk) Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20]) by crf-consulting.co.uk (8.12.3/8.12.3) with ESMTP id h4IJwjRf020223 for ; Sun, 18 May 2003 20:58:45 +0100 (BST) (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) h4IJwjLG019553 for ; Sun, 18 May 2003 20:58:45 +0100 (BST) (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost) by clan.nothing-going-on.org (8.12.8/8.12.8/Submit) id h4IJwjq7019552 for doc@freebsd.org; Sun, 18 May 2003 20:58:45 +0100 (BST) Date: Sun, 18 May 2003 20:58:45 +0100 From: Nik Clayton To: doc@freebsd.org Message-ID: <20030518195845.GB19455@clan.nothing-going-on.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="TakKZr9L6Hm6aLOc" Content-Disposition: inline User-Agent: Mutt/1.4i Organization: FreeBSD Project Subject: RFC: Dropping gzip'd docs on the FTP site X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 19:58:48 -0000 --TakKZr9L6Hm6aLOc Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi chaps, At the moment the docs on the FTP site are available in gzip, bzip2, and zip format. How do people feel about dropping support for gzip? FreeBSD's shipped with bzip for a while, and the zip format covers platforms where gzip or bzip isn't common. Support for building gzip'd docs would remain in the tool chain, I just want to remove the format when the docs are built for the FTP site. Comments? N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ (__) FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) \/ \= ^ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/= _) --TakKZr9L6Hm6aLOc Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+x+X1k6gHZCw343URAt+RAJ4/XSSTgn45TuO7b2bP8CZz2NW+tgCglKat oShMg46/Hjl9F1EsoOqEYoA= =5ITu -----END PGP SIGNATURE----- --TakKZr9L6Hm6aLOc-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 13:01:29 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 914D837B401; Sun, 18 May 2003 13:01:29 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D735543F93; Sun, 18 May 2003 13:01:28 -0700 (PDT) (envelope-from hmp@FreeBSD.org) Received: from freefall.freebsd.org (hmp@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4IK1SUp010939; Sun, 18 May 2003 13:01:28 -0700 (PDT) (envelope-from hmp@freefall.freebsd.org) Received: (from hmp@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4IK1SM3010935; Sun, 18 May 2003 13:01:28 -0700 (PDT) Date: Sun, 18 May 2003 13:01:28 -0700 (PDT) From: Hiten Pandya Message-Id: <200305182001.h4IK1SM3010935@freefall.freebsd.org> To: hmp@FreeBSD.org, freebsd-doc@FreeBSD.org, hmp@FreeBSD.org Subject: Re: docs/41580: usb(4) manpage: Structures' fields aren't synchronized with those in dev/usb/usb.h X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 20:01:30 -0000 Synopsis: usb(4) manpage: Structures' fields aren't synchronized with those in dev/usb/usb.h Responsible-Changed-From-To: freebsd-doc->hmp Responsible-Changed-By: hmp Responsible-Changed-When: Sun May 18 13:01:10 PDT 2003 Responsible-Changed-Why: I will take a look at this, thanks. http://www.freebsd.org/cgi/query-pr.cgi?pr=41580 From owner-freebsd-doc@FreeBSD.ORG Sun May 18 13:02:41 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9F8CA37B401; Sun, 18 May 2003 13:02:41 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9B9E843FB1; Sun, 18 May 2003 13:02:40 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com ([192.168.0.5]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4IK2dka009474; Sun, 18 May 2003 16:02:39 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Sun, 18 May 2003 15:56:53 -0400 From: Tom Rhodes To: Nik Clayton Message-Id: <20030518155653.5fd2e315.trhodes@FreeBSD.org> In-Reply-To: <20030518195845.GB19455@clan.nothing-going-on.org> References: <20030518195845.GB19455@clan.nothing-going-on.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: RFC: Dropping gzip'd docs on the FTP site X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 20:02:42 -0000 On Sun, 18 May 2003 20:58:45 +0100 Nik Clayton wrote: > Hi chaps, > > At the moment the docs on the FTP site are available in gzip, bzip2, and > zip format. > > How do people feel about dropping support for gzip? FreeBSD's shipped > with bzip for a while, and the zip format covers platforms where gzip or > bzip isn't common. > > Support for building gzip'd docs would remain in the tool chain, I just > want to remove the format when the docs are built for the FTP site. > > Comments? > [Snip cute little daemon and Nik's sig] Personally, I think it would be fine. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Sun May 18 14:40:26 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2AC7737B41A; Sun, 18 May 2003 14:40:26 -0700 (PDT) Received: from haakonia.hitnet.rwth-aachen.de (haakonia.hitnet.RWTH-Aachen.DE [137.226.181.92]) by mx1.FreeBSD.org (Postfix) with ESMTP id 76FEC43F75; Sun, 18 May 2003 14:40:25 -0700 (PDT) (envelope-from chris@unixpages.org) Received: from gondor.middleearth (gondor.middleearth [192.168.1.42]) by haakonia.hitnet.rwth-aachen.de (Postfix) with ESMTP id C482CA91E; Sun, 18 May 2003 23:40:24 +0200 (CEST) Received: by gondor.middleearth (Postfix, from userid 1001) id 55A8246E1; Sun, 18 May 2003 23:40:24 +0200 (CEST) Date: Sun, 18 May 2003 23:40:23 +0200 From: Christian Brueffer To: Nik Clayton Message-ID: <20030518214023.GK974@unixpages.org> References: <20030518195845.GB19455@clan.nothing-going-on.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="j/HO4hzKTNbM1mOX" Content-Disposition: inline In-Reply-To: <20030518195845.GB19455@clan.nothing-going-on.org> User-Agent: Mutt/1.4.1i X-Operating-System: FreeBSD 5.1-BETA X-PGP-Key: http://people.freebsd.org/~brueffer/brueffer.key.asc X-PGP-Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D cc: doc@freebsd.org Subject: Re: RFC: Dropping gzip'd docs on the FTP site X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 21:40:27 -0000 --j/HO4hzKTNbM1mOX Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, May 18, 2003 at 08:58:45PM +0100, Nik Clayton wrote: > Hi chaps, >=20 > At the moment the docs on the FTP site are available in gzip, bzip2, and > zip format. >=20 > How do people feel about dropping support for gzip? FreeBSD's shipped > with bzip for a while, and the zip format covers platforms where gzip or > bzip isn't common. >=20 > Support for building gzip'd docs would remain in the tool chain, I just > want to remove the format when the docs are built for the FTP site. >=20 > Comments? >=20 No problem with me. - Christian --=20 Christian Brueffer chris@unixpages.org brueffer@FreeBSD.org GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D --j/HO4hzKTNbM1mOX Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+x/3HbHYXjKDtmC0RAhO2AKDcnlFoofeClADo8XPQshWIei8qigCgmCY0 Up22oZQ1LDRIpjMaOlGfi4o= =w/V8 -----END PGP SIGNATURE----- --j/HO4hzKTNbM1mOX-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 15:11:25 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7454E37B401 for ; Sun, 18 May 2003 15:11:25 -0700 (PDT) Received: from sixshooter.v6.thrupoint.net (sixshooter.v6.thrupoint.net [65.242.152.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id C324F43FAF for ; Sun, 18 May 2003 15:11:24 -0700 (PDT) (envelope-from jpb@sixshooter.v6.thrupoint.net) Received: from sixshooter.v6.thrupoint.net (localhost.v6.thrupoint.net [127.0.0.1]) by sixshooter.v6.thrupoint.net (Postfix) with ESMTP id E062A4CF9 for ; Sun, 18 May 2003 18:11:23 -0400 (EDT) Received: (from jpb@localhost)h4IMBNWQ033686 for doc@freebsd.org; Sun, 18 May 2003 18:11:23 -0400 (EDT) Date: Sun, 18 May 2003 18:11:23 -0400 From: Jim Brown To: doc@freebsd.org Message-ID: <20030518221123.GA33669@sixshooter.v6.thrupoint.net> Mail-Followup-To: doc@freebsd.org References: <20030518195845.GB19455@clan.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030518195845.GB19455@clan.nothing-going-on.org> User-Agent: Mutt/1.4.1i Subject: Re: RFC: Dropping gzip'd docs on the FTP site X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 May 2003 22:11:25 -0000 * Nik Clayton [2003-05-18 15:59]: > Hi chaps, > > At the moment the docs on the FTP site are available in gzip, bzip2, and > zip format. > > How do people feel about dropping support for gzip? FreeBSD's shipped > with bzip for a while, and the zip format covers platforms where gzip or > bzip isn't common. > > Support for building gzip'd docs would remain in the tool chain, I just > want to remove the format when the docs are built for the FTP site. > > Comments? > > N > -- > FreeBSD: The Power to Serve http://www.freebsd.org/ (__) > FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) > \/ \ ^ > --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/_) Fine with me. Any particular reason? Is this another de-GNU-ity? Ruslan just had the same discussion on -CURRENT a few weeks ago. There was some controversy involving various tradeoffs with compression size, and processing time. Might want to review those just to make sure that the dial-up and low-bandwidth users aren't impacted. Wouldn't hurt to run benchmarks before and after as well. I'd do it myself, but it's Sunday afternoon and I'm too lazy :-) Best Regards, jpb === From owner-freebsd-doc@FreeBSD.ORG Sun May 18 17:20:04 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4CF9037B401 for ; Sun, 18 May 2003 17:20:04 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E4D3643F3F for ; Sun, 18 May 2003 17:20:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4J0K3Up039513 for ; Sun, 18 May 2003 17:20:03 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4J0K3gF039512; Sun, 18 May 2003 17:20:03 -0700 (PDT) Date: Sun, 18 May 2003 17:20:03 -0700 (PDT) Message-Id: <200305190020.h4J0K3gF039512@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" Subject: Re: docs/51897: Add example for disklable for md devices X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L. Nielsen" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 00:20:04 -0000 The following reply was made to PR docs/51897; it has been noted by GNATS. From: "Simon L. Nielsen" To: freebsd-gnats-submit@FreeBSD.org Cc: Subject: Re: docs/51897: Add example for disklable for md devices Date: Mon, 19 May 2003 02:17:23 +0200 --eJnRUKwClWJh1Khz Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Adding relevant part of notes by blackend@ and myself regarding this PR to the audit-trail. ----- Forwarded message from Marc Fonvieille ----- =46rom: Marc Fonvieille Date: Wed, 7 May 2003 20:36:49 +0200 To: "Simon L. Nielsen" Cc: freebsd-doc@FreeBSD.org User-Agent: Mutt/1.4i Subject: Re: docs/51897: Add example for disklable for md devices On Wed, May 07, 2003 at 10:58:48AM +0200, Simon L. Nielsen wrote: > > We shoould be consistent with other docs (Handbook etc..) i.e. > > disklabel -r -w md0 auto >=20 > Actually it was on purpose that I changed that. As I understand it '-r' > and 'auto' are not needed anymore post GEOM. The examples in > bsdlabel(8) does not use auto and this is the code handling '-r' : > Well I did not think about the brand new disklabel :( > case 'r': > /* > * We accept and ignode -r for compatibility with > * historically disklabel usage. > */ > break; >=20 > I would rather say that the rest of the docs should be change not to use > '-r' and 'auto' and perhaps add a compatibility note for FreeBSD < 5.0. >=20 You meant 5.1 I think. In the Handbook I would write that -r and auto options can be safely omitted on FreeBSD 5.1 and later. Marc ----- End forwarded message ----- --=20 Simon L. Nielsen --eJnRUKwClWJh1Khz Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yCKS8kocFXgPTRwRAsJZAKDPpVK61BqsvuJGAY5wEdkk1o3SbwCfRsbu t509Xg33Zflc/9MFaInpyYI= =2W+W -----END PGP SIGNATURE----- --eJnRUKwClWJh1Khz-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 18:37:10 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 119E537B401 for ; Sun, 18 May 2003 18:37:10 -0700 (PDT) Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by mx1.FreeBSD.org (Postfix) with ESMTP id 94D9743FAF for ; Sun, 18 May 2003 18:37:08 -0700 (PDT) (envelope-from grog@lemis.com) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id 8BB7C51A95; Mon, 19 May 2003 11:07:06 +0930 (CST) Date: Mon, 19 May 2003 11:07:06 +0930 From: Greg 'groggy' Lehey To: Ceri Davies , "M. Warner Losh" , doc@freebsd.org Message-ID: <20030519013706.GN77354@wantadilla.lemis.com> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="eWbcAUUbgrfSEG1c" Content-Disposition: inline In-Reply-To: <20030518160039.GA25804@submonkey.net> User-Agent: Mutt/1.4i Organization: The FreeBSD Project Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.FreeBSD.org/ X-PGP-Fingerprint: 9A1B 8202 BCCE B846 F92F 09AC 22E6 F290 507A 4223 Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 01:37:10 -0000 --eWbcAUUbgrfSEG1c Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Sunday, 18 May 2003 at 17:00:39 +0100, Ceri Davies wrote: > On Sun, May 18, 2003 at 09:52:26AM -0600, M. Warner Losh wrote: >> Is there a good docbook book that people can recommend? > > Although there are others, O'Reilly's DocBook: The Definitive Guide > is probably the best, and it's free too (www.docbook.org or the > textproc/docbook-tdg port). I have it, and I can't recommend it. Despite the name, it's a reference, not a guide. For an example of the kind of book I'm looking for, see http://www.alltel.net/~kollar/utp/. That's about troff, not DocBook, but it's a well written book. I don't think anything similar is available for DocBook. Greg -- See complete headers for address and phone numbers --eWbcAUUbgrfSEG1c Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) iD8DBQE+yDVCIubykFB6QiMRAvUmAKClWnW+FYLV1jmfFi0SGEHaS1IZ2wCfQRdw y6u/PPeioceyKd3aPMbewf8= =PESC -----END PGP SIGNATURE----- --eWbcAUUbgrfSEG1c-- From owner-freebsd-doc@FreeBSD.ORG Sun May 18 22:30:18 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1876937B401 for ; Sun, 18 May 2003 22:30:18 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2605743F85 for ; Sun, 18 May 2003 22:30:17 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4J5UGUp068989 for ; Sun, 18 May 2003 22:30:17 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4J5UGxo068988; Sun, 18 May 2003 22:30:16 -0700 (PDT) Resent-Date: Sun, 18 May 2003 22:30:16 -0700 (PDT) Resent-Message-Id: <200305190530.h4J5UGxo068988@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, Malcolm Kay Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4F80937B401 for ; Sun, 18 May 2003 22:29:05 -0700 (PDT) Received: from smtp0.adl1.internode.on.net (smtp0.adl1.internode.on.net [203.16.214.194]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5921B43F85 for ; Sun, 18 May 2003 22:29:04 -0700 (PDT) (envelope-from malcolm.kay@internode.on.net) Received: from beta.home (ppp364.sa.padsl.internode.on.net [150.101.245.107]) h4J5T2MO038769 for ; Mon, 19 May 2003 14:59:02 +0930 (CST) Message-Id: <200305191459.02203.malcolm.kay@internode.on.net> Date: Mon, 19 May 2003 14:59:02 +0930 From: Malcolm Kay To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/52419: Downloaded handbook errors on un-tar-ing X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 05:30:18 -0000 >Number: 52419 >Category: docs >Synopsis: Downloaded handbook errors on un-tar-ing >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: Sun May 18 22:30:16 PDT 2003 >Closed-Date: >Last-Modified: >Originator: malcolm kay >Release: FreeBSD 4.7-STABLE i386 >Organization: at home >Environment: System: FreeBSD beta.home 4.7-STABLE FreeBSD 4.7-STABLE #0: Sun Feb 23 01:18:55 CST 2003 =20 malcolm@beta.home:/usr/src/sys/compile/SOUND i386 = =20 = =20 >Description: = =20 Downloaded Handbook archive contains '..' in some paths; rejected by = tar =20 >How-To-Repeat: = =20 # ftp \=20 ftp://ftp.freebsd.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/handbook/book= =2Ehtml.tar.gz =20 # tar zxf book.html.tar.gz = =20 >Fix: = =20 Work around: Download immages individually from Web version using bro= wser. =20 Fix: Re-archive without '..' in path names. >Release-Note: >Audit-Trail: >Unformatted: X-send-pr-version: 3.113 X-GNATS-Notify: From owner-freebsd-doc@FreeBSD.ORG Mon May 19 00:09:23 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E3A8A37B401; Mon, 19 May 2003 00:09:23 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4F41643F85; Mon, 19 May 2003 00:09:23 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4J799cu010239; Mon, 19 May 2003 00:09:09 -0700 (PDT) (envelope-from murray) Date: Mon, 19 May 2003 00:09:08 -0700 From: Murray Stokely To: "Greg 'groggy' Lehey" Message-ID: <20030519000908.E8403@freebsdmall.com> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> <20030519013706.GN77354@wantadilla.lemis.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20030519013706.GN77354@wantadilla.lemis.com>; from grog@FreeBSD.org on Mon, May 19, 2003 at 11:07:06AM +0930 X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@FreeBSD.org cc: "M. Warner Losh" Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 07:09:24 -0000 On Mon, May 19, 2003 at 11:07:06AM +0930, Greg 'groggy' Lehey wrote: > I have it, and I can't recommend it. Despite the name, it's a > reference, not a guide. For an example of the kind of book I'm > looking for, see http://www.alltel.net/~kollar/utp/. That's about > troff, not DocBook, but it's a well written book. I don't think > anything similar is available for DocBook. I can recommend DocBook TDG strongly if you are trying to author something in DocBook for the first time. The whole point of SGML is that it is a totally different paradigm from something like troff. Authors aren't supposed to have to worry abou the complications of presentation. This book teaches you the tags that have been defined to describe technical content. It is another problem domain (usually dealt with by a separate person) to write an XML application to query that document for semantic information, process the SGML document and turn it into another output format, process the SGML document and create a audio rendering, etc.. The book you reference has chapters on learning vi, Unix fundamentals, and all kinds of typesetting information, all of which is completely irrellevant in the SGML/XML world. I'm sure it's a great book on troff, but it's not a fair comparison. If Warner would like to know more about the process of rendering DocBook SGML files into different output formats, then the wrong question was asked and a different book would have been recommended. - Murray From owner-freebsd-doc@FreeBSD.ORG Mon May 19 01:04:59 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5328237B401; Mon, 19 May 2003 01:04:59 -0700 (PDT) Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6597343F3F; Mon, 19 May 2003 01:04:56 -0700 (PDT) (envelope-from grog@lemis.com) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id ACEF951A95; Mon, 19 May 2003 17:34:52 +0930 (CST) Date: Mon, 19 May 2003 17:34:52 +0930 From: Greg 'groggy' Lehey To: Murray Stokely Message-ID: <20030519080452.GR77354@wantadilla.lemis.com> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> <20030519013706.GN77354@wantadilla.lemis.com> <20030519000908.E8403@freebsdmall.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="LfQcPIWFRhGivmDw" Content-Disposition: inline In-Reply-To: <20030519000908.E8403@freebsdmall.com> User-Agent: Mutt/1.4i Organization: The FreeBSD Project Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.FreeBSD.org/ X-PGP-Fingerprint: 9A1B 8202 BCCE B846 F92F 09AC 22E6 F290 507A 4223 cc: doc@FreeBSD.org cc: "M. Warner Losh" Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 08:04:59 -0000 --LfQcPIWFRhGivmDw Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Monday, 19 May 2003 at 0:09:08 -0700, Murray Stokely wrote: > On Mon, May 19, 2003 at 11:07:06AM +0930, Greg 'groggy' Lehey wrote: >> I have it, and I can't recommend it. Despite the name, it's a >> reference, not a guide. For an example of the kind of book I'm >> looking for, see http://www.alltel.net/~kollar/utp/. That's about >> troff, not DocBook, but it's a well written book. I don't think >> anything similar is available for DocBook. > > I can recommend DocBook TDG strongly if you are trying to author > something in DocBook for the first time. That's exactly what I was trying to do. I can't recommend it. > The whole point of SGML is that it is a totally different paradigm > from something like troff. Authors aren't supposed to have to worry > abou the complications of presentation. I have a problem with that, but I don't think it's relevant. > This book teaches you the tags that have been defined to describe > technical content. It is another problem domain (usually dealt with > by a separate person) to write an XML application to query that > document for semantic information, process the SGML document and > turn it into another output format, process the SGML document and > create a audio rendering, etc.. I can accept that division of labour. But they're both part of DocBook. > The book you reference has chapters on learning vi, Unix > fundamentals, and all kinds of typesetting information, all of which > is completely irrellevant in the SGML/XML world. Certainly the chapters about vi and UNIX in general are irrelevant. But it also has chapters leading you through how to create a document, how to influence the layout, etc. You may say "but you shouldn't be influencing the layout", but I disagree. If I want, say, to write a letter or a set of slides in DocBook, I need to know how to get the effects I want. This book doesn't tell me. In the case in point, I was writing my book "The Complete FreeBSD". O'Reilly supplied the presentation details you refer to above, so I really only needed to do what you say the book is for. In addition, since it's an O'Reilly book, you would expect it to be a particularly good match. In fact, I found it almost useless. O'Reilly did supply me with a basic introduction to how to do things, and apologized for not having anything better, so I'm sure they recognize the problem. In the end I gave up and wrote in groff. > If Warner would like to know more about the process of rendering > DocBook SGML files into different output formats, then the wrong > question was asked and a different book would have been recommended. Out of interest, which one? Greg -- See complete headers for address and phone numbers --LfQcPIWFRhGivmDw Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) iD8DBQE+yJAkIubykFB6QiMRAt1hAJ0dEsLk4JGPUifaJMATrO2Bq7mofQCfdsTg gJo7ZADxHDL/mF1GP2VR36M= =hUIm -----END PGP SIGNATURE----- --LfQcPIWFRhGivmDw-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 01:59:35 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D99E437B401 for ; Mon, 19 May 2003 01:59:34 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 487AF43F3F for ; Mon, 19 May 2003 01:59:33 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4J8xVYx007847; Mon, 19 May 2003 10:59:31 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4J8xZBM015249; Mon, 19 May 2003 10:59:35 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4J8xY8E015248; Mon, 19 May 2003 10:59:34 +0200 (CEST) (envelope-from marc) Date: Mon, 19 May 2003 10:59:34 +0200 From: Marc Fonvieille To: "Simon L. Nielsen" Message-ID: <20030519085934.GA553@nosferatu.blackend.org> References: <200305190020.h4J0K3gF039512@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200305190020.h4J0K3gF039512@freefall.freebsd.org> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: freebsd-doc@FreeBSD.org Subject: Re: docs/51897: Add example for disklable for md devices X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 08:59:35 -0000 On Sun, May 18, 2003 at 05:20:03PM -0700, Simon L. Nielsen wrote: > The following reply was made to PR docs/51897; it has been noted by GNATS. > > From: "Simon L. Nielsen" > To: freebsd-gnats-submit@FreeBSD.org > Cc: > Subject: Re: docs/51897: Add example for disklable for md devices > Date: Mon, 19 May 2003 02:17:23 +0200 > > --eJnRUKwClWJh1Khz > Content-Type: text/plain; charset=us-ascii > Content-Disposition: inline > Content-Transfer-Encoding: quoted-printable > > Adding relevant part of notes by blackend@ and myself regarding this PR > to the audit-trail. > [...] Hmmm, I am not really happy with this. If you want to quote me: - please quote all thread not only one post, - maybe ask my opinion first. and I'm not sure my sentences (and the thread) were so revelant to be in this PR. Marc From owner-freebsd-doc@FreeBSD.ORG Mon May 19 02:06:31 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 199FA37B401; Mon, 19 May 2003 02:06:31 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id AD60D43F3F; Mon, 19 May 2003 02:06:30 -0700 (PDT) (envelope-from blackend@FreeBSD.org) Received: from freefall.freebsd.org (blackend@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4J96UUp091735; Mon, 19 May 2003 02:06:30 -0700 (PDT) (envelope-from blackend@freefall.freebsd.org) Received: (from blackend@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4J96Uv9091731; Mon, 19 May 2003 02:06:30 -0700 (PDT) Date: Mon, 19 May 2003 02:06:30 -0700 (PDT) From: Marc Fonvieille Message-Id: <200305190906.h4J96Uv9091731@freefall.freebsd.org> To: blackend@FreeBSD.org, freebsd-doc@FreeBSD.org, blackend@FreeBSD.org Subject: Re: docs/51897: Add example for disklable for md devices X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 09:06:31 -0000 Synopsis: Add example for disklable for md devices Responsible-Changed-From-To: freebsd-doc->blackend Responsible-Changed-By: blackend Responsible-Changed-When: Mon May 19 02:05:37 PDT 2003 Responsible-Changed-Why: I will take it since I'm in the audit-trail. http://www.freebsd.org/cgi/query-pr.cgi?pr=51897 From owner-freebsd-doc@FreeBSD.ORG Mon May 19 02:13:19 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3006937B401; Mon, 19 May 2003 02:13:19 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id 66D0C43FA3; Mon, 19 May 2003 02:13:18 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4J9DBoG010524; Mon, 19 May 2003 02:13:11 -0700 (PDT) (envelope-from murray) Date: Mon, 19 May 2003 02:13:10 -0700 From: Murray Stokely To: "Greg 'groggy' Lehey" Message-ID: <20030519021310.F8403@freebsdmall.com> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> <20030519013706.GN77354@wantadilla.lemis.com> <20030519000908.E8403@freebsdmall.com> <20030519080452.GR77354@wantadilla.lemis.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20030519080452.GR77354@wantadilla.lemis.com>; from grog@FreeBSD.org on Mon, May 19, 2003 at 05:34:52PM +0930 X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@FreeBSD.org cc: "M. Warner Losh" Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 09:13:19 -0000 On Mon, May 19, 2003 at 05:34:52PM +0930, Greg 'groggy' Lehey wrote: > > The whole point of SGML is that it is a totally different paradigm > > from something like troff. Authors aren't supposed to have to worry > > abou the complications of presentation. > > I have a problem with that, but I don't think it's relevant. Well then you have a problem with the whole paradigm behind SGML and DocBook, and it's clear why you don't like it. The first chapter of the book in question says : "An SGML document contains all the information that a typesetter needs to lay out and typeset a printed page in the most effective and consistent way, but it does not specify the layout or the type." Yet it seems like this is exactly what your complaint is about. At least, I can't find any other complaints about DocBook in this or other messages from you except that you can't control the formatting like you can with nroff. That's fine, I'm a fan of TeX myself. > > This book teaches you the tags that have been defined to describe > > technical content. It is another problem domain (usually dealt with > > by a separate person) to write an XML application to query that > > document for semantic information, process the SGML document and > > turn it into another output format, process the SGML document and > > create a audio rendering, etc.. > > I can accept that division of labour. But they're both part of > DocBook. No they're not. DocBook (as with other SGML DTDs) has almost no typesetting information. This is a silly conversation, Greg. I know you know what semantic markup is, and it's clearly at odds with the way you prefer to work. In the FDP, the presentation of the DocBook SGML is done with Jade and DSSSL stylesheets. > But it also has chapters leading you through how to create a document, > how to influence the layout, etc. You may say "but you shouldn't be > influencing the layout", but I disagree. If I want, say, to write a > letter or a set of slides in DocBook, I need to know how to get the > effects I want. This book doesn't tell me. DocBook would be a poor choice for writing a letter. That's well outside of what it is intended to do. Slides are pretty far also but some modifications have been made into a separate slide-like DTD/schema and some example stylesheets to create slide PDFs. You can find the slide DTD here : http://sourceforge.net/projects/docbook I wouldn't waste my own time trying to create a presentation with DocBook though. > In the case in point, I was writing my book "The Complete FreeBSD". > O'Reilly supplied the presentation details you refer to above, so I > really only needed to do what you say the book is for. In addition, > since it's an O'Reilly book, you would expect it to be a particularly > good match. In fact, I found it almost useless. O'Reilly did supply > me with a basic introduction to how to do things, and apologized for > not having anything better, so I'm sure they recognize the problem. > In the end I gave up and wrote in groff. In this entire paragraph you haven't said what your problem was, or why you found it useless. I can only infer that you still have complaints that it is not nroff and that you can't control the typesetting. That is fine but it's not a failing of the DocBook DTD. What tags could be added to this DTD to make it acceptable to you? None, because your complaints aren't about the DocBook DTD, they are about the entire paradigm. > > If Warner would like to know more about the process of rendering > > DocBook SGML files into different output formats, then the wrong > > question was asked and a different book would have been recommended. > > Out of interest, which one? One of the many XSLT books by O'Reilly or the larger XSLT book by Wrox Press. We use DSSSL stylesheets in the FDP but DSSSL didn't catch on with the rest of the world because the lisp-based stylesheet language is programmer and implementor-unfriendly. Both DSSSL and XSLT are standard languages to transform XML/SGML documents. I'm not even aware of any printed books about DSSSL, but there are tens of books about XSLT. - Murray From owner-freebsd-doc@FreeBSD.ORG Mon May 19 04:20:13 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C73BF37B401 for ; Mon, 19 May 2003 04:20:13 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id DFCAB43FDF for ; Mon, 19 May 2003 04:20:12 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4JBKCUp019721 for ; Mon, 19 May 2003 04:20:12 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4JBKCU5019720; Mon, 19 May 2003 04:20:12 -0700 (PDT) Resent-Date: Mon, 19 May 2003 04:20:12 -0700 (PDT) Resent-Message-Id: <200305191120.h4JBKCU5019720@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, Bob Bishop Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CFB7F37B401 for ; Mon, 19 May 2003 04:19:11 -0700 (PDT) Received: from gidgate.gid.co.uk (gid.co.uk [194.32.164.225]) by mx1.FreeBSD.org (Postfix) with ESMTP id 849A443FBF for ; Mon, 19 May 2003 04:19:10 -0700 (PDT) (envelope-from rb@gid.co.uk) Received: (from rb@localhost) by gidgate.gid.co.uk (8.11.6/8.11.6) id h4JBJ8T75763; Mon, 19 May 2003 12:19:08 +0100 (BST) (envelope-from rb) Message-Id: <200305191119.h4JBJ8T75763@gidgate.gid.co.uk> Date: Mon, 19 May 2003 12:19:08 +0100 (BST) From: Bob Bishop To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 cc: rb@gidgate.gid.co.uk Subject: docs/52426: Update hardware notes to reflect kern/50427 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Bob Bishop List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 11:20:14 -0000 >Number: 52426 >Category: docs >Synopsis: Update hardware notes to reflect kern/50427 >Confidential: no >Severity: non-critical >Priority: high >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Mon May 19 04:20:12 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Bob Bishop >Release: FreeBSD 5.0-CURRENT i386 >Organization: GID ltd >Environment: >Description: kern/50427 requires update to hardware notes. >How-To-Repeat: >Fix: Apply the following to hardware-i386.html (diff against 5.0-R) (I don't know whether this is relevant to any other archs): begin 644 hardware-i386.html.diff M+2TM(&AA"\T.31X"BL@("`@("`@("`@("`@(#$Y,38P M+S(Y,7@O,CDR,$,O,CDS,"\R.30P+S(Y-3`O,CDQ-C`O,SDT,"\S.34P+S,Y M-C`O,SDQ-C`O,SDX>"\T.31X"B`@("`@("`@("`@("`@('-ERelease-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon May 19 04:21:38 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AFEA737B401; Mon, 19 May 2003 04:21:38 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4F4C143F3F; Mon, 19 May 2003 04:21:38 -0700 (PDT) (envelope-from blackend@FreeBSD.org) Received: from freefall.freebsd.org (blackend@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4JBLcUp020580; Mon, 19 May 2003 04:21:38 -0700 (PDT) (envelope-from blackend@freefall.freebsd.org) Received: (from blackend@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4JBLcNa020576; Mon, 19 May 2003 04:21:38 -0700 (PDT) Date: Mon, 19 May 2003 04:21:38 -0700 (PDT) From: Marc Fonvieille Message-Id: <200305191121.h4JBLcNa020576@freefall.freebsd.org> To: blackend@FreeBSD.org, freebsd-doc@FreeBSD.org, blackend@FreeBSD.org Subject: Re: docs/52419: Downloaded handbook errors on un-tar-ing X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 11:21:39 -0000 Synopsis: Downloaded handbook errors on un-tar-ing Responsible-Changed-From-To: freebsd-doc->blackend Responsible-Changed-By: blackend Responsible-Changed-When: Mon May 19 04:20:41 PDT 2003 Responsible-Changed-Why: It is a "side-effect" from images separation. I will work on the fix. http://www.freebsd.org/cgi/query-pr.cgi?pr=52419 From owner-freebsd-doc@FreeBSD.ORG Mon May 19 04:35:52 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 780CD37B401 for ; Mon, 19 May 2003 04:35:52 -0700 (PDT) Received: from thalia.otenet.gr (thalia.otenet.gr [195.170.0.8]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6038943FBD for ; Mon, 19 May 2003 04:35:51 -0700 (PDT) (envelope-from keramida@freebsd.org) Received: from gothmog.gr (patr530-b231.otenet.gr [212.205.244.239]) by thalia.otenet.gr (8.12.9/8.12.9) with ESMTP id h4JBZbP7028333 for ; Mon, 19 May 2003 14:35:46 +0300 (EEST) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.9/8.12.9) with ESMTP id h4JBZ9WI001353 for ; Mon, 19 May 2003 14:35:24 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.gr (8.12.9/8.12.9/Submit) id h4INQbQs002612 for doc@freebsd.org; Mon, 19 May 2003 02:26:37 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Mon, 19 May 2003 02:26:37 +0300 From: Giorgos Keramidas To: doc@freebsd.org Message-ID: <20030518232637.GA2546@gothmog.gr> References: <20030518195845.GB19455@clan.nothing-going-on.org> <20030518221123.GA33669@sixshooter.v6.thrupoint.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030518221123.GA33669@sixshooter.v6.thrupoint.net> Subject: Re: RFC: Dropping gzip'd docs on the FTP site X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 11:35:52 -0000 On 2003-05-18 18:11, Jim Brown wrote: >* Nik Clayton [2003-05-18 15:59]: >> >> At the moment the docs on the FTP site are available in gzip, bzip2, and >> zip format. >> >> How do people feel about dropping support for gzip? FreeBSD's shipped >> with bzip for a while, and the zip format covers platforms where gzip or >> bzip isn't common. > > Fine with me. Any particular reason? Is this another de-GNU-ity? It'll also save some space (and lots of i-nodes) on the ftp master and its mirrors. Go fer it :) From owner-freebsd-doc@FreeBSD.ORG Mon May 19 07:16:33 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8411537B401 for ; Mon, 19 May 2003 07:16:33 -0700 (PDT) Received: from hotmail.com (bay1-f29.bay1.hotmail.com [65.54.245.29]) by mx1.FreeBSD.org (Postfix) with ESMTP id 21CEC43F93 for ; Mon, 19 May 2003 07:16:33 -0700 (PDT) (envelope-from callowaysi@hotmail.com) Received: from mail pickup service by hotmail.com with Microsoft SMTPSVC; Mon, 19 May 2003 07:16:32 -0700 Received: from 192.33.240.30 by by1fd.bay1.hotmail.msn.com with HTTP; Mon, 19 May 2003 14:16:32 GMT X-Originating-IP: [192.33.240.30] X-Originating-Email: [callowaysi@hotmail.com] From: "Michael Calloway" To: doc@freebsd.org Date: Mon, 19 May 2003 14:16:32 +0000 Message-ID: X-OriginalArrivalTime: 19 May 2003 14:16:32.0921 (UTC) FILETIME=[3FBE2890:01C31E11] MIME-Version: 1.0 Content-Type: text/plain X-Content-Filtered-By: Mailman/MimeDel 2.1.1 Subject: Kernel Rebuilding on FreeBSD 5.x X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 14:16:33 -0000 I am trying to work with FreeBSD 5.x. I recently d/l 5.1-Beta, and I understand the signigficanceand gravity of a BETA. But I can't find any docs on re-compiling a custom kernel.Would you please point me in the right direction, please? TIA Mike ...and I get to keep the equipment when we're done. (Luther, from Mission Impossible 1) Live Free Or Die Power To Serve! _________________________________________________________________ MSN 8 with [1]e-mail virus protection service: 2 months FREE* References 1. http://g.msn.com/8HMRENUS/2740??PS= From owner-freebsd-doc@FreeBSD.ORG Mon May 19 08:02:51 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 72C4137B401 for ; Mon, 19 May 2003 08:02:51 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9CF2A43F3F for ; Mon, 19 May 2003 08:02:50 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JF2nka011479; Mon, 19 May 2003 11:02:49 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 10:55:32 -0400 From: Tom Rhodes To: "Michael Calloway" Message-Id: <20030519105532.7cc40947.trhodes@FreeBSD.org> In-Reply-To: References: X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: Kernel Rebuilding on FreeBSD 5.x X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 15:02:51 -0000 Hello Michael, On Mon, 19 May 2003 14:16:32 +0000 "Michael Calloway" wrote: > > I am trying to work with FreeBSD 5.x. I recently d/l 5.1-Beta, and I > understand the signigficanceand gravity of a BETA. But I can't find > any docs on re-compiling a custom kernel.Would you please point me in > the right direction, please? TIA > > Mike > ...and I get to keep the equipment when we're done. > The information in our handbook should be 99% applicable to FreeBSD 5.1-Beta. If you see a significant difference between the information located here: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html and your environment, please let us know and we will fix ASAP! If you need help on a specific problem, (hardware or otherwise) you can always email questions@FreeBSD.org, or check the appropriate handbook chapter/section. Thanks, -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Mon May 19 09:27:36 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BBBB037B401; Mon, 19 May 2003 09:27:36 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1925C43FAF; Mon, 19 May 2003 09:27:36 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 70FB010BF81; Mon, 19 May 2003 18:27:34 +0200 (CEST) Date: Mon, 19 May 2003 18:27:34 +0200 From: "Simon L. Nielsen" To: Marc Fonvieille Message-ID: <20030519162733.GA406@nitro.dk> References: <200305190020.h4J0K3gF039512@freefall.freebsd.org> <20030519085934.GA553@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="HcAYCG3uE/tztfnV" Content-Disposition: inline In-Reply-To: <20030519085934.GA553@nosferatu.blackend.org> User-Agent: Mutt/1.5.4i cc: freebsd-doc@FreeBSD.org Subject: Re: docs/51897: Add example for disklable for md devices X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 16:27:37 -0000 --HcAYCG3uE/tztfnV Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.19 10:59:34 +0200, Marc Fonvieille wrote: > On Sun, May 18, 2003 at 05:20:03PM -0700, Simon L. Nielsen wrote: > > The following reply was made to PR docs/51897; it has been noted by GNA= TS. > >=20 > > From: "Simon L. Nielsen" > > To: freebsd-gnats-submit@FreeBSD.org > > Cc: =20 > > Subject: Re: docs/51897: Add example for disklable for md devices > > Date: Mon, 19 May 2003 02:17:23 +0200 > >=20 > > --eJnRUKwClWJh1Khz > > Content-Type: text/plain; charset=3Dus-ascii > > Content-Disposition: inline > > Content-Transfer-Encoding: quoted-printable > > =20 > > Adding relevant part of notes by blackend@ and myself regarding this PR > > to the audit-trail. > > > [...] >=20 > Hmmm, I am not really happy with this. > If you want to quote me:=20 >=20 > - please quote all thread not only one post, > - maybe ask my opinion first. >=20 > and I'm not sure my sentences (and the thread) were so revelant to > be in this PR. Sorry about that, I just though other might have the same reservations you had if they look at the PR at a later time and thought that the one mail summed up the issue. Again sorry! I didn't want to put words in your mouth or anything like that. --=20 Simon L. Nielsen --HcAYCG3uE/tztfnV Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yQX18kocFXgPTRwRAo5bAJ9suaaKfQ/OCYBWaBq4Y11klCIx6QCbBtTS bh6kqaHnYVwi0L88hmafcAc= =ldTR -----END PGP SIGNATURE----- --HcAYCG3uE/tztfnV-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 10:46:31 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B627937B407 for ; Mon, 19 May 2003 10:46:31 -0700 (PDT) Received: from crf-consulting.co.uk (pc-62-31-42-106-hy.blueyonder.co.uk [62.31.42.106]) by mx1.FreeBSD.org (Postfix) with ESMTP id 48C7943F3F for ; Mon, 19 May 2003 10:46:29 -0700 (PDT) (envelope-from nik@crf-consulting.co.uk) Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20]) by crf-consulting.co.uk (8.12.3/8.12.3) with ESMTP id h4JHkRRf030155 for ; Mon, 19 May 2003 18:46:27 +0100 (BST) (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) h4JHkRLG016440 for ; Mon, 19 May 2003 18:46:27 +0100 (BST) (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost) by clan.nothing-going-on.org (8.12.8/8.12.8/Submit) id h4JHkRmb016439 for doc@freebsd.org; Mon, 19 May 2003 18:46:27 +0100 (BST) Date: Mon, 19 May 2003 18:46:26 +0100 From: Nik Clayton To: doc@freebsd.org Message-ID: <20030519174626.GA16422@clan.nothing-going-on.org> References: <20030518195845.GB19455@clan.nothing-going-on.org> <20030518221123.GA33669@sixshooter.v6.thrupoint.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ZGiS0Q5IWpPtfppv" Content-Disposition: inline In-Reply-To: <20030518221123.GA33669@sixshooter.v6.thrupoint.net> User-Agent: Mutt/1.4i Organization: FreeBSD Project Subject: Re: RFC: Dropping gzip'd docs on the FTP site X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 17:46:32 -0000 --ZGiS0Q5IWpPtfppv Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, May 18, 2003 at 06:11:23PM -0400, Jim Brown wrote: > Fine with me. Any particular reason? Is this another de-GNU-ity? Nothing GNU related -- it should just cut down on the amount of data that needs to get transferred between the mirrors (and my home system, where the doc/ tree's built). N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ (__) FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) \/ \= ^ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/= _) --ZGiS0Q5IWpPtfppv Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yRhyk6gHZCw343URAqXVAJsGeuw//Wg2LQUtJb2dwt65wY0P5wCbBpqq 4PCXzpIHR0yBDACUch9NpBM= =SnLj -----END PGP SIGNATURE----- --ZGiS0Q5IWpPtfppv-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 11:00:37 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E654E37B401 for ; Mon, 19 May 2003 11:00:37 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8967943F93 for ; Mon, 19 May 2003 11:00:35 -0700 (PDT) (envelope-from owner-bugmaster@freebsd.org) Received: from freefall.freebsd.org (peter@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4JI0ZUp063284 for ; Mon, 19 May 2003 11:00:35 -0700 (PDT) (envelope-from owner-bugmaster@freebsd.org) Received: (from peter@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4JI0YSg063278 for freebsd-doc@freebsd.org; Mon, 19 May 2003 11:00:34 -0700 (PDT) Date: Mon, 19 May 2003 11:00:34 -0700 (PDT) Message-Id: <200305191800.h4JI0YSg063278@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: peter set sender to owner-bugmaster@freebsd.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 18:00:38 -0000 Current FreeBSD problem reports 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. Bugs can be in one of several states: o - open A problem report has been submitted, no sanity checking performed. a - analyzed The problem is understood and a solution is being sought. f - feedback Further work requires additional information from the originator or the community - possibly confirmation of the effectiveness of a proposed solution. p - patched A patch has been committed, but some issues (MFC and / or confirmation from originator) are still open. s - suspended The problem is not being worked on, due to lack of information or resources. This is a prime candidate for somebody who is looking for a project to do. If the problem cannot be solved at all, it will be closed, rather than suspended. c - closed A problem report is closed when any changes have been integrated, documented, and tested -- or when fixing the problem is abandoned. Critical problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- a [2001/10/31] i386/31671 doc 4.4 installer hangs at " Mounting root fr 1 problem total. Serious problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- s [1999/10/04] i386/14135 doc lpt1 nolonger exists after 3.2-RELEASE s [2000/07/18] docs/20028 doc ASCII docs should reflect tags o [2001/05/23] docs/27605 doc Cross-document references () o [2002/01/15] ports/33929 doc Section 15.15 of the FreeBSD Porter's Han s [2002/03/08] docs/35678 doc docproj Makefiles for web are broken for o [2002/03/21] docs/36168 doc -pthread/_THREAD_SAFE docs missing in gcc o [2002/09/13] docs/42762 doc ppp.8 has no description of $env and ~use o [2002/10/07] docs/43776 doc /etc/sshd_config settings overridden by P o [2002/11/14] docs/45303 doc Bug in PDF DocBook rendering o [2002/12/15] docs/46286 doc there's an omission and an error in the n o [2003/02/19] docs/48472 doc Documentation unreadable. 11 problems total. Non-critical problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- o [2001/02/01] docs/24786 doc missing FILES descriptions in sa(4) o [2001/04/29] docs/26943 doc [patch] description of :C modifier is mis o [2001/07/26] docs/29245 doc top(1) manpage doesn't understand SMP a [2001/08/23] docs/30008 doc This document should be translated, comme o [2001/09/27] docs/30873 doc ``ip'' man page does not specify byte ord o [2001/10/07] docs/31109 doc replace gif images w/ png ones due to pat o [2001/10/09] docs/31164 doc man page for strftime is incorrect o [2001/11/15] docs/32020 doc loader.8 manpage missing tunables o [2001/11/16] docs/32054 doc inconsistency between index.3 and rindex. o [2002/01/05] docs/33589 doc Patch to doc.docbook.mk to post process . o [2002/01/13] docs/33852 doc split(1) man page implies that input file o [2002/01/14] docs/33877 doc Documentet behaviour of SF_flags for non- o [2002/01/15] misc/33926 doc Search function on website can not access o [2002/02/15] bin/34955 doc [PATCH] ps(1) is out of touch with realit a [2002/02/16] docs/35011 doc There are no commands called "diskless" o o [2002/02/22] docs/35222 doc mailing list archive URL regexp suboptima o [2002/03/06] docs/35602 doc dump(8)/restore(8) pages don't explain "a o [2002/03/06] docs/35607 doc dump(1) page needs discussion of scary er o [2002/03/06] docs/35608 doc mt(1) page uses "setmark" without explana o [2002/03/06] docs/35609 doc mt(1) page needs explanation of "long era o [2002/03/06] docs/35612 doc ps(1) page "state" description doesn't me o [2002/03/07] docs/35642 doc lo(4) page maybe should document optional o [2002/03/07] docs/35644 doc lo(4) page presumes familiarity with prin o [2002/03/07] docs/35646 doc cp(1) page needs a "Bugs" section. o [2002/03/07] docs/35647 doc www; combine query-by-number and multi-fi o [2002/03/07] docs/35648 doc rc.conf; add note about "flags" to both f o [2002/03/07] docs/35649 doc mount_smbfs(8) page: "See ./examples/dot. o [2002/03/08] docs/35686 doc blackhole(4) page seems to contradict its o [2002/03/08] docs/35687 doc /etc/nsmb.conf missing mention of readers o [2002/03/10] docs/35732 doc adduser(8) page has obsolete reference an o [2002/03/15] docs/35941 doc cd(4) manual doesn't mention "target" use o [2002/03/15] docs/35943 doc at(1) config files are misplaced in /var/ o [2002/03/15] docs/35953 doc hosts.equiv(5) manual is confusing or wro o [2002/03/20] misc/36154 doc Getting USB mouse to work: usbd and mouse o [2002/03/28] docs/36432 doc Proposal for doc/share/mk: make folded bo o [2002/03/28] docs/36449 doc symlink(7) manual doesn't mention trailin o [2002/03/28] docs/36459 doc tftp(1) manual's "get" syntax/description o [2002/04/01] docs/36628 doc header an footer of openssl manpages are o [2002/05/03] docs/37719 doc Detail VOP_ naming in a relevant man-page s [2002/05/07] docs/37843 doc manual for pthread_setschedparam is wrong o [2002/05/18] docs/38225 doc change "CDROM" to "CD-ROM" o [2002/05/25] docs/38556 doc EPS file of beastie, as addition to exist o [2002/05/27] docs/38620 doc Committers Guide and CVS o [2002/05/31] docs/38772 doc firewall_type feature not mentioned on Ha o [2002/06/07] docs/38982 doc developers-hanbook/Jail fix o [2002/06/10] docs/39129 doc handbook; type WRT simulating postscript o [2002/06/12] docs/39213 doc No rc(4) man page o [2002/06/15] docs/39348 doc kenv fetch of hostname requires dhcp/boot o [2002/06/19] docs/39530 doc access(2) man page has unnecessarily broa o [2002/06/19] docs/39532 doc 'find' man page should o [2002/06/24] docs/39824 doc Various tweaks for doc/en_US.ISO8859-1/bo o [2002/07/04] docs/40196 doc man find does not describe -follow o [2002/07/10] docs/40423 doc Keyboard(4)'s definition of parameters to o [2002/07/10] docs/40443 doc Update books/faq/book.sgml for USB .ko's o [2002/07/21] docs/40851 doc [PATCH] "mergemaster -p" in UPDATING's "C o [2002/07/28] docs/41089 doc pax -B option does not mention interactio o [2002/07/29] docs/41110 doc "apropos linux" doesn't find brandelf o [2002/08/02] docs/41270 doc confusing directions for kernelconfig cha o [2002/08/07] docs/41423 doc Update FAQ: attrib command for windows du o [2002/08/18] docs/41761 doc Update for /ru/internal/ part of site o [2002/08/19] docs/41787 doc man page for route (Section 8) missing de o [2002/08/19] docs/41791 doc Documentation formatting error o [2002/08/19] docs/41807 doc natd -punch_fw "bug" o [2002/08/20] docs/41820 doc Device driver confusion in Handbook (2.3) o [2002/08/22] docs/41919 doc MINI kernel for bootfloppy (Handbook p.34 a [2002/08/27] docs/42058 doc Documentation: Installing Oracle 8i onto o [2002/09/27] docs/43416 doc pw(8) -u uidmin,uidmax feature is out of o [2002/10/01] docs/43569 doc src/share/examples/worm/README out-of-dat o [2002/10/04] docs/43651 doc stab(5) incorrectly states to include jus o [2002/10/09] docs/43861 doc non-trivial typo in wicontrol man page f [2002/10/09] docs/43864 doc Minor documentation to add o [2002/10/11] docs/43941 doc Rationale for Upgrade Sequence o [2002/10/14] docs/44074 doc ln(1) manual clarifications [patch] o [2002/10/21] docs/44337 doc [PATCH] netstat(1) manual references none o [2002/10/23] docs/44400 doc ipfw(8) has contradictions in bridged and o [2002/10/24] docs/44435 doc sysctl manpage: add example for tcsh o [2002/10/29] docs/44594 doc Handbook doesn't mention drivers.flp for o [2002/11/14] docs/45294 doc LINT notes are murky re PQ_CACHESIZE sett o [2002/11/17] docs/45371 doc man page for exports lacks information on o [2002/12/02] docs/45940 doc burncd missing info o [2002/12/11] docs/46181 doc "make fetch-recursive" target description o [2002/12/11] docs/46196 doc Missing return value in (set_)menu_format o [2002/12/11] docs/46200 doc fix for ru_RU.KOI8-R/books/porters-handbo o [2002/12/16] docs/46291 doc correlation between HZ kernel config para o [2002/12/16] docs/46295 doc please add information to Nvi recovery em o [2003/01/02] docs/46709 doc tables in terminfo.5 are broken o [2003/01/05] docs/46793 doc DEVICE_POLLING can not be used with SMP, o [2003/01/09] docs/46919 doc setkey(8) references the wrong RFC for ES o [2003/01/14] docs/47085 doc boot(8) manpage is incomplete according t o [2003/01/27] docs/47575 doc Clarify requirements for IPFW2 in STABLE o [2003/01/28] docs/47594 doc [PATH] passwd(5) incorrectly states allow o [2003/01/30] docs/47690 doc builtin(1) manpage is wrong about externa o [2003/01/30] docs/47705 doc wc(1) manpage has poor explanations. f [2003/02/02] docs/47818 doc ln(1) manpage is confusing o [2003/02/02] docs/47824 doc auto-create plist chapter should mention o [2003/02/05] docs/47991 doc Handbook section on upgrading kernel says o [2003/02/06] docs/48018 doc telnetd(8) manpage appears incorrect rega f [2003/02/07] docs/48038 doc [PATCH] add Tips and Tricks section into o [2003/02/08] docs/48101 doc There's no documentation on the fixit dis o [2003/02/12] docs/48210 doc make -q only does what the manpage says i o [2003/02/17] docs/48407 doc PPP section needs a cleanup. o [2003/02/28] docs/48767 doc wrong key numbers for left/right windows o [2003/03/06] docs/48980 doc [PATCH] nsgmls -s errors and sect. 3.2.1 o [2003/03/14] docs/50013 doc [PATCH] add much more russian holydays o [2003/03/21] docs/50181 doc localtime_r man page doesn't exist o [2003/03/22] docs/50200 doc Handbook "Kerberos" chapter doesn't quali o [2003/03/23] docs/50211 doc [PATCH] Fix textfile creation o [2003/03/27] docs/50349 doc make release fails with NO_OPENSSH and ! o [2003/03/28] docs/50390 doc no man page for suser_xxx() f [2003/03/28] docs/50391 doc Incorrect information in a man o [2003/03/30] docs/50463 doc netstat(1) points to mbuf(9) which doesn' o [2003/03/30] docs/50469 doc "mount_msdos -W" issue in handbook o [2003/04/03] docs/50573 doc return values for res_query/res_search/re f [2003/04/07] docs/50677 doc [PATCH] update doc/en_US.ISO8859-1/books/ o [2003/04/10] docs/50773 doc NFS problems by jumbo frames to mention i o [2003/04/15] docs/51006 doc [PATCH] divert(4) and ipfw(8) manpages ar o [2003/04/20] docs/51187 doc logger(1) -A clarification o [2003/04/27] docs/51480 doc Multiple undefined references in the Free o [2003/05/06] docs/51875 doc atkbd(4) adjustment o [2003/05/06] docs/51891 doc DIAGNOSTICS in ed driver manpage don't ma o [2003/05/07] docs/51921 doc ls(1) manpage lacks some information abou o [2003/05/09] docs/51999 doc Missing MAN for ssh o [2003/05/11] docs/52071 doc [PATCH] Add more information about soft u o [2003/05/13] docs/52183 doc [PATCH] Clarifies pccard setup for wirele o [2003/05/19] docs/52426 doc Update hardware notes to reflect kern/504 125 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon May 19 11:11:32 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7203637B401 for ; Mon, 19 May 2003 11:11:32 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4127443F3F for ; Mon, 19 May 2003 11:11:31 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JIBSka011822 for ; Mon, 19 May 2003 14:11:28 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 14:04:11 -0400 From: Tom Rhodes To: FreeBSD-doc@FreeBSD.org Message-Id: <20030519140411.75dcc28c.trhodes@FreeBSD.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: RFC: Fixing handbook filenames (by id="blah" modifications). X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 18:11:32 -0000 Greetings. This morning, inspired by some unknown yearn to have the filenames match the chapters (ie: s/nfs.html/network-nfs.html) I created a patch that 'fixes' the advanced-networking chapter. Since the handbook will not build if the tags do not match an id, the appropriate changes were made to the other chapters. Before I commit this, does anyone have any opinions? If this goes in, I'll continue to work on this. From what my builds show me, this does NOT break anything. Please see the semi large patch at: http://people.FreeBSD.org/~trhodes/handbook.diff for an idea of what my first commit would consist of. Thanks! -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Mon May 19 11:54:34 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C963F37B40F for ; Mon, 19 May 2003 11:54:34 -0700 (PDT) Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0FDA043FAF for ; Mon, 19 May 2003 11:54:34 -0700 (PDT) (envelope-from robert@fledge.watson.org) Received: from fledge.watson.org (localhost [127.0.0.1]) by fledge.watson.org (8.12.9/8.12.9) with ESMTP id h4JIs9On061975 for ; Mon, 19 May 2003 14:54:09 -0400 (EDT) (envelope-from robert@fledge.watson.org) Received: from localhost (robert@localhost)h4JIs9nA061972 for ; Mon, 19 May 2003 14:54:09 -0400 (EDT) (envelope-from robert@fledge.watson.org) Date: Mon, 19 May 2003 14:54:08 -0400 (EDT) From: Robert Watson X-Sender: robert@fledge.watson.org To: doc@FreeBSD.org Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Subject: Adding new top-level section to Developer's Handbook: System Architecture? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 18:54:35 -0000 As part of the Network Associates Laboratories CBOSS contract with DARPA to improve FreeBSD system security, we have a task to write a FreeBSD Security Architecture. We're preparing to make the first draft of this document available -- it provides a high level view of how security services in the kernel and userland operate, talks about bullet security features, adaptation of FreeBSD security to particular tasks, etc. Right now, our thought is to make it a chapter in the Developer's Handbook. Unfortunately, it wasn't immediately clear where it should go. Today, the structure of the document is: I Basics II Inter-Process Communication III Kernel "FreeBSD Security Architecture" fits poorly into any of these categories: it's not basic, it's not IPC (although it talks a bit about IPC), and it's not strictly kernel since it talks fairly extensively about the integration of the user security elements. My first pass temptation was to change the format to be more like the following: I Basics II Inter-Process Communication III High-Level Architecture IV Kernel And stick in the secarch chapter as the (currently) sole section of III. At some point, I'd also like to copy the SMP arch document into this tree, although that's more strictly a kernel thing. I'm not sure adding a High Level Architecture section is the long term solution. The long term solution might be to break it into two books -- one on developing/debugging FreeBSD, and the other on developing/debugging on FreeBSD. Or perhaps an Architecture/design book separate from a practices and procedures book. Regardless, would anyone object to my taking the above described strategy for the time being, when I bring in the current draft? Robert N M Watson FreeBSD Core Team, TrustedBSD Projects robert@fledge.watson.org Network Associates Laboratories From owner-freebsd-doc@FreeBSD.ORG Mon May 19 12:19:51 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6485F37B401; Mon, 19 May 2003 12:19:51 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id BB54343FAF; Mon, 19 May 2003 12:19:49 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19HqAm-000JMv-00; Mon, 19 May 2003 20:19:48 +0100 Date: Mon, 19 May 2003 20:19:48 +0100 From: Ceri Davies To: Robert Watson Message-ID: <20030519191948.GA74434@submonkey.net> Mail-Followup-To: Ceri Davies , Robert Watson , doc@FreeBSD.org References: Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="45Z9DzgjV8m4Oswq" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.4i Sender: Ceri Davies cc: doc@FreeBSD.org Subject: Re: Adding new top-level section to Developer's Handbook: System Architecture? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 May 2003 19:19:51 -0000 --45Z9DzgjV8m4Oswq Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, May 19, 2003 at 02:54:08PM -0400, Robert Watson wrote: > My first pass temptation was > to change the format to be more like the following: >=20 > I Basics > II Inter-Process Communication > III High-Level Architecture > IV Kernel [...] > Regardless, would anyone object to my taking the above described strategy > for the time being, when I bring in the current draft? I doubt it. Certainly not I. Ceri --=20 --45Z9DzgjV8m4Oswq Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yS5UocfcwTS3JF8RAthrAKCKcWIKMQ+xu9neOCTQfqpQA5z00gCeKn8P IN+oU7VVLageZOQYt7di19w= =8n/1 -----END PGP SIGNATURE----- --45Z9DzgjV8m4Oswq-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 12:22:57 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 362FB37B401 for ; Mon, 19 May 2003 12:22:57 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8A9F843FAF for ; Mon, 19 May 2003 12:22:56 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19HqDn-000JNS-00 for doc@FreeBSD.org; Mon, 19 May 2003 20:22:55 +0100 Date: Mon, 19 May 2003 20:22:55 +0100 From: Ceri Davies To: doc@FreeBSD.org Message-ID: <20030519192255.GB74434@submonkey.net> Mail-Followup-To: Ceri Davies , doc@FreeBSD.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="uZ3hkaAS1mZxFaxD" Content-Disposition: inline User-Agent: Mutt/1.5.4i Sender: Ceri Davies Subject: Application and command names in elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 19:22:57 -0000 --uZ3hkaAS1mZxFaxD Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable I've been taking a high level look at getting all the <title> elements in the handbook ready for the 3rd edition (well, glimpse has been doing all the hard work so far), and I'm very tempted to religiously wrap all applica= tion and command names in the appropriate markup. Would anyone care to talk me out of it? Ceri --=20 --uZ3hkaAS1mZxFaxD Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yS8PocfcwTS3JF8RAuCrAKCj+utAY6n+kfxrjFRSjqxJquTnLQCdF4vG GDozDP1b0wp4wf8Xi6QqgZg= =4X86 -----END PGP SIGNATURE----- --uZ3hkaAS1mZxFaxD-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 12:36:47 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 69F6937B401; Mon, 19 May 2003 12:36:47 -0700 (PDT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7B58543FAF; Mon, 19 May 2003 12:36:46 -0700 (PDT) (envelope-from hrs@eos.ocn.ne.jp) Received: from mail.allbsd.org (p4244-adsao12honb4-acca.tokyo.ocn.ne.jp [219.161.186.244]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id AF86E677A; Tue, 20 May 2003 04:36:45 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) h4JJZnJp036108; Tue, 20 May 2003 04:35:50 +0900 (JST) (envelope-from hrs@eos.ocn.ne.jp) Date: Tue, 20 May 2003 03:32:01 +0900 (JST) Message-Id: <20030520.033201.71080752.hrs@eos.ocn.ne.jp> To: trhodes@freebsd.org From: Hiroki Sato <hrs@eos.ocn.ne.jp> In-Reply-To: <20030519140411.75dcc28c.trhodes@FreeBSD.org> References: <20030519140411.75dcc28c.trhodes@FreeBSD.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 3.2 on Emacs 20.7 / Mule 4.0 (HANANOEN) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit cc: FreeBSD-doc@freebsd.org Subject: Re: RFC: Fixing handbook filenames (by id="blah" modifications). X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 19:36:47 -0000 Tom Rhodes <trhodes@freebsd.org> wrote in <20030519140411.75dcc28c.trhodes@FreeBSD.org>: trhodes> This morning, inspired by some unknown yearn to have the filenames trhodes> match the chapters (ie: s/nfs.html/network-nfs.html) I created a trhodes> patch that 'fixes' the advanced-networking chapter. Sounds good to me :-) -- | Hiroki SATO <hrs@eos.ocn.ne.jp> / <hrs@FreeBSD.org> From owner-freebsd-doc@FreeBSD.ORG Mon May 19 12:38:07 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A311637B401; Mon, 19 May 2003 12:38:07 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id BC0EF43F85; Mon, 19 May 2003 12:38:06 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JJc5ka012124; Mon, 19 May 2003 15:38:05 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 15:30:48 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Ceri Davies <ceri@FreeBSD.org> Message-Id: <20030519153048.51f20a06.trhodes@FreeBSD.org> In-Reply-To: <20030519192255.GB74434@submonkey.net> References: <20030519192255.GB74434@submonkey.net> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 19:38:07 -0000 On Mon, 19 May 2003 20:22:55 +0100 Ceri Davies <ceri@freebsd.org> wrote: > > I've been taking a high level look at getting all the <title> elements in > the handbook ready for the 3rd edition (well, glimpse has been doing all > the hard work so far), and I'm very tempted to religiously wrap all application > and command names in the appropriate markup. > > Would anyone care to talk me out of it? > I'd like to chime in here if you do not mind. While I was thinking about this just last night, a question arose as to which is more appropriate: <command> or manual page entities. <command>, and &man.REF;, to me, are ambiguous. For instance, we can wrap the following in either command or &man entities: By using the &man.ssh.1; utility for remote network connections, you reduce the risk of password theft. By using the <command>ssh</command> utility for remote network connections, you reduce the risk of password theft. Perhaps we should standardize this some way. We have the screen for examples. Perhaps for commands where we do not need the screen tag, we can use the markup: Use <command>cvsup -g -L 2 src</command> to remove the graphic dependency on X11. Then we can use screen for, say, a series of commands which generate output. There seems to be mixed usage of the command and manual page entities. My attempt here was merely to keep it one way, or the other. Perhaps I'm thinking too much... -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Mon May 19 12:39:51 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3699037B40A for <FreeBSD-doc@FreeBSD.org>; Mon, 19 May 2003 12:39:51 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id BB9BC43F93 for <FreeBSD-doc@FreeBSD.org>; Mon, 19 May 2003 12:39:48 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JJdika012133; Mon, 19 May 2003 15:39:45 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 15:32:28 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Hiroki Sato <hrs@eos.ocn.ne.jp> Message-Id: <20030519153228.62748775.trhodes@FreeBSD.org> In-Reply-To: <20030520.033201.71080752.hrs@eos.ocn.ne.jp> References: <20030519140411.75dcc28c.trhodes@FreeBSD.org> <20030520.033201.71080752.hrs@eos.ocn.ne.jp> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: FreeBSD-doc@FreeBSD.org Subject: Re: RFC: Fixing handbook filenames (by id="blah" modifications). X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 19:39:51 -0000 On Tue, 20 May 2003 03:32:01 +0900 (JST) Hiroki Sato <hrs@eos.ocn.ne.jp> wrote: > Tom Rhodes <trhodes@freebsd.org> wrote > in <20030519140411.75dcc28c.trhodes@FreeBSD.org>: > > trhodes> This morning, inspired by some unknown yearn to have the filenames > trhodes> match the chapters (ie: s/nfs.html/network-nfs.html) I created a > trhodes> patch that 'fixes' the advanced-networking chapter. > > Sounds good to me :-) > Well, that makes one. Now if I can just get a few more doc committers to either say 'yes' or 'no', I'll feel better about committing it. Thanks for your input! -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Mon May 19 12:57:38 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 119D537B401; Mon, 19 May 2003 12:57:38 -0700 (PDT) Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4D28E43F75; Mon, 19 May 2003 12:57:34 -0700 (PDT) (envelope-from ru@whale.sunbay.crimea.ua) Received: from whale.sunbay.crimea.ua (ru@localhost [127.0.0.1]) h4JJvUEd085306 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 19 May 2003 22:57:30 +0300 (EEST) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.12.9/8.12.8/Submit) id h4JJvOwY085295; Mon, 19 May 2003 22:57:24 +0300 (EEST) (envelope-from ru) Date: Mon, 19 May 2003 22:57:24 +0300 From: Ruslan Ermilov <ru@freebsd.org> To: Kazuo Horikawa <horikawa@jp.freebsd.org> Message-ID: <20030519195724.GD79469@sunbay.com> References: <20030512.234234.74754585.horikawa@attbi.com> <20030513072849.GD962@gothmog.gr> <20030514191822.GA1751@gothmog.gr> <20030514.232305.59463444.horikawa@attbi.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="gDGSpKKIBgtShtf+" Content-Disposition: inline In-Reply-To: <20030514.232305.59463444.horikawa@attbi.com> User-Agent: Mutt/1.5.4i cc: doc@freebsd.org cc: keramida@freebsd.org Subject: Re: ".It Xo" ... generates improper output on groff 1.18.1 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 19:57:38 -0000 --gDGSpKKIBgtShtf+ Content-Type: multipart/mixed; boundary="RYJh/3oyKhIjGcML" Content-Disposition: inline --RYJh/3oyKhIjGcML Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, May 14, 2003 at 11:23:05PM -0600, Kazuo Horikawa wrote: > Hi Giorgos, >=20 > > Are you going to commit the following yourself Horikawa-san? >=20 > Sorry, but no. >=20 > > If you don't, I think I can convince RE that it's harmless > > enough to let me do it before 5.1-RELEASE. >=20 > If fdisk.8 will get the workaround, I think dig.1 and hexdump.1 also > want to have the same workaround (they also have same warning). > But, I guess you will get tired updating dig.1 as it has almost 30 > warnings. Also, dig.1 lives under contrib... >=20 > I guess, if Ruslan can get fix for groff, getting it and not touching > manpages is the best. >=20 This has been fixed in the attached commit. Cheers, --=20 Ruslan Ermilov Sysadmin and DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --RYJh/3oyKhIjGcML Content-Type: message/rfc822 Content-Disposition: inline Received: from whale.sunbay.crimea.ua (root@localhost)h4JEc2kU047468 for <ru@sunbay.crimea.ua>; Mon, 19 May 2003 17:38:02 +0300 (EEST) (envelope-from owner-src-committers@FreeBSD.org) Received: from mx2.freebsd.org (mx2.freebsd.org [216.136.204.119]) h4JEbwBB047456 for <ru@sunbay.crimea.ua>; Mon, 19 May 2003 17:38:00 +0300 (EEST) (envelope-from owner-src-committers@FreeBSD.org) Received: from hub.freebsd.org (hub.freebsd.org [216.136.204.18]) by mx2.freebsd.org (Postfix) with ESMTP id D66DD58596 for <ru@sunbay.crimea.ua>; Mon, 19 May 2003 07:37:55 -0700 (PDT) (envelope-from owner-src-committers@FreeBSD.org) Received: by hub.freebsd.org (Postfix) id 8230737B485; Mon, 19 May 2003 07:37:51 -0700 (PDT) Delivered-To: ru@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 538) id 1C45037B404; Mon, 19 May 2003 07:37:47 -0700 (PDT) Delivered-To: src-committers@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5A0AD37B401; Mon, 19 May 2003 07:37:43 -0700 (PDT) Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115]) by mx1.FreeBSD.org (Postfix) with ESMTP id E9D5043F75; Mon, 19 May 2003 07:37:42 -0700 (PDT) (envelope-from ru@FreeBSD.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.12.6/8.12.6) with ESMTP id h4JEbg0U095856; Mon, 19 May 2003 07:37:42 -0700 (PDT) (envelope-from ru@repoman.freebsd.org) Received: (from ru@localhost) by repoman.freebsd.org (8.12.6/8.12.6/Submit) id h4JEbghB095855; Mon, 19 May 2003 07:37:42 -0700 (PDT) Message-Id: <200305191437.h4JEbghB095855@repoman.freebsd.org> From: Ruslan Ermilov <ru@FreeBSD.org> Date: Mon, 19 May 2003 07:37:42 -0700 (PDT) To: src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org Subject: cvs commit: src/contrib/groff/tmac doc.tmac X-FreeBSD-CVS-Branch: FSF Sender: owner-src-committers@FreeBSD.org Precedence: bulk X-Loop: FreeBSD.ORG ru 2003/05/19 07:37:42 PDT FreeBSD src repository Modified files: (Branch: FSF) contrib/groff/tmac doc.tmac Log: Apply a vendor fix for one problem with tagged lists. From ChangeLog: 2003-05-18 Werner LEMBERG <wl@gnu.org> * tmac/doc.tmac (doc-tag-list): Force horizontal mode after tag to make items work which consist only of a tag. 2003-05-17 Werner LEMBERG <wl@gnu.org> * tmac/doc.tmac (doc-tag-list): Don't use \Z to assure that spaces aren't stretched in a tag (this can fail with unformatted boxes). Instead, insert a break and go back one line. Approved by: re (blanket) Revision Changes Path 1.1.1.10 +8 -7 src/contrib/groff/tmac/doc.tmac --RYJh/3oyKhIjGcML-- --gDGSpKKIBgtShtf+ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yTckUkv4P6juNwoRAosEAJ9hF1/osf/xgAAsLMyBEX1b7NGAJQCfULbF XQ+Q50w9HOziX9LSG6b4pvs= =gIqy -----END PGP SIGNATURE----- --gDGSpKKIBgtShtf+-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:05:58 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1F9FF37B401; Mon, 19 May 2003 13:05:58 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1EC5243FA3; Mon, 19 May 2003 13:05:53 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19HqtM-000JTU-00; Mon, 19 May 2003 21:05:52 +0100 Date: Mon, 19 May 2003 21:05:52 +0100 From: Ceri Davies <setantae@submonkey.net> To: Tom Rhodes <trhodes@FreeBSD.org> Message-ID: <20030519200552.GA74816@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, Tom Rhodes <trhodes@FreeBSD.org>, doc@FreeBSD.org References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="GvXjxJ+pjyke8COw" Content-Disposition: inline In-Reply-To: <20030519153048.51f20a06.trhodes@FreeBSD.org> User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> cc: doc@FreeBSD.org Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:05:58 -0000 --GvXjxJ+pjyke8COw Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, May 19, 2003 at 03:30:48PM -0400, Tom Rhodes wrote: > On Mon, 19 May 2003 20:22:55 +0100 > Ceri Davies <ceri@freebsd.org> wrote: > >=20 > > I've been taking a high level look at getting all the <title> elements = in > > the handbook ready for the 3rd edition (well, glimpse has been doing all > > the hard work so far), and I'm very tempted to religiously wrap all app= lication > > and command names in the appropriate markup. > >=20 > > Would anyone care to talk me out of it? >=20 > I'd like to chime in here if you do not mind. While I was thinking > about this just last night, a question arose as to which is more appropri= ate: > <command> or manual page entities. >=20 > <command>, and &man.REF;, to me, are ambiguous. For instance, we can wrap > the following in either command or &man entities: >=20 > By using the &man.ssh.1; utility for remote network connections, you redu= ce > the risk of password theft. If you use a manpage entity more than once in close proximity, it starts to look silly, at least in HTML output. In general I think that's when <comma= nd> elements come in handy. Ceri --=20 --GvXjxJ+pjyke8COw Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yTkgocfcwTS3JF8RAjVSAJ9xFOBeob0vBIjlM8KDVmaCULh3owCeKxMI Yk16QBcZtCKfjVtWjBVmw1k= =JLWh -----END PGP SIGNATURE----- --GvXjxJ+pjyke8COw-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:09:09 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6BEEE37B401; Mon, 19 May 2003 13:09:09 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 795DC43FBF; Mon, 19 May 2003 13:09:08 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id C86EE10BF81; Mon, 19 May 2003 22:09:06 +0200 (CEST) Date: Mon, 19 May 2003 22:09:06 +0200 From: "Simon L. Nielsen" <simon@nitro.dk> To: Tom Rhodes <trhodes@FreeBSD.org> Message-ID: <20030519200900.GA1120@nitro.dk> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="BXVAT5kNtrzKuDFl" Content-Disposition: inline In-Reply-To: <20030519153048.51f20a06.trhodes@FreeBSD.org> User-Agent: Mutt/1.5.4i cc: Ceri Davies <ceri@FreeBSD.org> cc: doc@FreeBSD.org Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:09:09 -0000 --BXVAT5kNtrzKuDFl Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.19 15:30:48 -0400, Tom Rhodes wrote: > I'd like to chime in here if you do not mind. While I was thinking > about this just last night, a question arose as to which is more appropri= ate: > <command> or manual page entities. In a patch I used man entities multiple times shortly after each other and Murrays changed it in the committed version to only use it the first time and use <command> for the other cases. <comment by Murray from docs/50790 audit trail> One thing to note is that it doesn't look good to use the man page entities twice in close=20 proximity. So I used &man.dumpon.8; the first time, then just used=20 <command>dumpon</command> elsewhere in the paragraph.=20 </comment> I think this is seems like a good way since the man reference is still nice to have. > Perhaps we should standardize this some way. We have the screen for exam= ples. > Perhaps for commands where we do not need the screen tag, we can use the > markup: >=20 > Use <command>cvsup -g -L 2 src</command> to remove the graphic dependency= on > X11. >=20 > Then we can use screen for, say, a series of commands which generate outp= ut. I think screen is mainly uses this way at the moment? It seems <screen> is used when there is output or if it is a command the user should run which is then preceded by a prompt char. This is at least the impression I get from a grep trough the handbook. --=20 Simon L. Nielsen --BXVAT5kNtrzKuDFl Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD4DBQE+yTnc8kocFXgPTRwRAkM4AJjJuljqQHclSq0WXhEsdG/179A3AKCgm1G3 Sfqev72FoEt/qqMtaTy/dw== =8nCE -----END PGP SIGNATURE----- --BXVAT5kNtrzKuDFl-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:10:26 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1E70137B401 for <doc@FreeBSD.org>; Mon, 19 May 2003 13:10:26 -0700 (PDT) Received: from sixshooter.v6.thrupoint.net (sixshooter.v6.thrupoint.net [65.242.152.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6021243FAF for <doc@FreeBSD.org>; Mon, 19 May 2003 13:10:25 -0700 (PDT) (envelope-from jpb@sixshooter.v6.thrupoint.net) Received: from sixshooter.v6.thrupoint.net (localhost.v6.thrupoint.net [127.0.0.1]) by sixshooter.v6.thrupoint.net (Postfix) with ESMTP id BC2C94D02 for <doc@FreeBSD.org>; Mon, 19 May 2003 16:10:24 -0400 (EDT) Received: (from jpb@localhost)h4JKAOGr036152 for doc@FreeBSD.org; Mon, 19 May 2003 16:10:24 -0400 (EDT) Date: Mon, 19 May 2003 16:10:24 -0400 From: Jim Brown <jpb@sixshooter.v6.thrupoint.net> To: doc@FreeBSD.org Message-ID: <20030519201024.GD35860@sixshooter.v6.thrupoint.net> Mail-Followup-To: doc@FreeBSD.org References: <Pine.NEB.3.96L.1030519144915.59393K-100000@fledge.watson.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <Pine.NEB.3.96L.1030519144915.59393K-100000@fledge.watson.org> User-Agent: Mutt/1.4.1i Subject: Re: Adding new top-level section to Developer's Handbook: System Architecture? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:10:26 -0000 * Robert Watson <rwatson@FreeBSD.org> [2003-05-19 14:54]: > > As part of the Network Associates Laboratories CBOSS contract with DARPA > to improve FreeBSD system security, we have a task to write a FreeBSD > Security Architecture. We're preparing to make the first draft of this > document available -- it provides a high level view of how security > services in the kernel and userland operate, talks about bullet security > features, adaptation of FreeBSD security to particular tasks, etc. Right > now, our thought is to make it a chapter in the Developer's Handbook. > Unfortunately, it wasn't immediately clear where it should go. Today, the > structure of the document is: > > I Basics > II Inter-Process Communication > III Kernel > > "FreeBSD Security Architecture" fits poorly into any of these categories: > it's not basic, it's not IPC (although it talks a bit about IPC), and it's > not strictly kernel since it talks fairly extensively about the > integration of the user security elements. My first pass temptation was > to change the format to be more like the following: > > I Basics > II Inter-Process Communication > III High-Level Architecture > IV Kernel > > And stick in the secarch chapter as the (currently) sole section of III. > > At some point, I'd also like to copy the SMP arch document into this tree, > although that's more strictly a kernel thing. > > I'm not sure adding a High Level Architecture section is the long term > solution. The long term solution might be to break it into two books -- > one on developing/debugging FreeBSD, and the other on developing/debugging > on FreeBSD. Or perhaps an Architecture/design book separate from a Did you mean "developing/debugging FreeBSD 4.x" and "developing/debugging FreeBSD 5.x"? Works for me. > practices and procedures book. > > Regardless, would anyone object to my taking the above described strategy > for the time being, when I bring in the current draft? (Extraneous bike shed comments rethought and deleted :-) > > Robert N M Watson FreeBSD Core Team, TrustedBSD Projects > robert@fledge.watson.org Network Associates Laboratories > > _______________________________________________ > 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" > Best Regards, jpb === From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:11:15 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8554637B404; Mon, 19 May 2003 13:11:15 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9C34443F3F; Mon, 19 May 2003 13:11:14 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19HqyX-000JUt-00; Mon, 19 May 2003 21:11:13 +0100 Date: Mon, 19 May 2003 21:11:13 +0100 From: Ceri Davies <setantae@submonkey.net> To: Tom Rhodes <trhodes@FreeBSD.org> Message-ID: <20030519201113.GB74816@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, Tom Rhodes <trhodes@FreeBSD.org>, FreeBSD-doc@FreeBSD.org References: <20030519140411.75dcc28c.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="8P1HSweYDcXXzwPJ" Content-Disposition: inline In-Reply-To: <20030519140411.75dcc28c.trhodes@FreeBSD.org> User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> cc: FreeBSD-doc@FreeBSD.org Subject: Re: RFC: Fixing handbook filenames (by id="blah" modifications). X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:11:15 -0000 --8P1HSweYDcXXzwPJ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, May 19, 2003 at 02:04:11PM -0400, Tom Rhodes wrote: > Greetings. >=20 > This morning, inspired by some unknown yearn to have the filenames > match the chapters (ie: s/nfs.html/network-nfs.html) I created a > patch that 'fixes' the advanced-networking chapter. >=20 > Since the handbook will not build if the <link> tags do not match > an id, the appropriate changes were made to the other chapters. >=20 > Before I commit this, does anyone have any opinions? If this goes > in, I'll continue to work on this. From what my builds show me, > this does NOT break anything. >=20 > Please see the semi large patch at: >=20 > http://people.FreeBSD.org/~trhodes/handbook.diff That diff needs updating (it has a diff of some cvs cruft in, and I updated the eresources chapter earlier and your diff reverts it), but I wouldn't be against the principle. I'm not sure I see the point at the moment though; there are other bits of the handbook that need work. Also, some articles are still lacking id's and therefore generating xXXX.html filenames, which may be worth fixing first (which I only mention as I remember there was a sweep not long ago to get rid of xXXX.html files). Ceri --=20 --8P1HSweYDcXXzwPJ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yTphocfcwTS3JF8RAum/AKDDuAaUd9SrJTcxWjDsBHEEJTJcIwCgwHNC +Bq70a3IAlRjMXYn0R/eSgI= =CV6i -----END PGP SIGNATURE----- --8P1HSweYDcXXzwPJ-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:21:42 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1DABB37B401 for <freebsd-doc@FreeBSD.org>; Mon, 19 May 2003 13:21:42 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 33B7143F75 for <freebsd-doc@FreeBSD.org>; Mon, 19 May 2003 13:21:41 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JKLdka012254 for <freebsd-doc@freebsd.org>; Mon, 19 May 2003 16:21:40 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 16:14:23 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: freebsd-doc@FreeBSD.org Message-Id: <20030519161423.3ed77956.trhodes@FreeBSD.org> In-Reply-To: <20030519201113.GB74816@submonkey.net> References: <20030519140411.75dcc28c.trhodes@FreeBSD.org> <20030519201113.GB74816@submonkey.net> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Re: RFC: Fixing handbook filenames (by id="blah" modifications). X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:21:42 -0000 On Mon, 19 May 2003 21:11:13 +0100 Ceri Davies <setantae@submonkey.net> wrote: > On Mon, May 19, 2003 at 02:04:11PM -0400, Tom Rhodes wrote: > > Greetings. > > > > This morning, inspired by some unknown yearn to have the filenames > > match the chapters (ie: s/nfs.html/network-nfs.html) I created a > > patch that 'fixes' the advanced-networking chapter. > > > > Since the handbook will not build if the <link> tags do not match > > an id, the appropriate changes were made to the other chapters. > > > > Before I commit this, does anyone have any opinions? If this goes > > in, I'll continue to work on this. From what my builds show me, > > this does NOT break anything. > > > > Please see the semi large patch at: > > > > http://people.FreeBSD.org/~trhodes/handbook.diff > > That diff needs updating (it has a diff of some cvs cruft in, and I > updated the eresources chapter earlier and your diff reverts it), but > I wouldn't be against the principle. I noticed this also. Which is why a new diff was uploaded, if you want, you can check that version out. > > I'm not sure I see the point at the moment though; there are other bits > of the handbook that need work. Also, some articles are still lacking > id's and therefore generating xXXX.html filenames, which may be worth > fixing first (which I only mention as I remember there was a sweep not > long ago to get rid of xXXX.html files). > Well, many articles are not only lacking id's, but also some content. My goal here is handbook first, articles second. Its not difficult to do this, yet I don't want to throw the patch aside unless there is a big call to leave it alone. On a more humorous note: I'm actually jumping full force on handbook work, don't stop me now as I may get lazy tonight... :) But if you honestly feel strong about not committing this, I won't. Personally, I think it will make the installed documentation look better if anyone wishes to execute an ls(1) in the handbook directory. I just think the format of <chapter><section>.html looks better and more consitent. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:24:21 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5EC9737B40A; Mon, 19 May 2003 13:24:21 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3612C43FA3; Mon, 19 May 2003 13:24:18 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JKOGka012268; Mon, 19 May 2003 16:24:16 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 16:17:00 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: "Simon L. Nielsen" <simon@nitro.dk> Message-Id: <20030519161700.27143841.trhodes@FreeBSD.org> In-Reply-To: <20030519200900.GA1120@nitro.dk> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> <20030519200900.GA1120@nitro.dk> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: ceri@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:24:21 -0000 On Mon, 19 May 2003 22:09:06 +0200 "Simon L. Nielsen" <simon@nitro.dk> wrote: > On 2003.05.19 15:30:48 -0400, Tom Rhodes wrote: > > > I'd like to chime in here if you do not mind. While I was thinking > > about this just last night, a question arose as to which is more appropriate: > > <command> or manual page entities. > > In a patch I used man entities multiple times shortly after each other > and Murrays changed it in the committed version to only use it the first > time and use <command> for the other cases. > > <comment by Murray from docs/50790 audit trail> > One thing to note is > that it doesn't look good to use the man page entities twice in close > proximity. So I used &man.dumpon.8; the first time, then just used > <command>dumpon</command> elsewhere in the paragraph. > </comment> > > I think this is seems like a good way since the man reference is still > nice to have. Ok, I see the logic here. Thanks guys. > > > Perhaps we should standardize this some way. We have the screen for examples. > > Perhaps for commands where we do not need the screen tag, we can use the > > markup: > > > > Use <command>cvsup -g -L 2 src</command> to remove the graphic dependency on > > X11. > > > > Then we can use screen for, say, a series of commands which generate output. > > I think screen is mainly uses this way at the moment? It seems <screen> > is used when there is output or if it is a command the user should run > which is then preceded by a prompt char. This is at least the impression > I get from a grep trough the handbook. > Yes, this is the way screen is usually used. The programlisting tag is also pretty nifty. :) -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:34:54 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C79CD37B401; Mon, 19 May 2003 13:34:54 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id F010D43FA3; Mon, 19 May 2003 13:34:53 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id D625610BF81; Mon, 19 May 2003 22:34:52 +0200 (CEST) Date: Mon, 19 May 2003 22:34:52 +0200 From: "Simon L. Nielsen" <simon@nitro.dk> To: Tom Rhodes <trhodes@FreeBSD.org> Message-ID: <20030519203451.GB1120@nitro.dk> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> <20030519200900.GA1120@nitro.dk> <20030519161700.27143841.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="WYTEVAkct0FjGQmd" Content-Disposition: inline In-Reply-To: <20030519161700.27143841.trhodes@FreeBSD.org> User-Agent: Mutt/1.5.4i cc: freebsd-doc@freebsd.org Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:34:55 -0000 --WYTEVAkct0FjGQmd Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.19 16:17:00 -0400, Tom Rhodes wrote: > On Mon, 19 May 2003 22:09:06 +0200 > "Simon L. Nielsen" <simon@nitro.dk> wrote: >=20 > > On 2003.05.19 15:30:48 -0400, Tom Rhodes wrote: > >=20 > > > I'd like to chime in here if you do not mind. While I was thinking > > > about this just last night, a question arose as to which is more appr= opriate: > > > <command> or manual page entities. > >=20 > > In a patch I used man entities multiple times shortly after each other > > and Murrays changed it in the committed version to only use it the first > > time and use <command> for the other cases. > >=20 > > <comment by Murray from docs/50790 audit trail> > > One thing to note is > > that it doesn't look good to use the man page entities twice in close= =20 > > proximity. So I used &man.dumpon.8; the first time, then just used=20 > > <command>dumpon</command> elsewhere in the paragraph.=20 > > </comment> > >=20 > > I think this is seems like a good way since the man reference is still > > nice to have. >=20 > Ok, I see the logic here. Thanks guys. Perhaps it would be a good idea to add a short note about this to the section about "Applications, commands, options, and cites" in the FDP primer ? I can make a patch if it sounds like a good idea... --=20 Simon L. Nielsen --WYTEVAkct0FjGQmd Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yT/r8kocFXgPTRwRApojAKCQiVtkUveWU72DTkqg5/O99cRwGACfVROy 9fUoytpsfnYenFgF489pdAM= =1bgt -----END PGP SIGNATURE----- --WYTEVAkct0FjGQmd-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:42:07 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B666037B401; Mon, 19 May 2003 13:42:07 -0700 (PDT) Received: from thalia.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6697343FB1; Mon, 19 May 2003 13:42:06 -0700 (PDT) (envelope-from keramida@freebsd.org) Received: from gothmog.gr (patr530-b120.otenet.gr [195.167.121.248]) by thalia.otenet.gr (8.12.9/8.12.9) with ESMTP id h4JKfwNQ028443; Mon, 19 May 2003 23:41:59 +0300 (EEST) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.9/8.12.9) with ESMTP id h4JKfvWI029930; Mon, 19 May 2003 23:41:57 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.gr (8.12.9/8.12.9/Submit) id h4JKfv7H029929; Mon, 19 May 2003 23:41:57 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Mon, 19 May 2003 23:41:57 +0300 From: Giorgos Keramidas <keramida@freebsd.org> To: Ruslan Ermilov <ru@freebsd.org> Message-ID: <20030519204157.GB29770@gothmog.gr> References: <20030512.234234.74754585.horikawa@attbi.com> <20030513072849.GD962@gothmog.gr> <20030514191822.GA1751@gothmog.gr> <20030514.232305.59463444.horikawa@attbi.com> <20030519195724.GD79469@sunbay.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030519195724.GD79469@sunbay.com> cc: doc@freebsd.org Subject: Re: ".It Xo" ... generates improper output on groff 1.18.1 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:42:08 -0000 On 2003-05-19 22:57, Ruslan Ermilov <ru@freebsd.org> wrote: >On Wed, May 14, 2003 at 11:23:05PM -0600, Kazuo Horikawa wrote: >>> Are you going to commit [the attached diff] Horikawa-san? >> >> Sorry, but no. > > This has been fixed in the attached commit. Thank you Ruslan :-) From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:46:13 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7B77337B401; Mon, 19 May 2003 13:46:13 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9CFF043F93; Mon, 19 May 2003 13:46:12 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19HrWN-000Jcz-00; Mon, 19 May 2003 21:46:11 +0100 Date: Mon, 19 May 2003 21:46:11 +0100 From: Ceri Davies <setantae@submonkey.net> To: Tom Rhodes <trhodes@FreeBSD.org> Message-ID: <20030519204611.GC74816@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, Tom Rhodes <trhodes@FreeBSD.org>, freebsd-doc@FreeBSD.org References: <20030519140411.75dcc28c.trhodes@FreeBSD.org> <20030519201113.GB74816@submonkey.net> <20030519161423.3ed77956.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="UPT3ojh+0CqEDtpF" Content-Disposition: inline In-Reply-To: <20030519161423.3ed77956.trhodes@FreeBSD.org> User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> cc: freebsd-doc@FreeBSD.org Subject: Re: RFC: Fixing handbook filenames (by id="blah" modifications). X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:46:13 -0000 --UPT3ojh+0CqEDtpF Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, May 19, 2003 at 04:14:23PM -0400, Tom Rhodes wrote: > But if you honestly feel strong about not committing this, I won't. I'm not against it. My main concern is that if you're planning a sweep of the whole book, then I'd rather it waited until after the 3rd edition, purely because in theory all the doc committers are currently knocking up huge patches to get it into shape, and big changes that aren't strictly necessary may make the whole merging process a bit more difficult. The actual diff that you posted isn't that much of a beast, so you may as well get that in now if nobody objects! Ceri --=20 --UPT3ojh+0CqEDtpF Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yUKTocfcwTS3JF8RAot+AKCs5XvW2YzAyCYuMrm8J7PCKWtZ9wCeNmUJ Pz7J3hksgsR656y+AZZLUpQ= =ZPRk -----END PGP SIGNATURE----- --UPT3ojh+0CqEDtpF-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:52:10 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B9B6537B405 for <doc@FreeBSD.org>; Mon, 19 May 2003 13:52:10 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7E4BD43F93 for <doc@FreeBSD.org>; Mon, 19 May 2003 13:52:09 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19Hrc8-000JeG-00 for doc@FreeBSD.org; Mon, 19 May 2003 21:52:08 +0100 Date: Mon, 19 May 2003 21:52:08 +0100 From: Ceri Davies <setantae@submonkey.net> To: doc@FreeBSD.org Message-ID: <20030519205208.GD74816@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, doc@FreeBSD.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="TybLhxa8M7aNoW+V" Content-Disposition: inline User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> Subject: "Administrate" vs. "Administer" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:52:11 -0000 --TybLhxa8M7aNoW+V Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable There are two places in the doc/ tree where we say "administrating the spoo= ler" or similar. While technically this is correct, I think that "administering the spooler" reads better; any objections to my changing it? Ceri --=20 --TybLhxa8M7aNoW+V Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yUP4ocfcwTS3JF8RApBCAKDJGrRxXqSQxPgKFM91Rcv732H5UgCgjWIJ ss2P8t6mRsFzJc/KlwhyJUA= =P6la -----END PGP SIGNATURE----- --TybLhxa8M7aNoW+V-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 13:57:07 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3B79837B401 for <doc@FreeBSD.org>; Mon, 19 May 2003 13:57:07 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 610F143FAF for <doc@FreeBSD.org>; Mon, 19 May 2003 13:57:06 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JKv1ka012394; Mon, 19 May 2003 16:57:03 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 16:49:42 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Ceri Davies <setantae@submonkey.net> Message-Id: <20030519164942.1de15ffc.trhodes@FreeBSD.org> In-Reply-To: <20030519205208.GD74816@submonkey.net> References: <20030519205208.GD74816@submonkey.net> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: "Administrate" vs. "Administer" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 20:57:07 -0000 On Mon, 19 May 2003 21:52:08 +0100 Ceri Davies <setantae@submonkey.net> wrote: > > There are two places in the doc/ tree where we say "administrating the spooler" > or similar. > > While technically this is correct, I think that "administering the spooler" > reads better; any objections to my changing it? > > Ceri > -- > No objections here. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Mon May 19 14:14:55 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8AF6937B401 for <doc@FreeBSD.org>; Mon, 19 May 2003 14:14:55 -0700 (PDT) Received: from wopr.caltech.edu (wopr.caltech.edu [131.215.103.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id EF87643FAF for <doc@FreeBSD.org>; Mon, 19 May 2003 14:14:54 -0700 (PDT) (envelope-from mph@wopr.caltech.edu) Received: from wopr.caltech.edu (localhost.caltech.edu [127.0.0.1]) by wopr.caltech.edu (8.12.9/8.12.8) with ESMTP id h4JLEsb9090754; Mon, 19 May 2003 14:14:54 -0700 (PDT) (envelope-from mph@wopr.caltech.edu) Received: (from mph@localhost) by wopr.caltech.edu (8.12.9/8.12.3/Submit) id h4JLEsgl090753; Mon, 19 May 2003 14:14:54 -0700 (PDT) Date: Mon, 19 May 2003 14:14:54 -0700 From: Matthew Hunt <mph@astro.caltech.edu> To: Ceri Davies <setantae@submonkey.net>, doc@FreeBSD.org Message-ID: <20030519211453.GA90693@wopr.caltech.edu> References: <20030519205208.GD74816@submonkey.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030519205208.GD74816@submonkey.net> User-Agent: Mutt/1.5.1i Subject: Re: "Administrate" vs. "Administer" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 21:14:55 -0000 On Mon, May 19, 2003 at 09:52:08PM +0100, Ceri Davies wrote: > While technically this is correct, I think that "administering the spooler" > reads better; any objections to my changing it? I strongly prefer "administer," and generally eschew the gratuitous longification of words. (I'd always assumed that "administrate" was a neologism, but the OED lists usages in this sense since 1639. Still, it always sounds clumsy to me.) -- Matthew Hunt <mph@astro.caltech.edu> * Science rules. http://www.pobox.com/~mph/ * From owner-freebsd-doc@FreeBSD.ORG Mon May 19 14:14:56 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 27DD837B401; Mon, 19 May 2003 14:14:56 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id B131343F75; Mon, 19 May 2003 14:14:54 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4JJxKgp012434; Mon, 19 May 2003 21:59:20 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4JJxPkd001792; Mon, 19 May 2003 21:59:25 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4JJxPWa001791; Mon, 19 May 2003 21:59:25 +0200 (CEST) (envelope-from marc) Date: Mon, 19 May 2003 21:59:25 +0200 From: Marc Fonvieille <blackend@FreeBSD.org> To: Tom Rhodes <trhodes@FreeBSD.org> Message-ID: <20030519195925.GC571@nosferatu.blackend.org> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030519153048.51f20a06.trhodes@FreeBSD.org> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: Ceri Davies <ceri@FreeBSD.org> cc: doc@FreeBSD.org Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 21:14:56 -0000 On Mon, May 19, 2003 at 03:30:48PM -0400, Tom Rhodes wrote: > > I'd like to chime in here if you do not mind. While I was thinking > about this just last night, a question arose as to which is more appropriate: > <command> or manual page entities. > > <command>, and &man.REF;, to me, are ambiguous. For instance, we can wrap > the following in either command or &man entities: > > By using the &man.ssh.1; utility for remote network connections, you reduce > the risk of password theft. > > By using the <command>ssh</command> utility for remote network connections, > you reduce the risk of password theft. > In this case the manual page entity seems a better choice: - on the online version it let the reader to read the manual page via the link generated. - on both online and printed versions, it gives an info about the manual page section > Perhaps we should standardize this some way. We have the screen for examples. > Perhaps for commands where we do not need the screen tag, we can use the > markup: > > Use <command>cvsup -g -L 2 src</command> to remove the graphic dependency on > X11. > > Then we can use screen for, say, a series of commands which generate output. I agree, <screen></screen> should be used for that and for multiple lines commands. > There seems to be mixed usage of the command and manual page entities. [...] When we have the choice between <command></command> and manual page for a command name (just the name, not a command with parameters) the manual page entity should be used. Marc From owner-freebsd-doc@FreeBSD.ORG Mon May 19 14:15:04 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 41B8C37B401; Mon, 19 May 2003 14:15:04 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id B774E43F75; Mon, 19 May 2003 14:14:56 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4JJArgp011205; Mon, 19 May 2003 21:10:53 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4JJAwkd001645; Mon, 19 May 2003 21:10:58 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4JJAvca001644; Mon, 19 May 2003 21:10:57 +0200 (CEST) (envelope-from marc) Date: Mon, 19 May 2003 21:10:57 +0200 From: Marc Fonvieille <blackend@FreeBSD.org> To: freebsd-doc@FreeBSD.org Message-ID: <20030519191057.GA571@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by abigail.blackend.org id h4JJArgp011205 cc: freebsd-current@FreeBSD.org Subject: PostScript produced by Groff 1.19 makes crash GS on 5.1-BETA X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 21:15:04 -0000 Hello, I updated my old -CURRENT box to a fresh 5.1-BETA When I wanted to build the Handbook, a GhostScript crash occured on ps --> eps conversion. The .ps file was produced during Handbook build from a .pic file by Groff. The crash with that file only occurs on a 5.1-BETA box, and with any GS version. You can easily reproduce the crash, just fetch the file: http://people.freebsd.org/~blackend/vinum-concat.ps and do a ps2epsi vinum-concat.ps vinum-concat.eps You can even fetch the same file produced by Groff 1.18.1 (http://people.freebsd.org/~blackend/vinum-concat-old.ps) and you will experience no problem. Here's the log of the crash for information: %ps2epsi vinum-concat.ps vinum-concat.eps Error: /rangecheck in --.getbitsrect-- Operand stack: -1 0 (\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000...) --nostringval-- 0 0 612 792 0 --nostringval-- (\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000! \000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000...) Execution stack: %interp_exit .runexec2 --nostringval-- --nostringval-- --nostringval-- 2 %stopped_push --nostringval-- --nostringval-- --nostringval-- false 1 %stopped_push 1 3 %oparray_pop 1 3 %oparray_pop 1 3 %oparray_pop 1 3 %oparray_pop .runexec2 --nostringval-- --nostringval-- --nostringval-- 2 %stopped_push --nostringval-- --nostringval-- --nostringval-- --nostringval-- false 1 %stopped_push --nostringval-- --nostringval-- --nostringval-- 1 1 841 --nostringval-- %for_pos_int_continue --nostringval-- --nostringval-- 6 6 %oparray_pop --nostringval-- --nostringval-- --nostringval-- Dictionary stack: --dict:1063/1123(ro)(G)-- --dict:0/20(G)-- --dict:77/200(L)-- --dict:25/30(L)-- --dict:59/120(L)-- --dict:25/30(L)-- Current allocation mode is local Last OS error: 2 GNU Ghostscript 7.06: Unrecoverable error, exit code 1 Marc From owner-freebsd-doc@FreeBSD.ORG Mon May 19 14:25:24 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 16E1F37B401; Mon, 19 May 2003 14:25:24 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id D244443F75; Mon, 19 May 2003 14:25:22 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4JLPLka012488; Mon, 19 May 2003 17:25:21 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 19 May 2003 17:18:04 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Marc Fonvieille <blackend@FreeBSD.org> Message-Id: <20030519171804.25e00041.trhodes@FreeBSD.org> In-Reply-To: <20030519195925.GC571@nosferatu.blackend.org> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> <20030519195925.GC571@nosferatu.blackend.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: ceri@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 21:25:24 -0000 On Mon, 19 May 2003 21:59:25 +0200 Marc Fonvieille <blackend@FreeBSD.org> wrote: > On Mon, May 19, 2003 at 03:30:48PM -0400, Tom Rhodes wrote: > > > > > There seems to be mixed usage of the command and manual page entities. > [...] > > When we have the choice between <command></command> and manual page for > a command name (just the name, not a command with parameters) > the manual page entity should be used. > > Marc > After reading the different replies to this, I like the way murray and ceri put it. Use the manual page entity first, and use command if the utility is mentioned again within proximity. I'll do this from now on. Thanks everyone. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Mon May 19 15:30:05 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 74F8C37B404 for <freebsd-doc@hub.freebsd.org>; Mon, 19 May 2003 15:30:05 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5AC4743F75 for <freebsd-doc@hub.freebsd.org>; Mon, 19 May 2003 15:30:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4JMU2Up094031 for <freebsd-doc@freefall.freebsd.org>; Mon, 19 May 2003 15:30:02 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4JMU2UB094030; Mon, 19 May 2003 15:30:02 -0700 (PDT) Resent-Date: Mon, 19 May 2003 15:30:02 -0700 (PDT) Resent-Message-Id: <200305192230.h4JMU2UB094030@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, "Simon L.Nielsen" <simon@nitro.dk> Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0221437B401 for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 May 2003 15:24:14 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0193943F85 for <FreeBSD-gnats-submit@freebsd.org>; Mon, 19 May 2003 15:24:13 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 822F610BF81; Tue, 20 May 2003 00:24:10 +0200 (CEST) Message-Id: <20030519222410.822F610BF81@arthur.nitro.dk> Date: Tue, 20 May 2003 00:24:10 +0200 (CEST) From: "Simon L.Nielsen" <simon@nitro.dk> To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/52448: [patch] Misc man page reference fixes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L.Nielsen" <simon@nitro.dk> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 22:30:05 -0000 >Number: 52448 >Category: docs >Synopsis: [patch] Misc man page reference fixes >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 May 19 15:30:02 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Simon L. Nielsen >Release: FreeBSD 4.8-STABLE i386 >Organization: >Environment: >Description: intro.3: Remove Xr references to libc, libcurses, libcompat, libkvm, libl, libtermcap and liby since they do not exists as man pages under those names. Add section number to libmp Xr reference (which do have a man page). Add libmp description - from libmp(3). picobsd.8: Remove Xr reference to etherboot since it does not have a man page at all. Add reference to the location of the port instead. >How-To-Repeat: >Fix: --- man-intro-3.patch begins here --- Index: intro.3 =================================================================== RCS file: /home/ncvs/src/share/man/man3/intro.3,v retrieving revision 1.14 diff -u -d -r1.14 intro.3 --- intro.3 7 Aug 2001 15:48:38 -0000 1.14 +++ intro.3 20 May 2003 00:11:09 -0000 @@ -60,7 +60,7 @@ .Pp The various libraries (followed by the loader flag): .Bl -tag -width "libc (-lc)" -.It Xr libc Pq Fl l Ns Ar c +.It libc Pq Fl l Ns Ar c Standard C library functions. .\" (See .\" .Xr libc 3 . ) @@ -71,7 +71,7 @@ .Fl l Ns Ar c for these functions. There are several `libraries' or groups of functions included inside of -.Xr libc : +.Em libc : the standard .Tn I/O routines, @@ -81,12 +81,12 @@ character tests and character operators, des encryption routines, storage allocation, time functions, signal handling and more. -.It Xr libcurses Pq Fl l Ns Ar curses Fl l Ns Ar termcap +.It libcurses Pq Fl l Ns Ar curses Fl l Ns Ar termcap Terminal independent screen management routines for two dimensional non-bitmap display terminals. (See .Xr ncurses 3 . ) -.It Xr libcompat Pq Fl l Ns Ar compat +.It libcompat Pq Fl l Ns Ar compat Functions which are obsolete but are available for compatibility with .Bx 4.3 . In particular, @@ -96,16 +96,16 @@ Use of these routines should, for the most part, be avoided. The manual page entry for each compatibility routine indicates the proper interface to use. -.It Xr libkvm Pq Fl l Ns Ar kvm +.It libkvm Pq Fl l Ns Ar kvm Functions used to access kernel memory are in this library. They can be used against both a running system and a crash dump. (See .Xr kvm 3 . ) -.It Xr libl Pq Fl l Ns Ar l +.It libl Pq Fl l Ns Ar l The library for .Xr lex 1 . .\" .It Xr libln -.It Xr libm Pq Fl l Ns Ar m +.It libm Pq Fl l Ns Ar m The math library, .Em libm . The math library is loaded as needed by the Pascal compiler, @@ -115,7 +115,8 @@ flag. (See .Xr math 3 . ) -.It Xr libmp Pq Fl l Ns Ar mp +.It Xr libmp 3 Pq Fl l Ns Ar mp +The traditional BSD multiple precision integer arithmetic library. .\" .It Xr libom .\" Old math library. .\" .It Xr libplot Pq Fl l Ns Ar plot @@ -128,12 +129,12 @@ .\" .Xr plot 3 . ) .\" .It Xr libresolv Pq Fl l Ns Ar resolv .\" Routines for network address resolution. -.It Xr libtermcap Pq Fl l Ns Ar termcap +.It libtermcap Pq Fl l Ns Ar termcap The terminal independent operation library package. (See .Xr termcap 3 . ) .\" .It libvt0.a -.It Xr liby Pq Fl l Ns Ar y +.It liby Pq Fl l Ns Ar y The library for .Xr yacc 1 . .El --- man-intro-3-libc.patch ends here --- --- man-picobsd-8.patch begins here --- Index: man8/picobsd.8 =================================================================== RCS file: /home/ncvs/src/share/man/man8/picobsd.8,v retrieving revision 1.24 diff -u -d -r1.24 picobsd.8 --- man8/picobsd.8 27 Dec 2002 12:15:34 -0000 1.24 +++ man8/picobsd.8 19 May 2003 22:37:11 -0000 @@ -19,7 +19,7 @@ .Nm PicoBSD ) which typically fits on one floppy disk, or can be downloaded as a single image file from some media such as CDROM, flash memory, or through -.Xr etherboot . +etherboot [ /usr/ports/net/etherboot ]. .Pp The .Nm @@ -101,8 +101,7 @@ kernel. This is the default behaviour, and is extremely useful as the kernel itself can be loaded, -using -.Xr etherboot +using etherboot [ /usr/ports/net/etherboot ] or .Xr pxeboot 8 , as a fully functional system. --- man-picobsd-8.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Mon May 19 15:34:54 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CBBC837B401; Mon, 19 May 2003 15:34:54 -0700 (PDT) Received: from haakonia.hitnet.rwth-aachen.de (haakonia.hitnet.RWTH-Aachen.DE [137.226.181.92]) by mx1.FreeBSD.org (Postfix) with ESMTP id D629F43F3F; Mon, 19 May 2003 15:34:53 -0700 (PDT) (envelope-from chris@unixpages.org) Received: from gondor.middleearth (gondor.middleearth [192.168.1.42]) by haakonia.hitnet.rwth-aachen.de (Postfix) with ESMTP id 2FF9CC4F3; Tue, 20 May 2003 00:34:53 +0200 (CEST) Received: by gondor.middleearth (Postfix, from userid 1001) id 9C2E24701; Tue, 20 May 2003 00:34:52 +0200 (CEST) Date: Tue, 20 May 2003 00:34:52 +0200 From: Christian Brueffer <chris@unixpages.org> To: Tom Rhodes <trhodes@freebsd.org> Message-ID: <20030519223451.GM974@unixpages.org> References: <20030519140411.75dcc28c.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="/t6ASE28jIy1gGy9" Content-Disposition: inline In-Reply-To: <20030519140411.75dcc28c.trhodes@FreeBSD.org> User-Agent: Mutt/1.4.1i X-Operating-System: FreeBSD 5.1-BETA X-PGP-Key: http://people.freebsd.org/~brueffer/brueffer.key.asc X-PGP-Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D cc: FreeBSD-doc@freebsd.org Subject: Re: RFC: Fixing handbook filenames (by id="blah" modifications). X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Mon, 19 May 2003 22:34:55 -0000 --/t6ASE28jIy1gGy9 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, May 19, 2003 at 02:04:11PM -0400, Tom Rhodes wrote: > Greetings. >=20 > This morning, inspired by some unknown yearn to have the filenames > match the chapters (ie: s/nfs.html/network-nfs.html) I created a > patch that 'fixes' the advanced-networking chapter. >=20 > Since the handbook will not build if the <link> tags do not match > an id, the appropriate changes were made to the other chapters. >=20 > Before I commit this, does anyone have any opinions? If this goes > in, I'll continue to work on this. From what my builds show me, > this does NOT break anything. >=20 > Please see the semi large patch at: >=20 > http://people.FreeBSD.org/~trhodes/handbook.diff >=20 > for an idea of what my first commit would consist of. >=20 Go for it. - Christian --=20 Christian Brueffer chris@unixpages.org brueffer@FreeBSD.org GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D --/t6ASE28jIy1gGy9 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yVwLbHYXjKDtmC0RAvvxAKCuA4hDLvDx5PNfbO23HTPro4vSkACg3bjl P2gvfFL1LkKvMqz5tt0TLAA= =XO6e -----END PGP SIGNATURE----- --/t6ASE28jIy1gGy9-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 18:00:31 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 945E337B404 for <freebsd-doc@hub.freebsd.org>; Mon, 19 May 2003 18:00:31 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E791B43F85 for <freebsd-doc@hub.freebsd.org>; Mon, 19 May 2003 18:00:30 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4K10UUp006833 for <freebsd-doc@freefall.freebsd.org>; Mon, 19 May 2003 18:00:30 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4K10Usn006832; Mon, 19 May 2003 18:00:30 -0700 (PDT) Date: Mon, 19 May 2003 18:00:30 -0700 (PDT) Message-Id: <200305200100.h4K10Usn006832@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" <simon@nitro.dk> Subject: Re: docs/51999: Missing MAN for ssh X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L. Nielsen" <simon@nitro.dk> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 01:00:31 -0000 The following reply was made to PR docs/51999; it has been noted by GNATS. From: "Simon L. Nielsen" <simon@nitro.dk> To: freebsd-gnats-submit@FreeBSD.org, mich@FreeBSD.org Cc: Subject: Re: docs/51999: Missing MAN for ssh Date: Tue, 20 May 2003 02:51:29 +0200 --KFztAG8eRSV9hGtP Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello sshd(8), ssh-keygen(1) and openssl(1) are also missing so it seems like all the crypto man pages are missing. --=20 Simon L. Nielsen --KFztAG8eRSV9hGtP Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yXwQ8kocFXgPTRwRAsV2AKCmEPc/D1zYJ0HgcZVBpsYDxJF0dQCcCtjn CMEKxQE5j6O+kJOO4XAT3Ms= =+GKz -----END PGP SIGNATURE----- --KFztAG8eRSV9hGtP-- From owner-freebsd-doc@FreeBSD.ORG Mon May 19 18:24:20 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6D2C037B401; Mon, 19 May 2003 18:24:20 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0E41043FAF; Mon, 19 May 2003 18:24:20 -0700 (PDT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4K1OJUp011205; Mon, 19 May 2003 18:24:19 -0700 (PDT) (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4K1OJG2011201; Mon, 19 May 2003 18:24:19 -0700 (PDT) Date: Mon, 19 May 2003 18:24:19 -0700 (PDT) From: Giorgos Keramidas <keramida@FreeBSD.org> Message-Id: <200305200124.h4K1OJG2011201@freefall.freebsd.org> To: keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, wosch@FreeBSD.org Subject: Re: docs/51999: Missing MAN for ssh X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 01:24:20 -0000 Synopsis: Missing MAN for ssh Responsible-Changed-From-To: freebsd-doc->wosch Responsible-Changed-By: keramida Responsible-Changed-When: Mon May 19 18:23:18 PDT 2003 Responsible-Changed-Why: Wolfram is our www-meister. http://www.freebsd.org/cgi/query-pr.cgi?pr=51999 From owner-freebsd-doc@FreeBSD.ORG Mon May 19 18:44:49 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4243337B401 for <doc@freebsd.org>; Mon, 19 May 2003 18:44:49 -0700 (PDT) Received: from veil.qala.com.sg (veil.qala.com.sg [210.193.2.44]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8466843F3F for <doc@freebsd.org>; Mon, 19 May 2003 18:44:46 -0700 (PDT) (envelope-from mirror-maintainer@mirror.averse.net) Received: from spam.averse.net (mirror [210.193.6.237] (may be forged)) by veil.qala.com.sg (8.11.3/8.11.3) with ESMTP id h4K1idv18089 for <doc@freebsd.org>; Tue, 20 May 2003 09:44:41 +0800 (SGT) X-Qala-Anti-Virus: This mail is checked for Viruses by Qala Antivirus Service. Server No. 1 Date: Tue, 20 May 2003 09:44:37 +0800 (SGT) From: mirror-maintainer@mirror.averse.net X-X-Sender: pyng@spam.averse.net To: doc@freebsd.org In-Reply-To: <20030519235838.GA36501@sixshooter.v6.thrupoint.net> Message-ID: <Pine.LNX.4.44.0305200931250.4155-100000@spam.averse.net> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Subject: Re: New FreeBSD WWW Mirror X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 01:44:49 -0000 On Mon, 19 May 2003, Jim Brown wrote: > Send your request to hostmaster@freebsd.org and copy > dnsadm@freebsd.org with your request. Once you have > your server listed as www.my.freebsd.org send a note > to doc@freebsd.org with your dnsadm@ reply. > > Someone from the FreeBSD Documentation Project team > will update the web page. Hi. Someone else was requesting information on how to be added to the drop down list, so I thought I might as well request addition too. I've been running mirrors for web (www2.sg.freebsd.org), i386 ftp (ftp.sg.freebsd.org), cvsup (cvsup.sg.freebsd.org) on mirror.averse.net for the past 10 months or so. The latter two mirrors (ftp and cvsup) are already mentioned in the handbook; just the web one remains to be added. Thanks! From owner-freebsd-doc@FreeBSD.ORG Mon May 19 19:20:14 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 54C4237B401; Mon, 19 May 2003 19:20:14 -0700 (PDT) Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251]) by mx1.FreeBSD.org (Postfix) with ESMTP id E323943FBD; Mon, 19 May 2003 19:20:13 -0700 (PDT) (envelope-from hmp@perrin.int.nxad.com) Received: by perrin.int.nxad.com (Postfix, from userid 1072) id A0A6E21068; Mon, 19 May 2003 19:20:12 -0700 (PDT) Date: Mon, 19 May 2003 19:20:12 -0700 From: Hiten Pandya <hmp@FreeBSD.ORG> To: Tom Rhodes <trhodes@FreeBSD.org> Message-ID: <20030520022012.GD40060@perrin.int.nxad.com> References: <20030519140411.75dcc28c.trhodes@FreeBSD.org> <20030520.033201.71080752.hrs@eos.ocn.ne.jp> <20030519153228.62748775.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030519153228.62748775.trhodes@FreeBSD.org> X-Operating-System: FreeBSD FreeBSD 4.7-STABLE User-Agent: Mutt/1.5.4i cc: FreeBSD-doc@FreeBSD.org Subject: Re: RFC: Fixing handbook filenames (by id="blah" modifications). X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 02:20:14 -0000 On Mon, May 19, 2003 at 03:32:28PM -0400, Tom Rhodes wrote: > On Tue, 20 May 2003 03:32:01 +0900 (JST) > Hiroki Sato <hrs@eos.ocn.ne.jp> wrote: > > > Tom Rhodes <trhodes@freebsd.org> wrote > > in <20030519140411.75dcc28c.trhodes@FreeBSD.org>: > > > > trhodes> This morning, inspired by some unknown yearn to have the filenames > > trhodes> match the chapters (ie: s/nfs.html/network-nfs.html) I created a > > trhodes> patch that 'fixes' the advanced-networking chapter. > > > > Sounds good to me :-) > > > > Well, that makes one. Now if I can just get a few more doc committers > to either say 'yes' or 'no', I'll feel better about committing it. > > Thanks for your input! (Ghostly voice) Do it. 8-) 8-) -- Hiten (hmp@FreeBSD.ORG) From owner-freebsd-doc@FreeBSD.ORG Mon May 19 19:41:52 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 836BD37B401 for <doc@freebsd.org>; Mon, 19 May 2003 19:41:52 -0700 (PDT) Received: from thalia.otenet.gr (thalia.otenet.gr [195.170.0.8]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5F61943F75 for <doc@freebsd.org>; Mon, 19 May 2003 19:41:51 -0700 (PDT) (envelope-from keramida@freebsd.org) Received: from gothmog.gr (patr530-b174.otenet.gr [212.205.244.182]) by thalia.otenet.gr (8.12.9/8.12.9) with ESMTP id h4K2fkNQ025210; Tue, 20 May 2003 05:41:48 +0300 (EEST) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.9/8.12.9) with ESMTP id h4K2fkWI012655; Tue, 20 May 2003 05:41:46 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.gr (8.12.9/8.12.9/Submit) id h4K2fjFF012654; Tue, 20 May 2003 05:41:45 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Tue, 20 May 2003 05:41:45 +0300 From: Giorgos Keramidas <keramida@freebsd.org> To: mirror-maintainer@mirror.averse.net Message-ID: <20030520024145.GA11820@gothmog.gr> References: <20030519235838.GA36501@sixshooter.v6.thrupoint.net> <Pine.LNX.4.44.0305200931250.4155-100000@spam.averse.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <Pine.LNX.4.44.0305200931250.4155-100000@spam.averse.net> cc: doc@freebsd.org Subject: Re: New FreeBSD WWW Mirror X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 02:41:52 -0000 On 2003-05-20 09:44, mirror-maintainer@mirror.averse.net wrote: > Hi. Someone else was requesting information on how to be added to the > drop down list, so I thought I might as well request addition too. > > I've been running mirrors for web (www2.sg.freebsd.org), i386 ftp > (ftp.sg.freebsd.org), cvsup (cvsup.sg.freebsd.org) on mirror.averse.net > for the past 10 months or so. The latter two mirrors (ftp and cvsup) are > already mentioned in the handbook; just the web one remains to be added. It's there already. It's listed in both the drop down list of the http://www.FreeBSD.org/ start page (look for 'Singapore') and in the ``World Wide Web Servers'' section of the Handbook at: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/eresources-web.html Am I missing something? - Giorgos From owner-freebsd-doc@FreeBSD.ORG Mon May 19 20:19:55 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B0D8637B401; Mon, 19 May 2003 20:19:55 -0700 (PDT) Received: from veil.qala.com.sg (veil.qala.com.sg [210.193.2.44]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3E80C43F75; Mon, 19 May 2003 20:19:54 -0700 (PDT) (envelope-from mirror-maintainer@mirror.averse.net) Received: from spam.averse.net (mirror [210.193.6.237] (may be forged)) by veil.qala.com.sg (8.11.3/8.11.3) with ESMTP id h4K3Jnv03691; Tue, 20 May 2003 11:19:49 +0800 (SGT) X-Qala-Anti-Virus: This mail is checked for Viruses by Qala Antivirus Service. Server No. 1 Date: Tue, 20 May 2003 11:19:49 +0800 (SGT) From: mirror-maintainer@mirror.averse.net X-X-Sender: pyng@spam.averse.net To: Giorgos Keramidas <keramida@freebsd.org> In-Reply-To: <20030520024145.GA11820@gothmog.gr> Message-ID: <Pine.LNX.4.44.0305201116180.31133-100000@spam.averse.net> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: doc@freebsd.org Subject: Re: New FreeBSD WWW Mirror X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 03:19:56 -0000 On Tue, 20 May 2003, Giorgos Keramidas wrote: > On 2003-05-20 09:44, mirror-maintainer@mirror.averse.net wrote: > > > > I've been running mirrors for web (www2.sg.freebsd.org), i386 ftp > > (ftp.sg.freebsd.org), cvsup (cvsup.sg.freebsd.org) on mirror.averse.net > > for the past 10 months or so. The latter two mirrors (ftp and cvsup) are > > already mentioned in the handbook; just the web one remains to be added. > > It's there already. It's listed in both the drop down list of the > http://www.FreeBSD.org/ start page (look for 'Singapore') and in the > ``World Wide Web Servers'' section of the Handbook at: > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/eresources-web.html > Am I missing something? Oops. Obviously my mistake. I just saw "Singapore" in the drop-down box and assumed that would lead to www.sg.freebsd.org (non-ideal as that lives on an ADSL connected box) instead of www2.sg.freebsd.org. My apologies and sorry for wasting your time (and mine)! From owner-freebsd-doc@FreeBSD.ORG Mon May 19 20:39:17 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 82D0637B401; Mon, 19 May 2003 20:39:17 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id F2D5643F3F; Mon, 19 May 2003 20:39:16 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4K3dGWA013855; Mon, 19 May 2003 20:39:16 -0700 (PDT) (envelope-from murray) Date: Mon, 19 May 2003 20:39:16 -0700 From: Murray Stokely <murray@FreeBSD.org> To: Robert Watson <rwatson@FreeBSD.org> Message-ID: <20030519203916.J8403@freebsdmall.com> References: <Pine.NEB.3.96L.1030519144915.59393K-100000@fledge.watson.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <Pine.NEB.3.96L.1030519144915.59393K-100000@fledge.watson.org>; from rwatson@FreeBSD.org on Mon, May 19, 2003 at 02:54:08PM -0400 X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doc@FreeBSD.org Subject: Re: Adding new top-level section to Developer's Handbook: System Architecture? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 03:39:17 -0000 On Mon, May 19, 2003 at 02:54:08PM -0400, Robert Watson wrote: > I'm not sure adding a High Level Architecture section is the long term > solution. The long term solution might be to break it into two books -- > one on developing/debugging FreeBSD, and the other on developing/debugging > on FreeBSD. Or perhaps an Architecture/design book separate from a > practices and procedures book. Yes I've been threatening to split this up for years and I think it's certainly where we need to go in the long run. > Regardless, would anyone object to my taking the above described strategy > for the time being, when I bring in the current draft? Not at all. I think bringing it in as a new section is fine for now, and we'll make sure to coordinate with you when it comes time to split into two books. - Murray From owner-freebsd-doc@FreeBSD.ORG Mon May 19 20:43:13 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D7BA537B401; Mon, 19 May 2003 20:43:13 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4A9BE43FA3; Mon, 19 May 2003 20:43:13 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4K3hCc0013903; Mon, 19 May 2003 20:43:12 -0700 (PDT) (envelope-from murray) Date: Mon, 19 May 2003 20:43:12 -0700 From: Murray Stokely <murray@freebsd.org> To: "Simon L. Nielsen" <simon@nitro.dk> Message-ID: <20030519204312.K8403@freebsdmall.com> References: <20030519192255.GB74434@submonkey.net> <20030519153048.51f20a06.trhodes@FreeBSD.org> <20030519200900.GA1120@nitro.dk> <20030519161700.27143841.trhodes@FreeBSD.org> <20030519203451.GB1120@nitro.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20030519203451.GB1120@nitro.dk>; from simon@nitro.dk on Mon, May 19, 2003 at 10:34:52PM +0200 X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Tom Rhodes <trhodes@freebsd.org> cc: freebsd-doc@freebsd.org Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 03:43:14 -0000 On Mon, May 19, 2003 at 10:34:52PM +0200, Simon L. Nielsen wrote: > > > <comment by Murray from docs/50790 audit trail> > > > One thing to note is > > > that it doesn't look good to use the man page entities twice in close > > > proximity. So I used &man.dumpon.8; the first time, then just used > > > <command>dumpon</command> elsewhere in the paragraph. > > > </comment> > > > > > > I think this is seems like a good way since the man reference is still > > > nice to have. > > > > Ok, I see the logic here. Thanks guys. > > Perhaps it would be a good idea to add a short note about this to the > section about "Applications, commands, options, and cites" in the FDP > primer ? > > I can make a patch if it sounds like a good idea... Yes I'd like to see this documented. Please send us a patch! ;) - Murray From owner-freebsd-doc@FreeBSD.ORG Mon May 19 23:30:33 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EBF6137B401; Mon, 19 May 2003 23:30:33 -0700 (PDT) Received: from rwcrmhc52.attbi.com (rwcrmhc52.attbi.com [216.148.227.88]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7A8FA43F3F; Mon, 19 May 2003 23:30:33 -0700 (PDT) (envelope-from horikawa@jp.freebsd.org) Received: from localhost (12-252-35-167.client.attbi.com[12.252.35.167]) by attbi.com (rwcrmhc52) with SMTP id <2003052006303205200e2vlle>; Tue, 20 May 2003 06:30:33 +0000 Date: Tue, 20 May 2003 00:28:06 -0600 (MDT) Message-Id: <20030520.002806.55513127.horikawa@attbi.com> To: ru@freebsd.org From: Kazuo Horikawa <horikawa@jp.FreeBSD.org> In-Reply-To: <20030519195724.GD79469@sunbay.com> References: <20030514191822.GA1751@gothmog.gr> <20030514.232305.59463444.horikawa@attbi.com> <20030519195724.GD79469@sunbay.com> X-Mailer: Mew version 3.1 on Emacs 21.2 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit cc: doc@freebsd.org cc: keramida@freebsd.org Subject: Re: ".It Xo" ... generates improper output on groff 1.18.1 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 06:30:34 -0000 Ruslan Ermilov <ru@freebsd.org> wrote: > This has been fixed in the attached commit. Good news. Thanks a lot! -- Kazuo Horikawa From owner-freebsd-doc@FreeBSD.ORG Tue May 20 01:30:21 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0FB8D37B401 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 01:30:18 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E284A43F3F for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 01:30:17 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4K8UGUp050758 for <freebsd-doc@freefall.freebsd.org>; Tue, 20 May 2003 01:30:16 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4K8UGtc050755; Tue, 20 May 2003 01:30:16 -0700 (PDT) Date: Tue, 20 May 2003 01:30:16 -0700 (PDT) Message-Id: <200305200830.h4K8UGtc050755@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Alexey Zelkin <phantom@FreeBSD.org.ua> Subject: Re: docs/52448: [patch] Misc man page reference fixes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Alexey Zelkin <phantom@FreeBSD.org.ua> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 08:30:21 -0000 The following reply was made to PR docs/52448; it has been noted by GNATS. From: Alexey Zelkin <phantom@FreeBSD.org.ua> To: "Simon L.Nielsen" <simon@nitro.dk> Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/52448: [patch] Misc man page reference fixes Date: Tue, 20 May 2003 11:28:28 +0300 On Tue, May 20, 2003 at 12:24:10AM +0200, Simon L.Nielsen wrote: > > >Number: 52448 > >Category: docs > >Synopsis: [patch] Misc man page reference fixes [..] > >Description: > intro.3: > Remove Xr references to libc, libcurses, libcompat, libkvm, > libl, libtermcap and liby since they do not exists as man > pages under those names. > > Add section number to libmp Xr reference (which do have a man > page). > Add libmp description - from libmp(3). I'd rather prefer to someone write stub or normal (which is better) manual pages for those libraries than removing Xr's. Yet Another Junior Doc Hacker Task -- ant takers ? :-) > picobsd.8: > Remove Xr reference to etherboot since it does not have a man > page at all. Add reference to the location of the port instead. From owner-freebsd-doc@FreeBSD.ORG Tue May 20 02:20:09 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C644237B404 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 02:20:09 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6B34943F93 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 02:20:09 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4K9K9Up055879 for <freebsd-doc@freefall.freebsd.org>; Tue, 20 May 2003 02:20:09 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4K9K9if055878; Tue, 20 May 2003 02:20:09 -0700 (PDT) Date: Tue, 20 May 2003 02:20:09 -0700 (PDT) Message-Id: <200305200920.h4K9K9if055878@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" <simon@nitro.dk> Subject: Re: docs/52448: [patch] Misc man page reference fixes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L. Nielsen" <simon@nitro.dk> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 09:20:10 -0000 The following reply was made to PR docs/52448; it has been noted by GNATS. From: "Simon L. Nielsen" <simon@nitro.dk> To: Alexey Zelkin <phantom@FreeBSD.org.ua> Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/52448: [patch] Misc man page reference fixes Date: Tue, 20 May 2003 11:10:49 +0200 --HcAYCG3uE/tztfnV Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.20 11:28:28 +0300, Alexey Zelkin wrote: > On Tue, May 20, 2003 at 12:24:10AM +0200, Simon L.Nielsen wrote: > >=20 > > >Number: 52448 > > >Category: docs > > >Synopsis: [patch] Misc man page reference fixes >=20 > [..] >=20 > > >Description: > > intro.3: > > Remove Xr references to libc, libcurses, libcompat, libkvm, > > libl, libtermcap and liby since they do not exists as man > > pages under those names. > >=20 > > Add section number to libmp Xr reference (which do have a man > > page). > > Add libmp description - from libmp(3). >=20 > I'd rather prefer to someone write stub or normal (which is better) manual > pages for those libraries than removing Xr's. Yet Another Junior Doc Hac= ker > Task -- ant takers ? :-) I might as well get to know mdoc better :-) I will have a look at theese. Some of them might simply be fixed with proper links to existing man page. Update to follow once I get looked at it more. --=20 Simon L. Nielsen --HcAYCG3uE/tztfnV Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+yfEX8kocFXgPTRwRAv90AKDOEEQcy+2aSoBd5VEVacLBqwPdfQCgwBE+ 3lrnNPLCidIqOThf8uCpizI= =HTZl -----END PGP SIGNATURE----- --HcAYCG3uE/tztfnV-- From owner-freebsd-doc@FreeBSD.ORG Tue May 20 04:20:31 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E4BE637B401; Tue, 20 May 2003 04:20:30 -0700 (PDT) Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2932A43FE1; Tue, 20 May 2003 04:20:26 -0700 (PDT) (envelope-from hmp@perrin.int.nxad.com) Received: by perrin.int.nxad.com (Postfix, from userid 1072) id 1B20221058; Tue, 20 May 2003 04:20:25 -0700 (PDT) Date: Tue, 20 May 2003 04:20:24 -0700 From: Hiten Pandya <hmp@FreeBSD.ORG> To: Murray Stokely <murray@FreeBSD.org> Message-ID: <20030520112024.GA63699@perrin.int.nxad.com> References: <Pine.NEB.3.96L.1030519144915.59393K-100000@fledge.watson.org> <20030519203916.J8403@freebsdmall.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030519203916.J8403@freebsdmall.com> X-Operating-System: FreeBSD FreeBSD 4.7-STABLE User-Agent: Mutt/1.5.4i cc: doc@FreeBSD.org cc: Robert Watson <rwatson@FreeBSD.org> Subject: Re: Adding new top-level section to Developer's Handbook: System Architecture? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 11:20:32 -0000 On Mon, May 19, 2003 at 08:39:16PM -0700, Murray Stokely wrote: > On Mon, May 19, 2003 at 02:54:08PM -0400, Robert Watson wrote: > > I'm not sure adding a High Level Architecture section is the long term > > solution. The long term solution might be to break it into two books -- > > one on developing/debugging FreeBSD, and the other on developing/debugging > > on FreeBSD. Or perhaps an Architecture/design book separate from a > > practices and procedures book. > > Yes I've been threatening to split this up for years and I think it's > certainly where we need to go in the long run. > > > Regardless, would anyone object to my taking the above described strategy > > for the time being, when I bring in the current draft? > > Not at all. I think bringing it in as a new section is fine for now, > and we'll make sure to coordinate with you when it comes time to split > into two books. Chapter naming in Dev-Handbook is really messed, IMHO. Also, we need to add ``empty still todo'' sections as <sect> tags, rather than just naming them inside a chapter. When I get more time, I am thinking of writing a ``Kernel Programming FAQ'' like the one available in NetBSD's doc, but a little more comprehensive. No promises yet. :-) Cheers. -- Hiten (hmp@FreeBSD.ORG) From owner-freebsd-doc@FreeBSD.ORG Tue May 20 04:40:05 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E53E837B404 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 04:40:05 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 012A243F93 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 04:40:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4KBe4Up073602 for <freebsd-doc@freefall.freebsd.org>; Tue, 20 May 2003 04:40:04 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4KBe4ne073601; Tue, 20 May 2003 04:40:04 -0700 (PDT) Resent-Date: Tue, 20 May 2003 04:40:04 -0700 (PDT) Resent-Message-Id: <200305201140.h4KBe4ne073601@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, "Simon L.Nielsen" <simon@nitro.dk> Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 37B4D37B401 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 04:36:10 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8FBB043F93 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 04:36:09 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 1F06D10BF84; Tue, 20 May 2003 13:36:08 +0200 (CEST) Message-Id: <20030520113608.1F06D10BF84@arthur.nitro.dk> Date: Tue, 20 May 2003 13:36:08 +0200 (CEST) From: "Simon L.Nielsen" <simon@nitro.dk> To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/52467: [patch] Add note about manref/command usage to FDP X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L.Nielsen" <simon@nitro.dk> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 11:40:06 -0000 >Number: 52467 >Category: docs >Synopsis: [patch] Add note about manref/command usage to FDP >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Tue May 20 04:40:04 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Simon L. Nielsen >Release: FreeBSD 4.8-STABLE i386 >Organization: >Environment: >Description: Add a description of when to use a manual page reference and when to use <command> to markup commands in SGML docbook. This was discussed on FreeBSD-doc in the thread starting with http://www.freebsd.org/cgi/getmsg.cgi?fetch=125961+0+current/freebsd-doc >How-To-Repeat: >Fix: --- doc-fdp-manref-command.patch begins here --- Index: sgml-markup/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml,v retrieving revision 1.53 diff -u -d -r1.53 chapter.sgml --- sgml-markup/chapter.sgml 26 Apr 2003 07:40:04 -0000 1.53 +++ sgml-markup/chapter.sgml 20 May 2003 13:25:57 -0000 @@ -1741,6 +1741,14 @@ <para>Use <sgmltag>option</sgmltag> to mark up a command's options.</para> + <para>When referring to the same command multiple times in + close proximity it preferred to use the + <literal>&man.<replaceable>command</replaceable>.<replaceable>section</replaceable>;</literal> + notation to markup the first reference and use + <sgmltag>command</sgmltag> to markup subsequent references. + This makes the generated output, especially HTML, appear + visually better.</para> + <para>This can be confusing, and sometimes the choice is not always clear. Hopefully this example makes it clearer.</para> --- doc-fdp-manref-command.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue May 20 06:49:27 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3C02E37B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 06:49:27 -0700 (PDT) Received: from mail.tcoip.com.br (erato.tco.net.br [200.220.254.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3F78843FA3 for <doc@FreeBSD.org>; Tue, 20 May 2003 06:49:25 -0700 (PDT) (envelope-from dcs@tcoip.com.br) Received: from tcoip.com.br ([10.0.2.6]) by mail.tcoip.com.br (8.11.6/8.11.6) with ESMTP id h4KDnMl20240 for <doc@FreeBSD.org>; Tue, 20 May 2003 10:49:22 -0300 Message-ID: <3ECA3261.2020307@tcoip.com.br> Date: Tue, 20 May 2003 10:49:21 -0300 From: "Daniel C. Sobral" <dcs@tcoip.com.br> User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.4a) Gecko/20030416 X-Accept-Language: en-us, en, pt-br, ja MIME-Version: 1.0 To: doc@FreeBSD.org Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Subject: doc/en_US.ISO8859-1/books/developers-handbook/boot-loader.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 13:49:27 -0000 As much as I admire my FreeBSD mentor, Mike never even so much as committed a change to loader(8). :-) Could someone please correct the information in the subject-mentioned page? :-) -- Daniel C. Sobral (8-DCS) Gerencia de Operacoes Divisao de Comunicacao de Dados Coordenacao de Seguranca VIVO Centro Oeste Norte Fones: 55-61-313-7654/Cel: 55-61-9618-0904 E-mail: Daniel.Capo@tco.net.br Daniel.Sobral@tcoip.com.br dcs@tcoip.com.br Outros: dcs@newsguy.com dcs@freebsd.org capo@notorious.bsdconspiracy.net How untasteful can you get? From owner-freebsd-doc@FreeBSD.ORG Tue May 20 07:25:10 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7BDF237B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 07:25:10 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9E42843FB1 for <doc@FreeBSD.org>; Tue, 20 May 2003 07:25:09 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19I83A-000Lxi-00; Tue, 20 May 2003 15:25:08 +0100 Date: Tue, 20 May 2003 15:25:08 +0100 From: Ceri Davies <setantae@submonkey.net> To: "Daniel C. Sobral" <dcs@tcoip.com.br> Message-ID: <20030520142508.GA84344@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, "Daniel C. Sobral" <dcs@tcoip.com.br>, doc@FreeBSD.org References: <3ECA3261.2020307@tcoip.com.br> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="WIyZ46R2i8wDzkSu" Content-Disposition: inline In-Reply-To: <3ECA3261.2020307@tcoip.com.br> User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> cc: doc@FreeBSD.org Subject: Re: doc/en_US.ISO8859-1/books/developers-handbook/boot-loader.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 14:25:10 -0000 --WIyZ46R2i8wDzkSu Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, May 20, 2003 at 10:49:21AM -0300, Daniel C. Sobral wrote: > As much as I admire my FreeBSD mentor, Mike never even so much as=20 > committed a change to loader(8). :-) Could someone please correct the=20 > information in the subject-mentioned page? :-) r1.1 of src/sys/boot/common/loader.8 seems to think otherwise. Ceri --=20 User: DO YOU ACCEPT JESUS CHRIST AS YOUR PERSONAL LORD AND SAVIOR? Iniaes: Sure, I can accept all forms of payment. -- www.chatterboxchallenge.com --WIyZ46R2i8wDzkSu Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yjrEocfcwTS3JF8RAktRAKC7toDpE/M/FVAYh8daYVMXgVU9zgCfWm+8 okjGhNyCid/LNpQ0wlsR+EM= =j9z0 -----END PGP SIGNATURE----- --WIyZ46R2i8wDzkSu-- From owner-freebsd-doc@FreeBSD.ORG Tue May 20 07:34:07 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7EB6C37B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 07:34:07 -0700 (PDT) Received: from mail.tcoip.com.br (erato.tco.net.br [200.220.254.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id D673643FD7 for <doc@FreeBSD.org>; Tue, 20 May 2003 07:34:04 -0700 (PDT) (envelope-from dcs@tcoip.com.br) Received: from tcoip.com.br ([10.0.2.6]) by mail.tcoip.com.br (8.11.6/8.11.6) with ESMTP id h4KEXHl21486; Tue, 20 May 2003 11:33:17 -0300 Message-ID: <3ECA3CAC.2020507@tcoip.com.br> Date: Tue, 20 May 2003 11:33:16 -0300 From: "Daniel C. Sobral" <dcs@tcoip.com.br> User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.4a) Gecko/20030416 X-Accept-Language: en-us, en, pt-br, ja MIME-Version: 1.0 To: Ceri Davies <setantae@submonkey.net> References: <3ECA3261.2020307@tcoip.com.br> <20030520142508.GA84344@submonkey.net> In-Reply-To: <20030520142508.GA84344@submonkey.net> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: doc/en_US.ISO8859-1/books/developers-handbook/boot-loader.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 14:34:07 -0000 Ceri Davies wrote: > On Tue, May 20, 2003 at 10:49:21AM -0300, Daniel C. Sobral wrote: > >>As much as I admire my FreeBSD mentor, Mike never even so much as >>committed a change to loader(8). :-) Could someone please correct the >>information in the subject-mentioned page? :-) > > > r1.1 of src/sys/boot/common/loader.8 seems to think otherwise. It does??? revision 1.1 date: 1999/03/15 08:52:23; author: dcs; state: Exp; branches: 1.1.2; The man page, version 0.1. /home/dcs$ cvs log src/sys/boot/common/loader.8| grep msmith /home/dcs$ -- Daniel C. Sobral (8-DCS) Gerencia de Operacoes Divisao de Comunicacao de Dados Coordenacao de Seguranca VIVO Centro Oeste Norte Fones: 55-61-313-7654/Cel: 55-61-9618-0904 E-mail: Daniel.Capo@tco.net.br Daniel.Sobral@tcoip.com.br dcs@tcoip.com.br Outros: dcs@newsguy.com dcs@freebsd.org capo@notorious.bsdconspiracy.net Distance doesn't make you any smaller, but it does make you part of a larger picture. From owner-freebsd-doc@FreeBSD.ORG Tue May 20 08:14:43 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5A23E37B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 08:14:43 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id E6C9043FBD for <doc@FreeBSD.org>; Tue, 20 May 2003 08:14:41 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19I8p4-000M2W-00; Tue, 20 May 2003 16:14:38 +0100 Date: Tue, 20 May 2003 16:14:38 +0100 From: Ceri Davies <setantae@submonkey.net> To: "Daniel C. Sobral" <dcs@tcoip.com.br> Message-ID: <20030520151438.GA84668@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, "Daniel C. Sobral" <dcs@tcoip.com.br>, doc@FreeBSD.org References: <3ECA3261.2020307@tcoip.com.br> <20030520142508.GA84344@submonkey.net> <3ECA3CAC.2020507@tcoip.com.br> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="r5Pyd7+fXNt84Ff3" Content-Disposition: inline In-Reply-To: <3ECA3CAC.2020507@tcoip.com.br> User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> cc: doc@FreeBSD.org Subject: Re: doc/en_US.ISO8859-1/books/developers-handbook/boot-loader.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 15:14:43 -0000 --r5Pyd7+fXNt84Ff3 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, May 20, 2003 at 11:33:16AM -0300, Daniel C. Sobral wrote: > Ceri Davies wrote: > >On Tue, May 20, 2003 at 10:49:21AM -0300, Daniel C. Sobral wrote: > > > >>As much as I admire my FreeBSD mentor, Mike never even so much as=20 > >>committed a change to loader(8). :-) Could someone please correct the= =20 > >>information in the subject-mentioned page? :-) > > > > > >r1.1 of src/sys/boot/common/loader.8 seems to think otherwise. >=20 > It does??? >=20 > revision 1.1 > date: 1999/03/15 08:52:23; author: dcs; state: Exp; > branches: 1.1.2; > The man page, version 0.1. >=20 > /home/dcs$ cvs log src/sys/boot/common/loader.8| grep msmith > /home/dcs$ Have a look at it: $ cvs -QR co -pr1.1 src/sys/boot/common/loader.8 | grep -iB2 smith =2ENm was written by =2EAn Michael Smith Aq msmisth@freebsd.org . OK, there's a typo, but it is him. Ceri --=20 User: DO YOU ACCEPT JESUS CHRIST AS YOUR PERSONAL LORD AND SAVIOR? Iniaes: Sure, I can accept all forms of payment. -- www.chatterboxchallenge.com --r5Pyd7+fXNt84Ff3 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+ykZeocfcwTS3JF8RAliqAKCC8GdvcDMyvc0L9BEjKVdIKU+5IACfc6Ut xRnOQ4+GyernjdBZUre7trc= =Bx6i -----END PGP SIGNATURE----- --r5Pyd7+fXNt84Ff3-- From owner-freebsd-doc@FreeBSD.ORG Tue May 20 08:20:01 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E9BD637B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 08:20:01 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 169F443FCB for <doc@FreeBSD.org>; Tue, 20 May 2003 08:20:01 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4KFJwuf053308; Tue, 20 May 2003 11:19:59 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 20 May 2003 11:11:42 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Ceri Davies <setantae@submonkey.net> Message-Id: <20030520111142.34d06a53.trhodes@FreeBSD.org> In-Reply-To: <20030520151438.GA84668@submonkey.net> References: <3ECA3261.2020307@tcoip.com.br> <20030520142508.GA84344@submonkey.net> <3ECA3CAC.2020507@tcoip.com.br> <20030520151438.GA84668@submonkey.net> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org cc: dcs@tcoip.com.br Subject: Re: doc/en_US.ISO8859-1/books/developers-handbook/boot-loader.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 15:20:02 -0000 On Tue, 20 May 2003 16:14:38 +0100 Ceri Davies <setantae@submonkey.net> wrote: > On Tue, May 20, 2003 at 11:33:16AM -0300, Daniel C. Sobral wrote: > > Ceri Davies wrote: > > >On Tue, May 20, 2003 at 10:49:21AM -0300, Daniel C. Sobral wrote: > > > > > >>As much as I admire my FreeBSD mentor, Mike never even so much as > > >>committed a change to loader(8). :-) Could someone please correct the > > >>information in the subject-mentioned page? :-) > > > > > > > > >r1.1 of src/sys/boot/common/loader.8 seems to think otherwise. > > > > It does??? > > > > revision 1.1 > > date: 1999/03/15 08:52:23; author: dcs; state: Exp; > > branches: 1.1.2; > > The man page, version 0.1. > > > > /home/dcs$ cvs log src/sys/boot/common/loader.8| grep msmith > > /home/dcs$ > > Have a look at it: > > $ cvs -QR co -pr1.1 src/sys/boot/common/loader.8 | grep -iB2 smith > .Nm > was written by > .An Michael Smith Aq msmisth@freebsd.org . > > OK, there's a typo, but it is him. And if someone doesn't fix it soon... Well... I may just have to cvs ci the typo away... -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue May 20 08:40:17 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7B9F137B401 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 08:40:17 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8629143F85 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 08:40:15 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4KFeFUp081884 for <freebsd-doc@freefall.freebsd.org>; Tue, 20 May 2003 08:40:15 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4KFeF70081883; Tue, 20 May 2003 08:40:15 -0700 (PDT) Resent-Date: Tue, 20 May 2003 08:40:15 -0700 (PDT) Resent-Message-Id: <200305201540.h4KFeF70081883@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, Fernando Schapachnik <fernando@mecon.gov.ar> Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0FD4F37B404 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 08:33:07 -0700 (PDT) Received: from relay2.mecon.ar (relay2.mecon.ar [168.101.16.11]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2421E43FBD for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 08:33:05 -0700 (PDT) (envelope-from fpscha@mecon.gov.ar) Received: from racing.mecon.ar (racing.mecon.ar [168.101.133.15]) by relay2.mecon.ar (8.12.6p2/8.12.6) with ESMTP id h4KFX30K092236 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 12:33:03 -0300 (ART) (envelope-from fpscha@mecon.gov.ar) Received: from racing.mecon.ar (meyosp.mecon.gov.ar [10.11.0.149]) by racing.mecon.ar (8.12.6/8.12.6) with ESMTP id h4KFWv1j041035 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 12:32:58 -0300 (ART) (envelope-from fpscha@mecon.gov.ar) Received: from bal740r0.mecon.gov.ar (bal740r0.mecon.ar [10.11.1.11]) by racing.mecon.ar (8.12.6/8.12.6) with ESMTP id h4KFWvGG041031 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 12:32:57 -0300 (ART) (envelope-from fpscha@mecon.gov.ar) Received: from bal740r0.mecon.gov.ar (localhost [127.0.0.1]) by bal740r0.mecon.gov.ar (8.12.6/8.12.6) with ESMTP id h4KFWvCH000877 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 12:32:57 -0300 (ART) (envelope-from fpscha@bal740r0.mecon.gov.ar) Received: (from fpscha@localhost) by bal740r0.mecon.gov.ar (8.12.6/8.12.6/Submit) id h4KFWuJ8000876; Tue, 20 May 2003 12:32:56 -0300 (ART) (envelope-from fpscha) Message-Id: <200305201532.h4KFWuJ8000876@bal740r0.mecon.gov.ar> Date: Tue, 20 May 2003 12:32:56 -0300 (ART) From: Fernando Schapachnik <fernando@mecon.gov.ar> To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/52487: sendmail man page is wrong regarding -qI sintax. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Fernando Schapachnik <fernando@mecon.gov.ar> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 15:40:17 -0000 >Number: 52487 >Category: docs >Synopsis: sendmail man page is wrong regarding -qI sintax. >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Tue May 20 08:40:14 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Fernando Schapachnik >Release: FreeBSD 4.7-RELEASE-p9 i386 >Organization: >Environment: System: FreeBSD bal740r0.mecon.gov.ar 4.7-RELEASE-p9 FreeBSD 4.7-RELEASE-p9 #4: Mon Mar 24 14:27:42 ART 2003 root@bal740r0.mecon.gov.ar:/usr/obj/usr/src/sys/BAL740R0 i386 >Description: FreeBSD sendmail man page says: -q[!]I substr Limit processed jobs to those containing substr as a substring of the queue id or not when ! is spec­ ified. However, issuing: sendmail -qI ID processes the wrong message. The correct sintax should be: sendmial -qIID >How-To-Repeat: >Fix: The extra space should be removed from the man page. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue May 20 09:45:47 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4278637B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 09:45:47 -0700 (PDT) Received: from mail.tcoip.com.br (erato.tco.net.br [200.220.254.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id D36F743F75 for <doc@FreeBSD.org>; Tue, 20 May 2003 09:45:45 -0700 (PDT) (envelope-from dcs@tcoip.com.br) Received: from tcoip.com.br ([10.0.2.6]) by mail.tcoip.com.br (8.11.6/8.11.6) with ESMTP id h4KGjIl25091; Tue, 20 May 2003 13:45:19 -0300 Message-ID: <3ECA5B9E.1000006@tcoip.com.br> Date: Tue, 20 May 2003 13:45:18 -0300 From: "Daniel C. Sobral" <dcs@tcoip.com.br> User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.4a) Gecko/20030416 X-Accept-Language: en-us, en, pt-br, ja MIME-Version: 1.0 To: Ceri Davies <setantae@submonkey.net> References: <3ECA3261.2020307@tcoip.com.br> <20030520142508.GA84344@submonkey.net> <3ECA3CAC.2020507@tcoip.com.br> <20030520151438.GA84668@submonkey.net> In-Reply-To: <20030520151438.GA84668@submonkey.net> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: doc/en_US.ISO8859-1/books/developers-handbook/boot-loader.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 16:45:47 -0000 Ceri Davies wrote: > On Tue, May 20, 2003 at 11:33:16AM -0300, Daniel C. Sobral wrote: > >>Ceri Davies wrote: >> >>>On Tue, May 20, 2003 at 10:49:21AM -0300, Daniel C. Sobral wrote: >>> >>> >>>>As much as I admire my FreeBSD mentor, Mike never even so much as >>>>committed a change to loader(8). :-) Could someone please correct the >>>>information in the subject-mentioned page? :-) >>> >>> >>>r1.1 of src/sys/boot/common/loader.8 seems to think otherwise. >> >>It does??? >> >>revision 1.1 >>date: 1999/03/15 08:52:23; author: dcs; state: Exp; >>branches: 1.1.2; >>The man page, version 0.1. >> >>/home/dcs$ cvs log src/sys/boot/common/loader.8| grep msmith >>/home/dcs$ > > > Have a look at it: > > $ cvs -QR co -pr1.1 src/sys/boot/common/loader.8 | grep -iB2 smith > .Nm > was written by > .An Michael Smith Aq msmisth@freebsd.org . > > OK, there's a typo, but it is him. AUTHORS The loader was written by Michael Smith <msmith@FreeBSD.org>. FICL was written by John Sadler <john_sadler@alum.mit.edu>. And none of them wrote the loader _man page_. :-) -- Daniel C. Sobral (8-DCS) Gerencia de Operacoes Divisao de Comunicacao de Dados Coordenacao de Seguranca VIVO Centro Oeste Norte Fones: 55-61-313-7654/Cel: 55-61-9618-0904 E-mail: Daniel.Capo@tco.net.br Daniel.Sobral@tcoip.com.br dcs@tcoip.com.br Outros: dcs@newsguy.com dcs@freebsd.org capo@notorious.bsdconspiracy.net To erase a line you've written at the command prompt, use "Ctrl-U". -- Dru <genesis@istar.ca> From owner-freebsd-doc@FreeBSD.ORG Tue May 20 10:17:00 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9B9A437B401 for <FreeBSD-doc@FreeBSD.org>; Tue, 20 May 2003 10:17:00 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id D531343F85 for <FreeBSD-doc@FreeBSD.org>; Tue, 20 May 2003 10:16:59 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4KHGwuf053484 for <FreeBSD-doc@FreeBSD.org>; Tue, 20 May 2003 13:16:58 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 20 May 2003 13:08:41 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: FreeBSD-doc@FreeBSD.org Message-Id: <20030520130841.2e49a3f3.trhodes@FreeBSD.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Heads up: ports chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 17:17:00 -0000 Greetings, This is just a heads up that I'm going to be rewriting a few parts of the ports chapter. I'll also be removing the FAQ and either merging the information into our current chapter, or adding new sections. Some new sections will be added during this overhaul. And yes, I will be translator-friendly. Now, no one here can say I caught them off guard... :) -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue May 20 11:34:12 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5A72B37B401; Tue, 20 May 2003 11:34:12 -0700 (PDT) Received: from praetor.linc-it.com (hardtime.linuxman.net [66.147.26.65]) by mx1.FreeBSD.org (Postfix) with ESMTP id 473FD43F93; Tue, 20 May 2003 11:34:09 -0700 (PDT) (envelope-from fullermd@over-yonder.net) Received: from mortis.over-yonder.net (adsl-156-171-96.jan.bellsouth.net [66.156.171.96]) (using TLSv1 with cipher EDH-RSA-DES-CBC3-SHA (168/168 bits)) (No client certificate requested) by praetor.linc-it.com (Postfix) with ESMTP id A567E15482; Tue, 20 May 2003 13:34:07 -0500 (CDT) Received: by mortis.over-yonder.net (Postfix, from userid 100) id E8CFA20F12; Tue, 20 May 2003 13:34:04 -0500 (CDT) Date: Tue, 20 May 2003 13:34:04 -0500 From: "Matthew D. Fuller" <fullermd@over-yonder.net> To: Murray Stokely <murray@FreeBSD.org> Message-ID: <20030520183404.GA36258@over-yonder.net> References: <20030518.095226.115908955.imp@bsdimp.com> <20030518160039.GA25804@submonkey.net> <20030519013706.GN77354@wantadilla.lemis.com> <20030519000908.E8403@freebsdmall.com> <20030519080452.GR77354@wantadilla.lemis.com> <20030519021310.F8403@freebsdmall.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030519021310.F8403@freebsdmall.com> User-Agent: Mutt/1.4i-fullermd.1 X-Editor: vi X-OS: FreeBSD <http://www.freebsd.org/> cc: doc@FreeBSD.org Subject: Re: DocBook book X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 18:34:12 -0000 On Mon, May 19, 2003 at 02:13:10AM -0700 I heard the voice of Murray Stokely, and lo! it spake thus: > > I'm not even aware of any printed books about DSSSL, but there are tens > of books about XSLT. Peripherally to this discussion: >From my own watchings of DSSSL discussion lists, I don't think anybody is aware of printed books about DSSSL 8-) There are occasional comments from people trying to write them, though. I can say from experience that learning it is a fascinating exercise in pain. -- Matthew Fuller (MF4839) | fullermd@over-yonder.net Systems/Network Administrator | http://www.over-yonder.net/~fullermd/ "The only reason I'm burning my candle at both ends, is because I haven't figured out how to light the middle yet" From owner-freebsd-doc@FreeBSD.ORG Tue May 20 13:43:50 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C563637B401 for <FreeBSD-doc@FreeBSD.org>; Tue, 20 May 2003 13:43:50 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id B2E1643F75 for <FreeBSD-doc@FreeBSD.org>; Tue, 20 May 2003 13:43:49 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4KKhmuf053962 for <FreeBSD-doc@freebsd.org>; Tue, 20 May 2003 16:43:48 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 20 May 2003 16:35:31 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: FreeBSD-doc@FreeBSD.org Message-Id: <20030520163531.42399522.trhodes@FreeBSD.org> In-Reply-To: <20030520130841.2e49a3f3.trhodes@FreeBSD.org> References: <20030520130841.2e49a3f3.trhodes@FreeBSD.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Re: Heads up: ports chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 20:43:51 -0000 On Tue, 20 May 2003 13:08:41 -0400 Tom Rhodes <trhodes@freebsd.org> wrote: > Greetings, > > This is just a heads up that I'm going to be rewriting a few parts > of the ports chapter. I'll also be removing the FAQ and either > merging the information into our current chapter, or adding new > sections. Some new sections will be added during this overhaul. > > And yes, I will be translator-friendly. > > > Now, no one here can say I caught them off guard... :) > > -- > Tom Rhodes For the most part, this is complete. If anyone notices something I missed, let me know (NOTE: That does not cover things which were explained in both the text and the faq. Nor does it cover obsolete (pre-4.0) options). Thanks, -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue May 20 14:19:05 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7E5DB37B409; Tue, 20 May 2003 14:19:05 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id DF30C43FBD; Tue, 20 May 2003 14:19:04 -0700 (PDT) (envelope-from ceri@FreeBSD.org) Received: from freefall.freebsd.org (ceri@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4KLJ4Up017886; Tue, 20 May 2003 14:19:04 -0700 (PDT) (envelope-from ceri@freefall.freebsd.org) Received: (from ceri@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4KLJ4KJ017882; Tue, 20 May 2003 14:19:04 -0700 (PDT) Date: Tue, 20 May 2003 14:19:04 -0700 (PDT) From: Ceri Davies <ceri@FreeBSD.org> Message-Id: <200305202119.h4KLJ4KJ017882@freefall.freebsd.org> To: simon@nitro.dk, ceri@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/52467: [patch] Add note about manref/command usage to FDP X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 21:19:05 -0000 Synopsis: [patch] Add note about manref/command usage to FDP State-Changed-From-To: open->closed State-Changed-By: ceri State-Changed-When: Tue May 20 14:18:51 PDT 2003 State-Changed-Why: Committed, thanks again. http://www.freebsd.org/cgi/query-pr.cgi?pr=52467 From owner-freebsd-doc@FreeBSD.ORG Tue May 20 14:22:03 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8BF9737B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 14:22:01 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3756443F93 for <doc@FreeBSD.org>; Tue, 20 May 2003 14:22:01 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19IEYa-000NyN-00 for doc@FreeBSD.org; Tue, 20 May 2003 22:22:00 +0100 Date: Tue, 20 May 2003 22:22:00 +0100 From: Ceri Davies <setantae@submonkey.net> To: doc@FreeBSD.org Message-ID: <20030520212200.GA91809@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, doc@FreeBSD.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="u3/rZRmxL6MmkK24" Content-Disposition: inline User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> Subject: Is this correct? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 21:22:03 -0000 --u3/rZRmxL6MmkK24 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable I'm pretty sure that this patch is correct, but not 100%. Comments? Ceri --=20 Index: sgml-markup/chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapt= er.sgml,v retrieving revision 1.54 diff -u -r1.54 chapter.sgml --- sgml-markup/chapter.sgml 20 May 2003 21:18:38 -0000 1.54 +++ sgml-markup/chapter.sgml 20 May 2003 21:20:33 -0000 @@ -674,7 +674,7 @@ =20 <para>Some elements may exist in two forms, <emphasis>formal</emphas= is> and <emphasis>informal</emphasis>. Typically, the formal version of - the element will consist of a title followed by the information + the element will consist of a title followed by the informal version of the element. The informal version will not have a title.</para> </note> --u3/rZRmxL6MmkK24 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+ypx4ocfcwTS3JF8RAogtAJwMWQcLyRcK+N79zA8bg1G7ggn/8gCbB3v8 oUfnNUegKe5amreDeA1MRIQ= =ORhT -----END PGP SIGNATURE----- --u3/rZRmxL6MmkK24-- From owner-freebsd-doc@FreeBSD.ORG Tue May 20 14:27:57 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A9B8437B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 14:27:57 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id EDB0043FB1 for <doc@FreeBSD.org>; Tue, 20 May 2003 14:27:56 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4KLRtuf054078; Tue, 20 May 2003 17:27:56 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 20 May 2003 17:19:39 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Ceri Davies <setantae@submonkey.net> Message-Id: <20030520171939.16786c3c.trhodes@FreeBSD.org> In-Reply-To: <20030520212200.GA91809@submonkey.net> References: <20030520212200.GA91809@submonkey.net> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: Is this correct? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 21:27:58 -0000 On Tue, 20 May 2003 22:22:00 +0100 Ceri Davies <setantae@submonkey.net> wrote: > > I'm pretty sure that this patch is correct, but not 100%. Comments? > > Ceri > -- > > Index: sgml-markup/chapter.sgml > =================================================================== > RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/fdp-primer/sgml-markup/chapter.sgml,v > retrieving revision 1.54 > diff -u -r1.54 chapter.sgml > --- sgml-markup/chapter.sgml 20 May 2003 21:18:38 -0000 1.54 > +++ sgml-markup/chapter.sgml 20 May 2003 21:20:33 -0000 > @@ -674,7 +674,7 @@ > > <para>Some elements may exist in two forms, <emphasis>formal</emphasis> > and <emphasis>informal</emphasis>. Typically, the formal version of > - the element will consist of a title followed by the information > + the element will consist of a title followed by the informal > version of the element. The informal version will not have a > title.</para> > </note> > This, looks correct. Mainly the fact that the next line talks about the 'informal version'. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue May 20 14:36:14 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2CEB037B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 14:36:14 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 481B143FBD for <doc@FreeBSD.org>; Tue, 20 May 2003 14:36:13 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19IEmK-000O3c-00; Tue, 20 May 2003 22:36:12 +0100 Date: Tue, 20 May 2003 22:36:12 +0100 From: Ceri Davies <setantae@submonkey.net> To: "Daniel C. Sobral" <dcs@tcoip.com.br> Message-ID: <20030520213612.GC91809@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, "Daniel C. Sobral" <dcs@tcoip.com.br>, doc@FreeBSD.org References: <3ECA3261.2020307@tcoip.com.br> <20030520142508.GA84344@submonkey.net> <3ECA3CAC.2020507@tcoip.com.br> <20030520151438.GA84668@submonkey.net> <3ECA5B9E.1000006@tcoip.com.br> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="8X7/QrJGcKSMr1RN" Content-Disposition: inline In-Reply-To: <3ECA5B9E.1000006@tcoip.com.br> User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> cc: doc@FreeBSD.org Subject: Re: doc/en_US.ISO8859-1/books/developers-handbook/boot-loader.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 21:36:14 -0000 --8X7/QrJGcKSMr1RN Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, May 20, 2003 at 01:45:18PM -0300, Daniel C. Sobral wrote: > Ceri Davies wrote: > > > >Have a look at it: > > > >$ cvs -QR co -pr1.1 src/sys/boot/common/loader.8 | grep -iB2 smith > >.Nm > >was written by > >.An Michael Smith Aq msmisth@freebsd.org . > > > >OK, there's a typo, but it is him. >=20 > AUTHORS > The loader was written by Michael Smith <msmith@FreeBSD.org>. >=20 > FICL was written by John Sadler <john_sadler@alum.mit.edu>. >=20 > And none of them wrote the loader _man page_. :-) Ah, you are correct, of course (at least based on the evidence provided). Ceri --=20 --8X7/QrJGcKSMr1RN Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yp/MocfcwTS3JF8RAoVbAJ4mu7i1/vst5oHyy5OYJG1LfRRjuACeNJ3V l9MAMDwVST4Krb85cDSC1hc= =srwc -----END PGP SIGNATURE----- --8X7/QrJGcKSMr1RN-- From owner-freebsd-doc@FreeBSD.ORG Tue May 20 14:44:47 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B293237B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 14:44:47 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id DDA5C43FA3 for <doc@FreeBSD.org>; Tue, 20 May 2003 14:44:46 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.12) id 19IEub-000O5P-00 for doc@FreeBSD.org; Tue, 20 May 2003 22:44:45 +0100 Date: Tue, 20 May 2003 22:44:45 +0100 From: Ceri Davies <setantae@submonkey.net> To: doc@FreeBSD.org Message-ID: <20030520214445.GA92534@submonkey.net> Mail-Followup-To: Ceri Davies <setantae@submonkey.net>, doc@FreeBSD.org References: <20030519192255.GB74434@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="2oS5YaxWCcQjTEyO" Content-Disposition: inline In-Reply-To: <20030519192255.GB74434@submonkey.net> User-Agent: Mutt/1.5.4i Sender: Ceri Davies <setantae@submonkey.net> Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 21:44:48 -0000 --2oS5YaxWCcQjTEyO Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, May 19, 2003 at 08:22:55PM +0100, Ceri Davies wrote: >=20 > I've been taking a high level look at getting all the <title> elements in > the handbook ready for the 3rd edition (well, glimpse has been doing all > the hard work so far), and I'm very tempted to religiously wrap all appli= cation > and command names in the appropriate markup. >=20 > Would anyone care to talk me out of it? OK, this thread kicked off really nicely, but nobody answered my question! Ceri --=20 --2oS5YaxWCcQjTEyO Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+yqHNocfcwTS3JF8RAtRNAJ9Y/gbhtLtDSrEoKpm+ozs2KI7GRgCfeAxE XhA4zTmtUCUVPGVrpUCfpPc= =9cRU -----END PGP SIGNATURE----- --2oS5YaxWCcQjTEyO-- From owner-freebsd-doc@FreeBSD.ORG Tue May 20 15:01:08 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id ECE9537B401 for <freebsd-doc@FreeBSD.org>; Tue, 20 May 2003 15:01:08 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id DA4F843F93 for <freebsd-doc@FreeBSD.org>; Tue, 20 May 2003 15:01:07 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4KM16uf054167 for <freebsd-doc@freebsd.org>; Tue, 20 May 2003 18:01:06 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 20 May 2003 17:52:49 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: freebsd-doc@FreeBSD.org Message-Id: <20030520175249.59619318.trhodes@FreeBSD.org> In-Reply-To: <20030520214445.GA92534@submonkey.net> References: <20030519192255.GB74434@submonkey.net> <20030520214445.GA92534@submonkey.net> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 22:01:09 -0000 On Tue, 20 May 2003 22:44:45 +0100 Ceri Davies <setantae@submonkey.net> wrote: > On Mon, May 19, 2003 at 08:22:55PM +0100, Ceri Davies wrote: > > > > I've been taking a high level look at getting all the <title> elements in > > the handbook ready for the 3rd edition (well, glimpse has been doing all > > the hard work so far), and I'm very tempted to religiously wrap all application > > and command names in the appropriate markup. > > > > Would anyone care to talk me out of it? > > OK, this thread kicked off really nicely, but nobody answered my question! > > Ceri > -- > Hey, if you don't step on my toes, I won't step on yours. :) No one tried to stop me when I took the device manual page PR, or the tunables documentation PR. Why should anyone stop you from doing something positive? :) (And don't worry, my toe goes back to normal pretty quickly if someone steps on it). -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue May 20 15:20:07 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0ABB737B425 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 15:20:05 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id EFF3C43FA3 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 15:20:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4KMK3Up023972 for <freebsd-doc@freefall.freebsd.org>; Tue, 20 May 2003 15:20:03 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4KMK33o023971; Tue, 20 May 2003 15:20:03 -0700 (PDT) Resent-Date: Tue, 20 May 2003 15:20:03 -0700 (PDT) Resent-Message-Id: <200305202220.h4KMK33o023971@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, Julien Gabel <jg@thilelli.net> Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BD9F137B401 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 15:19:32 -0700 (PDT) Received: from smtp.thilelli.net (juliengabel.net1.nerim.net [62.212.119.84]) by mx1.FreeBSD.org (Postfix) with ESMTP id 90B5B43F75 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 15:19:31 -0700 (PDT) (envelope-from jgabel@thilelli.net) Received: from titeuf.thilelli.net (titeuf.thilelli.net [192.168.0.97]) by bento.thilelli.net (Postfix) with ESMTP id C4923241C4 for <FreeBSD-gnats-submit@freebsd.org>; Wed, 21 May 2003 00:19:29 +0200 (CEST) Received: by titeuf.thilelli.net (Postfix, from userid 1001) id A5EE33BE; Wed, 21 May 2003 00:19:29 +0200 (CEST) Message-Id: <20030520221929.A5EE33BE@titeuf.thilelli.net> Date: Wed, 21 May 2003 00:19:29 +0200 (CEST) From: Julien Gabel <jg@thilelli.net> To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/52500: [PATCH] Unreferenced web link still exists in the 'Backup Basics' chapter of the handbook. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Julien Gabel <jg@thilelli.net> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 22:20:08 -0000 >Number: 52500 >Category: docs >Synopsis: [PATCH] Unreferenced web link still exists in the 'Backup Basics' chapter of the handbook. >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: Tue May 20 15:20:03 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Julien Gabel >Release: FreeBSD 4.8-RELEASE i386 >Organization: >Environment: System: FreeBSD titeuf.thilelli.net 4.8-RELEASE FreeBSD 4.8-RELEASE #0: Tue Apr 29 22:22:00 CEST 2003 root@titeuf.thilelli.net:/usr/obj/usr/src/sys/TITEUF i386 >Description: The html link "torture-testing Backup and Archive Programs" from section '12.9.7' of the backup chapter of the handbook is no longer a valid url since reality.sgi.com no longer exists. >How-To-Repeat: Read the backup chapter of the handbook, and then try using this link. >Fix: I found two new links for the correct page. I propose two patches, because i don't know which is better than the other. PATCH #1: --- chapter.sgml Wed May 21 00:03:03 2003 +++ chapter.sgml.PR1 Wed May 21 00:04:42 2003 @@ -1857,7 +1857,7 @@ size during the backup, files that are created/deleted during the backup and more. She presented the results at LISA V in Oct. 1991. See <ulink - url="http://reality.sgi.com/zwicky_neu/testdump.doc.html">torture-testing + url="http://berdmann.dyndns.org/zwicky/testdump.doc.html">torture-testing Backup and Archive Programs</ulink>.</para> </sect2> PATCH #2: --- chapter.sgml Wed May 21 00:03:03 2003 +++ chapter.sgml.PR2 Wed May 21 00:05:07 2003 @@ -1857,7 +1857,7 @@ size during the backup, files that are created/deleted during the backup and more. She presented the results at LISA V in Oct. 1991. See <ulink - url="http://reality.sgi.com/zwicky_neu/testdump.doc.html">torture-testing + url="http://ftp.at.linuxfromscratch.org/utils/archivers/star/testscripts/zwicky/testdump.doc.html">torture-testing Backup and Archive Programs</ulink>.</para> </sect2> >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue May 20 15:30:14 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 230C537B401 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 15:30:14 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 366FD43FBD for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 15:30:13 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4KMUDUp024296 for <freebsd-doc@freefall.freebsd.org>; Tue, 20 May 2003 15:30:13 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4KMUD2e024295; Tue, 20 May 2003 15:30:13 -0700 (PDT) Resent-Date: Tue, 20 May 2003 15:30:13 -0700 (PDT) Resent-Message-Id: <200305202230.h4KMUD2e024295@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, "Simon L.Nielsen" <simon@nitro.dk> Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6619C37B401 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 15:27:32 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5B12543FDD for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 15:27:30 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 896DF10BF84; Wed, 21 May 2003 00:27:29 +0200 (CEST) Message-Id: <20030520222729.896DF10BF84@arthur.nitro.dk> Date: Wed, 21 May 2003 00:27:29 +0200 (CEST) From: "Simon L.Nielsen" <simon@nitro.dk> To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/52501: [patch] Order development(7) SEE ALSO acording to mdoc(7) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L.Nielsen" <simon@nitro.dk> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 22:30:14 -0000 >Number: 52501 >Category: docs >Synopsis: [patch] Order development(7) SEE ALSO acording to mdoc(7) >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: Tue May 20 15:30:12 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Simon L. Nielsen >Release: FreeBSD 4.8-STABLE i386 >Organization: >Environment: >Description: The order of the items in the SEE ALSO section of development(7) is not the same as recomended in mdoc(7). >How-To-Repeat: >Fix: Reorder first by section, then alphabetically. --- man-development7-SA-order.patch begins here --- Index: development.7 =================================================================== RCS file: /home/ncvs/src/share/man/man7/development.7,v retrieving revision 1.4 diff -u -d -r1.4 development.7 --- development.7 28 Dec 2002 19:08:11 -0000 1.4 +++ development.7 21 May 2003 00:19:33 -0000 @@ -412,12 +412,12 @@ a good time. My recommendation is to only keep the cvs repository synchronized via cron. .Sh SEE ALSO -.Xr build 7 , .Xr crontab 1 , .Xr crontab 5 , -.Xr diskless 8 , +.Xr build 7 , .Xr firewall 7 , -.Xr tuning 7 +.Xr tuning 7 , +.Xr diskless 8 .Sh HISTORY The .Nm --- man-development7-SA-order.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue May 20 16:27:15 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9495937B401; Tue, 20 May 2003 16:27:15 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2F78C43F3F; Tue, 20 May 2003 16:27:15 -0700 (PDT) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (brueffer@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4KNRFUp029655; Tue, 20 May 2003 16:27:15 -0700 (PDT) (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4KNRF6m029651; Wed, 21 May 2003 01:27:15 +0200 (CEST) Date: Wed, 21 May 2003 01:27:15 +0200 (CEST) From: Christian Brueffer <brueffer@FreeBSD.org> Message-Id: <200305202327.h4KNRF6m029651@freefall.freebsd.org> To: simon@nitro.dk, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org, brueffer@FreeBSD.org Subject: Re: docs/52501: [patch] Order development(7) SEE ALSO acording to mdoc(7) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 23:27:15 -0000 Synopsis: [patch] Order development(7) SEE ALSO acording to mdoc(7) State-Changed-From-To: open->patched State-Changed-By: brueffer State-Changed-When: Wed May 21 01:26:08 CEST 2003 State-Changed-Why: Committed to -current, thanks! Responsible-Changed-From-To: freebsd-doc->brueffer Responsible-Changed-By: brueffer Responsible-Changed-When: Wed May 21 01:26:08 CEST 2003 Responsible-Changed-Why: I'll handle the MFC http://www.freebsd.org/cgi/query-pr.cgi?pr=52501 From owner-freebsd-doc@FreeBSD.ORG Tue May 20 16:46:53 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 34B4B37B43D; Tue, 20 May 2003 16:46:52 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6A81543F3F; Tue, 20 May 2003 16:46:52 -0700 (PDT) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (brueffer@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4KNkqUp030241; Tue, 20 May 2003 16:46:52 -0700 (PDT) (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4KNkp6u030237; Wed, 21 May 2003 01:46:51 +0200 (CEST) Date: Wed, 21 May 2003 01:46:51 +0200 (CEST) From: Christian Brueffer <brueffer@FreeBSD.org> Message-Id: <200305202346.h4KNkp6u030237@freefall.freebsd.org> To: jg@thilelli.net, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/52500: [PATCH] Unreferenced web link still exists in the 'Backup Basics' chapter of the handbook. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 20 May 2003 23:46:53 -0000 Synopsis: [PATCH] Unreferenced web link still exists in the 'Backup Basics' chapter of the handbook. State-Changed-From-To: open->closed State-Changed-By: brueffer State-Changed-When: Wed May 21 01:46:33 CEST 2003 State-Changed-Why: Committed, thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=52500 From owner-freebsd-doc@FreeBSD.ORG Tue May 20 21:28:01 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3ED2637B401; Tue, 20 May 2003 21:28:01 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id AE0F743FB1; Tue, 20 May 2003 21:28:00 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4L4S0HZ062903; Tue, 20 May 2003 21:28:00 -0700 (PDT) (envelope-from murray) Date: Tue, 20 May 2003 21:28:00 -0700 From: Murray Stokely <murray@FreeBSD.org> To: Tom Rhodes <trhodes@FreeBSD.org> Message-ID: <20030520212800.U8403@freebsdmall.com> References: <200305210121.h4L1LfLI066670@repoman.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <200305210121.h4L1LfLI066670@repoman.freebsd.org>; from trhodes@FreeBSD.org on Tue, May 20, 2003 at 06:21:41PM -0700 X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: freebsd-doc@FreeBSD.org Subject: Re: cvs commit: www/en/docproj handbook3.sgml X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Wed, 21 May 2003 04:28:01 -0000 On Tue, May 20, 2003 at 06:21:41PM -0700, Tom Rhodes wrote: > Log: > The cron(8) documentation task is complete. Ok, I think this section would be clearer if you maybe start with a simpler example than the system crontab file. There is a lot of junk in there (/etc/crontab) and I think it is confusing. Maybe if you just examine one line at a time. Maybe list one line, then talk about it (with a callout list to point to each field), then list another line, showing off a different aspect of cron's functionality, and then talk about that example line. See the ppp chapter for an example of a callout list describing the fields in a text file (/etc/ttys). I just don't think we need to list the whole crontab file. (and of course, someone will submit a PR the moment that /etc/crontab gets updated reminding us to update this chapter!) Also, I think you should just tell new users to edit their own crontab file with 'crontab -e'. This invokes the editor and I think is easier than telling them to create a file then install that file. crontab -e is one less step and makes it easier for new users. Thanks for writing this. We've needed a crontab section for a long time! - Murray From owner-freebsd-doc@FreeBSD.ORG Tue May 20 23:27:25 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6174937B401 for <doc@FreeBSD.org>; Tue, 20 May 2003 23:27:25 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id C326D43F93 for <doc@FreeBSD.org>; Tue, 20 May 2003 23:27:24 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4L6RNnH063741; Tue, 20 May 2003 23:27:23 -0700 (PDT) (envelope-from murray) Date: Tue, 20 May 2003 23:27:23 -0700 From: Murray Stokely <murray@FreeBSD.org> To: Ceri Davies <setantae@submonkey.net>, doc@FreeBSD.org Message-ID: <20030520232723.C8403@freebsdmall.com> References: <20030519192255.GB74434@submonkey.net> <20030520214445.GA92534@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="6TrnltStXW4iwmi0" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20030520214445.GA92534@submonkey.net>; from setantae@submonkey.net on Tue, May 20, 2003 at 10:44:45PM +0100 X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: Re: Application and command names in <title> elements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Wed, 21 May 2003 06:27:25 -0000 --6TrnltStXW4iwmi0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On Tue, May 20, 2003 at 10:44:45PM +0100, Ceri Davies wrote: > On Mon, May 19, 2003 at 08:22:55PM +0100, Ceri Davies wrote: > > I've been taking a high level look at getting all the <title> elements in > > the handbook ready for the 3rd edition (well, glimpse has been doing all > > the hard work so far), and I'm very tempted to religiously wrap all application > > and command names in the appropriate markup. I think that is a good idea. We talked of doing this during the 2nd edition work but I'm not sure if we never got around to it, or if we made a sweep but now things have slowly drifted back or what. In any case, it's a good thing from a high level perspective because "super XML-tools and search engines yet to be written" can give better results with more descriptive title names. As long as it's not a big aesthetic step backwards in the mean time, I'm all for it. And even if it is a big aesthetic step backwards, we can easily ignore the offending tags when enclosed in <title> via freebsd.dsl. - Murray --6TrnltStXW4iwmi0 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- iD8DBQE+yxxLtNcQog5FH30RAiepAJ9TjSmYSA8fr2hVnDWI88kDsNKVoACfc+vZ dI2X/42D3gTtp6DMZkUbPlU= =AcJM -----END PGP SIGNATURE----- --6TrnltStXW4iwmi0-- From owner-freebsd-doc@FreeBSD.ORG Tue May 20 23:30:02 2003 Return-Path: <owner-freebsd-doc@FreeBSD.ORG> Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EC79937B401 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 23:30:02 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 698C843F93 for <freebsd-doc@hub.freebsd.org>; Tue, 20 May 2003 23:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4L6U1Up069065 for <freebsd-doc@freefall.freebsd.org>; Tue, 20 May 2003 23:30:01 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4L6U1lo069064; Tue, 20 May 2003 23:30:01 -0700 (PDT) Resent-Date: Tue, 20 May 2003 23:30:01 -0700 (PDT) Resent-Message-Id: <200305210630.h4L6U1lo069064@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, Pav Lucistnik <pav@oook.cz> Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3336737B401 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 23:25:32 -0700 (PDT) Received: from hood.oook.cz (hood.oook.cz [195.122.218.35]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1C2D743F75 for <FreeBSD-gnats-submit@freebsd.org>; Tue, 20 May 2003 23:25:20 -0700 (PDT) (envelope-from pav@oook.cz) Received: from pav.oook.cz (localhost.oook.cz [127.0.0.1]) by hood.oook.cz (8.12.9/8.12.9) with ESMTP id h4L6PBi1006235 for <FreeBSD-gnats-submit@freebsd.org>; Wed, 21 May 2003 08:25:11 +0200 (CEST) (envelope-from pav@pav.oook.cz) Received: (from pav@localhost) by pav.oook.cz (8.12.9/8.12.9/Submit) id h4L6PBQk006234; Wed, 21 May 2003 08:25:11 +0200 (CEST) Message-Id: <200305210625.h4L6PBQk006234@pav.oook.cz> Date: Wed, 21 May 2003 08:25:11 +0200 (CEST) From: Pav Lucistnik <pav@oook.cz> To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/52514: Handbook: new chapter about Bluetooth X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Pav Lucistnik <pav@oook.cz> List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Wed, 21 May 2003 06:30:03 -0000 >Number: 52514 >Category: docs >Synopsis: Handbook: new chapter about Bluetooth >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: Tue May 20 23:30:00 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Pav Lucistnik >Release: FreeBSD 5.1-BETA i386 >Organization: >Environment: System: FreeBSD pav.oook.cz 5.1-BETA FreeBSD 5.1-BETA #1: Tue May 20 21:30:57 CEST 2003 root@pav.oook.cz:/usr/obj/usr/src/sys/PAV i386 >Description: This is new chapter for Handbook, covering usage of The Bluetooth stack on coming 5.1-RELEASE. It's based on my Bluetooth on FreeBSD webpage. It was reviewed and approved by Maksim Yevmenkin, author of Bluetooth code. Then it was review by Christian Brueffer (brueffer@). We'd like to get a review by at least one docproj elder before brueffer commits it. Another question is where this should go. brueffer@ suggests after Wireless Networking chapter, I suggest putting it after IPv6 as a last chapter of Advanced networking. Apply to /usr/doc/en_US.ISO8859-1/books/handbook/advanced-networking >How-To-Repeat: >Fix: --- chapter.sgml.orig Tue May 20 21:11:44 2003 +++ chapter.sgml Tue May 20 23:15:03 2003 @@ -6687,6 +6687,388 @@ support AAAA records.</para> </sect2> </sect1> + + <sect1 id="network-bluetooth"> + <sect1info> + <authorgroup> + <author> + <firstname>Pav</firstname> + <surname>Lucistnik</surname> + <contrib>Written by </contrib> + <affiliation> + <address><email>pav@oook.cz</email></address> + </affiliation> + </author> + </authorgroup> + </sect1info> + <title>Bluetooth + + + Introduction + Bluetooth is a wireless technology for creating personal networks + operating in the 2.4 GHz unlicensed band, with a range of 10 meters. + Networks are usually formed ad-hoc from portable devices like mobile + phones, handhelds and laptops. Unlike the other popular wireless + technology, Wi-Fi, Bluetooth offers higher level service profiles, + e.g. FTP-like file servers, file pushing, voice transport, serial + line emulation and more. + + The Bluetooth stack in FreeBSD is implemented using Netgraph. + A Broad variety of USB dongles is supported by the &man.ng.ubt.4; driver. + The 3Com PC Card 3CRWB60-A is supported by the &man.ng.bt3c.4; driver. + Serial and UART based Bluetooth devices are supported via + &man.ng.h4.4; and &man.hcseriald.8;. This chapter describes using + a USB Bluetooth dongle. Bluetooth support is available only on + FreeBSD 5.0 and newer systems. + + + + Plugging in the Device + Device drivers are by default available as kernel modules. + Before attaching a device, you need to load the driver into the + kernel: + + &prompt.root; kldload ng_ubt + + If the Bluetooth device is present in the system during system + startup, load the module from /boot/loader.conf: + + ng_ubt_load="YES" + + Plug in your USB dongle. Similar output will appear on the console + (or in syslog): + + ubt0: vendor 0x0a12 product 0x0001, rev 1.10/5.25, addr 2 +ubt0: Interface 0 endpoints: interrupt=0x81, bulk-in=0x82, bulk-out=0x2 +ubt0: Interface 1 (alt.config 5) endpoints: isoc-in=0x83, isoc-out=0x3; + wMaxPacketSize=49; nframes=6, buffer size=294 + + Copy /usr/src/share/examples/netgraph/bluetooth/rc.bluetooth + to some convenient place, like /etc/rc.bluetooth. + This script is used to start and stop the Bluetooth stack. It is a good idea + to stop the stack before unplugging the device, but it is not (usually) + fatal. When starting the stack, you will receive output similar to this: + + &prompt.root; /etc/rc.bluetooth start ubt0 +BD_ADDR: 00:02:72:00:d4:1a +Features: 0xff 0xff 0xf 00 00 00 00 00 +<3-Slot> <5-Slot> <Encryption> <Slot offset> +<Timing accuracy> <Switch> <Hold mode> <Sniff mode> +<Park mode> <RSSI> <Channel quality> <SCO link> +<HV2 packets> <HV3 packets> <u-law log> <A-law log> <CVSD> +<Paging scheme> <Power control> <Transparent SCO data> +Max. ACL packet size: 192 bytes +Number of ACL packets: 8 +Max. SCO packet size: 64 bytes +Number of SCO packets: 8 + + + + + HCI and Inquiry + + Now it is time to discover some nearby bluetooth devices. + Discovering devices and many other interesting tasks is done with + the &man.hccontrol.8; utility. You will receive a list of discoverable + devices in a few seconds: + + &prompt.user; hccontrol -n ubt0hci inquiry +Inquiry result, num_responses=1 +Inquiry result #0 + BD_ADDR: 00:80:37:29:19:a4 + Page Scan Rep. Mode: 0x1 + Page Scan Period Mode: 00 + Page Scan Mode: 00 + Class: 52:02:04 + Clock offset: 0x78ef +Inquiry complete. Status: No error [00] + + BD_ADDR is the unique address of a bluetooth device, similar to MAC + addresses of network cards. This address is needed for further + communication with a device. Let us try to read the device's name: + + &prompt.user; hccontrol -n ubt0hci remote_name_request 00:80:37:29:19:a4 0 0 0 +BD_ADDR: 00:80:37:29:19:a4 +Name: Pav's T39 + + If you perform a discovery on a different bluetooth device, it will find + your computer as your.host.name (ubt0). + + You can list active baseband connections: + + &prompt.user; hccontrol -n ubt0hci read_connection_list +Remote BD_ADDR Handle Type Mode Role Encrypt Pending Queue State +00:80:37:29:19:a4 41 ACL 0 MAST NONE 0 0 OPEN + + Handle is useful for manually disconnecting a connection: + + &prompt.root; hccontrol -n ubt0hci disconnect 41 +Connection handle: 41 +Reason: Connection terminated by local host [0x16] + + Refer to hccontrol help for a complete listing of + available commands. Note that the majority of commands does not require + superuser privileges. + + + + + L2CAP + + L2CAP is a higher level of connection in Bluetooth standards. + A useful command is &man.l2ping.8;, which can be used to ping + other devices. Some devices might not return all of the data + send to them, so 0 bytes as in this example + is a normal state. + + &prompt.root; l2ping -a 00:80:37:29:19:a4 +0 bytes from 0:80:37:29:19:a4 seq_no=0 time=48.633 ms result=0 +0 bytes from 0:80:37:29:19:a4 seq_no=1 time=37.551 ms result=0 +0 bytes from 0:80:37:29:19:a4 seq_no=2 time=28.324 ms result=0 +0 bytes from 0:80:37:29:19:a4 seq_no=3 time=46.150 ms result=0 + + The &man.l2control.8; utility is used to configure L2CAP nodes + and read their state. This example shows file transfer to a Palm + handheld: + + &prompt.user; l2control -a 00:02:72:00:d4:1a read_channel_list +L2CAP channels: +Remote BD_ADDR SCID/ DCID PSM IMTU/ OMTU State +00:07:e0:00:0b:ca 66/ 64 3 132/ 672 OPEN +&prompt.user; l2control -a 00:02:72:00:d4:1a read_connection_list +L2CAP connections: +Remote BD_ADDR Handle Flags Pending State +00:07:e0:00:0b:ca 41 O 0 OPEN + + Another diagnostic tool is &man.btsockstat.1;. It does a similar + job as &man.netstat.1; does, but for Bluetooth sockets, logical + connections on top of baseband connections. The example output shows + the same connection as l2control above: + + &prompt.user; btsockstat +Active L2CAP sockets +PCB Recv-Q Send-Q Local address/PSM Foreign address CID State +c2afe900 0 0 00:02:72:00:d4:1a/3 00:07:e0:00:0b:ca 66 OPEN +Active RFCOMM sessions +L2PCB PCB Flag MTU Out-Q DLCs State +c2afe900 c2b53380 1 127 0 Yes OPEN +Active RFCOMM sockets +PCB Recv-Q Send-Q Local address Foreign address Chan DLCI State +c2e8bc80 0 250 00:02:72:00:d4:1a 00:07:e0:00:0b:ca 3 6 OPEN + + + + + Pairing of Devices + + By default, Bluetooth communication is not authorized and any device + can talk to any other device. Some devices, like mobile phones, require + authentication for some functionality, like Internet connections. This + is done with PIN numbers - you enter the same (up to 16 digits long) + number on both devices. This operation is called pairing. + The daemon that answers pairing requests is &man.hcsecd.8;. Copy + /usr/src/usr.sbin/bluetooth/hcsecd/hcsecd.conf + to /usr/local/etc and edit it. The following is an + example section for a mobile phone, with the PIN arbitrarily set to 1234: + + device { + bdaddr 00:80:37:29:19:a4; + name "Pav's T39"; + key nokey; + pin "1234"; +} + + You can choose any PIN you like. Note that some devices, like + headsets, have a fixed PIN built in. Start hcsecd -d. + The switch forces the daemon to stay in the + terminal and not fork to the background, so we can see what is happening. + Set the remote device to receive pairing and initiate the HCI connection + to the remote device. The remote device should say that pairing was + accepted, and let you enter the PIN. Enter the same PIN as you have in your + hcsecd.conf. Now your PC and remote device are paired. + Alternatively, you can initiate pairing on the remote device. + This will appear in the hcsecd output: + +hcsecd[16484]: Got Link_Key_Request event from 'ubt0hci', remote bdaddr 0:80:37:29:19:a4 +hcsecd[16484]: Found matching entry, remote bdaddr 0:80:37:29:19:a4, name 'Pav's T39', link key doesn't exist +hcsecd[16484]: Sending Link_Key_Negative_Reply to 'ubt0hci' for remote bdaddr 0:80:37:29:19:a4 +hcsecd[16484]: Got PIN_Code_Request event from 'ubt0hci', remote bdaddr 0:80:37:29:19:a4 +hcsecd[16484]: Found matching entry, remote bdaddr 0:80:37:29:19:a4, name 'Pav's T39', PIN code exists +hcsecd[16484]: Sending PIN_Code_Reply to 'ubt0hci' for remote bdaddr 0:80:37:29:19:a4 + + + + + Service Discovery Protocol (SDP) + If you want to know which services a Bluetooth device offers, and + on which RFCOMM channels, build libbluetooth + and sdp-1.0rc3 from Maksim Evmenkin's + snapshot. Then, run sdptool and + observe (the output is snipped a bit, as this tool is quite talky): + + &prompt.root; sdptool browse 00:80:37:29:19:a4 +Browsing 00:80:37:29:19:A4 ... +Service Name: Dial-up Networking +Protocol Descriptor List: + "L2CAP" (0x0100) + "RFCOMM" (0x0003) + Channel: 1 + +Service Name: Fax +Protocol Descriptor List: + "L2CAP" (0x0100) + "RFCOMM" (0x0003) + Channel: 2 + +Service Name: Voice gateway +Service Class ID List: + "Headset Audio Gateway" (0x1112) + "Generic Audio" (0x1203) +Protocol Descriptor List: + "L2CAP" (0x0100) + "RFCOMM" (0x0003) + Channel: 3 + + + ... and so on. You will need the channel number later for using + a given service. Some devices do not support browsing, they return + an empty list, but you can try searching for a specific service. + + &prompt.root; sdptool search --bdaddr 00:07:e0:00:0b:ca OPUSH + + Offering services on FreeBSD to other devices is done using the + sdpd server. + &prompt.root; sdpd + + Registering a given Bluetooth service to a RFCOMM channel number: + &prompt.root; sdptool add --channel=7 LAN + + Checking services offered by our computer: + &prompt.root; sdptool browse ff:ff:ff:00:00:00 + + + + Dial-up Networking (DUN) and Local Area Network (LAN) + + Bluetooth can be used for connecting to the Internet, either over + PPP (mobile phones) or the local network (access points). The Dial-up Networking + profile on FreeBSD is implemented with &man.ppp.8; and + &man.rfcomm.pppd.8;, a wrapper that converts RFCOMM Bluetooth connections + to something ppp can operate with. Create ppp labels in + /etc/ppp/ppp.conf, examples from the &man.rfcomm.pppd.8; + manual page can be used. + + Connecting to the Internet through a mobile phone (DUN profile). First, find + out the correct RFCOMM channel on the remote device using + sdptool. Then, use &man.rfcomm.pppd.8;: + + &prompt.root; rfcomm_pppd -a 00:80:37:29:19:a4 -c -C 1 -l rfcomm-dialup + + Running a Bluetooth access point on FreeBSD. First, register a + RFCOMM channel for LAN service on the local sdpd. + Then, start the ppp server. Use BD_ADDR of the local Bluetooth device and + the channel number registered with sdpd. + + &prompt.root; rfcomm_pppd -a 00:02:72:00:d4:1a -s -C 7 -l rfcomm-server + + + + + OBEX Push (OPUSH) + OBEX is a widely used protocol for simple file transfers between + mobile devices. It's main use is in infrared communication, where it is + used for generic file transfers between notebooks or Palm handhelds, + and for sending business cards or calendar entries between mobile + phones and other devices with PIM applications. + + The OBEX client is implemented in the + obexapp utility from Maksim Evmenkin's + snapshot. It needs the openobex + library from same package and the + devel/glib12 port. Note that + obexapp does not require root privileges + to operate. + + OBEX client. First, find which channel on the remote device is IrMC + Synchronization or OBEX Object Push. After that, use + obexapp. Here is an example session where + we download a file (device info from a mobile phone) and send + a file (business card to the phone's directory): + + &prompt.user; obexapp -a 00:80:37:29:19:a4 -C 10 +obex> get +get: remote file> telecom/devinfo.txt +get: local file> devinfo-t39.txt +Success, response: OK, Success (0x20) +obex> put +put: local file> new.vcf +put: remote file> new.vcf +Success, response: OK, Success (0x20) +obex> di +Success, response: OK, Success (0x20) + + OBEX server. First, register the OPUSH service with the local + sdpd. If OPUSH does not work, + you can try the FTRN service instead. Then, start the OBEX daemon + using the channel number registered with sdpd: + + &prompt.root; obexapp -s -C 10 + + Received files will appear in /var/spool/obex. + This can be overriden with the switch. Make sure + the directory exists, obexapp will not + create it. On a typical workstation with a single user it is useful + to set a default owner of received files. See obexapp(1) + for details. + + + + + Serial Port Profile (SP) + Bluetooth can be used to emulate serial port connections. + To connect to a remote device, first locate the RFCOMM channel with the + Serial Port profile. Then, start the Serial Port Profile Daemon + &man.rfcomm.sppd.1; with a free pseudo tty: + + &prompt.root; rfcomm_sppd -a 00:07:E0:00:0B:CA -c 1 -t /dev/ttyp6 +rfcomm_sppd[94692]: Starting on /dev/ttyp6... + + Now connect this pseudo tty to your actual terminal: + + &prompt.root; cu -l ttyp6 + + + + + Troubleshooting + + + A remote device cannot connect to us + Some older devices do not support role switching. By default, + when FreeBSD is accepting a connection, it tries to switch roles + to become a master. Devices which do not support this will not + be able to connect. Role switching is performed when a connection + is being established, so we cannot ask the remote device if it does + support role switching. There is a driver option to disable role + switching on our side: + &prompt.root; hccontrol -n ubt0hci write_node_role_switch 0 + + + + Something is going wrong, can I see what exactly is happening? + Yes, you can. Use the hcidump tool + from Maksim Evmenkin's + snapshot, which works much like &man.tcpdump.1;. You can + use it to display the content of Bluetooth packets on the terminal + and to record Bluetooth communication for later analyzation. + + + + + + + + + + --- doc-danish-navilinks.patch ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed May 21 23:43:46 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9BAE937B419; Wed, 21 May 2003 23:43:45 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2D89443F3F; Wed, 21 May 2003 23:43:45 -0700 (PDT) (envelope-from brueffer@FreeBSD.org) Received: from freefall.freebsd.org (brueffer@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4M6hjUp008751; Wed, 21 May 2003 23:43:45 -0700 (PDT) (envelope-from brueffer@freefall.freebsd.org) Received: (from brueffer@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4M6hjPK008747; Thu, 22 May 2003 08:43:45 +0200 (CEST) Date: Thu, 22 May 2003 08:43:45 +0200 (CEST) From: Christian Brueffer Message-Id: <200305220643.h4M6hjPK008747@freefall.freebsd.org> To: arved@freebsd.org, brueffer@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/52543: bug in diskless operation chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 06:43:47 -0000 Synopsis: bug in diskless operation chapter State-Changed-From-To: open->closed State-Changed-By: brueffer State-Changed-When: Thu May 22 08:43:24 CEST 2003 State-Changed-Why: Committed, thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=52543 From owner-freebsd-doc@FreeBSD.ORG Thu May 22 01:15:06 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8099437B401; Thu, 22 May 2003 01:15:06 -0700 (PDT) Received: from camel.jerocu.net (camel.jerocu.net [213.129.160.132]) by mx1.FreeBSD.org (Postfix) with ESMTP id AFCE143FAF; Thu, 22 May 2003 01:15:04 -0700 (PDT) (envelope-from jesusr@endercom.com) Received: from localhost (localhost [127.0.0.1]) by camel.jerocu.net (8.12.9/8.12.9) with ESMTP id h4M8Amrl015763; Thu, 22 May 2003 10:11:28 +0200 (CEST) (envelope-from jesusr@endercom.com) Date: Thu, 22 May 2003 10:10:48 +0200 (CEST) From: Jesus Rodriguez X-X-Sender: jesusr@camel To: Hiroki Sato In-Reply-To: <20030522.064547.112628124.hrs@eos.ocn.ne.jp> Message-ID: <20030522100557.W15569@camel> References: <20030521165628.39bdfaf5.trhodes@FreeBSD.org> <20030522.064547.112628124.hrs@eos.ocn.ne.jp> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: trhodes@freebsd.org cc: FreeBSD-doc@freebsd.org Subject: Re: Error in Spanish translation files. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 08:15:06 -0000 On Thu, 22 May 2003, Hiroki Sato wrote: > Tom Rhodes wrote > in <20030521165628.39bdfaf5.trhodes@FreeBSD.org>: > > trhodes> /bin/cat /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/misc/docbook.css > docbook.css > trhodes> /usr/local/bin/jade -V html-manifest -ioutput.html -d /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/default.dsl -V %generate-legalnotice-link% -V %generate-docformat-navi-link% -ioutput.html.images -D /usr/obj/usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq -c /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../es_ES.ISO8859-1/share/sgml/catalog -c /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/iso8879/catalog -c /usr/local/share/sgml/docbook/catalog -c /usr/local/share/sgml/jade/catalog -t sgml /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/book.sgml > trhodes> /usr/local/bin/jade:/usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/freebsd.dsl:190:31:E: missing argument for function call > trhodes> /usr/local/bin/tidy -i -m -raw -preserve -f /dev/null -asxml $(/usr/bin/xargs < HTML.manifest) > > This error is due to the old definition of ($create-refentry-xref-link$) in > es_ES.ISO8859-1/share/sgml/freebsd.dsl. Merging the changes in the > latest English version solves it, but the function should be defined in > share/sgml/freebsd.dsl instead of en_US.ISO8859-1/share/sgml/freebsd.dsl > to avoid such situation. > > It can be solved using the patch I previously posted on -doc > (<20030426.235434.116360718.hrs@eos.ocn.ne.jp>) and jesusr@ > already gave to me to the commit approval. Although I think > I will merge that after 5.1R is released, I will take care soon > including fixes for the other languages by reason of the feedback timeout. Hi Hiroki, Thanks for your answer. Go ahead with the commit when you think is the right time. Thanks!. Saludos JesusR. ------------------------------- Jesus Rodriguez Endercom Comunicaciones, S.L. jesusr@endercom.com http://www.endercom.com Tel. +34 934424293 ------------------------------- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 03:41:18 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id ABD7137B401; Thu, 22 May 2003 03:41:18 -0700 (PDT) Received: from terpsi.otenet.gr (terpsi.otenet.gr [195.170.0.9]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1445543F85; Thu, 22 May 2003 03:40:49 -0700 (PDT) (envelope-from keramida@FreeBSD.org) Received: from gothmog.gr (patr530-a170.otenet.gr [212.205.215.170]) by terpsi.otenet.gr (8.12.9/8.12.9) with ESMTP id h4MAeVeq011282; Thu, 22 May 2003 13:40:45 +0300 (EEST) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.9/8.12.9) with ESMTP id h4LLf8cr009049; Thu, 22 May 2003 00:41:08 +0300 (EEST) (envelope-from keramida@FreeBSD.org) Received: (from giorgos@localhost) by gothmog.gr (8.12.9/8.12.9/Submit) id h4LLf8tB009048; Thu, 22 May 2003 00:41:08 +0300 (EEST) (envelope-from keramida@FreeBSD.org) Date: Thu, 22 May 2003 00:41:08 +0300 From: Giorgos Keramidas To: Tom Rhodes , Jesus Rodriguez Message-ID: <20030521214108.GA8632@gothmog.gr> References: <20030521165628.39bdfaf5.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030521165628.39bdfaf5.trhodes@FreeBSD.org> cc: FreeBSD-doc@FreeBSD.org Subject: Re: Error in Spanish translation files. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 10:41:19 -0000 On 2003-05-21 16:56, Tom Rhodes wrote: > While testing Simon's recently submitted doc patch, I obtained this > error. Could a Spanish translator (jesusr) look into this please? > > Note: This is a full build, not a make lint. > > /bin/cat /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/misc/docbook.css > docbook.css > /usr/local/bin/jade -V html-manifest -ioutput.html -d /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/default.dsl -V %generate-legalnotice-link% -V %generate-docformat-navi-link% -ioutput.html.images -D /usr/obj/usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq -c /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../es_ES.ISO8859-1/share/sgml/catalog -c /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/iso8879/catalog -c /usr/local/share/sgml/docbook/catalog -c /usr/local/share/sgml/jade/catalog -t sgml /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/book.sgml > /usr/local/bin/jade:/usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/freebsd.dsl:190:31:E: missing argument for function call > /usr/local/bin/tidy -i -m -raw -preserve -f /dev/null -asxml $(/usr/bin/xargs < HTML.manifest) The DSSSL function that generates the manpage links has changed in the English docs. It now takes an *optional* argument, instead of a mandatory argument. The following diff synchronizes the Spanish version of freebsd.dsl with the current state of the English one... and fixes the build, of course. Can you, Tom, or Jesus take care of this? --- patch starts here --- Index: es_ES.ISO8859-1/share/sgml/freebsd.dsl =================================================================== RCS file: /home/ncvs/doc/es_ES.ISO8859-1/share/sgml/freebsd.dsl,v retrieving revision 1.8 diff -u -r1.8 freebsd.dsl --- es_ES.ISO8859-1/share/sgml/freebsd.dsl 3 Nov 2002 12:48:18 -0000 1.8 +++ es_ES.ISO8859-1/share/sgml/freebsd.dsl 21 May 2003 21:32:40 -0000 @@ -53,9 +58,19 @@ (define %refentry-xref-link% #t) - (define ($create-refentry-xref-link$ refentrytitle manvolnum) - (string-append "http://www.FreeBSD.org/cgi/man.cgi?query=" - refentrytitle "&" "sektion=" manvolnum)) + (define ($create-refentry-xref-link$ #!optional (n (current-node))) + (let* ((r (select-elements (children n) (normalize "refentrytitle"))) + (m (select-elements (children n) (normalize "manvolnum"))) + (v (attribute-string (normalize "vendor") n)) + (u (string-append "http://www.FreeBSD.org/cgi/man.cgi?query=" + (data r) "&" "sektion=" (data m)))) + (case v + (("current") (string-append u "&" "manpath=FreeBSD+5.0-current")) + (("xfree86") (string-append u "&" "manpath=XFree86+4.3.0")) + (("netbsd") (string-append u "&" "manpath=NetBSD+1.6.1")) + (("ports") (string-append u "&" "manpath=FreeBSD+Ports")) + (else u)))) + ]]> --- patch ends here --- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 04:00:28 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6B93D37B401 for ; Thu, 22 May 2003 04:00:28 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5518243F93 for ; Thu, 22 May 2003 04:00:27 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4MB0RUp033167 for ; Thu, 22 May 2003 04:00:27 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4MB0R6S033158; Thu, 22 May 2003 04:00:27 -0700 (PDT) Resent-Date: Thu, 22 May 2003 04:00:27 -0700 (PDT) Resent-Message-Id: <200305221100.h4MB0R6S033158@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, Akira Ikeuchi Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8459537B401; Thu, 22 May 2003 03:59:47 -0700 (PDT) Received: from mx02.mitsumi.co.jp (mx02.mitsumi.co.jp [202.33.112.205]) by mx1.FreeBSD.org (Postfix) with ESMTP id 26F0843F75; Thu, 22 May 2003 03:59:46 -0700 (PDT) (envelope-from a_ikeuchi@mic.mitsumi.co.jp) Received: from mvc01.mitsumi.co.jp ([192.168.1.254]) by mx02.mitsumi.co.jp (8.11.6p2/8.11.6) with ESMTP id h4MB22k13340; Thu, 22 May 2003 20:02:02 +0900 Received: from mmx01.mitsumi.co.jp (localhost [127.0.0.1] (may be forged)) by mvc01.mitsumi.co.jp (8.11.6/8.11.6) with ESMTP id h4MAsjq22453; Thu, 22 May 2003 19:54:45 +0900 Received: from ml01.mic.mitsumi.co.jp (mic.mitsumi.co.jp [172.17.5.244] (may be forged)) by mmx01.mitsumi.co.jp (8.9.3p2+3.2W/3.7W) with ESMTP id TAA15701; Thu, 22 May 2003 19:59:44 +0900 Received: from mic.mitsumi.co.jp (a-ikeuchi.mic.mitsumi.co.jp [172.17.40.89]) by ml01.mic.mitsumi.co.jp (8.10.2/8.10.2) with ESMTP id h4MAiH819869; Thu, 22 May 2003 19:44:22 +0900 Message-Id: <3ECCADE3.3020708@mic.mitsumi.co.jp> Date: Thu, 22 May 2003 20:00:51 +0900 From: Akira Ikeuchi To: FreeBSD-gnats-submit@FreeBSD.org cc: imp@FreeBSD.org Subject: docs/52566: [PATCH] typing error in device_get_ivars.9 man page. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 11:00:28 -0000 >Number: 52566 >Category: docs >Synopsis: Typing error in device_get_ivars.9 man 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: Thu May 22 04:00:26 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Akira Ikeuchi >Release: FreeBSD 5.0-CURRENT i386 >Organization: T.I.T. Corp. >Environment: System: FreeBSD vmware50.mic.mitsumi.co.jp 5.0-RELEASE FreeBSD 5.0-RELEASE #2: Mon Mar 3 10:27:48 JST 2003 root@vmware50.mic.mitsumi.co.jp:/usr/src/sys/i386/compile/VMWARE i386 VMware 2.0.4 on MS-Windows, FreeBSD 5.0-RELEASE >Description: Some typing errors are included in device_[gs]et_ivars.9 man page. These errors were added when updating ver.1.6 to ver.1.7. The first is in SYNOPSIS section, two device_get_ivars functions are exists, and no device_set_ivars function. Maybe, second device_get_ivars is typing error, and to be device_set_ivars. The second is in DESCRIPTION section. On the first line .Pp macro is not needed, but no affection. The third is in DESCRIPTION section. device_[gs]et_ivars functions is mis-typed to device_[gs]et_ivar. Last letter 's' is dropped. >How-To-Repeat: man 9 device_get_ivars >Fix: Patch below. --- device_get_ivars.9.orig Wed May 21 19:24:40 2003 +++ device_get_ivars.9 Wed May 21 19:25:13 2003 @@ -41,15 +41,14 @@ .Ft void * .Fn device_get_ivars "device_t dev" .Ft void -.Fn device_get_ivars "device_t dev" "void *ivar" +.Fn device_set_ivars "device_t dev" "void *ivar" .Sh DESCRIPTION -.Pp The -.Nm device_get_ivar +.Nm device_get_ivars function returns the bus-specific instance variables of a device. .Pp The -.Nm device_set_ivar +.Nm device_set_ivars function sets the bus-specific instance variables of a device. .Pp Typically, only bus drivers will use these functions. >Release-Note: >Audit-Trail: >Unformatted: SEND-PR: -*- send-pr -*- SEND-PR: Lines starting with `SEND-PR' will be removed automatically, as SEND-PR: will all comments (text enclosed in `<' and `>'). SEND-PR: SEND-PR: Please consult the following URL if you are not sure how to SEND-PR: fill out a problem report: SEND-PR: http://www.freebsd.org/doc/en/articles/problem-reports/article.html SEND-PR: SEND-PR: Note that the Synopsis field is mandatory. SEND-PR: SEND-PR: Please note that (unless you state otherwise) if your report SEND-PR: includes a patch then it will be taken under the same license as SEND-PR: the one on the file(s) you want to change. SEND-PR: SEND-PR: BE ADVISED THAT FREEBSD PROBLEM REPORTS ARE PUBLIC INFORMATION AND SEND-PR: WILL BE PUBLISHED AS-IS ON THE PROJECT'S MAILING LISTS AND WEB SITES. SEND-PR: DO NOT SUBMIT ANY INFORMATION YOU DO NOT WANT MADE PUBLIC. SEND-PR: SEND-PR: For sensitive security issues, consider contacting the FreeBSD SEND-PR: security officer team (security-officer@freebsd.org) directly. SEND-PR: SEND-PR: Choose from the following categories: SEND-PR: SEND-PR: advocacy alpha bin conf docs gnu SEND-PR: i386 ia64 java kern misc ports SEND-PR: powerpc sparc64 standards www SEND-PR: To: FreeBSD-gnats-submit@freebsd.org From: Akira Ikeuchi Reply-To: Akira Ikeuchi Cc: X-send-pr-version: 3.113 X-GNATS-Notify: From owner-freebsd-doc@FreeBSD.ORG Thu May 22 05:53:56 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7E34437B401; Thu, 22 May 2003 05:53:56 -0700 (PDT) Received: from camel.jerocu.net (camel.jerocu.net [213.129.160.132]) by mx1.FreeBSD.org (Postfix) with ESMTP id EE82143F3F; Thu, 22 May 2003 05:53:54 -0700 (PDT) (envelope-from jesusr@endercom.com) Received: from localhost (localhost [127.0.0.1]) by camel.jerocu.net (8.12.9/8.12.9) with ESMTP id h4MCrXrl016448; Thu, 22 May 2003 14:53:34 +0200 (CEST) (envelope-from jesusr@endercom.com) Date: Thu, 22 May 2003 14:53:33 +0200 (CEST) From: Jesus Rodriguez X-X-Sender: jesusr@camel To: Giorgos Keramidas In-Reply-To: <20030521214108.GA8632@gothmog.gr> Message-ID: <20030522144836.G16403@camel> References: <20030521165628.39bdfaf5.trhodes@FreeBSD.org> <20030521214108.GA8632@gothmog.gr> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: Tom Rhodes cc: FreeBSD-doc@FreeBSD.org cc: hrs@eos.ocn.ne.jp Subject: Re: Error in Spanish translation files. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 12:53:56 -0000 On Thu, 22 May 2003, Giorgos Keramidas wrote: > On 2003-05-21 16:56, Tom Rhodes wrote: > > While testing Simon's recently submitted doc patch, I obtained this > > error. Could a Spanish translator (jesusr) look into this please? > > > > Note: This is a full build, not a make lint. > > > > /bin/cat /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/misc/docbook.css > docbook.css > > /usr/local/bin/jade -V html-manifest -ioutput.html -d /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/default.dsl -V %generate-legalnotice-link% -V %generate-docformat-navi-link% -ioutput.html.images -D /usr/obj/usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq -c /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../es_ES.ISO8859-1/share/sgml/catalog -c /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/iso8879/catalog -c /usr/local/share/sgml/docbook/catalog -c /usr/local/share/sgml/jade/catalog -t sgml /usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/book.sgml > > /usr/local/bin/jade:/usr/home/trhodes/work/doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/freebsd.dsl:190:31:E: missing argument for function call > > /usr/local/bin/tidy -i -m -raw -preserve -f /dev/null -asxml $(/usr/bin/xargs < HTML.manifest) > > The DSSSL function that generates the manpage links has changed in the > English docs. It now takes an *optional* argument, instead of a > mandatory argument. The following diff synchronizes the Spanish version > of freebsd.dsl with the current state of the English one... and fixes > the build, of course. > > Can you, Tom, or Jesus take care of this? There is some conflict or incompatibility between this patch and the pending commit from Hiroki?. > --- patch starts here --- > Index: es_ES.ISO8859-1/share/sgml/freebsd.dsl > =================================================================== > RCS file: /home/ncvs/doc/es_ES.ISO8859-1/share/sgml/freebsd.dsl,v > retrieving revision 1.8 > diff -u -r1.8 freebsd.dsl > --- es_ES.ISO8859-1/share/sgml/freebsd.dsl 3 Nov 2002 12:48:18 -0000 1.8 > +++ es_ES.ISO8859-1/share/sgml/freebsd.dsl 21 May 2003 21:32:40 -0000 > @@ -53,9 +58,19 @@ > (define %refentry-xref-link% #t) > > > - (define ($create-refentry-xref-link$ refentrytitle manvolnum) > - (string-append "http://www.FreeBSD.org/cgi/man.cgi?query=" > - refentrytitle "&" "sektion=" manvolnum)) > + (define ($create-refentry-xref-link$ #!optional (n (current-node))) > + (let* ((r (select-elements (children n) (normalize "refentrytitle"))) > + (m (select-elements (children n) (normalize "manvolnum"))) > + (v (attribute-string (normalize "vendor") n)) > + (u (string-append "http://www.FreeBSD.org/cgi/man.cgi?query=" > + (data r) "&" "sektion=" (data m)))) > + (case v > + (("current") (string-append u "&" "manpath=FreeBSD+5.0-current")) > + (("xfree86") (string-append u "&" "manpath=XFree86+4.3.0")) > + (("netbsd") (string-append u "&" "manpath=NetBSD+1.6.1")) > + (("ports") (string-append u "&" "manpath=FreeBSD+Ports")) > + (else u)))) > + > ]]> > > > --- patch ends here --- > Saludos JesusR. ------------------------------- Jesus Rodriguez Endercom Comunicaciones, S.L. jesusr@endercom.com http://www.endercom.com Tel. +34 934424293 ------------------------------- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 06:29:00 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B907937B401; Thu, 22 May 2003 06:29:00 -0700 (PDT) Received: from thalia.otenet.gr (thalia.otenet.gr [195.170.0.8]) by mx1.FreeBSD.org (Postfix) with ESMTP id DE81F43F3F; Thu, 22 May 2003 06:28:56 -0700 (PDT) (envelope-from keramida@ceid.upatras.gr) Received: from gothmog.gr (patr530-a081.otenet.gr [212.205.215.81]) by thalia.otenet.gr (8.12.9/8.12.9) with ESMTP id h4MDOBML006904; Thu, 22 May 2003 16:24:29 +0300 (EEST) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.9/8.12.9) with ESMTP id h4MDOAiN003592; Thu, 22 May 2003 16:24:10 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from giorgos@localhost) by gothmog.gr (8.12.9/8.12.9/Submit) id h4MDO1Il003591; Thu, 22 May 2003 16:24:01 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Thu, 22 May 2003 16:24:01 +0300 From: Giorgos Keramidas To: Jesus Rodriguez Message-ID: <20030522132401.GA3415@gothmog.gr> References: <20030521165628.39bdfaf5.trhodes@FreeBSD.org> <20030521214108.GA8632@gothmog.gr> <20030522144836.G16403@camel> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030522144836.G16403@camel> cc: Tom Rhodes cc: FreeBSD-doc@freebsd.org cc: hrs@eos.ocn.ne.jp Subject: Re: Error in Spanish translation files. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 13:29:01 -0000 On 2003-05-22 14:53, Jesus Rodriguez wrote: > On Thu, 22 May 2003, Giorgos Keramidas wrote: > > On 2003-05-21 16:56, Tom Rhodes wrote: > > > While testing Simon's recently submitted doc patch, I obtained this > > > error. Could a Spanish translator (jesusr) look into this please? > > > > > > Note: This is a full build, not a make lint. > > > [...]doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/freebsd.dsl:190:31:E: missing argument for function call > > > > The DSSSL function that generates the manpage links has changed in the > > English docs. It now takes an *optional* argument, instead of a > > mandatory argument. The following diff synchronizes the Spanish version > > of freebsd.dsl with the current state of the English one... and fixes > > the build, of course. > > > > Can you, Tom, or Jesus take care of this? > > There is some conflict or incompatibility between this patch and the > pending commit from Hiroki?. No, probably not. I was looking for a way to solve the build warns and used `diff -u en_US es_ES' to merge this change. Then, after mailing the diff, my ISP started having serious problems, and it got stuck in the mailq. I saw all the messages of the thread (including Hiroki's posts) today :/ I don't have a particularly strong opinion on this change. Hiroki should commit his version, since it's already approved. From owner-freebsd-doc@FreeBSD.ORG Thu May 22 08:09:26 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E6A9D37B401; Thu, 22 May 2003 08:09:24 -0700 (PDT) Received: from camel.jerocu.net (camel.jerocu.net [213.129.160.132]) by mx1.FreeBSD.org (Postfix) with ESMTP id F123643F3F; Thu, 22 May 2003 08:09:22 -0700 (PDT) (envelope-from jesusr@endercom.com) Received: from localhost (localhost [127.0.0.1]) by camel.jerocu.net (8.12.9/8.12.9) with ESMTP id h4MF8Brl016750; Thu, 22 May 2003 17:08:13 +0200 (CEST) (envelope-from jesusr@endercom.com) Date: Thu, 22 May 2003 17:08:11 +0200 (CEST) From: Jesus Rodriguez X-X-Sender: jesusr@camel To: Giorgos Keramidas In-Reply-To: <20030522132401.GA3415@gothmog.gr> Message-ID: <20030522170714.W16724@camel> References: <20030521165628.39bdfaf5.trhodes@FreeBSD.org> <20030521214108.GA8632@gothmog.gr> <20030522144836.G16403@camel> <20030522132401.GA3415@gothmog.gr> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: Tom Rhodes cc: FreeBSD-doc@freebsd.org cc: hrs@eos.ocn.ne.jp Subject: Re: Error in Spanish translation files. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 15:09:27 -0000 On Thu, 22 May 2003, Giorgos Keramidas wrote: > On 2003-05-22 14:53, Jesus Rodriguez wrote: > > On Thu, 22 May 2003, Giorgos Keramidas wrote: > > > On 2003-05-21 16:56, Tom Rhodes wrote: > > > > While testing Simon's recently submitted doc patch, I obtained this > > > > error. Could a Spanish translator (jesusr) look into this please? > > > > > > > > Note: This is a full build, not a make lint. > > > > [...]doc/es_ES.ISO8859-1/books/faq/../../../share/sgml/freebsd.dsl:190:31:E: missing argument for function call > > > > > > The DSSSL function that generates the manpage links has changed in the > > > English docs. It now takes an *optional* argument, instead of a > > > mandatory argument. The following diff synchronizes the Spanish version > > > of freebsd.dsl with the current state of the English one... and fixes > > > the build, of course. > > > > > > Can you, Tom, or Jesus take care of this? > > > > There is some conflict or incompatibility between this patch and the > > pending commit from Hiroki?. > > No, probably not. I was looking for a way to solve the build warns and > used `diff -u en_US es_ES' to merge this change. Then, after mailing > the diff, my ISP started having serious problems, and it got stuck in > the mailq. I saw all the messages of the thread (including Hiroki's > posts) today :/ > > I don't have a particularly strong opinion on this change. Hiroki > should commit his version, since it's already approved. Ok. As build is not broken i think we can wait to Hiroki commit his patch. Saludos JesusR. ------------------------------- Jesus Rodriguez Endercom Comunicaciones, S.L. jesusr@endercom.com http://www.endercom.com Tel. +34 934424293 ------------------------------- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 08:13:10 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9E9EA37B401; Thu, 22 May 2003 08:13:10 -0700 (PDT) Received: from sccrmhc01.attbi.com (sccrmhc01.attbi.com [204.127.202.61]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8D8B943F93; Thu, 22 May 2003 08:13:09 -0700 (PDT) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by attbi.com (sccrmhc01) with ESMTP id <2003052215130800100s46sbe>; Thu, 22 May 2003 15:13:08 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.9/8.12.9) with ESMTP id h4MFD7rh059146; Thu, 22 May 2003 08:13:08 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Message-Id: <200305221513.h4MFD7rh059146@bmah.dyndns.org> X-Mailer: exmh version 2.6.3 04/04/2003 with nmh-1.0.4 To: Hiroki Sato In-Reply-To: <200305221503.h4MF3osQ042049@repoman.freebsd.org> References: <200305221503.h4MF3osQ042049@repoman.freebsd.org> Comments: In-reply-to Hiroki Sato message dated "Thu, 22 May 2003 08:03:50 -0700." From: bmah@acm.org (Bruce A. Mah) X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_1260851960P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Thu, 22 May 2003 08:13:07 -0700 Sender: bmah@employees.org cc: freebsd-doc@FreeBSD.org Subject: Re: cvs commit: doc/da_DK.ISO8859-1/share/sgml freebsd.dsl doc/de_DE.ISO8859-1/share/sgml catalog freebsd.dsl doc/el_GR.ISO8859-7/share/sgml freebsd.dsl doc/en_US.ISO8859-1/share/sgml freebsd.dsl doc/es_ES.ISO8859-1/share/sgml catalog freebsd.dsl doc/fr_FR.ISO8859-1/share/sgml catalog ... X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: bmah@acm.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 15:13:11 -0000 --==_Exmh_1260851960P Content-Type: text/plain; charset=us-ascii If memory serves me right, Hiroki Sato wrote: > hrs 2003/05/22 08:03:50 PDT > > FreeBSD doc repository > > Modified files: > da_DK.ISO8859-1/share/sgml freebsd.dsl > de_DE.ISO8859-1/share/sgml catalog freebsd.dsl > el_GR.ISO8859-7/share/sgml freebsd.dsl > en_US.ISO8859-1/share/sgml freebsd.dsl > es_ES.ISO8859-1/share/sgml catalog freebsd.dsl > fr_FR.ISO8859-1/share/sgml catalog freebsd.dsl > it_IT.ISO8859-15/share/sgml catalog freebsd.dsl > nl_NL.ISO8859-1/share/sgml freebsd.dsl > pl_PL.ISO8859-2/share/sgml freebsd.dsl > pt_BR.ISO8859-1/share/sgml catalog freebsd.dsl > ru_RU.KOI8-R/share/sgml catalog > share/sgml catalog freebsd.dsl > sr_YU.ISO8859-2/share/sgml freebsd.dsl > zh_TW.Big5/share/sgml freebsd.dsl > Log: > Move ($create-refentry-xref-link$) to share/sgml/freebsd.dsl > and the localized sysids to /share/sgml/catalog. > > Since /share/sgml/freebsd.dsl still include some > language-neutral parameters and procedures for printable formats, > I will work on assorting them similarly. I am sorry that > this (and probably the next) commit may break the translation > team's usual update procedure, but you can merge the language-specific > freebsd.dsl from the English version as before. Not meaning to make more work for you, but would it be appropriate to do something similar for the release documentation? These files generate the same kind of manual page hyperlinks (but need to do them slightly differently than the regular doc/ documents because they're more closely tied to a specific version of the manual pages). This will also reduce the number of last-minute translation team fixes because (I think) all of the version number bumps will be in src/release/doc/share. If you could make up a patch for this, I can review and approve it pretty quickly. (If not, we can maybe do this after the end of the 5.1 release cycle.) Thanks! Bruce. --==_Exmh_1260851960P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) Comment: Exmh version 2.5+ 20020506 iD8DBQE+zOkD2MoxcVugUsMRAhWwAKD1k6KNJuyKH39acoLNDA5ac6a6fACcCPWH Ynl/Blr3M0OQhRC2hEiR8jA= =6wdq -----END PGP SIGNATURE----- --==_Exmh_1260851960P-- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 08:26:37 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5A79637B401 for ; Thu, 22 May 2003 08:26:37 -0700 (PDT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4A08743F75 for ; Thu, 22 May 2003 08:26:36 -0700 (PDT) (envelope-from hrs@eos.ocn.ne.jp) Received: from mail.allbsd.org (p63051-adsao12honb4-acca.tokyo.ocn.ne.jp [220.96.145.51]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id 524327C7B; Fri, 23 May 2003 00:26:35 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) h4MFPgJq051500; Fri, 23 May 2003 00:25:44 +0900 (JST) (envelope-from hrs@eos.ocn.ne.jp) Date: Fri, 23 May 2003 00:25:19 +0900 (JST) Message-Id: <20030523.002519.45176173.hrs@eos.ocn.ne.jp> To: bmah@acm.org From: Hiroki Sato In-Reply-To: <200305221513.h4MFD7rh059146@bmah.dyndns.org> References: <200305221503.h4MF3osQ042049@repoman.freebsd.org> <200305221513.h4MFD7rh059146@bmah.dyndns.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 3.2 on Emacs 20.7 / Mule 4.0 (HANANOEN) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit cc: freebsd-doc@freebsd.org Subject: Re: cvs commit: doc/da_DK.ISO8859-1/share/sgml freebsd.dsl doc/de_DE.ISO8859-1/share/sgml catalog freebsd.dsl doc/el_GR.ISO8859-7/share/sgml freebsd.dsl doc/en_US.ISO8859-1/share/sgml freebsd.dsl doc/es_ES.ISO8859-1/share/sgml catalog freebsd.dsl doc/fr_FR.ISO8859-1/share/sgml catalog ... X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 15:26:37 -0000 bmah@acm.org (Bruce A. Mah) wrote in <200305221513.h4MFD7rh059146@bmah.dyndns.org>: bmah> Not meaning to make more work for you, but would it be appropriate bmah> to do something similar for the release documentation? These files bmah> generate the same kind of manual page hyperlinks (but need to do them bmah> slightly differently than the regular doc/ documents because they're bmah> more closely tied to a specific version of the manual pages). OK, I will also work on src/release/doc stuff. ;-) -- | Hiroki SATO / From owner-freebsd-doc@FreeBSD.ORG Thu May 22 08:26:37 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7AA7737B404; Thu, 22 May 2003 08:26:37 -0700 (PDT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id A03E943F85; Thu, 22 May 2003 08:26:36 -0700 (PDT) (envelope-from hrs@eos.ocn.ne.jp) Received: from mail.allbsd.org (p63051-adsao12honb4-acca.tokyo.ocn.ne.jp [220.96.145.51]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id CEDAA7C79; Fri, 23 May 2003 00:26:35 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) h4MFPgJp051500; Fri, 23 May 2003 00:25:43 +0900 (JST) (envelope-from hrs@eos.ocn.ne.jp) Date: Fri, 23 May 2003 00:24:04 +0900 (JST) Message-Id: <20030523.002404.18574386.hrs@eos.ocn.ne.jp> To: keramida@ceid.upatras.gr From: Hiroki Sato In-Reply-To: <20030522132401.GA3415@gothmog.gr> References: <20030521214108.GA8632@gothmog.gr> <20030522144836.G16403@camel> <20030522132401.GA3415@gothmog.gr> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 3.2 on Emacs 20.7 / Mule 4.0 (HANANOEN) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit cc: trhodes@freebsd.org cc: FreeBSD-doc@freebsd.org cc: jesusr@endercom.com Subject: Re: Error in Spanish translation files. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 15:26:38 -0000 Giorgos Keramidas wrote in <20030522132401.GA3415@gothmog.gr>: keramida> > There is some conflict or incompatibility between this patch and the keramida> > pending commit from Hiroki?. keramida> keramida> No, probably not. I was looking for a way to solve the build warns and keramida> used `diff -u en_US es_ES' to merge this change. Then, after mailing keramida> the diff, my ISP started having serious problems, and it got stuck in keramida> the mailq. I saw all the messages of the thread (including Hiroki's keramida> posts) today :/ keramida> keramida> I don't have a particularly strong opinion on this change. Hiroki keramida> should commit his version, since it's already approved. Yes, the patch does not conflict with mine, but I think such part should be moved into the language-neutral place (otherwise similar problems must arise again). I committed a patch that solves the problem right now. If something goes wrong, please let me know. -- | Hiroki SATO / From owner-freebsd-doc@FreeBSD.ORG Thu May 22 08:30:21 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 64E4137B401 for ; Thu, 22 May 2003 08:30:21 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7247543FA3 for ; Thu, 22 May 2003 08:30:20 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4MFTwBr059129; Thu, 22 May 2003 11:29:58 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 22 May 2003 11:21:02 -0400 From: Tom Rhodes To: Hiroki Sato Message-Id: <20030522112102.11f3d68f.trhodes@FreeBSD.org> In-Reply-To: <20030523.002404.18574386.hrs@eos.ocn.ne.jp> References: <20030521214108.GA8632@gothmog.gr> <20030522144836.G16403@camel> <20030522132401.GA3415@gothmog.gr> <20030523.002404.18574386.hrs@eos.ocn.ne.jp> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: FreeBSD-doc@FreeBSD.org cc: jesusr@endercom.com Subject: Re: Error in Spanish translation files. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 15:30:21 -0000 On Fri, 23 May 2003 00:24:04 +0900 (JST) Hiroki Sato wrote: > Giorgos Keramidas wrote > in <20030522132401.GA3415@gothmog.gr>: > > keramida> > There is some conflict or incompatibility between this patch and the > keramida> > pending commit from Hiroki?. > keramida> > keramida> No, probably not. I was looking for a way to solve the build warns and > keramida> used `diff -u en_US es_ES' to merge this change. Then, after mailing > keramida> the diff, my ISP started having serious problems, and it got stuck in > keramida> the mailq. I saw all the messages of the thread (including Hiroki's > keramida> posts) today :/ > keramida> > keramida> I don't have a particularly strong opinion on this change. Hiroki > keramida> should commit his version, since it's already approved. > > Yes, the patch does not conflict with mine, but I think such part should > be moved into the language-neutral place (otherwise similar problems must > arise again). I committed a patch that solves the problem right now. > If something goes wrong, please let me know. Thank you for taking care of this! I'm impressed with the speed. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Thu May 22 12:08:28 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3967837B401 for ; Thu, 22 May 2003 12:08:28 -0700 (PDT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 45AEC43F93 for ; Thu, 22 May 2003 12:08:27 -0700 (PDT) (envelope-from hrs@eos.ocn.ne.jp) Received: from mail.allbsd.org (p63051-adsao12honb4-acca.tokyo.ocn.ne.jp [220.96.145.51]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id EF1B65CA8; Fri, 23 May 2003 04:08:25 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) h4MJ7KJp053103; Fri, 23 May 2003 04:07:21 +0900 (JST) (envelope-from hrs@eos.ocn.ne.jp) Date: Fri, 23 May 2003 04:04:05 +0900 (JST) Message-Id: <20030523.040405.15269493.hrs@eos.ocn.ne.jp> To: bmah@acm.org From: Hiroki Sato In-Reply-To: <200305221513.h4MFD7rh059146@bmah.dyndns.org> References: <200305221503.h4MF3osQ042049@repoman.freebsd.org> <200305221513.h4MFD7rh059146@bmah.dyndns.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 3.2 on Emacs 20.7 / Mule 4.0 (HANANOEN) Mime-Version: 1.0 Content-Type: Multipart/Mixed; boundary="--Next_Part(Fri_May_23_04:04:05_2003_247)--" Content-Transfer-Encoding: 7bit cc: freebsd-doc@FreeBSD.org Subject: Re: cvs commit: doc/da_DK.ISO8859-1/share/sgml freebsd.dsl doc/de_DE.ISO8859-1/share/sgml catalog freebsd.dsl doc/el_GR.ISO8859-7/share/sgml freebsd.dsl doc/en_US.ISO8859-1/share/sgml freebsd.dsl doc/es_ES.ISO8859-1/share/sgml catalog freebsd.dsl doc/fr_FR.ISO8859-1/share/sgml catalog ... X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 19:08:28 -0000 ----Next_Part(Fri_May_23_04:04:05_2003_247)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi Bruce, bmah@acm.org (Bruce A. Mah) wrote in <200305221513.h4MFD7rh059146@bmah.dyndns.org>: bmah> If you could make up a patch for this, I can review and approve it bmah> pretty quickly. (If not, we can maybe do this after the end of the 5.1 bmah> release cycle.) I made a similar patch for src/release/doc. Please try and review it. The version numbers in manpath=XXX are defined as entities in release.ent, so I think bumping them would become easier. -- | Hiroki SATO / ----Next_Part(Fri_May_23_04:04:05_2003_247)-- Content-Type: Application/Octet-Stream Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="release.dslcleanup.diff.gz" H4sICLUezT4AA3JlbGVhc2UuZHNsY2xlYW51cC5kaWZmAO2a3W7bRhbHr6WnOGHsWio9pChZikXX jhPbaRUkdmDZwC7aIKHJkcSE4rDDkRz3bYq6N71eYLHYvS16vw+wwN62L7Fn+CFRpBTLTrFJUelC 5sfMf84czsz/x5E7vkPfmeDQV4dHWqd7sr3dbBNDDwcWp3rYH3o6px61Qqo5oVfe/fBP+fSgCz3X oyboAzakum+PQz3kdtqQ7jBbXy6ezXGZU8FdOnb9PnD8E7rMB0Nrlh231wPiABkB6Xyz9oRT+rh7 aGqff7MWXeg40+MBD5MTjlUh22FCyJK5KRlbcGILqNdqdTAMs7Zl1ltAavgpyYBUVV1WqV6H59aV VGqAsW0adbPZjpXK+/tAjOZmC1T8bsP+fhnk54tQXHmUhAG13Z5rWwLTQC6Yc7WH9+MiWOje17DO RiIYCW0ght4OfA1lFSZ3satfUp9yS1DwXP9tCILBV2fPn8HQ8iGw+jQEQvamVSoO7bk+hXVOe9QX /Iq8wyMi667DfVEtq2UopYUqa3RouR7pMSYoX6umUUVCQ+sthZB+O6K+TbHS9CKmZYja0HdNUAIl SkCzsdlogtpsbT6IMlBKVGxOMfaofah4biiSb+Wr06MnCiiyfcFMh5KL0CGCW37oWYLxcN+hWjJC NMb7SnUmukTdczFuywNlufqlfLU9Da/LT5mUSSlK9wHzx5RjgKBpGn5jvl+/jo43NsD1QQxo/ACS pxaln5QqaVK+HWEu8UIhg6Q02/br10o1vRhwZtMwJPbA9RxO/Wqh9MaGkoR5+8ExqXLj4MjLd6PB ewUDdim1+2lrMglpG1HTIB/n/MYqa8kYKDa6BvfvsUBODOxixcfRMuLYe0F85tCou9lnTcXnUKlw qISYa1uQJOMhVkvSBn4VZRgfWp77HQUlbVG4wqNKTnAyzm8hiH0eM88fDReJjaFiCVz9LkbY4RAP cA3MCoyp7zCuVFF4bv0RBhPVIlYQYFlQBkIEpq5fXl5mh7Nu910do9Hw70McYPxqV5mjN30WlrCA V0H5DOdcSN/KnO8qyfVhtdCbio0LH4zzkpWK8q6HUWy3sAu5SEexOAYVWGKw+5cnUTl1S6trNaXY W5TyqcBJi0o3SB1Tgd1WccWerxMwLkIpc4NOkj/1RVy+KEU97HR6spRUU6uRZNDGK0m6SL18uTed TZOpIJhNHBqIAfhOpvmK20vb230Ilb4rb8+MmwvG3hYibuROZeuJ9+jvM5/5t/fKnZg7qP/qvPsJ ccdy8SzkjtbduaNV4I7lYik1avBo1I+5o4aoUDeRRFLuaEXcsaRSjjtqLbP2IMsdRsQdxp+WO7ba MXfU78gdzN6/BWXMKb1iihVTFEbMiilWTJFIrZhCMkWPv3py+gkxxXLx/H/2MpaLpWS0M3sZLbPe MhuN3F7GkkrFvYxGPcsU2xFTbP9pmaLZipmivWKKFVOsmGLFFCumSO5/Ukzxxnr19IVGR/bTFx+d J26OZSFLtO/OEu0CS9wch9ybOGbj6d5Ey2zWJxzRjjhiCZU8Qxhms5lliHrEEPXflyH+UBDR3Gw8 QIjYviVEZNbRN8HMUjr0opTcx/FG3gRzsWKWK7DU/qzGArqA6/9c//Lzz//894///f5fP/52/cv1 T3/79fr6+u94/R/f/5BhjxV9rOhjRR+TCiv6+EPSB/kQ+oCUPz42c3zM30EWUUENno78mC3qhmm0 za127nePZXiibSKY1BoZnmhJnGhtbkdW+sW9o+OzztlfYR2txvZGDtUGaKGMu3ZJ6Xx5fHJ6pOzN FPOZtlRJOWtxssmI4MX542edA1CIrieZ0vXDk4Pz51gWDpn9GAcbdOUICQeUCl0/Olbg4PDR2SM4 7Ha7z5BBMhGkfZXmN085Ktg56sJpXDAxlWTUReIouJ6R2SnDSzkaJ2Alo9hLfhUyNg1D/i4U/VdG SmAZa7Mtz0NrJn1uBQPXDtcRC3Z24BwbTi9JG0+KhQ/x9v2eZCX1A/xfzfu/WvR/dZ7/q4v8P186 8X81t+10B4Mu8OOHGPQUYH8ng84Iprp3N+g5Yrcy6Dn1iwb9WTpypR2PuLcz8eNi9Wnqb/bjmdqp H+ck7+DH2XDlDS0R2FGg2OPbm3RBPq6/o8wVv61zF9STZY1EQnMbub2nL2pkJ+vwL6MVSk0f51x/ n860pf19JvpG7jSa/9HhXf1d3qPvcEnB+Tx7F1xnV75ZRYEAHozkTNtVMr4R+Yk+syST9xADVv+o xIDtLyQGo3Z3ZDBqWctbxAx4q9SaGj8iQ6NmGtN/0cQIFjCDrJnbg8DateweROOBhAb8Nhp5bEhV xFVAtdC3gnDA0Mw6xwfPzg/z8DBTODmBDD1In8funcVmIudCCD3Gp84i128u3S3Zmpho59bEZV5j lAX1s4tUMhOU+KXifRXiZSedOop8d3hf8Zl1BJT4DWGJCql+9j1gT87SOHE418Bmfigs6VqXCB8D QK+/sC68K5xk/oYAn1JHWvcFBXtg+X3qaDKVkEgcW0MKrIe0weGkqwE+DBcBJgTLG7IQ1ZFVLNdH uT6TgxyVuNzp8cv/A8hNiMxsLQAA ----Next_Part(Fri_May_23_04:04:05_2003_247)---- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 13:30:44 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 520BE37B401; Thu, 22 May 2003 13:30:44 -0700 (PDT) Received: from rwcrmhc51.attbi.com (rwcrmhc51.attbi.com [204.127.198.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 83B8943F3F; Thu, 22 May 2003 13:30:43 -0700 (PDT) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by attbi.com (rwcrmhc51) with ESMTP id <20030522203042051006d2r1e>; Thu, 22 May 2003 20:30:42 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.9/8.12.9) with ESMTP id h4MKUgrh046714; Thu, 22 May 2003 13:30:42 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.9/8.12.9/Submit) id h4MKUg9H046713; Thu, 22 May 2003 13:30:42 -0700 (PDT) (envelope-from bmah) Date: Thu, 22 May 2003 13:30:42 -0700 From: "Bruce A. Mah" To: Hiroki Sato Message-ID: <20030522203042.GA46677@intruder.bmah.org> References: <200305221503.h4MF3osQ042049@repoman.freebsd.org> <200305221513.h4MFD7rh059146@bmah.dyndns.org> <20030523.040405.15269493.hrs@eos.ocn.ne.jp> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="FCuugMFkClbJLl1L" Content-Disposition: inline In-Reply-To: <20030523.040405.15269493.hrs@eos.ocn.ne.jp> User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ cc: freebsd-doc@freebsd.org Subject: Re: cvs commit: doc/da_DK.ISO8859-1/share/sgml freebsd.dsl doc/de_DE.ISO8859-1/share/sgml catalog freebsd.dsl doc/el_GR.ISO8859-7/share/sgml freebsd.dsl doc/en_US.ISO8859-1/share/sgml freebsd.dsl doc/es_ES.ISO8859-1/share/sgml catalog freebsd.dsl doc/fr_FR.ISO8859-1/share/sgml catalog ... X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 20:30:44 -0000 --FCuugMFkClbJLl1L Content-Type: text/plain; charset=us-ascii Content-Disposition: inline If memory serves me right, Hiroki Sato wrote: > I made a similar patch for src/release/doc. Please try and review it. Thanks...this looks good. It passed a LINT test for all languages and I briefly looked through the en_US HTML renderings. Seems OK to me. Please commit this change when you feel it's ready (this counts as RE approval). > The version numbers in manpath=XXX are defined as entities > in release.ent, so I think bumping them would become easier. This is a great idea...wish I had thought of that. :-) Thanks for the fast turnaround on this change! Bruce. --FCuugMFkClbJLl1L Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zTNx2MoxcVugUsMRAhaLAKDMG9gxuPB2KhCO55Uc1z+2GJSmEQCfb0Ji qfFmhtmY66slR1kLWXhINIQ= =J+Qd -----END PGP SIGNATURE----- --FCuugMFkClbJLl1L-- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 15:38:22 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9DE2E37B401 for ; Thu, 22 May 2003 15:38:22 -0700 (PDT) Received: from flood.ping.uio.no (flood.ping.uio.no [129.240.78.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id 85B7543F75 for ; Thu, 22 May 2003 15:38:21 -0700 (PDT) (envelope-from des@ofug.org) Received: by flood.ping.uio.no (Postfix, from userid 2602) id 182A4530F; Fri, 23 May 2003 00:38:20 +0200 (CEST) X-URL: http://www.ofug.org/~des/ X-Disclaimer: The views expressed in this message do not necessarily coincide with those of any organisation or company with which I am or have been affiliated. To: doc@freebsd.org From: Dag-Erling Smorgrav Date: Fri, 23 May 2003 00:38:19 +0200 Message-ID: User-Agent: Gnus/5.1001 (Gnus v5.10.1) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Subject: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 22:38:22 -0000 Does anyone ever build docs with a separate object directory? It is currently broken due to insufficient testing of bsd.images.mk rev 1.22: ===> articles/console-server make: don't know how to make /usr/obj/home/des/freebsd/doc/en_US.ISO8859-1/articles/console-server//home/des/freebsd/doc/en_US.ISO8859-1/articles/console-server/../../../share/images/articles/console-server/tk0231-9-1.png. Stop *** Error code 2 Stop in /home/des/freebsd/doc/en_US.ISO8859-1/articles. *** Error code 1 Stop in /home/des/freebsd/doc/en_US.ISO8859-1. It looks for images in ${.OBJDIR}/${.CURDIR}/../../../share/images, where they obviously aren't. DES -- Dag-Erling Smorgrav - des@ofug.org From owner-freebsd-doc@FreeBSD.ORG Thu May 22 15:44:40 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 71C8B37B404 for ; Thu, 22 May 2003 15:44:40 -0700 (PDT) Received: from flood.ping.uio.no (flood.ping.uio.no [129.240.78.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7C90F43FBD for ; Thu, 22 May 2003 15:44:39 -0700 (PDT) (envelope-from des@ofug.org) Received: by flood.ping.uio.no (Postfix, from userid 2602) id ADA16530E; Fri, 23 May 2003 00:44:37 +0200 (CEST) X-URL: http://www.ofug.org/~des/ X-Disclaimer: The views expressed in this message do not necessarily coincide with those of any organisation or company with which I am or have been affiliated. To: doc@freebsd.org References: From: Dag-Erling Smorgrav Date: Fri, 23 May 2003 00:44:36 +0200 In-Reply-To: (Dag-Erling Smorgrav's message of "Fri, 23 May 2003 00:38:19 +0200") Message-ID: User-Agent: Gnus/5.1001 (Gnus v5.10.1) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 22:44:40 -0000 Dag-Erling Smorgrav writes: > It looks for images in ${.OBJDIR}/${.CURDIR}/../../../share/images, > where they obviously aren't. I should add that it is (almost) never necessary to spell out ${.OBJDIR} as it is always the current working directory, unless you explicitly cd somewhere else. The .if ${.OBJDIR} !=3D ${.CURDIR} block that starts on line 94 of bsd.images.mk can in all likelyhood be removed. Doing so, however, uncovers the following: =3D=3D=3D> articles/checkpoint groff -p -S -Wall -mtty-char -man /home/des/freebsd/doc/en_US.ISO8859-1/art= icles/checkpoint/../../../share/images/articles/checkpoint/networks.pic > /= home/des/freebsd/doc/en_US.ISO8859-1/articles/checkpoint/../../../share/ima= ges/articles/checkpoint/networks.ps /usr/local/bin/ps2epsi /home/des/freebsd/doc/en_US.ISO8859-1/articles/check= point/../../../share/images/articles/checkpoint/networks.ps /home/des/freeb= sd/doc/en_US.ISO8859-1/articles/checkpoint/../../../share/images/articles/c= heckpoint/networks.eps Error: /rangecheck in --.getbitsrect-- Operand stack: -1 0 (\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\0= 00\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\= 000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000= \000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\00= 0\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\0= 00\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\= 000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000= \000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\00= 0\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\0= 00\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\= 000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000...) --nos= tringval-- 0 0 612 792 0 --nostringval-- (\000\000\000\000\00= 0\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\0= 00\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\= 000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000= \000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\00= 0\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\0= 00\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\= 000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000= \000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\00= 0\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\0= 00\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\= 000\000\000\000\000\000\000\000...) Execution stack: %interp_exit .runexec2 --nostringval-- --nostringval-- --nostrin= gval-- 2 %stopped_push --nostringval-- --nostringval-- --nostring= val-- false 1 %stopped_push 1 3 %oparray_pop 1 3 %oparray= _pop 1 3 %oparray_pop .runexec2 --nostringval-- --nostringval--= --nostringval-- 2 %stopped_push --nostringval-- --nostringval-- = --nostringval-- --nostringval-- false 1 %stopped_push --nostrin= gval-- --nostringval-- --nostringval-- 1 1 841 --nostringval-- = %for_pos_int_continue --nostringval-- --nostringval-- 6 6 %opar= ray_pop --nostringval-- --nostringval-- --nostringval-- Dictionary stack: --dict:1052/1123(ro)(G)-- --dict:0/20(G)-- --dict:71/200(L)-- --di= ct:25/30(L)-- --dict:59/120(L)-- --dict:25/30(L)-- Current allocation mode is local Last OS error: 2 GNU Ghostscript 7.05: Unrecoverable error, exit code 1 /usr/local/bin/peps -p -r 100 -o /home/des/freebsd/doc/en_US.ISO8859-1/art= icles/checkpoint/../../../share/images/articles/checkpoint/networks.png `/= bin/realpath /home/des/freebsd/doc/en_US.ISO8859-1/articles/checkpoint/../.= ./../share/images/articles/checkpoint/networks.eps` peps: /home/des/freebsd/doc/share/images/articles/checkpoint/networks.eps i= s not a valid EPS file. *** Error code 4 Stop in /home/des/freebsd/doc/en_US.ISO8859-1/articles/checkpoint. *** Error code 1 Stop in /home/des/freebsd/doc/en_US.ISO8859-1/articles. *** Error code 1 Stop in /home/des/freebsd/doc/en_US.ISO8859-1. DES --=20 Dag-Erling Smorgrav - des@ofug.org From owner-freebsd-doc@FreeBSD.ORG Thu May 22 15:55:50 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DBE9A37B404 for ; Thu, 22 May 2003 15:55:50 -0700 (PDT) Received: from flood.ping.uio.no (flood.ping.uio.no [129.240.78.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4340943FB1 for ; Thu, 22 May 2003 15:55:50 -0700 (PDT) (envelope-from des@ofug.org) Received: by flood.ping.uio.no (Postfix, from userid 2602) id D9376530E; Fri, 23 May 2003 00:55:47 +0200 (CEST) X-URL: http://www.ofug.org/~des/ X-Disclaimer: The views expressed in this message do not necessarily coincide with those of any organisation or company with which I am or have been affiliated. To: doc@freebsd.org References: From: Dag-Erling Smorgrav Date: Fri, 23 May 2003 00:55:46 +0200 In-Reply-To: (Dag-Erling Smorgrav's message of "Fri, 23 May 2003 00:44:36 +0200") Message-ID: User-Agent: Gnus/5.1001 (Gnus v5.10.1) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 22:55:51 -0000 Dag-Erling Smorgrav writes: > Doing so, however, uncovers the following: > [peps failure] Disregard that part, there seems to be something wrong with ghostscript on my box. DES -- Dag-Erling Smorgrav - des@ofug.org From owner-freebsd-doc@FreeBSD.ORG Thu May 22 16:17:55 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0AF3E37B401 for ; Thu, 22 May 2003 16:17:55 -0700 (PDT) Received: from nola-gate.ebaseweb.com (nola-gate.ebaseweb.com [63.82.229.230]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7594043FAF for ; Thu, 22 May 2003 16:17:54 -0700 (PDT) (envelope-from webmaster@ebaseweb.com) Received: from ebaseweb.com (unknown [63.109.127.110]) by nola-gate.ebaseweb.com (Postfix) with ESMTP id 59B61536DB for ; Thu, 22 May 2003 18:18:33 -0500 (CDT) Received: from YAKKO.ebaseweb.com [63.82.229.2] by ebaseweb.com with ESMTP (SMTPD32-6.06) id AB6A1D6A0148; Thu, 22 May 2003 18:21:14 -0500 Message-Id: <5.2.1.1.2.20030522181313.02db1058@mailhost.ebaseweb.com> X-Sender: bkimble@mailhost.ebaseweb.com X-Mailer: QUALCOMM Windows Eudora Version 5.2.1 Date: Thu, 22 May 2003 18:16:55 -0700 To: doc@FreeBSD.org From: Billy Kimble Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii"; format=flowed Subject: Don't know who to e-mail about this X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2003 23:17:55 -0000 Yo - I'm not sure who I need to be corresponding with but I just had a bit of trouble installing BSD 2.8 on my Dell PowerEdge 600SC and I think it will be a common problem for anyone installing to variety of dell servers. Every time I tried to boot to the CD, it kept gettin stuck at "ata0: resetting devices"... I let it sit there for 60 minutes once and it never progressed past that point. The problem was that dell factory ships any servers with IDE hard drives, with the hard drives on the same IDE channel .. and put the jumpers on "Auto Select". We had 2 hard drives in the box, so the solution was to move the 2nd hard drive to the secondary master, or tertiary master. Hope this helps, and if this isn't where I need to send this to, lemme know where I do :-P Later! Billy Kimble, System Administrator ebase, LLC From owner-freebsd-doc@FreeBSD.ORG Thu May 22 18:18:44 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E7CC737B407; Thu, 22 May 2003 18:18:44 -0700 (PDT) Received: from sccrmhc03.attbi.com (sccrmhc03.attbi.com [204.127.202.63]) by mx1.FreeBSD.org (Postfix) with ESMTP id DEF9D43FAF; Thu, 22 May 2003 18:18:43 -0700 (PDT) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by attbi.com (sccrmhc03) with ESMTP id <2003052301184300300a9gede>; Fri, 23 May 2003 01:18:43 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.9/8.12.9) with ESMTP id h4N1Ig9c001996; Thu, 22 May 2003 18:18:42 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.9/8.12.9/Submit) id h4N1Ige4001995; Thu, 22 May 2003 18:18:42 -0700 (PDT) Date: Thu, 22 May 2003 18:18:42 -0700 From: "Bruce A. Mah" To: freebsd-doc@freebsd.org Message-ID: <20030523011842.GA1870@intruder.bmah.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="DocE+STaALJfprDB" Content-Disposition: inline User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ Subject: HEADSUP: doc/ slush coming X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 01:18:45 -0000 --DocE+STaALJfprDB Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hi everybody-- I apologize for the late notice, but we should probably start thinking about a doc/ slush for the 5.1-RELEASE cycle. We'd like committers to have completed changes that will affect translation teams no later than Saturday, 24 May. This will give the translation teams about five or six days (depending on timezones) to synchronize and commit their work before the doc/ tree is scheduled to be tagged on Friday, 30 May. Thanks for your help...keep up the good work! Bruce. (for doceng@) --DocE+STaALJfprDB Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zXbx2MoxcVugUsMRAlXiAJ95tyhInWCxh8Ok4XozLX2iEuL8awCgvapi 1UEl85QrKfhA6I8n8sst7Uw= =rH8q -----END PGP SIGNATURE----- --DocE+STaALJfprDB-- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 18:54:56 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7363337B401 for ; Thu, 22 May 2003 18:54:56 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id DC66143F85 for ; Thu, 22 May 2003 18:54:55 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 5E72A10BF84; Fri, 23 May 2003 03:54:54 +0200 (CEST) Date: Fri, 23 May 2003 03:54:54 +0200 From: "Simon L. Nielsen" To: Dag-Erling Smorgrav Message-ID: <20030523015453.GF92953@nitro.dk> References: Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="8X7/QrJGcKSMr1RN" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.4i cc: doc@freebsd.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 01:54:56 -0000 --8X7/QrJGcKSMr1RN Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.23 00:38:19 +0200, Dag-Erling Smorgrav wrote: > Does anyone ever build docs with a separate object directory? It is > currently broken due to insufficient testing of bsd.images.mk rev > 1.22: I think the correct solution is to use .PATH in the makefiles. This way fewer special hacks should be needed. I have been trying to get this to work and it works for most of doc/ but some special cases still fail. I plan to look at this again tommorow.. --=20 Simon L. Nielsen --8X7/QrJGcKSMr1RN Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zX9t8kocFXgPTRwRAt7OAJ4tQLomywrhCVXjYtyf76faPbljVwCg27QT exPbDOfGVcUFjstYk+7sFq0= =FR35 -----END PGP SIGNATURE----- --8X7/QrJGcKSMr1RN-- From owner-freebsd-doc@FreeBSD.ORG Thu May 22 19:35:34 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F180737B40C for ; Thu, 22 May 2003 19:35:33 -0700 (PDT) Received: from flood.ping.uio.no (flood.ping.uio.no [129.240.78.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id 08D2843FE1 for ; Thu, 22 May 2003 19:35:30 -0700 (PDT) (envelope-from des@ofug.org) Received: by flood.ping.uio.no (Postfix, from userid 2602) id AF0C5530F; Fri, 23 May 2003 04:35:28 +0200 (CEST) X-URL: http://www.ofug.org/~des/ X-Disclaimer: The views expressed in this message do not necessarily coincide with those of any organisation or company with which I am or have been affiliated. To: "Simon L. Nielsen" References: <20030523015453.GF92953@nitro.dk> From: Dag-Erling Smorgrav Date: Fri, 23 May 2003 04:35:28 +0200 In-Reply-To: <20030523015453.GF92953@nitro.dk> (Simon L. Nielsen's message of "Fri, 23 May 2003 03:54:54 +0200") Message-ID: User-Agent: Gnus/5.1001 (Gnus v5.10.1) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii cc: doc@freebsd.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 02:35:34 -0000 "Simon L. Nielsen" writes: > I think the correct solution is to use .PATH in the makefiles. This way > fewer special hacks should be needed. I have been trying to get this to > work and it works for most of doc/ but some special cases still fail. No, the correct solution is to not use ${.OBJDIR}, since in most cases the current directory is the one you want; unfortunately there is a lot of precedent for using ${.OBJDIR} all over the tree (both src and doc). DES -- Dag-Erling Smorgrav - des@ofug.org From owner-freebsd-doc@FreeBSD.ORG Thu May 22 19:37:44 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A4B9E37B401 for ; Thu, 22 May 2003 19:37:44 -0700 (PDT) Received: from flood.ping.uio.no (flood.ping.uio.no [129.240.78.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0A3C043FAF for ; Thu, 22 May 2003 19:37:44 -0700 (PDT) (envelope-from des@ofug.org) Received: by flood.ping.uio.no (Postfix, from userid 2602) id 9AA7A530E; Fri, 23 May 2003 04:37:42 +0200 (CEST) X-URL: http://www.ofug.org/~des/ X-Disclaimer: The views expressed in this message do not necessarily coincide with those of any organisation or company with which I am or have been affiliated. To: "Simon L. Nielsen" References: <20030523015453.GF92953@nitro.dk> From: Dag-Erling Smorgrav Date: Fri, 23 May 2003 04:37:42 +0200 In-Reply-To: (Dag-Erling Smorgrav's message of "Fri, 23 May 2003 04:35:28 +0200") Message-ID: User-Agent: Gnus/5.1001 (Gnus v5.10.1) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii cc: doc@freebsd.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 02:37:45 -0000 Dag-Erling Smorgrav writes: > "Simon L. Nielsen" writes: > > I think the correct solution is to use .PATH in the makefiles. > No, the correct solution is to not use ${.OBJDIR} [...] Ah, sorry, I replied without really understanding what you were saying. Yes, of course, part of the solution is to use .PATH to specify where the sources for the images are found. Once that is done you can eliminate most of the ${.OBJDIR} use from doc.images.mk. DES -- Dag-Erling Smorgrav - des@ofug.org From owner-freebsd-doc@FreeBSD.ORG Thu May 22 22:01:59 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E4CA737B401 for ; Thu, 22 May 2003 22:01:59 -0700 (PDT) Received: from CPE0004761ac738-CM00109515bc65.cpe.net.cable.rogers.com (CPE0004761ac738-CM00109515bc65.cpe.net.cable.rogers.com [63.139.154.3]) by mx1.FreeBSD.org (Postfix) with SMTP id B0BEE43FDF for ; Thu, 22 May 2003 22:01:58 -0700 (PDT) shadow@cpe0004761ac738-cm00109515bc65.cpe.net.cable.rogers.com) Received: (qmail 1048 invoked by uid 1001); 23 May 2003 05:03:07 -0000 Date: Fri, 23 May 2003 01:03:07 -0400 From: Miroslav Pendev To: Peter Pentchev Message-ID: <20030523050307.GA280@cybershade.us> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline X-Divine-Shadow-Zone: Beware of Lexxx! X-Operating-System: FreeBSD 4.7 STABLE User-Agent: Mutt/1.5.3i cc: doc@freebsd.org Subject: FDP primer - Bulgarian translation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 05:02:00 -0000 Hi guys, I just finished with translation of the FDP Primer book into Bulgarian - using SGML mark-up and to me it seem to be ready to drop in /usr/doc tree... at least I was able to build txt, rtf, html, html-split and pdf. As this is a new folder tree - should I send it as PR or as link to tar.gz? Also would it be possible to create a Bulgarian Documentation Project? I will be glad to translate or mark some more docs, as this is the only way to contribute, so far... I made the translation using ÿ instead of small "ya" character, it seems to work fine with Jade, though I have problem to force jade to use the Cyrillic styles for and etc. instead of English ones. Peter, can you help with this issue? I noticed that there is a docbook's bg.xml, but I am still not sure how to use it... It is here: /usr/local/local/share/xsl/docbook/common The Cyrillic html-split version of FDP primer is here: http://www.cybershade.us/freebsd/bg/fdp/split/ Thanks, --- Miroslav Pendev From owner-freebsd-doc@FreeBSD.ORG Fri May 23 02:20:03 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7A99437B401 for ; Fri, 23 May 2003 02:20:03 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1DEAA43F85 for ; Fri, 23 May 2003 02:20:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4N9K2Up078480 for ; Fri, 23 May 2003 02:20:02 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4N9K2TI078479; Fri, 23 May 2003 02:20:02 -0700 (PDT) Date: Fri, 23 May 2003 02:20:02 -0700 (PDT) Message-Id: <200305230920.h4N9K2TI078479@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Julien Gabel Subject: Re: docs/52500: [PATCH] Unreferenced web link still exists in the 'Backup Basics' chapter of the handbook. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Julien Gabel List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 09:20:03 -0000 The following reply was made to PR docs/52500; it has been noted by GNATS. From: Julien Gabel To: freebsd-gnats-submit@FreeBSD.org Cc: Subject: Re: docs/52500: [PATCH] Unreferenced web link still exists in the 'Backup Basics' chapter of the handbook. Date: Fri, 23 May 2003 11:16:13 +0200 --OXfL5xGRrasGEqWY Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello, It seems that the proposed patch was not apply to all correct places : % find /usr/doc -print | xargs grep -i "testdump.doc" /usr/doc/en_US.ISO8859-1/books/handbook/backups/chapter.sgml: url=3D"= http://berdmann.dyndns.org/zwicky/testdump.doc.html">torture-testing /usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml: url=3D"= http://reality.sgi.com/zwicky_neu/testdump.doc.html">torture-testing I don't know (yet :) for which purpose the document "backups/chapter.sgml" = exists, but the section of the handbook 'http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bac= kup-basics.html#AEN15841' seems to be build from the 'second' file : "doc/en_US.ISO8859-1/books/handb= ook/disks/chapter.sgml". Maybe can you just apply the same patch to the second file too, --=20 -jg. --OXfL5xGRrasGEqWY Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zebdtwbGgPtqszARArFGAJ9tKrGw8r+msD+g5wPxMgdAdJyYKgCeJapQ BTVRF1vY5LCM7OcTaifB1CY= =bdmd -----END PGP SIGNATURE----- --OXfL5xGRrasGEqWY-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 06:55:26 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7D31337B401; Fri, 23 May 2003 06:55:26 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E86EA43F75; Fri, 23 May 2003 06:55:25 -0700 (PDT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4NDtPUp035427; Fri, 23 May 2003 06:55:25 -0700 (PDT) (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4NDtPI8035423; Fri, 23 May 2003 06:55:25 -0700 (PDT) Date: Fri, 23 May 2003 06:55:25 -0700 (PDT) From: Giorgos Keramidas Message-Id: <200305231355.h4NDtPI8035423@freefall.freebsd.org> To: reichert@numachi.com, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/39129: handbook; type WRT simulating postscript X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 13:55:26 -0000 Synopsis: handbook; type WRT simulating postscript State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Fri May 23 06:54:39 PDT 2003 State-Changed-Why: Committed, thanks :) Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Fri May 23 06:54:39 PDT 2003 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=39129 From owner-freebsd-doc@FreeBSD.ORG Fri May 23 07:10:04 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B4EB737B401 for ; Fri, 23 May 2003 07:10:04 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id CD18A43F93 for ; Fri, 23 May 2003 07:10:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4NEA3Up041504 for ; Fri, 23 May 2003 07:10:03 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4NEA3Gg041503; Fri, 23 May 2003 07:10:03 -0700 (PDT) Resent-Date: Fri, 23 May 2003 07:10:03 -0700 (PDT) Resent-Message-Id: <200305231410.h4NEA3Gg041503@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, Marc Olzheim Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5B30237B401 for ; Fri, 23 May 2003 07:06:46 -0700 (PDT) Received: from serv1.ilse.net (serv1.ilse.nl [62.69.160.11]) by mx1.FreeBSD.org (Postfix) with ESMTP id CB47143FAF for ; Fri, 23 May 2003 07:06:44 -0700 (PDT) (envelope-from marcolz@serv5.ilse.net) Received: from serv5.ilse.net (serv5.ilse.net [10.1.8.15]) by serv1.ilse.net (8.12.8/8.10.2) with ESMTP id h4NE6hxP099611 for ; Fri, 23 May 2003 16:06:43 +0200 (MEST) Received: (from marcolz@localhost) by serv5.ilse.net (8.12.8/8.12.4/Submit) id h4NE6gAJ038179; Fri, 23 May 2003 16:06:42 +0200 (CEST) Message-Id: <200305231406.h4NE6gAJ038179@serv5.ilse.net> Date: Fri, 23 May 2003 16:06:42 +0200 (CEST) From: Marc Olzheim To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/52612: [PATCH] close() can return undocumented ENOSPC X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Marc Olzheim List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 14:10:05 -0000 >Number: 52612 >Category: docs >Synopsis: [PATCH] close() can return undocumented ENOSPC >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: Fri May 23 07:10:02 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Marc Olzheim >Release: FreeBSD 5.0-CURRENT i386 >Organization: ilse technology >Environment: FreeBSD office-install1.ilse.net 5.0-CURRENT FreeBSD 5.0-CURRENT #8: Tue Apr 29 11:21:52 CEST 2003 root@office-install1.ilse.net:/usr/obj/usr/src/sys/SMP i386 >Description: On cached for example NFS, close can return ENOSPC, indicating that it could not correctly write pending flushes to disk. It would be nice to have this documented. Also, the paragraph about why you should use close() yourself, made me wonder what kind of programming we were trying to promote here... >How-To-Repeat: NFS mount a dir, write enough to it (at least 4 Mb in my case, it's porbably some buffersize issue), then close() the file and see ENOSPC returned. >Fix: Patch follows: --- /usr/src/lib/libc/sys/close.2 Fri May 23 15:37:05 2003 +++ /usr/src/lib/libc/sys/close.2 Fri May 23 15:48:00 2003 @@ -71,11 +71,9 @@ file descriptor for that file is closed by that process. .Pp When a process exits, -all associated file descriptors are freed, but since there is -a limit on active descriptors per processes, the +all associated file descriptors are freed, as though the process called .Fn close -system call -is useful when a large quantity of file descriptors are being handled. +itself. .Pp When a process forks (see .Xr fork 2 ) , @@ -115,6 +113,8 @@ is not an active descriptor. .It Bq Er EINTR An interrupt was received. +.It Bq Er ENOSPC +The underlying object did not fit, cached data was lost. .El .Sh SEE ALSO .Xr accept 2 , >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri May 23 07:13:53 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D3AF937B401 for ; Fri, 23 May 2003 07:13:53 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id D105843F75 for ; Fri, 23 May 2003 07:13:52 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 48ECD10BF81; Fri, 23 May 2003 16:13:51 +0200 (CEST) Date: Fri, 23 May 2003 16:13:51 +0200 From: "Simon L. Nielsen" To: Dag-Erling Smorgrav Message-ID: <20030523141349.GF402@nitro.dk> References: <20030523015453.GF92953@nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="HnQK338I3UIa/qiP" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.4i cc: doc@freebsd.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 14:13:54 -0000 --HnQK338I3UIa/qiP Content-Type: multipart/mixed; boundary="Ycz6tD7Th1CMF4v7" Content-Disposition: inline --Ycz6tD7Th1CMF4v7 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.23 04:37:42 +0200, Dag-Erling Smorgrav wrote: > Dag-Erling Smorgrav writes: > > "Simon L. Nielsen" writes: > > > I think the correct solution is to use .PATH in the makefiles. > > No, the correct solution is to not use ${.OBJDIR} [...] >=20 > Ah, sorry, I replied without really understanding what you were > saying. Yes, of course, part of the solution is to use .PATH to > specify where the sources for the images are found. Once that is done > you can eliminate most of the ${.OBJDIR} use from doc.images.mk. I have a patch that almost works now... The only problem is with the console server article which use a =2Epng image that is not generated, and therefore is not put in the object directory. That causes the install to fail. I'm currently trying to find the right way to fix this. --=20 Simon L. Nielsen --Ycz6tD7Th1CMF4v7 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="doc-build-partial-objdir-buildfix.patch" Content-Transfer-Encoding: quoted-printable Index: share/mk/doc.images.mk =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/share/mk/doc.images.mk,v retrieving revision 1.22 diff -u -d -r1.22 doc.images.mk --- share/mk/doc.images.mk 11 Apr 2003 09:21:15 -0000 1.22 +++ share/mk/doc.images.mk 23 May 2003 15:57:34 -0000 @@ -3,13 +3,15 @@ # # This include file handles image processing. # -# There are two types of images that must be handled: +# There are three types of images that must be handled: # # 1. Images from the library directory, that are shared across multiple # documents. # # 2. Images that are document specific. # +# 3. Images that are document specific, but language neutral. +# # For library images this file ensures that they are copied in to the=20 # documents directory so that they can be reference properly. # @@ -54,11 +56,18 @@ # The name of the directory that contains all the library images for this # language and encoding # -IMAGES_EN_DIR?=3D ${.CURDIR}/../../../share/images =20 -.for _curimage in ${IMAGES_EN} -LOCAL_IMAGES_EN +=3D ${IMAGES_EN_DIR}/${DOC}s/${.CURDIR:T}/${_curimage} -.endfor +# The document type (book|article) +DOC_TYPE?=3D ${.CURDIR:H:T:S|s$||} + +# The name of the document. Should be the name of the directory the +# document is stored in. +DOC_NAME?=3D ${.CURDIR:T} + +# Tell make where to find the language neutral images +.PATH: ${DOC_PREFIX}/share/images/${DOC_TYPE}s/${DOC_NAME} + +LOCAL_IMAGES_EN+=3D ${IMAGES_EN} =20 _IMAGES_PNG=3D ${IMAGES:M*.png} _IMAGES_PNG+=3D ${LOCAL_IMAGES_EN:M*.png} @@ -91,28 +100,10 @@ IMAGES_EPS=3D ${_IMAGES_EPS} ${IMAGES_GEN_EPS} ${IMAGES_SCR_EPS} ${IMAGES_= PIC_EPS} IMAGES_TXT=3D ${_IMAGES_TXT} ${IMAGES_SCR_TXT} =20 -.if ${.OBJDIR} !=3D ${.CURDIR} -LOCAL_IMAGES=3D ${IMAGES:S|^|${.OBJDIR}/|} -CLEANFILES+=3D ${LOCAL_IMAGES} - -.if !empty(_IMAGES_PNG) -LOCAL_IMAGES_PNG=3D ${_IMAGES_PNG:S|^|${.OBJDIR}/|} -.endif - -.if !empty(_IMAGES_EPS) -LOCAL_IMAGES_EPS=3D ${_IMAGES_EPS:S|^|${.OBJDIR}/|} -.endif - -.if !empty(_IMAGES_TXT) -LOCAL_IMAGES_TXT=3D ${_IMAGES_TXT:S|^|${.OBJDIR}/|} -.endif - -.else LOCAL_IMAGES=3D ${IMAGES} LOCAL_IMAGES_PNG=3D ${_IMAGES_PNG} LOCAL_IMAGES_EPS=3D ${_IMAGES_EPS} LOCAL_IMAGES_TXT=3D ${_IMAGES_TXT} -.endif =20 LOCAL_IMAGES_PNG+=3D ${IMAGES_GEN_PNG} ${IMAGES_SCR_PNG} ${IMAGES_PIC_PNG} LOCAL_IMAGES_EPS+=3D ${IMAGES_GEN_EPS} ${IMAGES_SCR_EPS} ${IMAGES_PIC_EPS} @@ -171,6 +162,7 @@ `${REALPATH} ${.TARGET:S/.png$/.eps/}` =20 .pic.eps: + ${MKDIR} ${.TARGET:H} ${PIC2PS} ${.ALLSRC} > ${.TARGET:S/.eps$/.ps/} ${PS2EPS} ${.TARGET:S/.eps$/.ps/} ${.TARGET} =20 @@ -181,17 +173,20 @@ =20 .for _curimage in ${IMAGES_GEN_PNG} ${_curimage}: ${_curimage:S/.png$/.eps/} + ${MKDIR} ${.TARGET:H} ${EPS2PNG} ${EPS2PNGOPTS} -o ${.TARGET} `${REALPATH} ${.ALLSRC}` .endfor =20 .for _curimage in ${IMAGES_GEN_EPS} ${_curimage}: ${_curimage:S/.eps$/.png/} + ${MKDIR} ${.TARGET:H} ${PNGTOPNM} ${PNGTOPNMOPTS} ${.ALLSRC} | \ ${PNMTOPS} ${PNMTOPSOPTS} > ${.TARGET} .endfor =20 .for _curimage in ${IMAGES_GEN_PDF} ${_curimage}: ${_curimage:S/.pdf$/.eps/} + ${MKDIR} ${.TARGET:H} ${EPSTOPDF} ${EPSTOPDFOPTS} --outfile=3D${.TARGET} ${.ALLSRC} .endfor =20 @@ -225,7 +220,7 @@ # The name of the directory that contains all the library images for this # language and encoding # -IMAGES_LIB_DIR?=3D ${.CURDIR}/../../../share/images +IMAGES_LIB_DIR?=3D ${DOC_PREFIX}/share/images =20 # # The name of the directory *in* the document directory where files and Index: en_US.ISO8859-1/books/handbook/txtfiles.ent =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/txtfiles.ent,v retrieving revision 1.2 diff -u -d -r1.2 txtfiles.ent --- en_US.ISO8859-1/books/handbook/txtfiles.ent 11 Apr 2003 09:21:15 -0000 = 1.2 +++ en_US.ISO8859-1/books/handbook/txtfiles.ent 23 May 2003 03:08:36 -0000 @@ -66,6 +66,6 @@ - - + + --Ycz6tD7Th1CMF4v7-- --HnQK338I3UIa/qiP Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+ziyd8kocFXgPTRwRAktHAKCY/3nIcbe6vQOxhC9V/VozUX5hVwCdGMgN vK5PT1TpxnDMdTZrjW6PBJ8= =xd9Z -----END PGP SIGNATURE----- --HnQK338I3UIa/qiP-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:15:58 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5110037B401; Fri, 23 May 2003 10:15:58 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E33C243F75; Fri, 23 May 2003 10:15:57 -0700 (PDT) (envelope-from blackend@FreeBSD.org) Received: from freefall.freebsd.org (blackend@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4NHFvUp015900; Fri, 23 May 2003 10:15:57 -0700 (PDT) (envelope-from blackend@freefall.freebsd.org) Received: (from blackend@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4NHFvUM015896; Fri, 23 May 2003 10:15:57 -0700 (PDT) Date: Fri, 23 May 2003 10:15:57 -0700 (PDT) From: Marc Fonvieille Message-Id: <200305231715.h4NHFvUM015896@freefall.freebsd.org> To: simon@nitro.dk, blackend@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:15:58 -0000 Synopsis: [patch] Cleanup of laptop article State-Changed-From-To: open->closed State-Changed-By: blackend State-Changed-When: Fri May 23 10:14:30 PDT 2003 State-Changed-Why: I committed a modified version of your patch. I will fix some remaining problems soon. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=52547 From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:17:34 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 75A2937B401; Fri, 23 May 2003 10:17:34 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1508843F75; Fri, 23 May 2003 10:17:34 -0700 (PDT) (envelope-from blackend@FreeBSD.org) Received: from freefall.freebsd.org (blackend@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4NHHXUp016089; Fri, 23 May 2003 10:17:33 -0700 (PDT) (envelope-from blackend@freefall.freebsd.org) Received: (from blackend@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4NHHXGF016085; Fri, 23 May 2003 10:17:33 -0700 (PDT) Date: Fri, 23 May 2003 10:17:33 -0700 (PDT) From: Marc Fonvieille Message-Id: <200305231717.h4NHHXGF016085@freefall.freebsd.org> To: blackend@FreeBSD.org, freebsd-doc@FreeBSD.org, blackend@FreeBSD.org Subject: Re: docs/52548: [patch] Translate navi links into Danish X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:17:34 -0000 Synopsis: [patch] Translate navi links into Danish Responsible-Changed-From-To: freebsd-doc->blackend Responsible-Changed-By: blackend Responsible-Changed-When: Fri May 23 10:17:00 PDT 2003 Responsible-Changed-Why: I will take this one since I worked on the danish doc effort. http://www.freebsd.org/cgi/query-pr.cgi?pr=52548 From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:20:07 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AF65C37B401 for ; Fri, 23 May 2003 10:20:07 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 46B5743FB1 for ; Fri, 23 May 2003 10:20:07 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4NHK7Up016137 for ; Fri, 23 May 2003 10:20:07 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4NHK72A016136; Fri, 23 May 2003 10:20:07 -0700 (PDT) Date: Fri, 23 May 2003 10:20:07 -0700 (PDT) Message-Id: <200305231720.h4NHK72A016136@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Marc Fonvieille Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Marc Fonvieille List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:20:08 -0000 The following reply was made to PR docs/52547; it has been noted by GNATS. From: Marc Fonvieille To: "Simon L.Nielsen" Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article Date: Fri, 23 May 2003 19:11:57 +0200 On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote: > General cleanup of the laptop article : > > * Add id attributes to all sect1 tags This is far to be mandatory on a so little article. > * s/FreeBSD/&os;/g This tag should be used on new submission, but a full commit does not worth since it brings nothing new to the reader. > * Add application tags around XFree86 references > * Minor markup cleanups... Hope they right > * Refer to more files/programs using manual page references > * Remove some redundant words/sentences (inspired by FDP Writing style section) > > Note: This article is in need of a whitespace cleanup. > >How-To-Repeat: > >Fix: > --- doc-article-laptop-cleanup.patch begins here --- [...] > > - > - Option "Emulate3Buttons" > - > + Option "Emulate3Buttons" It's not good: no whitespace/wrapline change with content change. And this one is quite useless. [...] > - cards is in the file /etc/defaults/pccard.conf. > + cards is in &man.pccard.conf.5;. /etc/defaults/pccard.conf is always up to date, it's not the case of the manual page. > Look through it, and preferably buy cards listed there. Cards not > listed may also work as generic devices: in > particular most modems (16-bit) should work fine, provided they > @@ -128,39 +126,38 @@ > card, remove irq 5 (otherwise you may experience hangs when you > insert a card). Check also the available memory slots; if your > card is not being detected, try changing it to one of the other > - allowed values (listed in the manual page &man.pccardc.8;). > + allowed values (listed in &man.pccardc.8;). manual page was good there. > > > - If it is not running already, start the pccardd daemon. > + If it is not running already, start the &man.pccardd.8; daemon. > (To enable it at boot time, add > pccard_enable="YES" to > - /etc/rc.conf.) Now your cards should be > + &man.rc.conf.5;). Now your cards should be Well /etc/rc.conf is a better choice there, for obvious reason. > detected when you insert and remove them, and you should get > log messages about new devices being enabled. > > There have been major changes to the pccard code > (including ISA routing of interrupts, for machines whose > - PCI BIOS FreeBSD can not seem to use) before the FreeBSD 4.4 > + PCI BIOS &os; can not seem to use) before the &os; 4.4 > release. If you have problems, try upgrading your system. > > > > - > + > > Power management > > Unfortunately, this is not very reliably supported under > - FreeBSD. If you are lucky, some functions may work reliably; > + &os;. If you are lucky, some functions may work reliably; > or they may not work at all. > > To enable this, you may need to compile a kernel with > power management support (device apm0) or > add the option enable apm0 to > - /boot/loader.conf, and > - also enable the apm daemon at boot time (line > + &man.loader.conf.5;, and > + also enable the &man.apm.8; daemon at boot time (line /boot/loader.conf is not bad here, and &man.apmd.8; seems better. Marc From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:24:32 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 02F9E37B401; Fri, 23 May 2003 10:24:32 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id E613E43F75; Fri, 23 May 2003 10:24:30 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4NHOTN6089657; Fri, 23 May 2003 13:24:29 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Fri, 23 May 2003 13:13:40 -0400 From: Tom Rhodes To: Marc Fonvieille Message-Id: <20030523131340.6af09ed5.trhodes@FreeBSD.org> In-Reply-To: <200305231720.h4NHK72A016136@freefall.freebsd.org> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:24:32 -0000 On Fri, 23 May 2003 10:20:07 -0700 (PDT) Marc Fonvieille wrote: > > - cards is in the file /etc/defaults/pccard.conf. > > + cards is in &man.pccard.conf.5;. > > /etc/defaults/pccard.conf is always up to date, it's not the case of the > manual page. FWIW, Warner (imp) does do a pretty good job at keeping the manual page up to date. Along with the wi(4) manual page. On another note, I think ``FreeBSD'' should be replaced with &os; in several places where applicable. Along with s/manpage/manual page/, as it sounds better IMHO. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:32:08 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0958437B401 for ; Fri, 23 May 2003 10:32:08 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id C4B2C43FA3 for ; Fri, 23 May 2003 10:32:06 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4NHW5gp046700; Fri, 23 May 2003 19:32:05 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4NHWGwX003949; Fri, 23 May 2003 19:32:16 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4NHWFIT003948; Fri, 23 May 2003 19:32:15 +0200 (CEST) (envelope-from marc) Date: Fri, 23 May 2003 19:32:15 +0200 From: Marc Fonvieille To: Dag-Erling Smorgrav Message-ID: <20030523173215.GB3794@nosferatu.blackend.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: doc@freebsd.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:32:08 -0000 On Fri, May 23, 2003 at 12:38:19AM +0200, Dag-Erling Smorgrav wrote: > Does anyone ever build docs with a separate object directory? It is > currently broken due to insufficient testing of bsd.images.mk rev > 1.22: > [...] Hmm I did not test that case. Well I'm currently fighting with a Groff/GS crash on my -CURRENT box, so I you have a working solution, please commit it. Marc From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:34:02 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 80E3537B401 for ; Fri, 23 May 2003 10:34:02 -0700 (PDT) Received: from rwcrmhc51.attbi.com (rwcrmhc51.attbi.com [204.127.198.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id E87F843F75 for ; Fri, 23 May 2003 10:34:01 -0700 (PDT) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by attbi.com (rwcrmhc51) with ESMTP id <20030523173401051006fmbde>; Fri, 23 May 2003 17:34:01 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.9/8.12.9) with ESMTP id h4NHY19c008084; Fri, 23 May 2003 10:34:01 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.9/8.12.9/Submit) id h4NHY0qA008083; Fri, 23 May 2003 10:34:00 -0700 (PDT) Date: Fri, 23 May 2003 10:34:00 -0700 From: "Bruce A. Mah" To: Billy Kimble Message-ID: <20030523173400.GA8060@intruder.bmah.org> References: <5.2.1.1.2.20030522181313.02db1058@mailhost.ebaseweb.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="huq684BweRXVnRxX" Content-Disposition: inline In-Reply-To: <5.2.1.1.2.20030522181313.02db1058@mailhost.ebaseweb.com> User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ cc: doc@freebsd.org Subject: Re: Don't know who to e-mail about this X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:34:02 -0000 --huq684BweRXVnRxX Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable If memory serves me right, Billy Kimble wrote: > I'm not sure who I need to be corresponding with but I just had a bit of= =20 > trouble installing BSD 2.8 on my Dell PowerEdge 600SC and I think it will= =20 > be a common problem for anyone installing to variety of dell servers. Eve= ry=20 > time I tried to boot to the CD, it kept gettin stuck at "ata0: resetting= =20 > devices"... I let it sit there for 60 minutes once and it never progresse= d=20 > past that point. The problem was that dell factory ships any servers with= =20 > IDE hard drives, with the hard drives on the same IDE channel .. and put= =20 > the jumpers on "Auto Select". We had 2 hard drives in the box, so the=20 > solution was to move the 2nd hard drive to the secondary master, or=20 > tertiary master. Hope this helps, and if this isn't where I need to send= =20 > this to, lemme know where I do :-P Later! This list is for discussion of FreeBSD documentation issues. General technical questions about FreeBSD should go to freebsd-questions@freebsd.org. (BTW, it's not clear to me exactly what OS you're trying to install. You mentioned "BSD 2.8" but there is no such thing FreeBSD 2.8. Maybe you mean a differnet version or OS?) Good luck! Bruce. --huq684BweRXVnRxX Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zluI2MoxcVugUsMRAkNzAJ4uCyXxThTHVV1ZT6nBvGr5mbeceACgy/Rd 127wClbDqvgOhOXqpsHKUDA= =sADx -----END PGP SIGNATURE----- --huq684BweRXVnRxX-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:48:34 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DBC0137B401 for ; Fri, 23 May 2003 10:48:33 -0700 (PDT) Received: from mercury.wolfram.com (mercury.wolfram.com [140.177.203.78]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6C38343F85 for ; Fri, 23 May 2003 10:48:33 -0700 (PDT) (envelope-from mailer@mercury.wolfram.com) Received: by mercury.wolfram.com (Postfix, from userid 11300) id 1145B18044; Fri, 23 May 2003 12:48:12 -0500 (CDT) To: freebsd-doc@freebsd.org From: Wolfram Research Sender: Wolfram Research Precedence: bulk Message-Id: <20030523174812.1145B18044@mercury.wolfram.com> Date: Fri, 23 May 2003 12:48:12 -0500 (CDT) Subject: MATHwire: Information for Mathematica Users X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:48:34 -0000 ------------------- Announcements ------------------- Wolfram Research's website has been redesigned. Take a look... http://www.wolfram.com webMathematica 2.0 has just been released, offering easier installation and development, faster construction of pages, and increased performance... http://www.wolfram.com/webmathematica The fifth International Mathematica Symposium will take place at Imperial College in London, England, July 7-11, 2003... http://metric.ma.ic.ac.uk/ims03 Learn how to apply the ideas of Stephen Wolfram's "A New Kind of Science" at the NKS 2003 Conference & Minicourse... http://www.wolframscience.com/nks2003 The Mathematica Teacher Network is a new forum for sharing knowledge among science and math teachers. Sign up at... http://www.wolfram.com/solutions/precollege/network Register now for spring and summer course offerings from Wolfram Education Group. Visit the website for schedules and locations... http://www.wolfram.com/services/education/courses/calendar.html ----------------------------------- Featured Application Packages ----------------------------------- A New Kind of Science Explorer: Mathematica Kit is now available, providing powerful tools for Mathematica users... http://www.wolframscience.com/nksx/nksxmk.html Control System Professional Suite from Wolfram Research offers a uniquely flexible environment for solving control problems in engineering, science, economics, and finance... http://www.wolfram.com/products/applications/csps Geometrica02 from Video Atelier introduces new features that let you do exact drawings, analytical geometry, and tests... http://www.wolfram.com/products/applications/geometrica RiskQ 4.2 from Loehle Enterprises puts users in control of their data for modeling, statistical analysis, and event prediction... http://www.wolfram.com/products/applications/riskq For drawing and solving systems represented by schematics, use the new SchematicSolver--the first mouse-driven, interactive drawing tool based entirely on Mathematica... http://www.wolfram.com/products/applications/schematicsolver UnRisk PRICING ENGINE 1.7 from UnRisk Consortium adds dozens of exotic options and many other new features for fast and accurate pricing of derivatives with Mathematica... http://www.wolfram.com/products/applications/unrisk mathStatica 1.2 lets you solve algebraic and symbolic problems in mathematical statistics and more... http://www.wolfram.com/products/applications/mathstatica -------------------- New in Print -------------------- "Numerical and Analytical Methods for Scientists and Engineers Using Mathematica" by Daniel Dubin... http://store.wolfram.com/view/book/ISBN0471266108.str "A Mathematica Approach to Calculus," Second Edition, by John T. Gresser... http://store.wolfram.com/view/book/ISBN0130920150.str "A Mathematica Companion for Differential Equations" by Selwyn Hollis... http://store.wolfram.com/view/book/ISBN0130463299.str ---------------------- Did you know...? ---------------------- ...gridMathematica lets you harness the power of grid computing, with a direct extension of Mathematica's uniquely productive programming language... http://www.wolfram.com/products/gridmathematica ...you can convert a Mathematica notebook into an interactive web application running on a webMathematica server in just four simple steps... http://library.wolfram.com/howtos/makemsp ------------------- In the news... ------------------- HyperFeed Technologies now offers their data subscribers direct connection capabilities to Mathematica... http://www.wolfram.com/news/hyperfeed.html Math professor and author Selwyn Hollis has made a website of Mathematica animations as a companion to his new book on differential equations... http://www.wolfram.com/news/hollis.html Steven Skiena, developer of the bundled Mathematica add-on package Combinatorica, talks about why he likes Mathematica and the new book that will "show the fun of discrete mathematics"... http://www.wolfram.com/news/skiena.html ----------------- If you wish to be removed from the MATHwire mailing list, please click on this link: http://www.wolfram.com/unsubscribe/?email=freebsd-doc@freebsd.org&mid=MW0503 If you wish to be removed from the Wolfram Research mailing list, please click on this link: http://www.wolfram.com/unsubscribe/?email=freebsd-doc@freebsd.org&mid=PMmw05 If you wish to change the email address we have on file for you, please click on this link: http://www.wolfram.com/emailchange/?email=freebsd-doc@freebsd.org&mid=MW0503 ----------------- This message was sent to . From owner-freebsd-doc@FreeBSD.ORG Fri May 23 10:52:15 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 006C937B401; Fri, 23 May 2003 10:52:15 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9104F43F75; Fri, 23 May 2003 10:52:13 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4NHqCgp046885; Fri, 23 May 2003 19:52:12 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4NHqNwX004086; Fri, 23 May 2003 19:52:23 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4NHqMZu004085; Fri, 23 May 2003 19:52:22 +0200 (CEST) (envelope-from marc) Date: Fri, 23 May 2003 19:52:22 +0200 From: Marc Fonvieille To: Tom Rhodes Message-ID: <20030523175222.GD3794@nosferatu.blackend.org> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> <20030523131340.6af09ed5.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030523131340.6af09ed5.trhodes@FreeBSD.org> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 17:52:15 -0000 On Fri, May 23, 2003 at 01:13:40PM -0400, Tom Rhodes wrote: > > > > /etc/defaults/pccard.conf is always up to date, it's not the case of the > > manual page. > > FWIW, Warner (imp) does do a pretty good job at keeping the manual page > up to date. Along with the wi(4) manual page. > heh I never said Warner's job was bad :) For the moment /etc/defaults/pccard.conf "seems" to be the best place to look for a supported card. Well wi(4) is a very good manual page for wireless adapters. > On another note, I think ``FreeBSD'' should be replaced with &os; in > several places where applicable. Along with s/manpage/manual page/, > as it sounds better IMHO. For s/FreeBSD/&os;/g it would be just overkill on our repo without a really gain for the reader. For "manual page" we already talked about it in past. Marc From owner-freebsd-doc@FreeBSD.ORG Fri May 23 11:05:45 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6FE4037B401; Fri, 23 May 2003 11:05:45 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3590843F3F; Fri, 23 May 2003 11:05:44 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4NI5gQd089832; Fri, 23 May 2003 14:05:43 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Fri, 23 May 2003 13:54:53 -0400 From: Tom Rhodes To: Marc Fonvieille Message-Id: <20030523135453.24ed4c17.trhodes@FreeBSD.org> In-Reply-To: <20030523175222.GD3794@nosferatu.blackend.org> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> <20030523131340.6af09ed5.trhodes@FreeBSD.org> <20030523175222.GD3794@nosferatu.blackend.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 18:05:45 -0000 On Fri, 23 May 2003 19:52:22 +0200 Marc Fonvieille wrote: > On Fri, May 23, 2003 at 01:13:40PM -0400, Tom Rhodes wrote: > > > > > > /etc/defaults/pccard.conf is always up to date, it's not the case of the > > > manual page. > > > > FWIW, Warner (imp) does do a pretty good job at keeping the manual page > > up to date. Along with the wi(4) manual page. > > > > heh I never said Warner's job was bad :) > For the moment /etc/defaults/pccard.conf "seems" to be the best place > to look for a supported card. Well wi(4) is a very good manual page for > wireless adapters. Oh, I never said you said. :) I just think that Warner does a good job keeping it up to date. > > > On another note, I think ``FreeBSD'' should be replaced with &os; in > > several places where applicable. Along with s/manpage/manual page/, > > as it sounds better IMHO. > > For s/FreeBSD/&os;/g it would be just overkill on our repo without a > really gain for the reader. For "manual page" we already talked about > it in past. It would be, but if we mix it in with regurlar worthwhile commits, it would work out 'ok' I think. Either way, perhaps something should be added to the FDP about this. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Fri May 23 11:06:30 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A080D37B401; Fri, 23 May 2003 11:06:30 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 994AB43F85; Fri, 23 May 2003 11:06:29 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 260E510BF81; Fri, 23 May 2003 20:06:28 +0200 (CEST) Date: Fri, 23 May 2003 20:06:28 +0200 From: "Simon L. Nielsen" To: Marc Fonvieille Message-ID: <20030523180624.GA65833@nitro.dk> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="OXfL5xGRrasGEqWY" Content-Disposition: inline In-Reply-To: <200305231720.h4NHK72A016136@freefall.freebsd.org> User-Agent: Mutt/1.5.4i cc: freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 18:06:31 -0000 --OXfL5xGRrasGEqWY Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.23 10:20:07 -0700, Marc Fonvieille wrote: > The following reply was made to PR docs/52547; it has been noted by GNATS. >=20 > On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote: > > General cleanup of the laptop article : > >=20 > > * Add id attributes to all sect1 tags > =20 > This is far to be mandatory on a so little article. Hmm, from following the this mailling list I got the impression that the section id tags was a good idea on all books/articles, since it makes sensible filenames when doing html-split output ? > > * s/FreeBSD/&os;/g > =20 > This tag should be used on new submission, but a full commit does not > worth since it brings nothing new to the reader. Ok. > > * Add application tags around XFree86 references > > * Minor markup cleanups... Hope they right > > * Refer to more files/programs using manual page references > > * Remove some redundant words/sentences (inspired by FDP Writing style= section) > >=20 > > Note: This article is in need of a whitespace cleanup. > > >How-To-Repeat: > > >Fix: > > --- doc-article-laptop-cleanup.patch begins here --- > [...] > > =20 > > - > > - Option "Emulate3Buttons" > > - > > + Option "Emulate3Buttons" > =20 > It's not good: no whitespace/wrapline change with content change. > And this one is quite useless. Doh, yes. I should have remembered that. > =20 > [...] > > - cards is in the file /etc/defaults/pccard.conf. =20 > > + cards is in &man.pccard.conf.5;. > =20 > /etc/defaults/pccard.conf is always up to date, it's not the case of the > manual page. I have often seen manual pages refered to instead of the files they document (at least in other manual pages). This was the main reason for this change, and a few other similar changes in the patch. > =20 > > Look through it, and preferably buy cards listed there. Cards = not > > listed may also work as generic devices: in=20 > > particular most modems (16-bit) should work fine, provided they= =20 > > @@ -128,39 +126,38 @@ > > card, remove irq 5 (otherwise you may experience hangs when you= =20 > > insert a card). Check also the available memory slots; if your= =20 > > card is not being detected, try changing it to one of the other= =20 > > - allowed values (listed in the manual page &man.pccardc.8;). > > + allowed values (listed in &man.pccardc.8;). > =20 > manual page was good there. This change was inspired by the 'Avoid redundant phrases' part of the "Writing style" section of FDP... Is I reading that section wrong, or is the FDP Primer just not updated with current pratice ? Thanks, for taking the time to comment so detailed on the patch! It helps me a lot in getting to know all the do's and don'ts about the documentation. --=20 Simon L. Nielsen --OXfL5xGRrasGEqWY Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zmMg8kocFXgPTRwRAi03AJ983XhTTwacemzXRHGL/IwPabnAIQCeL7VF 2d0eWAO2XEhBVlN7DVYofHk= =90dn -----END PGP SIGNATURE----- --OXfL5xGRrasGEqWY-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 11:17:50 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0FFF137B404 for ; Fri, 23 May 2003 11:17:50 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id B745343F75 for ; Fri, 23 May 2003 11:17:48 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4NIHlQd089860; Fri, 23 May 2003 14:17:47 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Fri, 23 May 2003 14:06:57 -0400 From: Tom Rhodes To: "Simon L. Nielsen" Message-Id: <20030523140657.4275dc72.trhodes@FreeBSD.org> In-Reply-To: <20030523180624.GA65833@nitro.dk> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> <20030523180624.GA65833@nitro.dk> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 18:17:50 -0000 On Fri, 23 May 2003 20:06:28 +0200 "Simon L. Nielsen" wrote: > On 2003.05.23 10:20:07 -0700, Marc Fonvieille wrote: > > The following reply was made to PR docs/52547; it has been noted by GNATS. > > > > On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote: > > > General cleanup of the laptop article : > > > > > > * Add id attributes to all sect1 tags > > > > This is far to be mandatory on a so little article. > > Hmm, from following the this mailling list I got the impression that the > section id tags was a good idea on all books/articles, since it makes > sensible filenames when doing html-split output ? I'm going to agree with ceri (and keramida?) about this. Personally, I think using id attributes in articles is a Good Thing™. > > This change was inspired by the 'Avoid redundant phrases' part of the > "Writing style" section of FDP... Is I reading that section wrong, or is > the FDP Primer just not updated with current pratice ? The FDP needs a few touch ups here and there. Yet, busy as we are, we simply cannot do it all. Even though we try, and a good handful of us are zealots when it comes to FreeBSD and its documentation; we are very likely to get behind. > > Thanks, for taking the time to comment so detailed on the patch! It > helps me a lot in getting to know all the do's and don'ts about the > documentation. > Education comes with time. While working through the PR base, you will learn (as I did, and many before me) the traditions and standard practices of the documentation project. Its a long road to walk, and true that the FDP can teach you how to use docbook; mdoc(7) can teach you mdoc(7); but they cannot just hand you experiance. Thats what the PR base gives you. Anyways, I've got a ton of work todo; both for FreeBSD && ${REALJOB}. Take care, -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Fri May 23 13:20:07 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6393937B401 for ; Fri, 23 May 2003 13:20:07 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0E60943F75 for ; Fri, 23 May 2003 13:20:07 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4NKK6Up033073 for ; Fri, 23 May 2003 13:20:06 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4NKK6eA033072; Fri, 23 May 2003 13:20:06 -0700 (PDT) Date: Fri, 23 May 2003 13:20:06 -0700 (PDT) Message-Id: <200305232020.h4NKK6eA033072@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" Subject: Re: docs/50181: localtime_r man page doesn't exist X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L. Nielsen" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 20:20:07 -0000 The following reply was made to PR docs/50181; it has been noted by GNATS. From: "Simon L. Nielsen" To: freebsd-gnats-submit@FreeBSD.org, steve@Watt.COM Cc: Subject: Re: docs/50181: localtime_r man page doesn't exist Date: Fri, 23 May 2003 22:10:12 +0200 --VrqPEDrXMn8OVzN4 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello This PR is duplicate of docs/22644 which was fixed in v. 1.10 of src/lib/libc/stdtime/Makefile.inc but was never MFC'ed. So this PR can be closed, if the above mentioned change is MFC'ed. --=20 Simon L. Nielsen --VrqPEDrXMn8OVzN4 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zoAj8kocFXgPTRwRAkSrAKCIXmi9LAM6jEkulZQh6DlqM4zhhgCglE+/ 3pt0Ge2Bf1lSwvljhrsBEVM= =o1jC -----END PGP SIGNATURE----- --VrqPEDrXMn8OVzN4-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 13:32:41 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 23D2337B401 for ; Fri, 23 May 2003 13:32:39 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9648243F85 for ; Fri, 23 May 2003 13:32:37 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4NKWZgp047635; Fri, 23 May 2003 22:32:35 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4NKWkwX004482; Fri, 23 May 2003 22:32:46 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4NKWjoW004481; Fri, 23 May 2003 22:32:45 +0200 (CEST) (envelope-from marc) Date: Fri, 23 May 2003 22:32:45 +0200 From: Marc Fonvieille To: "Simon L. Nielsen" Message-ID: <20030523203245.GG3794@nosferatu.blackend.org> References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="azLHFNyN32YCQGCU" Content-Disposition: inline In-Reply-To: <20030523141349.GF402@nitro.dk> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: doc@freebsd.org cc: Dag-Erling Smorgrav Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 20:32:41 -0000 --azLHFNyN32YCQGCU Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, May 23, 2003 at 04:13:51PM +0200, Simon L. Nielsen wrote: >=20 > I have a patch that almost works now... >=20 > The only problem is with the console server article which use a > .png image that is not generated, and therefore is not put in > the object directory. That causes the install to fail. I'm currently > trying to find the right way to fix this. > I see 2 big problems with your patch:=20 - Images are built many times - Images are built in each doc dirs instead of doc/share/images So a waste of CPU time, a waste of disk space. For example each localized version of the Handbook (using images) will eats about 100MB just for images build. Marc --azLHFNyN32YCQGCU Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+zna+81T1MWxkgcoRAh1qAJ0UAlYlTQeXA1pbzjtjq16c+Ay+PQCeI4pN H7NpyOz6IYiT7Zrkm7eIcEE= =e3WQ -----END PGP SIGNATURE----- --azLHFNyN32YCQGCU-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 13:51:15 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A864C37B401; Fri, 23 May 2003 13:51:15 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4CD5643F3F; Fri, 23 May 2003 13:51:14 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4NKpDgp047708; Fri, 23 May 2003 22:51:13 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4NKpOwX004536; Fri, 23 May 2003 22:51:24 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4NKpOuA004535; Fri, 23 May 2003 22:51:24 +0200 (CEST) (envelope-from marc) Date: Fri, 23 May 2003 22:51:24 +0200 From: Marc Fonvieille To: Tom Rhodes Message-ID: <20030523205124.GH3794@nosferatu.blackend.org> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> <20030523180624.GA65833@nitro.dk> <20030523140657.4275dc72.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030523140657.4275dc72.trhodes@FreeBSD.org> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: "Simon L. Nielsen" cc: freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 20:51:15 -0000 On Fri, May 23, 2003 at 02:06:57PM -0400, Tom Rhodes wrote: > On Fri, 23 May 2003 20:06:28 +0200 > "Simon L. Nielsen" wrote: > > > On 2003.05.23 10:20:07 -0700, Marc Fonvieille wrote: > > > The following reply was made to PR docs/52547; it has been noted by GNATS. > > > > > > On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote: > > > > General cleanup of the laptop article : > > > > > > > > * Add id attributes to all sect1 tags > > > > > > This is far to be mandatory on a so little article. > > > > Hmm, from following the this mailling list I got the impression that the > > section id tags was a good idea on all books/articles, since it makes > > sensible filenames when doing html-split output ? > > I'm going to agree with ceri (and keramida?) about this. Personally, > I think using id attributes in articles is a Good Thing™. > I think for a short article, id attributes could be in some ways useless since it's more annoying to read the html-split than the plain one... :) Marc From owner-freebsd-doc@FreeBSD.ORG Fri May 23 14:07:15 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id AD23C37B401; Fri, 23 May 2003 14:07:15 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8E85B43F3F; Fri, 23 May 2003 14:07:14 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4NL7DQd090182; Fri, 23 May 2003 17:07:13 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Fri, 23 May 2003 16:56:23 -0400 From: Tom Rhodes To: Marc Fonvieille Message-Id: <20030523165623.75e3ce28.trhodes@FreeBSD.org> In-Reply-To: <20030523205124.GH3794@nosferatu.blackend.org> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> <20030523180624.GA65833@nitro.dk> <20030523140657.4275dc72.trhodes@FreeBSD.org> <20030523205124.GH3794@nosferatu.blackend.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: simon@nitro.dk cc: freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 21:07:16 -0000 On Fri, 23 May 2003 22:51:24 +0200 Marc Fonvieille wrote: > On Fri, May 23, 2003 at 02:06:57PM -0400, Tom Rhodes wrote: > > On Fri, 23 May 2003 20:06:28 +0200 > > "Simon L. Nielsen" wrote: > > > > > On 2003.05.23 10:20:07 -0700, Marc Fonvieille wrote: > > > > The following reply was made to PR docs/52547; it has been noted by GNATS. > > > > > > > > On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote: > > > > > General cleanup of the laptop article : > > > > > > > > > > * Add id attributes to all sect1 tags > > > > > > > > This is far to be mandatory on a so little article. > > > > > > Hmm, from following the this mailling list I got the impression that the > > > section id tags was a good idea on all books/articles, since it makes > > > sensible filenames when doing html-split output ? > > > > I'm going to agree with ceri (and keramida?) about this. Personally, > > I think using id attributes in articles is a Good Thing™. > > > > I think for a short article, id attributes could be in some ways > useless since it's more annoying to read the html-split than the plain > one... :) Let me be anal for just a second (no comments, and stop laughing). Define ``short'' article. Do you mean more than x paragraphs long, or fewer than x number of printed pages? I agree with you that some articles/book sections could be beefed up a little with better and more robust descriptions. Well, the Personalizing Users section (8.8 in the handbook) could probably be removed entirely. The only thing it does is point users over to the localization chapter. Yet, perhaps thats a bikeshed that should be avoided. Weird people live in that shed, yo. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Fri May 23 15:11:17 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7E07737B401; Fri, 23 May 2003 15:11:17 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id BE0D343F3F; Fri, 23 May 2003 15:11:16 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 4744210BF81; Sat, 24 May 2003 00:11:15 +0200 (CEST) Date: Sat, 24 May 2003 00:11:15 +0200 From: "Simon L. Nielsen" To: Marc Fonvieille Message-ID: <20030523221114.GC66202@nitro.dk> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> <20030523180624.GA65833@nitro.dk> <20030523140657.4275dc72.trhodes@FreeBSD.org> <20030523205124.GH3794@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="NKoe5XOeduwbEQHU" Content-Disposition: inline In-Reply-To: <20030523205124.GH3794@nosferatu.blackend.org> User-Agent: Mutt/1.5.4i cc: Tom Rhodes cc: freebsd-doc@FreeBSD.org Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 22:11:17 -0000 --NKoe5XOeduwbEQHU Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.23 22:51:24 +0200, Marc Fonvieille wrote: > On Fri, May 23, 2003 at 02:06:57PM -0400, Tom Rhodes wrote: > > On Fri, 23 May 2003 20:06:28 +0200 > > "Simon L. Nielsen" wrote: > >=20 > > > On 2003.05.23 10:20:07 -0700, Marc Fonvieille wrote: > > > > The following reply was made to PR docs/52547; it has been noted by= GNATS. > > > >=20 > > > > On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote: > > > > > General cleanup of the laptop article : > > > > >=20 > > > > > * Add id attributes to all sect1 tags > > > > =20 > > > > This is far to be mandatory on a so little article. > > >=20 > > > Hmm, from following the this mailling list I got the impression that = the > > > section id tags was a good idea on all books/articles, since it makes > > > sensible filenames when doing html-split output ? > >=20 > > I'm going to agree with ceri (and keramida?) about this. Personally, > > I think using id attributes in articles is a Good Thing™. >=20 > I think for a short article, id attributes could be in some ways > useless since it's more annoying to read the html-split than the plain > one... :) Well, I agree to a point... but the split-html is being build on www.FreeBSD.org for the laptop article so you get the 'xXX.html' files, which some people could link to, and which the search engines will find. Btw. I think the bikeshed should be Yellow. --=20 Simon L. Nielsen --NKoe5XOeduwbEQHU Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zpyC8kocFXgPTRwRAsmLAJ9uRXWC7TIWemMcMyhxY/eTEW0sagCgowtj VI4QakOIYHDQr+HwVlzJD2g= =A4d7 -----END PGP SIGNATURE----- --NKoe5XOeduwbEQHU-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 15:56:59 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E2C1F37B401; Fri, 23 May 2003 15:56:59 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3533E43F85; Fri, 23 May 2003 15:56:59 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 63EDD10BF81; Sat, 24 May 2003 00:56:58 +0200 (CEST) Date: Sat, 24 May 2003 00:56:58 +0200 From: "Simon L. Nielsen" To: Marc Fonvieille Message-ID: <20030523225658.GH66202@nitro.dk> References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="cYtjc4pxslFTELvY" Content-Disposition: inline In-Reply-To: <20030523203245.GG3794@nosferatu.blackend.org> User-Agent: Mutt/1.5.4i cc: doc@freebsd.org cc: Dag-Erling Smorgrav Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 22:57:00 -0000 --cYtjc4pxslFTELvY Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.23 22:32:45 +0200, Marc Fonvieille wrote: > On Fri, May 23, 2003 at 04:13:51PM +0200, Simon L. Nielsen wrote: > >=20 > > I have a patch that almost works now... > >=20 > > The only problem is with the console server article which use a > > .png image that is not generated, and therefore is not put in > > the object directory. That causes the install to fail. I'm currently > > trying to find the right way to fix this. > > >=20 > I see 2 big problems with your patch:=20 >=20 > - Images are built many times > - Images are built in each doc dirs instead of doc/share/images >=20 > So a waste of CPU time, a waste of disk space. > For example each localized version of the Handbook (using images) will > eats about 100MB just for images build. Hmm, yes. I hadn't noticed that it got that big :-/ Ohh, well - back to the drawing board. --=20 Simon L. Nielsen --cYtjc4pxslFTELvY Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zqc68kocFXgPTRwRAql6AKC0yOVhHbRtqSX72TGVgE56rxhqZACgzuc+ L86/UjgsQTQwm3I7v+hNeL4= =F4wE -----END PGP SIGNATURE----- --cYtjc4pxslFTELvY-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 16:02:32 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 608DF37B401; Fri, 23 May 2003 16:02:32 -0700 (PDT) Received: from thalia.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id BE94A43FAF; Fri, 23 May 2003 16:02:30 -0700 (PDT) (envelope-from keramida@ceid.upatras.gr) Received: from gothmog.gr (patr530-b140.otenet.gr [212.205.244.148]) by thalia.otenet.gr (8.12.9/8.12.9) with ESMTP id h4NN2LKd025976; Sat, 24 May 2003 02:02:22 +0300 (EEST) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.9/8.12.9) with ESMTP id h4NN2IOZ027133; Sat, 24 May 2003 02:02:20 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from giorgos@localhost) by gothmog.gr (8.12.9/8.12.9/Submit) id h4NN2IPK027132; Sat, 24 May 2003 02:02:18 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Sat, 24 May 2003 02:02:18 +0300 From: Giorgos Keramidas To: Marc Fonvieille Message-ID: <20030523230218.GE25642@gothmog.gr> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> <20030523180624.GA65833@nitro.dk> <20030523140657.4275dc72.trhodes@FreeBSD.org> <20030523205124.GH3794@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="TB36FDmn/VVEgNH/" Content-Disposition: inline In-Reply-To: <20030523205124.GH3794@nosferatu.blackend.org> cc: Tom Rhodes cc: freebsd-doc@freebsd.org cc: "Simon L. Nielsen" Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 23:02:32 -0000 --TB36FDmn/VVEgNH/ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline On 2003-05-23 22:51, Marc Fonvieille wrote: >On Fri, May 23, 2003 at 02:06:57PM -0400, Tom Rhodes wrote: >>On Fri, 23 May 2003 20:06:28 +0200 "Simon L. Nielsen" wrote: >>>On 2003.05.23 10:20:07 -0700, Marc Fonvieille wrote: >>>>On Thu, May 22, 2003 at 01:45:04AM +0200, Simon L.Nielsen wrote: >>>>> General cleanup of the laptop article : >>>>> >>>>> * Add id attributes to all sect1 tags >>>> >>>> This is far to be mandatory on a so little article. >>> >>> Hmm, from following the this mailling list I got the impression that the >>> section id tags was a good idea on all books/articles, since it makes >>> sensible filenames when doing html-split output ? >> >> I'm going to agree with ceri (and keramida?) about this. Personally, >> I think using id attributes in articles is a Good Thing™. > > I think for a short article, id attributes could be in some ways > useless since it's more annoying to read the html-split than the plain > one... :) They're only useful if the article contains a "table of contents" near the top, or other parts of our docs want to refer to parts of the article. Then the links will be more sensible if we *do* use id="" keywords. For instance, this is why I recently added id="" parts to all the
elements of the pr-guidelines article. Having those id keywords there also has another advantage. People who link to the FreeBSD.org docs collection from external sites won't be surprised after a while to find that all their links point to the wrong and incomprehensible URI http://www.freebsd.org/.../lala.html#AE987623. For an article that doesn't contain a TOC, I agree with Marc though. Just my two eurocents... - Giorgos --TB36FDmn/VVEgNH/ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+zqh61g+UGjGGA7YRAhp3AKCjB5KqhgMamlvaCbq2N0yiHiGELQCeIEvJ cDcBmBBNezIIHiabT6UeMoc= =ySen -----END PGP SIGNATURE----- --TB36FDmn/VVEgNH/-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 16:47:31 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A22FF37B401; Fri, 23 May 2003 16:47:31 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3449543FBD; Fri, 23 May 2003 16:47:31 -0700 (PDT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4NNlVUp050849; Fri, 23 May 2003 16:47:31 -0700 (PDT) (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4NNlVll050845; Fri, 23 May 2003 16:47:31 -0700 (PDT) Date: Fri, 23 May 2003 16:47:31 -0700 (PDT) From: Giorgos Keramidas Message-Id: <200305232347.h4NNlVll050845@freefall.freebsd.org> To: steve@Watt.COM, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/50181: localtime_r man page doesn't exist X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 23 May 2003 23:47:31 -0000 Synopsis: localtime_r man page doesn't exist State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Fri May 23 16:45:54 PDT 2003 State-Changed-Why: I just merged the appropriate changes in revision 1.9.2.3 of src/lib/libc/stdtime/Makefile.inc Thanks to both of you. Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Fri May 23 16:45:54 PDT 2003 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=50181 From owner-freebsd-doc@FreeBSD.ORG Fri May 23 18:00:28 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9AE1437B401 for ; Fri, 23 May 2003 18:00:28 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 46EB343F3F for ; Fri, 23 May 2003 18:00:28 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4O10RUp057017 for ; Fri, 23 May 2003 18:00:27 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4O10R2C057016; Fri, 23 May 2003 18:00:27 -0700 (PDT) Date: Fri, 23 May 2003 18:00:27 -0700 (PDT) Message-Id: <200305240100.h4O10R2C057016@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" Subject: Re: docs/31164: man page for strftime is incorrect X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: "Simon L. Nielsen" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 01:00:29 -0000 The following reply was made to PR docs/31164; it has been noted by GNATS. From: "Simon L. Nielsen" To: freebsd-gnats-submit@FreeBSD.org, ulrich@infopuls.com Cc: Subject: Re: docs/31164: man page for strftime is incorrect Date: Sat, 24 May 2003 02:51:02 +0200 --7ZAtKRhVyVSsbBD2 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hello This was a problem with an incorrect manual page. This was fixed in : src/lib/libc/stdtime/strftime.3 v. 1.25 and MFC'ed as 1.18.2.8. Therefore I think this PR can be closed. --=20 Simon L. Nielsen --7ZAtKRhVyVSsbBD2 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+zsH08kocFXgPTRwRAltjAKCF55xA66H9MuSuUKiK//9wW4zs4QCfbUSu G3it3NJQniUoXoJS9AGZUh0= =SKqX -----END PGP SIGNATURE----- --7ZAtKRhVyVSsbBD2-- From owner-freebsd-doc@FreeBSD.ORG Fri May 23 18:22:59 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 41E9E37B401; Fri, 23 May 2003 18:22:59 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D57F143FB1; Fri, 23 May 2003 18:22:58 -0700 (PDT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4O1MwUp061207; Fri, 23 May 2003 18:22:58 -0700 (PDT) (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4O1MvNN061203; Fri, 23 May 2003 18:22:57 -0700 (PDT) Date: Fri, 23 May 2003 18:22:57 -0700 (PDT) From: Giorgos Keramidas Message-Id: <200305240122.h4O1MvNN061203@freefall.freebsd.org> To: ulrich@infopuls.com, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/31164: man page for strftime is incorrect X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 01:22:59 -0000 Synopsis: man page for strftime is incorrect State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Fri May 23 18:21:16 PDT 2003 State-Changed-Why: This has already been merged to STABLE. Thanks to Simon L. Nielsen for letting us know this can be closed now. http://www.freebsd.org/cgi/query-pr.cgi?pr=31164 From owner-freebsd-doc@FreeBSD.ORG Fri May 23 18:27:18 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E0F1637B401; Fri, 23 May 2003 18:27:18 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 80D1043F85; Fri, 23 May 2003 18:27:18 -0700 (PDT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4O1RIUp061324; Fri, 23 May 2003 18:27:18 -0700 (PDT) (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4O1RIfl061320; Fri, 23 May 2003 18:27:18 -0700 (PDT) Date: Fri, 23 May 2003 18:27:18 -0700 (PDT) From: Giorgos Keramidas Message-Id: <200305240127.h4O1RIfl061320@freefall.freebsd.org> To: khairil@bytecraft.com, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/43864: Minor documentation to add X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 01:27:19 -0000 Synopsis: Minor documentation to add State-Changed-From-To: feedback->closed State-Changed-By: keramida State-Changed-When: Fri May 23 18:26:34 PDT 2003 State-Changed-Why: Feedback timeout after 5 months. http://www.freebsd.org/cgi/query-pr.cgi?pr=43864 From owner-freebsd-doc@FreeBSD.ORG Sat May 24 01:11:09 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9F67737B401; Sat, 24 May 2003 01:11:09 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7E8CF43FA3; Sat, 24 May 2003 01:11:07 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4O8B2gp053976; Sat, 24 May 2003 10:11:02 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4O8B6jU000884; Sat, 24 May 2003 10:11:06 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4O8B5kO000883; Sat, 24 May 2003 10:11:05 +0200 (CEST) (envelope-from marc) Date: Sat, 24 May 2003 10:11:05 +0200 From: Marc Fonvieille To: Giorgos Keramidas Message-ID: <20030524081105.GA806@nosferatu.blackend.org> References: <200305231720.h4NHK72A016136@freefall.freebsd.org> <20030523180624.GA65833@nitro.dk> <20030523140657.4275dc72.trhodes@FreeBSD.org> <20030523205124.GH3794@nosferatu.blackend.org> <20030523230218.GE25642@gothmog.gr> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Qxx1br4bt0+wmkIi" Content-Disposition: inline In-Reply-To: <20030523230218.GE25642@gothmog.gr> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: Tom Rhodes cc: freebsd-doc@freebsd.org cc: "Simon L. Nielsen" Subject: Re: docs/52547: [patch] Cleanup of laptop article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 08:11:09 -0000 --Qxx1br4bt0+wmkIi Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, May 24, 2003 at 02:02:18AM +0300, Giorgos Keramidas wrote: [...] >=20 > They're only useful if the article contains a "table of contents" near > the top, or other parts of our docs want to refer to parts of the > article. Then the links will be more sensible if we *do* use id=3D"" > keywords. For instance, this is why I recently added id=3D"" parts to all > the
elements of the pr-guidelines article. >=20 > Having those id keywords there also has another advantage. People who > link to the FreeBSD.org docs collection from external sites won't be > surprised after a while to find that all their links point to the wrong > and incomprehensible URI http://www.freebsd.org/.../lala.html#AE987623. >=20 > For an article that doesn't contain a TOC, I agree with Marc though. > True, some articles need the id thing, some others not. Marc PS: For everyone, I'm not sure you will get this mail :) I'm experiencing a lot of mail and DNS issues since few days. So do not be surprise if I don't answer or if I do an "out of sync" answer etc. --Qxx1br4bt0+wmkIi Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+zykY81T1MWxkgcoRAuIOAJ9nBe7aLjCdT7vab6LHI5mZfLPBCACeJiWZ cUDEVAPY5fR1ckkiqfg7zfY= =rMY+ -----END PGP SIGNATURE----- --Qxx1br4bt0+wmkIi-- From owner-freebsd-doc@FreeBSD.ORG Sat May 24 01:57:39 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 78C4137B401 for ; Sat, 24 May 2003 01:57:39 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id EC7A243F3F for ; Sat, 24 May 2003 01:57:37 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4O8vagp054661; Sat, 24 May 2003 10:57:36 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4O8vejU000982; Sat, 24 May 2003 10:57:40 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4O8vdkG000981; Sat, 24 May 2003 10:57:39 +0200 (CEST) (envelope-from marc) Date: Sat, 24 May 2003 10:57:38 +0200 From: Marc Fonvieille To: doc@freebsd.org Message-ID: <20030524085738.GB806@nosferatu.blackend.org> References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="GRPZ8SYKNexpdSJ7" Content-Disposition: inline In-Reply-To: <20030523203245.GG3794@nosferatu.blackend.org> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: "Simon L. Nielsen" cc: Dag-Erling Smorgrav Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 08:57:39 -0000 --GRPZ8SYKNexpdSJ7 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, May 23, 2003 at 10:32:45PM +0200, Marc Fonvieille wrote: >=20 > I see 2 big problems with your patch:=20 >=20 > - Images are built many times > - Images are built in each doc dirs instead of doc/share/images >=20 > So a waste of CPU time, a waste of disk space. > For example each localized version of the Handbook (using images) will > eats about 100MB just for images build. > In fact I'm not really right on that point: the 100MB is in the PDF/PS format case which needs the images to be in the localdir, it would be very difficult to deal with links in the generated .tex file. For the others formats, HTML for example, in your implementation the images are copied many times in the doc tree (each time a doc needs the image) which is, as I said in my previous mail, a space eater. Well, nothing is easy, our .mk files are very "hairy" cause of multiples add-ons etc. All the thing should be rewritten from the beginning, but who would be enough "crazy" to take that task? :)) Marc --GRPZ8SYKNexpdSJ7 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+zzQB81T1MWxkgcoRAkMzAJwLV9kcGRQFiX1GSrTwDxjV8+IkYACgoC57 bEKK841WgcFD9Rj0qeKEpts= =rup9 -----END PGP SIGNATURE----- --GRPZ8SYKNexpdSJ7-- From owner-freebsd-doc@FreeBSD.ORG Sat May 24 02:12:32 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A0D1337B401 for ; Sat, 24 May 2003 02:12:32 -0700 (PDT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 062FF43F93 for ; Sat, 24 May 2003 02:12:31 -0700 (PDT) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.10.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id h4O9CTgp054724; Sat, 24 May 2003 11:12:29 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) h4O9CXjU001049; Sat, 24 May 2003 11:12:33 +0200 (CEST) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.9/8.12.9/Submit) id h4O9CXAG001048; Sat, 24 May 2003 11:12:33 +0200 (CEST) (envelope-from marc) Date: Sat, 24 May 2003 11:12:33 +0200 From: Marc Fonvieille To: doc@freebsd.org Message-ID: <20030524091233.GD806@nosferatu.blackend.org> References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="eRtJSFbw+EEWtPj3" Content-Disposition: inline In-Reply-To: <20030523203245.GG3794@nosferatu.blackend.org> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.1-BETA cc: "Simon L. Nielsen" cc: Dag-Erling Smorgrav Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 09:12:32 -0000 --eRtJSFbw+EEWtPj3 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, May 23, 2003 at 10:32:45PM +0200, Marc Fonvieille wrote: >=20 > I see 2 big problems with your patch:=20 > Hmm sometimes my English sounds harsh, sorry about that. Marc --eRtJSFbw+EEWtPj3 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+zzeA81T1MWxkgcoRAh0FAJ9SJgW7+7aFoB/HtDMfFgiRGdrxOgCcD7uY 6zcoZ9fw350NPsP8RY1JJ9w= =SH7S -----END PGP SIGNATURE----- --eRtJSFbw+EEWtPj3-- From owner-freebsd-doc@FreeBSD.ORG Sat May 24 03:17:43 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5714837B401; Sat, 24 May 2003 03:17:43 -0700 (PDT) Received: from flood.ping.uio.no (flood.ping.uio.no [129.240.78.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id 899A243F3F; Sat, 24 May 2003 03:17:41 -0700 (PDT) (envelope-from des@ofug.org) Received: by flood.ping.uio.no (Postfix, from userid 2602) id 849B7530E; Sat, 24 May 2003 12:17:38 +0200 (CEST) X-URL: http://www.ofug.org/~des/ X-Disclaimer: The views expressed in this message do not necessarily coincide with those of any organisation or company with which I am or have been affiliated. To: Marc Fonvieille References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> <20030524085738.GB806@nosferatu.blackend.org> From: Dag-Erling Smorgrav Date: Sat, 24 May 2003 12:17:38 +0200 In-Reply-To: <20030524085738.GB806@nosferatu.blackend.org> (Marc Fonvieille's message of "Sat, 24 May 2003 10:57:38 +0200") Message-ID: User-Agent: Gnus/5.1001 (Gnus v5.10.1) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" cc: "Simon L. Nielsen" cc: doc@freebsd.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 10:17:43 -0000 --=-=-= Marc Fonvieille writes: > Well, nothing is easy, our .mk files are very "hairy" cause of multiples > add-ons etc. All the thing should be rewritten from the beginning, but > who would be enough "crazy" to take that task? :)) A rewrite is definitely needed. That would also be a good occasion to transition from SGML to XML, if at all possible (XML tools are a couple of orders of magnitude faster than SGML tools...) As for images, the obvious solution (to me) is to start by recursing into share/images and build all images there before building the documents themselves. For the curious, I've attached my document.mk which I use for pretty much everything I produce outside the FreeBSD doc tree. It's the nth generation of something I originally wrote for ThinkSec way back when. Not a doc.project.mk replacement, but a different take on a similar theme. DES -- Dag-Erling Smorgrav - des@ofug.org --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: attachment; filename=document.mk Content-Transfer-Encoding: quoted-printable #!/usr/bin/make -f #- # Copyright (c) 2002 Dag-Erling Co=EFdan Sm=F8rgrav # All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer # in this position and unchanged. # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # 3. The name of the author may not be used to endorse or promote products # derived from this software without specific prior written permission. # # THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR # IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES # OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. # IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, # INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT # NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF # THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. # # $Id: document.mk,v 1.6 2002/11/08 21:15:28 des Exp $ # FORMATS ?=3D html dvi PAPER_TYPE ?=3D A4 DOCBASE ?=3D . DOCBOOK_BASE ?=3D /usr/local/share/xsl/docbook DOCBOOK_XHTML ?=3D ${DOCBOOK_BASE}/xhtml/docbook.xsl DOCBOOK_FO ?=3D ${DOCBOOK_BASE}/fo/docbook.xsl CATALOG_FILES +=3D /usr/local/share/xml/catalog .if exists(${.CURDIR}/catalog) CATALOG_FILES +=3D ${.CURDIR}/catalog .endif XSLTENV ?=3D SGML_CATALOG_FILES=3D"${CATALOG_FILES:S/ /:/g}" XSLTPROC ?=3D env ${XSLTENV} xsltproc XMLLINT ?=3D env ${XSLTENV} xmllint TIDY ?=3D tidy TIDYFLAGS ?=3D -indent -wrap 76 -raw -quiet -preserve -xml FOP ?=3D fop LATEX ?=3D latex --interaction nonstopmode LATEX_EXTLIST ?=3D .aux .log .toc .lof .lot .idx BIBTEX ?=3D bibtex DVIPS ?=3D dvips PS2PDF ?=3D ps2pdf XSLT_PARAMS +=3D author.othername.in.middle=3D"1" .ifdef HTML_STYLESHEET XSLT_PARAMS +=3D html.stylesheet=3D"'${HTML_STYLESHEET}'" .endif .ifdef SECTION_AUTOLABEL XSLT_PARAMS +=3D section.autolabel=3D"1" .endif XSLT_PARAMS +=3D toc.section.depth=3D"3" XSLT_PARAMS +=3D make.year.ranges=3D"1" XSLT_PARAMS +=3D paper.type=3D"'${PAPER_TYPE}'" XSLT_PARAM_ARGS =3D ${XSLT_PARAMS:S/^/--param /:S/=3D/ /} SRCS =3D HTML =3D DVI =3D .for document in ${DOCUMENTS} .if exists(${document}.xml) SRCS +=3D ${document}.xml .if !empty(FORMATS:Mhtml) HTML +=3D ${document}.html TARGETS +=3D ${document}.html .endif .if !empty(FORMATS:Mpdf) PDF +=3D ${document}.pdf TARGETS +=3D ${document}.pdf CLEANFILES +=3D ${document}.fo .endif .endif .if exists(${document}.tex) SRCS +=3D ${document}.tex .for ext in ${LATEX_EXTLIST} CLEANFILES +=3D ${document}${ext} .endfor .if !empty(FORMATS:Mdvi) DVI +=3D ${document}.dvi TARGETS +=3D ${document}.dvi .endif .if !empty(FORMATS:Mpdf) PDF +=3D ${document}.pdf TARGETS +=3D ${document}.pdf CLEANFILES +=3D ${document}.dvi ${document}.ps .endif .if exists(${document}.bib) ${document}.dvi: ${document}.tex ${document}.bib .endif .endif .endfor CLEANFILES +=3D ${TARGETS} .MAIN: all depend all install clean: @${MAKE} do-${.TARGET} .for subdir in ${SUBDIR} @echo "=3D=3D=3D> ${DIRPREFIX}${subdir} [${.TARGET}]" @(cd ${subdir} && ${MAKE} ${.TARGET} DIRPREFIX=3D"${DIRPREFIX}${subdir}/") .endfor .if !target(do-depend) do-depend: ${SRCS} .endif .if !target(do-all) do-all: ${TARGETS} .endif .if !target(do-install) do-install: .endif .if !target(do-clean) do-clean: .if !empty(CLEANFILES) rm -f ${CLEANFILES} .endif .endif .SUFFIXES: .SUFFIXES: .tex .dvi .xml .html .fo .ps .pdf .tex.dvi: sh -c 'sum=3D`cksum ${.TARGET:.dvi=3D.aux}`; \ ${LATEX} ${.IMPSRC} && \ if [ -f ${.IMPSRC:R}.bib ] ; then \ ${BIBTEX} ${.IMPSRC:R}; \ fi && \ if [ "$$sum" !=3D "`cksum ${.TARGET:.dvi=3D.aux}`" ]; then \ ${LATEX} ${.IMPSRC}; \ fi' .dvi.ps: ${DVIPS} -o ${.TARGET} ${.IMPSRC} .ps.pdf: ${PS2PDF} ${.IMPSRC} ${.TARGET} .xml.html: ${DOCBOOK_XHTML} ${XSLTPROC} -o ${.TARGET} ${XSLT_PARAM_ARGS} --catalogs\ ${DOCBOOK_XHTML} ${.IMPSRC} .if defined(TIDY) && ${TIDY} !=3D NO && ${TIDY} !=3D no @perl -p -i -e 's/(? Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8404437B401; Sat, 24 May 2003 03:30:15 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id A28BA43F85; Sat, 24 May 2003 03:30:14 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id C052F10BF84; Sat, 24 May 2003 12:30:13 +0200 (CEST) Date: Sat, 24 May 2003 12:30:13 +0200 From: "Simon L. Nielsen" To: Marc Fonvieille Message-ID: <20030524103013.GD418@nitro.dk> References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> <20030524085738.GB806@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="RASg3xLB4tUQ4RcS" Content-Disposition: inline In-Reply-To: <20030524085738.GB806@nosferatu.blackend.org> User-Agent: Mutt/1.5.4i cc: doc@freebsd.org cc: Dag-Erling Smorgrav Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 10:30:15 -0000 --RASg3xLB4tUQ4RcS Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.24 10:57:38 +0200, Marc Fonvieille wrote: > In fact I'm not really right on that point: the 100MB is in the PDF/PS > format case which needs the images to be in the localdir, it would be > very difficult to deal with links in the generated .tex file. > For the others formats, HTML for example, in your implementation the > images are copied many times in the doc tree (each time a doc needs the > image) which is, as I said in my previous mail, a space eater. It definatly is a bad thing to require that much space for building when it really should not be needed, if done right. > Well, nothing is easy, our .mk files are very "hairy" cause of multiples > add-ons etc. All the thing should be rewritten from the beginning, but > who would be enough "crazy" to take that task? :)) Guess who would... hey, why am I still in CC :-) I'm going to try to write down some requirements on what a new doc build system should support, and I'l post it here, unless somebody else is interested in looking over drafts before doing a wider circulation... ? --=20 Simon L. Nielsen --RASg3xLB4tUQ4RcS Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+z0m18kocFXgPTRwRAn2JAJ9xgfyzm4p8lhEKt/HgMZkbs5Ic9QCg1/tS E3t8G/CWNBca6dn4LxrDX2o= =UPVj -----END PGP SIGNATURE----- --RASg3xLB4tUQ4RcS-- From owner-freebsd-doc@FreeBSD.ORG Sat May 24 03:37:13 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id F226D37B401; Sat, 24 May 2003 03:37:12 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3CDEA43F75; Sat, 24 May 2003 03:37:12 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 85AC610BF84; Sat, 24 May 2003 12:37:11 +0200 (CEST) Date: Sat, 24 May 2003 12:37:11 +0200 From: "Simon L. Nielsen" To: Dag-Erling Smorgrav Message-ID: <20030524103711.GE418@nitro.dk> References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> <20030524085738.GB806@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="pAwQNkOnpTn9IO2O" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.4i cc: doc@freebsd.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 10:37:13 -0000 --pAwQNkOnpTn9IO2O Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.24 12:17:38 +0200, Dag-Erling Smorgrav wrote: > Marc Fonvieille writes: > > Well, nothing is easy, our .mk files are very "hairy" cause of multiples > > add-ons etc. All the thing should be rewritten from the beginning, but > > who would be enough "crazy" to take that task? :)) >=20 > A rewrite is definitely needed. That would also be a good occasion to > transition from SGML to XML, if at all possible (XML tools are a > couple of orders of magnitude faster than SGML tools...) Doesn't the XML docbook have problems with including other files as done e.g. in the handbook? I might remember incorrectly, it is some time since I looked at XML docbook last. > As for images, the obvious solution (to me) is to start by recursing > into share/images and build all images there before building the > documents themselves. That was actually also the solution I was thinking a bit about to avoid having to build the images multiple times. Perhaps with the help of symlinks... but I havn't had a closer look at it yet. > For the curious, I've attached my document.mk which I use for pretty > much everything I produce outside the FreeBSD doc tree. It's the nth > generation of something I originally wrote for ThinkSec way back when. > Not a doc.project.mk replacement, but a different take on a similar > theme. Nice, I will take a closer look at it. --=20 Simon L. Nielsen --pAwQNkOnpTn9IO2O Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+z0tX8kocFXgPTRwRAmFGAJ0f7gRXLj2bhS6UqGdjAaShbc8zXQCgkx7T pE8hE5eCWREzz7QKM0fQ5Oc= =Vl8J -----END PGP SIGNATURE----- --pAwQNkOnpTn9IO2O-- From owner-freebsd-doc@FreeBSD.ORG Sat May 24 04:02:00 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 11BCD37B401; Sat, 24 May 2003 04:02:00 -0700 (PDT) Received: from flood.ping.uio.no (flood.ping.uio.no [129.240.78.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id D13E643F3F; Sat, 24 May 2003 04:01:58 -0700 (PDT) (envelope-from des@ofug.org) Received: by flood.ping.uio.no (Postfix, from userid 2602) id A8995530E; Sat, 24 May 2003 13:01:55 +0200 (CEST) X-URL: http://www.ofug.org/~des/ X-Disclaimer: The views expressed in this message do not necessarily coincide with those of any organisation or company with which I am or have been affiliated. To: "Simon L. Nielsen" References: <20030523015453.GF92953@nitro.dk> <20030523141349.GF402@nitro.dk> <20030523203245.GG3794@nosferatu.blackend.org> <20030524085738.GB806@nosferatu.blackend.org> <20030524103711.GE418@nitro.dk> From: Dag-Erling Smorgrav Date: Sat, 24 May 2003 13:01:55 +0200 In-Reply-To: <20030524103711.GE418@nitro.dk> (Simon L. Nielsen's message of "Sat, 24 May 2003 12:37:11 +0200") Message-ID: User-Agent: Gnus/5.1001 (Gnus v5.10.1) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii cc: doc@freebsd.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 11:02:00 -0000 "Simon L. Nielsen" writes: > Doesn't the XML docbook have problems with including other files as done > e.g. in the handbook? Not at all: %manpages; ]> DES -- Dag-Erling Smorgrav - des@ofug.org From owner-freebsd-doc@FreeBSD.ORG Sat May 24 13:50:12 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 604C237B401 for ; Sat, 24 May 2003 13:50:12 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7C46F43F85 for ; Sat, 24 May 2003 13:50:11 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h4OKoBUp070034 for ; Sat, 24 May 2003 13:50:11 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h4OKoB1A070033; Sat, 24 May 2003 13:50:11 -0700 (PDT) Date: Sat, 24 May 2003 13:50:11 -0700 (PDT) Message-Id: <200305242050.h4OKoB1A070033@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Murray Stokely Subject: Re: docs/52514: Handbook: new chapter about Bluetooth X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Murray Stokely List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 May 2003 20:50:12 -0000 The following reply was made to PR docs/52514; it has been noted by GNATS. From: Murray Stokely To: Pav Lucistnik Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/52514: Handbook: new chapter about Bluetooth Date: Sat, 24 May 2003 13:45:18 -0700 I'm glad we're going to have this new content about Bluetooth, but I don't think it belongs in a new chapter. Other interface technologies such as USB, Firewire, SCSI, IDE, etc.. do not have their own chapters. I think this might belong as a section in the Desktop chapter. - Murray On Wed, May 21, 2003 at 08:25:11AM +0200, Pav Lucistnik wrote: > > >Number: 52514 > >Category: docs > >Synopsis: Handbook: new chapter about Bluetooth > >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: Tue May 20 23:30:00 PDT 2003 > >Closed-Date: > >Last-Modified: > >Originator: Pav Lucistnik > >Release: FreeBSD 5.1-BETA i386 > >Organization: > >Environment: > System: FreeBSD pav.oook.cz 5.1-BETA FreeBSD 5.1-BETA #1: Tue May 20 21:30:57 CEST 2003 root@pav.oook.cz:/usr/obj/usr/src/sys/PAV i386 > > > > >Description: > This is new chapter for Handbook, covering usage of The Bluetooth stack > on coming 5.1-RELEASE. It's based on my Bluetooth on FreeBSD webpage. > It was reviewed and approved by Maksim Yevmenkin, author of Bluetooth > code. Then it was review by Christian Brueffer (brueffer@). > > We'd like to get a review by at least one docproj elder before brueffer > commits it. > > Another question is where this should go. brueffer@ suggests after > Wireless Networking chapter, I suggest putting it after IPv6 as > a last chapter of Advanced networking. > > Apply to /usr/doc/en_US.ISO8859-1/books/handbook/advanced-networking > >How-To-Repeat: > > >Fix: > > --- chapter.sgml.orig Tue May 20 21:11:44 2003 > +++ chapter.sgml Tue May 20 23:15:03 2003 > @@ -6687,6 +6687,388 @@ > support AAAA records. > > > + > + > + > + > + > + Pav > + Lucistnik > + Written by > + > +
pav@oook.cz
> + > + > + > + > + Bluetooth > + > + > + Introduction > + Bluetooth is a wireless technology for creating personal networks > + operating in the 2.4 GHz unlicensed band, with a range of 10 meters. > + Networks are usually formed ad-hoc from portable devices like mobile > + phones, handhelds and laptops. Unlike the other popular wireless > + technology, Wi-Fi, Bluetooth offers higher level service profiles, > + e.g. FTP-like file servers, file pushing, voice transport, serial > + line emulation and more. > + > + The Bluetooth stack in FreeBSD is implemented using Netgraph. > + A Broad variety of USB dongles is supported by the &man.ng.ubt.4; driver. > + The 3Com PC Card 3CRWB60-A is supported by the &man.ng.bt3c.4; driver. > + Serial and UART based Bluetooth devices are supported via > + &man.ng.h4.4; and &man.hcseriald.8;. This chapter describes using > + a USB Bluetooth dongle. Bluetooth support is available only on > + FreeBSD 5.0 and newer systems. > + > + > + > + Plugging in the Device > + Device drivers are by default available as kernel modules. > + Before attaching a device, you need to load the driver into the > + kernel: > + > + &prompt.root; kldload ng_ubt > + > + If the Bluetooth device is present in the system during system > + startup, load the module from /boot/loader.conf: > + > + ng_ubt_load="YES" > + > + Plug in your USB dongle. Similar output will appear on the console > + (or in syslog): > + > + ubt0: vendor 0x0a12 product 0x0001, rev 1.10/5.25, addr 2 > +ubt0: Interface 0 endpoints: interrupt=0x81, bulk-in=0x82, bulk-out=0x2 > +ubt0: Interface 1 (alt.config 5) endpoints: isoc-in=0x83, isoc-out=0x3; > + wMaxPacketSize=49; nframes=6, buffer size=294 > + > + Copy /usr/src/share/examples/netgraph/bluetooth/rc.bluetooth > + to some convenient place, like /etc/rc.bluetooth. > + This script is used to start and stop the Bluetooth stack. It is a good idea > + to stop the stack before unplugging the device, but it is not (usually) > + fatal. When starting the stack, you will receive output similar to this: > + > + &prompt.root; /etc/rc.bluetooth start ubt0 > +BD_ADDR: 00:02:72:00:d4:1a > +Features: 0xff 0xff 0xf 00 00 00 00 00 > +<3-Slot> <5-Slot> <Encryption> <Slot offset> > +<Timing accuracy> <Switch> <Hold mode> <Sniff mode> > +<Park mode> <RSSI> <Channel quality> <SCO link> > +<HV2 packets> <HV3 packets> <u-law log> <A-law log> <CVSD> > +<Paging scheme> <Power control> <Transparent SCO data> > +Max. ACL packet size: 192 bytes > +Number of ACL packets: 8 > +Max. SCO packet size: 64 bytes > +Number of SCO packets: 8 > + > + > + > + > + HCI and Inquiry > + > + Now it is time to discover some nearby bluetooth devices. > + Discovering devices and many other interesting tasks is done with > + the &man.hccontrol.8; utility. You will receive a list of discoverable > + devices in a few seconds: > + > + &prompt.user; hccontrol -n ubt0hci inquiry > +Inquiry result, num_responses=1 > +Inquiry result #0 > + BD_ADDR: 00:80:37:29:19:a4 > + Page Scan Rep. Mode: 0x1 > + Page Scan Period Mode: 00 > + Page Scan Mode: 00 > + Class: 52:02:04 > + Clock offset: 0x78ef > +Inquiry complete. Status: No error [00] > + > + BD_ADDR is the unique address of a bluetooth device, similar to MAC > + addresses of network cards. This address is needed for further > + communication with a device. Let us try to read the device's name: > + > + &prompt.user; hccontrol -n ubt0hci remote_name_request 00:80:37:29:19:a4 0 0 0 > +BD_ADDR: 00:80:37:29:19:a4 > +Name: Pav's T39 > + > + If you perform a discovery on a different bluetooth device, it will find > + your computer as your.host.name (ubt0). > + > + You can list active baseband connections: > + > + &prompt.user; hccontrol -n ubt0hci read_connection_list > +Remote BD_ADDR Handle Type Mode Role Encrypt Pending Queue State > +00:80:37:29:19:a4 41 ACL 0 MAST NONE 0 0 OPEN > + > + Handle is useful for manually disconnecting a connection: > + > + &prompt.root; hccontrol -n ubt0hci disconnect 41 > +Connection handle: 41 > +Reason: Connection terminated by local host [0x16] > + > + Refer to hccontrol help for a complete listing of > + available commands. Note that the majority of commands does not require > + superuser privileges. > + > + > + > + > + L2CAP > + > + L2CAP is a higher level of connection in Bluetooth standards. > + A useful command is &man.l2ping.8;, which can be used to ping > + other devices. Some devices might not return all of the data > + send to them, so 0 bytes as in this example > + is a normal state. > + > + &prompt.root; l2ping -a 00:80:37:29:19:a4 > +0 bytes from 0:80:37:29:19:a4 seq_no=0 time=48.633 ms result=0 > +0 bytes from 0:80:37:29:19:a4 seq_no=1 time=37.551 ms result=0 > +0 bytes from 0:80:37:29:19:a4 seq_no=2 time=28.324 ms result=0 > +0 bytes from 0:80:37:29:19:a4 seq_no=3 time=46.150 ms result=0 > + > + The &man.l2control.8; utility is used to configure L2CAP nodes > + and read their state. This example shows file transfer to a Palm > + handheld: > + > + &prompt.user; l2control -a 00:02:72:00:d4:1a read_channel_list > +L2CAP channels: > +Remote BD_ADDR SCID/ DCID PSM IMTU/ OMTU State > +00:07:e0:00:0b:ca 66/ 64 3 132/ 672 OPEN > +&prompt.user; l2control -a 00:02:72:00:d4:1a read_connection_list > +L2CAP connections: > +Remote BD_ADDR Handle Flags Pending State > +00:07:e0:00:0b:ca 41 O 0 OPEN > + > + Another diagnostic tool is &man.btsockstat.1;. It does a similar > + job as &man.netstat.1; does, but for Bluetooth sockets, logical > + connections on top of baseband connections. The example output shows > + the same connection as l2control above: > + > + &prompt.user; btsockstat > +Active L2CAP sockets > +PCB Recv-Q Send-Q Local address/PSM Foreign address CID State > +c2afe900 0 0 00:02:72:00:d4:1a/3 00:07:e0:00:0b:ca 66 OPEN > +Active RFCOMM sessions > +L2PCB PCB Flag MTU Out-Q DLCs State > +c2afe900 c2b53380 1 127 0 Yes OPEN > +Active RFCOMM sockets > +PCB Recv-Q Send-Q Local address Foreign address Chan DLCI State > +c2e8bc80 0 250 00:02:72:00:d4:1a 00:07:e0:00:0b:ca 3 6 OPEN > + > + > + > + > + Pairing of Devices > + > + By default, Bluetooth communication is not authorized and any device > + can talk to any other device. Some devices, like mobile phones, require > + authentication for some functionality, like Internet connections. This > + is done with PIN numbers - you enter the same (up to 16 digits long) > + number on both devices. This operation is called pairing. > + The daemon that answers pairing requests is &man.hcsecd.8;. Copy > + /usr/src/usr.sbin/bluetooth/hcsecd/hcsecd.conf > + to /usr/local/etc and edit it. The following is an > + example section for a mobile phone, with the PIN arbitrarily set to 1234: > + > + device { > + bdaddr 00:80:37:29:19:a4; > + name "Pav's T39"; > + key nokey; > + pin "1234"; > +} > + > + You can choose any PIN you like. Note that some devices, like > + headsets, have a fixed PIN built in. Start hcsecd -d. > + The switch forces the daemon to stay in the > + terminal and not fork to the background, so we can see what is happening. > + Set the remote device to receive pairing and initiate the HCI connection > + to the remote device. The remote device should say that pairing was > + accepted, and let you enter the PIN. Enter the same PIN as you have in your > + hcsecd.conf. Now your PC and remote device are paired. > + Alternatively, you can initiate pairing on the remote device. > + This will appear in the hcsecd output: > + > +hcsecd[16484]: Got Link_Key_Request event from 'ubt0hci', remote bdaddr 0:80:37:29:19:a4 > +hcsecd[16484]: Found matching entry, remote bdaddr 0:80:37:29:19:a4, name 'Pav's T39', link key doesn't exist > +hcsecd[16484]: Sending Link_Key_Negative_Reply to 'ubt0hci' for remote bdaddr 0:80:37:29:19:a4 > +hcsecd[16484]: Got PIN_Code_Request event from 'ubt0hci', remote bdaddr 0:80:37:29:19:a4 > +hcsecd[16484]: Found matching entry, remote bdaddr 0:80:37:29:19:a4, name 'Pav's T39', PIN code exists > +hcsecd[16484]: Sending PIN_Code_Reply to 'ubt0hci' for remote bdaddr 0:80:37:29:19:a4 > + > + > + > + > + Service Discovery Protocol (SDP) > + If you want to know which services a Bluetooth device offers, and > + on which RFCOMM channels, build libbluetooth > + and sdp-1.0rc3 from + url="http://www.geocities.com/m_evmenkin/">Maksim Evmenkin's > + snapshot. Then, run sdptool and > + observe (the output is snipped a bit, as this tool is quite talky): > + > + &prompt.root; sdptool browse 00:80:37:29:19:a4 > +Browsing 00:80:37:29:19:A4 ... > +Service Name: Dial-up Networking > +Protocol Descriptor List: > + "L2CAP" (0x0100) > + "RFCOMM" (0x0003) > + Channel: 1 > + > +Service Name: Fax > +Protocol Descriptor List: > + "L2CAP" (0x0100) > + "RFCOMM" (0x0003) > + Channel: 2 > + > +Service Name: Voice gateway > +Service Class ID List: > + "Headset Audio Gateway" (0x1112) > + "Generic Audio" (0x1203) > +Protocol Descriptor List: > + "L2CAP" (0x0100) > + "RFCOMM" (0x0003) > + Channel: 3 > + > + > + ... and so on. You will need the channel number later for using > + a given service. Some devices do not support browsing, they return > + an empty list, but you can try searching for a specific service. > + > + &prompt.root; sdptool search --bdaddr 00:07:e0:00:0b:ca OPUSH > + > + Offering services on FreeBSD to other devices is done using the > + sdpd server. > + &prompt.root; sdpd > + > + Registering a given Bluetooth service to a RFCOMM channel number: > + &prompt.root; sdptool add --channel=7 LAN > + > + Checking services offered by our computer: > + &prompt.root; sdptool browse ff:ff:ff:00:00:00 > + > + > + > + Dial-up Networking (DUN) and Local Area Network (LAN) > + > + Bluetooth can be used for connecting to the Internet, either over > + PPP (mobile phones) or the local network (access points). The Dial-up Networking > + profile on FreeBSD is implemented with &man.ppp.8; and > + &man.rfcomm.pppd.8;, a wrapper that converts RFCOMM Bluetooth connections > + to something ppp can operate with. Create ppp labels in > + /etc/ppp/ppp.conf, examples from the &man.rfcomm.pppd.8; > + manual page can be used. > + > + Connecting to the Internet through a mobile phone (DUN profile). First, find > + out the correct RFCOMM channel on the remote device using > + sdptool. Then, use &man.rfcomm.pppd.8;: > + > + &prompt.root; rfcomm_pppd -a 00:80:37:29:19:a4 -c -C 1 -l rfcomm-dialup > + > + Running a Bluetooth access point on FreeBSD. First, register a > + RFCOMM channel for LAN service on the local sdpd. > + Then, start the ppp server. Use BD_ADDR of the local Bluetooth device and > + the channel number registered with sdpd. > + > + &prompt.root; rfcomm_pppd -a 00:02:72:00:d4:1a -s -C 7 -l rfcomm-server > + > + > + > + > + OBEX Push (OPUSH) > + OBEX is a widely used protocol for simple file transfers between > + mobile devices. It's main use is in infrared communication, where it is > + used for generic file transfers between notebooks or Palm handhelds, > + and for sending business cards or calendar entries between mobile > + phones and other devices with PIM applications. > + > + The OBEX client is implemented in the > + obexapp utility from + url="http://www.geocities.com/m_evmenkin/">Maksim Evmenkin's > + snapshot. It needs the openobex > + library from same package and the > + devel/glib12 port. Note that > + obexapp does not require root privileges > + to operate. > + > + OBEX client. First, find which channel on the remote device is IrMC > + Synchronization or OBEX Object Push. After that, use > + obexapp. Here is an example session where > + we download a file (device info from a mobile phone) and send > + a file (business card to the phone's directory): > + > + &prompt.user; obexapp -a 00:80:37:29:19:a4 -C 10 > +obex> get > +get: remote file> telecom/devinfo.txt > +get: local file> devinfo-t39.txt > +Success, response: OK, Success (0x20) > +obex> put > +put: local file> new.vcf > +put: remote file> new.vcf > +Success, response: OK, Success (0x20) > +obex> di > +Success, response: OK, Success (0x20) > + > + OBEX server. First, register the OPUSH service with the local > + sdpd. If OPUSH does not work, > + you can try the FTRN service instead. Then, start the OBEX daemon > + using the channel number registered with sdpd: > + > + &prompt.root; obexapp -s -C 10 > + > + Received files will appear in /var/spool/obex. > + This can be overriden with the switch. Make sure > + the directory exists, obexapp will not > + create it. On a typical workstation with a single user it is useful > + to set a default owner of received files. See obexapp(1) > + for details. > + > + > + > + > + Serial Port Profile (SP) > + Bluetooth can be used to emulate serial port connections. > + To connect to a remote device, first locate the RFCOMM channel with the > + Serial Port profile. Then, start the Serial Port Profile Daemon > + &man.rfcomm.sppd.1; with a free pseudo tty: > + > + &prompt.root; rfcomm_sppd -a 00:07:E0:00:0B:CA -c 1 -t /dev/ttyp6 > +rfcomm_sppd[94692]: Starting on /dev/ttyp6... > + > + Now connect this pseudo tty to your actual terminal: > + > + &prompt.root; cu -l ttyp6 > + > + > + > + > + Troubleshooting > + > + > + A remote device cannot connect to us > + Some older devices do not support role switching. By default, > + when FreeBSD is accepting a connection, it tries to switch roles > + to become a master. Devices which do not support this will not > + be able to connect. Role switching is performed when a connection > + is being established, so we cannot ask the remote device if it does > + support role switching. There is a driver option to disable role > + switching on our side: > + &prompt.root; hccontrol -n ubt0hci write_node_role_switch 0 > + > + > + > + Something is going wrong, can I see what exactly is happening? > + Yes, you can. Use the hcidump tool > + from Maksim Evmenkin's > + snapshot, which works much like &man.tcpdump.1;. You can > + use it to display the content of Bluetooth packets on the terminal > + and to record Bluetooth communication for later analyzation. > + > + > + > + > + > + > > >