From owner-freebsd-doc@FreeBSD.ORG Sun Dec 12 07:57:06 2010 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 CDB7B106566B for ; Sun, 12 Dec 2010 07:57:06 +0000 (UTC) (envelope-from jau@oxit.fi) Received: from smtp.oxit.fi (smtp.oxit.fi [193.185.41.132]) by mx1.freebsd.org (Postfix) with ESMTP id 80E398FC0A for ; Sun, 12 Dec 2010 07:57:06 +0000 (UTC) Received: from [109.240.241.209] ([::ffff:109.240.241.209]) (AUTH: LOGIN jau) by smtp.oxit.fi with esmtp; Sun, 12 Dec 2010 09:46:58 +0200 id 00620004.4D047DF2.00003B9A From: Jukka Ukkonen To: freebsd-doc@FreeBSD.org X-Mailer: Modest 3.2 Date: Sun, 12 Dec 2010 09:47:13 +0200 Message-Id: <1292140033.3377.8.camel@Nokia-N900> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: Proposal for new manual pages X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Jukka Ukkonen List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 12 Dec 2010 07:57:06 -0000 Because FreeBSD web already hosts manual pages for multiple other UNIX style OS flavours it might be a nice idea to add manuals for UWin (AT&T) and Cygwin as well. Just my 0,02 EUR worth. Cheers, --jau From owner-freebsd-doc@FreeBSD.ORG Sun Dec 12 14:45:11 2010 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 BB7841065670; Sun, 12 Dec 2010 14:45:10 +0000 (UTC) (envelope-from ryusuke@FreeBSD.org) Received: from castle.jp.FreeBSD.org (castle.jp.FreeBSD.org [IPv6:2001:218:422:1::15]) by mx1.freebsd.org (Postfix) with ESMTP id 021918FC13; Sun, 12 Dec 2010 14:45:09 +0000 (UTC) Received: from localhost (localhost [::1]) by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet6 id oBCEj3s82063; Sun, 12 Dec 2010 23:45:05 +0900 (JST) (envelope-from ryusuke@FreeBSD.org) Date: Sun, 12 Dec 2010 23:44:57 +0900 (JST) Message-Id: <20101212.234457.193766695.ryusuke@jp.FreeBSD.org> To: linimon@lonesome.com, freebsd-doc@FreeBSD.org From: Ryusuke SUZUKI In-Reply-To: <20101209143300.GA28241@lonesome.com> References: <20101209.223154.193764232.ryusuke@jp.FreeBSD.org> <20101209143300.GA28241@lonesome.com> X-Mailer: Mew version 6.1 on Emacs 22.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Sun_Dec_12_23_44_57_2010_097)--" Content-Transfer-Encoding: 7bit Cc: ryusuke@FreeBSD.org Subject: Re: newbies page (ppp) 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, 12 Dec 2010 14:45:11 -0000 ----Security_Multipart(Sun_Dec_12_23_44_57_2010_097)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi, ryusuke> "The first thing many people need to set up is ppp,..." ryusuke> ryusuke> Do you agree? mcl> To me, that sounds like that page is many years stale. Yes. I am afraid so, too. BTW,.. When I translate the FreeBSD document, I find the outdated sentence occasionally. In most case, I leave it as it is. Let me give two example. o http://www.freebsd.org/applications.html (About Applications for FreeBSD) > Net surfing. A real UNIX workstation makes a great Internet surfboard. > FreeBSD versions of Firefox and Opera are available for serious web users. > Surf the web, publish your own web pages, read Usenet news, and send and > receive email with a FreeBSD system on your desktop. The word "Net surfing" is still cool? In Japan, this is an obsolete word. I used "web browsing" for Japansese translation, o http://www.freebsd.org/java/howhelp.html (FreeBSD Java, how to help page) This page is terribly oudated. I am afraid that this page does not have enough information to help people to help Java. Translation of this page is finished, but I hesitate to commit... I do not plan to modify these. I will be happy if someone fix. Ryusuke ----Security_Multipart(Sun_Dec_12_23_44_57_2010_097)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (FreeBSD) iEYEABECAAYFAk0E3+kACgkQG5rRvmPSlyQQ7ACcDmGBO+MAYdqzjCX6CB10nwnq vZIAoLrhCBLt/Jaw7myfgBpoC1LuQd8t =B3kt -----END PGP SIGNATURE----- ----Security_Multipart(Sun_Dec_12_23_44_57_2010_097)---- From owner-freebsd-doc@FreeBSD.ORG Mon Dec 13 11:06:16 2010 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 B5427106564A for ; Mon, 13 Dec 2010 11:06:16 +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 9906A8FC18 for ; Mon, 13 Dec 2010 11:06:16 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id oBDB6GrU044109 for ; Mon, 13 Dec 2010 11:06:16 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id oBDB6EJl044096 for freebsd-doc@FreeBSD.org; Mon, 13 Dec 2010 11:06:14 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 13 Dec 2010 11:06:14 GMT Message-Id: <201012131106.oBDB6EJl044096@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, 13 Dec 2010 11:06:16 -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/152852 doc [patch] add link to WantedPorts to handbook o docs/152103 doc man ipnat is out-dated o docs/151952 doc No example for scanning for SSIDs in ifconfig(8) man p o docs/151752 doc pw.conf(5) doesn't define format for file clearly o docs/151478 doc [patch] Russian porters-handbook: MFen 1.440 -> 1.1077 o docs/151367 doc [patch] Update for puc.4 man page o docs/151104 doc mksnap_ffs(8) should mention 20 snapshot limit on UFS 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/150736 doc [handbook] ipfw docs: rule number is optional, not man o docs/150365 doc [make.conf] [patch] remove BDECFLAGS from make.conf(5) o docs/150255 doc dtrace description should mention makeoptions DEBUG=-g o docs/150244 doc [patch] DRIVER_MODULE(9): MULTI_DRIVER_MODULE is only o docs/150219 doc zfs(8) manual page misses jail/unjail o docs/150124 doc Request for update of "building the kernel" section of o docs/149950 doc [patch] glob(3)'s reference to regex(3) is spelled inc o docs/149845 doc unify spelling of blocksize, block-size and block size o docs/149574 doc [patch] update mi_switch(9) man page o docs/149522 doc Russian network article: incorrect translation about n o docs/149106 doc xfs.5: non-working mount example 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/148680 doc [sysctl][patch] Document some sys/kern sysctls o docs/148071 doc Failover mode between wired and wireless interfaces o docs/148037 doc bge(4) does not list all devices in if_bge.c / if_bger 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/146047 doc [kld] [patch] the kldstat(2) manual needs to be more p 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/145067 doc Remove all reference to floppy installs o docs/145066 doc Update for new uart dev names for serial port. o docs/144818 doc all mailinglist archives dated 19970101 contain traili o docs/144630 doc [patch] domainname(1) manpage contains old information o docs/144543 doc [handbook] IPFW doc change o docs/144537 doc Missing _mdconfig_list and _mdconfig2_list explanation o docs/144515 doc [handbook] Expand handbook Table of contents o docs/144488 doc share/examples/etc/make.conf: contains dangerous examp o docs/144408 doc [patch] update makefs(8) (remove device option) o docs/143850 doc procfs(5) manpage for status > controlling terminal is o docs/143472 doc gethostname(3) references undefined value: HOST_NAME_M o docs/143416 doc [handbook] IPFW handbook page issues o docs/143408 doc man filedesc(9) is missing o docs/142917 doc top(1) man page does not include information about VCS o docs/142437 doc [request] Errata Notices Index missing a docs/142341 doc jail(8): Jail escape when cwd is moved from the host s 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 o docs/140495 doc [patch] /etc/rc.conf.d is not documented in rc.conf(5) o docs/140457 doc [patch] Grammar fix for isspace(3) o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140435 doc ls(1), section STANDARD: the -A is exception from POSI o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/140369 doc [patch] src/contrib/pf/man/pf.4 o docs/140075 doc release notes: missing word "NOT", which changes all t 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/138887 doc manpage ports(7) incorrect 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 bin/137156 doc [patch] fix dump(8) cryptic output on reporting progre 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 p docs/136029 doc MALLOC_PRODUCTION knob should be mentioned somewhere, 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/134222 doc installation failure of japanese docs 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/132113 doc [handbook] Update handbook jails creation o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131684 doc [patch] articles/linux-comparison: replace Addenda by o docs/131626 doc [patch] dump(8) "recommended" cache option confusing o docs/131625 doc [patch] Typos in ed(1) man page o docs/130364 doc Man page for top needs explanation of CPU states 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 o docs/125751 doc man 3 pthread_getschedparam section ERRORS incomplete 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 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/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/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/117747 doc 'break' system call needs a man page o docs/116116 doc mktemp (3) re/move note o docs/116080 doc PREFIX is documented, but not the more important LOCAL 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/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/101464 doc sync ru_RU.KOI8-R/articles/portbuild/article.html with 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/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/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 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 191 problems total. From owner-freebsd-doc@FreeBSD.ORG Thu Dec 16 01:40:08 2010 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 A93F9106566C for ; Thu, 16 Dec 2010 01:40: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 587C28FC0C for ; Thu, 16 Dec 2010 01:40:08 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id oBG1e8uY076513 for ; Thu, 16 Dec 2010 01:40:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id oBG1e8ui076512; Thu, 16 Dec 2010 01:40:08 GMT (envelope-from gnats) Resent-Date: Thu, 16 Dec 2010 01:40:08 GMT Resent-Message-Id: <201012160140.oBG1e8ui076512@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, Jason Helfman Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A69241065670 for ; Thu, 16 Dec 2010 01:37:12 +0000 (UTC) (envelope-from jhelfman@experts-exchange.com) Received: from mail.experts-exchange.com (mail.experts-exchange.com [72.29.183.251]) by mx1.freebsd.org (Postfix) with ESMTP id 851358FC16 for ; Thu, 16 Dec 2010 01:37:12 +0000 (UTC) Received: from mail.experts-exchange.com (localhost [127.0.0.1]) by mail.experts-exchange.com (Postfix) with ESMTP id 299CE9C56E3 for ; Wed, 15 Dec 2010 17:37:12 -0800 (PST) Received: from mail.experts-exchange.com ([127.0.0.1]) by mail.experts-exchange.com (mail.experts-exchange.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 4oun9Dnr7+cO for ; Wed, 15 Dec 2010 17:37:12 -0800 (PST) Received: from experts-exchange.com (unknown [192.168.103.122]) by mail.experts-exchange.com (Postfix) with SMTP id D4B5B9C56E9 for ; Wed, 15 Dec 2010 17:37:11 -0800 (PST) Received: (nullmailer pid 97586 invoked by uid 1001); Thu, 16 Dec 2010 01:34:09 -0000 Message-Id: <1292463249.590630.97585.nullmailer@experts-exchange.com> Date: Wed, 15 Dec 2010 17:34:09 -0800 From: Jason Helfman To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/153196: [patch] porters-handbook: port comments are cut after 60 characters, book indicates 70 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Jason Helfman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Dec 2010 01:40:08 -0000 >Number: 153196 >Category: docs >Synopsis: [patch] porters-handbook: port comments are cut after 60 characters, book indicates 70 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Dec 16 01:40:08 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Jason Helfman >Release: FreeBSD 8.1-RELEASE i386 >Organization: Experts Exchange, LLC. >Environment: System: FreeBSD eggman.experts-exchange.com 8.1-RELEASE FreeBSD 8.1-RELEASE #0: Mon Jul 19 02:55:53 UTC 2010 root@almeida.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386 >Description: Porters Handbook indicates that keeping COMMENT line to 70 characters or less is recommended. I found that the limit is 60 to display on command line. Test port: PORTNAME= test PORTVERSION= 1 COMMENT= Samba provides seamless file and print services to SMB/CIFS clients. CATEGORIES= www MASTER_SITES= # empty DISTFILES= # empty NO_BUILD= yes NO_WRKSUBDIR= yes do-install: ${DO_NADA} .include pkg_info |grep test test-1 Samba provides seamless file and print services to SMB/CIFS $ echo "Samba provides seamless file and print services to SMB/CIFS" |wc 1 9 60 $ echo "Samba provides seamless file and print services to SMB/CIFS clients." |wc 1 10 69 >How-To-Repeat: Use test port from above, run pkg_info and grep for port. Do word count on COMMENT from pkg_info display. >Fix: --- porters-handbook/book.sgml.orig 2010-12-15 17:22:25.000000000 -0800 +++ porters-handbook/book.sgml 2010-12-15 17:22:57.000000000 -0800 @@ -3188,7 +3188,7 @@ The COMMENT variable should immediately follow the MAINTAINER variable in the Makefile. - Please try to keep the COMMENT line less than 70 + Please try to keep the COMMENT line less than 60 characters, as it is displayed to users as a one-line summary of the port. >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Fri Dec 17 13:04:57 2010 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 99E551065679; Fri, 17 Dec 2010 13:04:57 +0000 (UTC) (envelope-from jkois@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 6F7BE8FC1A; Fri, 17 Dec 2010 13:04:57 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id oBHD4vYl008122; Fri, 17 Dec 2010 13:04:57 GMT (envelope-from jkois@freefall.freebsd.org) Received: (from jkois@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id oBHD4vxL008118; Fri, 17 Dec 2010 13:04:57 GMT (envelope-from jkois) Date: Fri, 17 Dec 2010 13:04:57 GMT Message-Id: <201012171304.oBHD4vxL008118@freefall.freebsd.org> To: jkois@FreeBSD.org, freebsd-doc@FreeBSD.org, jkois@FreeBSD.org From: jkois@FreeBSD.org Cc: Subject: Re: docs/153196: [patch] porters-handbook: port comments are cut after 60 characters, book indicates 70 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, 17 Dec 2010 13:04:57 -0000 Synopsis: [patch] porters-handbook: port comments are cut after 60 characters, book indicates 70 Responsible-Changed-From-To: freebsd-doc->jkois Responsible-Changed-By: jkois Responsible-Changed-When: Fri Dec 17 13:04:31 UTC 2010 Responsible-Changed-Why: Take. http://www.freebsd.org/cgi/query-pr.cgi?pr=153196 From owner-freebsd-doc@FreeBSD.ORG Sat Dec 18 15:10:10 2010 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 A3432106566C for ; Sat, 18 Dec 2010 15:10: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 784378FC16 for ; Sat, 18 Dec 2010 15:10:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id oBIFAA52012936 for ; Sat, 18 Dec 2010 15:10:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id oBIFAAb9012935; Sat, 18 Dec 2010 15:10:10 GMT (envelope-from gnats) Resent-Date: Sat, 18 Dec 2010 15:10:10 GMT Resent-Message-Id: <201012181510.oBIFAAb9012935@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, Aldis Berjoza Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 68FBC1065673 for ; Sat, 18 Dec 2010 15:04:36 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (unknown [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 3DA2A8FC15 for ; Sat, 18 Dec 2010 15:04:36 +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 oBIF4ZW1015002 for ; Sat, 18 Dec 2010 15:04:35 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id oBIF4ZQs015001; Sat, 18 Dec 2010 15:04:35 GMT (envelope-from nobody) Message-Id: <201012181504.oBIF4ZQs015001@red.freebsd.org> Date: Sat, 18 Dec 2010 15:04:35 GMT From: Aldis Berjoza To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/153269: Handbook refers to vinum(8) instead of vinum(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: Sat, 18 Dec 2010 15:10:10 -0000 >Number: 153269 >Category: docs >Synopsis: Handbook refers to vinum(8) instead of vinum(4) >Confidential: no >Severity: non-critical >Priority: high >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Dec 18 15:10:10 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Aldis Berjoza >Release: >Organization: >Environment: >Description: In section 18.4.1.1.1 "Installing the Hardware" at the end of section handbook refers to vinum(8), which is not available As I understand it should refer to vinum(4) >How-To-Repeat: >Fix: Fix link and s/vinum\(8\)/vinum(4)/ >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sat Dec 18 16:30:12 2010 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 3E50C1065675 for ; Sat, 18 Dec 2010 16:30: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 44F818FC16 for ; Sat, 18 Dec 2010 16:30:10 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id oBIGUAUW097188 for ; Sat, 18 Dec 2010 16:30:10 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id oBIGUAIb097186; Sat, 18 Dec 2010 16:30:10 GMT (envelope-from gnats) Resent-Date: Sat, 18 Dec 2010 16:30:10 GMT Resent-Message-Id: <201012181630.oBIGUAIb097186@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, Aldis Berjoza Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 009261065670 for ; Sat, 18 Dec 2010 16:26:43 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (unknown [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id E36698FC08 for ; Sat, 18 Dec 2010 16:26:42 +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 oBIGQgJC083655 for ; Sat, 18 Dec 2010 16:26:42 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id oBIGQgag083654; Sat, 18 Dec 2010 16:26:42 GMT (envelope-from nobody) Message-Id: <201012181626.oBIGQgag083654@red.freebsd.org> Date: Sat, 18 Dec 2010 16:26:42 GMT From: Aldis Berjoza To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/153273: [HANDBOOK] 21.7.1 needs improvement 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, 18 Dec 2010 16:30:12 -0000 >Number: 153273 >Category: docs >Synopsis: [HANDBOOK] 21.7.1 needs improvement >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Dec 18 16:30:09 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Aldis Berjoza >Release: >Organization: >Environment: >Description: Quote: Normally, newfs(8) interprets the name of the disk and complains if it cannot understand it. For example: # newfs /dev/gvinum/concat newfs: /dev/gvinum/concat: can't figure out file system partition In order to create a file system on this volume, use newfs(8): # newfs /dev/gvinum/concat It doesn't make much sense. bough commands are same.... I think the Normally, newfs(8) interprets the name of the disk and complains if it cannot understand it. For example: # newfs /dev/gvinum/concat newfs: /dev/gvinum/concat: can't figure out file system partition part should be removed >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: