From owner-freebsd-doc@FreeBSD.ORG Sun Jul 11 04:12:13 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 559E416A4D0; Sun, 11 Jul 2004 04:12:13 +0000 (GMT) Date: Sun, 11 Jul 2004 04:12:13 +0000 From: Murray Stokely To: doc@freebsd.org Message-ID: <20040711041213.GC72884@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: Seeking new members for doceng@ 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, 11 Jul 2004 04:12:13 -0000 If you are interested in possibly joining the doceng@ team, then please email doceng@freebsd.org with information about your current projects and your views about the future of FreeBSD Documentation. The doceng@ team is a body that was setup to handle some of the meta-project issues associated with the doc project. Responsibilities include granting approval for new doc/ and www/ committers, maintaining the doc project primer, which documents the best practices for the FDP, and other tasks described in our charter: http://www.freebsd.org/internal/doceng.html There is probably room for about 2 additional members on the team right now. If you are interested in joining the team please mail doceng@ within the next 7 days. In 2 weeks we will announce the new member(s). Thanks, - Murray / the DocEng team. From owner-freebsd-doc@FreeBSD.ORG Sun Jul 11 13:56:32 2004 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 7A20B16A4CE for ; Sun, 11 Jul 2004 13:56:32 +0000 (GMT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 339B443D54 for ; Sun, 11 Jul 2004 13:56:32 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p46151-adsao12honb4-acca.tokyo.ocn.ne.jp [220.96.128.151]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id 2BF712550 for ; Sun, 11 Jul 2004 22:56:31 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) by delta.allbsd.org (8.12.9p2/8.12.9) with ESMTP id i6BDuJA2089766 for ; Sun, 11 Jul 2004 22:56:20 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Sun, 11 Jul 2004 22:55:34 +0900 (JST) Message-Id: <20040711.225534.98614992.hrs@eos.ocn.ne.jp> To: doc@FreeBSD.org From: Hiroki Sato X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 4.0.65 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart0(Sun_Jul_11_22_55_34_2004_030)--" Content-Transfer-Encoding: 7bit Subject: doc build with AFPL Ghostscript 8.14 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, 11 Jul 2004 13:56:32 -0000 ----Security_Multipart0(Sun_Jul_11_22_55_34_2004_030)-- Content-Type: Multipart/Mixed; boundary="--Next_Part(Sun_Jul_11_22_55_34_2004_283)--" Content-Transfer-Encoding: 7bit ----Next_Part(Sun_Jul_11_22_55_34_2004_283)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi, I made a patch to solve a doc build problem when AFPL Ghostscript 8.14 is used. This patch should be compatible with both of GNU Ghostscript 7.07, which the docproj port depends on via graphics/peps, and gs 8.14. The problem was that graphics/peps cannot be used with gs 8.14. After applying this patch, peps is no longer used. Comments? If there is no objection, I think I will commit this with some additional comments in doc.images.mk. -- | Hiroki SATO ----Next_Part(Sun_Jul_11_22_55_34_2004_283)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="docepsgeom.diff" Index: share/mk/doc.images.mk =================================================================== RCS file: /home/ncvs/doc/share/mk/doc.images.mk,v retrieving revision 1.27 diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFly:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.27 doc.images.mk --- share/mk/doc.images.mk 5 Apr 2004 22:53:43 -0000 1.27 +++ share/mk/doc.images.mk 11 Jul 2004 13:26:56 -0000 @@ -122,7 +122,7 @@ # low for the typical monitor in use today. The resolution of 100 looks # much better on these monitors without making the image too large for # a 640x480 monitor. -EPS2PNG_RES?= 100 +EPS2PNM_RES?= 100 # We need to list ${_IMAGES_PNG} here since the images might be in a # shared image directory. @@ -133,8 +133,14 @@ SCR2TXT?= ${PREFIX}/bin/scr2txt SCR2TXTOPTS?= -l ${SCR2TXTFLAGS} SED?= /usr/bin/sed -EPS2PNG?= ${PREFIX}/bin/peps -EPS2PNGOPTS?= -p -r ${EPS2PNG_RES} ${EPS2PNGFLAGS} +EPS2PNM?= ${PREFIX}/bin/gs +EPS2PNMOPTS?= -q -dBATCH -dGraphicsAlphaBits=4 -dTextAlphaBits=4 \ + -dEPSCrop -r${EPS2PNM_RES}x${EPS2PNM_RES} \ + -dNOPAUSE -dSAFER -sDEVICE=pnm -sOutputFile=- +EPSGEOM?= ${PERL} ${DOC_PREFIX}/share/mk/epsgeom +EPSGEOMOPTS?= ${EPS2PNM_RES} ${EPS2PNM_RES} +PNMTOPNG?= ${PREFIX}/bin/pnmtopng +PNMTOPNGOPTS?= ${PNGTOPNGFLAGS} PNGTOPNM?= ${PREFIX}/bin/pngtopnm PNGTOPNMOPTS?= ${PNGTOPNMFLAGS} PPMTOPGM?= ${PREFIX}/bin/ppmtopgm @@ -153,6 +159,13 @@ # SETENV?= /usr/bin/env REALPATH?= /bin/realpath +.if exists(/usr/bin/perl) +PERL?= /usr/bin/perl +.elif exists(/usr/local/bin/perl) +PERL?= /usr/local/bin/perl +.else +PERL?= perl +.endif # Use suffix rules to convert .scr files to other formats .SUFFIXES: .scr .pic .png .ps .eps .txt @@ -184,8 +197,10 @@ # relative path when the arguments are passed by peps; realpath will # correct the problem. .pic.png: ${.TARGET:S/.png$/.eps/} - ${EPS2PNG} ${EPS2PNGOPTS} -o ${.TARGET} \ - `${REALPATH} ${.TARGET:S/.png$/.eps/}` + ${EPSGEOM} -offset ${EPSGEOMOPTS} ${.TARGET:S/.png$/.eps/} \ + | ${EPS2PNM} ${EPS2PNMOPTS} \ + -g`${EPSGEOM} -geom ${EPSGEOMOPTS} ${.TARGET:S/.png$/.eps/}` - \ + | ${PNMTOPNG} > ${.TARGET} .pic.ps: ${PIC2PS} ${.ALLSRC} > ${.TARGET} @@ -198,18 +213,20 @@ # bounding box. .ps.eps: ${SETENV} outfile=${.TARGET} ${PS2EPS} ${PS2EPSOPTS} < ${.ALLSRC} 1>&2 - echo "save countdictstack mark newpath /showpage {} def /setpagedevice {pop} def" >> ${.TARGET} - echo "%%EndProlog" >> ${.TARGET} - echo "%%Page: 1 1" >> ${.TARGET} - echo "%%BeginDocument: ${.ALLSRC}" >> ${.TARGET} + (echo "save countdictstack mark newpath /showpage {} def /setpagedevice {pop} def";\ + echo "%%EndProlog";\ + echo "%%Page: 1 1";\ + echo "%%BeginDocument: ${.ALLSRC}";\ + ) >> ${.TARGET} ${SED} -e '/^%%BeginPreview:/,/^%%EndPreview[^!-~]*$$/d' \ -e '/^%!PS-Adobe/d' \ -e '/^%%[A-Za-z][A-Za-z]*[^!-~]*$$/d'\ -e '/^%%[A-Za-z][A-Za-z]*: /d' < ${.ALLSRC} >> ${.TARGET} - echo "%%EndDocument" >> ${.TARGET} - echo "%%Trailer" >> ${.TARGET} - echo "cleartomark countdictstack exch sub { end } repeat restore" >> ${.TARGET} - echo "%%EOF" >> ${.TARGET} + (echo "%%EndDocument";\ + echo "%%Trailer";\ + echo "cleartomark countdictstack exch sub { end } repeat restore";\ + echo "%%EOF";\ + ) >> ${.TARGET} # We can't use suffix rules to generate the rules to convert EPS to PNG and # PNG to EPS. This is because a .png file can depend on a .eps file, and @@ -218,7 +235,10 @@ .for _curimage in ${IMAGES_GEN_PNG} ${_curimage}: ${_curimage:S/.png$/.eps/} - ${EPS2PNG} ${EPS2PNGOPTS} -o ${.TARGET} `${REALPATH} ${.ALLSRC}` + ${EPSGEOM} -offset ${EPSGEOMOPTS} ${.ALLSRC} \ + | ${EPS2PNM} ${EPS2PNMOPTS} \ + -g`${EPSGEOM} -geom ${EPSGEOMOPTS} ${.ALLSRC}` - \ + | ${PNMTOPNG} > ${.TARGET} .endfor .for _curimage in ${IMAGES_GEN_EPS} Index: share/mk/epsgeom =================================================================== RCS file: share/mk/epsgeom diff -N share/mk/epsgeom --- /dev/null 1 Jan 1970 00:00:00 -0000 +++ share/mk/epsgeom 11 Jul 2004 13:27:58 -0000 @@ -0,0 +1,81 @@ +#!/usr/bin/perl -w +# $FreeBSD$ +# +# epsgeom - extract geometry from a EPS file. +# + +my $x; +my $y; +my $width; +my $height; + +my $gx; +my $gy; + +if (@ARGV != 4) { + die "Error: invalid arguments.\n"; +} + +my $mode = shift @ARGV; +my $hres = shift @ARGV; +my $vres = shift @ARGV; +my $file = shift @ARGV; + +my $realfile = `realpath ${file}`; +chomp $realfile; + +open IN, "<$realfile" or die "Error: cannot open $realfile.\n"; +while() { + if (($x,$y,$width,$height) = + /^%%BoundingBox:\s+([-\d]+)\s+([-\d]+)\s+([-\d]+)\s+([-\d]+)/) { + last; + } + #print STDERR "DEBUG: $_"; +} +close IN; + +if (not defined($x)) { + die "Error: no BoundingBox found.\n"; +} + +$width -= $x; +$height -= $y; + +# (int)(((double)hres * (double)width / 72.0) + 0.5), +$gx = $hres * $width / 72.0 + 0.5; +# (int)(((double)vres * (double)height / 72.0) + 0.5), +$gy = $vres * $height / 72.0 + 0.5; + +my %replace = ( + '@X@' => int $x, + '@Y@' => int $y, + '@MX@' => int -$x, + '@MY@' => int -$y, + '@WIDTH@' => int $width, + '@MWIDTH@' => int -$width, + '@HEIGHT@' => int $height, + '@MHEIGHT@' => int -$height, + '@ANGLE@' => int 0, + '@INPUT@' => $realfile, + ); + +if ($mode eq "-replace") { + foreach my $i (keys %replace) { + printf "-e s,%s,%s,g ", $i, $replace{$i}; + } +} elsif ($mode eq "-offset") { + #print STDERR "DEBUG: (int -$x), $y\n"; + printf "<< /PageOffset [%d %d] >> setpagedevice\n", (int -$x), $y; + open IN, "<$realfile" or die "Error: cannot open $realfile.\n"; + print while(); + close IN; + print "\n"; + print "showpage\n"; +} elsif ($mode eq "-geom") { + #print STDERR "DEBUG: $x,$y,$width,$height\n"; + printf "%dx%d", $gx, $gy; +} else { + die "Error: invalid mode specified.\n"; +} + +__END__ ----Next_Part(Sun_Jul_11_22_55_34_2004_283)---- ----Security_Multipart0(Sun_Jul_11_22_55_34_2004_030)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQBA8UbWTyzT2CeTzy0RAiQTAJ9bN12lBx1mhIeHyOneCYLO02ImtgCgnjGp pP6uHc/50gDgnxm3zSE+cxA= =HUCO -----END PGP SIGNATURE----- ----Security_Multipart0(Sun_Jul_11_22_55_34_2004_030)---- From owner-freebsd-doc@FreeBSD.ORG Sun Jul 11 23:41:28 2004 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 EE19116A4CE; Sun, 11 Jul 2004 23:41:28 +0000 (GMT) Received: from vader.aacc.edu (vader.aacc.edu [12.167.138.28]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5E2CF43D2F; Sun, 11 Jul 2004 23:41:28 +0000 (GMT) (envelope-from fox@vader.aacc.cc.md.us) Received: from vader.aacc.edu (IDENT:V9dRG+wzLv58EKoruGVX9LIctbNUQboJ@localhost [127.0.0.1]) by vader.aacc.edu (8.12.8/8.12.8) with ESMTP id i6BNfMuU019411; Sun, 11 Jul 2004 19:41:22 -0400 Received: from localhost (fox@localhost) by vader.aacc.edu (8.12.8/8.12.8/Submit) with ESMTP id i6BNfMgc019407; Sun, 11 Jul 2004 19:41:22 -0400 X-Authentication-Warning: vader.aacc.edu: fox owned process doing -bs Date: Sun, 11 Jul 2004 19:41:22 -0400 (EDT) From: fox@vader.aacc.cc.md.us X-X-Sender: fox@vader.aacc.edu To: Giorgos Keramidas In-Reply-To: <200407072139.i67LdDRH095078@freefall.freebsd.org> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: freebsd-doc@FreeBSD.org Subject: Re: docs/66824: [patch] share/man/man4/man4.i386/fe.4 grammar, and 2 questions 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, 11 Jul 2004 23:41:29 -0000 On Wed, 7 Jul 2004, Giorgos Keramidas wrote: > Synopsis: [patch] share/man/man4/man4.i386/fe.4 grammar, and 2 questions > > http://www.freebsd.org/cgi/query-pr.cgi?pr=66824 Quoting from your patch: > @@ -303,8 +303,8 @@ against the mbuf cluster allocation poli > The unnecessarily allocated clusters are freed within short lifetime, > and it will not affect long term kernel memory usage. > .Pp > -Although XNS and IPX supports are included in the driver, > -they are never be tested and must have a lot of bugs. > +Although XNS and IPX supports is included in the driver, s/supports/support/ > +it has never been tested and it is expected to have a lot of bugs. > .Sh AUTHORS, COPYRIGHT AND DISCLAIMER > The > .Nm -- "I'd ask if you'd found the right sort of isolated wasteland for your citadel of dread yet, but that would be a silly question; you're in Utah, after all." --ESR to Darl McBride (Chief Excessive Ossifier of Squandered Clues Obstination), in http://www.catb.org/~esr/writings/mcbride.html From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 08:27:20 2004 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 B6A5616A4CE; Mon, 12 Jul 2004 08:27:20 +0000 (GMT) Received: from eddie.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2A3FD43D2D; Mon, 12 Jul 2004 08:27:20 +0000 (GMT) (envelope-from simon@eddie.nitro.dk) Received: by eddie.nitro.dk (Postfix, from userid 1000) id 66E9511811; Mon, 12 Jul 2004 10:27:03 +0200 (CEST) Date: Mon, 12 Jul 2004 10:27:03 +0200 From: "Simon L. Nielsen" To: Hiroki Sato Message-ID: <20040712082702.GA74317@eddie.nitro.dk> References: <20040711.225534.98614992.hrs@eos.ocn.ne.jp> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="+QahgC5+KEYLbs62" Content-Disposition: inline In-Reply-To: <20040711.225534.98614992.hrs@eos.ocn.ne.jp> User-Agent: Mutt/1.5.6i cc: doc@FreeBSD.org Subject: Re: doc build with AFPL Ghostscript 8.14 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, 12 Jul 2004 08:27:20 -0000 --+QahgC5+KEYLbs62 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.11 22:55:34 +0900, Hiroki Sato wrote: > I made a patch to solve a doc build problem when AFPL Ghostscript 8.14 > is used. This patch should be compatible with both of GNU Ghostscript > 7.07, which the docproj port depends on via graphics/peps, and gs 8.14. > The problem was that graphics/peps cannot be used with gs 8.14. After > applying this patch, peps is no longer used. >=20 > Comments? If there is no objection, I think I will commit this > with some additional comments in doc.images.mk. "Go for it" (R)/(tm)/(c) ;-) I did a quick test and it seemed to work fine. > 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.27 > diff -d -u -I\$FreeBSD:.*\$ -I\$NetBSD:.*\$ -I\$OpenBSD:.*\$ -I\$DragonFl= y:.*\$ -I\$Id:.*\$ -I\$hrs:.*\$ -r1.27 doc.images.mk > +.if exists(/usr/bin/perl) > +PERL?=3D /usr/bin/perl > +.elif exists(/usr/local/bin/perl) > +PERL?=3D /usr/local/bin/perl > +.else > +PERL?=3D perl > +.endif How about moving this part to doc.project.mk ? I also need a definition of PERL for the Hardware Notes and if PERL is in doc.project.mk it's available in all doc related makefiles. > Index: share/mk/epsgeom > =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: share/mk/epsgeom > diff -N share/mk/epsgeom > --- /dev/null 1 Jan 1970 00:00:00 -0000 > +++ share/mk/epsgeom 11 Jul 2004 13:27:58 -0000 > @@ -0,0 +1,81 @@ > +#!/usr/bin/perl -w > +# $FreeBSD$ > +# > +# epsgeom - extract geometry from a EPS file. > +# How about adding some sort of copyright statement? --=20 Simon L. Nielsen FreeBSD Documentation Team --+QahgC5+KEYLbs62 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA8ktWh9pcDSc1mlERAtgLAJ9owUSCjrORPONWGuLTe8vlID0+KgCcCQVc Ot1hlQs67satVehNI43a7a4= =xVmY -----END PGP SIGNATURE----- --+QahgC5+KEYLbs62-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 10:02:56 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id B3C2216A4CF; Mon, 12 Jul 2004 10:02:56 +0000 (GMT) Date: Mon, 12 Jul 2004 10:02:56 +0000 From: Murray Stokely To: doc@freebsd.org Message-ID: <20040712100256.GB3948@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: doceng@freebsd.org Subject: [REVIEW] Split of Advanced Networking chapter of Handbook 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, 12 Jul 2004 10:02:56 -0000 The Advanced Networking chapter of the Handbook is almost 100 pages and is certainly too unwieldy in it's current form. I would like to split out the network server configuration sections into a separate chapter called 'Network Servers'. The new chapter would contain the sections on NFS, NIS/YP, DHCP, DNS, NTP, and inetd. The Advanced Networking chapter would still contain the information about routing, wireless networks, natd, and other topics that it currently contains. You can see the built output of my proposal here : http://people.freebsd.org/~murray/handbook/ Or you can examine the diff here : http://people.freebsd.org/~murray/patches/handbook.diff I would move the inetd section to the front of the network servers chapter, and add an introductory section about network services. I would also update the preface. Please let me know if anyone has any comments or objections. Otherwise, I would like to make this change later this week. - Murray From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 10:30:52 2004 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 6661416A4CE; Mon, 12 Jul 2004 10:30:52 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4F93E43D49; Mon, 12 Jul 2004 10:30:51 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6CAUntG065594; Mon, 12 Jul 2004 12:30:49 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6CAUnNh065593; Mon, 12 Jul 2004 12:30:49 +0200 (CEST) (envelope-from marc) Date: Mon, 12 Jul 2004 12:30:49 +0200 From: Marc Fonvieille To: Murray Stokely Message-ID: <20040712103049.GA63594@abigail.blackend.org> References: <20040712100256.GB3948@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040712100256.GB3948@hub.freebsd.org> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: doceng@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: [REVIEW] Split of Advanced Networking chapter of Handbook 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, 12 Jul 2004 10:30:52 -0000 On Mon, Jul 12, 2004 at 10:02:56AM +0000, Murray Stokely wrote: [...] > > You can see the built output of my proposal here : > > http://people.freebsd.org/~murray/handbook/ > Images do not appear, but I assume it's just cause you do not used a complete tree. > Or you can examine the diff here : > > http://people.freebsd.org/~murray/patches/handbook.diff > > I would move the inetd section to the front of the network servers > chapter, and add an introductory section about network services. I > would also update the preface. > > Please let me know if anyone has any comments or objections. > Otherwise, I would like to make this change later this week. > It's Ok for me :) Marc From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 11:03:08 2004 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 02A5816A4CE for ; Mon, 12 Jul 2004 11:03:08 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id EE1CF43D31 for ; Mon, 12 Jul 2004 11:03:07 +0000 (GMT) (envelope-from owner-bugmaster@freebsd.org) Received: from freefall.freebsd.org (peter@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6CB37YY089319 for ; Mon, 12 Jul 2004 11:03:07 GMT (envelope-from owner-bugmaster@freebsd.org) Received: (from peter@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6CB35Xs089313 for freebsd-doc@freebsd.org; Mon, 12 Jul 2004 11:03:05 GMT (envelope-from owner-bugmaster@freebsd.org) Date: Mon, 12 Jul 2004 11:03:05 GMT Message-Id: <200407121103.i6CB35Xs089313@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, 12 Jul 2004 11:03:08 -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 Serious problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- s [1999/10/04] i386/14135 doc lpt1 nolonger exists after 3.2-RELEASE s [2000/07/19] docs/20028 doc ASCII docs should reflect tags o [2001/05/24] docs/27605 doc Cross-document references () 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/14] docs/42762 doc ppp.8 has no description of $env and ~use o [2002/11/15] docs/45303 doc Bug in PDF DocBook rendering o [2003/11/22] docs/59587 doc rewriting examples (part of documentation o [2003/12/29] docs/60679 doc pthreads documentation does not describe o [2004/01/19] docs/61558 doc New SMC 2602W cards, using the ADM8211, a o [2004/01/20] docs/61605 doc Improve documentation for i386 disk geome o [2004/02/10] docs/62665 doc setting up X display subsystem function i o [2004/03/10] docs/64063 doc Size of block in File System Quota docume 13 problems total. Non-critical problems S Submitted Tracker Resp. Description ------------------------------------------------------------------------------- o [2001/02/02] 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 p [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 [2002/01/05] docs/33589 doc Patch to doc.docbook.mk to post process . o [2002/01/14] 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- 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/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/35648 doc rc.conf; add note about "flags" to both f 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/16] docs/35943 doc at(1) config files are misplaced in /var/ o [2002/03/16] docs/35953 doc hosts.equiv(5) manual is confusing or wro o [2002/03/28] docs/36432 doc Proposal for doc/share/mk: make folded bo o [2002/03/29] docs/36449 doc symlink(7) manual doesn't mention trailin 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 p [2002/06/08] docs/39044 doc The man page for rot13(6) never mentions o [2002/06/13] 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/25] docs/39824 doc Various tweaks for doc/en_US.ISO8859-1/bo o [2002/07/10] docs/40423 doc Keyboard(4)'s definition of parameters to o [2002/07/11] 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/08/02] docs/41270 doc confusing directions for kernelconfig cha o [2002/08/19] docs/41791 doc Documentation formatting error o [2002/08/20] docs/41807 doc natd -punch_fw "bug" o [2002/08/20] docs/41820 doc Device driver confusion in Handbook (2.3) a [2002/08/27] docs/42058 doc Documentation: Installing Oracle 8i onto 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 o [2002/10/11] docs/43941 doc Rationale for Upgrade Sequence o [2002/10/15] docs/44074 doc ln(1) manual clarifications [patch] 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/12/02] docs/45940 doc burncd missing info o [2002/12/11] docs/46196 doc Missing return value in (set_)menu_format 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/03] docs/46709 doc tables in terminfo.5 are broken o [2003/01/06] docs/46793 doc DEVICE_POLLING can not be used with SMP, o [2003/01/28] 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/31] docs/47705 doc wc(1) manpage has poor explanations. f [2003/02/02] docs/47818 doc ln(1) manpage is confusing f [2003/02/07] docs/48038 doc [PATCH] add Tips and Tricks section into 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/23] docs/50211 doc [PATCH] Fix textfile creation o [2003/04/03] docs/50573 doc return values for res_query/res_search/re o [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/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/11] docs/52071 doc [PATCH] Add more information about soft u o [2003/05/25] docs/52672 doc Porter's Handbook: couple of corrections o [2003/06/13] docs/53303 doc mount(2) man page error o [2003/06/21] docs/53575 doc Change to Handbook Section 20.9 o [2003/06/21] docs/53596 doc Updates to mt manual page o [2003/06/25] docs/53732 doc quota output and man page do not document o [2003/07/08] docs/54229 doc Complete "See also" section for getipnode o [2003/07/11] docs/54391 doc Document that glob(3) respects LC_COLLATE o [2003/07/13] i386/54451 doc [patch] i386_{get|set}_ldt manual page is o [2003/07/26] docs/54879 doc man 1 jot, -r description o [2003/07/28] docs/54999 doc Documentation Project Primer doesn't conf o [2003/08/12] docs/55482 doc DUMP has access to block devices in a JAI o [2003/08/17] docs/55653 doc chflags.1 - note that not all tools chfla o [2003/09/18] docs/56981 doc man terminfo(5) from libncurses does not o [2003/09/24] docs/57153 doc S_IRWXU missing in fstat(2) man page? o [2003/09/30] docs/57388 doc INSTALL.TXT enhancement: mention ok promp o [2003/10/04] docs/57569 doc error on gensetdefs(8) man page o [2003/10/13] docs/57926 doc amd.conf.5 poorly format as it has both m o [2003/10/13] docs/57974 doc man page apropos for select macros (FD_SE o [2003/10/13] docs/57978 doc Type miss of GPIB in Hardware Notes o [2003/10/16] docs/58111 doc Handbook 12.4.3 Rebuilding ATA RAID1 Arra o [2003/10/28] docs/58615 doc update for Vinum chapter of Handbook: des o [2003/10/30] docs/58710 doc killpg(2) contains an error regarding sen o [2003/11/07] docs/59044 doc doc.docbook.mk does not properly handle a o [2003/11/19] docs/59477 doc Outdated Info Documents at http://docs.fr o [2003/11/21] docs/59565 doc [PATCH] FAQ doesn't cover definition of g o [2003/11/24] docs/59649 doc Outdated 4.4BSD Documents at http://docs. o [2003/11/30] docs/59835 doc ipfw(8) man page does not warn about acce o [2003/12/23] docs/60529 doc resolver(5) man page is badly out of date o [2003/12/24] docs/60544 doc getenv(3) manpage doesn't state the retur o [2004/01/08] docs/61070 doc Installation docs misleading: PResizer i o [2004/01/13] docs/61301 doc [patch] Manpage patch for aue(4) to enabl o [2004/01/20] docs/61624 doc Missing page numbers in pdf version of Ha o [2004/01/21] docs/61667 doc Obsolete documentation on FreeBSD PnP o [2004/01/25] docs/61859 doc Incorrect informaiton about trace command o [2004/01/25] docs/61878 doc LSI megaraid 150-x cards not included in o [2004/02/04] docs/62364 doc Misleading information in the handbook o [2004/02/05] docs/62402 doc easily circumventable Blade150 problem o [2004/02/06] docs/62412 doc one of the diskless boot methods describe o [2004/02/12] docs/62719 doc cross-reference pccardd and devd o [2004/02/12] docs/62724 doc host(1) manpage does not include informat o [2004/02/16] docs/62914 doc Reference development(7) in other parts o o [2004/02/22] docs/63215 doc Wrong prototypes in mi_switch(9) (ref doc o [2004/03/03] docs/63676 doc [patch] Fix some tag errors. o [2004/03/03] docs/63719 doc lptcontrol(8) manpage omits -s from a lis o [2004/03/05] docs/63808 doc No manpage for devfs.conf f [2004/03/16] docs/64342 doc Assumed content of PATH is not defined in o [2004/03/27] docs/64807 doc Handbook section on NAT incomplete o [2004/04/02] docs/65065 doc improper language ntpd man pages o [2004/04/10] docs/65400 doc make.1: better wording in BUGS section o [2004/04/13] docs/65477 doc Installation Instruction fail to mention o [2004/04/14] docs/65530 doc minor improvement to getgrent.3 o [2004/04/15] docs/65570 doc documented -C option not available in mak o [2004/04/22] docs/65895 doc incorrect "omshell" link in "dhclient" ma o [2004/04/26] docs/65988 doc incorrect references to ppp.conf in handb o [2004/04/29] docs/66091 doc ppp(8) docs out-of-date for -CURRENT o [2004/05/04] docs/66264 doc [patch] libexec/rtld/rtld.1 typo fixes no o [2004/05/04] docs/66265 doc [patch] Document what -f and LD_TRACE_LOA o [2004/05/05] docs/66296 doc [patch] contrib/amd/amq/amq.8 uses log_op o [2004/05/07] docs/66343 doc unlisted supported card on man page for w o [2004/05/09] docs/66426 doc handbook update (desktop section): web br o [2004/05/10] docs/66483 doc [patch] share/man/man4/csa.4 grammar nits o [2004/05/11] docs/66539 doc [patch] share/man/man4/netgraph.4 inconsi o [2004/05/12] docs/66574 doc [patch] MFC share/man/man4/ng_iface.4 1.1 o [2004/05/12] docs/66575 doc [patch] MFC share/man/man4/ng_ksocket.4 v o [2004/05/13] docs/66621 doc Document fix for "kmem_map too small pani o [2004/05/17] docs/66764 doc [patch] 4_RELENG share/man/man4/ng_one2ma o [2004/05/17] docs/66768 doc 4_RELENG share/man/man4/ng_one2many.4 MFC o [2004/05/17] docs/66770 doc [patch] share/man/man4/ng_pppoe.4 tyops, o [2004/05/17] docs/66771 doc [patch] usr.sbin/pccard/pccardc/pccardc.8 o [2004/05/17] docs/66775 doc Clarification that port names should not o [2004/05/18] docs/66826 doc [patch] RELENG_4 share/man/man4/man4.i386 o [2004/05/18] docs/66827 doc [patch] usr.sbin/usbd/usbd.conf.5 bad com o [2004/05/18] docs/66828 doc [patch] /usr/src/sys/conf/NOTES spelling o [2004/05/23] docs/67078 doc [patch] MFC of a rtld(1) man page is inco o [2004/06/10] docs/67806 doc Let 5.x users know how to boot into singl o [2004/06/13] docs/67893 doc boot.8's -m description is insufficient. o [2004/06/19] docs/68115 doc ISO-IMAGES-i386/README.TXT - cdrecord is o [2004/06/22] docs/68201 doc [patch] pthread_atfork(3) man page o [2004/06/28] docs/68449 doc [patch] src/lib/libstand/libstand.3 nits o [2004/06/28] docs/68453 doc [patch] rc.subr.8 o [2004/07/02] docs/68595 doc [PATCH] add FAQ entry for lock order reve o [2004/07/02] docs/68606 doc Porter's Handbook: document how to write o [2004/07/07] docs/68746 doc Virtual hosts documentaion doesn't make c o [2004/07/09] docs/68843 doc Dates on rc.subr(8) & rc(8) are whack. o [2004/07/09] docs/68845 doc The .At macro produces unexpected results 159 problems total. From owner-freebsd-doc@FreeBSD.ORG Sun Jul 11 17:28:32 2004 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 A882816A4CE for ; Sun, 11 Jul 2004 17:28:32 +0000 (GMT) Received: from partners.100mwh.com (partners.100mwh.com [209.151.94.17]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7F54643D1D for ; Sun, 11 Jul 2004 17:28:32 +0000 (GMT) (envelope-from cchandler@websteria.com) Received: from rdu25-15-203.nc.rr.com ([24.25.15.203] helo=CraigPC) by partners.100mwh.com with asmtp (Exim 4.34) id 1Bji7g-0008FY-KK for doc@FreeBSD.org; Sun, 11 Jul 2004 11:28:20 -0600 From: "Craig M. Chandler" To: Date: Sun, 11 Jul 2004 10:55:23 -0400 Message-ID: <000001c4676e$cd9a4700$6400a8c0@CraigPC> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook CWS, Build 9.0.2416 (9.0.2911.0) Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1409 X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - partners.100mwh.com X-AntiAbuse: Original Domain - freebsd.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - websteria.com X-Source: X-Source-Args: X-Source-Dir: X-Mailman-Approved-At: Mon, 12 Jul 2004 12:10:35 +0000 Subject: compusa no longer selling freebsd 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, 11 Jul 2004 17:28:32 -0000 I did a search on BSD and freebsd and only came up with Mac OS X or some motherboards. Just thought you'd like to know and either change your web page or get them to sell it. I think you can get it off Amazon.com (and set up an affiliate program, so you get a percentage of the sale, when people click through!) -Craig ____________________________ Craig M. Chandler Websteria - Computer Consulting & Web Design cchandler@websteria.com From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 12:22:48 2004 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 20FC216A4CE for ; Mon, 12 Jul 2004 12:22:48 +0000 (GMT) Received: from brain.otenet.gr (brain.otenet.gr [195.170.0.25]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0E1FE43D48 for ; Mon, 12 Jul 2004 12:21:32 +0000 (GMT) (envelope-from keramida@ceid.upatras.gr) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226])i6CCKIT5016759; Mon, 12 Jul 2004 15:21:28 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) i6CCLNB9004160; Mon, 12 Jul 2004 15:22:44 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Received: (from keramida@localhost)i6CCKR5n004145; Mon, 12 Jul 2004 15:20:27 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Mon, 12 Jul 2004 15:20:26 +0300 From: Giorgos Keramidas To: fox@vader.aacc.cc.md.us Message-ID: <20040712122026.GA3999@orion.daedalusnetworks.priv> References: <200407072139.i67LdDRH095078@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: cc: doc@freebsd.org Subject: Re: docs/66824: [patch] share/man/man4/man4.i386/fe.4 grammar, and 2 questions 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, 12 Jul 2004 12:22:48 -0000 On 2004-07-11 19:41, fox@vader.aacc.cc.md.us wrote: > On Wed, 7 Jul 2004, Giorgos Keramidas wrote: > > Synopsis: [patch] share/man/man4/man4.i386/fe.4 grammar, and 2 questions > > > > http://www.freebsd.org/cgi/query-pr.cgi?pr=66824 > > Quoting from your patch: > > > -Although XNS and IPX supports are included in the driver, > > -they are never be tested and must have a lot of bugs. > > +Although XNS and IPX supports is included in the driver, > > s/supports/support/ Committed, thanks for catching this typo :) From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 16:34:53 2004 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 556E316A4CE; Mon, 12 Jul 2004 16:34:53 +0000 (GMT) Received: from smtp.eos.ocn.ne.jp (eos.ocn.ne.jp [211.6.83.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 25F3243D1D; Mon, 12 Jul 2004 16:34:53 +0000 (GMT) (envelope-from hrs@FreeBSD.org) Received: from delta.allbsd.org (p46151-adsao12honb4-acca.tokyo.ocn.ne.jp [220.96.128.151]) by smtp.eos.ocn.ne.jp (Postfix) with ESMTP id 19262BFF; Tue, 13 Jul 2004 01:34:52 +0900 (JST) Received: from localhost (alph.allbsd.org [192.168.0.10]) by delta.allbsd.org (8.12.9p2/8.12.9) with ESMTP id i6CGYIA2095825; Tue, 13 Jul 2004 01:34:19 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Tue, 13 Jul 2004 01:32:06 +0900 (JST) Message-Id: <20040713.013206.07630638.hrs@eos.ocn.ne.jp> To: murray@FreeBSD.org From: Hiroki Sato In-Reply-To: <20040712103049.GA63594@abigail.blackend.org> References: <20040712100256.GB3948@hub.freebsd.org> <20040712103049.GA63594@abigail.blackend.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 4.0.65 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Tue_Jul_13_01_32_06_2004_946)--" Content-Transfer-Encoding: 7bit cc: doceng@FreeBSD.org cc: doc@FreeBSD.org cc: blackend@FreeBSD.org Subject: Re: [REVIEW] Split of Advanced Networking chapter of Handbook 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, 12 Jul 2004 16:34:53 -0000 ----Security_Multipart(Tue_Jul_13_01_32_06_2004_946)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Marc Fonvieille wrote in <20040712103049.GA63594@abigail.blackend.org>: blackend> On Mon, Jul 12, 2004 at 10:02:56AM +0000, Murray Stokely wrote: blackend> > Please let me know if anyone has any comments or objections. blackend> > Otherwise, I would like to make this change later this week. blackend> > blackend> blackend> It's Ok for me :) Sounds good to me, too ;) -- | Hiroki SATO ----Security_Multipart(Tue_Jul_13_01_32_06_2004_946)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQBA8r0ITyzT2CeTzy0RAqMXAJ4qBsFrNjjcbj32IwrEr8uSqKcIPwCgxX64 CCNF5rImWpH7H/pigV8hJs4= =6zwx -----END PGP SIGNATURE----- ----Security_Multipart(Tue_Jul_13_01_32_06_2004_946)---- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 16:53:41 2004 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 709A416A4D2 for ; Mon, 12 Jul 2004 16:53:41 +0000 (GMT) Received: from eborcom.com (dsl-62-3-122-102.zen.co.uk [62.3.122.102]) by mx1.FreeBSD.org (Postfix) with SMTP id 3277643D49 for ; Mon, 12 Jul 2004 16:53:40 +0000 (GMT) (envelope-from tom@FreeBSD.org) Received: (qmail 16402 invoked by uid 1001); 12 Jul 2004 16:53:38 -0000 Date: Mon, 12 Jul 2004 17:53:38 +0100 From: Tom Hukins To: Murray Stokely Message-ID: <20040712165338.GA16218@eborcom.com> Mail-Followup-To: Tom Hukins , Murray Stokely , doc@freebsd.org, doceng@freebsd.org References: <20040712100256.GB3948@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040712100256.GB3948@hub.freebsd.org> User-Agent: Mutt/1.4.1i cc: doceng@freebsd.org cc: doc@freebsd.org Subject: Re: Split of Advanced Networking chapter of Handbook 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, 12 Jul 2004 16:53:41 -0000 On Mon, Jul 12, 2004 at 10:02:56AM +0000, Murray Stokely wrote: > The Advanced Networking chapter of the Handbook is almost 100 pages > and is certainly too unwieldy in it's current form. Agreed. > I would like to split out the network server configuration sections > into a separate chapter called 'Network Servers'. The new chapter > would contain the sections on NFS, NIS/YP, DHCP, DNS, NTP, and inetd. I've been concerned for a while about the prevalance of TLAs here. Sure, most users will know what DNS does, but maybe we should make section titles more helpful by using something like: - Networked File Sharing (NFS) - Networked Account Sharing (NIS) - Automatic Network Configuration (DHCP) - Host and Domain Name Configuration (DNS) - Clock Synchronization (NTP) This way, users looking through the book's contents will have a clearer idea of what different sections are about. Alternatively, this might be solved through adding index terms. Opinions? If I don't hear any objections, I'll commit something along these lines. Regardless, I think the work Murray has done is a useful improvement. Tom From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 20:01:00 2004 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 04BF916A4DF; Mon, 12 Jul 2004 20:01:00 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9564343D55; Mon, 12 Jul 2004 20:00:59 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1Bk6ym-000AGy-1N; Mon, 12 Jul 2004 21:00:48 +0100 Date: Mon, 12 Jul 2004 21:00:47 +0100 From: Ceri Davies To: "Simon L. Nielsen" Message-ID: <20040712200047.GO29928@submonkey.net> Mail-Followup-To: Ceri Davies , "Simon L. Nielsen" , Mark Linimon , Hiten Pandya , freebsd-www@FreeBSD.org, freebsd-doc@FreeBSD.org References: <200407081120.i68BKBcK013201@freefall.freebsd.org> <20040708161517.GS29928@submonkey.net> <20040710125852.GA762@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="1C2QhcYtVTlNtC1j" Content-Disposition: inline In-Reply-To: <20040710125852.GA762@zaphod.nitro.dk> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: Mark Linimon cc: freebsd-doc@FreeBSD.org cc: freebsd-www@FreeBSD.org cc: Hiten Pandya Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals 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, 12 Jul 2004 20:01:00 -0000 --1C2QhcYtVTlNtC1j Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Jul 10, 2004 at 02:58:52PM +0200, Simon L. Nielsen wrote: > On 2004.07.08 17:15:17 +0100, Ceri Davies wrote: > > On Thu, Jul 08, 2004 at 11:07:21AM -0500, Mark Linimon wrote: > > > I added LOR to the glossary a few days ago. It includes a URL to the > > > list page. > > >=20 > > > I noted that the glossary does not seem to be built in the version of > > > the handbook that is displayed on the website as well at that time. > > > There seems to be a Makefile flag to turn it on. Does anyone know > > > why that flag is not on for the www page? > >=20 > > There simply wasn't enough content in it when I committed it. >=20 > I think there is now, so how do you feel about just including it by > default now? I'd still like to see a bit more, but having people aware that it exists has to help in that area, so that may not be a bad idea. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --1C2QhcYtVTlNtC1j Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA8u3vocfcwTS3JF8RAnuGAKCl9ICoAl0pOgiOti47ajFLS79u9QCbBmxM OU2DDHMFNMRLbXjTT1Gzj10= =CrMv -----END PGP SIGNATURE----- --1C2QhcYtVTlNtC1j-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 21:08:25 2004 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 15E8B16A4CE; Mon, 12 Jul 2004 21:08:25 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8392343D54; Mon, 12 Jul 2004 21:08:24 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id CF9E611A00; Mon, 12 Jul 2004 23:08:22 +0200 (CEST) Date: Mon, 12 Jul 2004 23:08:22 +0200 From: "Simon L. Nielsen" To: Ceri Davies , Mark Linimon , Hiten Pandya , freebsd-www@FreeBSD.org, freebsd-doc@FreeBSD.org Message-ID: <20040712210822.GB754@zaphod.nitro.dk> References: <200407081120.i68BKBcK013201@freefall.freebsd.org> <20040708161517.GS29928@submonkey.net> <20040710125852.GA762@zaphod.nitro.dk> <20040712200047.GO29928@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="yrj/dFKFPuw6o+aM" Content-Disposition: inline In-Reply-To: <20040712200047.GO29928@submonkey.net> User-Agent: Mutt/1.5.6i Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals 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, 12 Jul 2004 21:08:25 -0000 --yrj/dFKFPuw6o+aM Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.12 21:00:47 +0100, Ceri Davies wrote: > On Sat, Jul 10, 2004 at 02:58:52PM +0200, Simon L. Nielsen wrote: [Glossary in Handbook] > > I think there is now, so how do you feel about just including it by > > default now? > > I'd still like to see a bit more, but having people aware that it exists > has to help in that area, so that may not be a bad idea. I read that as a "not no" :-). I agree that there should be more text, it just seems silly that it sits there and (almost) nobody knows it's there. Anyway, I just enabled it by default since Mark Linimon said yes, and nobody said no. --=20 Simon L. Nielsen FreeBSD Documentation Team --yrj/dFKFPuw6o+aM Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA8v3Gh9pcDSc1mlERArCjAJ4rEoYtpjvQCTScHK3AuMb4Sk31XgCgsTR0 6srrEvQ8pXK7lDdm7XgotqU= =uv8D -----END PGP SIGNATURE----- --yrj/dFKFPuw6o+aM-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 21:36:06 2004 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 07BED16A4CE; Mon, 12 Jul 2004 21:36:06 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id AA9E043D39; Mon, 12 Jul 2004 21:36:05 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1Bk8Sy-0004WG-Qf; Mon, 12 Jul 2004 22:36:04 +0100 Date: Mon, 12 Jul 2004 22:36:04 +0100 From: Ceri Davies To: "Simon L. Nielsen" Message-ID: <20040712213604.GP29928@submonkey.net> Mail-Followup-To: Ceri Davies , "Simon L. Nielsen" , Mark Linimon , Hiten Pandya , freebsd-www@FreeBSD.org, freebsd-doc@FreeBSD.org References: <200407081120.i68BKBcK013201@freefall.freebsd.org> <20040708161517.GS29928@submonkey.net> <20040710125852.GA762@zaphod.nitro.dk> <20040712200047.GO29928@submonkey.net> <20040712210822.GB754@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="tpXFRyzAyQ/GSAaD" Content-Disposition: inline In-Reply-To: <20040712210822.GB754@zaphod.nitro.dk> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: Mark Linimon cc: freebsd-doc@FreeBSD.org cc: freebsd-www@FreeBSD.org cc: Hiten Pandya Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals 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, 12 Jul 2004 21:36:06 -0000 --tpXFRyzAyQ/GSAaD Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jul 12, 2004 at 11:08:22PM +0200, Simon L. Nielsen wrote: > On 2004.07.12 21:00:47 +0100, Ceri Davies wrote: > > On Sat, Jul 10, 2004 at 02:58:52PM +0200, Simon L. Nielsen wrote: >=20 > [Glossary in Handbook] > > > I think there is now, so how do you feel about just including it by > > > default now? > > > > I'd still like to see a bit more, but having people aware that it exists > > has to help in that area, so that may not be a bad idea. >=20 > I read that as a "not no" :-). I agree that there should be more > text, it just seems silly that it sits there and (almost) nobody knows > it's there. That's the way I meant it to be parsed; sorry for being slightly ambiguous. > Anyway, I just enabled it by default since Mark Linimon said yes, and > nobody said no. Thanks. One slight issue that I have with the current build now is that there is no make dependency on the glossary file, so editing the freebsd-glossary.sgml file and rerunning make in books/handbook doesn't cause a rebuild. It would be nice to fix this, but I'm not sure of the best way. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --tpXFRyzAyQ/GSAaD Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA8wREocfcwTS3JF8RAukFAJ9va2w67AvAprd8SUBJFa8mM2cw3ACfYj6g Lps9wY9gG8Ol0/+gJSoEGKc= =S7l5 -----END PGP SIGNATURE----- --tpXFRyzAyQ/GSAaD-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 22:04:17 2004 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 5664116A4CE; Mon, 12 Jul 2004 22:04:17 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0ADE643D2D; Mon, 12 Jul 2004 22:04:17 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id AE1B411A00; Tue, 13 Jul 2004 00:04:15 +0200 (CEST) Date: Tue, 13 Jul 2004 00:04:15 +0200 From: "Simon L. Nielsen" To: Ceri Davies , Mark Linimon , Hiten Pandya , freebsd-www@FreeBSD.org, freebsd-doc@FreeBSD.org Message-ID: <20040712220415.GF754@zaphod.nitro.dk> References: <200407081120.i68BKBcK013201@freefall.freebsd.org> <20040708161517.GS29928@submonkey.net> <20040710125852.GA762@zaphod.nitro.dk> <20040712200047.GO29928@submonkey.net> <20040712210822.GB754@zaphod.nitro.dk> <20040712213604.GP29928@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="yRA+Bmk8aPhU85Qt" Content-Disposition: inline In-Reply-To: <20040712213604.GP29928@submonkey.net> User-Agent: Mutt/1.5.6i Subject: Re: docs/68595: [PATCH] add FAQ entry for lock order reversals 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, 12 Jul 2004 22:04:17 -0000 --yRA+Bmk8aPhU85Qt Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.12 22:36:04 +0100, Ceri Davies wrote: > Thanks. One slight issue that I have with the current build now is that > there is no make dependency on the glossary file, so editing the > freebsd-glossary.sgml file and rerunning make in books/handbook doesn't > cause a rebuild. It would be nice to fix this, but I'm not sure of the > best way. I just committed a fix which uses .PATH to locate the glossary. I think that's the best way to handle it - at least we have far uglier hacks in other parts of the doc build-system... :-) --=20 Simon L. Nielsen FreeBSD Documentation Team --yRA+Bmk8aPhU85Qt Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA8wrfh9pcDSc1mlERAjxVAJ9ER87xB7e4dBJd4/70k2OCel8AjACgiKuG iEjy+JenkqiziHHMDXhlqgA= =jMv6 -----END PGP SIGNATURE----- --yRA+Bmk8aPhU85Qt-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 22:10:44 2004 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 667EE16A4CE for ; Mon, 12 Jul 2004 22:10:44 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 14AB943D45 for ; Mon, 12 Jul 2004 22:10:44 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 0D2D011A00; Tue, 13 Jul 2004 00:10:42 +0200 (CEST) Date: Tue, 13 Jul 2004 00:10:42 +0200 From: "Simon L. Nielsen" To: Derek Marcotte Message-ID: <20040712221042.GH754@zaphod.nitro.dk> References: <008701c465da$d232ff90$0301a8c0@office.cpainc.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="0XhtP95kHFp3KGBe" Content-Disposition: inline In-Reply-To: <008701c465da$d232ff90$0301a8c0@office.cpainc.net> User-Agent: Mutt/1.5.6i cc: doc@FreeBSD.org Subject: http://www.freebsd.org/doc/en_US.ISO8859-1/articles/5-roadmap/schedule.html 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, 12 Jul 2004 22:10:44 -0000 --0XhtP95kHFp3KGBe Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.09 13:33:17 -0400, Derek Marcotte wrote: > Just FYI: > The URL >=20 > http://www.freebsd.org/doc/en_US.ISO8859-1/articles/5-roadmap/schedule.ht= ml >=20 > Shows 5.3-RELEASE ETA to be March 29, 2004... Perhaps someone > with more current information would like to update this. Yes it seems it need to be updated... I contacted the Release Engineering Team, and the will update the article when they have worked out the updated schedule for 5.3. Thanks for letting us know. --=20 Simon L. Nielsen FreeBSD Documentation Team --0XhtP95kHFp3KGBe Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA8wxih9pcDSc1mlERApNEAKDMCmhzupCW25bOpH+mPha1EXlxrACgjcD9 LXU7tY/b+sJlgqfZMBqhxVA= =GoES -----END PGP SIGNATURE----- --0XhtP95kHFp3KGBe-- From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 23:15:32 2004 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 7745116A4CE; Mon, 12 Jul 2004 23:15:32 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 145E943D4C; Mon, 12 Jul 2004 23:15:32 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6CNFVnV043870; Mon, 12 Jul 2004 17:15:31 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i6CNFVJs043867; Mon, 12 Jul 2004 17:15:31 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Mon, 12 Jul 2004 17:15:31 -0600 (MDT) From: Warren Block To: Tom Hukins In-Reply-To: <20040712165338.GA16218@eborcom.com> Message-ID: <20040712165306.O43767@wonkity.com> References: <20040712100256.GB3948@hub.freebsd.org> <20040712165338.GA16218@eborcom.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3 (wonkity.com [127.0.0.1]); Mon, 12 Jul 2004 17:15:31 -0600 (MDT) cc: doceng@freebsd.org cc: doc@freebsd.org Subject: Re: Split of Advanced Networking chapter of Handbook 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, 12 Jul 2004 23:15:32 -0000 On Mon, 12 Jul 2004, Tom Hukins wrote: > I've been concerned for a while about the prevalance of TLAs here. > Sure, most users will know what DNS does, but maybe we should make > section titles more helpful by using something like: > - Networked File Sharing (NFS) > - Networked Account Sharing (NIS) > - Automatic Network Configuration (DHCP) > - Host and Domain Name Configuration (DNS) > - Clock Synchronization (NTP) Careful--with the first one, it looks like the term in parentheses is spelled out by the title before it, which is not the case. Maybe File Sharing With NFS Account Sharing with NIS ... I've got a proposal on acronyms for my next post that ties in with this. -Warren Block * Rapid City, South Dakota USA From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 23:31:26 2004 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 9323E16A4CE for ; Mon, 12 Jul 2004 23:31:26 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 33AFC43D55 for ; Mon, 12 Jul 2004 23:31:26 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6CNVPtZ043912 for ; Mon, 12 Jul 2004 17:31:25 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i6CNVPnt043909 for ; Mon, 12 Jul 2004 17:31:25 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Mon, 12 Jul 2004 17:31:25 -0600 (MDT) From: Warren Block To: doc@freebsd.org Message-ID: <20040712171533.R43767@wonkity.com> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3 (wonkity.com [127.0.0.1]); Mon, 12 Jul 2004 17:31:25 -0600 (MDT) Subject: Handbook Acronyms 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, 12 Jul 2004 23:31:26 -0000 In most books, the first use of an acronym or term is defined. With the Handbook, that is probably not very helpful, since most users will not read it straight through and may miss the definition. A glossary would help, particularly for HTML, where the definition is just a link away. This fails on paper versions of the Handbook, though. Ideally, the first use of a glossary term in a chapter would have a short definition: With NFS (Network File System), files may be... In the HTML version, the entire "NFS (Network File System)" would be a link to the glossary. Later references and links would just be "NFS". If every acronym is defined in the glossary, is it possible to generate the link and definition the first time an acronym is used in a chapter? -Warren Block * Rapid City, South Dakota USA From owner-freebsd-doc@FreeBSD.ORG Mon Jul 12 23:43:10 2004 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 5666016A4CE; Mon, 12 Jul 2004 23:43:10 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id E1B7443D46; Mon, 12 Jul 2004 23:43:09 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost.pittgoth.com ([192.168.0.5]) (authenticated bits=0) by pittgoth.com (8.12.11/8.12.11) with ESMTP id i6CNh9El022518 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 12 Jul 2004 19:43:09 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Mon, 12 Jul 2004 19:43:44 -0400 From: Tom Rhodes To: Murray Stokely Message-Id: <20040712194344.34d3a954@localhost.pittgoth.com> In-Reply-To: <20040712100256.GB3948@hub.freebsd.org> References: <20040712100256.GB3948@hub.freebsd.org> X-Mailer: Sylpheed version 0.9.11claws (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doceng@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: [REVIEW] Split of Advanced Networking chapter of Handbook 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, 12 Jul 2004 23:43:10 -0000 On Mon, 12 Jul 2004 10:02:56 +0000 Murray Stokely wrote: > The Advanced Networking chapter of the Handbook is almost 100 pages > and is certainly too unwieldy in it's current form. > > I would like to split out the network server configuration sections > into a separate chapter called 'Network Servers'. The new chapter > would contain the sections on NFS, NIS/YP, DHCP, DNS, NTP, and inetd. > The Advanced Networking chapter would still contain the information > about routing, wireless networks, natd, and other topics that it > currently contains. > > You can see the built output of my proposal here : > > http://people.freebsd.org/~murray/handbook/ > Quick review and I like it. -- Tom Rhodes From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 02:35:22 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 3C02716A4CF; Tue, 13 Jul 2004 02:35:22 +0000 (GMT) Date: Tue, 13 Jul 2004 02:35:22 +0000 From: Murray Stokely To: Tom Hukins , doc@freebsd.org, doceng@freebsd.org Message-ID: <20040713023522.GB85720@hub.freebsd.org> References: <20040712100256.GB3948@hub.freebsd.org> <20040712165338.GA16218@eborcom.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040712165338.GA16218@eborcom.com> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: Re: Split of Advanced Networking chapter of Handbook 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: Tue, 13 Jul 2004 02:35:22 -0000 On Mon, Jul 12, 2004 at 05:53:38PM +0100, Tom Hukins wrote: > I've been concerned for a while about the prevalance of TLAs here. > Sure, most users will know what DNS does, but maybe we should make > section titles more helpful by using something like: Yea I agree all the section names should be like your list. Some of them are already I think. > This way, users looking through the book's contents will have a > clearer idea of what different sections are about. Agreed. > Alternatively, this might be solved through adding index terms. > Opinions? If I don't hear any objections, I'll commit something along Index terms are something separate. Many terms are already there in both expanded and acronym form (possibly with a marker). The index terms may still need cleaning up, but that isn't a replacement for expanding section titles. There is space pressure to keep the index entries concise and so acronyms aren't as frowned upon in an index, I think. Four words like 'Network File System Server' is pushing the space limitation for two column index output in a book -- especially if you then have secondary index terms beneath it. > these lines. Please don't make this kind of commit until I do the split so that my patch will still apply cleanly. - Murray From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 06:20:40 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 4532616A4F2; Tue, 13 Jul 2004 06:20:40 +0000 (GMT) Date: Tue, 13 Jul 2004 06:20:40 +0000 From: Murray Stokely To: Tom Hukins , doc@freebsd.org, doceng@freebsd.org Message-ID: <20040713062040.GD85720@hub.freebsd.org> References: <20040712100256.GB3948@hub.freebsd.org> <20040712165338.GA16218@eborcom.com> <20040713023522.GB85720@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040713023522.GB85720@hub.freebsd.org> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: Re: Split of Advanced Networking chapter of Handbook 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: Tue, 13 Jul 2004 06:20:40 -0000 I went ahead and committed the chapter split since all the feedback was positive and I don't want to hold up anyone else from working on this. Thanks to all those who spoke up about it. - Murray On Tue, Jul 13, 2004 at 02:35:22AM +0000, Murray Stokely wrote: > > these lines. > > Please don't make this kind of commit until I do the split so that my > patch will still apply cleanly. > > - Murray From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 07:40:46 2004 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 D584116A4CE for ; Tue, 13 Jul 2004 07:40:46 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id BEA7B43D39 for ; Tue, 13 Jul 2004 07:40:45 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) by abigail.blackend.org (8.12.11/8.12.11) with ESMTP id i6D7ehmh005773 for ; Tue, 13 Jul 2004 09:40:43 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6D7ehcf005772 for doc@freebsd.org; Tue, 13 Jul 2004 09:40:43 +0200 (CEST) (envelope-from marc) Date: Tue, 13 Jul 2004 09:40:42 +0200 From: Marc Fonvieille To: doc@freebsd.org Message-ID: <20040713074042.GA5126@abigail.blackend.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE Subject: RFC: initialisms and FDP 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: Tue, 13 Jul 2004 07:40:47 -0000 Hello, I think it's the right moment to talk about initialism: abbreviations and acronyms. I'd like to add something to the FDP related to that "problem". In fact I see 2 issues: First, it seems people do not make a difference between an abbreviation and an acronym (I'm focusing on english usage, but it's same in many language like french for example). http://linguistics.arizona.edu/~hharley/PDFs/HarleyAcronyms2003.pdf explains the difference. To sum up the main difference, an acronym is an initialism where the sequence of initials taken from the source is pronounced as a phonological word, and an abbreviation is an initialism where eash letter is pronounced individually. Well some of us will think: "Marc you are too muck picky", maybe but DocBook offers both and tags. These tags exist to mainly respect the definition above. Since we hardly make the difference between these initialisms, we used tags (which is not correct according to linguistic definitions). So to avoid the fact that, one day, someone starts to mix and tags in our doc, I propose to define in our FDP as a generic tag for initialisms. My second remark is about when or how many times we should use acronym tags for the same initialism? This remark is important cause if we start to use tags, which is the case since a while, what should prevent someone to "spam" our SGML files with these tags? Some will think everything: SMTP, NTP etc. should be tagged, so we will end up with "bloat". Since this tag is not rendered, for the moment, I don't see why in one section we should tag many times the same initialism (but that's just my opinion). >From my point of view, the main interest about initialism tagging is having links to the glossary to define the initialism. Some of us recently pointed this glossary question. So can we take a decision and add a "rule" to our FDP? Marc From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 12:47:48 2004 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 5550816A4CE for ; Tue, 13 Jul 2004 12:47:48 +0000 (GMT) Received: from web50510.mail.yahoo.com (web50510.mail.yahoo.com [206.190.38.247]) by mx1.FreeBSD.org (Postfix) with SMTP id 03CCE43D2D for ; Tue, 13 Jul 2004 12:47:48 +0000 (GMT) (envelope-from jery_molan@yahoo.com) Message-ID: <20040713124747.92834.qmail@web50510.mail.yahoo.com> Received: from [193.227.14.65] by web50510.mail.yahoo.com via HTTP; Tue, 13 Jul 2004 05:47:47 PDT Date: Tue, 13 Jul 2004 05:47:47 -0700 (PDT) From: d fg To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Subject: 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: Tue, 13 Jul 2004 12:47:48 -0000 hi there; HOWTO setup network ; sharing files ; connect to internet i'm in a domain __________________________________ Do you Yahoo!? New and Improved Yahoo! Mail - 100MB free storage! http://promotions.yahoo.com/new_mail From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 15:00:46 2004 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 4E79216A4CE for ; Tue, 13 Jul 2004 15:00:46 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3FF1043D2F for ; Tue, 13 Jul 2004 15:00:46 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6DF0kX2000761 for ; Tue, 13 Jul 2004 15:00:46 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6DF0k8P000760; Tue, 13 Jul 2004 15:00:46 GMT (envelope-from gnats) Date: Tue, 13 Jul 2004 15:00:46 GMT Message-Id: <200407131500.i6DF0k8P000760@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Peter Pentchev Subject: Re: docs/65615: make.conf.5 documents non-existent MAKE_SHELL variable X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Peter Pentchev List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Jul 2004 15:00:46 -0000 The following reply was made to PR docs/65615; it has been noted by GNATS. From: Peter Pentchev To: Matthew Seaman , bug-followup@FreeBSD.org Cc: Subject: Re: docs/65615: make.conf.5 documents non-existent MAKE_SHELL variable Date: Tue, 13 Jul 2004 17:55:35 +0300 On Sat, Apr 17, 2004 at 01:00:13PM +0100, Matthew Seaman wrote: > On Sat, Apr 17, 2004 at 04:44:59AM -0700, Jens Schweikhardt wrote: > > Synopsis: make.conf.5 documents non-existent MAKE_SHELL variable > > > > /usr/src/usr.bin/make/Makefile:MAKE_SHELL?= sh > > /usr/src/usr.bin/make/Makefile:.if ${MAKE_SHELL} == "csh" > > /usr/src/usr.bin/make/Makefile:.elif ${MAKE_SHELL} == "sh" > > /usr/src/usr.bin/make/Makefile:.elif ${MAKE_SHELL} == "ksh" > > /usr/src/usr.bin/make/Makefile:.error "MAKE_SHELL must be set to one of \"csh\", \"sh\" or \"ksh\"." > > > > So MAKE_SHELL appears to be used for making make itself. > > Ah. Well, I was looking at the RELENG_4 sources. Seems this is a 5.x > thing that got MFC'd a bit too enthusiastically. It seems that Jens closed the PR without actually fixing the RELENG_4 make.conf(5) manpage; the MAKE_SHELL description has been removed now. Thanks for noticing this! G'luck, Peter -- Peter Pentchev roam@ringlet.net roam@sbnd.net roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 When you are not looking at it, this sentence is in Spanish. From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 15:03:11 2004 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 07EB216A4CE; Tue, 13 Jul 2004 15:03:11 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D9CF043D41; Tue, 13 Jul 2004 15:03:10 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6DF3AL7000931; Tue, 13 Jul 2004 15:03:10 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6DF3A07000927; Tue, 13 Jul 2004 15:03:10 GMT (envelope-from roam) Date: Tue, 13 Jul 2004 15:03:10 GMT From: Peter Pentchev Message-Id: <200407131503.i6DF3A07000927@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, roam@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/66574: [patch] MFC share/man/man4/ng_iface.4 1.14 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: Tue, 13 Jul 2004 15:03:11 -0000 Synopsis: [patch] MFC share/man/man4/ng_iface.4 1.14 State-Changed-From-To: open->closed State-Changed-By: roam State-Changed-When: Tue Jul 13 15:02:48 GMT 2004 State-Changed-Why: The correction was merged into -STABLE, thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=66574 From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 15:07:48 2004 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 6206A16A4CE; Tue, 13 Jul 2004 15:07:48 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 40F3443D45; Tue, 13 Jul 2004 15:07:48 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6DF7m6P004726; Tue, 13 Jul 2004 15:07:48 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6DF7mgq004722; Tue, 13 Jul 2004 15:07:48 GMT (envelope-from roam) Date: Tue, 13 Jul 2004 15:07:48 GMT From: Peter Pentchev Message-Id: <200407131507.i6DF7mgq004722@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, roam@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/66575: [patch] MFC share/man/man4/ng_ksocket.4 v 1.16 and 1.17 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: Tue, 13 Jul 2004 15:07:48 -0000 Synopsis: [patch] MFC share/man/man4/ng_ksocket.4 v 1.16 and 1.17 State-Changed-From-To: open->closed State-Changed-By: roam State-Changed-When: Tue Jul 13 15:07:29 GMT 2004 State-Changed-Why: The fixes were merged into -STABLE, thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=66575 From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 16:10:07 2004 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 5A67F16A4CE; Tue, 13 Jul 2004 16:10:07 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4DAE243D41; Tue, 13 Jul 2004 16:10:07 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6DGA7Q3016117; Tue, 13 Jul 2004 16:10:07 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6DGA6Ok016113; Tue, 13 Jul 2004 16:10:06 GMT (envelope-from roam) Date: Tue, 13 Jul 2004 16:10:06 GMT From: Peter Pentchev Message-Id: <200407131610.i6DGA6Ok016113@freefall.freebsd.org> To: stb@lassitu.de, roam@FreeBSD.org, freebsd-doc@FreeBSD.org, roam@FreeBSD.org Subject: Re: docs/66621: Document fix for "kmem_map too small panics" 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: Tue, 13 Jul 2004 16:10:07 -0000 Synopsis: Document fix for "kmem_map too small panics" State-Changed-From-To: open->feedback State-Changed-By: roam State-Changed-When: Tue Jul 13 16:06:41 GMT 2004 State-Changed-Why: Does this also apply to 4.x-STABLE? Both the VM_KMEM_SIZE_MAX option and autosizing support (maxusers 0) are present in -STABLE, too. In this case - or actually, in any case - wouldn't it be better if your excellent explanation replaced the current question 5.11, 'panic-kmemmap-too-small', which seems to pertain to pre-maxusers kernels? Responsible-Changed-From-To: freebsd-doc->roam Responsible-Changed-By: roam Responsible-Changed-When: Tue Jul 13 16:06:41 GMT 2004 Responsible-Changed-Why: I'll take care of this. http://www.freebsd.org/cgi/query-pr.cgi?pr=66621 From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 16:21:13 2004 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 DFD8316A4CE; Tue, 13 Jul 2004 16:21:13 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BAE5443D31; Tue, 13 Jul 2004 16:21:13 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6DGLDSV016773; Tue, 13 Jul 2004 16:21:13 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6DGLDdw016769; Tue, 13 Jul 2004 16:21:13 GMT (envelope-from roam) Date: Tue, 13 Jul 2004 16:21:13 GMT From: Peter Pentchev Message-Id: <200407131621.i6DGLDdw016769@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, roam@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/66764: [patch] 4_RELENG share/man/man4/ng_one2many.4 MFC 1.6, tyop 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: Tue, 13 Jul 2004 16:21:14 -0000 Synopsis: [patch] 4_RELENG share/man/man4/ng_one2many.4 MFC 1.6, tyop State-Changed-From-To: open->closed State-Changed-By: roam State-Changed-When: Tue Jul 13 16:21:00 GMT 2004 State-Changed-Why: Fixes merged into -STABLE, thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=66764 From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 16:52:33 2004 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 63D9C16A4CE for ; Tue, 13 Jul 2004 16:52:33 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id 12FD043D4C for ; Tue, 13 Jul 2004 16:52:33 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1BkQW8-000L5K-7C; Tue, 13 Jul 2004 17:52:32 +0100 Date: Tue, 13 Jul 2004 17:52:32 +0100 From: Ceri Davies To: Warren Block Message-ID: <20040713165232.GT29928@submonkey.net> Mail-Followup-To: Ceri Davies , Warren Block , doc@freebsd.org References: <20040712171533.R43767@wonkity.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ggHp9WSrPOeNxb0b" Content-Disposition: inline In-Reply-To: <20040712171533.R43767@wonkity.com> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: doc@freebsd.org Subject: Re: Handbook Acronyms 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: Tue, 13 Jul 2004 16:52:33 -0000 --ggHp9WSrPOeNxb0b Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jul 12, 2004 at 05:31:25PM -0600, Warren Block wrote: > In most books, the first use of an acronym or term is defined. With the= =20 > Handbook, that is probably not very helpful, since most users will not=20 > read it straight through and may miss the definition. >=20 > A glossary would help, particularly for HTML, where the definition is=20 > just a link away. This fails on paper versions of the Handbook, though. >=20 > Ideally, the first use of a glossary term in a chapter would have a=20 > short definition: >=20 > With NFS (Network File System), files may be... >=20 > In the HTML version, the entire "NFS (Network File System)" would be a=20 > link to the glossary. Later references and links would just be "NFS". >=20 > If every acronym is defined in the glossary, is it possible to generate= =20 > the link and definition the first time an acronym is used in a chapter? Yes, and that's the plan at the moment. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --ggHp9WSrPOeNxb0b Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA9BNPocfcwTS3JF8RAt/sAJ9aa5ggvYCZBE4kvb8eZ4kaKOIXbwCghCQI 2Xaa69lzrGCYxq4CE+Mm2cQ= =b1mS -----END PGP SIGNATURE----- --ggHp9WSrPOeNxb0b-- From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 17:06:25 2004 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 A791F16A4CE; Tue, 13 Jul 2004 17:06:25 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id 29DC243D49; Tue, 13 Jul 2004 17:06:25 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1BkQjY-000L9H-A0; Tue, 13 Jul 2004 18:06:24 +0100 Date: Tue, 13 Jul 2004 18:06:24 +0100 From: Ceri Davies To: Marc Fonvieille Message-ID: <20040713170624.GU29928@submonkey.net> Mail-Followup-To: Ceri Davies , Marc Fonvieille , doc@freebsd.org References: <20040713074042.GA5126@abigail.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="xcivb/T/gnJQjo5J" Content-Disposition: inline In-Reply-To: <20040713074042.GA5126@abigail.blackend.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: doc@freebsd.org Subject: Re: RFC: initialisms and FDP 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: Tue, 13 Jul 2004 17:06:25 -0000 --xcivb/T/gnJQjo5J Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jul 13, 2004 at 09:40:42AM +0200, Marc Fonvieille wrote: > I think it's the right moment to talk about initialism: abbreviations > and acronyms. > I'd like to add something to the FDP related to that "problem". >=20 > In fact I see 2 issues: > First, it seems people do not make a difference between an abbreviation > and an acronym (I'm focusing on english usage, but it's same in many > language like french for example). > http://linguistics.arizona.edu/~hharley/PDFs/HarleyAcronyms2003.pdf > explains the difference. > To sum up the main difference, an acronym is an initialism where the > sequence of initials taken from the source is pronounced as a > phonological word, and an abbreviation is an initialism where eash > letter is pronounced individually. -- [1] That strikes me as a redefinition of the word "abbreviation". With this definition, what is "Penn.", as in "Pennsylvania"? It's certainly not an acronym, but the "new rules" tell us that it's not an abbreviation either. I think someone wants to think up a new word instead of overloading "abbreviation" - I *know* that the DocBook element abbrev has the old "Penn." type in mind over the new-fangled "USA" type. > So to avoid the fact that, one day, someone starts to mix and > tags in our doc, I propose to define in our FDP as > a generic tag for initialisms. Fine with me - as far as I'm concerned both of the forms defined in [1] above *are* acronyms. Expect me to raise holy hell if someone marks up an abbreviation (old-style) as an acronym though. > This remark is important cause if we start to use tags, which > is the case since a while, what should prevent someone to "spam" our > SGML files with these tags? Some will think everything: SMTP, NTP etc. > should be tagged, so we will end up with "bloat". Since this tag is not > rendered, for the moment, I don't see why in one section we should tag > many times the same initialism (but that's just my opinion). See murray's recent commit regrading ⋼. We *should* be marking up every occurrence of an acronym as such, because that's what DocBook is for. Ceri PS I understand that I am running somewhat hot at the moment - please don't get offended by anything above. --=20 It is not tinfoil, it is my new skin. I am a robot. --xcivb/T/gnJQjo5J Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD4DBQFA9BaQocfcwTS3JF8RAoqJAJdhImGnRRu9od7I7eQUMdlQaR4WAJsFlZto kGk6g2/RQtEjEqMPVRxBhg== =jRDT -----END PGP SIGNATURE----- --xcivb/T/gnJQjo5J-- From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 18:06:06 2004 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 6D15916A4CE; Tue, 13 Jul 2004 18:06:06 +0000 (GMT) Received: from www.reppep.com (www.reppep.com [66.92.104.200]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1EB9F43D2F; Tue, 13 Jul 2004 18:06:06 +0000 (GMT) (envelope-from pepper@reppep.com) Received: from [129.85.219.160] (salt.rockefeller.edu [129.85.219.160]) by www.reppep.com (Postfix) with ESMTP id 56787FE87; Tue, 13 Jul 2004 14:06:03 -0400 (EDT) Mime-Version: 1.0 Message-Id: In-Reply-To: <20040711.225534.98614992.hrs@eos.ocn.ne.jp> References: <20040711.225534.98614992.hrs@eos.ocn.ne.jp> Date: Tue, 13 Jul 2004 14:05:52 -0400 To: Hiroki Sato From: Chris Pepper Content-Type: text/plain; charset="us-ascii" ; format="flowed" cc: doc@FreeBSD.org Subject: Re: doc build with AFPL Ghostscript 8.14 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: Tue, 13 Jul 2004 18:06:06 -0000 At 10:55 PM +0900 2004/07/11, Hiroki Sato wrote: >Hi, > > I made a patch to solve a doc build problem when AFPL Ghostscript 8.14 > is used. This patch should be compatible with both of GNU Ghostscript > 7.07, which the docproj port depends on via graphics/peps, and gs 8.14. > The problem was that graphics/peps cannot be used with gs 8.14. After > applying this patch, peps is no longer used. Don't forget to strike the peps comment >@@ -184,8 +197,10 @@ > # relative path when the arguments are passed by peps; realpath will > # correct the problem. > .pic.png: ${.TARGET:S/.png$/.eps/} >- ${EPS2PNG} ${EPS2PNGOPTS} -o ${.TARGET} \ >- `${REALPATH} ${.TARGET:S/.png$/.eps/}` >+ ${EPSGEOM} -offset ${EPSGEOMOPTS} ${.TARGET:S/.png$/.eps/} \ >+ | ${EPS2PNM} ${EPS2PNMOPTS} \ >+ -g`${EPSGEOM} -geom ${EPSGEOMOPTS} >${.TARGET:S/.png$/.eps/}` - \ >+ | ${PNMTOPNG} > ${.TARGET} Chris -- Chris Pepper: Rockefeller University: From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 18:15:05 2004 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 7623216A4CE; Tue, 13 Jul 2004 18:15:05 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1B93243D1F; Tue, 13 Jul 2004 18:15:03 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6DIF0Kc014678; Tue, 13 Jul 2004 20:15:00 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6DIF0fc014677; Tue, 13 Jul 2004 20:15:00 +0200 (CEST) (envelope-from marc) Date: Tue, 13 Jul 2004 20:15:00 +0200 From: Marc Fonvieille To: Ceri Davies , doc@FreeBSD.org Message-ID: <20040713181500.GA10935@abigail.blackend.org> References: <20040713074042.GA5126@abigail.blackend.org> <20040713170624.GU29928@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="pWyiEgJYm5f9v55/" Content-Disposition: inline In-Reply-To: <20040713170624.GU29928@submonkey.net> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE Subject: Re: RFC: initialisms and FDP 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: Tue, 13 Jul 2004 18:15:05 -0000 --pWyiEgJYm5f9v55/ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jul 13, 2004 at 06:06:24PM +0100, Ceri Davies wrote: >=20 > > So to avoid the fact that, one day, someone starts to mix and > > tags in our doc, I propose to define in our FDP as > > a generic tag for initialisms. >=20 > Fine with me - as far as I'm concerned both of the forms defined in [1] > above *are* acronyms. Expect me to raise holy hell if someone marks up > an abbreviation (old-style) as an acronym though. > So "old-style" abbrevation: , the rest . > > This remark is important cause if we start to use tags, which > > is the case since a while, what should prevent someone to "spam" our > > SGML files with these tags? Some will think everything: SMTP, NTP etc. > > should be tagged, so we will end up with "bloat". Since this tag is not > > rendered, for the moment, I don't see why in one section we should tag > > many times the same initialism (but that's just my opinion). >=20 > See murray's recent commit regrading ⋼. We *should* be marking up > every occurrence of an acronym as such, because that's what DocBook is > for. You're right, I did not read carefully last commits. However Murray's commit helps me to "bounce" on something I discreetly mentioned: NTP, SMTP, TCP etc... should be tagged (I mean replaced with an entity) ? What will be considered as an acronym? Everything or just some terms? Marc >=20 > Ceri >=20 > PS I understand that I am running somewhat hot at the moment - please > don't get offended by anything above. Since english is not my mother tongue, it's sometimes difficult for me to know when it's offending or not. In the same way, people often thought I was rude, but it was just a translation issue :) Marc > --=20 > It is not tinfoil, it is my new skin. I am a robot. --pWyiEgJYm5f9v55/ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA9Cai81T1MWxkgcoRApFKAKCdL9s795txwrj/3mNioc4kkv57qACfSRzN 1pqtHEagcXvpOZNGdWoxmXk= =GwC8 -----END PGP SIGNATURE----- --pWyiEgJYm5f9v55/-- From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 21:34:35 2004 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 89C6416A4CF; Tue, 13 Jul 2004 21:34:35 +0000 (GMT) Received: from internet.potentialtech.com (h-66-167-251-6.phlapafg.covad.net [66.167.251.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2485143D45; Tue, 13 Jul 2004 21:34:35 +0000 (GMT) (envelope-from wmoran@potentialtech.com) Received: from working.potentialtech.com (pa-plum-cmts1e-68-68-113-64.pittpa.adelphia.net [68.68.113.64]) by internet.potentialtech.com (Postfix) with ESMTP id E2D1769A39; Tue, 13 Jul 2004 17:34:33 -0400 (EDT) Date: Tue, 13 Jul 2004 17:34:32 -0400 From: Bill Moran To: "Steve Bertrand" Message-Id: <20040713173432.5004bcdf.wmoran@potentialtech.com> In-Reply-To: <2770.209.167.16.15.1089737800.squirrel@209.167.16.15> References: <40F4109E.5070704@fskklaw.com> <2770.209.167.16.15.1089737800.squirrel@209.167.16.15> Organization: Potential Technologies X-Mailer: Sylpheed version 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd4.9) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: tms3@fskklaw.com cc: doc@freebsd.org cc: questions@freebsd.org Subject: Re: Chapter 14 Security 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: Tue, 13 Jul 2004 21:34:35 -0000 "Steve Bertrand" wrote: > > The article requires the use of the command "gifconfig" which does not > > exit on my FreeBSD 5.2.1 machine. Is this a typo in the manual, or have > > I missed something? > > Just did a quick google for "no gifconfig freebsd 5", and in the sparc64 > relnotes, I found this: > > "gifconfig(8) is obsolete and has been removed. Its functionality is now > handled by the tunnel and deletetunnel commands of ifconfig(8)." > > Here's the link. If it's taken out of sparc, I'm assuming that it's > obsolete for the others as well... > > http://jamesthornton.com/freebsd/5.0/relnotes-sparc64.html This should probably be passed on to the doc team. Anyone have time to put together a patch to update the handbook? [doc team CCed] -- Bill Moran Potential Technologies http://www.potentialtech.com From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 23:34:25 2004 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 CE59016A4CE; Tue, 13 Jul 2004 23:34:25 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5120C43D2F; Tue, 13 Jul 2004 23:34:25 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6DNYOMF019274; Tue, 13 Jul 2004 17:34:24 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i6DNYOuW019271; Tue, 13 Jul 2004 17:34:24 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 13 Jul 2004 17:34:24 -0600 (MDT) From: Warren Block To: Ceri Davies In-Reply-To: <20040713165232.GT29928@submonkey.net> Message-ID: <20040713172910.P19256@wonkity.com> References: <20040712171533.R43767@wonkity.com> <20040713165232.GT29928@submonkey.net> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3 (wonkity.com [127.0.0.1]); Tue, 13 Jul 2004 17:34:24 -0600 (MDT) cc: doc@FreeBSD.org Subject: Re: Handbook Acronyms 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: Tue, 13 Jul 2004 23:34:25 -0000 On Tue, 13 Jul 2004, Ceri Davies wrote: >> If every acronym is defined in the glossary, is it possible to generate >> the link and definition the first time an acronym is used in a chapter? > > Yes, and that's the plan at the moment. Excellent! I don't see the glossary in the Handbook source; is there one with at least one entry to use as a template? I would be willing to start working on adding definitions. -Warren Block * Rapid City, South Dakota USA From owner-freebsd-doc@FreeBSD.ORG Tue Jul 13 23:53:34 2004 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 9A99C16A4E0 for ; Tue, 13 Jul 2004 23:53:34 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4F2F643D1F for ; Tue, 13 Jul 2004 23:53:34 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1BkX5Z-000Pir-15; Wed, 14 Jul 2004 00:53:33 +0100 Date: Wed, 14 Jul 2004 00:53:32 +0100 From: Ceri Davies To: Warren Block Message-ID: <20040713235332.GD29928@submonkey.net> Mail-Followup-To: Ceri Davies , Warren Block , doc@FreeBSD.org References: <20040712171533.R43767@wonkity.com> <20040713165232.GT29928@submonkey.net> <20040713172910.P19256@wonkity.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="AGgF02x1jLHCLk2P" Content-Disposition: inline In-Reply-To: <20040713172910.P19256@wonkity.com> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: doc@FreeBSD.org Subject: Re: Handbook Acronyms 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: Tue, 13 Jul 2004 23:53:34 -0000 --AGgF02x1jLHCLk2P Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jul 13, 2004 at 05:34:24PM -0600, Warren Block wrote: > On Tue, 13 Jul 2004, Ceri Davies wrote: >=20 > >>If every acronym is defined in the glossary, is it possible to generate > >>the link and definition the first time an acronym is used in a chapter? > > > >Yes, and that's the plan at the moment. >=20 > Excellent! >=20 > I don't see the glossary in the Handbook source; is there one with at=20 > least one entry to use as a template? I would be willing to start=20 > working on adding definitions. Great - it's at doc/en/share/sgml/glossary/freebsd-glossary.sgml. Thanks! Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --AGgF02x1jLHCLk2P Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA9HX8ocfcwTS3JF8RAtPsAKCLVvvtfvepoAov2TRoU4DiyUydkACgrnuF wqG813c79lt9h+FGLwMR2Wk= =JIBm -----END PGP SIGNATURE----- --AGgF02x1jLHCLk2P-- From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 00:42:44 2004 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 B1CEA16A4CE for ; Wed, 14 Jul 2004 00:42:44 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2DB7143D55 for ; Wed, 14 Jul 2004 00:42:43 +0000 (GMT) (envelope-from iaccounts@ibctech.ca) Received: (qmail 61724 invoked by uid 1002); 14 Jul 2004 00:43:23 -0000 Received: from iaccounts@ibctech.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.037851 secs); 14 Jul 2004 00:43:23 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 14 Jul 2004 00:43:22 -0000 Received: from 64.39.177.89 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Tue, 13 Jul 2004 20:43:22 -0400 (EDT) Message-ID: <10564.64.39.177.89.1089765802.squirrel@64.39.177.89> In-Reply-To: <20040713173432.5004bcdf.wmoran@potentialtech.com> References: <40F4109E.5070704@fskklaw.com> <2770.209.167.16.15.1089737800.squirrel@209.167.16.15> <20040713173432.5004bcdf.wmoran@potentialtech.com> Date: Tue, 13 Jul 2004 20:43:22 -0400 (EDT) From: "Steve Bertrand" To: "Bill Moran" User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal cc: tms3@fskklaw.com cc: doc@freebsd.org cc: questions@freebsd.org Subject: Re: Chapter 14 Security 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: Wed, 14 Jul 2004 00:42:44 -0000 >> > The article requires the use of the command "gifconfig" which does not >> > exit on my FreeBSD 5.2.1 machine. Is this a typo in the manual, or >> have >> > I missed something? >> >> Just did a quick google for "no gifconfig freebsd 5", and in the sparc64 >> relnotes, I found this: >> >> "gifconfig(8) is obsolete and has been removed. Its functionality is now >> handled by the tunnel and deletetunnel commands of ifconfig(8)." >> >> Here's the link. If it's taken out of sparc, I'm assuming that it's >> obsolete for the others as well... >> >> http://jamesthornton.com/freebsd/5.0/relnotes-sparc64.html > > This should probably be passed on to the doc team. Anyone have time to > put together a patch to update the handbook? > > [doc team CCed] > Although I've always been intrigued in the arena of actually making a doc/code patch contribution to any open source project, I feel this a very good time to look into howto perform this type of task. I'll review the FreeBSD developers handbook: http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/ tomorrow to find out more on how I can do this. It's something I've always wanted to do, and it seems like a great opportunity for me to get 'right into' making an actual contribution for what I have so freely taken. Any other resources I can be pointed to for making Doc contributions will be graciously accepted for mine, and hopefully others interest. Steve > -- > Bill Moran > Potential Technologies > http://www.potentialtech.com > From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 02:12:01 2004 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 B6F5216A4CF; Wed, 14 Jul 2004 02:12:01 +0000 (GMT) Received: from internet.potentialtech.com (h-66-167-251-6.phlapafg.covad.net [66.167.251.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id 87B2343D31; Wed, 14 Jul 2004 02:12:01 +0000 (GMT) (envelope-from wmoran@potentialtech.com) Received: from working.potentialtech.com (pa-plum-cmts1e-68-68-113-64.pittpa.adelphia.net [68.68.113.64]) by internet.potentialtech.com (Postfix) with ESMTP id 7302169A39; Tue, 13 Jul 2004 22:12:00 -0400 (EDT) Date: Tue, 13 Jul 2004 22:11:59 -0400 From: Bill Moran To: "Steve Bertrand" Message-Id: <20040713221159.14e4c8ed.wmoran@potentialtech.com> In-Reply-To: <10564.64.39.177.89.1089765802.squirrel@64.39.177.89> References: <40F4109E.5070704@fskklaw.com> <2770.209.167.16.15.1089737800.squirrel@209.167.16.15> <20040713173432.5004bcdf.wmoran@potentialtech.com> <10564.64.39.177.89.1089765802.squirrel@64.39.177.89> Organization: Potential Technologies X-Mailer: Sylpheed version 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd4.9) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: questions@freebsd.org cc: doc@freebsd.org Subject: Re: Chapter 14 Security 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: Wed, 14 Jul 2004 02:12:01 -0000 "Steve Bertrand" wrote: > >> > The article requires the use of the command "gifconfig" which does not > >> > exit on my FreeBSD 5.2.1 machine. Is this a typo in the manual, or > >> have > >> > I missed something? > >> > >> Just did a quick google for "no gifconfig freebsd 5", and in the sparc64 > >> relnotes, I found this: > >> > >> "gifconfig(8) is obsolete and has been removed. Its functionality is now > >> handled by the tunnel and deletetunnel commands of ifconfig(8)." > >> > >> Here's the link. If it's taken out of sparc, I'm assuming that it's > >> obsolete for the others as well... > >> > >> http://jamesthornton.com/freebsd/5.0/relnotes-sparc64.html > > > > This should probably be passed on to the doc team. Anyone have time to > > put together a patch to update the handbook? > > > > [doc team CCed] > > Although I've always been intrigued in the arena of actually making a > doc/code patch contribution to any open source project, I feel this a very > good time to look into howto perform this type of task. > > I'll review the FreeBSD developers handbook: > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/ > > tomorrow to find out more on how I can do this. It's something I've always > wanted to do, and it seems like a great opportunity for me to get 'right > into' making an actual contribution for what I have so freely taken. > > Any other resources I can be pointed to for making Doc contributions will > be graciously accepted for mine, and hopefully others interest. http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html You may also want to subscribe to doc@freebsd.org -- Bill Moran Potential Technologies http://www.potentialtech.com From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 02:53:48 2004 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 DC3EC16A4CE; Wed, 14 Jul 2004 02:53:48 +0000 (GMT) Received: from wonkity.com (wonkity.com [65.173.111.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id DA35243D39; Wed, 14 Jul 2004 02:53:46 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.12.11/8.12.11) with ESMTP id i6E2rk45019583; Tue, 13 Jul 2004 20:53:46 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.12.11/8.12.11/Submit) with ESMTP id i6E2rkA8019580; Tue, 13 Jul 2004 20:53:46 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 13 Jul 2004 20:53:46 -0600 (MDT) From: Warren Block To: Ceri Davies In-Reply-To: <20040713235332.GD29928@submonkey.net> Message-ID: <20040713203222.R19556@wonkity.com> References: <20040712171533.R43767@wonkity.com> <20040713165232.GT29928@submonkey.net> <20040713235332.GD29928@submonkey.net> MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="0-1462583829-1089773626=:19556" X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-1.5.3 (wonkity.com [127.0.0.1]); Tue, 13 Jul 2004 20:53:46 -0600 (MDT) cc: doc@FreeBSD.org Subject: Re: Handbook Acronyms 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: Wed, 14 Jul 2004 02:53:49 -0000 This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. --0-1462583829-1089773626=:19556 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed On Wed, 14 Jul 2004, Ceri Davies wrote: [glossary] > Great - it's at > doc/en/share/sgml/glossary/freebsd-glossary.sgml. Okay, as a first step at defining all these terms, here's a little Perl snippet (requires 5.8, I think) that creates a list of acronyms used in the Handbook and removes those terms already present in the glossary. Surprisingly, it turns out that the terms presently defined in the glossary are not used in the Handbook at all, and vice versa. (I can't escape the feeling that this could be done in about two lines of Perl if I had a better handle on it. 8-) -Warren Block * Rapid City, South Dakota USA --0-1462583829-1089773626=:19556 Content-Type: TEXT/PLAIN; charset=US-ASCII; name=acrolist Content-Transfer-Encoding: BASE64 Content-ID: <20040713205346.A19556@wonkity.com> Content-Description: Content-Disposition: attachment; filename=acrolist IyEvdXNyL2Jpbi9wZXJsDQoNCiMgTGlzdCBhY3JvbnltcyB1c2VkIGluIHRo ZSBGcmVlQlNEIEhhbmRib29rIGJ1dCBub3QgeWV0DQojIGRlZmluZWQgaW4g dGhlIEdsb3NzYXJ5Lg0KIyBXQiwgMjAwNDA3MTMNCg0KdXNlIHN0cmljdDsN CnVzZSB3YXJuaW5nczsNCg0KdXNlIEZpbGU6OkZpbmQ7DQp1c2UgU3dpdGNo Ow0KDQpteSAkZGlyID0gJy91c3IvZG9jL2VuX1VTLklTTzg4NTktMS9ib29r cy9oYW5kYm9vay8nOw0KbXkgJGdsb3NzYXJ5ID0gJy91c3IvZG9jL2VuX1VT LklTTzg4NTktMS9zaGFyZS9zZ21sL2dsb3NzYXJ5L2ZyZWVic2QtZ2xvc3Nh cnkuc2dtbCc7DQpteSAkZmlsZWV4dCA9ICcuc2dtbCc7DQpteSAlYWNyb255 bXM7DQoNCiMgYWRkIHRlcm1zIHRvIGxpc3QNCmZpbmQoXCZ3YW50ZWQsICRk aXIpOw0KDQojIHJlbW92ZSB0ZXJtcyBhbHJlYWR5IGRlZmluZWQgaW4gZ2xv c3NhcnkNCnRlcm1zKCRnbG9zc2FyeSwnZGVsJyk7DQoNCm15IEBzb3J0ZWQg PSBzb3J0IGtleXMgJWFjcm9ueW1zOw0KDQpmb3JlYWNoIChAc29ydGVkKSB7 DQogICAgcHJpbnQgIiRfXG4iOw0KfQ0KDQpleGl0IDA7DQoNCnN1YiB3YW50 ZWQgew0KICAgIG15KCRmbmFtZSkgPSAkXzsNCiAgICBpZiAoKC1mICRmbmFt ZSkgYW5kICgkZm5hbWUgPX4gLyRmaWxlZXh0LykpIHsNCiAgICAgICAgdGVy bXMoJGZuYW1lLCAnYWRkJyk7DQogICAgfQ0KfSAgICAgICAgICAgDQoNCnN1 YiB0ZXJtcyB7DQogICAgbXkoJGZuYW1lLCAkb3ApID0gQF87DQogICAgb3Bl biBteSAkZmgsICRmbmFtZSBvciBkaWUgIioqIGNvdWxkbid0IG9wZW4gJyRm bmFtZSctLSQhIjsNCiAgICB3aGlsZSAoPCRmaD4pIHsNCiAgICAgICAgaWYg KC88YWNyb255bT4oXHcrKS8pIHsNCiAgICAgICAgICAgIHN3aXRjaCAoJG9w KSB7DQogICAgICAgICAgICAgICAgIGNhc2UgJ2FkZCcgICB7ICRhY3Jvbnlt c3t1YygkMSl9ID0gMSAgICB9DQogICAgICAgICAgICAgICAgIGNhc2UgJ2Rl bCcgICB7IGRlbGV0ZSAkYWNyb255bXN7dWMoJDEpfSB9DQogICAgICAgICAg ICB9DQogICAgICAgIH0NCiAgICB9DQogICAgY2xvc2UgJGZoIG9yIGRpZSAi KiogY291bGRuJ3QgY2xvc2UgJyRmbmFtZSctLSQhIjsNCn0NCg== --0-1462583829-1089773626=:19556-- From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 08:56:10 2004 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 2CCA816A4CE for ; Wed, 14 Jul 2004 08:56:10 +0000 (GMT) Received: from mail.apdip.net (ns2.apdip.net [202.187.94.11]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2C45943D41 for ; Wed, 14 Jul 2004 08:56:09 +0000 (GMT) (envelope-from khairil@apdip.net) Received: from [192.168.0.36] (unknown [202.187.94.4]) by mail.apdip.net (Postfix) with ESMTP id 4901E2A4054; Wed, 14 Jul 2004 14:56:21 +0800 (MYT) From: Khairil Yusof To: Bill Moran In-Reply-To: <20040710183026.0baf1e83.wmoran@potentialtech.com> References: <20040710183026.0baf1e83.wmoran@potentialtech.com> Content-Type: text/plain Message-Id: <1089787716.14700.104.camel@localhost.localdomain> Mime-Version: 1.0 X-Mailer: Ximian Evolution 1.4.6 (1.4.6-2) Date: Wed, 14 Jul 2004 14:49:36 +0800 Content-Transfer-Encoding: 7bit cc: tmclaugh@sdf.lonestar.org cc: doc@freebsd.org Subject: Re: RFC: new doc on jail + quota 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: Wed, 14 Jul 2004 08:56:10 -0000 On Sun, 2004-07-11 at 06:30, Bill Moran wrote: > Now I want to get this documented, and I'm curious as to how folks think > I should do so. I see three possibilities, and the correct thing to do > may be more than one. > 2) Add a chapter to the handbook on running disk quotas within a jail http://lists.freebsd.org/pipermail/freebsd-doc/2004-June/004463.html Was a start, and should be reworked into categories (haven't had much time lately) so that categories/sections like quotas, devfs etc. can be added. After some fixes (by tmclaugh), I was planning to do this sometime in the next week or so. Please go ahead with a section on disk quotas, which I hope can be part of a new Jails chapter/section in the Handbook. -- Khairil Yusof IOSN IT Consultant, UNDP-APDIP, Malaysia DID: +603 2091 5183 Fax: +603 2093 9740 International Open Source Network: http://www.iosn.net UNDP Asia Pacific Development Information Programme http://www.apdip.net GNU/Linux 14:45:54 up 13 days, 58 min, 9 users, load average: 0.27, 0.34, 0.32 From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 13:04:23 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 4BDF916A4CF; Wed, 14 Jul 2004 13:04:23 +0000 (GMT) Date: Wed, 14 Jul 2004 13:04:23 +0000 From: Murray Stokely To: "Craig M. Chandler" Message-ID: <20040714130423.GB66732@hub.freebsd.org> References: <000001c4676e$cd9a4700$6400a8c0@CraigPC> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <000001c4676e$cd9a4700$6400a8c0@CraigPC> User-Agent: Mutt/1.4.1i 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: compusa no longer selling freebsd 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: Wed, 14 Jul 2004 13:04:23 -0000 On Sun, Jul 11, 2004 at 10:55:23AM -0400, Craig M. Chandler wrote: > I did a search on BSD and freebsd and only came up with Mac OS X or some > motherboards. I don't think FreeBSD has ever been available from the CompUSA website, but it was on the shelves of the last CompUSA store I visited. I'll send some email to make sure that is still the case. > Just thought you'd like to know and either change your web page or get them > to sell it. > I think you can get it off Amazon.com (and set up an affiliate program, so > you get a percentage of the sale, when people click through!) Well, we'd rather have people buy from a supporting vendor so more of the money goes back to the project than have to lose 15% or more to Amazon.com. You can buy many FreeBSD books from amazon.com though. - Murray From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 13:08:00 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 0258116A4CF; Wed, 14 Jul 2004 13:08:00 +0000 (GMT) Date: Wed, 14 Jul 2004 13:07:59 +0000 From: Murray Stokely To: Warren Block Message-ID: <20040714130759.GD66732@hub.freebsd.org> References: <20040712171533.R43767@wonkity.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040712171533.R43767@wonkity.com> User-Agent: Mutt/1.4.1i 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: Handbook Acronyms 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: Wed, 14 Jul 2004 13:08:00 -0000 On Mon, Jul 12, 2004 at 05:31:25PM -0600, Warren Block wrote: > In most books, the first use of an acronym or term is defined. With the > Handbook, that is probably not very helpful, since most users will not > read it straight through and may miss the definition. > > A glossary would help, particularly for HTML, where the definition is > just a link away. This fails on paper versions of the Handbook, though. > > Ideally, the first use of a glossary term in a chapter would have a > short definition: > > With NFS (Network File System), files may be... This reads better as 'With the Network File System (NFS), files may be...' rather than having the expanded form in parenthesis, but otherwise I agree with your main point of avoiding undefined acronym-overload. - Murray From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 13:13:30 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id C8D8F16A4CF; Wed, 14 Jul 2004 13:13:30 +0000 (GMT) Date: Wed, 14 Jul 2004 13:13:30 +0000 From: Murray Stokely To: Warren Block Message-ID: <20040714131330.GE66732@hub.freebsd.org> References: <20040712171533.R43767@wonkity.com> <20040713165232.GT29928@submonkey.net> <20040713235332.GD29928@submonkey.net> <20040713203222.R19556@wonkity.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040713203222.R19556@wonkity.com> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Ceri Davies cc: doc@FreeBSD.org Subject: Re: Handbook Acronyms 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: Wed, 14 Jul 2004 13:13:30 -0000 On Tue, Jul 13, 2004 at 08:53:46PM -0600, Warren Block wrote: > Surprisingly, it turns out that the terms presently defined in the > glossary are not used in the Handbook at all, and vice versa. Yes the current terms look a bit out of place in the Handbook. There are mostly developer terms and acronyms from our community mailing lists at the moment. It's nice to have them somewhere, but they aren't relevant with the Handbook. It would be great if we could continue maintaining a master glossary like we do now, but add stylesheet support to only pull in those terms that are actually used in a given document. All the tools are there, someone just needs to write the code. A supplemental perl script might be used in addition to the DSSSL code to implement this. Any takers? =) - Murray From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 15:00:28 2004 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 A741716A4CE for ; Wed, 14 Jul 2004 15:00:28 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 86D5443D2D for ; Wed, 14 Jul 2004 15:00:25 +0000 (GMT) (envelope-from iaccounts@ibctech.ca) Received: (qmail 33408 invoked by uid 1002); 14 Jul 2004 15:01:06 -0000 Received: from iaccounts@ibctech.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.097853 secs); 14 Jul 2004 15:01:06 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 14 Jul 2004 15:01:05 -0000 Received: from 209.167.16.15 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Wed, 14 Jul 2004 11:01:05 -0400 (EDT) Message-ID: <4233.209.167.16.15.1089817265.squirrel@209.167.16.15> Date: Wed, 14 Jul 2004 11:01:05 -0400 (EDT) From: "Steve Bertrand" To: freebsd-doc@freebsd.org User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal References: In-Reply-To: Subject: Creating local doc repository 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: Wed, 14 Jul 2004 15:00:28 -0000 As I'm very interested in learning 'howto' contribute to the documentation project, I'm working through the documentation primer. I'm have some confusion on the best method to check out (or copy the sources locally) of the entire doc tree. Can I just check them out from the FreeBSD servers directly, if so, is there documentation I could be pointed to that will get me started with the correct server name, repository name etc? or; Can I just mirror the doc tree locally? I've tried this with cvsup to no avail. From the info I've gathered, I've concaucted the following supfile: #*default tag=RELENG_4 *default host=cvsup-master.FreeBSD.org *default release=cvs *default base=/usr/local/etc/cvsup *default prefix=/home/steve/doc *default delete use-rel-suffix *default umask=002 cvsroot-doc ...with the following result (after successfully connecting to the server): Authentication required, but could not open "/home/steve/.cvsup/auth" Any information on how I can get a copy of the source so I can begin the process of attempting my own contribs would be greatly appreciated. Thanks for any leads to howto's, advice etc. Steve From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 15:06:00 2004 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 7FF0916A4CE for ; Wed, 14 Jul 2004 15:06:00 +0000 (GMT) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8551A43D3F for ; Wed, 14 Jul 2004 15:05:59 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) i6EF5v5j027339; Wed, 14 Jul 2004 17:05:57 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6EF5uUi027338; Wed, 14 Jul 2004 17:05:56 +0200 (CEST) (envelope-from marc) Date: Wed, 14 Jul 2004 17:05:56 +0200 From: Marc Fonvieille To: Steve Bertrand Message-ID: <20040714150556.GD76610@abigail.blackend.org> References: <4233.209.167.16.15.1089817265.squirrel@209.167.16.15> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4233.209.167.16.15.1089817265.squirrel@209.167.16.15> User-Agent: Mutt/1.4.2.1i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.10-PRERELEASE cc: freebsd-doc@freebsd.org Subject: Re: Creating local doc repository 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: Wed, 14 Jul 2004 15:06:00 -0000 On Wed, Jul 14, 2004 at 11:01:05AM -0400, Steve Bertrand wrote: > As I'm very interested in learning 'howto' contribute to the documentation > project, I'm working through the documentation primer. > > I'm have some confusion on the best method to check out (or copy the > sources locally) of the entire doc tree. > > Can I just check them out from the FreeBSD servers directly, if so, is > there documentation I could be pointed to that will get me started with > the correct server name, repository name etc? or; > http://www.bsdnews.org/02/freebsd_doc.php describes what I use for doc/ tree, www/ is similar. Marc From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 15:07:10 2004 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 0E61916A4CE for ; Wed, 14 Jul 2004 15:07:10 +0000 (GMT) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id A71A443D39 for ; Wed, 14 Jul 2004 15:07:09 +0000 (GMT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) i6EF79TH011768; Wed, 14 Jul 2004 11:07:09 -0400 (EDT) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id i6EF7875011767; Wed, 14 Jul 2004 11:07:08 -0400 (EDT) Date: Wed, 14 Jul 2004 11:07:08 -0400 From: Ken Smith To: Steve Bertrand Message-ID: <20040714150708.GG7787@electra.cse.Buffalo.EDU> References: <4233.209.167.16.15.1089817265.squirrel@209.167.16.15> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4233.209.167.16.15.1089817265.squirrel@209.167.16.15> User-Agent: Mutt/1.4.1i cc: freebsd-doc@freebsd.org Subject: Re: Creating local doc repository 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: Wed, 14 Jul 2004 15:07:10 -0000 On Wed, Jul 14, 2004 at 11:01:05AM -0400, Steve Bertrand wrote: > #*default tag=RELENG_4 > *default host=cvsup-master.FreeBSD.org > *default release=cvs > *default base=/usr/local/etc/cvsup > *default prefix=/home/steve/doc > *default delete use-rel-suffix > *default umask=002 > cvsroot-doc > > ...with the following result (after successfully connecting to the server): > > Authentication required, but could not open "/home/steve/.cvsup/auth" cvsup-master.freebsd.org is set up to only allow other official mirror sites (cvsup.freebsd.org. cvsup1.freebsd.org, etc) to connect to it. Try another of the official mirror sites, they allow connections from any host. You might try using 'ping' first to see if you can locate a server close to you network-wise, though some servers are more overloaded than others. Or you can just use mine, cvsup9.freebsd.org... :-) -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel | From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 15:09:21 2004 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 0486616A4CE for ; Wed, 14 Jul 2004 15:09:21 +0000 (GMT) Received: from q.closedsrc.org (ip233.gte244.dsl-acs2.sea.iinet.com [209.20.244.233]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7D33D43D45 for ; Wed, 14 Jul 2004 15:09:18 +0000 (GMT) (envelope-from question+fbsddoc@closedsrc.org) Received: by q.closedsrc.org (Postfix, from userid 1001) id C2F0C45080; Wed, 14 Jul 2004 08:04:43 -0700 (PDT) Date: Wed, 14 Jul 2004 08:04:43 -0700 From: Linh Pham To: Steve Bertrand Message-ID: <20040714150443.GH33462@q.internal.closedsrc.org> References: <4233.209.167.16.15.1089817265.squirrel@209.167.16.15> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="V88s5gaDVPzZ0KCq" Content-Disposition: inline In-Reply-To: <4233.209.167.16.15.1089817265.squirrel@209.167.16.15> Organization: closedsrc.org Mail-Copies-To: poster X-PGP-Key: http://closedsrc.org/~question/pubkey.asc User-Agent: Mutt/1.5.6i cc: freebsd-doc@freebsd.org Subject: Re: Creating local doc repository 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: Wed, 14 Jul 2004 15:09:21 -0000 --V88s5gaDVPzZ0KCq Content-Type: multipart/mixed; boundary="98e8jtXdkpgskNou" Content-Disposition: inline --98e8jtXdkpgskNou Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004-07-14 11:01 -0400, Steve Bertrand wrote: # I've concaucted the following supfile: #=20 # #*default tag=3DRELENG_4 # *default host=3Dcvsup-master.FreeBSD.org # *default release=3Dcvs # *default base=3D/usr/local/etc/cvsup # *default prefix=3D/home/steve/doc # *default delete use-rel-suffix # *default umask=3D002 # cvsroot-doc The host can be any FreeBSD CVSup server, such as cvsup.freebsd.org or cvsup3.freebsd.org so long as it the tree you want. I have attached the supfile that I am using to pull down the doc tree. You can just replace the host, base and prefix to your liking. I used the doc-supfile under /usr/share/examples/cvsup as my template. HTH --=20 Linh Pham question+fbsddoc@closedsrc.org Webmaster and FreeBSD Geek http://closedsrc.org Apprentice Manager Editor and Writer http://www.daemonnews.org Q->Worf: Eat any good books lately? | Humans =3D Ugly Bags of Mostly Water --98e8jtXdkpgskNou Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename=doc-supfile *default host=cvsup.FreeBSD.org *default base=/u01/freebsd-doc *default prefix=/u01/freebsd-doc *default release=cvs tag=. *default delete use-rel-suffix # If your network link is a T1 or faster, comment out the following line. *default compress # This will retrieve the entire doc branch of the FreeBSD repository. # This includes the handbook, FAQ, and translations thereof. doc-all --98e8jtXdkpgskNou-- --V88s5gaDVPzZ0KCq Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA9UuLwhofDeWkDMIRAt+7AKCy8rPGTlRDYGf7QRVDshqRXgAk4QCfSjwq hyvXQWQlrtYsut9Nz5/FCfY= =ROrX -----END PGP SIGNATURE----- --V88s5gaDVPzZ0KCq-- From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 15:17:42 2004 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 5BD1516A4CE for ; Wed, 14 Jul 2004 15:17:42 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id B0EF043D2F for ; Wed, 14 Jul 2004 15:17:40 +0000 (GMT) (envelope-from iaccounts@ibctech.ca) Received: (qmail 36222 invoked by uid 1002); 14 Jul 2004 15:18:20 -0000 Received: from iaccounts@ibctech.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.098813 secs); 14 Jul 2004 15:18:20 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 14 Jul 2004 15:18:18 -0000 Received: from 209.167.16.15 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Wed, 14 Jul 2004 11:18:18 -0400 (EDT) Message-ID: <4264.209.167.16.15.1089818298.squirrel@209.167.16.15> In-Reply-To: <20040714150708.GG7787@electra.cse.Buffalo.EDU> References: <4233.209.167.16.15.1089817265.squirrel@209.167.16.15> <20040714150708.GG7787@electra.cse.Buffalo.EDU> Date: Wed, 14 Jul 2004 11:18:18 -0400 (EDT) From: "Steve Bertrand" To: "Ken Smith" User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal cc: freebsd-doc@freebsd.org Subject: Re: Creating local doc repository 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: Wed, 14 Jul 2004 15:17:42 -0000 > On Wed, Jul 14, 2004 at 11:01:05AM -0400, Steve Bertrand wrote: > >> #*default tag=RELENG_4 >> *default host=cvsup-master.FreeBSD.org >> *default release=cvs >> *default base=/usr/local/etc/cvsup >> *default prefix=/home/steve/doc >> *default delete use-rel-suffix >> *default umask=002 >> cvsroot-doc >> >> ...with the following result (after successfully connecting to the >> server): >> >> Authentication required, but could not open "/home/steve/.cvsup/auth" > > cvsup-master.freebsd.org is set up to only allow other official mirror > sites (cvsup.freebsd.org. cvsup1.freebsd.org, etc) to connect to it. > > Try another of the official mirror sites, they allow connections from > any host. You might try using 'ping' first to see if you can locate > a server close to you network-wise, though some servers are more > overloaded > than others. Or you can just use mine, cvsup9.freebsd.org... :-) > Indeed, as soon as I changed the hostname from cvsup-master, the authentication error dissapeared and I'm now happily aquiring the required files. Thanks for all the adivce ;o) Steve > -- > Ken Smith > - From there to here, from here to | kensmith@cse.buffalo.edu > there, funny things are everywhere. | > - Theodore Geisel | > From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 15:33:00 2004 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 1A0B416A4CE; Wed, 14 Jul 2004 15:33:00 +0000 (GMT) Received: from msgbas2x.cos.agilent.com (msgbas2x.cos.agilent.com [192.25.240.37]) by mx1.FreeBSD.org (Postfix) with ESMTP id 81BB543D45; Wed, 14 Jul 2004 15:32:54 +0000 (GMT) (envelope-from des@des.no) Received: from enccos4.cos.agilent.com (enccos4.cos.agilent.com [130.29.152.93]) by msgbas2x.cos.agilent.com (Postfix) with SMTP id B5264838A; Wed, 14 Jul 2004 09:32:53 -0600 (MDT) Received: from relcos2.cos.agilent.com (130.29.152.237) by enccos4.cos.agilent.com (Sigaba Gateway v3.83) with ESMTP id 11661611; Wed, 14 Jul 2004 09:33:16 -0600 Received: from wcosbh22.cos.agilent.com (wcosbh22.cos.agilent.com [130.29.152.178]) by relcos2.cos.agilent.com (Postfix) with ESMTP id D490F603; Wed, 14 Jul 2004 09:32:52 -0600 (MDT) Received: from wcosbh23.cos.agilent.com ([130.29.152.145]) by wcosbh22.cos.agilent.com with Microsoft SMTPSVC(5.0.2195.6713); Wed, 14 Jul 2004 09:32:51 -0600 Received: from mail pickup service by wcosbh23.cos.agilent.com with Microsoft SMTPSVC; Wed, 14 Jul 2004 09:32:50 -0600 Received: from wcosvs23.cos.agilent.com ([130.29.152.143]) by wcosbh23.cos.agilent.com with Microsoft SMTPSVC(5.0.2195.6713); Tue, 6 Jul 2004 08:47:29 -0600 Received: from relcos2.cos.agilent.com ([130.29.152.237]) by 130.29.152.143 with trend_isnt_name_B; Tue, 06 Jul 2004 08:47:23 -0600 Received: from enccos4.cos.agilent.com (enccos4.cos.agilent.com [130.29.152. ; Tue, 6 Jul 2004 08:47:23 -0600 (M DT) Received: from msgbas1x.cos.agilent.com (192.168.148.33)by enccos4.cos.agile nt.com (Sigaba Gateway v3.8)with ESMTP id 8182820; Tue, 06 Jul 2004 08:47:4 4 -0600 Received: from mx2.freebsd.org (mx2.freebsd.org [216.136.204.119])by msgbas1 ; Tue, 6 Jul 2004 08:47:23 -0600 (MDT) Received: from hub.freebsd.org (hub.freebsd.org [216.136.204.18])by mx2.free bsd.org (Postfix) with ESMTPid CC3B456274; Tue, 6 Jul 2004 14:47:10 +0000 (GMT)(envelope-from owner-freebsd-hackers@freebsd.org) Received: from hub.freebsd.org (localhost [127.0.0.1])by hub.freebsd.org (Po stfix) with ESMTPid EDFF116A4CE; Tue, 6 Jul 2004 14:47:09 +0000 (GMT) Delivered-To: freebsd-hackers@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])by hub.fre ebsd.org (Postfix) with ESMTPid 58C6E16A4CE; Tue, 6 Jul 2004 14:47:02 +000 0 (GMT) Received: from smtp.des.no (flood.des.no [217.116.83.31])by mx1.FreeBSD.org (Postfix) with ESMTPid B3BF943D55; Tue, 6 Jul 2004 14:47:01 +0000 (GMT)(en velope-from des@des.no) Received: by smtp.des.no (Pony Express, from userid 666)id 8F015531C; Tue, 6 Jul 2004 16:47:00 +0200 (CEST) Received: from dwp.des.no (des.no [80.203.228.37])by smtp.des.no (Pony Expre ss) with ESMTPid 0B212531B; Tue, 6 Jul 2004 16:46:53 +0200 (CEST) Received: by dwp.des.no (Postfix, from userid 2602)id DCB9DB860; Tue, 6 Jul 2004 16:46:52 +0200 (CEST) To: Xin LI References: <20040625033718.GA1691@frontfree.net> <20040706144102.GA4034@frontfree.net> From: des@des.no (=?iso-8859-1?q?Dag-Erling_Sm=F8rgrav?= ) Date: Tue, 06 Jul 2004 16:46:52 +0200 In-Reply-To: <20040706144102.GA4034@frontfree.net> (Xin LI's message of"Tue, 6 Jul 2004 22:41:02 +0800") Message-ID: User-Agent: Gnus/5.1006 (Gnus v5.10.6) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Spam-Checker-Version: SpamAssassin 2.63 (2004-01-11) on flood.des.no X-Spam-Level: X-Spam-Status: No, hits=0.0 required=5.0 tests=AWL autolearn=no version=2.63 X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Sender: owner-freebsd-hackers@freebsd.org Errors-To: owner-freebsd-hackers@freebsd.org X-OriginalArrivalTime: 06 Jul 2004 14:47:32.0527 (UTC) FILETIME=[2B2C03F0:01C46368] cc: hackers@FreeBSD.org cc: doc@FreeBSD.org Subject: Re: About rules on style changes X-BeenThere: freebsd-doc@freebsd.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Jul 2004 15:33:00 -0000 Xin LI writes: > Hmm... Seems that I have misunderstood the committers' guide, section > 10.3, which said: > > "Do not mix style fixes with new functionality. A style fix is any > change which does not modify the functionality of the code. Mixing the > changes obfuscates the functionality change when using cvs diff, which > can hide any new bugs." That just means you have to do it in a separate commit. We do not generally make style changes for their own sake; instead, we commit style fixes shortly before or after a functional change. DES --=20 Dag-Erling Sm=F8rgrav - des@des.no _______________________________________________ freebsd-hackers@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-hackers To unsubscribe, send any mail to "freebsd-hackers-unsubscribe@freebsd.org" From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 17:45:31 2004 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 66BCA16A4CE; Wed, 14 Jul 2004 17:45:31 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 21D6143D54; Wed, 14 Jul 2004 17:45:31 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 93F8E1430A; Wed, 14 Jul 2004 12:45:30 -0500 (CDT) Date: Wed, 14 Jul 2004 12:45:30 -0500 (CDT) From: Mark Linimon X-X-Sender: linimon@pancho To: Murray Stokely In-Reply-To: <20040714131330.GE66732@hub.freebsd.org> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: Ceri Davies cc: doc@FreeBSD.org Subject: Re: Handbook Acronyms 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: Wed, 14 Jul 2004 17:45:31 -0000 On Wed, 14 Jul 2004, Murray Stokely wrote: > Yes the current terms look a bit out of place in the Handbook. There > are mostly developer terms and acronyms from our community mailing lists > at the moment. It's nice to have them somewhere, but they aren't > relevant with the Handbook. Having written a number of the entries, I agree that the current entries are as described, and that it's nice to have them somewhere. I will demur somewhat about them not being relevant with the Handbook, but if we go that way, where else should we move them? The FAQ? mcl From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 22:32:27 2004 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 1A6EA16A4CE for ; Wed, 14 Jul 2004 22:32:27 +0000 (GMT) Received: from postfix3-2.free.fr (postfix3-2.free.fr [213.228.0.169]) by mx1.FreeBSD.org (Postfix) with ESMTP id E044343D2D for ; Wed, 14 Jul 2004 22:32:26 +0000 (GMT) (envelope-from thetemplar@free.fr) Received: from [82.64.20.104] (lns-th2-2-82-64-20-104.adsl.proxad.net [82.64.20.104]) by postfix3-2.free.fr (Postfix) with ESMTP id A0892C254 for ; Thu, 15 Jul 2004 00:32:22 +0200 (CEST) Message-ID: <40F5B501.8020702@free.fr> Date: Thu, 15 Jul 2004 00:34:41 +0200 From: Eddahbi Karim User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7) Gecko/20040618 X-Accept-Language: fr, en-us, en MIME-Version: 1.0 To: doc@FreeBSD.org Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Subject: [Handbook - Chapter 2.7] Adding informations about "DOS" 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: Wed, 14 Jul 2004 22:32:27 -0000 Hiya, I had to use the DOS installation method because my CD-ROM didn't work and I have an USB Modem which can't be setup while installing FreeBSD. I think that you should some informations about this installation media in the Chapter 2.7 of the Handbook. There's a short description in the INSTALL.TXT file which is stored on the first FreeBSD CD. " 1.5.3 Installing from a DOS partition To prepare for installation from an MS-DOS partition you should simply copy the files from the distribution into a directory called FREEBSD on the Primary DOS partition (C:). For example, to do a minimal installation of FreeBSD from DOS using files copied from the CDROM, you might do something like this: C:\> MD C:\FREEBSD C:\> XCOPY /S E:\BIN C:\FREEBSD\BIN Assuming that E: was where your CD was mounted. For as many distributions as you wish to install from DOS (and you have free space for), install each one in a directory under C:\FREEBSD - the BIN dist is only the minimal requirement. Once you've copied the directories, you can simply launch the installation from floppies as normal and select ``DOS'' as your media type when the time comes. " I think that it's easy to understand and it warns the user about the preparations needed before beginning the installation and using this media. Karim. From owner-freebsd-doc@FreeBSD.ORG Wed Jul 14 23:00:33 2004 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 AD28916A4CE for ; Wed, 14 Jul 2004 23:00:33 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8404343D2D for ; Wed, 14 Jul 2004 23:00:33 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6EN0XNq038693 for ; Wed, 14 Jul 2004 23:00:33 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6EN0X9C038644; Wed, 14 Jul 2004 23:00:33 GMT (envelope-from gnats) Resent-Date: Wed, 14 Jul 2004 23:00:33 GMT Resent-Message-Id: <200407142300.i6EN0X9C038644@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, Rene Ladan Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id ACF7316A4CF for ; Wed, 14 Jul 2004 22:57:13 +0000 (GMT) Received: from 82-168-140-74-bbxl.xdsl.tiscali.nl (82-168-140-74-bbxl.xdsl.tiscali.nl [82.168.140.74]) by mx1.FreeBSD.org (Postfix) with ESMTP id A861343D39 for ; Wed, 14 Jul 2004 22:57:12 +0000 (GMT) (envelope-from r.c.ladan@student.tue.nl) Received: from 82-168-140-74-bbxl.xdsl.tiscali.nl (atmosphere.local [127.0.0.1])i6EMtjCc026837 for ; Thu, 15 Jul 2004 00:55:45 +0200 (CEST) (envelope-from r.c.ladan@student.tue.nl) Received: (from rene@localhost)i6EMtjBm026836; Thu, 15 Jul 2004 00:55:45 +0200 (CEST) (envelope-from r.c.ladan@student.tue.nl) Message-Id: <200407142255.i6EMtjBm026836@82-168-140-74-bbxl.xdsl.tiscali.nl> Date: Thu, 15 Jul 2004 00:55:45 +0200 (CEST) From: Rene Ladan To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69068: handbook errata X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Rene Ladan List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Jul 2004 23:00:33 -0000 >Number: 69068 >Category: docs >Synopsis: handbook errata >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: Wed Jul 14 23:00:33 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Rene Ladan >Release: FreeBSD 5.2.1-RELEASE-p8 i386 >Organization: >Environment: System: FreeBSD 5.2.1-RELEASE-p8 FreeBSD 5.2.1-RELEASE-p8 #0: Fri May 28 06:53:18 CEST 2004 root@atmosphere.local:/usr/obj/usr/src-releng-52/sys/RENE_2004-05-02d i386 >Description: In en_US.ISO8859-1/books/handbook/basics/chapter.sgml rev 1.126, line 1950 'complete to' should be replaced by 'complete further than' 'foobar' and 'foo.bar' are identical up to 'foo', which is where the shell can complete to. It cannot complete further than that without first asking for more user input. >How-To-Repeat: n/a >Fix: see above. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 02:16:50 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id BACB316A4CF; Thu, 15 Jul 2004 02:16:50 +0000 (GMT) Date: Thu, 15 Jul 2004 02:16:50 +0000 From: Murray Stokely To: Mark Linimon Message-ID: <20040715021650.GA34256@hub.freebsd.org> References: <20040714131330.GE66732@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Ceri Davies cc: doc@FreeBSD.org Subject: Re: Handbook Acronyms 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, 15 Jul 2004 02:16:50 -0000 On Wed, Jul 14, 2004 at 12:45:30PM -0500, Mark Linimon wrote: > Having written a number of the entries, I agree that the current entries > are as described, and that it's nice to have them somewhere. I will > demur somewhat about them not being relevant with the Handbook, but if > we go that way, where else should we move them? The FAQ? Keeping them in the Handbook is fine with me, I just think in the long run we'll want tools that create a glossary relevant for the FAQ, Handbook, Developers Handbook, and other documents automatically from the same source file that you are already doing a good job maintaining. POLA, OBE, and other mailing list acronyms aren't needed for the Handbook, but would be good to be included at the end of an article about the freebsd mailing lists, for example. - Murray From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 03:04:34 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id D06A816A4CF; Thu, 15 Jul 2004 03:04:34 +0000 (GMT) Date: Thu, 15 Jul 2004 03:04:34 +0000 From: Murray Stokely To: doc@freebsd.org Message-ID: <20040715030434.GE34256@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D Subject: Spellchecking the DocBook FreeBSD Documentation 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, 15 Jul 2004 03:04:35 -0000 This is a note to explain how I use the tools in CVS to spellcheck our documentation. This is just one of many possible approaches. $ cd /usr/doc/en_US.ISO8859-1/books/handbook $ make clean; make SPELLCHECK=1 spellcheck|sort|uniq|less The SPELLCHECK=1 variable tells the makefile to use the special spellcheck.dsl stylesheet to omit the contents of certain tags (such as ) from the HTML output. This variable should just be removed and automatically added to the spellcheck target. The spellcheck target then runs ispell over the generated HTML files, using the FreeBSD technical lexicon dictionary in /usr/share/dict/freebsd. All mispelled words are printed to standard out, so we should run this through sort and then uniq to remove duplicates. Once a word is found that is not a false positive, then a quick grep through the source will tell you which file has the offending misspelling. This approach converts the DocBook into HTML before spellchecking. Another approach would be to spellcheck the DocBook source directly, examining the tags and deciding what to ignore. This could be done with an SGML aware spellchecker (aspell doesn't seem nearly powerful enough to me), or with a scripting language and SGML parsing libraries. I think that would be more work than using DSSSL or XSL for the parsing though. Chern Lee wrote and posted a TCL script here several years ago, and his script may give better output than the 'make spellcheck' stuff I've implemented above. If it does, we should add it to CVS. - Murray From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 06:56:43 2004 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 2E58B16A4CE; Thu, 15 Jul 2004 06:56:43 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 290B343D41; Thu, 15 Jul 2004 06:56:43 +0000 (GMT) (envelope-from murray@FreeBSD.org) Received: from freefall.freebsd.org (murray@localhost [127.0.0.1]) i6F6uhkW001598; Thu, 15 Jul 2004 06:56:43 GMT (envelope-from murray@freefall.freebsd.org) Received: (from murray@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F6ugZq001594; Thu, 15 Jul 2004 06:56:42 GMT (envelope-from murray) Date: Thu, 15 Jul 2004 06:56:42 GMT From: Murray Stokely Message-Id: <200407150656.i6F6ugZq001594@freefall.freebsd.org> To: dkg@con-fuse.org, murray@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/68115: ISO-IMAGES-i386/README.TXT - cdrecord is able to deal with IDE 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: Thu, 15 Jul 2004 06:56:43 -0000 Synopsis: ISO-IMAGES-i386/README.TXT - cdrecord is able to deal with IDE devices State-Changed-From-To: open->closed State-Changed-By: murray State-Changed-When: Thu Jul 15 06:55:46 GMT 2004 State-Changed-Why: Whether cdrecord supports ATAPI drives or not is irrellevant. This readme just includes a quick note that says we recommend cdrecord for SCSI and burncd for ATA. One reason we recommend cdrecord only for the SCSI case, is because people spend too much time figuring out wheter or not cdrecord will work for their ATAPI drive when they could just use burncd and be done with it. We are just giving pointers to some possible tools, not documenting the features of those tools. Thanks for the submission. http://www.freebsd.org/cgi/query-pr.cgi?pr=68115 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 06:58:38 2004 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 5F9A116A4CE for ; Thu, 15 Jul 2004 06:58:38 +0000 (GMT) Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100]) by mx1.FreeBSD.org (Postfix) with ESMTP id 11FA743D1D for ; Thu, 15 Jul 2004 06:58:38 +0000 (GMT) (envelope-from den@FreeBSD.org) Received: from FreeBSD.org (llp-13.vistcom.ru [217.23.84.68]) by volginfo.ru (Postfix) with ESMTP id 364832016 for ; Thu, 15 Jul 2004 10:58:38 +0400 (MSD) Message-ID: <40F62B1B.9020404@FreeBSD.org> Date: Thu, 15 Jul 2004 10:58:35 +0400 From: Denis Peplin User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.6) Gecko/20040205 X-Accept-Language: ru, en-us, en MIME-Version: 1.0 To: freebsd-doc@FreeBSD.org Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Subject: www usage statistic is outdated 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, 15 Jul 2004 06:58:38 -0000 Hello! I found that http://www.freebsd.org/statistic/www.html is outdated: Analysed requests from Fri-21-Nov-2003 00:01 to Thu-11-Dec-2003 00:04 (20.00 days) From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:00:45 2004 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 09DB416A4CF for ; Thu, 15 Jul 2004 07:00:45 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E45E443D39 for ; Thu, 15 Jul 2004 07:00:44 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6F70isn001739 for ; Thu, 15 Jul 2004 07:00:44 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F70iDN001736; Thu, 15 Jul 2004 07:00:44 GMT (envelope-from gnats) Resent-Date: Thu, 15 Jul 2004 07:00:44 GMT Resent-Message-Id: <200407150700.i6F70iDN001736@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, Alexey Dokuchaev Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E053116A4CE for ; Thu, 15 Jul 2004 06:59:16 +0000 (GMT) Received: from mx.nsu.ru (mx.nsu.ru [212.192.164.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6341A43D55 for ; Thu, 15 Jul 2004 06:59:15 +0000 (GMT) (envelope-from danfe@regency.nsu.ru) Received: from regency.nsu.ru ([193.124.210.26]) by mx.nsu.ru with esmtp (Exim 4.32) id 1Bl0Ip-00066F-9p for FreeBSD-gnats-submit@freebsd.org; Thu, 15 Jul 2004 14:05:11 +0700 Received: from regency.nsu.ru (localhost [127.0.0.1]) by regency.nsu.ru (8.12.10/8.12.10) with ESMTP id i6F7159k099571 for ; Thu, 15 Jul 2004 14:01:05 +0700 (NOVST) (envelope-from danfe@regency.nsu.ru) Received: (from danfe@localhost) by regency.nsu.ru (8.12.10/8.12.10/Submit) id i6F714tO099473; Thu, 15 Jul 2004 14:01:05 +0700 (NOVST) (envelope-from danfe) Message-Id: <200407150701.i6F714tO099473@regency.nsu.ru> Date: Thu, 15 Jul 2004 14:01:05 +0700 (NOVST) From: Alexey Dokuchaev To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69086: Porters Handbook: How to convert from CR/LF to LF using REINPLACE_CMD X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Alexey Dokuchaev List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Jul 2004 07:00:45 -0000 >Number: 69086 >Category: docs >Synopsis: Porters Handbook: How to convert from CR/LF to LF using REINPLACE_CMD >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Thu Jul 15 07:00:44 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Alexey Dokuchaev >Release: FreeBSD 4.9-STABLE i386 >Organization: CNIT NSU >Environment: System: FreeBSD regency.nsu.ru 4.9-STABLE FreeBSD 4.9-STABLE #1: Wed Mar 3 13:17:54 NOVT 2004 root@regency.nsu.ru:/usr/src/sys/compile/REGENCY i386 >Description: Quite often, we have to port sotfware written for or under Windows/DOS, which use dumb CR/LF convention for text files instead of Unix plain LF. This often causes problems with further patching, compiler warning, scipts execution (/bin/sh^M not found), etc. Since there's no standard practice of dealing with such situations, people often come up with all sorts of solutions, i.e. supplying explicit patches in files/, adding dependency(!!!) on dos2unix, of wrapping tr -d '\r' in a script and calling it instead of sed(1) in my proposal, which is simple and straightforward. I therefore suggest including this in Porter's Handbook, as in attached patch. >How-To-Repeat: Try porting some fairly complex CR/LF code. >Fix: Index: book.sgml =================================================================== RCS file: /home/pub/ftp/pub/FreeBSD/development/FreeBSD-CVS//doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.461 diff -u -r1.461 book.sgml --- book.sgml 12 Jul 2004 08:24:15 -0000 1.461 +++ book.sgml 15 Jul 2004 06:55:26 -0000 @@ -681,6 +681,24 @@ lines!); define USE_AUTOCONF_VER=213 and take the diffs of configure.in. + Quite often, there is a situation when ported software, being + primarily developed on Windows, uses CR/LF convention for most of its + source files. This may cause problems with further patching, compiler + warnings, scipts execution (/bin/sh^M not found), + etc. To quickly convert those files from CR/LF to just LF, you can do + something like this: + + USE_REINPLACE= yes + +post-extract: + @${FIND} -E ${WRKDIR} -type f -iregex ".*\.(c|cpp|h|txt)" \ + -exec ${REINPLACE_CMD} -e 's/[[:cntrl:]]*$$//' '{}' \; + + Of course, if you need to process each and every file, + above can be omitted. Be aware that this + piece of code will strip all trailing control characters from each + line of processed file (except \n). + Also, if you had to delete a file, then you can do it in the post-extract target rather than as part of the patch. Once you are happy with the resulting diff, please split >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:09:23 2004 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 8E73B16A4CE; Thu, 15 Jul 2004 07:09:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7417A43D46; Thu, 15 Jul 2004 07:09:23 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6F79NbD005729; Thu, 15 Jul 2004 07:09:23 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F79NSf005725; Thu, 15 Jul 2004 07:09:23 GMT (envelope-from roam) Date: Thu, 15 Jul 2004 07:09:23 GMT From: Peter Pentchev Message-Id: <200407150709.i6F79NSf005725@freefall.freebsd.org> To: roam@FreeBSD.org, freebsd-doc@FreeBSD.org, imp@FreeBSD.org Subject: Re: docs/66771: [patch] usr.sbin/pccard/pccardc/pccardc.8 grammar and nits 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, 15 Jul 2004 07:09:23 -0000 Synopsis: [patch] usr.sbin/pccard/pccardc/pccardc.8 grammar and nits Responsible-Changed-From-To: freebsd-doc->imp Responsible-Changed-By: roam Responsible-Changed-When: Thu Jul 15 07:09:11 GMT 2004 Responsible-Changed-Why: Over to our PC-CARD maintainer. http://www.freebsd.org/cgi/query-pr.cgi?pr=66771 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:10:24 2004 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 B24DC16A4CE for ; Thu, 15 Jul 2004 07:10:24 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id A9A7843D3F for ; Thu, 15 Jul 2004 07:10:24 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6F7AOW4005835 for ; Thu, 15 Jul 2004 07:10:24 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F7AOVn005834; Thu, 15 Jul 2004 07:10:24 GMT (envelope-from gnats) Date: Thu, 15 Jul 2004 07:10:24 GMT Message-Id: <200407150710.i6F7AOVn005834@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Murray Stokely Subject: Re: docs/69068: handbook errata 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: Thu, 15 Jul 2004 07:10:24 -0000 The following reply was made to PR docs/69068; it has been noted by GNATS. From: Murray Stokely To: Rene Ladan Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/69068: handbook errata Date: Thu, 15 Jul 2004 07:05:31 +0000 On Thu, Jul 15, 2004 at 12:55:45AM +0200, Rene Ladan wrote: > In en_US.ISO8859-1/books/handbook/basics/chapter.sgml rev 1.126, > line 1950 'complete to' should be replaced by 'complete further than' No, 'complete to' is correct. 'complete further than' would be incorrect. The shell would not be able to complete further than 'foo' because it doesn't know if a 'b' or '.' would be next. > 'foobar' and 'foo.bar' are identical up to 'foo', which is where > the shell can complete to. It cannot complete further than that without > first asking for more user input. That what the existing text says. Please re-read it, and then confirm that I can close this PR. " Both foobar and foo.bar start with fo, but it was able to complete to foo. If you type in ., then hit Tab again, the shell would be able to fill in the rest of the filename for you." - Murray From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:17:09 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 4068116A4CF; Thu, 15 Jul 2004 07:17:09 +0000 (GMT) Date: Thu, 15 Jul 2004 07:17:09 +0000 From: Murray Stokely To: Marc Fonvieille Message-ID: <20040715071709.GB55440@hub.freebsd.org> References: <20040713074042.GA5126@abigail.blackend.org> <20040713170624.GU29928@submonkey.net> <20040713181500.GA10935@abigail.blackend.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040713181500.GA10935@abigail.blackend.org> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Ceri Davies cc: doc@FreeBSD.org Subject: Re: RFC: initialisms and FDP 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, 15 Jul 2004 07:17:09 -0000 On Tue, Jul 13, 2004 at 08:15:00PM +0200, Marc Fonvieille wrote: > You're right, I did not read carefully last commits. However Murray's > commit helps me to "bounce" on something I discreetly mentioned: > NTP, SMTP, TCP etc... should be tagged (I mean replaced with an entity) ? > What will be considered as an acronym? Everything or just some terms? I marked up the NIS in that chapter mainly because NFS was already done and it just wasn't consistent, then after I got to about the 30th occurrence and realized I wasn't nearly finished with the file I created the ⋼ entity. It would be really nice if we had some applications of all these tags before spamming our SGML files with them. I think it would be really cool if we had a mouse over rule for the HTML output to display the expanded form of the abbreviation. Also, the first occurence in a file could point to the glossary as was mentioned. Until we have some kind of application, I don't want to spend any time adding tags. How are mouseover's defined these days? Is this standardized in CSS2 or only a Javascript thing? If it's in CSS2, then we could write some simple xsl code to make a pass through the docs and output some rules to append to docbook.css during the build. - Murray From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:23:36 2004 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 2894D16A4CE; Thu, 15 Jul 2004 07:23:36 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0D0A043D1F; Thu, 15 Jul 2004 07:23:36 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6F7NZeq006350; Thu, 15 Jul 2004 07:23:35 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F7NZ0l006346; Thu, 15 Jul 2004 07:23:35 GMT (envelope-from roam) Date: Thu, 15 Jul 2004 07:23:35 GMT From: Peter Pentchev Message-Id: <200407150723.i6F7NZ0l006346@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, roam@FreeBSD.org, freebsd-doc@FreeBSD.org, roam@FreeBSD.org Subject: Re: docs/66826: [patch] RELENG_4 share/man/man4/man4.i386/pnp.4 grammar, sentence breaks 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, 15 Jul 2004 07:23:36 -0000 Synopsis: [patch] RELENG_4 share/man/man4/man4.i386/pnp.4 grammar, sentence breaks State-Changed-From-To: open->analyzed State-Changed-By: roam State-Changed-When: Thu Jul 15 07:22:59 GMT 2004 State-Changed-Why: I'll take this one. Responsible-Changed-From-To: freebsd-doc->roam Responsible-Changed-By: roam Responsible-Changed-When: Thu Jul 15 07:22:59 GMT 2004 Responsible-Changed-Why: I'll take this one. http://www.freebsd.org/cgi/query-pr.cgi?pr=66826 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:30:42 2004 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 D5AEE16A512; Thu, 15 Jul 2004 07:30:42 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 329FC43D49; Thu, 15 Jul 2004 07:30:30 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 9807F119E6; Thu, 15 Jul 2004 09:30:28 +0200 (CEST) Date: Thu, 15 Jul 2004 09:30:28 +0200 From: "Simon L. Nielsen" To: Murray Stokely Message-ID: <20040715073027.GA725@zaphod.nitro.dk> References: <20040713074042.GA5126@abigail.blackend.org> <20040713170624.GU29928@submonkey.net> <20040713181500.GA10935@abigail.blackend.org> <20040715071709.GB55440@hub.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="qMm9M+Fa2AknHoGS" Content-Disposition: inline In-Reply-To: <20040715071709.GB55440@hub.freebsd.org> User-Agent: Mutt/1.5.6i cc: Ceri Davies cc: doc@FreeBSD.org cc: Marc Fonvieille Subject: Re: RFC: initialisms and FDP 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, 15 Jul 2004 07:30:43 -0000 --qMm9M+Fa2AknHoGS Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.15 07:17:09 +0000, Murray Stokely wrote: > It would be really nice if we had some applications of all these > tags before spamming our SGML files with them. I think it > would be really cool if we had a mouse over rule for the HTML output > to display the expanded form of the abbreviation. Also, the first > occurence in a file could point to the glossary as was mentioned. That actually might be rather simple to do, by doing copy-paste of the DSSSL code I made for the trademark stuff. > Until we have some kind of application, I don't want to spend any time > adding tags. >=20 > How are mouseover's defined these days? Is this standardized in CSS2 > or only a Javascript thing? If it's in CSS2, then we could write some > simple xsl code to make a pass through the docs and output some rules > to append to docbook.css during the build. It's actually defined (to a degree) in HTML 4. The title attribute on most tags can be used to create a single line mouseover text. E.g. see the language selection on http://www.freebsd.org/. If we need multi-line I think it has to be done with JavaScript - at least I couldn't find a proper way the last time I looked. Of course there is also the HTML acronym tag (which might be named something different but the idea is the same as the DocBook one) that can be used. In most browsers that renders to a dotted underlined item which can be used to indicate an acronym and then the title attribute can be used to actually get a mouseover explanation. --=20 Simon L. Nielsen FreeBSD Documentation Team --qMm9M+Fa2AknHoGS Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA9jKTh9pcDSc1mlERAiXvAKC8n35c+13OIZDdkdfEMvgmnrU5JwCeIO7h 4fGOR46f2NHHVdQ/n4BvY8g= =P4Rl -----END PGP SIGNATURE----- --qMm9M+Fa2AknHoGS-- From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:34:57 2004 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 67CCB16A4CF; Thu, 15 Jul 2004 07:34:57 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3FBE543D46; Thu, 15 Jul 2004 07:34:57 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6F7YvIN007672; Thu, 15 Jul 2004 07:34:57 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F7YvSv007668; Thu, 15 Jul 2004 07:34:57 GMT (envelope-from roam) Date: Thu, 15 Jul 2004 07:34:57 GMT From: Peter Pentchev Message-Id: <200407150734.i6F7YvSv007668@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, roam@FreeBSD.org, freebsd-doc@FreeBSD.org, roam@FreeBSD.org Subject: Re: docs/66827: [patch] usr.sbin/usbd/usbd.conf.5 bad command syntax in example, minor markup nit. 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, 15 Jul 2004 07:34:57 -0000 Synopsis: [patch] usr.sbin/usbd/usbd.conf.5 bad command syntax in example, minor markup nit. State-Changed-From-To: open->patched State-Changed-By: roam State-Changed-When: Thu Jul 15 07:34:28 GMT 2004 State-Changed-Why: Fix committed to -CURRENT, will MFC in two weeks. Thanks for the patch! Responsible-Changed-From-To: freebsd-doc->roam Responsible-Changed-By: roam Responsible-Changed-When: Thu Jul 15 07:34:28 GMT 2004 Responsible-Changed-Why: I'll take care of the MFC. http://www.freebsd.org/cgi/query-pr.cgi?pr=66827 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:50:12 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 6F83216A4CF; Thu, 15 Jul 2004 07:50:12 +0000 (GMT) Date: Thu, 15 Jul 2004 07:50:12 +0000 From: Murray Stokely To: "Simon L. Nielsen" Message-ID: <20040715075012.GD55440@hub.freebsd.org> References: <20040713074042.GA5126@abigail.blackend.org> <20040713170624.GU29928@submonkey.net> <20040713181500.GA10935@abigail.blackend.org> <20040715071709.GB55440@hub.freebsd.org> <20040715073027.GA725@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040715073027.GA725@zaphod.nitro.dk> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Ceri Davies cc: doc@FreeBSD.org cc: Marc Fonvieille Subject: Re: RFC: initialisms and FDP 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, 15 Jul 2004 07:50:12 -0000 On Thu, Jul 15, 2004 at 09:30:28AM +0200, Simon L. Nielsen wrote: > It's actually defined (to a degree) in HTML 4. The title attribute on > most tags can be used to create a single line mouseover text. > E.g. see the language selection on http://www.freebsd.org/. If we > need multi-line I think it has to be done with JavaScript - at least I > couldn't find a proper way the last time I looked. Single-line is sufficient for just expanding acronyms. I see that the docbook dsssl stylesheets know how to use the target already. I'll see if I can add a custom handler to set the title, and update the &nis macro I created as a test case. Thanks for a the pointers. - Murray From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 07:53:23 2004 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 7BAFA16A4CE; Thu, 15 Jul 2004 07:53:23 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5D70043D41; Thu, 15 Jul 2004 07:53:23 +0000 (GMT) (envelope-from roam@FreeBSD.org) Received: from freefall.freebsd.org (roam@localhost [127.0.0.1]) i6F7rNlK008335; Thu, 15 Jul 2004 07:53:23 GMT (envelope-from roam@freefall.freebsd.org) Received: (from roam@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F7rNQA008331; Thu, 15 Jul 2004 07:53:23 GMT (envelope-from roam) Date: Thu, 15 Jul 2004 07:53:23 GMT From: Peter Pentchev Message-Id: <200407150753.i6F7rNQA008331@freefall.freebsd.org> To: fox@vader.aacc.cc.md.us, roam@FreeBSD.org, freebsd-doc@FreeBSD.org, roam@FreeBSD.org Subject: Re: docs/66828: [patch] /usr/src/sys/conf/NOTES spelling and punctuation nits. 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, 15 Jul 2004 07:53:23 -0000 Synopsis: [patch] /usr/src/sys/conf/NOTES spelling and punctuation nits. State-Changed-From-To: open->patched State-Changed-By: roam State-Changed-When: Thu Jul 15 07:52:35 GMT 2004 State-Changed-Why: Committed to -CURRENT with a couple of changes, MFC in two weeks. Thanks! Responsible-Changed-From-To: freebsd-doc->roam Responsible-Changed-By: roam Responsible-Changed-When: Thu Jul 15 07:52:35 GMT 2004 Responsible-Changed-Why: I'll take care of the MFC. http://www.freebsd.org/cgi/query-pr.cgi?pr=66828 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 08:05:33 2004 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 14AC516A4CE; Thu, 15 Jul 2004 08:05:33 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id EAF8343D46; Thu, 15 Jul 2004 08:05:32 +0000 (GMT) (envelope-from murray@FreeBSD.org) Received: from freefall.freebsd.org (murray@localhost [127.0.0.1]) i6F85W9L012770; Thu, 15 Jul 2004 08:05:32 GMT (envelope-from murray@freefall.freebsd.org) Received: (from murray@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F85Wtm012766; Thu, 15 Jul 2004 08:05:32 GMT (envelope-from murray) Date: Thu, 15 Jul 2004 08:05:32 GMT From: Murray Stokely Message-Id: <200407150805.i6F85Wtm012766@freefall.freebsd.org> To: r.c.ladan@student.tue.nl, murray@FreeBSD.org, freebsd-doc@FreeBSD.org Subject: Re: docs/69068: handbook errata 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, 15 Jul 2004 08:05:33 -0000 Synopsis: handbook errata State-Changed-From-To: open->closed State-Changed-By: murray State-Changed-When: Thu Jul 15 08:04:46 GMT 2004 State-Changed-Why: Closed at submitter's request. The text was simply misread. http://www.freebsd.org/cgi/query-pr.cgi?pr=69068 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 08:30:28 2004 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 C899F16A4CE for ; Thu, 15 Jul 2004 08:30:28 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BFFC543D45 for ; Thu, 15 Jul 2004 08:30:28 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6F8USsD014103 for ; Thu, 15 Jul 2004 08:30:28 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6F8USTD014100; Thu, 15 Jul 2004 08:30:28 GMT (envelope-from gnats) Resent-Date: Thu, 15 Jul 2004 08:30:28 GMT Resent-Message-Id: <200407150830.i6F8USTD014100@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, Janos Mohacsi Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 444C016A4CE for ; Thu, 15 Jul 2004 08:23:46 +0000 (GMT) Received: from norfolk.ki.iif.hu (norfolk.ki.iif.hu [193.6.222.32]) by mx1.FreeBSD.org (Postfix) with ESMTP id 830CF43D48 for ; Thu, 15 Jul 2004 08:23:45 +0000 (GMT) (envelope-from mohacsi@norfolk.ki.iif.hu) Received: (from mohacsi@localhost) by norfolk.ki.iif.hu (8.12.11/8.12.11) id i6F8NVB3025354; Thu, 15 Jul 2004 10:23:31 +0200 (CEST) (envelope-from mohacsi) Message-Id: <200407150823.i6F8NVB3025354@norfolk.ki.iif.hu> Date: Thu, 15 Jul 2004 10:23:31 +0200 (CEST) From: Janos Mohacsi To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69087: sysutils/mkisofs no longer exist X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Janos Mohacsi List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Jul 2004 08:30:28 -0000 >Number: 69087 >Category: docs >Synopsis: sysutils/mkisofs no longer exist >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: Thu Jul 15 08:30:27 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Janos Mohacsi >Release: FreeBSD 5.2-CURRENT i386 >Organization: NIIF >Environment: System: FreeBSD norfolk.ki.iif.hu 5.2-CURRENT FreeBSD 5.2-CURRENT #12: Thu Jul 8 14:37:25 CEST 2004 root@norfolk.ki.iif.hu:/usr/obj/usr/src/sys/NORFOLK i386 >Description: sysutils/mkisofs no longer exist (i.e merged to sysutils/cdrtools) There are lots of reference to mkisofs that has to be update: 1. man page of burncd 2. Chapter 16 of FreeBSD Handbook >How-To-Repeat: Read man page and Chapter 16. >Fix: Do I send patches? >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 08:33:33 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 815) id 9168B16A4CF; Thu, 15 Jul 2004 08:33:33 +0000 (GMT) Date: Thu, 15 Jul 2004 08:33:33 +0000 From: Murray Stokely To: "Simon L. Nielsen" Message-ID: <20040715083333.GA62713@hub.freebsd.org> References: <20040713074042.GA5126@abigail.blackend.org> <20040713170624.GU29928@submonkey.net> <20040713181500.GA10935@abigail.blackend.org> <20040715071709.GB55440@hub.freebsd.org> <20040715073027.GA725@zaphod.nitro.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040715073027.GA725@zaphod.nitro.dk> User-Agent: Mutt/1.4.1i X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: Ceri Davies cc: doc@FreeBSD.org cc: Marc Fonvieille Subject: Mouseover definitions for acronyms (was Re: RFC: initialisms and FDP) 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, 15 Jul 2004 08:33:33 -0000 Ok this is working now. Thanks to Simon for explaining how to do the mouseovers in HTML4. I think that the little dotted underlines will get distracting in a chapter filled with acronyms. For the advanced networking chapter anyway, it might look best if the first occurence of an acronym is rendered with a link to the glossary, and the first three are rendered with the mouseover. I'm not really sure, it's largely up to individual sense of aesthetic. What do others think? You can view network-nis.html on your local system (or on the web site in 6 hours or so) to see what it looks like. - Murray On Thu, Jul 15, 2004 at 09:30:28AM +0200, Simon L. Nielsen wrote: > Of course there is also the HTML acronym tag (which might be named > something different but the idea is the same as the DocBook one) that > can be used. In most browsers that renders to a dotted underlined > item which can be used to indicate an acronym and then the title > attribute can be used to actually get a mouseover explanation. From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 12:00:36 2004 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 EB2DB16A4CE for ; Thu, 15 Jul 2004 12:00:36 +0000 (GMT) Received: from frodo.otenet.gr (frodo.otenet.gr [195.170.0.12]) by mx1.FreeBSD.org (Postfix) with ESMTP id D8F0143D3F for ; Thu, 15 Jul 2004 12:00:33 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226]) by frodo.otenet.gr (8.12.10/8.12.10) with SMTP id i6FC0J3E022069; Thu, 15 Jul 2004 15:00:24 +0300 Received: from orion.daedalusnetworks.priv (orion [127.0.0.1]) i6FC2aUM037749; Thu, 15 Jul 2004 15:02:37 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost)i6FC2TIv037748; Thu, 15 Jul 2004 15:02:29 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Thu, 15 Jul 2004 15:02:29 +0300 From: Giorgos Keramidas To: Eddahbi Karim Message-ID: <20040715120229.GA36824@orion.daedalusnetworks.priv> References: <40F5B501.8020702@free.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <40F5B501.8020702@free.fr> cc: doc@freebsd.org Subject: Re: [Handbook - Chapter 2.7] Adding informations about "DOS" 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, 15 Jul 2004 12:00:37 -0000 On 2004-07-15 00:34, Eddahbi Karim wrote: > Hiya, > > I had to use the DOS installation method because my CD-ROM didn't work > and I have an USB Modem which can't be setup while installing FreeBSD. > > I think that you should some informations about this installation media > in the Chapter 2.7 of the Handbook. > There's a short description in the INSTALL.TXT file which is stored on > the first FreeBSD CD. > > " 1.5.3 Installing from a DOS partition > [snip] Very cool! Thanks for taking the time to mail us. I haven't used a non-CDROM installation for ages, so I wasn't aware that the DOS installation still works. What version of FreeBSD did you install? Did everything go as expected? Any other details that you think DOS-using people should pay attention to? Giorgos From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 12:50:27 2004 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 7D78516A4CE for ; Thu, 15 Jul 2004 12:50:27 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 74AD543D53 for ; Thu, 15 Jul 2004 12:50:27 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6FCoRRt046526 for ; Thu, 15 Jul 2004 12:50:27 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6FCoR16046525; Thu, 15 Jul 2004 12:50:27 GMT (envelope-from gnats) Date: Thu, 15 Jul 2004 12:50:27 GMT Message-Id: <200407151250.i6FCoR16046525@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/69087: sysutils/mkisofs no longer exist X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Jul 2004 12:50:27 -0000 The following reply was made to PR docs/69087; it has been noted by GNATS. From: Giorgos Keramidas To: Janos Mohacsi Cc: bug-followup@FreeBSD.org Subject: Re: docs/69087: sysutils/mkisofs no longer exist Date: Thu, 15 Jul 2004 15:44:50 +0300 On 2004-07-15 10:23, Janos Mohacsi wrote: > sysutils/mkisofs no longer exist (i.e merged to sysutils/cdrtools) > There are lots of reference to mkisofs that has to be update: > 1. man page of burncd > 2. Chapter 16 of FreeBSD Handbook Does this patch look ok for the Handbook chapter? %% Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v retrieving revision 1.212 diff -u -r1.212 chapter.sgml --- chapter.sgml 14 Jul 2004 05:33:13 -0000 1.212 +++ chapter.sgml 15 Jul 2004 12:43:07 -0000 @@ -920,13 +920,13 @@ working with systems that do not support those extensions. - sysutils/mkisofs + sysutils/cdrtools - The sysutils/mkisofs - program is used to produce a data file containing an ISO 9660 file + The sysutils/cdrtools + port includes &man.mkisofs.8;, a program that you can use to + produce a data file containing an ISO 9660 file system. It has options that support various extensions, and is - described below. You can install it with the - sysutils/mkisofs port. + described below. CD burner @@ -972,7 +972,9 @@ mkisofs - sysutils/mkisofs produces an ISO 9660 file system + The &man.mkisofs.8; program, which is part of the + sysutils/cdrtools port, + produces an ISO 9660 file system that is an image of a directory tree in the &unix; file system name space. The simplest usage is: @@ -1045,7 +1047,7 @@ and /tmp/myboot are identical. There are many other options you can use with - sysutils/mkisofs to fine-tune its behavior. In particular: + &man.mkisofs.8; to fine-tune its behavior. In particular: modifications to an ISO 9660 layout and the creation of Joliet and HFS discs. See the &man.mkisofs.8; manual page for details. @@ -1213,7 +1215,7 @@ You can copy a data CD to a image file that is functionally equivalent to the image file created with - sysutils/mkisofs, and you can use it to duplicate + &man.mkisofs.8;, and you can use it to duplicate any data CD. The example given here assumes that your CDROM device is acd0. Substitute your correct CDROM device. Under &os; 4.X, a c must be appended @@ -1307,7 +1309,7 @@ Such a CDROM cannot be read under any operating system except FreeBSD. If you want to be able to mount the CD, or share data with another operating system, you must use - sysutils/mkisofs as described above. + &man.mkisofs.8; as described above. %% From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 12:50:30 2004 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 EA2F216A4D1 for ; Thu, 15 Jul 2004 12:50:30 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E40CF43D1F for ; Thu, 15 Jul 2004 12:50:30 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6FCoU6m046558 for ; Thu, 15 Jul 2004 12:50:30 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6FCoUPV046557; Thu, 15 Jul 2004 12:50:30 GMT (envelope-from gnats) Date: Thu, 15 Jul 2004 12:50:30 GMT Message-Id: <200407151250.i6FCoUPV046557@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/69087: sysutils/mkisofs no longer exist X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Jul 2004 12:50:31 -0000 The following reply was made to PR docs/69087; it has been noted by GNATS. From: Giorgos Keramidas To: Janos Mohacsi Cc: bug-followup@FreeBSD.org Subject: Re: docs/69087: sysutils/mkisofs no longer exist Date: Thu, 15 Jul 2004 15:49:48 +0300 On 2004-07-15 10:23, Janos Mohacsi wrote: > sysutils/mkisofs no longer exist (i.e merged to sysutils/cdrtools) > There are lots of reference to mkisofs that has to be update: > 1. man page of burncd Here's a patch for the burncd manpage too. Does this look ok? I'm most concerned about the use of .Pa to mark up the port name. %% Index: burncd.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/burncd/burncd.8,v retrieving revision 1.31 diff -u -r1.31 burncd.8 --- burncd.8 18 Nov 2003 02:33:27 -0000 1.31 +++ burncd.8 15 Jul 2004 12:46:39 -0000 @@ -179,7 +179,9 @@ .Xr mkisofs 8 , available in the .Fx -Ports Collection, is commonly used to create ISO9660 file system images +Ports Collection as part of the +.Pa sysutils/cdrtools +port, is commonly used to create ISO9660 file system images from a given directory tree. .Sh ENVIRONMENT The following environment variables affect the execution of %% From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 13:20:21 2004 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 0F15416A4CE for ; Thu, 15 Jul 2004 13:20:21 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id E2AE143D45 for ; Thu, 15 Jul 2004 13:20:20 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6FDKKJY051107 for ; Thu, 15 Jul 2004 13:20:20 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6FDKKnO051106; Thu, 15 Jul 2004 13:20:20 GMT (envelope-from gnats) Date: Thu, 15 Jul 2004 13:20:20 GMT Message-Id: <200407151320.i6FDKKnO051106@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Mohacsi Janos Subject: Re: docs/69087: sysutils/mkisofs no longer exist X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Mohacsi Janos List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Jul 2004 13:20:21 -0000 The following reply was made to PR docs/69087; it has been noted by GNATS. From: Mohacsi Janos To: Giorgos Keramidas Cc: Janos Mohacsi , bug-followup@FreeBSD.org Subject: Re: docs/69087: sysutils/mkisofs no longer exist Date: Thu, 15 Jul 2004 15:11:23 +0200 (CEST) On Thu, 15 Jul 2004, Giorgos Keramidas wrote: > Does this patch look ok for the Handbook chapter? > Yes, I think so. Janos Mohacsi Network Engineer, Research Associate NIIF/HUNGARNET, HUNGARY Key 00F9AF98: 8645 1312 D249 471B DBAE 21A2 9F52 0D1F 00F9 AF98 From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 14:28:00 2004 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 88FA016A4CE for ; Thu, 15 Jul 2004 14:28:00 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id B046E43D1F for ; Thu, 15 Jul 2004 14:27:59 +0000 (GMT) (envelope-from iaccounts@ibctech.ca) Received: (qmail 15726 invoked by uid 1002); 15 Jul 2004 14:28:41 -0000 Received: from iaccounts@ibctech.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.002089 secs); 15 Jul 2004 14:28:41 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 15 Jul 2004 14:28:39 -0000 Received: from 209.167.16.15 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Thu, 15 Jul 2004 10:28:39 -0400 (EDT) Message-ID: <1223.209.167.16.15.1089901719.squirrel@209.167.16.15> Date: Thu, 15 Jul 2004 10:28:39 -0400 (EDT) From: "Steve Bertrand" To: freebsd-doc@freebsd.org User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal Subject: Submitting patches 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, 15 Jul 2004 14:28:00 -0000 I've been tracking some doc pr's, and am a little confused as to how to submit patches. I am just following the handbook for now, as I have no idea how to write manual pages, but don't exactly understand proper procedure for actually making a contribution. In the pr list, can I just find something I'd like to fix, then send the patch to the list, or do I submit it through send-pr? If someone else has already taken responsibility for a pr, is it deemed offensive if I submit my own patch even if the pr is still 'open'? I'm very excited about making an initial contribution, however, I want to ensure I follow proper order as to not offend anyone, and make it as easy as possible for everyone. Tks, Steve From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 15:13:03 2004 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 3E20416A4CE for ; Thu, 15 Jul 2004 15:13:03 +0000 (GMT) Received: from malone.intellispace.net (malone.intellispace.net [160.79.145.141]) by mx1.FreeBSD.org (Postfix) with ESMTP id CF38643D5C for ; Thu, 15 Jul 2004 15:13:02 +0000 (GMT) (envelope-from nboeger@khmere.com) Received: from khmere.com (160.79.51.130) by malone.intellispace.net (5.1.053) id 40F47B2D000B3CC4 for doc@FreeBSD.org; Thu, 15 Jul 2004 11:08:53 -0400 Message-ID: <40F69EFD.4030506@khmere.com> Date: Thu, 15 Jul 2004 11:13:01 -0400 From: Nathan Boeger User-Agent: Mozilla/5.0 (X11; U; SunOS sun4u; en-US; rv:1.7b) Gecko/20040422 X-Accept-Language: en-us, en MIME-Version: 1.0 To: doc@FreeBSD.org Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Subject: I have a book on BSD system programming 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, 15 Jul 2004 15:13:03 -0000 Hello, I have a finished book on BSD system programming that I want to submit to the FreeBSD project. It was not published by the original publisher and I think the BSD community could use it. However, reading over the documentation it seems it will need some work to make it fully compliant. I am not able to do this right now and I would like to know if its possible to submit the book and have the BSD folks help to clean it up along the way. I don't think it will take much work since its in txt now. I think most of it is just simple edits and some style conversions. Please send me any thoughts you have. Thanks -nb From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 15:13:25 2004 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 8BF2E16A4CE for ; Thu, 15 Jul 2004 15:13:25 +0000 (GMT) Received: from odin.ac.hmc.edu (Odin.AC.HMC.Edu [134.173.32.75]) by mx1.FreeBSD.org (Postfix) with ESMTP id 70E9143D45 for ; Thu, 15 Jul 2004 15:13:25 +0000 (GMT) (envelope-from brdavis@odin.ac.hmc.edu) Received: from odin.ac.hmc.edu (IDENT:brdavis@localhost.localdomain [127.0.0.1]) by odin.ac.hmc.edu (8.12.10/8.12.10) with ESMTP id i6FFDOOF003981; Thu, 15 Jul 2004 08:13:24 -0700 Received: (from brdavis@localhost) by odin.ac.hmc.edu (8.12.10/8.12.3/Submit) id i6FFDO7K003980; Thu, 15 Jul 2004 08:13:24 -0700 Date: Thu, 15 Jul 2004 08:13:24 -0700 From: Brooks Davis To: Steve Bertrand Message-ID: <20040715151324.GB2162@Odin.AC.HMC.Edu> References: <1223.209.167.16.15.1089901719.squirrel@209.167.16.15> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="LpQ9ahxlCli8rRTG" Content-Disposition: inline In-Reply-To: <1223.209.167.16.15.1089901719.squirrel@209.167.16.15> User-Agent: Mutt/1.5.4i cc: freebsd-doc@freebsd.org Subject: Re: Submitting patches 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, 15 Jul 2004 15:13:25 -0000 --LpQ9ahxlCli8rRTG Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Jul 15, 2004 at 10:28:39AM -0400, Steve Bertrand wrote: > I've been tracking some doc pr's, and am a little confused as to how to > submit patches. >=20 > I am just following the handbook for now, as I have no idea how to write > manual pages, but don't exactly understand proper procedure for actually > making a contribution. >=20 > In the pr list, can I just find something I'd like to fix, then send the > patch to the list, or do I submit it through send-pr? Ideally you should send the patch as a reply to the pr so it is logged with the PR. You may want to post a pointer here as well if no one picks it up quickly. > If someone else has already taken responsibility for a pr, is it deemed > offensive if I submit my own patch even if the pr is still 'open'? You might try contacting the person first to avoid duplicate effort. -- Brooks --=20 Any statement of the form "X is the one, true Y" is FALSE. PGP fingerprint 655D 519C 26A7 82E7 2529 9BF0 5D8E 8BE9 F238 1AD4 --LpQ9ahxlCli8rRTG Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (GNU/Linux) iD8DBQFA9p8TXY6L6fI4GtQRAo1aAJ4uU7RZHUVtXbsj3uLVPn5a9soEcgCgmhhV 5lSuH8DZgu5PamYypAYTaLE= =NRFA -----END PGP SIGNATURE----- --LpQ9ahxlCli8rRTG-- From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 15:15:09 2004 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 169D516A4CF for ; Thu, 15 Jul 2004 15:15:09 +0000 (GMT) Received: from internet.potentialtech.com (h-66-167-251-6.phlapafg.covad.net [66.167.251.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id E530843D46 for ; Thu, 15 Jul 2004 15:15:08 +0000 (GMT) (envelope-from wmoran@potentialtech.com) Received: from working.potentialtech.com (pa-plum-cmts1e-68-68-113-64.pittpa.adelphia.net [68.68.113.64]) by internet.potentialtech.com (Postfix) with ESMTP id F027269A39; Thu, 15 Jul 2004 11:15:07 -0400 (EDT) Date: Thu, 15 Jul 2004 11:15:06 -0400 From: Bill Moran To: "Steve Bertrand" Message-Id: <20040715111506.157a7b26.wmoran@potentialtech.com> In-Reply-To: <1223.209.167.16.15.1089901719.squirrel@209.167.16.15> References: <1223.209.167.16.15.1089901719.squirrel@209.167.16.15> Organization: Potential Technologies X-Mailer: Sylpheed version 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd4.9) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-doc@freebsd.org Subject: Re: Submitting patches 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, 15 Jul 2004 15:15:09 -0000 "Steve Bertrand" wrote: > I've been tracking some doc pr's, and am a little confused as to how to > submit patches. > > I am just following the handbook for now, as I have no idea how to write > manual pages, but don't exactly understand proper procedure for actually > making a contribution. > > In the pr list, can I just find something I'd like to fix, then send the > patch to the list, or do I submit it through send-pr? If you look at the web page showing PRs, there's a "reply to this PR" like at the bottom. This is the best way to respond, as it records your response in the PR database and emails anyone listed as responsible. > If someone else has already taken responsibility for a pr, is it deemed > offensive if I submit my own patch even if the pr is still 'open'? Not offensive, but I would definately email the person responsible to make sure you're not duplicating effort. It's possible that the person responsible is "mostly done" with a fix. > I'm very excited about making an initial contribution, however, I want to > ensure I follow proper order as to not offend anyone, and make it as easy > as possible for everyone. If it seems you've offended anyone, don't take it personally. Keep in mind that most people work on FreeBSD because they enjoy it and/or they believe in it. This means when things don't go as planned or expected, folks can get pretty emotional. It's just a side effect of being involved in a project where people _really_ care about what they're doing (and don't just write it off as "well, I get paid anyway") I think that's something that often scares a lot of people away from OSS projects. -- Bill Moran Potential Technologies http://www.potentialtech.com From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 16:00:38 2004 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 2D37F16A53A for ; Thu, 15 Jul 2004 16:00:38 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1227C43D48 for ; Thu, 15 Jul 2004 16:00:38 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6FG0bCc069348 for ; Thu, 15 Jul 2004 16:00:37 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6FG0bpG069347; Thu, 15 Jul 2004 16:00:37 GMT (envelope-from gnats) Date: Thu, 15 Jul 2004 16:00:37 GMT Message-Id: <200407151600.i6FG0bpG069347@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Giorgos Keramidas Subject: Re: docs/69087: sysutils/mkisofs no longer exist X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Giorgos Keramidas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Jul 2004 16:00:38 -0000 The following reply was made to PR docs/69087; it has been noted by GNATS. From: Giorgos Keramidas To: Mohacsi Janos Cc: Janos Mohacsi , bug-followup@freebsd.org Subject: Re: docs/69087: sysutils/mkisofs no longer exist Date: Thu, 15 Jul 2004 18:54:01 +0300 On 2004-07-15 15:11, Mohacsi Janos wrote: > On Thu, 15 Jul 2004, Giorgos Keramidas wrote: > >Does this patch look ok for the Handbook chapter? > > Yes, I think so. Nice. If nobody raises any ort of objections or has style comments to make, I'll commit this tomorrow morning at 10:00-11:00 EEST -- that is, in about 14 hours. Giorgos From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 21:23:31 2004 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 AADD016A4CE for ; Thu, 15 Jul 2004 21:23:31 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id A212543D1F for ; Thu, 15 Jul 2004 21:23:31 +0000 (GMT) (envelope-from www@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i6FLNVlf088135 for ; Thu, 15 Jul 2004 21:23:31 GMT (envelope-from www@www.freebsd.org) Received: (from www@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i6FLNVXK088134 for freebsd-doc@FreeBSD.org; Thu, 15 Jul 2004 21:23:31 GMT (envelope-from www) Date: Thu, 15 Jul 2004 21:23:31 GMT From: World Wide Web Owner Message-Id: <200407152123.i6FLNVXK088134@www.freebsd.org> To: freebsd-doc@FreeBSD.org Subject: FreeBSD web build failed on www.freebsd.org 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, 15 Jul 2004 21:23:31 -0000 ===> releases/2.0.5R ===> releases/2.1R ===> releases/2.1.5R ===> releases/2.1.6R ===> releases/2.1.7R ===> releases/2.2R ===> releases/2.2.1R ===> releases/2.2.2R ===> releases/2.2.5R ===> releases/2.2.6R ===> releases/2.2.7R ===> releases/2.2.8R ===> releases/3.0R ===> releases/3.1R ===> releases/3.2R ===> releases/3.3R ===> releases/3.4R ===> releases/3.5R ===> releases/4.0R ===> releases/4.1R ===> releases/4.1.1R ===> releases/4.2R ===> releases/4.3R ===> releases/4.4R ===> releases/4.5R ===> releases/4.6R ===> releases/4.6.2R ===> releases/4.7R ===> releases/4.8R ===> releases/4.9R ===> releases/4.10R ===> releases/5.0R ===> releases/5.0R/DP1 ===> releases/5.0R/DP2 ===> releases/5.1R ===> releases/5.2R ===> releases/5.2.1R ===> releases/5.3R /usr/bin/sed -e 's///' todo.sgml | /usr/bin/env SGML_CATALOG_FILES= /usr/local/bin/sgmlnorm -d -ifreebsd.urls.absolute -c /usr/local/share/sgml/html/catalog -D /w/www/build/www/en/releases/5.3R > todo.html || (/bin/rm -f todo.html && false) /usr/local/bin/sgmlnorm:0:337:9:E: general entity "a.simon" not defined and no default entity *** Error code 1 Stop in /w/www/build/www/en/releases/5.3R. *** Error code 1 Stop in /w/www/build/www/en/releases. *** Error code 1 Stop in /w/www/build/www/en. 9.35 real 2.13 user 2.74 sys From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 21:26:13 2004 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 D86F416A4CE; Thu, 15 Jul 2004 21:26:13 +0000 (GMT) Received: from shrike.submonkey.net (cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com [81.103.67.204]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9287743D39; Thu, 15 Jul 2004 21:26:13 +0000 (GMT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.34; FreeBSD) id 1BlDk4-000AdU-Qr; Thu, 15 Jul 2004 22:26:12 +0100 Date: Thu, 15 Jul 2004 22:26:11 +0100 From: Ceri Davies To: World Wide Web Owner Message-ID: <20040715212611.GI29928@submonkey.net> Mail-Followup-To: Ceri Davies , World Wide Web Owner , freebsd-doc@FreeBSD.org References: <200407152123.i6FLNVXK088134@www.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="vTKWYyFdYy4kKIJI" Content-Disposition: inline In-Reply-To: <200407152123.i6FLNVXK088134@www.freebsd.org> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.6i Sender: Ceri Davies cc: freebsd-doc@FreeBSD.org Subject: Re: FreeBSD web build failed on www.freebsd.org 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, 15 Jul 2004 21:26:14 -0000 --vTKWYyFdYy4kKIJI Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Jul 15, 2004 at 09:23:31PM +0000, World Wide Web Owner wrote: > =3D=3D=3D> releases/5.3R > /usr/bin/sed -e 's/= //' todo.sgml | /usr/bin/env SGML_CATAL= OG_FILES=3D /usr/local/bin/sgmlnorm -d -ifreebsd.urls.absolute -c /usr/loc= al/share/sgml/html/catalog -D /w/www/build/www/en/releases/5.3R > todo.html= || (/bin/rm -f todo.html && false) > /usr/local/bin/sgmlnorm:0:337:9:E: general entity "a.simon" not def= ined and no default entity Fixed. Ceri --=20 It is not tinfoil, it is my new skin. I am a robot. --vTKWYyFdYy4kKIJI Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA9vZzocfcwTS3JF8RAlXPAJ9h2Ugg6HxhTj01+V8EptHOpJoEnwCeKfGH 2sPxDYIgeS5kBPVYGKwYZ8s= =BaAJ -----END PGP SIGNATURE----- --vTKWYyFdYy4kKIJI-- From owner-freebsd-doc@FreeBSD.ORG Thu Jul 15 21:32:46 2004 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 EB95316A4CE; Thu, 15 Jul 2004 21:32:46 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 681C643D31; Thu, 15 Jul 2004 21:32:46 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 22765119B1; Thu, 15 Jul 2004 23:32:45 +0200 (CEST) Date: Thu, 15 Jul 2004 23:32:44 +0200 From: "Simon L. Nielsen" To: Ceri Davies , World Wide Web Owner , freebsd-doc@FreeBSD.org Message-ID: <20040715213244.GD756@zaphod.nitro.dk> References: <200407152123.i6FLNVXK088134@www.freebsd.org> <20040715212611.GI29928@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="yLVHuoLXiP9kZBkt" Content-Disposition: inline In-Reply-To: <20040715212611.GI29928@submonkey.net> User-Agent: Mutt/1.5.6i Subject: Re: FreeBSD web build failed on www.freebsd.org 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, 15 Jul 2004 21:32:47 -0000 --yLVHuoLXiP9kZBkt Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.15 22:26:11 +0100, Ceri Davies wrote: > On Thu, Jul 15, 2004 at 09:23:31PM +0000, World Wide Web Owner wrote: > > =3D=3D=3D> releases/5.3R > > /usr/bin/sed -e 's///' todo.sgml | /usr/bin/env SGML_CAT= ALOG_FILES=3D /usr/local/bin/sgmlnorm -d -ifreebsd.urls.absolute -c /usr/l= ocal/share/sgml/html/catalog -D /w/www/build/www/en/releases/5.3R > todo.ht= ml || (/bin/rm -f todo.html && false) > > /usr/local/bin/sgmlnorm:0:337:9:E: general entity "a.simon" not d= efined and no default entity >=20 > Fixed. Doh! (nr. 2 for that commit) - I of course had added my entity to my local copy of developers.sgml a long time ago, but never gotten around to committing it since there was no need... Thanks! --=20 Simon L. Nielsen FreeBSD Documentation Team --yLVHuoLXiP9kZBkt Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA9vf8h9pcDSc1mlERAqpIAJ46uR+5/xM0ZhPgLKi9ZplDRliABQCfdrSh c0ewsfO2pV0DbxbPyhXPPjo= =SHhx -----END PGP SIGNATURE----- --yLVHuoLXiP9kZBkt-- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 16 01:54:03 2004 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 BCE7516A4CE for ; Fri, 16 Jul 2004 01:54:03 +0000 (GMT) Received: from web50307.mail.yahoo.com (web50307.mail.yahoo.com [206.190.38.61]) by mx1.FreeBSD.org (Postfix) with SMTP id 725DA43D53 for ; Fri, 16 Jul 2004 01:54:03 +0000 (GMT) (envelope-from murcielako@yahoo.com) Message-ID: <20040716015402.61557.qmail@web50307.mail.yahoo.com> Received: from [200.116.0.242] by web50307.mail.yahoo.com via HTTP; Thu, 15 Jul 2004 20:54:02 CDT Date: Thu, 15 Jul 2004 20:54:02 -0500 (CDT) From: "=?iso-8859-1?q?Jorge=20Mario=20G.?=" To: Nathan Boeger , doc@FreeBSD.org In-Reply-To: <40F69EFD.4030506@khmere.com> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Subject: Re: I have a book on BSD system programming 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, 16 Jul 2004 01:54:03 -0000 Hi there well that really rocks but you should know that translating a complete book to sghml is a long, slow work. you could start leting us see the doc _________________________________________________________ Do You Yahoo!? Información de Estados Unidos y América Latina, en Yahoo! Noticias. Visítanos en http://noticias.espanol.yahoo.com From owner-freebsd-doc@FreeBSD.ORG Fri Jul 16 08:37:18 2004 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 4DCF316A4CE for ; Fri, 16 Jul 2004 08:37:18 +0000 (GMT) Received: from gandalf.online.bg (gandalf.online.bg [217.75.128.9]) by mx1.FreeBSD.org (Postfix) with SMTP id BE3A743D7B for ; Fri, 16 Jul 2004 08:37:16 +0000 (GMT) (envelope-from roam@ringlet.net) Received: (qmail 8888 invoked from network); 16 Jul 2004 08:32:56 -0000 Received: from unknown (HELO straylight.m.ringlet.net) (217.75.134.254) by gandalf.online.bg with SMTP; 16 Jul 2004 08:32:56 -0000 Received: (qmail 70168 invoked by uid 1000); 16 Jul 2004 08:37:13 -0000 Date: Fri, 16 Jul 2004 11:37:13 +0300 From: Peter Pentchev To: Leonard Zettel Message-ID: <20040716083713.GD858@straylight.m.ringlet.net> Mail-Followup-To: Leonard Zettel , freebsd-doc@freebsd.org References: <200406032310.12551.zettel@acm.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="g7w8+K/95kPelPD2" Content-Disposition: inline In-Reply-To: <200406032310.12551.zettel@acm.org> User-Agent: Mutt/1.5.6i cc: freebsd-doc@freebsd.org Subject: Re: Suggested rewrite of "FreeBSD Documentation Project: SGML" 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, 16 Jul 2004 08:37:18 -0000 --g7w8+K/95kPelPD2 Content-Type: text/plain; charset=windows-1251 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Jun 03, 2004 at 11:10:12PM -0400, Leonard Zettel wrote: > http://www.lenzettel.com/freebsd/sgml.html >=20 > Questions, comments, criticisms? I like it at a first read, but it is somewhat difficult to see exactly what changes you have made (the ones in the first couple of sentences are obvious). Could you try to check out the FreeBSD Web site sources =66rom the CVS repository, edit the www/en/docproj/sgml.sgml file to include your changes, and then send us a patch (or at least your version of the sgml.sgml file) so we can comment on the changes themselves? :) Thanks for your efforts so far! G'luck, Peter --=20 Peter Pentchev roam@ringlet.net roam@sbnd.net roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 If wishes were fishes, the antecedent of this conditional would be true. --g7w8+K/95kPelPD2 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA95O57Ri2jRYZRVMRAuVrAKCNSfuSzzoTgCQeXNthmtXlKwMK/gCffTVB peE+93KbnhUpUd+WjB9cH5M= =Pp11 -----END PGP SIGNATURE----- --g7w8+K/95kPelPD2-- From owner-freebsd-doc@FreeBSD.ORG Fri Jul 16 10:23:05 2004 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 B7C7E16A4CE; Fri, 16 Jul 2004 10:23:05 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 960B743D31; Fri, 16 Jul 2004 10:23:05 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from freefall.freebsd.org (keramida@localhost [127.0.0.1]) i6GAN5fI099676; Fri, 16 Jul 2004 10:23:05 GMT (envelope-from keramida@freefall.freebsd.org) Received: (from keramida@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6GAN5YG099672; Fri, 16 Jul 2004 10:23:05 GMT (envelope-from keramida) Date: Fri, 16 Jul 2004 10:23:05 GMT From: Giorgos Keramidas Message-Id: <200407161023.i6GAN5YG099672@freefall.freebsd.org> To: janos.mohacsi@bsd.hu, keramida@FreeBSD.org, freebsd-doc@FreeBSD.org, keramida@FreeBSD.org Subject: Re: docs/69087: sysutils/mkisofs no longer 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, 16 Jul 2004 10:23:05 -0000 Synopsis: sysutils/mkisofs no longer exist State-Changed-From-To: open->closed State-Changed-By: keramida State-Changed-When: Fri Jul 16 10:21:42 GMT 2004 State-Changed-Why: I've committed some fixes to burncd.8 and the Handbook. If you happen to notice any other places where the sysutils/mkisofs port is mentioned please let us know :) Responsible-Changed-From-To: freebsd-doc->keramida Responsible-Changed-By: keramida Responsible-Changed-When: Fri Jul 16 10:21:42 GMT 2004 Responsible-Changed-Why: http://www.freebsd.org/cgi/query-pr.cgi?pr=69087 From owner-freebsd-doc@FreeBSD.ORG Fri Jul 16 12:01:47 2004 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 5486D16A4CE for ; Fri, 16 Jul 2004 12:01:47 +0000 (GMT) Received: from sccrmhc13.comcast.net (sccrmhc13.comcast.net [204.127.202.64]) by mx1.FreeBSD.org (Postfix) with ESMTP id ED03943D2F for ; Fri, 16 Jul 2004 12:01:46 +0000 (GMT) (envelope-from zettel@acm.org) Received: from [192.168.0.6] (bgp966574bgs.derbrn01.mi.comcast.net[68.41.108.205]) by comcast.net (sccrmhc13) with ESMTP id <2004071612014501600bffqqe>; Fri, 16 Jul 2004 12:01:46 +0000 From: Leonard Zettel To: Peter Pentchev Date: Fri, 16 Jul 2004 08:02:46 -0400 User-Agent: KMail/1.6.2 References: <200406032310.12551.zettel@acm.org> <20040716083713.GD858@straylight.m.ringlet.net> In-Reply-To: <20040716083713.GD858@straylight.m.ringlet.net> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Message-Id: <200407160802.46405.zettel@acm.org> cc: freebsd-doc@freebsd.org Subject: Re: Suggested rewrite of "FreeBSD Documentation Project: SGML" 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, 16 Jul 2004 12:01:47 -0000 On Friday 16 July 2004 04:37 am, Peter Pentchev wrote: > On Thu, Jun 03, 2004 at 11:10:12PM -0400, Leonard Zettel wrote: > > http://www.lenzettel.com/freebsd/sgml.html > > > > Questions, comments, criticisms? > > I like it at a first read, but it is somewhat difficult to see exactly > what changes you have made (the ones in the first couple of sentences > are obvious). Could you try to check out the FreeBSD Web site sources > from the CVS repository, edit the www/en/docproj/sgml.sgml file to > include your changes, and then send us a patch (or at least your version > of the sgml.sgml file) so we can comment on the changes themselves? :) > > Thanks for your efforts so far! > Thank you for your kind words! As an absolute newbie to FreeBSD, it has been a real struggle trying to wade through the procedural thicket to get a modified sgml file. But I'm working on it! > G'luck, Can always use that - thanks. -LenZ- > Peter From owner-freebsd-doc@FreeBSD.ORG Fri Jul 16 15:05:47 2004 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 EDB7C16A4CE for ; Fri, 16 Jul 2004 15:05:47 +0000 (GMT) Received: from fed1rmmtao07.cox.net (fed1rmmtao07.cox.net [68.230.241.32]) by mx1.FreeBSD.org (Postfix) with ESMTP id C361043D31 for ; Fri, 16 Jul 2004 15:05:47 +0000 (GMT) (envelope-from mirror176@cox.net) Received: from [192.168.1.102] (really [24.56.6.166]) by fed1rmmtao07.cox.net (InterMail vM.6.01.03.02 201-2131-111-104-20040324) with ESMTP id <20040716150547.YLRK27884.fed1rmmtao07.cox.net@[192.168.1.102]> for ; Fri, 16 Jul 2004 11:05:47 -0400 Message-ID: <40F7EE89.5080903@cox.net> Date: Fri, 16 Jul 2004 08:04:41 -0700 From: "Edward Sanford Sutton, III" User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.7) Gecko/20040628 X-Accept-Language: en-us, en MIME-Version: 1.0 To: freebsd-doc@FreeBSD.org Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Subject: invalid link? 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, 16 Jul 2004 15:05:48 -0000 http://www.freebsd.org/projects/newbies.html links to http://manuel.brad.ac.uk/help/.faq/.unix/.pronun.html as the 'Pronunciation Guide'. It appears to probably have moved or have been removed because the contacted server returns a 'File Not Found' page. Thanks, Ed Sutton From owner-freebsd-doc@FreeBSD.ORG Fri Jul 16 16:25:25 2004 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 E8B8516A52C for ; Fri, 16 Jul 2004 16:25:20 +0000 (GMT) Received: from annibale.willystudios.com (annibale.willystudios.com [216.120.241.248]) by mx1.FreeBSD.org (Postfix) with ESMTP id 50F9843D5D for ; Fri, 16 Jul 2004 16:25:20 +0000 (GMT) (envelope-from stucchi@willystudios.com) Received: by annibale.willystudios.com (Postfix, from userid 1003) id EDBE34F3EB; Fri, 16 Jul 2004 18:23:12 +0200 (CEST) Received: from max.willystudios.com (host182-22.pool80182.interbusiness.it [80.182.22.182]) by annibale.willystudios.com (Postfix) with ESMTP id 9ECA14F3DF; Fri, 16 Jul 2004 18:23:12 +0200 (CEST) Received: by max.willystudios.com (Postfix, from userid 1000) id 2E54759B; Fri, 16 Jul 2004 18:24:21 +0200 (CEST) Date: Fri, 16 Jul 2004 18:24:21 +0200 From: Massimiliano Stucchi To: Nathan Boeger Message-ID: <20040716162421.GE20361@willystudios.com> References: <40F69EFD.4030506@khmere.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="9crTWz/Z+Zyzu20v" Content-Disposition: inline In-Reply-To: <40F69EFD.4030506@khmere.com> User-Agent: Mutt/1.4.2.1i X-Operating-System: FreeBSD 4.10-STABLE X-URL: http://www.willystudios.com/max/ X-Organization: WillyStudios.com X-Bogosity: No, tests=bogofilter, spamicity=0.500000, version=0.92.1 cc: doc@FreeBSD.org Subject: Re: I have a book on BSD system programming X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: stucchi@willystudios.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Jul 2004 16:25:25 -0000 --9crTWz/Z+Zyzu20v Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 150704, 11:13, Nathan Boeger wrote: > > Please send me any thoughts you have. If you decided to give it to the community, why don't you just put it somewhere and give us pointers to it ? This way someone may come up, format it in SGML and put it into the FreeBSD doc tree. Ciao ! --=20 Massimiliano Stucchi WillyStudios.com stucchi@willystudios.com Http://www.willystudios.com/max/ --9crTWz/Z+Zyzu20v Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA+AE1FwcpJfdZDoERAoLoAJ9yBmXiwJcjyqdfXsxPnHNfA8ByjQCfUysv NG/zLMksuF1WxfpuVI6/7Lo= =kg8E -----END PGP SIGNATURE----- --9crTWz/Z+Zyzu20v-- From owner-freebsd-doc@FreeBSD.ORG Sat Jul 17 17:00:40 2004 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 671DF16A4CE for ; Sat, 17 Jul 2004 17:00:40 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 46E5B43D39 for ; Sat, 17 Jul 2004 17:00:40 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6HH0d4N064589 for ; Sat, 17 Jul 2004 17:00:39 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6HH0dcs064588; Sat, 17 Jul 2004 17:00:39 GMT (envelope-from gnats) Resent-Date: Sat, 17 Jul 2004 17:00:39 GMT Resent-Message-Id: <200407171700.i6HH0dcs064588@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, Joel Dahl Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A988116A4CE for ; Sat, 17 Jul 2004 16:50:48 +0000 (GMT) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id A389E43D46 for ; Sat, 17 Jul 2004 16:50:48 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i6HGomT4079150 for ; Sat, 17 Jul 2004 16:50:48 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.12.11/8.12.11/Submit) id i6HGomvd079149; Sat, 17 Jul 2004 16:50:48 GMT (envelope-from nobody) Message-Id: <200407171650.i6HGomvd079149@www.freebsd.org> Date: Sat, 17 Jul 2004 16:50:48 GMT From: Joel Dahl To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Subject: docs/69202: [PATCH] Add Firefox to list of browsers in handbook 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, 17 Jul 2004 17:00:40 -0000 >Number: 69202 >Category: docs >Synopsis: [PATCH] Add Firefox to list of browsers in 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: Sat Jul 17 17:00:39 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Joel Dahl >Release: 5.2.1 >Organization: none >Environment: FreeBSD dude.automatvapen.se 5.2.1-RELEASE-p9 FreeBSD 5.2.1-RELEASE-p9 #1: Sat Jul 10 16:52:28 CEST 2004 root@dude.automatvapen.se:/usr/obj/usr/src/sys/WORKSTATION i386 >Description: This patch includes Firefox in the Browser section of the handbook. Firefox has grown very popular, so I think we should mention it and the installing procedures. The patch should be applied to: /usr/doc/en_US.ISO8859-1/books/handbook/desktop/chapter.sgml >How-To-Repeat: none >Fix: http://www.automatvapen.se/freebsd/patches/doc_firefox.diff >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sat Jul 17 21:38:08 2004 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 8413116A4CE for ; Sat, 17 Jul 2004 21:38:08 +0000 (GMT) Received: from outbound3.mail.tds.net (outbound3.mail.tds.net [216.170.230.93]) by mx1.FreeBSD.org (Postfix) with ESMTP id 38DE043D3F for ; Sat, 17 Jul 2004 21:38:08 +0000 (GMT) (envelope-from omcldr@tds.net) Received: from dedejimqei2ie1k6x (kgldgaambas02-pool3-a87.kgldga.tds.net [69.11.163.87])i6HLc63g000314 for ; Sat, 17 Jul 2004 16:38:06 -0500 (CDT) Message-ID: <006e01c46c46$502eee60$100efea9@dedejimqei2ie1k6x> From: "Jim Church" To: Date: Sat, 17 Jul 2004 17:37:51 -0400 MIME-Version: 1.0 X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2800.1437 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1441 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.1 Subject: acception 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, 17 Jul 2004 21:38:08 -0000 I erased My Numbers and entire message before I filled them. Could you = please resend Thanks. omcldr@tds.net From owner-freebsd-doc@FreeBSD.ORG Sat Jul 17 23:40:21 2004 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 CA51216A4CE for ; Sat, 17 Jul 2004 23:40:21 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id BDE6A43D48 for ; Sat, 17 Jul 2004 23:40:21 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6HNeLXM012748 for ; Sat, 17 Jul 2004 23:40:21 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6HNeLkp012747; Sat, 17 Jul 2004 23:40:21 GMT (envelope-from gnats) Resent-Date: Sat, 17 Jul 2004 23:40:21 GMT Resent-Message-Id: <200407172340.i6HNeLkp012747@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, Brad Davis Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E6FC716A4CE for ; Sat, 17 Jul 2004 23:33:34 +0000 (GMT) Received: from valentine.liquidneon.com (valentine.liquidneon.com [216.38.206.180]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7617D43D49 for ; Sat, 17 Jul 2004 23:33:33 +0000 (GMT) (envelope-from bdavis@house.so14k.com) Received: from localhost (localhost [127.0.0.1]) by valentine.liquidneon.com (Postfix) with ESMTP id D286D8D3 for ; Sat, 17 Jul 2004 17:33:32 -0600 (MDT) Received: from valentine.liquidneon.com ([216.38.206.180]) by localhost (valentine.liquidneon.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 10482-02 for ; Sat, 17 Jul 2004 17:33:32 -0600 (MDT) Received: from mccaffrey.house.so14k.com (c-24-8-51-173.client.comcast.net [24.8.51.173]) by valentine.liquidneon.com (Postfix) with ESMTP id 79E3612E for ; Sat, 17 Jul 2004 17:33:32 -0600 (MDT) Received: by mccaffrey.house.so14k.com (Postfix, from userid 1001) id 2628B61A; Sat, 17 Jul 2004 17:33:32 -0600 (MDT) Message-Id: <20040717233332.2628B61A@mccaffrey.house.so14k.com> Date: Sat, 17 Jul 2004 17:33:32 -0600 (MDT) From: Brad Davis To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/69216: [patch] fix erraneous caps X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Brad Davis List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 17 Jul 2004 23:40:22 -0000 >Number: 69216 >Category: docs >Synopsis: [patch] fix erraneous caps >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: Sat Jul 17 23:40:21 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Brad Davis >Release: FreeBSD 4.10-STABLE i386 >Organization: >Environment: System: FreeBSD mccaffrey.house.so14k.com 4.10-STABLE FreeBSD 4.10-STABLE #0: Fri May 28 08:02:41 MDT 2004 root@mccaffrey.house.so14k.com:/usr/obj/usr/src/sys/MCCAFFREY i386 >Description: thttpd should be spelled as thttpd, not tHttpd. >How-To-Repeat: n/a >Fix: Apply the following patch: --- doc-ori/en_US.ISO8859-1/articles/hubs/article.sgml Sat Jul 17 17:22:51 2004 +++ doc/en_US.ISO8859-1/articles/hubs/article.sgml Sat Jul 17 17:23:38 2004 @@ -266,18 +266,18 @@ www/thttpd: If you are going to be serving a large amount of static content - you may find that using an application such as tHttpd is more + you may find that using an application such as thttpd is more efficient than Apache. It is optimized for excellent performance on FreeBSD. www/boa: - Boa is another alternative to tHttpd and Apache. It should + Boa is another alternative to thttpd and Apache. It should provide considerably better performance than Apache for purely static content. It does not, at the time of writing, contain the same set of optimizations for FreeBSD that are found in - tHttpd. + thttpd. >Release-Note: >Audit-Trail: >Unformatted: