From owner-freebsd-doc@FreeBSD.ORG Sun Jan 15 12:19:57 2012 Return-Path: Delivered-To: docs@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 068751065670 for ; Sun, 15 Jan 2012 12:19:57 +0000 (UTC) (envelope-from patfbsd@davenulle.org) Received: from smtp.lamaiziere.net (net.lamaiziere.net [94.23.254.147]) by mx1.freebsd.org (Postfix) with ESMTP id BEDEE8FC14 for ; Sun, 15 Jan 2012 12:19:56 +0000 (UTC) Received: from roxette.lamaiziere.net (79.176.97.84.rev.sfr.net [84.97.176.79]) by smtp.lamaiziere.net (Postfix) with ESMTPA id 7BBFBFAA2D08 for ; Sun, 15 Jan 2012 13:02:26 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by roxette.lamaiziere.net (Postfix) with ESMTP id B4392C0D1 for ; Sun, 15 Jan 2012 13:02:25 +0100 (CET) Date: Sun, 15 Jan 2012 13:02:25 +0100 From: Patrick Lamaiziere To: docs@freebsd.org Message-ID: <20120115130225.688d88a7@davenulle.org> X-Mailer: Claws Mail 3.8.0 (GTK+ 2.24.6; amd64-portbld-freebsd9.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Cc: Subject: outdated article http://www.freebsd.org/doc/en/articles/multi-os/ X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 15 Jan 2012 12:19:57 -0000 Hello, Looks like these articles are quite outdated, do you think we shall remove these? http://www.freebsd.org/doc/en/articles/multi-os/ and translations. http://www.freebsd.org/doc/fr_FR.ISO8859-1/articles/multi-os/ Thanks, regards. From owner-freebsd-doc@FreeBSD.ORG Sun Jan 15 21:40:10 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C6C9E106566C for ; Sun, 15 Jan 2012 21:40:10 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 9D6EA8FC12 for ; Sun, 15 Jan 2012 21:40:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0FLeAde075661 for ; Sun, 15 Jan 2012 21:40:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0FLeAS4075660; Sun, 15 Jan 2012 21:40:10 GMT (envelope-from gnats) Resent-Date: Sun, 15 Jan 2012 21:40:10 GMT Resent-Message-Id: <201201152140.q0FLeAS4075660@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, David Wolfskill Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 27AA0106567C for ; Sun, 15 Jan 2012 21:35:19 +0000 (UTC) (envelope-from david@catwhisker.org) Received: from albert.catwhisker.org (m209-73.dsl.rawbw.com [198.144.209.73]) by mx1.freebsd.org (Postfix) with ESMTP id E9FE98FC1C for ; Sun, 15 Jan 2012 21:35:18 +0000 (UTC) Received: from albert.catwhisker.org (localhost [127.0.0.1]) by albert.catwhisker.org (8.14.5/8.14.5) with ESMTP id q0FL990Q003529 for ; Sun, 15 Jan 2012 13:09:09 -0800 (PST) (envelope-from david@albert.catwhisker.org) Received: (from david@localhost) by albert.catwhisker.org (8.14.5/8.14.5/Submit) id q0FL993H003528; Sun, 15 Jan 2012 13:09:09 -0800 (PST) (envelope-from david) Message-Id: <201201152109.q0FL993H003528@albert.catwhisker.org> Date: Sun, 15 Jan 2012 13:09:09 -0800 (PST) From: David Wolfskill To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/164188: doc update for new mailing list: freebsd-zope X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: David Wolfskill List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 15 Jan 2012 21:40:10 -0000 >Number: 164188 >Category: docs >Synopsis: doc update for new mailing list: freebsd-zope >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sun Jan 15 21:40:10 UTC 2012 >Closed-Date: >Last-Modified: >Originator: David Wolfskill >Release: FreeBSD 8.2-STABLE i386 >Organization: Wolfskill & Dowling Residence >Environment: System: FreeBSD albert.catwhisker.org 8.2-STABLE FreeBSD 8.2-STABLE #423 230106M: Sat Jan 14 04:07:59 PST 2012 root@freebeast.catwhisker.org:/common/S1/obj/usr/src/sys/ALBERT i386 >Description: We have a new mailing list (courtesy of miwi@). The below patch is intended to update the docs accordingly; please feel free ot adjust as appropriate. >How-To-Repeat: n/a >Fix: Index: en_US.ISO8859-1/books/handbook/eresources/chapter.sgml =================================================================== RCS file: /cvs/freebsd/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml,v retrieving revision 1.216 diff -u -u -r1.216 chapter.sgml --- en_US.ISO8859-1/books/handbook/eresources/chapter.sgml 22 Dec 2011 05:15:08 -0000 1.216 +++ en_US.ISO8859-1/books/handbook/eresources/chapter.sgml 15 Jan 2012 21:03:20 -0000 @@ -565,6 +565,11 @@ &a.xfce.name; XFCE for &os; — porting and maintaining + + + &a.zope.name; + Zope for &os; — porting and maintaining + @@ -1839,6 +1844,22 @@ are also welcome. + + + &a.zope.name; + + + Zope + + This is a forum for discussions related to bring the + Zope environment to &os;. This + is a technical mailing list. It is for individuals actively + working on porting Zope to &os;, + to bring up problems or discuss alternative solutions. + Individuals interested in following the technical discussion + are also welcome. + + Index: en_US.ISO8859-1/share/sgml/mailing-lists.ent =================================================================== RCS file: /cvs/freebsd/doc/en_US.ISO8859-1/share/sgml/mailing-lists.ent,v retrieving revision 1.87 diff -u -u -r1.87 mailing-lists.ent --- en_US.ISO8859-1/share/sgml/mailing-lists.ent 22 Dec 2011 05:15:08 -0000 1.87 +++ en_US.ISO8859-1/share/sgml/mailing-lists.ent 15 Jan 2012 21:03:58 -0000 @@ -548,6 +548,10 @@ XFCE for FreeBSD mailing list"> freebsd-xfce"> + +Zope for FreeBSD mailing list"> +freebsd-zope"> + bug-followup@FreeBSD.org"> >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Jan 15 21:46:18 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2D9FD106564A; Sun, 15 Jan 2012 21:46:18 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id F41A58FC12; Sun, 15 Jan 2012 21:46:17 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0FLkHgO083929; Sun, 15 Jan 2012 21:46:17 GMT (envelope-from gjb@freefall.freebsd.org) Received: (from gjb@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0FLkHZT083925; Sun, 15 Jan 2012 21:46:17 GMT (envelope-from gjb) Date: Sun, 15 Jan 2012 21:46:17 GMT Message-Id: <201201152146.q0FLkHZT083925@freefall.freebsd.org> To: gjb@FreeBSD.org, freebsd-doc@FreeBSD.org, gjb@FreeBSD.org From: gjb@FreeBSD.org Cc: Subject: Re: docs/164188: doc update for new mailing list: freebsd-zope X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 15 Jan 2012 21:46:18 -0000 Synopsis: doc update for new mailing list: freebsd-zope Responsible-Changed-From-To: freebsd-doc->gjb Responsible-Changed-By: gjb Responsible-Changed-When: Sun Jan 15 21:46:02 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=164188 From owner-freebsd-doc@FreeBSD.ORG Mon Jan 16 03:50:13 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 629FC106566C for ; Mon, 16 Jan 2012 03:50:13 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 42EE98FC08 for ; Mon, 16 Jan 2012 03:50:13 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0G3oDgj019470 for ; Mon, 16 Jan 2012 03:50:13 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0G3oCbx019469; Mon, 16 Jan 2012 03:50:12 GMT (envelope-from gnats) Date: Mon, 16 Jan 2012 03:50:12 GMT Message-Id: <201201160350.q0G3oCbx019469@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/164099: man page for gparm set is incorrect and incomplete X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Jan 2012 03:50:13 -0000 The following reply was made to PR docs/164099; it has been noted by GNATS. From: Benjamin Kaduk To: Ariane van der Steldt Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/164099: man page for gparm set is incorrect and incomplete Date: Sun, 15 Jan 2012 22:45:49 -0500 (EST) On Fri, 13 Jan 2012, Ariane van der Steldt wrote: >> Description: > man gparm: set command describes -f as the only specific option to gparm > set and mentions that for further info, the section ATTRIBUTES must be > consulted. > > However: > - the -f option apparently has no relation to ATTRIBUTES > - the -a option is used for the ATTRIBUTES >> How-To-Repeat: > man gparm, read the 'set' command section >> Fix: > Change documentation: > - mention that the attributes are set using -a, not -f [I am assuming that this is actually referring to gpart(8), not a "gparm" that I don't seem to find anywhere.] Hi Ariane, I must confess I'm not entirely sure what parts of the man page are giving you difficulty here, so I'll go through and explain how I'm interpreting things, and you can tell me which parts of my interpretation you aren't getting from the current text. Then we can come up with a patch to make it better. 'gpart set' looks to be mentioned in a few places (hopefully my formatting is not destroyed somewhere in the mail path): % SYNOPSIS % [...] % Usage of the gpart utility: % [...] % gpart set -a attrib -i index [-f flags] geom % [...] % DESCRIPTION % [...] % set Set the named attribute on the partition entry. See the sec- % tion entitled ATTRIBUTES below for a list of available % attributes. % % Additional options include: % % -f flags Additional operational flags. See the section % entitled OPERATIONAL FLAGS below for a discussion % about its use. % [...] % ATTRIBUTES % The scheme-specific attributes for EBR: % % active % % The scheme-specific attributes for GPT: % [..., including MBR and PC98] % OPERATIONAL FLAGS % Actions other than the commit and undo actions take an optional -f flags % option. This option is used to specify action-specific operational % flags. By default, the gpart utility defines the `C' flag so that the % action is immediately committed. The user can specify ``-f x'' to have % the action result in a pending change that can later, with other pending % changes, be committed as a single compound change with the commit action % or reverted with the undo action. The synopsis tells me that the 'gpart set' subcommand takes a mandatory '-a attrib'[utes] argument and a mandatory '-i index' argument, and can take an optional flags argument. It, of course, must also operate on a particular geom device. Looking at the more detailed entry for the 'set' subcommand, I get confirmation that this subcommand must deal with attributes (i.e. has a mandatory argument), and can get the list of choices from the ATTRIBUTES section later on. (Hmm, there is no mention of the 'index' argument here, though, which is probably a separate bug. The text from the 'add' subcommand could be used, but it might be more consistent with the rest of the manual page to just mention it inline.) The 'additional options' then are just the "optional" (i.e. non-mandatory) options, and OPERATIONAL FLAGS tells me what in particular I can use. Which parts of my interpretation do not come through to you from the current text of the man page? I'll put together a patch that includes those changes and also adds mention of the 'index' argument. Thanks, Ben Kaduk From owner-freebsd-doc@FreeBSD.ORG Mon Jan 16 11:06:07 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 75636106564A for ; Mon, 16 Jan 2012 11:06:07 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 5910F8FC0C for ; Mon, 16 Jan 2012 11:06:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0GB67cs056853 for ; Mon, 16 Jan 2012 11:06:07 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0GB66IC056851 for freebsd-doc@FreeBSD.org; Mon, 16 Jan 2012 11:06:06 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 16 Jan 2012 11:06:06 GMT Message-Id: <201201161106.q0GB66IC056851@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: gnats set sender to owner-bugmaster@FreeBSD.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Cc: Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Jan 2012 11:06:07 -0000 (Note: an HTML version of this report is available at http://www.freebsd.org/cgi/query-pr-summary.cgi?category=doc .) The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Tracker Resp. Description -------------------------------------------------------------------------------- o docs/164099 doc gparm(8): man page for gparm set is incorrect and inco o docs/164034 doc acl(9) documentation lacking o docs/163879 doc [handbook] handbook does not say about how to force to o docs/163877 doc apm(4) is not installed o docs/163830 doc device smbios: missing documentation, no manpage o docs/163771 doc getnameinfo(3) man-page detail o docs/163742 doc [patch] document failok mount(8) option o docs/163646 doc update man ehci(4) to mention options USB_DEBUG o docs/163576 doc zfs(8) sync property not noted in the manpage o docs/163177 doc [patch] man page for gnats(7) incorrectly lists gnatsd o docs/163149 doc [patch] Red Hat Linux/i386 9 HTML format sudo man page o docs/163119 doc mktemp(3) is referring to (now) non-existent gcc optio o docs/163043 doc [patch] gsched.8: remove reference to gsched_as o docs/162775 doc zpool(1): Document some undocumented zpool import opti o docs/162765 doc [patch] lseek(2) may return successful although no see o docs/162699 doc Handbook/Upgrading instructions: should mention delete o docs/162433 doc [handbook] QEMU instructions for FreeBSD guests o docs/162419 doc [request] please document (new) zfs and zpool cmdline o docs/162404 doc [handbook] IPv6 link-local address compared with IPv4 o docs/162380 doc Documentation lacking for getfacl/setfacl p docs/162265 doc [Patch] ipfw.8: Documentation clarity o docs/162172 doc rctl manpage erroneously lists nproc a docs/161808 doc Missing documentation critical to correct usage of uui o docs/161804 doc New documentation: French translation for building-pro o docs/161754 doc p4tcc(4), est(4) and qpi(4) are not documented o docs/161496 doc zfs(1): Please document that sysctl vfs.usermount must o docs/161057 doc [handbook] Error in section 18.17.4 of the handbook o docs/160491 doc [patch] reaper of the dead: remove ancient FAQ entries o docs/160460 doc [handbook] Network setup guide suggestion o docs/160447 doc [handbook] Developer's Handbook contains some outdated o docs/160446 doc [handbook] Handbook sound setup seems outdated o docs/160445 doc [handbook] Handbook does not mention ACL o docs/160399 doc Man page for re(4) missing jumbo frames info o docs/159898 doc [patch] libusb.3 whitespace, markup, grammar fixes o docs/159854 doc [patch] grammar updates for carp.4 o docs/159551 doc [patch] ports(7) makes no mention of LOCALBASE o docs/159307 doc [patch] lpd smm chapter unconditionally installed o docs/159298 doc [handbook] document Konqueror with Webkit support to i o docs/158813 doc [patch] grammar updates for jme(4) o docs/158388 doc Incorrect documentation of LOCAL_SCRIPT in release(7) o docs/158387 doc The tree(3) man should mention the RB_FOREACH_SAFE() A o docs/158378 doc cpio/bsdcpio(1) man page does not document -0 and --nu o docs/157908 doc [handbook] Description of post-install should include o docs/157698 doc [patch] gpart(8) man page contains old/incorrect size o docs/157453 doc [patch] document 16-fib cap in setfib.2 o docs/157452 doc [patch] grammar and style nits in ipfw.8 o docs/157337 doc [handbook] [patch] Indentation changes to network serv o docs/157316 doc [patch] update devstat(9) man page o docs/157234 doc [patch] nullfs(5): //proc/curproc/file returns "unknow o docs/157049 doc FreeBSD Handbook: Chapter 14 (Security) Inaccuracy o docs/156955 doc bug in share/man/man2/setsockopt.2 a docs/156920 doc isspecial(3) is not helpful o docs/156815 doc chmod(1): manpage should describe that chmod kicks +t o docs/156689 doc stf(4) output-only documentation gives bad configurati f docs/156187 doc [handbook] [patch] Add bsnmpd to handbook o docs/156081 doc troff falls with troff.core with UTF-8 man with incorr o docs/155982 doc [handbook] reaper of the dead: remove reference to flo o docs/155773 doc dialog(1): dialog manpages not updated o docs/155149 doc [patch] don't encourage using xorg.conf outside of PRE o docs/154838 doc update cvs-tags information on releng_* to reflect sup o docs/153958 doc ksu man-page documented, but not installed o docs/153738 doc [patch] Docuement requirement to alter some sysctls wh a docs/153012 doc [patch] iostat(8) requires an argument to -c option o docs/151752 doc pw.conf(5) doesn't define format for file clearly o docs/150991 doc [patch] Install upgtfw using pkg_add as advised in upg o docs/150917 doc [patch] icmp.4, wrong description of icmplim and icmpl o docs/150877 doc ambiguity in newsyslog(8) man page about zfs with comp o docs/150255 doc dtrace description should mention makeoptions DEBUG=-g o docs/150219 doc zfs(8) manual page misses jail/unjail o docs/149574 doc [patch] update mi_switch(9) man page o docs/149051 doc [request] No document for clang or clang++ o docs/149047 doc [patch] tcsh(1) bears no mention of brace expansion in o docs/148987 doc [patch] {MD[245]|SHA_|SHA1_|SHA256_}{End|File|FileChun o docs/148984 doc [handbook] Mistake in section 16.15.4 of the handbook o docs/148680 doc [sysctl][patch] Document some sys/kern sysctls o docs/148071 doc Failover mode between wired and wireless interfaces o docs/147995 doc elf.5 man page has has missing reference o docs/146958 doc bad link to "XaQti XMAC II datasheet" in sk(4) manual o docs/146521 doc [handbook] Update IPv6 system handbook section to ment o docs/145719 doc [patch] 7.3 relnotes erroneously describes new getpage o docs/145699 doc hexdump(1) mutes all format qualifier output following o docs/145644 doc Add artical about creating manpage from scratch o docs/145069 doc Dialup firewalling with FreeBSD article out dated. o docs/145066 doc Update for new uart dev names for serial port. s docs/144818 doc all mailinglist archives dated 19970101 contain traili o docs/144630 doc [patch] domainname(1) manpage contains old information o docs/144515 doc [handbook] Expand handbook Table of contents o docs/144488 doc share/examples/etc/make.conf: contains dangerous examp o docs/143850 doc procfs(5) manpage for status > controlling terminal is o docs/143416 doc [handbook] IPFW handbook page issues o docs/143408 doc man filedesc(9) is missing o docs/142168 doc [patch] ld(1): ldd(1) not mentioned in ld(1) manpage o docs/141032 doc misleading documentation for rtadvd.conf(5) raflags se s docs/140847 doc [request] add documentation on ECMP and new route args p docs/140457 doc [patch] Grammar fix for isspace(3) o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/139336 doc [request] ZFS documentation suggestion o docs/139165 doc gssapi.3 man page out of sync with between crypto and o docs/139018 doc translation of submitting.sgml from docproj/submitting o docs/138845 doc Exceeding kern.ipc.maxpipekva refers to tuning(7) whic o docs/138663 doc system(3) man page confuses users about "return value o docs/138485 doc bpf(4) and ip(4) man pages missing important corner ca o docs/136712 doc [handbook] [patch] draft new section on gmirror per pa o docs/136666 doc [handbook] Configure serial port for remote kernel deb o docs/136035 doc ftpchroot(5) omits an important option o docs/135516 doc [patch] pax(1) manual not mentioning chflags unawarene o docs/135475 doc [patch] jot(1) manpage and behaviour differ o docs/134123 doc The RUNQUEUE(9) man page is out of date o docs/132839 doc [patch] Fix example script in ldap-auth article o docs/132718 doc [handbook] Information about adding a new mirror is ou o docs/132260 doc dhcpd(8) pid not stored in documented location o docs/132190 doc EPERM explanation for send(2), sendto(2), and sendmsg( o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131626 doc [patch] dump(8) "recommended" cache option confusing o docs/130238 doc nfs.lockd man page doesn't mention NFSLOCKD option or o docs/129671 doc New TCP chapter for Developer's Handbook (from rwatson o docs/129464 doc using packages system o docs/129095 doc ipfw(8): Can not check that packet originating/destine s docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages o docs/127908 doc [patch] readdir(3) error documentation s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126484 doc libc function res-zonscut2 is not documented o docs/125921 doc lpd(8) talks about blocks in minfree while it is KB in f docs/122052 doc minor update on handbook section 20.7.1 o docs/121952 doc Handbook chapter on Network Address Translation wrong o docs/121585 doc [handbook] Wrong multicast specification s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120539 doc Inconsistent ipfw's man page o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118214 doc close(2) error returns incomplete o docs/118020 doc ipfilter(4): man pages query for man 4 ipfilter return o docs/116116 doc mktemp (3) re/move note o docs/116080 doc PREFIX is documented, but not the more important LOCAL p docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/112804 doc groff(1) command should be called to explicitly use "p o docs/112682 doc Handbook GEOM_GPT explanation does not provide accurat o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/111147 doc hostapd.conf is not documented o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110253 doc [patch] rtprio(1): remove processing starvation commen o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit p docs/110061 doc [patch] tuning(7) missing reference to vfs.read_max o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/109973 doc No manual entry for c++filt o docs/109972 doc No manual entry for zless/bzless f docs/109226 doc [request] No manual entry for sntp o docs/109201 doc [request]: manual for callbootd a docs/108980 doc list of missing man pages o docs/106135 doc [request] articles/vinum needs to be updated o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84271 doc [patch] compress(1) doesn't warn about nasty link hand o docs/83820 doc getino(3) manpage not installed o docs/81611 doc [patch] natd runs with -same_ports by default o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour o docs/57298 doc [patch] add using compact flash cards info to handbook s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/51480 doc Multiple undefined references in the FreeBSD manual pa o docs/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] Add documentation on the fixit disk o docs/43823 doc [patch] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples s docs/35678 doc docproj Makefiles for web are broken for paths with sp s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. a docs/30008 doc [patch] French softupdates document should be translat o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 213 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Jan 16 20:20:10 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A5A77106566B for ; Mon, 16 Jan 2012 20:20:10 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 7AEF28FC14 for ; Mon, 16 Jan 2012 20:20:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0GKKAMc067631 for ; Mon, 16 Jan 2012 20:20:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0GKKABh067630; Mon, 16 Jan 2012 20:20:10 GMT (envelope-from gnats) Date: Mon, 16 Jan 2012 20:20:10 GMT Message-Id: <201201162020.q0GKKABh067630@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Garrett Cooper Cc: Subject: Re: docs/162380: Documentation lacking for getfacl/setfacl X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Garrett Cooper List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Jan 2012 20:20:10 -0000 The following reply was made to PR docs/162380; it has been noted by GNATS. From: Garrett Cooper To: bug-followup@FreeBSD.org, yanegomi@gmail.com Cc: Subject: Re: docs/162380: Documentation lacking for getfacl/setfacl Date: Mon, 16 Jan 2012 12:18:10 -0800 Correction: the documentation for _get_facl is lacking -- not setfacl. setfacl describes everything properly -- minus the synchronization flag being the wrong case, e.g. 'S', as opposed to 's'. Thanks, -Garrett From owner-freebsd-doc@FreeBSD.ORG Mon Jan 16 21:03:47 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 942931065673 for ; Mon, 16 Jan 2012 21:03:47 +0000 (UTC) (envelope-from uqs@FreeBSD.org) Received: from acme.spoerlein.net (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by mx1.freebsd.org (Postfix) with ESMTP id 191768FC1F for ; Mon, 16 Jan 2012 21:03:46 +0000 (UTC) Received: from localhost (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by acme.spoerlein.net (8.14.5/8.14.4) with ESMTP id q0GL3jq0070262 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Mon, 16 Jan 2012 22:03:45 +0100 (CET) (envelope-from uqs@FreeBSD.org) Date: Mon, 16 Jan 2012 22:03:45 +0100 From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= To: freebsd-doc@FreeBSD.org Message-ID: <20120116210345.GX3489@acme.spoerlein.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) Cc: Bharath Mohan Subject: RFC Moving linuxemu chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Jan 2012 21:03:47 -0000 Greetings, to incorporate the WINE section from the Wiki into the handbook, there needs to be some reshuffling of the "linuxemu" chapter. To that end, I have a patch ready that renames the chapter to "compat" and intends the current content by one level (sect1->sect2, sect2->sect3, etc.). This is all to make room for a chapter on WINE and possibly on SVR4. I don't know if we do repo-copies in doc/, so should I file a ticket for that? Cheers, Uli From owner-freebsd-doc@FreeBSD.ORG Mon Jan 16 21:12:26 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1A2651065672 for ; Mon, 16 Jan 2012 21:12:26 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from mail-wi0-f182.google.com (mail-wi0-f182.google.com [209.85.212.182]) by mx1.freebsd.org (Postfix) with ESMTP id A3C3A8FC16 for ; Mon, 16 Jan 2012 21:12:25 +0000 (UTC) Received: by wibhq12 with SMTP id hq12so1509484wib.13 for ; Mon, 16 Jan 2012 13:12:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=WdhY+Q5lBf0jq82eVNNG8MpZ7tuB6aJSgX+xlevJ6rM=; b=K4M2nCVYhx253Ny1CRx6ePVYVrpHog+Abp1kr6xvW4JoU6dnoUBw7dVQvka8lL6Yez yFDGV/mVCFrj+oTdv+OyL6HIDzeTgyxm+H50S5cSHII/8Fz3awg/ALDeu/u4OoozZErK XGBl5jKAr55EK/nVgz7m4UXCT/BUEdNZG73oI= Received: by 10.180.102.169 with SMTP id fp9mr23070467wib.9.1326748344517; Mon, 16 Jan 2012 13:12:24 -0800 (PST) Received: from [192.168.0.154] (athedsl-4364864.home.otenet.gr. [79.130.10.48]) by mx.google.com with ESMTPS id l2sm24334593wie.11.2012.01.16.13.12.22 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 16 Jan 2012 13:12:23 -0800 (PST) Message-ID: <4F1492B6.4000609@gmail.com> Date: Mon, 16 Jan 2012 23:12:22 +0200 From: Manolis Kiagias User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.2.18) Gecko/20110616 Thunderbird/3.1.11 MIME-Version: 1.0 To: =?UTF-8?B?VWxyaWNoIFNww7ZybGVpbg==?= References: <20120116210345.GX3489@acme.spoerlein.net> In-Reply-To: <20120116210345.GX3489@acme.spoerlein.net> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Cc: "freebsd-doc@freebsd.org" Subject: Re: RFC Moving linuxemu chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Jan 2012 21:12:26 -0000 On 16/1/2012 11:03 μμ, Ulrich Spörlein wrote: > Greetings, > > to incorporate the WINE section from the Wiki into the handbook, there > needs to be some reshuffling of the "linuxemu" chapter. To that end, I > have a patch ready that renames the chapter to "compat" and intends the > current content by one level (sect1->sect2, sect2->sect3, etc.). This is > all to make room for a chapter on WINE and possibly on SVR4. > > I don't know if we do repo-copies in doc/, so should I file a ticket for > that? > > Cheers, > Uli > Not sure, but AFAIR Tom Rhodes (@trhodes) tried this once to change cutting-edge to updating-upgrading after some major changes but was unsuccessful. Give it a try and if it doesn't work, just change the contents. It will be slightly misleading but still... manolis@ From owner-freebsd-doc@FreeBSD.ORG Mon Jan 16 21:38:46 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 34CFB106566B for ; Mon, 16 Jan 2012 21:38:46 +0000 (UTC) (envelope-from uqs@spoerlein.net) Received: from acme.spoerlein.net (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by mx1.freebsd.org (Postfix) with ESMTP id C09EF8FC1B for ; Mon, 16 Jan 2012 21:38:45 +0000 (UTC) Received: from localhost (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by acme.spoerlein.net (8.14.5/8.14.4) with ESMTP id q0GLcinS070914 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO) for ; Mon, 16 Jan 2012 22:38:44 +0100 (CET) (envelope-from uqs@spoerlein.net) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=spoerlein.net; s=dkim200908; t=1326749925; bh=KqfFOQ/uiMG/LiCW85I0tthgrrBoPnG6vGMvRy2cOj4=; h=Date:From:To:Subject:Message-ID:MIME-Version:Content-Type; b=TN3mF+HTeoS4MHUogheRei2YA3zZAFjszsl1bTeL6hyEWxZLmAuE0hNrG0ZorzdWf rKdeykYR7CXEd3KeU+tgBK5oa8B5Ly1dVRzoiQ3BVnfvzgQuIUcty/+Y//IrGcNJjP +QW0spKbcYSxjGJWOUecSxacSjWV8KyANQU2iKvs= Date: Mon, 16 Jan 2012 22:38:44 +0100 From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= To: freebsd-doc@FreeBSD.org Message-ID: <20120116213844.GY3489@acme.spoerlein.net> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="hwvH6HDNit2nSK4j" Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) Cc: Subject: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Jan 2012 21:38:46 -0000 --hwvH6HDNit2nSK4j Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hey, erm, I must be doing something rather stupid, as a handbook build will fail to succeed if I run 'make obj' first. The attached patch fixes that for me and also still works for non-OBJDIR builds. Ok to commit? Cheers, Uli --hwvH6HDNit2nSK4j Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="docimages.diff" Index: share/mk/doc.images.mk =================================================================== RCS file: /home/dcvs/doc/share/mk/doc.images.mk,v retrieving revision 1.31 diff -u -p -r1.31 doc.images.mk --- share/mk/doc.images.mk 25 Dec 2009 18:12:00 -0000 1.31 +++ share/mk/doc.images.mk 16 Jan 2012 21:21:01 -0000 @@ -91,29 +91,10 @@ IMAGES_PNG= ${_IMAGES_PNG} ${IMAGES_GEN_ IMAGES_EPS= ${_IMAGES_EPS} ${IMAGES_GEN_EPS} ${IMAGES_SCR_EPS} ${IMAGES_PIC_EPS} IMAGES_TXT= ${_IMAGES_TXT} ${IMAGES_SCR_TXT} -.if ${.OBJDIR} != ${.CURDIR} -LOCAL_IMAGES= ${IMAGES:S|^|${.OBJDIR}/|} -CLEANFILES+= ${LOCAL_IMAGES} - -.if !empty(_IMAGES_PNG) -LOCAL_IMAGES_PNG= ${_IMAGES_PNG:S|^|${.OBJDIR}/|} -.endif - -.if !empty(_IMAGES_EPS) -LOCAL_IMAGES_EPS= ${_IMAGES_EPS:S|^|${.OBJDIR}/|} -.endif - -.if !empty(_IMAGES_TXT) -LOCAL_IMAGES_TXT= ${_IMAGES_TXT:S|^|${.OBJDIR}/|} -.endif - -.else LOCAL_IMAGES= ${IMAGES} LOCAL_IMAGES_PNG= ${_IMAGES_PNG} LOCAL_IMAGES_EPS= ${_IMAGES_EPS} LOCAL_IMAGES_TXT= ${_IMAGES_TXT} -.endif - LOCAL_IMAGES_PNG+= ${IMAGES_GEN_PNG} ${IMAGES_SCR_PNG} ${IMAGES_PIC_PNG} LOCAL_IMAGES_EPS+= ${IMAGES_GEN_EPS} ${IMAGES_SCR_EPS} ${IMAGES_PIC_EPS} LOCAL_IMAGES_TXT+= ${IMAGES_SCR_TXT} --hwvH6HDNit2nSK4j-- From owner-freebsd-doc@FreeBSD.ORG Tue Jan 17 01:30:08 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 68DBE1065670 for ; Tue, 17 Jan 2012 01:30:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 41FF38FC1C for ; Tue, 17 Jan 2012 01:30:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0H1U8Q6054764 for ; Tue, 17 Jan 2012 01:30:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0H1U8gk054762; Tue, 17 Jan 2012 01:30:08 GMT (envelope-from gnats) Resent-Date: Tue, 17 Jan 2012 01:30:08 GMT Resent-Message-Id: <201201170130.q0H1U8gk054762@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, Mark Gladman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 40972106566C for ; Tue, 17 Jan 2012 01:28:47 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 1FE9B8FC16 for ; Tue, 17 Jan 2012 01:28:47 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q0H1SknC063749 for ; Tue, 17 Jan 2012 01:28:46 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q0H1SkG4063748; Tue, 17 Jan 2012 01:28:46 GMT (envelope-from nobody) Message-Id: <201201170128.q0H1SkG4063748@red.freebsd.org> Date: Tue, 17 Jan 2012 01:28:46 GMT From: Mark Gladman To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/164228: Adding raid3 to handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Jan 2012 01:30:08 -0000 >Number: 164228 >Category: docs >Synopsis: Adding raid3 to handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Jan 17 01:30:07 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Mark Gladman >Release: 8.2-stable >Organization: >Environment: >Description: I'd like to propose adding a raid3 section to the FreeBSD handbook using geom_raid3 >How-To-Repeat: >Fix: Please find attached an ugly non-marked-up text document of a proposed raid3 handbook page. I apologise, I don't know DocBook (but am working on it as time permits)... Patch attached with submission follows: Written by Mark Gladman based on documentation from Tom Rhodes and Murray Stokely. RAID3 is a method used to combine several disk drives into a single volume with a dedicated parity disk . The GEOM disk subsystem provides software support for RAID3. In a RAID3 system, data is split up in to a number of bytes* that get written across all the drives in the array except for one disk, that acts as a dedicated parity disk. This means that reading 1024kb from a RAID3 implementation will access all disks in the array bar one (the dedicated parity disk*) to read the 1024kb. This performance can be enhanced by using multiple disk controllers. Each disk in a RAID3 array must be of the same size, since I/O requests are interleaved to read or write to multiple disks in parallel. Also due to the nature of RAID3, the number of components must be equal to 3, 5, 9, 17, etc. (2^n + 1). Creating aarray of unformatted ATA disks 1. Load the geom_raid3.ko module: # kldload geom_raid3 2. Ensure that a suitable mount point exists. If this volume will become a root partition, then temporarily use another mount point such as /mnt: # mkdir /mnt 3. Determine the device names for the disks which will be added to the array, and create the new RAID3 device. The final device listed will be the dedicated parity disk. For example, to add three disks unused and unpartitioned ATA disks, for example /dev/ad1, /dev/ad2 and /dev/ad3: # graid3 label -v gr0 /dev/ad1 /dev/ad2 /dev/ad3 Metadata value stored on /dev/ad1. Metadata value stored on /dev/ad2. Metadata value stored on /dev/ad3. Done. 4. Write a standard label, also known as a partition table, on the new volume and install the default bootstrap code: # bsdlabel -wB /dev/raid3/gr0 5. This process should have created two other devices in the /dev/raid3 directory in addition to the gr0 device. Those include gr0a and gr0c. At this point a file system may be created on the gr0a device with the newfs utility: # newfs -U /dev/raid3/gr0a Many numbers will glide across the screen, and after a few seconds, the process will be complete. The volume has been created and is ready to be mounted. To manually mount the created disk stripe: # mount /dev/raid3/gr0a /mnt To mount this newly created array's file system automatically during the boot process, place the volume information in /etc/fstab file. For this purpose, a permanent mount point, named raid3, is created: # mkdir /raid3 # echo "/dev/raid3/gr0a /raid3 ufs rw 2 2" \ >> /etc/fstab The geom_raid3.ko module must also be automatically loaded during system initialization, by adding a line to /boot/loader.conf: # echo 'geom_raid3_load="YES"' >> /boot/loader.conf >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue Jan 17 04:58:53 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 36609106564A; Tue, 17 Jan 2012 04:58:53 +0000 (UTC) (envelope-from linimon@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 090368FC0C; Tue, 17 Jan 2012 04:58:53 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0H4wqjK048945; Tue, 17 Jan 2012 04:58:52 GMT (envelope-from linimon@freefall.freebsd.org) Received: (from linimon@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0H4wqV3048941; Tue, 17 Jan 2012 04:58:52 GMT (envelope-from linimon) Date: Tue, 17 Jan 2012 04:58:52 GMT Message-Id: <201201170458.q0H4wqV3048941@freefall.freebsd.org> To: linimon@FreeBSD.org, freebsd-bugs@FreeBSD.org, freebsd-doc@FreeBSD.org From: linimon@FreeBSD.org Cc: Subject: Re: docs/164217: [patch] correct synchronize flag in setfacl(1) manpage X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Jan 2012 04:58:53 -0000 Synopsis: [patch] correct synchronize flag in setfacl(1) manpage Responsible-Changed-From-To: freebsd-bugs->freebsd-doc Responsible-Changed-By: linimon Responsible-Changed-When: Tue Jan 17 04:58:33 UTC 2012 Responsible-Changed-Why: reassign. http://www.freebsd.org/cgi/query-pr.cgi?pr=164217 From owner-freebsd-doc@FreeBSD.ORG Tue Jan 17 07:16:32 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E0E01106566C for ; Tue, 17 Jan 2012 07:16:32 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper-int.allbsd.org [IPv6:2001:2f0:104:e002::2]) by mx1.freebsd.org (Postfix) with ESMTP id CBB908FC0A for ; Tue, 17 Jan 2012 07:16:31 +0000 (UTC) Received: from alph.allbsd.org ([IPv6:2001:2f0:104:e010:862b:2bff:febc:8956]) (authenticated bits=128) by mail.allbsd.org (8.14.4/8.14.4) with ESMTP id q0H7GFZW051981; Tue, 17 Jan 2012 16:16:25 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [IPv6:::1]) (authenticated bits=0) by alph.allbsd.org (8.14.4/8.14.4) with ESMTP id q0H7GCFI092983; Tue, 17 Jan 2012 16:16:15 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Tue, 17 Jan 2012 16:16:05 +0900 (JST) Message-Id: <20120117.161605.2130678104801057350.hrs@allbsd.org> To: uqs@spoerlein.net From: Hiroki Sato In-Reply-To: <20120116213844.GY3489@acme.spoerlein.net> References: <20120116213844.GY3489@acme.spoerlein.net> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.3.51 on Emacs 23.3 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Tue_Jan_17_16_16_05_2012_375)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.3 (mail.allbsd.org [IPv6:2001:2f0:104:e001::32]); Tue, 17 Jan 2012 16:16:27 +0900 (JST) X-Spam-Status: No, score=-104.0 required=13.0 tests=BAYES_00, CONTENT_TYPE_PRESENT, MIMEQENC, QENCPTR1, QENCPTR2, RDNS_NONE, SPF_SOFTFAIL, USER_IN_WHITELIST autolearn=no version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on gatekeeper.allbsd.org Cc: freebsd-doc@FreeBSD.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Jan 2012 07:16:33 -0000 ----Security_Multipart(Tue_Jan_17_16_16_05_2012_375)-- Content-Type: Text/Plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Ulrich Sp=F6rlein wrote in <20120116213844.GY3489@acme.spoerlein.net>: uq> Hey, uq> = uq> erm, I must be doing something rather stupid, as a handbook build w= ill uq> fail to succeed if I run 'make obj' first. uq> = uq> The attached patch fixes that for me and also still works for non-O= BJDIR uq> builds. uq> = uq> Ok to commit? The original intention was to create image files under ${.OBJDIR}/ and pick them up from there, but the OBJDIR support looks broken as far as I can check now. Please go ahead with your patch. While it does not fix the support (i.e. files can be created outside the OBJDIR during the build process), it should eliminate the build error with no harmful effect. I will revisit to fix the support later. -- Hiroki ----Security_Multipart(Tue_Jan_17_16_16_05_2012_375)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (FreeBSD) iEYEABECAAYFAk8VIDUACgkQTyzT2CeTzy3/TgCfep/lPUNngE1bkrEkdXS4EbTG n2IAoIRcBdLbGz8ZLvJECs7PPQGOcb73 =1C+j -----END PGP SIGNATURE----- ----Security_Multipart(Tue_Jan_17_16_16_05_2012_375)---- From owner-freebsd-doc@FreeBSD.ORG Tue Jan 17 08:39:41 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4DE051065677; Tue, 17 Jan 2012 08:39:41 +0000 (UTC) (envelope-from uqs@spoerlein.net) Received: from acme.spoerlein.net (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by mx1.freebsd.org (Postfix) with ESMTP id D50FE8FC0A; Tue, 17 Jan 2012 08:39:40 +0000 (UTC) Received: from localhost (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by acme.spoerlein.net (8.14.5/8.14.4) with ESMTP id q0H8ddLq083752 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Tue, 17 Jan 2012 09:39:39 +0100 (CET) (envelope-from uqs@spoerlein.net) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=spoerlein.net; s=dkim200908; t=1326789579; bh=YcUAHN49xz/BEmOHb+hSKUM7yxYZElkcDJpXnAflLaI=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Transfer-Encoding:In-Reply-To; b=Th7UKPV0Qt4lI/bdxIDq3cRl+/4b2AcDwzBbDEWiXDRTD+Z2V8lP3tYxUf2Jy4dwy keN0kbOnjHqE9XSz8OKWBCmEh1bY6yLwk9XrCIqVJ1Hy4fMiOOmi9Mj8nGZYHhWDMv +XszkkAkOmtPSb/eK1uPUbC0p/uxLNSJHwCVc+wU= Date: Tue, 17 Jan 2012 09:39:39 +0100 From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= To: Hiroki Sato Message-ID: <20120117083938.GZ3489@acme.spoerlein.net> References: <20120116213844.GY3489@acme.spoerlein.net> <20120117.161605.2130678104801057350.hrs@allbsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20120117.161605.2130678104801057350.hrs@allbsd.org> User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-doc@FreeBSD.org Subject: Re: doc build with .OBJDIR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Jan 2012 08:39:41 -0000 On Tue, 2012-01-17 at 16:16:05 +0900, Hiroki Sato wrote: > Ulrich Spörlein wrote > in <20120116213844.GY3489@acme.spoerlein.net>: > > > Hey, > > > > erm, I must be doing something rather stupid, as a handbook build will > > fail to succeed if I run 'make obj' first. > > > > The attached patch fixes that for me and also still works for non-OBJDIR > > builds. > > > > Ok to commit? > > The original intention was to create image files under ${.OBJDIR}/ > and pick them up from there, but the OBJDIR support looks broken as > far as I can check now. Please go ahead with your patch. While it > does not fix the support (i.e. files can be created outside the > OBJDIR during the build process), it should eliminate the build error > with no harmful effect. I will revisit to fix the support later. > > -- Hiroki Committed, thanks! Cheers, Uli From owner-freebsd-doc@FreeBSD.ORG Wed Jan 18 05:10:16 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AA12B1065674 for ; Wed, 18 Jan 2012 05:10:16 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 94D658FC23 for ; Wed, 18 Jan 2012 05:10:16 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0I5AG4Y031986 for ; Wed, 18 Jan 2012 05:10:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0I5AGXB031985; Wed, 18 Jan 2012 05:10:16 GMT (envelope-from gnats) Date: Wed, 18 Jan 2012 05:10:16 GMT Message-Id: <201201180510.q0I5AGXB031985@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Ariane van der Steldt Cc: Subject: Re: docs/164099: man page for gparm set is incorrect and incomplete X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Ariane van der Steldt List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jan 2012 05:10:16 -0000 The following reply was made to PR docs/164099; it has been noted by GNATS. From: Ariane van der Steldt To: Benjamin Kaduk Cc: freebsd-gnats-submit@freebsd.org Subject: Re: docs/164099: man page for gparm set is incorrect and incomplete Date: Wed, 18 Jan 2012 06:05:11 +0100 On Sun, Jan 15, 2012 at 10:45:49PM -0500, Benjamin Kaduk wrote: > On Fri, 13 Jan 2012, Ariane van der Steldt wrote: > >> Description: > > man gparm: set command describes -f as the only specific option to gparm > > set and mentions that for further info, the section ATTRIBUTES must be > > consulted. > > > > However: > > - the -f option apparently has no relation to ATTRIBUTES > > - the -a option is used for the ATTRIBUTES > >> How-To-Repeat: > > man gparm, read the 'set' command section > >> Fix: > > Change documentation: > > - mention that the attributes are set using -a, not -f > > [I am assuming that this is actually referring to gpart(8), not a "gparm" > that I don't seem to find anywhere.] gpart indeed, my apologies. > I must confess I'm not entirely sure what parts of the man page are giving > you difficulty here, so I'll go through and explain how I'm interpreting > things, and you can tell me which parts of my interpretation you aren't > getting from the current text. Then we can come up with a patch to make > it better. > > 'gpart set' looks to be mentioned in a few places (hopefully my formatting > is not destroyed somewhere in the mail path): > > % SYNOPSIS > % [...] > % Usage of the gpart utility: > % [...] > % gpart set -a attrib -i index [-f flags] geom > % [...] > % DESCRIPTION > % [...] > % set Set the named attribute on the partition entry. See the sec- > % tion entitled ATTRIBUTES below for a list of available > % attributes. > % > % Additional options include: > % > % -f flags Additional operational flags. See the section > % entitled OPERATIONAL FLAGS below for a discussion > % about its use. The above is where it went wrong. I double checked and the error is all mine. I think what happened was I read the -f as only option, went up again (the kernel options left me wondering if I really had this enabled, which invoking 'gpart show' confirmed) and then scrolled back to the set subcommand. Where I proceeded to find the uppercase wording and probably selected the wrong term. At least, that's what I think happened. :/ > % [...] > % ATTRIBUTES > % The scheme-specific attributes for EBR: > % > % active > % > % The scheme-specific attributes for GPT: > % [..., including MBR and PC98] > % OPERATIONAL FLAGS > % Actions other than the commit and undo actions take an optional -f flags > % option. This option is used to specify action-specific operational > % flags. By default, the gpart utility defines the `C' flag so that the > % action is immediately committed. The user can specify ``-f x'' to have > % the action result in a pending change that can later, with other pending > % changes, be committed as a single compound change with the commit action > % or reverted with the undo action. > > The synopsis tells me that the 'gpart set' subcommand takes a mandatory > '-a attrib'[utes] argument and a mandatory '-i index' argument, and can > take an optional flags argument. It, of course, must also operate on a > particular geom device. > > Looking at the more detailed entry for the 'set' subcommand, I get > confirmation that this subcommand must deal with attributes (i.e. has a > mandatory argument), and can get the list of choices from the ATTRIBUTES > section later on. (Hmm, there is no mention of the 'index' argument here, > though, which is probably a separate bug. The text from the 'add' > subcommand could be used, but it might be more consistent with the rest of > the manual page to just mention it inline.) The 'additional options' then > are just the "optional" (i.e. non-mandatory) options, and OPERATIONAL > FLAGS tells me what in particular I can use. It seems a bit strange to me to mention the -f option for each entry, while it seems to be universal to each modifying subcommand. Alternatively, the -a, -i and -f could be described at the top of the DESCRIPTION, followed by each ofthe subcommands. > Which parts of my interpretation do not come through to you from the > current text of the man page? I'll put together a patch that includes > those changes and also adds mention of the 'index' argument. I think it's best to describe the -a, -i, -f etc options at the top of the description, after: 'The gpart utility is used to partition GEOM providers, normally disks.' It'll mean less duplication of text (by reducing the -f description to only one occurence) and places the options closer to the synopsis, improving readability. None the less, the error was obviously mine, my apologies. -- Ariane From owner-freebsd-doc@FreeBSD.ORG Wed Jan 18 10:00:26 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 38EB71065674 for ; Wed, 18 Jan 2012 10:00:26 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 054AF8FC0A for ; Wed, 18 Jan 2012 10:00:26 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0IA0Pca038082 for ; Wed, 18 Jan 2012 10:00:25 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0IA0Pop038081; Wed, 18 Jan 2012 10:00:25 GMT (envelope-from gnats) Resent-Date: Wed, 18 Jan 2012 10:00:25 GMT Resent-Message-Id: <201201181000.q0IA0Pop038081@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, Roman Kurakin Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id EA35C106564A for ; Wed, 18 Jan 2012 09:59:28 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id BBCF78FC0A for ; Wed, 18 Jan 2012 09:59:28 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q0I9xSMk077421 for ; Wed, 18 Jan 2012 09:59:28 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q0I9xSif077420; Wed, 18 Jan 2012 09:59:28 GMT (envelope-from nobody) Message-Id: <201201180959.q0I9xSif077420@red.freebsd.org> Date: Wed, 18 Jan 2012 09:59:28 GMT From: Roman Kurakin To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/164276: books/handbook/mirrors.html page update X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jan 2012 10:00:26 -0000 >Number: 164276 >Category: docs >Synopsis: books/handbook/mirrors.html page update >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Wed Jan 18 10:00:25 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Roman Kurakin >Release: >Organization: FreeBSD >Environment: >Description: The http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html page need to be update on request of owner of http://linux-distro.co.uk resource. He asks to add the resource to that page. >How-To-Repeat: >Fix: Add the http://linux-distro.co.uk resource to the page http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Jan 18 13:12:37 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C1DC81065759; Wed, 18 Jan 2012 13:12:37 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 93DDB8FC16; Wed, 18 Jan 2012 13:12:37 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0IDCbY4036668; Wed, 18 Jan 2012 13:12:37 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0IDCbKo036664; Wed, 18 Jan 2012 13:12:37 GMT (envelope-from eadler) Date: Wed, 18 Jan 2012 13:12:37 GMT Message-Id: <201201181312.q0IDCbKo036664@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-doc@FreeBSD.org, eadler@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/127908: [patch] readdir(3) error documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jan 2012 13:12:37 -0000 Synopsis: [patch] readdir(3) error documentation Responsible-Changed-From-To: freebsd-doc->eadler Responsible-Changed-By: eadler Responsible-Changed-When: Wed Jan 18 13:12:37 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=127908 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 18 16:21:12 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 27F191065670 for ; Wed, 18 Jan 2012 16:21:12 +0000 (UTC) (envelope-from adam.k.kirchhoff@gmail.com) Received: from mail-vw0-f54.google.com (mail-vw0-f54.google.com [209.85.212.54]) by mx1.freebsd.org (Postfix) with ESMTP id D6E0D8FC16 for ; Wed, 18 Jan 2012 16:21:11 +0000 (UTC) Received: by vbbey12 with SMTP id ey12so3295911vbb.13 for ; Wed, 18 Jan 2012 08:21:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:date:message-id:subject:from:to:content-type; bh=B2gYyj6OoIM5iNla6UBF0fG4gQh74NxXcGcmXPFYKro=; b=a54i/1MjQ/T3pL9lH8rilHvzJiJsLQ3GALA2ne7P819bY+TKvpubL+O/xw3ndB22if FaPnRDauw4p1lA2nZe2vt5MeF9T6m3vYO+aFhJCKPHt0fRRf8IQJpj0gLAUb7F09UwEe DpCAW70LA0wD0wkcO3pZ8WycBJMSUUz6wI9N8= MIME-Version: 1.0 Received: by 10.52.17.174 with SMTP id p14mr3477576vdd.20.1326901809501; Wed, 18 Jan 2012 07:50:09 -0800 (PST) Received: by 10.220.178.2 with HTTP; Wed, 18 Jan 2012 07:50:09 -0800 (PST) Date: Wed, 18 Jan 2012 10:50:09 -0500 Message-ID: From: Adam Kirchhoff To: doc@FreeBSD.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: FreeBSD 9.0-RELEASE Hardware Notes is wrong. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jan 2012 16:21:12 -0000 http://www.freebsd.org/releases/9.0R/hardware.html This section is correct: [i386,amd64] The snd_emu10kx(4) driver supports the following sound cards: > Creative Sound Blaster Live! (EMU10K1 Chipset). Both PCM and MIDI > interfaces are available. > Creative Sound Blaster Audigy (CA0100 and CA0101 Chipset). PCM and two > MIDI interfaces available. > Creative Sound Blaster Audigy 2 and Creative Sound Blaster Audigy 4 > (CA0102 Chipset). PCM support is limited to 48kHz/16 bit stereo (192kHz/24 > bit part of this chipset is not supported). > Creative Sound Blaster Audigy 2 Value (CA0108 Chipset). PCM support is > limited to 48kHz/16 bit stereo (192kHz/24 bit part of this chipset is not > supported). There is no MIDI support for this card. This section is wrong: The snd_emu10kx(4) driver does support the following sound cards (although > they have names similar to some supported ones): > Creative Sound Blaster Live! 24-Bit, identified by FreeBSD as > Creative Sound Blaster Audigy LS / ES, identified by FreeBSD as > All other Creative sound cards with -DAT chipsets. > All Creative X-Fi series sound cards. None of those cards are supported by snd_emu10kx (according to the man page, and in my own personal experience). I believe a "does support" should read "does not support". Adam From owner-freebsd-doc@FreeBSD.ORG Wed Jan 18 21:00:47 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 711181065700; Wed, 18 Jan 2012 21:00:47 +0000 (UTC) (envelope-from marck@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 4798C8FC19; Wed, 18 Jan 2012 21:00:47 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0IL0lHZ062449; Wed, 18 Jan 2012 21:00:47 GMT (envelope-from marck@freefall.freebsd.org) Received: (from marck@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0IL0ldw062440; Wed, 18 Jan 2012 21:00:47 GMT (envelope-from marck) Date: Wed, 18 Jan 2012 21:00:47 GMT Message-Id: <201201182100.q0IL0ldw062440@freefall.freebsd.org> To: rik@FreeBSD.org, marck@FreeBSD.org, freebsd-doc@FreeBSD.org From: marck@FreeBSD.org Cc: Subject: Re: docs/164276: books/handbook/mirrors.html page update X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jan 2012 21:00:47 -0000 Synopsis: books/handbook/mirrors.html page update State-Changed-From-To: open->closed State-Changed-By: marck State-Changed-When: Wed Jan 18 21:00:29 UTC 2012 State-Changed-Why: Committed, thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=164276 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 18 21:10:09 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 92EC81065675 for ; Wed, 18 Jan 2012 21:10:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 828908FC18 for ; Wed, 18 Jan 2012 21:10:09 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0ILA95q069589 for ; Wed, 18 Jan 2012 21:10:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0ILA9lF069588; Wed, 18 Jan 2012 21:10:09 GMT (envelope-from gnats) Date: Wed, 18 Jan 2012 21:10:09 GMT Message-Id: <201201182110.q0ILA9lF069588@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: dfilter@FreeBSD.ORG (dfilter service) Cc: Subject: Re: docs/164276: commit references a PR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: dfilter service List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jan 2012 21:10:09 -0000 The following reply was made to PR docs/164276; it has been noted by GNATS. From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/164276: commit references a PR Date: Wed, 18 Jan 2012 21:00:31 +0000 (UTC) marck 2012-01-18 21:00:11 UTC FreeBSD doc repository Modified files: en_US.ISO8859-1/books/handbook/mirrors chapter.sgml Log: Add linux-distro.co.uk Requested by: rik PR: 164276 Revision Changes Path 1.505 +11 -0 doc/en_US.ISO8859-1/books/handbook/mirrors/chapter.sgml _______________________________________________ cvs-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/cvs-all To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org" From owner-freebsd-doc@FreeBSD.ORG Wed Jan 18 22:49:49 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E71B7106564A for ; Wed, 18 Jan 2012 22:49:49 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 8C0DA8FC1A for ; Wed, 18 Jan 2012 22:49:49 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q0IMnmVk041401 for ; Wed, 18 Jan 2012 15:49:48 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q0IMnmHh041398 for ; Wed, 18 Jan 2012 15:49:48 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Wed, 18 Jan 2012 15:49:48 -0700 (MST) From: Warren Block To: freebsd-doc@freebsd.org In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Wed, 18 Jan 2012 15:49:48 -0700 (MST) Subject: Re: Tidy and HTML tab spacing X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jan 2012 22:49:50 -0000 HTML versions of FreeBSD documents are fed through tidy (www/tidy or www/tidy-devel) for cleanup. There's a bug in tidy[1] that can cause tab stops to be wrong: http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-distfiles.html#AEN1623 Note how DISTNAME and EXTRACT_SUFX do not line up. They are correct in the source book.sgml. So what to do? 1. It might be possible to fix tidy. This would be the neatest. (See [1]). 2. An option could be added to tidy to ignore tabs. The HTML standard "strongly discourages" tabs in PRE elements[2], but does not disallow them. Using actual tabs has an added benefit to the user in that they could cut-and-paste or just drag-select Makefile examples to see embedded tabs. 3. Tidy could be replaced with some other tool. However, the others I've found have additional dependencies on either PHP or Java, so I did not test them for correct handling of tabs[3],[4]. Either one adds some overhead not just for doc build machines but anyone who wants to work on FreeBSD documentation. 4. Add newlines to the HTML in the build process before it gets to tidy: s/CLASS="PROGRAMLISTING"\n>/CLASS="PROGRAMLISTING">\n/ 5. Don't tidy HTML files at all (suggested as an option by Benedict Reuschling). The unprocessed HTML is ugly, but few people are going to look at it directly. Files that haven't been through tidy are a little larger, about 4% in the case of the Porter's Handbook. Footnotes: [1] In www/tidy-devel, line 355 of streamio.c does not realize that characters at the beginning of the line may be inside a tag and should not count as visible. The pre-tidy HTML output of the example above is ---- 
DISTNAME=	foo
EXTRACT_SUFX=	.tgz
---- The '>' before DISTNAME is being wrongly counted toward the tab stop. See http://www.wonkity.com/~wblock/tidy/ for a slightly more detailed example. Tidy is mature software, and there's been a bug report for this problem in the bug database since 2008: https://sourceforge.net/tracker/?func=detail&aid=1885471&group_id=27659&atid=390963 So bug fixes in this area from the tidy project are unlikely. [2] http://www.w3.org/TR/html401/struct/text.html#edef-PRE [3] http://htmlpurifier.org/ [4] http://htmlcleaner.sourceforge.net/index.php From owner-freebsd-doc@FreeBSD.ORG Wed Jan 18 23:45:55 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 28B0E106566C for ; Wed, 18 Jan 2012 23:45:55 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper-int.allbsd.org [IPv6:2001:2f0:104:e002::2]) by mx1.freebsd.org (Postfix) with ESMTP id 16B6A8FC12 for ; Wed, 18 Jan 2012 23:45:53 +0000 (UTC) Received: from alph.allbsd.org ([IPv6:2001:2f0:104:e010:862b:2bff:febc:8956]) (authenticated bits=128) by mail.allbsd.org (8.14.4/8.14.4) with ESMTP id q0INjerB041330; Thu, 19 Jan 2012 08:45:50 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [IPv6:::1]) (authenticated bits=0) by alph.allbsd.org (8.14.4/8.14.4) with ESMTP id q0INjb8b056299; Thu, 19 Jan 2012 08:45:39 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Thu, 19 Jan 2012 08:44:34 +0900 (JST) Message-Id: <20120119.084434.926306642968660094.hrs@allbsd.org> To: wblock@wonkity.com From: Hiroki Sato In-Reply-To: References: X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.3.51 on Emacs 23.3 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Thu_Jan_19_08_44_34_2012_839)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.3 (mail.allbsd.org [IPv6:2001:2f0:104:e001::32]); Thu, 19 Jan 2012 08:45:50 +0900 (JST) X-Spam-Status: No, score=-104.6 required=13.0 tests=BAYES_00, CONTENT_TYPE_PRESENT, RDNS_NONE, SPF_SOFTFAIL, USER_IN_WHITELIST autolearn=no version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on gatekeeper.allbsd.org Cc: freebsd-doc@FreeBSD.org Subject: Re: Tidy and HTML tab spacing X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 18 Jan 2012 23:45:55 -0000 ----Security_Multipart(Thu_Jan_19_08_44_34_2012_839)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Warren Block wrote in : wb> HTML versions of FreeBSD documents are fed through tidy (www/tidy or wb> www/tidy-devel) for cleanup. There's a bug in tidy[1] that can cause wb> tab stops to be wrong: wb> http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-distfiles.html#AEN1623 wb> wb> Note how DISTNAME and EXTRACT_SUFX do not line up. They are correct wb> in the source book.sgml. wb> wb> So what to do? I lean to fixing Tidy if possible. The reason why we are using Tidy is to fix mark-ups in rendered results from various tools like Jade, not (only) for human-readability. The results of Tidy are still not perfect from viewpoint of standard conformance, but it is better than nothing even if most of modern www browsers can handle the rendered HTMLs directly. It is known that there are some problems with entity dereference and white-space handling as you also pointed out. wb> 3. Tidy could be replaced with some other tool. However, the others Although I tried xmlindent, xmlformat, and xmllint as a replacement in the past, they were indended for well-formed XML docs and not enough for fixing malformed (sometimes broken) mark-ups. wb> 4. Add newlines to the HTML in the build process before it gets to wb> tidy: wb> s/CLASS="PROGRAMLISTING"\n>/CLASS="PROGRAMLISTING">\n/ I think this will break the results because a newline just after ">" is recognized as CDATA. wb> 5. Don't tidy HTML files at all (suggested as an option by Benedict wb> Reuschling). The unprocessed HTML is ugly, but few people are going wb> to look at it directly. Files that haven't been through tidy are a wb> little larger, about 4% in the case of the Porter's Handbook. To eliminate Tidy we have to improve standard conformance of the rendered results. I do not know the recent situation precisely because I investigated it seven years ago, but I think it still has some glitches. -- Hiroki ----Security_Multipart(Thu_Jan_19_08_44_34_2012_839)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (FreeBSD) iEYEABECAAYFAk8XWWIACgkQTyzT2CeTzy3HyQCeMVvG+f2eYwy4eQeSlgSWZOZv /AoAn3xKxtWP13Zwx1wD36PL32/SJozj =Tjgi -----END PGP SIGNATURE----- ----Security_Multipart(Thu_Jan_19_08_44_34_2012_839)---- From owner-freebsd-doc@FreeBSD.ORG Thu Jan 19 01:01:22 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F33A7106566C for ; Thu, 19 Jan 2012 01:01:21 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-4.mit.edu (DMZ-MAILSEC-SCANNER-4.MIT.EDU [18.9.25.15]) by mx1.freebsd.org (Postfix) with ESMTP id 937C28FC1C for ; Thu, 19 Jan 2012 01:01:21 +0000 (UTC) X-AuditID: 1209190f-b7f8a6d000000914-d5-4f176b5f7125 Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-4.mit.edu (Symantec Messaging Gateway) with SMTP id 70.0E.02324.F5B671F4; Wed, 18 Jan 2012 20:01:20 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id q0J11JiW022196; Wed, 18 Jan 2012 20:01:19 -0500 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q0J11I0X020644 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 18 Jan 2012 20:01:19 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id q0J11Hlu022460; Wed, 18 Jan 2012 20:01:17 -0500 (EST) Date: Wed, 18 Jan 2012 20:01:17 -0500 (EST) From: Benjamin Kaduk To: Adam Kirchhoff In-Reply-To: Message-ID: References: User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrNIsWRmVeSWpSXmKPExsUixG6nopuQLe5vcPCGoMXZn0YWUz/uZHVg 8pjxaT6Lx85Zd9kDmKK4bFJSczLLUov07RK4MtrW/GEuWM9T8b63gbWB8T9nFyMHh4SAicTO Ju4uRk4gU0ziwr31bF2MXBxCAvsYJZb2NkA5Gxgl+m5/Z4RwDjBJ7Dm4kBWkRUiggVHi0cVU EJtFQFviy71H7CA2m4CKxMw3G9lAbBEBfYljxyaC2cwCwhKnL91lBLGFBSwlFn3YCmZzCgRK THu5DqyGV8Be4vrmd4wQ8wMk5j+6AbZLVEBHYvX+KSwQNYISJ2c+YYGYaSlx7s91tgmMgrOQ pGYhSS1gZFrFKJuSW6Wbm5iZU5yarFucnJiXl1qka6KXm1mil5pSuokRFKackvw7GL8dVDrE KMDBqMTDGyki7i/EmlhWXJl7iFGSg0lJlHdjBlCILyk/pTIjsTgjvqg0J7X4EKMEB7OSCO9O E6Acb0piZVVqUT5MSpqDRUmcV03rnZ+QQHpiSWp2ampBahFMVoaDQ0mC93IWUKNgUWp6akVa Zk4JQpqJgxNkOA/Q8D0gNbzFBYm5xZnpEPlTjIpS4ryLQRICIImM0jy4XlgaecUoDvSKMG8H SBUPMAXBdb8CGswENNijSQxkcEkiQkqqgTGLaQ5f+DSXNfF+Ar5sJWdv3Dw23zkp7KGULM/l 5b8nVHSkM0eyT7so0Zxq+r/ae5l2CadJuUr/8x2LIs5XmTWdZdiqfG2qd9DfDT8W3e5un+79 7FW14ndtxx7z7a/XMb7Z+VG0bO3Dpw8nHI1T3ywdxPxBs2lBNvucPWu+hcV0nnouZFupl6fE UpyRaKjFXFScCADuLxOT/gIAAA== Cc: doc@freebsd.org Subject: Re: FreeBSD 9.0-RELEASE Hardware Notes is wrong. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Jan 2012 01:01:22 -0000 On Wed, 18 Jan 2012, Adam Kirchhoff wrote: > http://www.freebsd.org/releases/9.0R/hardware.html > > This section is correct: > > [i386,amd64] The snd_emu10kx(4) driver supports the following sound cards: >> Creative Sound Blaster Live! (EMU10K1 Chipset). Both PCM and MIDI >> interfaces are available. >> Creative Sound Blaster Audigy (CA0100 and CA0101 Chipset). PCM and two >> MIDI interfaces available. >> Creative Sound Blaster Audigy 2 and Creative Sound Blaster Audigy 4 >> (CA0102 Chipset). PCM support is limited to 48kHz/16 bit stereo (192kHz/24 >> bit part of this chipset is not supported). >> Creative Sound Blaster Audigy 2 Value (CA0108 Chipset). PCM support is >> limited to 48kHz/16 bit stereo (192kHz/24 bit part of this chipset is not >> supported). There is no MIDI support for this card. > > > > This section is wrong: > > > The snd_emu10kx(4) driver does support the following sound cards (although >> they have names similar to some supported ones): >> Creative Sound Blaster Live! 24-Bit, identified by FreeBSD as >> Creative Sound Blaster Audigy LS / ES, identified by FreeBSD as >> All other Creative sound cards with -DAT chipsets. >> All Creative X-Fi series sound cards. > > > > None of those cards are supported by snd_emu10kx (according to the man > page, and in my own personal experience). I believe a "does support" should > read "does not support". Looks like the second one should be "does not support", yes. Thanks for spotting it; hopefully I can prod a committer into making the change. -Ben Kaduk From owner-freebsd-doc@FreeBSD.ORG Thu Jan 19 01:13:49 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 45A0F1065672 for ; Thu, 19 Jan 2012 01:13:49 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 052918FC08 for ; Thu, 19 Jan 2012 01:13:48 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q0J1DmFF042616; Wed, 18 Jan 2012 18:13:48 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q0J1DmBm042613; Wed, 18 Jan 2012 18:13:48 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Wed, 18 Jan 2012 18:13:48 -0700 (MST) From: Warren Block To: Hiroki Sato In-Reply-To: <20120119.084434.926306642968660094.hrs@allbsd.org> Message-ID: References: <20120119.084434.926306642968660094.hrs@allbsd.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Wed, 18 Jan 2012 18:13:48 -0700 (MST) Cc: freebsd-doc@FreeBSD.org Subject: Re: Tidy and HTML tab spacing X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Jan 2012 01:13:49 -0000 On Thu, 19 Jan 2012, Hiroki Sato wrote: > Warren Block wrote > in : > > wb> HTML versions of FreeBSD documents are fed through tidy (www/tidy or > wb> www/tidy-devel) for cleanup. There's a bug in tidy[1] that can cause > wb> tab stops to be wrong: > wb> http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-distfiles.html#AEN1623 > wb> > wb> Note how DISTNAME and EXTRACT_SUFX do not line up. They are correct > wb> in the source book.sgml. > wb> > wb> So what to do? > > I lean to fixing Tidy if possible. The reason why we are using Tidy > is to fix mark-ups in rendered results from various tools like Jade, > not (only) for human-readability. The results of Tidy are still not > perfect from viewpoint of standard conformance, but it is better than > nothing even if most of modern www browsers can handle the rendered > HTMLs directly. Agreed. > wb> 4. Add newlines to the HTML in the build process before it gets to > wb> tidy: > wb> s/CLASS="PROGRAMLISTING"\n>/CLASS="PROGRAMLISTING">\n/ > > I think this will break the results because a newline just after ">" > is recognized as CDATA. A test run on the Porter's Handbook did seem to work: make -C /usr/ports/www/tidy-devel deinstall make clean book.html perl -0777 -i -pe 's/CLASS="PROGRAMLISTING"\n\>/CLASS="PROGRAMLISTING"\>\n/g' book.html make -C /usr/ports/www/tidy-devel install clean tidy -wrap 90 -m -raw -preserve -f /dev/null -asxml book.html From owner-freebsd-doc@FreeBSD.ORG Thu Jan 19 06:59:31 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E7D27106564A for ; Thu, 19 Jan 2012 06:59:30 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper-int.allbsd.org [IPv6:2001:2f0:104:e002::2]) by mx1.freebsd.org (Postfix) with ESMTP id 9CBFC8FC13 for ; Thu, 19 Jan 2012 06:59:29 +0000 (UTC) Received: from alph.allbsd.org ([IPv6:2001:2f0:104:e010:862b:2bff:febc:8956]) (authenticated bits=128) by mail.allbsd.org (8.14.4/8.14.4) with ESMTP id q0J6xF2M044576; Thu, 19 Jan 2012 15:59:25 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [IPv6:::1]) (authenticated bits=0) by alph.allbsd.org (8.14.4/8.14.4) with ESMTP id q0J6xDMv070988; Thu, 19 Jan 2012 15:59:15 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Thu, 19 Jan 2012 15:57:36 +0900 (JST) Message-Id: <20120119.155736.1127622096127250170.hrs@allbsd.org> To: wblock@wonkity.com From: Hiroki Sato In-Reply-To: References: <20120119.084434.926306642968660094.hrs@allbsd.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.3.51 on Emacs 23.3 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Thu_Jan_19_15_57_36_2012_397)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.3 (mail.allbsd.org [IPv6:2001:2f0:104:e001::32]); Thu, 19 Jan 2012 15:59:27 +0900 (JST) X-Spam-Status: No, score=-104.4 required=13.0 tests=BAYES_00, CONTENT_TYPE_PRESENT, QENCPTR1, RDNS_NONE, SPF_SOFTFAIL, USER_IN_WHITELIST autolearn=no version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on gatekeeper.allbsd.org Cc: freebsd-doc@FreeBSD.org Subject: Re: Tidy and HTML tab spacing X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Jan 2012 06:59:31 -0000 ----Security_Multipart(Thu_Jan_19_15_57_36_2012_397)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Warren Block wrote in : wb> > I think this will break the results because a newline just after ">" wb> > is recognized as CDATA. wb> wb> A test run on the Porter's Handbook did seem to work: wb> make -C /usr/ports/www/tidy-devel deinstall wb> make clean book.html wb> perl -0777 -i -pe wb> 's/CLASS="PROGRAMLISTING"\n\>/CLASS="PROGRAMLISTING"\>\n/g' book.html wb> make -C /usr/ports/www/tidy-devel install clean wb> tidy -wrap 90 -m -raw -preserve -f /dev/null -asxml book.html Yes, but this just covers the issue because column calculation by Tidy is based on literals in the markup text, not on the result text. For example, in the following line >[tab]foo Tidy expands [tab] to spaces based on the length of ">[tab]foo" regardless of the fact that ">" is not a character in the result text. So, if we convert this into two line like the following: > [tab]foo the expansion of the [tab] will be correct. However, this trick does not always work as intended. One is that \n just after ">" means a newline in 
, not automatically ignored.  So, all of
  will have a empty line at the top.  Another is that
 this is valid only for a particular case.  For example:

foo[tab]bar[tab]baz
foo[tab]bar[tab]baz

 The  will be converted to  in the HTML output and two
 lines of "foo bat baz" will not be aligned because Tidy counts the
  tag for the tab expansion.  This cannot solve by converting
 "\n>" to ">\n" at the end of a 
 tag in the HTML output.

 It is difficult to solve this issue completely because the result
 text can be obtained only by a complete HTML processor such as www
 browsers.  I don't have a good idea, but I think it is not a bad idea
 to use a tab character (or replacing it to 	) in the result text
 by modifying Tidy and leave the processing to www browsers.

-- Hiroki

----Security_Multipart(Thu_Jan_19_15_57_36_2012_397)--
Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (FreeBSD)

iEYEABECAAYFAk8XvuAACgkQTyzT2CeTzy2J0ACfQwN4NMOKea1HxWqGKyG4EYzB
locAoJltXwkFC83gR0yDFqnLjp1vgW4J
=9AE5
-----END PGP SIGNATURE-----

----Security_Multipart(Thu_Jan_19_15_57_36_2012_397)----

From owner-freebsd-doc@FreeBSD.ORG  Thu Jan 19 15:07:21 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 75CDD106564A
	for ; Thu, 19 Jan 2012 15:07:21 +0000 (UTC)
	(envelope-from shirkdog_list@hotmail.com)
Received: from bay0-omc1-s3.bay0.hotmail.com (bay0-omc1-s3.bay0.hotmail.com
	[65.54.190.14]) by mx1.freebsd.org (Postfix) with ESMTP id 6137F8FC1F
	for ; Thu, 19 Jan 2012 15:07:21 +0000 (UTC)
Received: from BAY145-W27 ([65.54.190.61]) by bay0-omc1-s3.bay0.hotmail.com
	with Microsoft SMTPSVC(6.0.3790.4675); 
	Thu, 19 Jan 2012 06:54:33 -0800
Message-ID: 
X-Originating-IP: [108.15.28.185]
From: Shirk Dog 
To: 
Date: Thu, 19 Jan 2012 09:54:33 -0500
Importance: Normal
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginalArrivalTime: 19 Jan 2012 14:54:33.0773 (UTC)
	FILETIME=[417ACDD0:01CCD6BA]
Subject: Handbook - Update for 9.0 Wireless configuration with WPA2
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Thu, 19 Jan 2012 15:07:21 -0000


Section 32.3 Wireless Networking.
32.3.3.1.3.1 WPA-PSKThe first step is the configuration of the /etc/wpa_sup=
plicant.conf file with the SSID and the pre-shared key
of your network:

network=3D{
  ssid=3D"freebsdap"
  psk=3D"freebsdmall"
}
------------------------------------------


I use WPA2 with AES on my access point. In order to get my laptop to connec=
t to the access point I needed to add options for the key management to /et=
c/wpa_supplicant.conf

network=3D{
ssid=3D"freebsdap"
psk=3D"freebsdmall"
scan_ssid=3D1
key_mgmt=3DWPA-PSK
pairwise=3DCCMP TKIP
}






Shirkdog
Free your mind...
http://www.shirkdog.us 		 	   		  =

From owner-freebsd-doc@FreeBSD.ORG  Thu Jan 19 15:09:47 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 15B0F1065675;
	Thu, 19 Jan 2012 15:09:47 +0000 (UTC) (envelope-from jhb@freebsd.org)
Received: from cyrus.watson.org (cyrus.watson.org [65.122.17.42])
	by mx1.freebsd.org (Postfix) with ESMTP id DBB5B8FC1C;
	Thu, 19 Jan 2012 15:09:46 +0000 (UTC)
Received: from bigwig.baldwin.cx (bigwig.baldwin.cx [96.47.65.170])
	by cyrus.watson.org (Postfix) with ESMTPSA id 86B2C46B0D;
	Thu, 19 Jan 2012 10:09:46 -0500 (EST)
Received: from jhbbsd.localnet (unknown [209.249.190.124])
	by bigwig.baldwin.cx (Postfix) with ESMTPSA id 018A4B946;
	Thu, 19 Jan 2012 10:09:46 -0500 (EST)
From: John Baldwin 
To: freebsd-doc@freebsd.org
Date: Thu, 19 Jan 2012 10:09:44 -0500
User-Agent: KMail/1.13.5 (FreeBSD/8.2-CBSD-20110714-p10; KDE/4.5.5; amd64; ; )
References: 
	
In-Reply-To: 
MIME-Version: 1.0
Message-Id: <201201191009.45027.jhb@freebsd.org>
Content-Type: Text/Plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7
	(bigwig.baldwin.cx); Thu, 19 Jan 2012 10:09:46 -0500 (EST)
Cc: Adam Kirchhoff , simon@freebsd.org
Subject: Re: FreeBSD 9.0-RELEASE Hardware Notes is wrong.
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Thu, 19 Jan 2012 15:09:47 -0000

On Wednesday, January 18, 2012 8:01:17 pm Benjamin Kaduk wrote:
> On Wed, 18 Jan 2012, Adam Kirchhoff wrote:
> 
> > http://www.freebsd.org/releases/9.0R/hardware.html
> >
> > This section is correct:
> >
> > [i386,amd64] The snd_emu10kx(4) driver supports the following sound cards:
> >> Creative Sound Blaster Live! (EMU10K1 Chipset). Both PCM and MIDI
> >> interfaces are available.
> >> Creative Sound Blaster Audigy (CA0100 and CA0101 Chipset). PCM and two
> >> MIDI interfaces available.
> >> Creative Sound Blaster Audigy 2 and Creative Sound Blaster Audigy 4
> >> (CA0102 Chipset). PCM support is limited to 48kHz/16 bit stereo (192kHz/24
> >> bit part of this chipset is not supported).
> >> Creative Sound Blaster Audigy 2 Value (CA0108 Chipset). PCM support is
> >> limited to 48kHz/16 bit stereo (192kHz/24 bit part of this chipset is not
> >> supported). There is no MIDI support for this card.
> >
> >
> >
> > This section is wrong:
> >
> >
> > The snd_emu10kx(4) driver does support the following sound cards (although
> >> they have names similar to some supported ones):
> >> Creative Sound Blaster Live! 24-Bit, identified by FreeBSD as
> >> Creative Sound Blaster Audigy LS / ES, identified by FreeBSD as
> >> All other Creative sound cards with -DAT chipsets.
> >> All Creative X-Fi series sound cards.
> >
> >
> >
> > None of those cards are supported by snd_emu10kx (according to the man
> > page, and in my own personal experience). I believe a "does support" should
> > read "does not support".
> 
> Looks like the second one should be "does not support", yes.
> 
> Thanks for spotting it; hopefully I can prod a committer into making the 
> change.

The snd_emu10kx(4) manpage from which this is derived is correct.  This 
appears to be a problem with the code that parses the manpages to generate the 
hardware release notes.  Maybe it is confused by the markup:

The
.Nm
driver does
.Em not
support the following sound cards (although they have names
similar to some supported ones):

This change fixes it.  If simon ok's it I'll commit it.  It does result in
a new header line for malo(4) making it into the hardware notes (it may be that
the malo(4) manpage needs to format it's hardware table differently anyway).

Index: release/doc/share/misc/man2hwnotes.pl
===================================================================
--- man2hwnotes.pl	(revision 230267)
+++ man2hwnotes.pl	(working copy)
@@ -324,6 +324,11 @@ sub parse {
 	    } elsif (/^Fx/) {
 		dlog(3, "Got Fx command");
 		parabuf_addline(\%mdocvars, "FreeBSD");
+	    } elsif (/^Em (.+)$/) {
+		my ($txt, $punct_str) = split_punct_chars($1);
+
+		parabuf_addline(\%mdocvars,
+				normalize("$txt$punct_str"));
 	    } else {
 		# Ignore all other commands.
 		dlog(3, "Ignoring unknown command $cmd");

-- 
John Baldwin

From owner-freebsd-doc@FreeBSD.ORG  Thu Jan 19 15:53:35 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 8F64D1065672
	for ; Thu, 19 Jan 2012 15:53:35 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id 4B2098FC1D
	for ; Thu, 19 Jan 2012 15:53:34 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id q0JFrYld049461;
	Thu, 19 Jan 2012 08:53:34 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q0JFrYVM049458;
	Thu, 19 Jan 2012 08:53:34 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Date: Thu, 19 Jan 2012 08:53:34 -0700 (MST)
From: Warren Block 
To: Shirk Dog 
In-Reply-To: 
Message-ID: 
References: 
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Thu, 19 Jan 2012 08:53:34 -0700 (MST)
Cc: freebsd-doc@freebsd.org
Subject: Re: Handbook - Update for 9.0 Wireless configuration with WPA2
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Thu, 19 Jan 2012 15:53:35 -0000

On Thu, 19 Jan 2012, Shirk Dog wrote:

>
> Section 32.3 Wireless Networking.
> 32.3.3.1.3.1 WPA-PSKThe first step is the configuration of the /etc/wpa_supplicant.conf file with the SSID and the pre-shared key
> of your network:
>
> network={
>  ssid="freebsdap"
>  psk="freebsdmall"
> }
> ------------------------------------------
>
>
> I use WPA2 with AES on my access point. In order to get my laptop to connect to the access point I needed to add options for the key management to /etc/wpa_supplicant.conf
>
> network={
> ssid="freebsdap"
> psk="freebsdmall"
> scan_ssid=1

This should not be needed unless a "hidden" SSID is used.

From owner-freebsd-doc@FreeBSD.ORG  Thu Jan 19 16:10:32 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id CF6041065675
	for ; Thu, 19 Jan 2012 16:10:32 +0000 (UTC)
	(envelope-from shirkdog_list@hotmail.com)
Received: from bay0-omc4-s25.bay0.hotmail.com (bay0-omc4-s25.bay0.hotmail.com
	[65.54.190.227])
	by mx1.freebsd.org (Postfix) with ESMTP id B70D78FC1A
	for ; Thu, 19 Jan 2012 16:10:32 +0000 (UTC)
Received: from BAY145-W9 ([65.54.190.199]) by bay0-omc4-s25.bay0.hotmail.com
	with Microsoft SMTPSVC(6.0.3790.4675); 
	Thu, 19 Jan 2012 08:10:31 -0800
Message-ID: 
X-Originating-IP: [108.15.28.185]
From: Shirk Dog 
To: 
Date: Thu, 19 Jan 2012 11:10:31 -0500
Importance: Normal
In-Reply-To: 
References: ,
	
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-OriginalArrivalTime: 19 Jan 2012 16:10:31.0982 (UTC)
	FILETIME=[DE624CE0:01CCD6C4]
Cc: freebsd-doc@freebsd.org
Subject: RE: Handbook - Update for 9.0 Wireless configuration with WPA2
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Thu, 19 Jan 2012 16:10:32 -0000


My SSID is hidden=2C which I would hope would be more common. But it makes =
sense why this is not in the handbook.

At least the connection is rock solid in 9.0.

Thanks for the response.

Shirkdog
Free your mind...
http://www.shirkdog.us


----------------------------------------
> Date: Thu=2C 19 Jan 2012 08:53:34 -0700
> From: wblock@wonkity.com
> To: shirkdog_list@hotmail.com
> CC: freebsd-doc@freebsd.org
> Subject: Re: Handbook - Update for 9.0 Wireless configuration with WPA2
>
> On Thu=2C 19 Jan 2012=2C Shirk Dog wrote:
>
> >
> > Section 32.3 Wireless Networking.
> > 32.3.3.1.3.1 WPA-PSKThe first step is the configuration of the /etc/wpa=
_supplicant.conf file with the SSID and the pre-shared key
> > of your network:
> >
> > network=3D{
> > ssid=3D"freebsdap"
> > psk=3D"freebsdmall"
> > }
> > ------------------------------------------
> >
> >
> > I use WPA2 with AES on my access point. In order to get my laptop to co=
nnect to the access point I needed to add options for the key management to=
 /etc/wpa_supplicant.conf
> >
> > network=3D{
> > ssid=3D"freebsdap"
> > psk=3D"freebsdmall"
> > scan_ssid=3D1
>
> This should not be needed unless a "hidden" SSID is used.
 		 	   		  =

From owner-freebsd-doc@FreeBSD.ORG  Thu Jan 19 16:40:50 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 5949D106566B
	for ; Thu, 19 Jan 2012 16:40:50 +0000 (UTC)
	(envelope-from lists@eitanadler.com)
Received: from mail-lpp01m010-f54.google.com (mail-lpp01m010-f54.google.com
	[209.85.215.54])
	by mx1.freebsd.org (Postfix) with ESMTP id D14468FC1C
	for ; Thu, 19 Jan 2012 16:40:49 +0000 (UTC)
Received: by lahe6 with SMTP id e6so100826lah.13
	for ; Thu, 19 Jan 2012 08:40:48 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=eitanadler.com; s=0xdeadbeef;
	h=mime-version:in-reply-to:references:from:date:message-id:subject:to
	:cc:content-type;
	bh=Iu7HYH42H9iar0iZQIFMwLLD0Do+k97vpqYY6+9eRmQ=;
	b=s5HBXJJdmu9qHVIs5fdk3QekMfvC0s7qGbR036kzy+0ITqiCukmAEIVhfwlSvONQgg
	+EnqjliUKuHfazlfemVAfeKGuyc1pkqtsdbqBPLOkJFNw1D48VboReA3GI4JvnglvLAq
	cTrJxIeLN/MFl2bdNUy9+13nCwNbKG1MC21No=
Received: by 10.112.36.195 with SMTP id s3mr6504830lbj.72.1326989532129; Thu,
	19 Jan 2012 08:12:12 -0800 (PST)
MIME-Version: 1.0
Received: by 10.112.21.168 with HTTP; Thu, 19 Jan 2012 08:11:41 -0800 (PST)
In-Reply-To: 
References: 
	
From: Eitan Adler 
Date: Thu, 19 Jan 2012 11:11:41 -0500
Message-ID: 
To: Warren Block 
Content-Type: text/plain; charset=UTF-8
Cc: freebsd-doc@freebsd.org, Shirk Dog 
Subject: Re: Handbook - Update for 9.0 Wireless configuration with WPA2
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Thu, 19 Jan 2012 16:40:50 -0000

On Thu, Jan 19, 2012 at 10:53 AM, Warren Block  wrote:

> This should not be needed unless a "hidden" SSID is used.

Perhaps a section should be added about "hidden" SSIDs?


-- 
Eitan Adler

From owner-freebsd-doc@FreeBSD.ORG  Thu Jan 19 16:51:16 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 5AB6F1065673;
	Thu, 19 Jan 2012 16:51:16 +0000 (UTC)
	(envelope-from simon@freebsd.org)
Received: from emx.nitro.dk (emx.nitro.dk [IPv6:2a01:4f8:120:7384::102])
	by mx1.freebsd.org (Postfix) with ESMTP id D0D7A8FC0C;
	Thu, 19 Jan 2012 16:51:15 +0000 (UTC)
Received: from mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4])
	by emx.nitro.dk (Postfix) with ESMTP id 0E8C41AE1CB;
	Thu, 19 Jan 2012 16:51:15 +0000 (UTC)
Received: from emx.nitro.dk ([127.0.1.2])
	by mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4])
	(amavisd-new, port 10024)
	with LMTP id kVlkGOwweVI9; Thu, 19 Jan 2012 16:51:09 +0000 (UTC)
Received: from [192.168.4.28] (unknown [89.100.56.44])
	(using TLSv1 with cipher AES128-SHA (128/128 bits))
	(No client certificate requested)
	by emx.nitro.dk (Postfix) with ESMTPSA id 9CF3B1AE1BE;
	Thu, 19 Jan 2012 16:51:08 +0000 (UTC)
Mime-Version: 1.0 (Apple Message framework v1251.1)
Content-Type: text/plain; charset=iso-8859-1
From: "Simon L. B. Nielsen" 
In-Reply-To: <201201191009.45027.jhb@freebsd.org>
Date: Thu, 19 Jan 2012 16:51:07 +0000
Content-Transfer-Encoding: quoted-printable
Message-Id: <1287A4E8-5289-42AB-B53A-521155C1AA8B@freebsd.org>
References: 
	
	<201201191009.45027.jhb@freebsd.org>
To: John Baldwin 
X-Mailer: Apple Mail (2.1251.1)
Cc: freebsd-doc@freebsd.org, Adam Kirchhoff 
Subject: Re: FreeBSD 9.0-RELEASE Hardware Notes is wrong.
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Thu, 19 Jan 2012 16:51:16 -0000


On 19 Jan 2012, at 15:09, John Baldwin wrote:

> On Wednesday, January 18, 2012 8:01:17 pm Benjamin Kaduk wrote:
>> On Wed, 18 Jan 2012, Adam Kirchhoff wrote:
>>=20
>>> http://www.freebsd.org/releases/9.0R/hardware.html
>>>=20
>>> This section is correct:
>>>=20
>>> [i386,amd64] The snd_emu10kx(4) driver supports the following sound =
cards:
>>>> Creative Sound Blaster Live! (EMU10K1 Chipset). Both PCM and MIDI
>>>> interfaces are available.
>>>> Creative Sound Blaster Audigy (CA0100 and CA0101 Chipset). PCM and =
two
>>>> MIDI interfaces available.
>>>> Creative Sound Blaster Audigy 2 and Creative Sound Blaster Audigy 4
>>>> (CA0102 Chipset). PCM support is limited to 48kHz/16 bit stereo =
(192kHz/24
>>>> bit part of this chipset is not supported).
>>>> Creative Sound Blaster Audigy 2 Value (CA0108 Chipset). PCM support =
is
>>>> limited to 48kHz/16 bit stereo (192kHz/24 bit part of this chipset =
is not
>>>> supported). There is no MIDI support for this card.
>>>=20
>>>=20
>>>=20
>>> This section is wrong:
>>>=20
>>>=20
>>> The snd_emu10kx(4) driver does support the following sound cards =
(although
>>>> they have names similar to some supported ones):
>>>> Creative Sound Blaster Live! 24-Bit, identified by FreeBSD as
>>>> Creative Sound Blaster Audigy LS / ES, identified by FreeBSD as
>>>> All other Creative sound cards with -DAT chipsets.
>>>> All Creative X-Fi series sound cards.
>>>=20
>>>=20
>>>=20
>>> None of those cards are supported by snd_emu10kx (according to the =
man
>>> page, and in my own personal experience). I believe a "does support" =
should
>>> read "does not support".
>>=20
>> Looks like the second one should be "does not support", yes.
>>=20
>> Thanks for spotting it; hopefully I can prod a committer into making =
the=20
>> change.
>=20
> The snd_emu10kx(4) manpage from which this is derived is correct.  =
This=20
> appears to be a problem with the code that parses the manpages to =
generate the=20
> hardware release notes.  Maybe it is confused by the markup:
>=20
> The
> .Nm
> driver does
> .Em not
> support the following sound cards (although they have names
> similar to some supported ones):

The parser script basically implemented the mdoc commands which were =
needed to generate valid output at the time, so it sounds entirely =
likely that ".Em foo" just wasn't implemented.

> This change fixes it.  If simon ok's it I'll commit it.  It does =
result in
> a new header line for malo(4) making it into the hardware notes (it =
may be that
> the malo(4) manpage needs to format it's hardware table differently =
anyway).

It's been a long time since I looked at the code and I don't have time =
to do any tests right now, but the patch looks sane enough. If it =
produces the expected output the patch is fine with me.

> Index: release/doc/share/misc/man2hwnotes.pl
> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
> --- man2hwnotes.pl	(revision 230267)
> +++ man2hwnotes.pl	(working copy)
> @@ -324,6 +324,11 @@ sub parse {
> 	    } elsif (/^Fx/) {
> 		dlog(3, "Got Fx command");
> 		parabuf_addline(\%mdocvars, "FreeBSD");
> +	    } elsif (/^Em (.+)$/) {
> +		my ($txt, $punct_str) =3D split_punct_chars($1);
> +
> +		parabuf_addline(\%mdocvars,
> +				=
normalize("$txt$punct_str"));
> 	    } else {
> 		# Ignore all other commands.
> 		dlog(3, "Ignoring unknown command $cmd");

--=20
Simon L. B. Nielsen


From owner-freebsd-doc@FreeBSD.ORG  Fri Jan 20 01:02:44 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 5937C106566B
	for ; Fri, 20 Jan 2012 01:02:44 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id 170B48FC08
	for ; Fri, 20 Jan 2012 01:02:43 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id q0K12fDq054093;
	Thu, 19 Jan 2012 18:02:41 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q0K12fFO054090;
	Thu, 19 Jan 2012 18:02:41 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Date: Thu, 19 Jan 2012 18:02:41 -0700 (MST)
From: Warren Block 
To: Eitan Adler 
In-Reply-To: 
Message-ID: 
References: 
	
	
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Thu, 19 Jan 2012 18:02:41 -0700 (MST)
Cc: freebsd-doc@freebsd.org, Shirk Dog 
Subject: Re: Handbook - Update for 9.0 Wireless configuration with WPA2
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Fri, 20 Jan 2012 01:02:44 -0000

On Thu, 19 Jan 2012, Eitan Adler wrote:

> On Thu, Jan 19, 2012 at 10:53 AM, Warren Block  wrote:
>
>> This should not be needed unless a "hidden" SSID is used.
>
> Perhaps a section should be added about "hidden" SSIDs?

Maybe a warning to not use hidden SSIDs, at least until the network is 
set up and tested.

From owner-freebsd-doc@FreeBSD.ORG  Fri Jan 20 13:10:12 2012
Return-Path: 
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 62AEE1065672
	for ; Fri, 20 Jan 2012 13:10:12 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id 392248FC12
	for ; Fri, 20 Jan 2012 13:10:12 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q0KDACWu070512
	for ; Fri, 20 Jan 2012 13:10:12 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q0KDAC8F070511;
	Fri, 20 Jan 2012 13:10:12 GMT (envelope-from gnats)
Resent-Date: Fri, 20 Jan 2012 13:10:12 GMT
Resent-Message-Id: <201201201310.q0KDAC8F070511@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,
	"Rogier 'DocWilco' Mulhuijzen" 
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 5A353106566B
	for ;
	Fri, 20 Jan 2012 13:03:27 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 4361B8FC08
	for ;
	Fri, 20 Jan 2012 13:03:27 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q0KD3Oc4092855
	for ; Fri, 20 Jan 2012 13:03:24 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q0KD3OZe092849;
	Fri, 20 Jan 2012 13:03:24 GMT (envelope-from nobody)
Message-Id: <201201201303.q0KD3OZe092849@red.freebsd.org>
Date: Fri, 20 Jan 2012 13:03:24 GMT
From: "Rogier 'DocWilco' Mulhuijzen" 
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-3.1
Cc: 
Subject: docs/164334: Sections 2.13 and 2.3.7 don't use the new URL
	structure for downloads
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Fri, 20 Jan 2012 13:10:12 -0000


>Number:         164334
>Category:       docs
>Synopsis:       Sections 2.13 and 2.3.7 don't use the new URL structure for downloads
>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:   Fri Jan 20 13:10:11 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Rogier 'DocWilco' Mulhuijzen
>Release:        9.0
>Organization:
>Environment:
n/a
>Description:
The documentation lists the URLs as follows (examples):

ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/arch/ISO-IMAGES/version/FreeBSD-version-RELEASE-arch-memstick.img
ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/ISO-IMAGES/9.0/FreeBSD-9.0-RELEASE-i386-memstick.img

Which are incorrect for 9.0. The should be:

ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/arch/target/ISO-IMAGES/version/FreeBSD-version-RELEASE-arch-memstick.img
ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/i386/i386/ISO-IMAGES/9.0/FreeBSD-9.0-RELEASE-i386-memstick.img

Also, it's probably a better idea to list amd64 as example these days.
>How-To-Repeat:
Go to http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/install-pre.html#INSTALL-BOOT-MEDIA
>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted:

From owner-freebsd-doc@FreeBSD.ORG  Fri Jan 20 20:05:52 2012
Return-Path: 
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 3F742106566B;
	Fri, 20 Jan 2012 20:05:52 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id 05C208FC0C;
	Fri, 20 Jan 2012 20:05:51 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id q0KK5pq0061763;
	Fri, 20 Jan 2012 13:05:51 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q0KK5pYI061760;
	Fri, 20 Jan 2012 13:05:51 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Date: Fri, 20 Jan 2012 13:05:51 -0700 (MST)
From: Warren Block 
To: Hiroki Sato 
In-Reply-To: <20120119.155736.1127622096127250170.hrs@allbsd.org>
Message-ID: 
References: 
	<20120119.084434.926306642968660094.hrs@allbsd.org>
	
	<20120119.155736.1127622096127250170.hrs@allbsd.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: MULTIPART/MIXED;
	BOUNDARY="-902635197-1133617426-1327089951=:61386"
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Fri, 20 Jan 2012 13:05:51 -0700 (MST)
Cc: freebsd-doc@FreeBSD.org
Subject: Re: Tidy and HTML tab spacing
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Fri, 20 Jan 2012 20:05:52 -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.

---902635197-1133617426-1327089951=:61386
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII

On Thu, 19 Jan 2012, Hiroki Sato wrote:

> It is difficult to solve this issue completely because the result
> text can be obtained only by a complete HTML processor such as www
> browsers.  I don't have a good idea, but I think it is not a bad idea
> to use a tab character (or replacing it to 	) in the result text
> by modifying Tidy and leave the processing to www browsers.

The suggestion of 	 is interesting.  The problem is that tidy is 
changing tabs to spaces while still reading the file, when it really 
should be treating the tab as a special entity while processings tags.

So preprocessing still might be a way to preserve tabs.  Just convert 
them all to 	 before tidy has a chance to change them.

   perl -i -pe 's/\t/	/g' book.html

sed works also, but beware of the binary tab necessary for sed's 
paleolithic regexes:

   sed -i -e 's/	/\	/g' book.html

Initial testing shows this does seem to work.  The output has genuine
tabs which display fine in Firefox but ought to be tested in other 
browsers.  Note that there are some invisible tabs in the HTML output 
that come from the SGML source.  For example, the copyright notice in 
the Porter's Handbook:

       The FreeBSD Documentation
 	Project

That leading tab on the second line is in the HTML file.  Still, 
replacing those invisible tabs with 	 instead of spaces should 
render the same.


Finally, before picking up on the idea of tab-as-an-entity, I worked up 
a patch to www/tidy-devel which uses the magic value of --tab-size 255 
to mean "don't replace tabs".  Attached, but I think the 	 is 
better.
---902635197-1133617426-1327089951=:61386
Content-Type: TEXT/PLAIN; charset=US-ASCII; name=patch-src-streamio.c
Content-Transfer-Encoding: BASE64
Content-ID: 
Content-Description: 
Content-Disposition: attachment; filename=patch-src-streamio.c

LS0tIHNyYy9zdHJlYW1pby5jLm9yaWcJMjAwOC0wMy0yMiAxNTowMDoxOC4w
MDAwMDAwMDAgLTA2MDANCisrKyBzcmMvc3RyZWFtaW8uYwkyMDEyLTAxLTIw
IDEyOjI1OjU4LjAwMDAwMDAwMCAtMDcwMA0KQEAgLTM1MSwxMSArMzUxLDE4
IEBADQogICAgICAgICAgICAgYWRkZWQgPSB5ZXM7DQogICAgICAgICAgICAg
VFlfKEFkZENoYXJUb09yaWdpbmFsVGV4dCkoaW4sICh0Y2hhciljKTsNCiAj
ZW5kaWYNCi0gICAgICAgICAgICBpbi0+dGFicyA9IHRhYnNpemUgPiAwID8N
Ci0gICAgICAgICAgICAgICAgdGFic2l6ZSAtICgoaW4tPmN1cmNvbCAtIDEp
ICUgdGFic2l6ZSkgLSAxDQotICAgICAgICAgICAgICAgIDogMDsNCi0gICAg
ICAgICAgICBpbi0+Y3VyY29sKys7DQotICAgICAgICAgICAgYyA9ICcgJzsN
CisgICAgICAgICAgICBpZiAodGFic2l6ZSA9PSAyNTUpIHsNCisgICAgICAg
ICAgICAgICAgaW4tPmN1cmNvbCsrOw0KKyAgICAgICAgICAgICAgICBjID0g
J1x0JzsNCisgICAgICAgICAgICB9DQorICAgICAgICAgICAgZWxzZQ0KKyAg
ICAgICAgICAgIHsNCisgICAgICAgICAgICAgICAgaW4tPnRhYnMgPSB0YWJz
aXplID4gMCA/DQorICAgICAgICAgICAgICAgICAgICB0YWJzaXplIC0gKChp
bi0+Y3VyY29sIC0gMSkgJSB0YWJzaXplKSAtIDENCisgICAgICAgICAgICAg
ICAgICAgIDogMDsNCisgICAgICAgICAgICAgICAgaW4tPmN1cmNvbCsrOw0K
KyAgICAgICAgICAgICAgICBjID0gJyAnOw0KKyAgICAgICAgICAgIH0NCiAg
ICAgICAgICAgICBicmVhazsNCiAgICAgICAgIH0NCiANCg==

---902635197-1133617426-1327089951=:61386--

From owner-freebsd-doc@FreeBSD.ORG  Sat Jan 21 20:15:55 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id D90FC106564A
	for ; Sat, 21 Jan 2012 20:15:55 +0000 (UTC)
	(envelope-from freebsd-announce@chthonic.com)
Received: from www5.pairlite.com (www5.pairlite.com [64.130.10.15])
	by mx1.freebsd.org (Postfix) with ESMTP id B5EB68FC15
	for ; Sat, 21 Jan 2012 20:15:55 +0000 (UTC)
Received: from whisperer.chthonixia.net (cpe-66-65-69-148.nyc.res.rr.com
	[66.65.69.148])
	by www5.pairlite.com (Postfix) with ESMTPSA id 95B222E2D4
	for ; Sat, 21 Jan 2012 15:00:49 -0500 (EST)
Date: Sat, 21 Jan 2012 15:00:36 -0500
From: Joe Altman 
To: freebsd-doc@freebsd.org
Message-ID: <20120121200036.GA3893@whisperer.chthonixia.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.5.21 (2010-09-15)
Subject: Errors in building documentation from source
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Sat, 21 Jan 2012 20:15:55 -0000

Greetings...

I've some sort of image error in building the docs from source, and
I'm wondering if anyone here knows how to fix it.

If I run make cleandir a couple of times, there are more errors; but
I've only included two below. In order to install that part of the
docs do work, I just run make all multiple times.

*** Error code 1 (ignored)
===> articles/building-products (all)
/usr/local/bin/gs -q -dNOPAUSE -dBATCH -dSAFER -dDELAYSAFER
-sPAPERSIZE=letter
-r72 -sDEVICE=bbox  -sOutputFile=/dev/null  
/usr/doc/en_US.ISO8859-1/articles/building-products/../../../share/images/articles/building-products/freebsd-branches.ps
>
/usr/doc/en_US.ISO8859-1/articles/building-products/../../../share/images/articles/building-products/freebsd-branches.eps
2>&1
*** Error code 1

Stop in /usr/doc/en_US.ISO8859-1/articles/building-products.
*** Error code 1

Stop in /usr/doc/en_US.ISO8859-1/articles.
*** Error code 1

Stop in /usr/doc/en_US.ISO8859-1.

Followed by:

===> articles/building-products (all)
/usr/bin/perl /usr/doc/share/misc/epsgeom -offset 100 100 
/usr/doc/en_US.ISO8859-1/articles/building-products/../../../share/images/articles/building-products/freebsd-branches.eps
| /usr/local/bin/gs -q -dBATCH -dGraphicsAlphaBits=4 
-dTextAlphaBits=4  -dEPSCrop -r100x100  -dNOPAUSE -dSAFER -sDEVICE=pnm 
-sOutputFile=-  -g`/usr/bin/perl /usr/doc/share/misc/epsgeom -geom 100
100 
/usr/doc/en_US.ISO8859-1/articles/building-products/../../../share/images/articles/building-products/freebsd-branches.eps`
-  | /usr/local/bin/pnmtopng > 
/usr/doc/en_US.ISO8859-1/articles/building-products/../../../share/images/articles/building-products/freebsd-branches.png
Error: no BoundingBox found.
Error: no BoundingBox found.
pnmtopng: bad magic number - not a ppm, pgm, or pbm file
*** Error code 1

Stop in /usr/doc/en_US.ISO8859-1/articles/building-products.
*** Error code 1

Stop in /usr/doc/en_US.ISO8859-1/articles.
*** Error code 1

Stop in /usr/doc/en_US.ISO8859-1.

For both images in the
/usr/share/doc/en_US.ISO8859-1/articles/building-products/
directory, the result displayed in my browser is an image that
contains this text: 

The image
"file:///usr/share/doc/en_US.ISO8859-1/articles/building-products/freebsd-branches.png"
cannot be displayed because it contains errors.

A similar condition exists for other image directories:

file:///usr/share/doc/en_US.ISO8859-1/books/handbook/geom/striping.png

All images in:
file:///usr/share/doc/en_US.ISO8859-1/books/handbook/security/
file:///usr/share/doc/en_US.ISO8859-1/books/handbook/vinum/
file:///usr/share/doc/en_US.ISO8859-1/articles/releng/

Thanks for any help, and best regards,

Joe

From owner-freebsd-doc@FreeBSD.ORG  Sat Jan 21 23:32:49 2012
Return-Path: 
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id AF1B5106564A
	for ; Sat, 21 Jan 2012 23:32:49 +0000 (UTC)
	(envelope-from gabor@FreeBSD.org)
Received: from server.mypc.hu (server.mypc.hu [87.229.73.95])
	by mx1.freebsd.org (Postfix) with ESMTP id 33BDA8FC14
	for ; Sat, 21 Jan 2012 23:32:48 +0000 (UTC)
Received: from server.mypc.hu (localhost [127.0.0.1])
	by server.mypc.hu (Postfix) with ESMTP id D1F9B14E6B1E;
	Sun, 22 Jan 2012 00:17:02 +0100 (CET)
X-Virus-Scanned: amavisd-new at server.mypc.hu
Received: from server.mypc.hu ([127.0.0.1])
	by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024)
	with LMTP id GZtSBD1EbrJk; Sun, 22 Jan 2012 00:17:00 +0100 (CET)
Received: from [192.168.1.117] (catv-80-98-232-12.catv.broadband.hu
	[80.98.232.12])
	(using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits))
	(No client certificate requested)
	by server.mypc.hu (Postfix) with ESMTPSA id BB4AC14E6A5A;
	Sun, 22 Jan 2012 00:17:00 +0100 (CET)
Message-ID: <4F1B4767.5070105@FreeBSD.org>
Date: Sun, 22 Jan 2012 00:16:55 +0100
From: Gabor Kovesdan 
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
	rv:10.0a2) Gecko/20111124 Thunderbird/10.0a2
MIME-Version: 1.0
To: Warren Block 
References: 
	
In-Reply-To: 
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Cc: freebsd-doc@freebsd.org
Subject: Re: Tidy and HTML tab spacing
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project 
List-Unsubscribe: ,
	
List-Archive: 
List-Post: 
List-Help: 
List-Subscribe: ,
	
X-List-Received-Date: Sat, 21 Jan 2012 23:32:49 -0000

On 2012.01.18. 23:49, Warren Block wrote:
> 5. Don't tidy HTML files at all (suggested as an option by Benedict
>    Reuschling).  The unprocessed HTML is ugly, but few people are going
>    to look at it directly.  Files that haven't been through tidy are a
>    little larger, about 4% in the case of the Porter's Handbook. 
I also think tidy should be removed. As hrs wrote, new standards should 
be evaluated and probably they are much better. (I think they are.) If 
there are some nits, then we should process it with a custom script or 
something, instead of this crapware.

Gabor