From owner-freebsd-doc@FreeBSD.ORG Sun Dec 28 09:10:05 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1E73B106564A for ; Sun, 28 Dec 2008 09:10:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 0D78B8FC12 for ; Sun, 28 Dec 2008 09:10:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBS9A4Ej088812 for ; Sun, 28 Dec 2008 09:10:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBS9A4ij088808; Sun, 28 Dec 2008 09:10:04 GMT (envelope-from gnats) Date: Sun, 28 Dec 2008 09:10:04 GMT Message-Id: <200812280910.mBS9A4ij088808@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Federico Galvez-Durand Besnard Cc: Subject: Re: docs/122052: minor update on handbook section 20.7.1 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Federico Galvez-Durand Besnard List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 28 Dec 2008 09:10:05 -0000 The following reply was made to PR docs/122052; it has been noted by GNATS. From: Federico Galvez-Durand Besnard To: bug-followup@FreeBSD.org Cc: trhodes@FreeBSD.org Subject: Re: docs/122052: minor update on handbook section 20.7.1 Date: Sun, 28 Dec 2008 09:41:46 +0100 Hi Tom, Greg Lehey work writing VINUM is outstanding. However, the manual does not match the quality of the source code. Some highlights: 1) The definition of RAID-10 given in 21.6.4 is wrong. It actually describes RAID-01. I added RAID-10, for the sake of completeness. http://en.wikipedia.org/wiki/Nested_RAID_levels 2) VINUM was originally written for Release 4.x, the manual needed updates to accommodate most recent Releases and GEOM framework. Same stands for man pages. This patch separates clearly 4.x from > 5.x. Also, all misleading embedded-guidances have been treated. 3) This patch improves the whole section text and figures. 4) Examples have been also improved. Configuration files and output are shown. I will appreciate any feedback if there is a committer, familiar with VINUM, available for reading (and compare to the actual version) the proposed update (shown in this link for the sake of simplicity and for few fellows who requested it): http://www.del.ufrj.br/~federico.besnard/FreeBSD/apocrypha/handbook/vinum-vinum.html I will work on the SGML version only if this patch makes sense to someone with power for committing the patch. I have seen recent developers' activity on the GEOM side, it might be the case of not having a need for VINUM any longer. So this work on the handbook is not only low priority but useless. I am not sure, I am not writing code for GEOM nor tracking all activity there. Please advise. From owner-freebsd-doc@FreeBSD.ORG Sun Dec 28 15:46:01 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 047B01065673; Sun, 28 Dec 2008 15:46:01 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.188]) by mx1.freebsd.org (Postfix) with ESMTP id 354578FC08; Sun, 28 Dec 2008 15:46:00 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by nf-out-0910.google.com with SMTP id h3so864112nfh.33 for ; Sun, 28 Dec 2008 07:45:59 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:sender:message-id:date:from :organization:user-agent:mime-version:to:cc:subject:references :in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; bh=abHxzm7n3+grg4SEYhsBIWxtQDknFSFkFvDinALg3xU=; b=cIuwlzm+3aZbvcC4PAiJX88AwTgAjfrrO2xgysZaBnrLHFE6RHWzl8sfAjXEg2YJlU +O4LQy+yaEoA8/k6vvfaq1sGAPr+7xEYIuXqCU2IS1YCP+I7WDYv1zi3HYmZCXfg8PK8 cFOCihAL9/VHGZhrIsfALwo39i1XuRM0kHGkc= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=sender:message-id:date:from:organization:user-agent:mime-version:to :cc:subject:references:in-reply-to:x-enigmail-version:content-type :content-transfer-encoding; b=CbRTIqVC/Vv/LLhEYtKXWn+ceO1yfbAohoYKuLSjbGS8sLwqoG+NoYEYZ3aNQiy4no Qzk3VyJr2MU14xnVDBUlytEBNWZq6w/OOwqUZFgvjD2q3WonW1LUt5KGbHpacmcZfITc CuCCxcvWysYnZYW1NXxEPMxxK+Ra/DTAs0lNI= Received: by 10.210.16.10 with SMTP id 10mr11258023ebp.196.1230479158879; Sun, 28 Dec 2008 07:45:58 -0800 (PST) Received: from self.rene-ladan.nl ([77.163.174.49]) by mx.google.com with ESMTPS id k9sm41978423nfh.17.2008.12.28.07.45.57 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sun, 28 Dec 2008 07:45:57 -0800 (PST) Sender: Rene Ladan Message-ID: <49579F33.6020600@freebsd.org> Date: Sun, 28 Dec 2008 16:45:55 +0100 From: Rene Ladan Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.18 (X11/20081123) MIME-Version: 1.0 To: Gabor PALI References: <4956903C.5060405@FreeBSD.org> <87sko9wda1.fsf@kobe.laptop> <495696F1.7080207@freebsd.org> <87d4fdpb46.fsf@kobe.laptop> <87prjdl1zm.fsf@kobe.laptop> <4956AF88.2030502@FreeBSD.org> In-Reply-To: <4956AF88.2030502@FreeBSD.org> X-Enigmail-Version: 0.95.6 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Rene Ladan , freebsd-doc@freebsd.org Subject: Re: [RFC] A Handbook Section on Updating the Documentation Set 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, 28 Dec 2008 15:46:01 -0000 Gabor PALI schreef: > Giorgos Keramidas wrote: >>> On Sat, 27 Dec 2008 21:58:25 +0100, Rene Ladan wrote: >>>> Indeed, but my tag changes seem to be lost. Maybe I am too picky :) > > Reasons are explained below: > > - Some text have changed in the patch and got fixed meanwhile. > > >> It is a >> good idea to avoid using a specific CVSup server in the docs, because >> users will tend to copy/paste the name of the server and won't >> necessarily bother picking the right one for their setup. On the other >> hand, having examples that one can copy and paste is nice too; it avoids >> the need for a lengthy explanation of what cvsup"N"."country" means, and >> we have servers that don't match the country-based pattern. > > - I assumed that readers are able to replace cvsup with csup and pick a > server for themselves, so there is no more explanation needed. > Makes sense. > >> If we change to a template name, then we should update the >> text before the commands too, and we should add a link to the Handbook >> section that lists the CVSup servers. A pointer to: >> >> the list of CVSup mirrors >> >> should suffice for that. > > Yep, we can add it. > > >> - &prompt.root; rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc >> + &prompt.root; rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc >> >> This one is ok. We don't have many docsnap servers, so is >> probably fine here. If we start mirroring docsnap files in multiple >> places, and there are several to choose, we may have to revert to the >> element, but for now is fine :) > > I marked up the hostname and the target directory with > because they could be changed by the user. Of course, there is only one > Docsnap server at the moment; I simply tried to follow the markup > traditions (see FDP Primer, 4.2.5.12 [1]). If we want to make it > non-replaceable (as no more Docsnap servers), then I suggest to omit > and elements (see FDP Primer, 4.2.4.8 [1]). > Ok, predefined hostnames are fine with me as long as there is one. Please commit ;) Rene -- http://www.rene-ladan.nl/ GPG fingerprint = ADBC ECCD EB5F A6B4 549F 600D 8C9E 647A E564 2BFC (subkeys.pgp.net) From owner-freebsd-doc@FreeBSD.ORG Mon Dec 29 11:06:07 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B0C111065670 for ; Mon, 29 Dec 2008 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 9600E8FC1F for ; Mon, 29 Dec 2008 11:06:07 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBTB675m023428 for ; Mon, 29 Dec 2008 11:06:07 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBTB678I023424 for freebsd-doc@FreeBSD.org; Mon, 29 Dec 2008 11:06:07 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 29 Dec 2008 11:06:07 GMT Message-Id: <200812291106.mBTB678I023424@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, 29 Dec 2008 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/129962 doc [newusb] usbconfig(8) refers to non-existant usb2_core p docs/129853 doc mistype in manual page nscd.conf(5) o docs/129671 doc New TCP chapter for Developer's Handbook (from rwatson o docs/129464 doc using packages system o docs/129428 doc ntp.conf(5) is incorrect - you can only use IP address o docs/129400 doc [patch] Remove comments that have snook into three man o docs/129196 doc Inconsistent errno in strtol() o docs/129095 doc ipfw(8): Can not check that packet originating/destine o docs/129024 doc [patch] ipfw(8) improvements p docs/128968 doc [patch] rwlock(9) man page typo o docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages o docs/128222 doc [patch] man page truss(1) claims that init(8) can be t o docs/127908 doc [PATCH] readdir(3) error documentation o docs/127890 doc socket(2) man page should explain that protocol can be p docs/127866 doc Typos found in ifconfig(8) man page s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/127575 doc [patch] Update to ports (7) as it is missing a few mak o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126487 doc fix language on atol(3) manpage o docs/126484 doc libc function res-zonscut2 is not documented o docs/126445 doc discussion on WEP settings in wpa_supplicant.conf(5) m o docs/126227 doc [patch] kthread(9) refers to non-existent manpage, des o docs/125921 doc lpd(8) talks about blocks in minfree while it is KB in o docs/125751 doc man 3 pthread_getschedparam section ERRORS incomplete p docs/124166 doc fortune: instant-workstation tip should go o docs/123035 doc [patch] bugs in refuse.README o docs/122053 doc [patch] update on vinum(4) reference to newfs(8) 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/121871 doc ftpd does not interpret configuration files as documen o docs/121585 doc [handbook] Wrong multicast specification o docs/121565 doc dhcp-options(5) manpage incorrectly formatted omitting s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121197 doc [patch] edits to books/porters-handbook o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120539 doc Inconsistent ipfw's man page o docs/120456 doc ath(4) needs to specify requirement on wlan_scan_sta o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119907 doc Ports compatibility o docs/119746 doc l10n chapter of handbook (Russian Language) o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting a docs/119536 doc a few typos in French handbook (basics) o docs/119329 doc [patch] Fix misleading man 1 split o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/118545 doc loader tunables kern.dfldsiz and friends nearly undocu o docs/118332 doc man page for top does not describe STATE column wait e o docs/118214 doc close(2) error returns incomplete o docs/118020 doc ipfilter(4): man pages query for man 4 ipfilter return o docs/117798 doc formatting oddity in sysmouse(4) o docs/117747 doc 'break' system call needs a man page o docs/117013 doc mount_smbfs(8) doesn't document -U (username) argument o docs/116480 doc sysctl(3) description of kern.file no longer applies s o docs/116116 doc mktemp (3) re/move note o docs/116080 doc PREFIX is documented, but not the more important LOCAL o docs/115921 doc Booting from pst(4) is not supported o docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114184 doc [patch] [ndis]: add info to man 4 ndis o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/112804 doc groff(1) command should be called to explicitly use "p o docs/112682 doc Handbook GEOM_GPT explanation does not provide accurat o docs/112481 doc bug in ppp.linkup example o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/111147 doc hostapd.conf is not documented o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110253 doc [patch] rtprio(1): remove processing starvation commen o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit o docs/110061 doc [PATCH] tuning(7) missing reference to vfs.read_max o docs/109983 doc No manual entry for protoize o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/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/108101 doc /boot/default/loader.conf contains an incorrect commen o docs/106135 doc [request] articles/vinum needs to be updated o docs/105997 doc sys/kern/sys_pipe.c refer to tuning(7), but there is n o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/104403 doc man security should mention that the usage of the X Wi o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/101464 doc sync ru_RU.KOI8-R/articles/portbuild/article.html with o docs/100242 doc sysctl(3) description of KERN_PROC is not correct anym o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98759 doc [patch] sbp_targ(4) man page missing reference to devi o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91174 doc [REQUEST] Handbook: Addition of Oracle 9i installation o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/86342 doc bikeshed entry of Handbook is wrong o docs/85187 doc [patch] find(1) manpage missing block info for -ls o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/85118 doc [PATCH] opiekey(1) references non-existing opiegen(1) o docs/85100 doc NOTES: ICH audio device support statement is ambiguous o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84806 doc mdoc(7) manpage has section ordering problems o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84538 doc [patch] sk(4) driver supports Marvell 88E800x chip too o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84268 doc chmod(1) manpage's BUGS entry is either wrong or too c o docs/84265 doc [patch] chmod(1) manpage omits implication of setting f docs/82595 doc 25.5.3 Configuring a bridge section of the handbook ne o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/78138 doc [patch] Error in pre-installation section of installat o docs/76333 doc [patch] ferror(3): EOF indicator can be cleared by not o docs/70652 doc [patch] New man page: portindex(5) o docs/63570 doc [patch] Language cleanup for the Handbook's DNS sectio o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour o docs/57388 doc [patch] INSTALL.TXT enhancement: mention ok prompt s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/50211 doc [PATCH] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] add documentation on the fixit disk to the FAQ o docs/47818 doc [patch] ln(1) manpage is confusing o docs/43823 doc [PATCH] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples o docs/36449 doc symlink(7) manual doesn't mention trailing slash, etc. s docs/35678 doc docproj Makefiles for web are broken for paths with sp s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. a docs/30008 doc [patch] French softupdates document should be translat o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 151 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Dec 29 22:40:02 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 728071065673 for ; Mon, 29 Dec 2008 22:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 4D5A38FC14 for ; Mon, 29 Dec 2008 22:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBTMe2tP019075 for ; Mon, 29 Dec 2008 22:40:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBTMe2sr019074; Mon, 29 Dec 2008 22:40:02 GMT (envelope-from gnats) Resent-Date: Mon, 29 Dec 2008 22:40:02 GMT Resent-Message-Id: <200812292240.mBTMe2sr019074@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, Gavin Atkinson Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B87A71065678 for ; Mon, 29 Dec 2008 22:30:14 +0000 (UTC) (envelope-from gavin@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id A54408FC08 for ; Mon, 29 Dec 2008 22:30:14 +0000 (UTC) (envelope-from gavin@FreeBSD.org) Received: from freefall.freebsd.org (gavin@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBTMUEo0012017 for ; Mon, 29 Dec 2008 22:30:14 GMT (envelope-from gavin@freefall.freebsd.org) Received: (from gavin@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBTMUEx2012008; Mon, 29 Dec 2008 22:30:14 GMT (envelope-from gavin) Message-Id: <200812292230.mBTMUEx2012008@freefall.freebsd.org> Date: Mon, 29 Dec 2008 22:30:14 GMT From: Gavin Atkinson To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/130039: [patch] Add extra detail to the problem-reports article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Gavin Atkinson List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 Dec 2008 22:40:02 -0000 >Number: 130039 >Category: docs >Synopsis: [patch] Add extra detail to the problem-reports article >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Dec 29 22:40:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Gavin Atkinson >Release: FreeBSD 7.1-PRERELEASE i386 >Organization: FreeBSD >Environment: System: FreeBSD freefall.freebsd.org 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #36: Mon Dec 29 15:15:30 UTC 2008 simon@freefall.freebsd.org:/usr/src/sys/i386/compile/FREEFALL i386 >Description: Add some extra details to the problem-reports article. Note that there is a single "whitespace" fix (moving a tag) in the patch as I've touched the line immediately preceding it. Patch is also at http://people.freebsd.org/~gavin/my-prs/pr-article.diff >How-To-Repeat: N/A >Fix: --- pr-article.diff begins here --- Index: doc/en_US.ISO8859-1/articles/problem-reports/article.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/articles/problem-reports/article.sgml,v retrieving revision 1.60 diff -u -r1.60 article.sgml --- doc/en_US.ISO8859-1/articles/problem-reports/article.sgml 13 Jul 2008 14:37:24 -0000 1.60 +++ doc/en_US.ISO8859-1/articles/problem-reports/article.sgml 26 Dec 2008 19:55:17 -0000 @@ -390,6 +390,17 @@ + If the problem can be reproduced easily, include + information that will help a developer to reproduce it + themselves. If a problem can be demonstrated with + specific input then include an example of that input if + possible, and include both the actual and the expected + output. If this data is large or cannot be made public, + then do try to create a minimal file that exibits the + same issue and that can be included within the PR. + + + If this is a kernel problem, then be prepared to supply the following information. (You do not have to include these by default, which only tends to @@ -408,7 +419,14 @@ sense of that option - a backtrace, if one was generated + the full text of any backtrace, panic or other console + output, or entries in /var/log/messages, + if any were generated + + + the output of pciconf -l and + relevant parts of your dmesg output if + your problem relates to a specific piece of hardware the fact that you have read @@ -471,7 +489,17 @@ minute or two to use the web-based search engine at . (Of course, everyone is guilty of forgetting to do this - now and then.) + now and then.) + + + + Report only one issue per Problem + Report. Avoid including two or more problems + within the same report unless they are related. When + submitting patches, avoid adding multiple features or + fixing multiple bugs in the same PR unless they are closely + related—such PRs often take longer to resolve. + Avoid controversial requests. --- pr-article.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue Dec 30 08:25:05 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 711E1106566B; Tue, 30 Dec 2008 08:25:05 +0000 (UTC) (envelope-from remko@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 471B48FC08; Tue, 30 Dec 2008 08:25:05 +0000 (UTC) (envelope-from remko@FreeBSD.org) Received: from freefall.freebsd.org (remko@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBU8P5hf098077; Tue, 30 Dec 2008 08:25:05 GMT (envelope-from remko@freefall.freebsd.org) Received: (from remko@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBU8P5r3098073; Tue, 30 Dec 2008 08:25:05 GMT (envelope-from remko) Date: Tue, 30 Dec 2008 08:25:05 GMT Message-Id: <200812300825.mBU8P5r3098073@freefall.freebsd.org> To: gavin@freebsd.org, remko@FreeBSD.org, freebsd-doc@FreeBSD.org From: remko@FreeBSD.org Cc: Subject: Re: docs/130039: [patch] Add extra detail to the problem-reports article 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, 30 Dec 2008 08:25:05 -0000 Synopsis: [patch] Add extra detail to the problem-reports article State-Changed-From-To: open->closed State-Changed-By: remko State-Changed-When: Tue Dec 30 08:25:04 UTC 2008 State-Changed-Why: Committed. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=130039 From owner-freebsd-doc@FreeBSD.ORG Tue Dec 30 08:30:03 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D4E561065674 for ; Tue, 30 Dec 2008 08:30:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id C38A98FC12 for ; Tue, 30 Dec 2008 08:30:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBU8U3lJ098474 for ; Tue, 30 Dec 2008 08:30:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBU8U3TJ098471; Tue, 30 Dec 2008 08:30:03 GMT (envelope-from gnats) Date: Tue, 30 Dec 2008 08:30:03 GMT Message-Id: <200812300830.mBU8U3TJ098471@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: dfilter@FreeBSD.ORG (dfilter service) Cc: Subject: Re: docs/130039: 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: Tue, 30 Dec 2008 08:30:04 -0000 The following reply was made to PR docs/130039; it has been noted by GNATS. From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/130039: commit references a PR Date: Tue, 30 Dec 2008 08:25:09 +0000 (UTC) remko 2008-12-30 08:24:55 UTC FreeBSD doc repository Modified files: en_US.ISO8859-1/articles/problem-reports article.sgml Log: Add some extra details to the article. One whitespace move, because area was touched by submitter. PR: 130039 Submitted by: gavin Revision Changes Path 1.61 +30 -2 doc/en_US.ISO8859-1/articles/problem-reports/article.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 Tue Dec 30 11:09:27 2008 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DB29E106566B for ; Tue, 30 Dec 2008 11:09:27 +0000 (UTC) (envelope-from root@www2-r.join4free.com) Received: from www2-r.join4free.com (www2-r.join4free.com [64.154.5.22]) by mx1.freebsd.org (Postfix) with SMTP id BB4648FC13 for ; Tue, 30 Dec 2008 11:09:27 +0000 (UTC) (envelope-from root@www2-r.join4free.com) Received: (qmail 7177 invoked by uid 99); 30 Dec 2008 10:42:46 -0000 Date: 30 Dec 2008 10:42:46 -0000 Message-ID: <20081230104246.7176.qmail@www2-r.join4free.com> To: doc@FreeBSD.org MIME-Version: 1.0 From: AnalTube 4Free Content-Type: text/plain; charset="ISO-8859-1" Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: Welcome to AnalTube 4Free 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, 30 Dec 2008 11:09:28 -0000 Activate Your Membership Confirmation and Information Now with this link. Thank you for requesting to become a member to the Join4Free network. AnalTube 4Free Members receive the following benefits: a. Unlimited Access to Join4Free Websites. b. Exclusive Join4Free Email Network subscription:      J4F Daily - daily links to the best new content & exclusive promotions. c. Exclusive Smerby.com Email Network subscription (J4F Non-Adult Division):      Smerby.com - promotions for non-adult traditional services and products. All emails sent to you by us are secure with our system and are used strictly through our exclusive network of promotional offers. Our company will never rent or sell your information to third party agencies. To confirm and activate your membership, please click the link below so that we can verify this is your correct e-mail address: Use this link to Confirm Your Membership Information. Below is your info: Username: doc@FreeBSD.org Password: 595959 IP Address*: 89.25.125.157 Date: 2008-12-30 [*This IP address has been recorded for security purposes. Fraudulent Actions are not tolerated, and will be prosecuted to the fullest extent of the law.] IMPORTANT: Enter your username exactly as it appears above, it should be your complete email address. You are receiving this because your email address was entered into the above site. If your email address was submitted by someone else, you may use this link to place your address on our blocked list. This will guarantee you never receive another confirmation email from us. From owner-freebsd-doc@FreeBSD.ORG Tue Dec 30 12:59:05 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E553F106564A for ; Tue, 30 Dec 2008 12:59:05 +0000 (UTC) (envelope-from returned@legalauthority.com) Received: from rackforce1.dedicatedemailsrvr.com (rackforce1.dedicatedemailsrvr.com [69.10.143.162]) by mx1.freebsd.org (Postfix) with ESMTP id BFB138FC1B for ; Tue, 30 Dec 2008 12:59:05 +0000 (UTC) (envelope-from returned@legalauthority.com) Received: by rackforce1.dedicatedemailsrvr.com (Postfix, from userid 600) id 91B731FC47F; Tue, 30 Dec 2008 07:22:52 -0800 (PST) X-DomainKeys: Sendmail DomainKeys Filter v0.6.0 rackforce1.dedicatedemailsrvr.com 91B731FC47F DomainKey-Signature: a=rsa-sha1; s=customer; d=legalauthority.com; c=nofws; q=dns; b=Bwu4//r/cVcMl3dXn8wigu1bMu9yRdmejGLpz34PYy8jphcvCi8nvZfLPXlROrhGQ wOMIqzl83eejX6zoDMI6V20VFG91Vi8w08v/lbGT5fNrnPlPJk6SacFAr7ahv29 To: doc@freebsd.org X-Mailer: LegalAuthority.com X-Mailer-Draft-ID: 300134 From: Dean Jones X-Virtual-Info: ZG9jQGZyZWVic2Qub3JnLUwyMTE2Mzg5LUQzMDAxMzQtQzMtREFURTIwMDgtMTItMzAgMDc6MjI6NTI= Content-Transfer-Encoding: quoted-printable Message-Id: <20081230152252.91B731FC47F@rackforce1.dedicatedemailsrvr.com> Date: Tue, 30 Dec 2008 07:22:52 -0800 (PST) MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: Legal Authority Can Help You Conduct Your Legal Job Search Efficiently 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, 30 Dec 2008 12:59:06 -0000 3D"" ____________________ [1]3D"Le= 1-800-283-3860 * [2]Home * [3]Targeted Mailing * [4]What = We Do * [5]The Pr= ocess * [6]Proven Results * [7]Pricin= g 3D"" , Did you know that about 85% of all open legal positions are simply n= ot published anywhere - not on employers' websites and not in classified ad= s? Even recruiters wouldn't know about these positions. To get to these unlisted jobs, you need to use one of the best legal job-se= arch tools in the world: [8]Legal = Authority. Here's how it works: * At [9]Legal Authority, you consult with your personal Employment Advocate, an attorney who = knows this business inside and out. Your advocate will help you focus your= job search: you choose the city you wish to work in, your practice area, a= nd any other preferences you have. * Next, the advocate will search our database of more than 750,000 conta= cts to narrow it down to a list of firms that appeal to you. You can spend= days looking up law firms in your city and writing to each and every one o= f them on your own. Or, you can call [10]<= strong>Legal Authority and watch them do it in five minutes. * From there, Legal Authority's professional resume writers will craft a= n expert resume and cover letter for you. They address these letters (and = the printed envelopes) to actual hiring directors, not "To Whom It May Conc= ern." * They custom print all your resumes, letters, and envelopes and send th= em to you. All you do is sign each one and drop it in the mail. =20 Using any other resource, you'd still be stuck at the beginning, looking at= a limited scope of published job opportunities. When you use [11]Legal Authority, you'll be ap= plying to every relevant organization, and your job search will be as thoro= ugh, professional, and focused as possible. No other method can compare with Legal Authority's proven effectiveness. <= a href=3D"http://www.legalauthority.com/tmlandingpage.php?e=3Dgro.dsbeer f~c= od&cid=3D11456&lpgid=3D38&wsid=3D3&ces=3D2116389&email=3Ddoc@freebsd.o rg&co= mpid=3D3&tp=3DE" target=3D"_blank">Go to Legal Authority today or call us at 800-283-3860 to learn more about how to improve your= job search and finally get the results you deserve. 3D"Sig= Sincerely, Dean Jones Customer Service Manager PS: Guide your legal job search and point your way to career success= through Legal Authority. [12]Get= started now! PPS: [13]Click here to compare Legal Authority benefits wit= h other job sites. 3D"" [14][www.legala=] =20 3D"" 3D"" Dean Jones Customer Service Manager Tel: 1-800-283-3860 Fax: 1-213-895-7306 This email message is confidential, intende= d only for the named recipient(s) above, and may contain information that i= s privileged, attorney work product, or exempt from disclosure under applic= able law. If you have received this message in error, or are not the named = recipient(s), please immediately notify the sender at 1-800-283-3860 and de= lete this email message from your computer. Thank you. 3D"" 3D"" 3D"" 3D"" *Legal Authority is America's largest and most = popular job search service for attorneys and law students and its ads may b= e seen nationally in every major legal publication including American Lawye= r, The National Law Journal, *The National Jurist, *L Magazine, *JD Jungle,= JD Journal, Corporate Counsel Magazine, California Lawyer, Lawyers Weekly = USA, Massachusetts Lawyers Weekly, Detroit Legal News, Michigan Lawyers Wee= kly, Missouri Lawyers Weekly, North Carolina Lawyers Weekly, Rhode Island L= awyers Weekly, South Carolina Lawyers Weekly, Virginia Lawyers Weekly, Atla= ntic Coast In-House, Midwest In-House, New England In-House, Los Angeles Da= ily Journal, San Francisco Daily Journal, The San Francisco Recorder, The W= ashington Legal Times, The Orange County Register, The Miami Business Journ= al, The Colorado Lawyer, Fultyn County Daily Report (Atlanta), The Chicago = Daily Law Bulletin, The New York Law Journal, Texas Lawyer. 3D"" 3D"" 3D"" 3D"" © 2008 Legal Authority. All r= ights reserved. Office: 175 South Lake Avenue, Suite 200, Pasadena, CA 9110= 1 If you no longer wish to receive this mail in future : [15]Unsubscribe here References Visible links 1. 3D"http://www.legalauthority.com/" 2. 3D"http://www.legalauthority.com/" 3. 3D"http://www.legalauthority.com/targeted-mailing.php" 4. 3D"http://www.legalauthority.com/whatwedo.php" 5. 3D"http://www.legalauthority.com/process.php" 6. 3D"http://www.legalauthority.com/proven-results.php" 7. 3D"http://www.legalauthority.com/pricing.php" 8. 3D"http://www.legalauthority.com/tmlanding= 9. 3D"http://www.legalauthority.com/tmlandingpage.php?e=3Dgro.= 10. 3D"http://www.legalauthority.=/ 11. file://localhost/tmp/3D"h= 12. 3D"http://www.legalauthority.com/tmlandi= 13. 3D"http://www.legalauthority.com/pdf/la-comparechart.pdf" 14. 3D'http://www.legalauthority.com/tmlandingpage.php?e=3Dgro.dsbeerf= 15. file://localhost/tmp/3D"http= Hidden links: 16. 3D"http://www.legalauthority.com/tmlandingpage.php?e=3Dgro.d= From owner-freebsd-doc@FreeBSD.ORG Tue Dec 30 14:25:18 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A6D78106567B for ; Tue, 30 Dec 2008 14:25:18 +0000 (UTC) (envelope-from giuseppe.bonfa@gmail.com) Received: from mail-bw0-f33.google.com (mail-bw0-f33.google.com [209.85.218.33]) by mx1.freebsd.org (Postfix) with ESMTP id 2D9A08FC1D for ; Tue, 30 Dec 2008 14:25:17 +0000 (UTC) (envelope-from giuseppe.bonfa@gmail.com) Received: by bwz14 with SMTP id 14so4262844bwz.19 for ; Tue, 30 Dec 2008 06:25:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:subject:x-enigmail-version:content-type :content-transfer-encoding; bh=47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=; b=ZaA/IdT/ZfqmaSUbjBgiYGBJS7N/SvC7IcagyjDJvlcL3M4kK9dcz/kQliipGkWU/K WG+Y4VCVwGXhF/cycWoGsa/e6d4aidnDK1Z4C3EjjtW7G4qZ+x3FR8nUJ+01UdgD/WS3 4TQ33Gnif3O2RFJ8Ugko23Gfolovjyxz0Mkqw= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:subject :x-enigmail-version:content-type:content-transfer-encoding; b=r2FwfKEe+46Mman8SFVoXZ5AwIIZGsbWPvSrRyAD9KKdRtfD2C721rcSRl2f6LZ7KD Kc5P3lvO6rSf1UeuaYwTpJN98rxWqAOfrNNsgYdA5n44HWZ62iT48dqnoZKOlo5nRs9S VRRh1FaztJVCmOc1k5rNi9BQMNcZdD3YpPzTQ= Received: by 10.86.100.19 with SMTP id x19mr8768253fgb.18.1230646305159; Tue, 30 Dec 2008 06:11:45 -0800 (PST) Received: from ?44.134.103.3? (host99-51-dynamic.27-79-r.retail.telecomitalia.it [79.27.51.99]) by mx.google.com with ESMTPS id d4sm7553454fga.11.2008.12.30.06.11.43 (version=TLSv1/SSLv3 cipher=RC4-MD5); Tue, 30 Dec 2008 06:11:44 -0800 (PST) Message-ID: <495A2C1A.9010606@gmail.com> Date: Tue, 30 Dec 2008 15:11:38 +0100 From: GiuseppeBonfa User-Agent: Thunderbird 2.0.0.16 (X11/20080724) MIME-Version: 1.0 To: freebsd-doc@FreeBSD.org X-Enigmail-Version: 0.95.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: Subject: Subscription 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, 30 Dec 2008 14:25:19 -0000 From owner-freebsd-doc@FreeBSD.ORG Wed Dec 31 11:40:01 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id AEF061065675 for ; Wed, 31 Dec 2008 11:40:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 7BDBD8FC0C for ; Wed, 31 Dec 2008 11:40:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBVBe1EU035466 for ; Wed, 31 Dec 2008 11:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBVBe1cn035465; Wed, 31 Dec 2008 11:40:01 GMT (envelope-from gnats) Resent-Date: Wed, 31 Dec 2008 11:40:01 GMT Resent-Message-Id: <200812311140.mBVBe1cn035465@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, Gavin Atkinson Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BFEE51065670 for ; Wed, 31 Dec 2008 11:39:46 +0000 (UTC) (envelope-from ga9@buffy.york.ac.uk) Received: from mail-gw1.york.ac.uk (mail-gw1.york.ac.uk [144.32.128.246]) by mx1.freebsd.org (Postfix) with ESMTP id 6E0A78FC13 for ; Wed, 31 Dec 2008 11:39:45 +0000 (UTC) (envelope-from ga9@buffy.york.ac.uk) Received: from mail-gw7.york.ac.uk (mail-gw7.york.ac.uk [144.32.129.30]) by mail-gw1.york.ac.uk (8.13.6/8.13.6) with ESMTP id mBVBde3l021735 for ; Wed, 31 Dec 2008 11:39:40 GMT Received: from buffy-128.york.ac.uk ([144.32.128.160] helo=buffy.york.ac.uk) by mail-gw7.york.ac.uk with esmtps (TLSv1:AES256-SHA:256) (Exim 4.68) (envelope-from ) id 1LHzQK-0003S8-Pg for FreeBSD-gnats-submit@freebsd.org; Wed, 31 Dec 2008 11:39:40 +0000 Received: from buffy.york.ac.uk (localhost [127.0.0.1]) by buffy.york.ac.uk (8.14.2/8.14.2) with ESMTP id mBVBdebh024044 for ; Wed, 31 Dec 2008 11:39:40 GMT (envelope-from ga9@buffy.york.ac.uk) Received: (from ga9@localhost) by buffy.york.ac.uk (8.14.2/8.14.2/Submit) id mBVBdeS5024043; Wed, 31 Dec 2008 11:39:40 GMT (envelope-from ga9) Message-Id: <200812311139.mBVBdeS5024043@buffy.york.ac.uk> Date: Wed, 31 Dec 2008 11:39:40 GMT From: Gavin Atkinson To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/130075: [patch] Changes to handbook syslogd section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Gavin Atkinson List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 31 Dec 2008 11:40:01 -0000 >Number: 130075 >Category: docs >Synopsis: [patch] Changes to handbook syslogd section >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Dec 31 11:40:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Gavin Atkinson >Release: FreeBSD 7.0-STABLE amd64 >Organization: >Environment: System: FreeBSD buffy.york.ac.uk 7.0-STABLE FreeBSD 7.0-STABLE #3: Fri Jun 20 09:21:51 UTC 2008 root@buffy.york.ac.uk:/usr/obj/usr/src/sys/GENERIC amd64 >Description: I've made a few changes to the new syslogd chapter. Firstly, there is some confusion in the current article between the client and server sections - there is talk about how to configure the server in the client section. This also contains incorrect info - the rc.conf settings in the client section, for example, are really the ones that should be used on the server. Also, where info is relevant to both the server and client configuration, I've moved the details into the server section as it comes first. As it was, various details were only explained the second time they came up. Lastly, I've just clarified a couple of bits, and added further info. >How-To-Repeat: N/A >Fix: --- handbook-syslog.diff begins here --- Index: doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml =================================================================== RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml,v retrieving revision 1.113 diff -u -r1.113 chapter.sgml --- doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml 26 Dec 2008 03:19:02 -0000 1.113 +++ doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml 30 Dec 2008 14:37:15 -0000 @@ -5040,6 +5040,26 @@ be logged to the file specified previously, /var/log/logclient.log. + The server machine must also have the following listing + placed inside /etc/rc.conf: + + syslogd_enable="YES" +syslogd_flags="-a logclient.example.com -vv" + + The first option will enable the syslogd + daemon on boot up, and the second option allows data from the + specified client to be accepted on this server. The latter + part, using , will increase the verbosity + of logged messages. This is extremely useful for tweaking + facilities as administrators are able to see what type of + messages are being logged under which facility. + + Multiple options may be specified to + allow logging from multiple clients. IP + addresses and whole netblocks may also be specified, see the + &man.syslog.3; manual page for a full list of possible + options. + Finally, the log file should be created. The method used does not matter, but &man.touch.1; works great for situations such as this: @@ -5066,7 +5086,7 @@ to a logging server in addition to keeping local copies. Similar to log servers, clients must also meet a few minimum - requirements. + requirements: @@ -5088,20 +5108,18 @@ Client configuration is a bit more relaxed when compared - to that of the servers. The client machine must also have the + to that of the servers. The client machine must have the following listing placed inside /etc/rc.conf: syslogd_enable="YES" -syslogd_flags="-a logclient.example.com -vv" +syslogd_flags="-s -vv" - The first option will enable the syslogd - daemon on boot up, and the second line allows data from the - client to be accepted on this server. The latter part, using - , will increase the verbosity of logged - messages. This is extremely useful for tweaking facilities as - administrators are able to see what type of messages are being - logged under which facility. + As before, these entries will enable the + syslogd daemon on boot up, and increases + the verbosity of logged messages. The + option prevents logs from being accepted by this client from + other hosts. Facilities describe the system part for which a message is generated. For an example, ftp and @@ -5128,14 +5146,15 @@ &prompt.root; /etc/rc.d/syslogd restart To test that log messages are being sent across the network, - use &man.logger.1; to send a message to + use &man.logger.1; on the client to send a message to syslogd: &prompt.root; logger "Test message from logclient" - This message should now exist in - /var/log/messages on both the client - and the server. + This message should now exist both in + /var/log/messages on the client, and + /var/log/logclient.log on the + log server. --- handbook-syslog.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Wed Dec 31 11:53:05 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 090101065670; Wed, 31 Dec 2008 11:53:05 +0000 (UTC) (envelope-from remko@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id D20CC8FC1F; Wed, 31 Dec 2008 11:53:04 +0000 (UTC) (envelope-from remko@FreeBSD.org) Received: from freefall.freebsd.org (remko@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBVBr408049279; Wed, 31 Dec 2008 11:53:04 GMT (envelope-from remko@freefall.freebsd.org) Received: (from remko@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBVBr47p049275; Wed, 31 Dec 2008 11:53:04 GMT (envelope-from remko) Date: Wed, 31 Dec 2008 11:53:04 GMT Message-Id: <200812311153.mBVBr47p049275@freefall.freebsd.org> To: gavin@freebsd.org, remko@FreeBSD.org, freebsd-doc@FreeBSD.org From: remko@FreeBSD.org Cc: Subject: Re: docs/130075: [patch] Changes to handbook syslogd section 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, 31 Dec 2008 11:53:05 -0000 Synopsis: [patch] Changes to handbook syslogd section State-Changed-From-To: open->closed State-Changed-By: remko State-Changed-When: Wed Dec 31 11:53:04 UTC 2008 State-Changed-Why: Committed. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=130075 From owner-freebsd-doc@FreeBSD.ORG Wed Dec 31 12:00:05 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 41D6C106567E for ; Wed, 31 Dec 2008 12:00:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1FF828FC1A for ; Wed, 31 Dec 2008 12:00:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBVC05sp049410 for ; Wed, 31 Dec 2008 12:00:05 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBVC04eb049408; Wed, 31 Dec 2008 12:00:04 GMT (envelope-from gnats) Date: Wed, 31 Dec 2008 12:00:04 GMT Message-Id: <200812311200.mBVC04eb049408@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: dfilter@FreeBSD.ORG (dfilter service) Cc: Subject: Re: docs/130075: 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, 31 Dec 2008 12:00:08 -0000 The following reply was made to PR docs/130075; it has been noted by GNATS. From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/130075: commit references a PR Date: Wed, 31 Dec 2008 11:52:41 +0000 (UTC) remko 2008-12-31 11:52:26 UTC FreeBSD doc repository Modified files: en_US.ISO8859-1/books/handbook/network-servers chapter.sgml Log: Import a few changes to the new syslogd chapter which clarifies some confusion. PR: 130075 Submitted by: Gavin Revision Changes Path 1.115 +33 -14 doc/en_US.ISO8859-1/books/handbook/network-servers/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 Dec 31 14:49:16 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 83578106566C; Wed, 31 Dec 2008 14:49:16 +0000 (UTC) (envelope-from brucec@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 588B58FC35; Wed, 31 Dec 2008 14:49:16 +0000 (UTC) (envelope-from brucec@FreeBSD.org) Received: from freefall.freebsd.org (brucec@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBVEnGqp081840; Wed, 31 Dec 2008 14:49:16 GMT (envelope-from brucec@freefall.freebsd.org) Received: (from brucec@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBVEnGVl081836; Wed, 31 Dec 2008 14:49:16 GMT (envelope-from brucec) Date: Wed, 31 Dec 2008 14:49:16 GMT Message-Id: <200812311449.mBVEnGVl081836@freefall.freebsd.org> To: brucec@FreeBSD.org, freebsd-doc@FreeBSD.org, freebsd-usb@FreeBSD.org From: brucec@FreeBSD.org Cc: Subject: Re: docs/129962: [newusb] usbconfig(8) refers to non-existant usb2_core(4) 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, 31 Dec 2008 14:49:17 -0000 Synopsis: [newusb] usbconfig(8) refers to non-existant usb2_core(4) Responsible-Changed-From-To: freebsd-doc->freebsd-usb Responsible-Changed-By: brucec Responsible-Changed-When: Wed Dec 31 14:48:47 UTC 2008 Responsible-Changed-Why: reassign http://www.freebsd.org/cgi/query-pr.cgi?pr=129962 From owner-freebsd-doc@FreeBSD.ORG Wed Dec 31 22:27:16 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DAF89106566C for ; Wed, 31 Dec 2008 22:27:16 +0000 (UTC) (envelope-from murray@stokely.org) Received: from rv-out-0506.google.com (rv-out-0506.google.com [209.85.198.227]) by mx1.freebsd.org (Postfix) with ESMTP id BC3A38FC19 for ; Wed, 31 Dec 2008 22:27:16 +0000 (UTC) (envelope-from murray@stokely.org) Received: by rv-out-0506.google.com with SMTP id b25so7093999rvf.43 for ; Wed, 31 Dec 2008 14:27:15 -0800 (PST) Received: by 10.141.27.16 with SMTP id e16mr8004649rvj.219.1230762435376; Wed, 31 Dec 2008 14:27:15 -0800 (PST) Received: by 10.141.151.6 with HTTP; Wed, 31 Dec 2008 14:27:15 -0800 (PST) Message-ID: <2a7894eb0812311427q7125e48dr8d4c2b5c5abee2b2@mail.gmail.com> Date: Wed, 31 Dec 2008 14:27:15 -0800 From: "Murray Stokely" To: "FreeBSD doc list" MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline Subject: Volunteers Needed to add Subtitles to Conference Videos 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, 31 Dec 2008 22:27:17 -0000 We now have over 23 videos uploaded to the BSD Conferences video channel from MeetBSD, NYCBSDCon, and other BSD conferences. I'd really like to add subtitles to the YouTube metadata as this has been requested by several users. Once we have subtitles they will be autotmatically machine translated so that users can choose captions in the language they are most comfortable with. There are a variety of tools you can use to record a transcription of the video. One that I tried recently was the webservice Overstream : http://www.overstream.net You simply give it the URL for the YouTube video as it is playing and it lets you add caption overlays and modify the timings to sync it up properly. The end result should be a text file with caption and timings which we can then upload to different video services to provide the captioning on demand. If you have any experience with this, or if you'd like to try to caption one of the videos, please let me know. Thanks and happy new year! - Murray From owner-freebsd-doc@FreeBSD.ORG Wed Dec 31 22:32:58 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DE9B0106564A for ; Wed, 31 Dec 2008 22:32:58 +0000 (UTC) (envelope-from murray@stokely.org) Received: from rv-out-0506.google.com (rv-out-0506.google.com [209.85.198.228]) by mx1.freebsd.org (Postfix) with ESMTP id BEC5F8FC18 for ; Wed, 31 Dec 2008 22:32:58 +0000 (UTC) (envelope-from murray@stokely.org) Received: by rv-out-0506.google.com with SMTP id b25so7095328rvf.43 for ; Wed, 31 Dec 2008 14:32:57 -0800 (PST) Received: by 10.141.194.21 with SMTP id w21mr5567513rvp.230.1230762777243; Wed, 31 Dec 2008 14:32:57 -0800 (PST) Received: by 10.141.151.6 with HTTP; Wed, 31 Dec 2008 14:32:56 -0800 (PST) Message-ID: <2a7894eb0812311432o4ac4ac88g49fd59ab63ea2457@mail.gmail.com> Date: Wed, 31 Dec 2008 14:32:56 -0800 From: "Murray Stokely" To: "FreeBSD doc list" In-Reply-To: <2a7894eb0812311427q7125e48dr8d4c2b5c5abee2b2@mail.gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <2a7894eb0812311427q7125e48dr8d4c2b5c5abee2b2@mail.gmail.com> Subject: Re: Volunteers Needed to add Subtitles to Conference Videos 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, 31 Dec 2008 22:32:59 -0000 I forgot to include two additional help topics / videos that provide more background about adding subtitles : http://help.youtube.com/support/youtube/bin/answer.py?answer=100079 http://help.youtube.com/support/youtube/bin/answer.py?answer=100077&cbid=-187pqdnf2wsk7&src=cb&lev=answer There are standard formats for these things so the subtitles could be used by other video hosting services as well. - Murray On Wed, Dec 31, 2008 at 2:27 PM, Murray Stokely wrote: > We now have over 23 videos uploaded to the BSD Conferences video > channel from MeetBSD, NYCBSDCon, and other BSD conferences. > > I'd really like to add subtitles to the YouTube metadata as this has > been requested by several users. Once we have subtitles they will be > autotmatically machine translated so that users can choose captions in > the language they are most comfortable with. > > There are a variety of tools you can use to record a transcription of > the video. One that I tried recently was the webservice Overstream : > > http://www.overstream.net > > You simply give it the URL for the YouTube video as it is playing and > it lets you add caption overlays and modify the timings to sync it up > properly. > > The end result should be a text file with caption and timings which we > can then upload to different video services to provide the captioning > on demand. > > If you have any experience with this, or if you'd like to try to > caption one of the videos, please let me know. Thanks and happy new > year! > > - Murray >