From owner-freebsd-doc@FreeBSD.ORG Sun Jan 19 23:28:01 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id E95C7FB8 for ; Sun, 19 Jan 2014 23:28:01 +0000 (UTC) Received: from nm29-vm8.bullet.mail.ir2.yahoo.com (nm29-vm8.bullet.mail.ir2.yahoo.com [212.82.97.77]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 46266165E for ; Sun, 19 Jan 2014 23:28:00 +0000 (UTC) Received: from [212.82.98.63] by nm29.bullet.mail.ir2.yahoo.com with NNFMP; 19 Jan 2014 23:25:50 -0000 Received: from [46.228.39.84] by tm16.bullet.mail.ir2.yahoo.com with NNFMP; 19 Jan 2014 23:25:50 -0000 Received: from [127.0.0.1] by smtp121.mail.ir2.yahoo.com with NNFMP; 19 Jan 2014 23:25:50 -0000 X-Yahoo-Newman-Id: 206039.71958.bm@smtp121.mail.ir2.yahoo.com X-Yahoo-Newman-Property: ymail-3 X-YMail-OSG: IFgbgEMVM1kbx0t8aQ1fnJqHtYkwdfmHdbkcrZqss1MRUyH M09DOb7fo.1SmmOfZsj88lxXa7WXz2sDikVNRydeu7Df.w7Yu0aRIUMR2_n9 HgipzDsuoCkPGz4IyPvv2RgkctuXJEWv.w1quQPVjxUq3a.n_uvmqrqUf8Hd nEm.8b1ePJ9l2avdRRLJtuJFpuiw_WWyir36J6tW_zr4.P4QbQKzZKey3Hat NdDLWhB51WzR0xO0osxE7FAxIJYi0zLoHlv1Mw5YKB2gqWLWRDHZ8Y8DOBJB 1mzKcqujEE_hvDY7B94g4Und7TCuhese4qHVcGEiuvVWsCtRKBSIFRmAeErn TIna.eQBynMzQvqbVPMMgxptNnF.tzMZD3r1zAQ66LvLo.516w01jFliIIjg Nm64Nwfe3ueyqOTX2Fe_N0_QsFWxN4OnYENU8T9KVcqY6UM8zkCkfjNbV832 iFNYqgzoD.1hNn6izENExX8tLs9s82JyVKtncjYwdx4WrXNxC6Mp0OK4uRhD FEAcshFm35glRndCzigKTBrtzNiWq9thrjEzNm1qzrcI- X-Yahoo-SMTP: .0XlE6SswBDYfMbmQW9mSFhBHRmAtZT_Gj4SWrHcfl8Br8.EIgh8JvKM8dLj X-Rocket-Received: from [192.168.0.106] (cpioli.rory@109.227.97.26 with plain [188.125.69.59]) by smtp121.mail.ir2.yahoo.com with SMTP; 19 Jan 2014 23:25:50 +0000 UTC Message-Id: From: Elizabeth V To: doc@freebsd.org Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Subject: Beverly Date: Mon, 20 Jan 2014 04:25:49 +0500 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 19 Jan 2014 23:28:02 -0000 OzzyRebdowt, are you near Beverly ? From owner-freebsd-doc@FreeBSD.ORG Mon Jan 20 11:06:04 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 7708D823 for ; Mon, 20 Jan 2014 11:06:04 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 6143D1CEB for ; Mon, 20 Jan 2014 11:06:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0KB64Ff087461 for ; Mon, 20 Jan 2014 11:06:04 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0KB64Zx087459 for freebsd-doc@FreeBSD.org; Mon, 20 Jan 2014 11:06:04 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 20 Jan 2014 11:06:04 GMT Message-Id: <201401201106.s0KB64Zx087459@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 Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Jan 2014 11:06:04 -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/185764 doc mention of libiconv in FreeBSD 10.0 release note o docs/185602 doc Possible scsi(4) typo o docs/185531 doc etherswitchcfg(8) refers to etherswitch(4) which does o docs/185481 doc sh/bash Parameter Expansion +/- syntax not documented o docs/185422 doc [handbook] brazilian portuguese translation to "Append o docs/185421 doc [handbook] brazilian portuguese translation to "Append o docs/185392 doc [handbook] brazilian portuguese translation to "The Fr o docs/185391 doc [handbook] brazilian portuguese translation to "GEOM: o docs/185382 doc missing description in rights(4) man page o docs/185353 docs nc(1) does not exit after transfer (should be document o docs/185281 doc [handbook] brazilian portuguese translation to "Jails" o docs/185280 doc [handbook] brazilian portuguese translation to "Introd o docs/185041 doc HTML rendering: replaceable elements are not distingui o docs/184758 doc error in rtadvd.conf example o docs/184755 doc The vmstat(8) manualpage synopsis doesn't show all opt o docs/184606 doc Translation of dashes in PDF version o docs/184482 doc passwd (1) man page incorrect info about login.conf o docs/184459 doc Documentation Bug in the man Page for the who Command o docs/184110 doc blackhole(4) manpage doesn`t describe net.inet.sctp.b o docs/184051 doc Update configuration example for staging o docs/184048 doc developers handbook, 10.7 Debugging Deadlocks - must i o docs/184046 doc bhyve(4) manpage references non-existant manpages bhyv o docs/184029 doc Description of /usr/tests is missing in hier(7) o docs/183927 doc missing info about kernel toolchain in kernel building o docs/183653 doc [patch] Add some more *BSD releases to the groff_mdoc o docs/183650 doc [patch] Remove misleading "kldload" in sem(4) man page o docs/183427 doc Online man pages don't include latest release + ports o docs/183333 doc Misnamed constant in bpf(4) o docs/183246 doc FreeBSD 8.4-RELEASE Installation Instructions don't pr o docs/183024 doc textdump(4) mentions call doadump, should be textdump o docs/183002 doc Fix instructions in "6.5.3. Anti-Aliased Fonts" regard o docs/182876 doc CURRENT release notes webpage out of date and inconsis o docs/182218 doc Add an ipfilter rc.conf option in handbook for IPv6 o docs/182202 doc Handbook pkgng description doesn't mention there are n o docs/181845 doc Virtualbox Host Setup needs acd0 in /etc/devfs.conf, a o docs/181844 doc FreeBSD Handbook Virtualbox Host Section missing confi o docs/181808 doc Chapter 15.15 (Resource Limits) misses important infor o docs/181785 doc [patch] Man page for tmpfile() is inconsistent o docs/181390 doc seq(1) first appeared in 8th UNIX o docs/181376 doc CLOCK_THREAD_CPUTIME_ID is not documented in clock_get o docs/181280 doc suggestion: split zfs man page in a zfs- way o docs/181134 doc Fix example for boot0cfg utility o docs/180970 doc [request] No manpage for ps_strings o docs/180767 doc [patch] printf.3: fix off-by-one in snprintf descripti o docs/180493 doc [handbook] Single-user mode console confusion o docs/180332 doc SSD Kernel Instructions Out of Date: options MFS throw o docs/180331 doc SSD Kernel Instructions Out of Date: options MD_ROOT a o docs/180330 doc SSD Kernel Instructions Out of Date: pseudo-device no o docs/180027 doc Missing man page entries for callout_reset_sbt in time o docs/179988 doc [faq] [patch] ThwackAFAQ - sandbox p docs/179914 doc remove inactive user dougb from mergemaster maintainer o docs/179697 doc Handbook incomplete WRT Opera flash usage (linproc) o docs/179497 doc [patch] service.8 add csh completion example o docs/179246 doc [patch] gnome porting updates o docs/178818 doc gmirror(8) says to use rc.early which is no longer ava o docs/178730 doc move roff papers out of src into doc o docs/178677 doc *** [article.html] Error code 1 Stop in /usr/doc. o docs/178286 doc [PATCH] document the LOCAL_* vars in build(7) o docs/178221 doc Addition to handbook jails chapter: warning about make o www/178190 doc myths web page should be updated o docs/178119 doc [ports] Porter's handbook lacks examples for using Opt o docs/177968 doc bpf(4): documentation of BIOCROTZBUF is incomplete o docs/177699 doc Documentation (handbook and manpage) for mac_biba does o docs/177514 doc [handbook] ZFS examples do not cover dataset creation o docs/177457 doc diskinfo(8): diskinfo -v shows inacurate drive size o docs/177431 doc Handbook & Announcements recommend poor dd options for o docs/177429 doc dd(1) man page is unclear about semantics of conv=sync o docs/177215 doc [handbook] [patch] FreeBSD uses SHA512 and no more MD5 o docs/176806 doc recv(2) man page grammatical fixes o docs/176648 doc restore(8) man page is misleading/confusing o docs/176645 doc The example in netmap.4 is wrong o docs/176363 doc Remove mention of 'CVSup' from "Mirroring FreeBSD arti o docs/176355 doc Attribution and correction of quote in fortune o docs/176251 doc FreeBSD Handbook assumes too much pre-knowledge o docs/176127 doc [handbook] add information about all missing mailing l o docs/176125 doc missing summary of freebsd-jail mailing list o docs/176123 doc missing summary of freebsd-sysinstall mailing list o docs/176015 doc [handbook] wrong order in docs for major upgrade o docs/175995 doc Setting MALLOC_PRODUCTION stops buildworld o docs/175983 doc man zfs are missing "hold, release" from "zfs allow" o docs/175712 doc Update 'disk naming' handbook page o docs/175687 doc pthread_setschedparam(3) may fail for undocumented rea o docs/175560 doc ugen(4) man page contains incorrect device node path o docs/175239 doc sem_wait can be interrupted o docs/175123 doc [geom] gpart list/status isn't documented in usage sec o docs/174868 doc mount(2) doesn't do a good job at describing all possi o docs/174792 doc synopsis for nsupdate(1) missing options -L, and -p o docs/174581 doc man page of recvmsg(2) does not mention return value 0 o docs/173710 doc Added section "MTP storage" to handbook o docs/173539 doc [patch] statfs(2) man page missed the error code ENOSY o docs/173321 doc ports(7) man page -- no info on building with debuggin o docs/173013 doc FreeBSD Boot Menu documentation lacks detail o docs/172927 doc ipfw(8): ipfw manual page doesn't show simpliest NAT c o docs/172913 doc [ipsec] [patch] setkey(8) is unclear on anti-replay wi o docs/172869 doc [PATCH] Add in nifty lang icons to index.html (home) o docs/172743 doc IPv6 handbooks lacks info about accepting router adver o docs/172626 doc [PATCH] modify the community/* pages to look more plea o docs/172370 doc [handbook] Handbook should be updated for Blu-Ray driv o docs/172369 doc mkisofs(8)/growisofs(1m) don't specify UDF version o docs/172368 doc mount_udf(8) doesn't specify which versions of UDF are o docs/172367 doc ata(4) man page needs an updated for Blu-Ray o docs/172330 doc [PATCH] Fix some errors introduced to announce.xml by o docs/172144 doc psignal(9) manpage is outdated for FreeBSD-9 systems o docs/172137 doc deprecated information for adduser(8) man pages o docs/171199 doc the GDB man page is outdated o docs/170691 doc Difference between zfs manpages and reality o docs/170119 doc at behaviour and man at inconsistency o docs/169712 doc [patch] porters-handbook zh_TW.Big5 apache section o docs/169711 doc [patch] porters-handbook zh_CN.GB2312 apache section o docs/169544 doc serial port console documentation changes s docs/169401 doc passify dead links in release links, move www to lists o docs/169377 doc [patch] ipmon(8) man page refers to a different facili o docs/169317 doc zfs umount refers to umount(1M) but should to umount(8 o docs/169158 doc [patch] iasl(8) man page is out of date f docs/168939 doc Port upgrade documentation missing from Application Ja o docs/168930 doc map_mincore(9) not up-to-date o docs/168915 doc size of integers used by test(1) and sh(1) is not docu o docs/168823 doc 404s in fr_FR French web pages o docs/168814 doc [patch] remove `d` negative pointer EINVAL requirement o docs/168803 doc Remove outdated smp info o docs/167429 doc geli(8) needs to mention unencrypted /etc/fstab requir o docs/166553 doc find(1): find -delete documentation is misleading o docs/166358 doc No networking in Jail build via: handbook/jail-tuning o conf/166330 doc [rc] [patch] Thin server configuration revision reques o docs/165551 doc ipfw(8): no info in "ipfw pipe show" about ipv6 o docs/165249 doc Multibyte characters in manpages still not displaying o docs/164803 doc Unclear manual page for mount_unionfs(8) o docs/164620 doc Raid 1 issues 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/163830 doc device smbios: missing documentation, no manpage o docs/163149 doc [patch] Red Hat Linux/i386 9 HTML format sudo man page o docs/162765 doc [patch] lseek(2) may return successful although no see o docs/162587 doc unclear/incomplete description of per-interface statis 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/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/160460 doc [handbook] Network setup guide suggestion o docs/160399 doc Man page for re(4) missing jumbo frames info o docs/159307 doc [patch] lpd smm chapter unconditionally installed 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/157908 doc [handbook] Description of post-install should include o docs/157698 doc [patch] gpart(8) man page contains old/incorrect size o docs/157316 doc [patch] update devstat(9) man page o docs/157049 doc FreeBSD Handbook: Chapter 14 (Security) Inaccuracy o 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/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 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/149574 doc [patch] update mi_switch(9) man page 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/146521 doc [handbook] Update IPv6 system handbook section to ment o docs/145699 doc hexdump(1) mutes all format qualifier output following 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/144515 doc [handbook] Expand handbook Table of contents 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/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/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/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/132839 doc [patch] Fix example script in ldap-auth article 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 o docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/126484 doc libc function res-zonscut2 is not documented 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/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/118214 doc close(2) error returns incomplete o docs/116588 doc No IPFW tables or dummynet in Handbook 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/112579 doc [request] No ipv6 related pf examples in /usr/share/ex 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/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/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu 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/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/101271 doc serial console documentation implies kernel rebuild re p docs/100196 doc man login.conf does explain not "unlimited" 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/95408 doc install over serial console does not work as documente 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/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/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/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 kern/51341 doc [ipfw] [patch] ipfw rule 'deny icmp from any to any ic o docs/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] Add documentation on the fixit disk o docs/47594 doc [patch] passwd(5) incorrectly states allowed username o docs/45303 doc Bug in PDF DocBook rendering 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/36724 doc ipnat(5) manpage grammar is incomplete and inconsisten s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. 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 273 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Jan 20 18:33:53 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 38FAFAA6; Mon, 20 Jan 2014 18:33:53 +0000 (UTC) Received: from mail.ipfw.ru (mail.ipfw.ru [IPv6:2a01:4f8:120:6141::2]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C382F1D68; Mon, 20 Jan 2014 18:33:52 +0000 (UTC) Received: from [2a02:6b8:0:401:222:4dff:fe50:cd2f] (helo=ptichko.yndx.net) by mail.ipfw.ru with esmtpsa (TLSv1:CAMELLIA256-SHA:256) (Exim 4.76 (FreeBSD)) (envelope-from ) id 1W5FpW-0000VL-FN; Mon, 20 Jan 2014 18:27:58 +0400 Message-ID: <52DD6B35.9080708@FreeBSD.org> Date: Mon, 20 Jan 2014 22:30:13 +0400 From: "Alexander V. Chernikov" User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:24.0) Gecko/20100101 Thunderbird/24.0.1 MIME-Version: 1.0 To: doc@freebsd.org, Glen Barber Subject: old records in 10.0R release announces Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Jan 2014 18:33:53 -0000 Hello guys! Some stale stuff in ttp://www.freebsd.org/releases/10.0R/relnotes.html#new: A new cpuset(2) API has been added for thread to CPU binding and CPU resource grouping and assignment. The cpuset(1) userland utility has been added to allow manipulation of processor sets. # cpuset appeared iin 7.1 The kernel now supports a new textdump format of kernel dumps. A textdump provides higher-level information via mechanically generated/extracted debugging output, rather than a simple memory dump. This facility can be used to generate brief kernel bug reports that are rich in debugging information, but are not dependent on kernel symbol tables or precisely synchronized source code. More information can be found in the textdump(4) manual page. # textdump appeared in 7.1 Kernel support for M:N threading has been removed. While the KSE (Kernel Scheduled Entities) project was quite successful in bringing threading to FreeBSD, the M:N approach taken by the KSE library was never developed to its full potential. Backwards compatibility for applications using KSE threading will be provided via libmap.conf(5) for dynamically linked binaries. The FreeBSD Project greatly appreciates the work of Julian Elischer, Daniel Eischen, and David Xu on KSE support. # KSE was removed in 8? The FreeBSD kernel now exports information about certain kernel features via the |kern.features| sysctl tree. The feature_present(3) library call provides a convenient interface for user applications to test the presence of features. # kern.features appeared in 6.X ? [amd64,i386,ia64,powerpc] The ULE scheduler is now the default process scheduler in |GENERIC| kernels. # loong ago Bootloader changes: # Entirely from 7.2 ? Network: The ale(4) driver has been added to provide support for Atheros AR8121/AR8113/AR8114 Gigabit/Fast Ethernet controllers. # ale is in 8 at least The em(4) driver has been split into two drivers with some common parts. The em(4) driver will continue to support adapters up to the 82575, as well as new client/desktop adapters. A new igb(4) driver will support new server adapters. # igb is not "new" nowadays 2.3 Userland: The procstat(1) utility has been added to display detailed information about processes. # Since 8 ? 2.4 Contrinuted awk has been updated from the 1 May 2007 release to the 23 October 2007 release. bzip2 has been updated from 1.0.4 to 1.0.5. # 8.x has 1.0.6 The timezone database has been updated from the tzdata2008h release to the tzdata2009m release. From owner-freebsd-doc@FreeBSD.ORG Mon Jan 20 18:42:37 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 3FDD2401; Mon, 20 Jan 2014 18:42:37 +0000 (UTC) Received: from mail0.glenbarber.us (mail0.glenbarber.us [IPv6:2607:fc50:1:2300:1001:1001:1001:face]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 1139D1E56; Mon, 20 Jan 2014 18:42:37 +0000 (UTC) Received: from glenbarber.us (c-71-224-221-174.hsd1.nj.comcast.net [71.224.221.174]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: gjb) by mail0.glenbarber.us (Postfix) with ESMTPSA id 7F110B14C; Mon, 20 Jan 2014 18:42:34 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.8.3 mail0.glenbarber.us 7F110B14C Authentication-Results: mail0.glenbarber.us; dkim=none reason="no signature"; dkim-adsp=none Date: Mon, 20 Jan 2014 13:42:32 -0500 From: Glen Barber To: Eugene Grosbein Subject: Re: 10.0 Release Notes section 2.2 Message-ID: <20140120184232.GS61932@glenbarber.us> References: <52DD6220.2020005@rdtc.ru> <52DD63CE.1000104@grosbein.net> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="EIrXVFSPgsocVIgL" Content-Disposition: inline In-Reply-To: <52DD63CE.1000104@grosbein.net> X-Operating-System: FreeBSD 11.0-CURRENT amd64 User-Agent: Mutt/1.5.22 (2013-10-16) Cc: stable@freebsd.org, melifaro@FreeBSD.org, freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Jan 2014 18:42:37 -0000 --EIrXVFSPgsocVIgL Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jan 21, 2014 at 12:58:38AM +0700, Eugene Grosbein wrote: > On 21.01.2014 00:51, Eugene Grosbein wrote: > > Hi! > >=20 > > Is it possible to fix 10.0 Release Notes section 2.2? > > http://www.freebsd.org/releases/10.0R/relnotes.html#new > >=20 > > It describes superpages, textdumps, KSE removal, cpuset, kern.features,= ULE > > as new features for 10.0 despite of the fact these functions are present > > since 8.0 and some of them in 7.2. >=20 > In fact, not only section 2.2 but many other sections of Release Notes > are full of old features present in 9.x, 8.x and 7.x versions describes a= s new. >=20 Thanks for the reports (everyone who reported problems). They're being looked at. Some changes have been made, and will be visible on the next rebuild. Glen --EIrXVFSPgsocVIgL Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (FreeBSD) iQIcBAEBCAAGBQJS3W4YAAoJELls3eqvi17QJlgP/ij0lsA05ho98gfVzgUr3U5m L6+zwwUNfIZlFfV3eKwPPmaxYu4ZuDHJUHy0Eg3Y/l712W8SYull/eFmKwCZtNFb Bfr7Zh/nT2+VOiYPGL0xjpE6c3Rl8O67Iso4ycMivdw6v2O0yL0epNSo+Bl1Nsrv 46r7fyYlyngx4KHyLW5OM/OBbCaFctY5EaHd2aEvi/Z4xB7M6Nv5aR/CzBb13t5S b6NVltec/KKtfXkU8xPT9ISUhT+0jpZUKkUS8aoTyts8oVS9eOunILmkPyNwQv/+ s3TkFnDfhU6OKO7r6J6lVlGElmF9mZ01to6U+iiWFXNrhYwAbZuBKQTCr5SQDPtN WgDNBSep6+AHnfJq4DCAedXFABESDtxzXh692yZRtfAirHVO63LW912AzjmLQtmr JNO4TE2AB9Bq97Rw/q/zISWrqjSolp4/n9WCjUn5iC8TLArajKSXhOUuWy/soFCj CfbSaGVqE+EfakoQ0oHy1wIjQhl4Ylu/z3lfOOgbwCaq1GTsrZjdTlvXL68EXbOP dyI1we24AoOp3SB0ZS2oiJNjEkvvBxAdCskc2oQ+e2s2s30PIADd7ZmJVrw7h1z+ 0Q0j29TRc5C2W9XTcXHQeeiiNV+ftz52Q+BCBr6g9mztnLiDsGGidM9dH4y49lW3 1CBiLjtgwLP6vpgWZNT8 =RXme -----END PGP SIGNATURE----- --EIrXVFSPgsocVIgL-- From owner-freebsd-doc@FreeBSD.ORG Mon Jan 20 19:51:07 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 3D582740 for ; Mon, 20 Jan 2014 19:51:07 +0000 (UTC) Received: from sdf.lonestar.org (mx.sdf.org [192.94.73.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 1F394149A for ; Mon, 20 Jan 2014 19:51:06 +0000 (UTC) Received: from otaku.freeshell.org (IDENT:cwr@otaku.freeshell.org [192.94.73.9]) by sdf.lonestar.org (8.14.7/8.14.5) with ESMTP id s0KJow1j018114 (using TLSv1/SSLv3 with cipher DHE-RSA-AES256-SHA (256 bits) verified NO) for ; Mon, 20 Jan 2014 19:51:00 GMT Date: Mon, 20 Jan 2014 19:50:58 +0000 (UTC) From: Charlie X-X-Sender: cwr@faeroes.freeshell.org To: freebsd-doc@freebsd.org Subject: Handbook Section 25.2.3.3 Error Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Jan 2014 19:51:07 -0000 Greetings all, First, I want to say "hi," and that I am excited to be part of the FreeBSD community. I am not much of a developer, but I have been wanting to help out with the project for a few months now, so I figured I could probably try helping with documentation. While upgrading a box to 10.0-RELEASE today, I happened to glance over the Handbook page on upgrading FreeBSD, and I believe there is a mistake in section 25.2.3.3, "Rebuilding Ports After a Major Version Upgrade." www5.us.freebsd.org/doc/handbook/updating-upgrading-freebsdupdate.html The portmaster command listed is 'portmaster -f', but I believe it should be 'portmaster -af'. Once again, I look forward to helping with the project. I am pretty good at writing, but not so great at coding and software development, so if there are any small projects that I might be able to work on, I'd be interested in learning more. Looking forward to NYC*BSDCON! Charlie Ross cwr@sdf.org SDF Public Access UNIX System - http://sdf.org From owner-freebsd-doc@FreeBSD.ORG Mon Jan 20 20:28:22 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 283E4C4A; Mon, 20 Jan 2014 20:28:22 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id B49FF175E; Mon, 20 Jan 2014 20:28:21 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id s0KKSKCc047197; Mon, 20 Jan 2014 13:28:20 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id s0KKSK08047194; Mon, 20 Jan 2014 13:28:20 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Mon, 20 Jan 2014 13:28:20 -0700 (MST) From: Warren Block To: Charlie Subject: Re: Handbook Section 25.2.3.3 Error 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.4.3 (wonkity.com [127.0.0.1]); Mon, 20 Jan 2014 13:28:20 -0700 (MST) Cc: freebsd-doc@freebsd.org, wblock@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Jan 2014 20:28:22 -0000 On Mon, 20 Jan 2014, Charlie wrote: > Greetings all, > > First, I want to say "hi," and that I am excited to be part of the FreeBSD > community. I am not much of a developer, but I have been wanting to help out > with the project for a few months now, so I figured I could probably try > helping with documentation. > > While upgrading a box to 10.0-RELEASE today, I happened to glance over the > Handbook page on upgrading FreeBSD, and I believe there is a mistake in > section 25.2.3.3, "Rebuilding Ports After a Major Version Upgrade." > > www5.us.freebsd.org/doc/handbook/updating-upgrading-freebsdupdate.html > > The portmaster command listed is 'portmaster -f', but I believe it should be > 'portmaster -af'. Agreed, change committed. > Once again, I look forward to helping with the project. I am pretty good at > writing, but not so great at coding and software development, so if there are > any small projects that I might be able to work on, I'd be interested in > learning more. Welcome! As with all documentation, there is always room for improvement. For an in-depth look at how the FreeBSD documentation works, we have the FDP Primer: http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ There is a lot there, don't let it overwhelm you. As far as projects, there are numerous open problem reports in the doc category: http://www.freebsd.org/cgi/query-pr-summary.cgi?category=docs Another approach is to just to report errors you've found, like you did above. It's usually best to file those as problem reports in the bug tracking system so they don't get lost: http://www.freebsd.org/support/bugreports.html Problem reports with patches are particularly prized because they can be quickly evaluated and committed. If you have questions or comments, you can post here or ask on IRC (#bsddocs on EFnet). Thanks! From owner-freebsd-doc@FreeBSD.ORG Mon Jan 20 20:45:48 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 9F284981; Mon, 20 Jan 2014 20:45:48 +0000 (UTC) Received: from home.opsec.eu (home.opsec.eu [IPv6:2001:14f8:200::1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 5B0B2190A; Mon, 20 Jan 2014 20:45:48 +0000 (UTC) Received: from pi by home.opsec.eu with local (Exim 4.80.1 (FreeBSD)) (envelope-from ) id 1W5Lj7-000FJk-6G; Mon, 20 Jan 2014 21:45:45 +0100 Date: Mon, 20 Jan 2014 21:45:45 +0100 From: Kurt Jaeger To: Glen Barber Subject: Re: 10.0 Release Notes section 2.2 Message-ID: <20140120204545.GM2951@home.opsec.eu> References: <52DD6220.2020005@rdtc.ru> <52DD63CE.1000104@grosbein.net> <20140120184232.GS61932@glenbarber.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20140120184232.GS61932@glenbarber.us> Cc: stable@freebsd.org, freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Jan 2014 20:45:48 -0000 Hi! > Thanks for the reports (everyone who reported problems). The link to the raspberry pi instructions is old. In the rel-notes: http://kernelnomicon.org/?p=164 Better (still somewhat out of date) link: http://kernelnomicon.org/?p=275 -- pi@opsec.eu +49 171 3101372 6 years to go ! From owner-freebsd-doc@FreeBSD.ORG Mon Jan 20 20:59:04 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id AD605682; Mon, 20 Jan 2014 20:59:04 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 817F81A11; Mon, 20 Jan 2014 20:59:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0KKx4En037040; Mon, 20 Jan 2014 20:59:04 GMT (envelope-from wblock@freefall.freebsd.org) Received: (from wblock@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0KKx4rF037039; Mon, 20 Jan 2014 20:59:04 GMT (envelope-from wblock) Date: Mon, 20 Jan 2014 20:59:04 GMT Message-Id: <201401202059.s0KKx4rF037039@freefall.freebsd.org> To: mallen@vidnet.net, wblock@FreeBSD.org, freebsd-doc@FreeBSD.org From: wblock@FreeBSD.org Subject: Re: docs/164620: Raid 1 issues X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Jan 2014 20:59:04 -0000 Synopsis: Raid 1 issues State-Changed-From-To: open->closed State-Changed-By: wblock State-Changed-When: Mon Jan 20 20:56:28 UTC 2014 State-Changed-Why: The gmirror section of the GEOM chapter was completely rewritten in November 2012, r39909, to use best practices for creating mirrors out of new or existing drives. It will not cause the problems the old version did. http://www.freebsd.org/cgi/query-pr.cgi?pr=164620 From owner-freebsd-doc@FreeBSD.ORG Tue Jan 21 01:02:11 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 1B12758E; Tue, 21 Jan 2014 01:02:11 +0000 (UTC) Received: from mail0.glenbarber.us (mail0.glenbarber.us [208.86.227.67]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id E12A01F95; Tue, 21 Jan 2014 01:02:10 +0000 (UTC) Received: from glenbarber.us (c-71-224-221-174.hsd1.nj.comcast.net [71.224.221.174]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: gjb) by mail0.glenbarber.us (Postfix) with ESMTPSA id 496E2CC50; Tue, 21 Jan 2014 01:02:08 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.8.3 mail0.glenbarber.us 496E2CC50 Authentication-Results: mail0.glenbarber.us; dkim=none reason="no signature"; dkim-adsp=none Date: Mon, 20 Jan 2014 20:02:07 -0500 From: Glen Barber To: Kurt Jaeger Subject: Re: 10.0 Release Notes section 2.2 Message-ID: <20140121010207.GX61932@glenbarber.us> References: <52DD6220.2020005@rdtc.ru> <52DD63CE.1000104@grosbein.net> <20140120184232.GS61932@glenbarber.us> <20140120204545.GM2951@home.opsec.eu> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="0q9y5TNQq+E02vJE" Content-Disposition: inline In-Reply-To: <20140120204545.GM2951@home.opsec.eu> X-Operating-System: FreeBSD 11.0-CURRENT amd64 User-Agent: Mutt/1.5.22 (2013-10-16) Cc: stable@freebsd.org, freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jan 2014 01:02:11 -0000 --0q9y5TNQq+E02vJE Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jan 20, 2014 at 09:45:45PM +0100, Kurt Jaeger wrote: > Hi! >=20 > > Thanks for the reports (everyone who reported problems). >=20 > The link to the raspberry pi instructions is old. >=20 > In the rel-notes: >=20 > http://kernelnomicon.org/?p=3D164 >=20 > Better (still somewhat out of date) link: >=20 > http://kernelnomicon.org/?p=3D275 >=20 Thank you for the info. I am hesitant to update the page (more than *critically* required) for this. Since the first link has the link to the updated version, albeit still not quite current, I think the URL might be best left alone. The problem is (to explain my hesitation) that I'm working off uncommitted changes to the releng/10.0/release/doc/ files. It is not that I do not *want* to commit the changes -- it is that I *cannot* commit the changes. Unfortunately. The best that I can do at this point to keep a record of these changes in the repository is r260922. While, technically, I can propose an update for the releng/10.0/ branch, this qualifies neither as a security advisory or an errata notice (in the strictest sense that neither the source code for the userland or kernel are affected). Glen --0q9y5TNQq+E02vJE Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (FreeBSD) iQIcBAEBCAAGBQJS3ccOAAoJELls3eqvi17QPhwP+gJqS6CaRqKCnJ+QtQE3mAlq okwsBIi7CyGutMJurvVVcgwnu1ndFAbLgXVo37cP4SePCdrwCW+qZeZAdGP55jqV aMXfV/M4wzmmvpl8wycGxt8qfbYYVjjDTdhuOOxbjN+swW0gRiISV3G4WZlbbgGD 52WHvFgX5JOHnbP+mtYA/H12GRCQjHTPQL01kYev5B7cAk69wiEKFI9O8OnG4eef hEzt4HY3ePmxDkJ5RI20CKKZ/ewEVsfASR+okLckOX/FptX9v4QcixsqcE6ppSO1 WMZv5SMFMj9y1P2wlX0Jwl9202EKSNkj0Erk9Te0yFmsU29XxZvUVKKA8uCM/THB 7h0iTXf+KScM3VmZ7RW2ZzqZr+ofGuWVv1aILWPhg6DYMVNTbn2zA1Do2bmla3tY aBl2pSj06Pl/7Qi+WUF/7hQENqFlusS9FlPHDuir+4SC5Y5D50nFjbyDxjbx3Bc+ jDQDi4pw1S2LWU/HS6vr9cmIDq1dQtPgr9BbRTpELzVVApD/mNUK5T6gURefzGrS 67hNkVsOecTHpy+VfxYrmXvUDaNHyI3lfx3gdmVy2Q4Qn//R36Iz/jdpSW/ppMAk mltP8B6ocN77xuEI9cZjtTinxnk6cPIl6PpkC30FARfMw7uVtuiW757mASdnPci1 t1yR+EWXFl4lx/I0Mjmo =MBtR -----END PGP SIGNATURE----- --0q9y5TNQq+E02vJE-- From owner-freebsd-doc@FreeBSD.ORG Tue Jan 21 06:04:16 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 7831F8D5; Tue, 21 Jan 2014 06:04:16 +0000 (UTC) Received: from ohta.kitchenlab.org (ohta.kitchenlab.org [IPv6:2001:470:1f05:55c::1]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 3026814F0; Tue, 21 Jan 2014 06:04:16 +0000 (UTC) Received: from Bruces-MacBook-Pro.local (c-67-188-254-192.hsd1.ca.comcast.net [67.188.254.192]) (authenticated bits=0) by ohta.kitchenlab.org (8.14.7/8.14.7) with ESMTP id s0L63tLZ056602 (version=TLSv1/SSLv3 cipher=DHE-RSA-CAMELLIA256-SHA bits=256 verify=NO); Mon, 20 Jan 2014 22:03:56 -0800 (PST) (envelope-from bmah@FreeBSD.org) X-Authentication-Warning: ohta.kitchenlab.org: Host c-67-188-254-192.hsd1.ca.comcast.net [67.188.254.192] claimed to be Bruces-MacBook-Pro.local Message-ID: <52DE0DCB.4080008@FreeBSD.org> Date: Mon, 20 Jan 2014 22:03:55 -0800 From: "Bruce A. Mah" Organization: The FreeBSD Project User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 MIME-Version: 1.0 To: Glen Barber , Kurt Jaeger Subject: Re: 10.0 Release Notes section 2.2 References: <52DD6220.2020005@rdtc.ru> <52DD63CE.1000104@grosbein.net> <20140120184232.GS61932@glenbarber.us> <20140120204545.GM2951@home.opsec.eu> <20140121010207.GX61932@glenbarber.us> In-Reply-To: <20140121010207.GX61932@glenbarber.us> X-Enigmail-Version: 1.6 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="4AHD5uf60BLFP6W1epE6GWdcCLXE297R4" Cc: stable@freebsd.org, freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jan 2014 06:04:16 -0000 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --4AHD5uf60BLFP6W1epE6GWdcCLXE297R4 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable If memory serves me right, Glen Barber wrote: > The problem is (to explain my hesitation) that I'm working off > uncommitted changes to the releng/10.0/release/doc/ files. It is not > that I do not *want* to commit the changes -- it is that I *cannot* > commit the changes. Unfortunately. >=20 > The best that I can do at this point to keep a record of these changes > in the repository is r260922. While, technically, I can propose an > update for the releng/10.0/ branch, this qualifies neither as a securit= y > advisory or an errata notice (in the strictest sense that neither the > source code for the userland or kernel are affected). Put some corrections / additions in the 10.0 release errata (on the 10.0-STABLE codeline)? That's one of the original uses for that file. Bruce. --4AHD5uf60BLFP6W1epE6GWdcCLXE297R4 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQEcBAEBCgAGBQJS3g3LAAoJEEmEkQqMqu6K0DAH/iHVxRMBLyg9TjIsbqWigd1G 5UPzFRNHzMtrOr5Obg7Y53O/pJH1QYPFh5QlRvGQmdQgiG1Z4DQOog43MXxlxQHf s90nhYEP4FAAGSYcQ/fHBqXlHrga3o+LH/+yk6S+uX8LLr5j0KqBzP2Zt1H6wGb+ 8ntUf4+K0XoPH5vaw0/6PQrgKXF+L/9mvKFwX5mni7GU621jWj2fgFfGw4o2j7zP T2dys3xLrF7R9MD3pfmKe3mTuRoxf9+DP367gI+tGlUwkB2UjVdDu3NvY2Kd1kft 3qmMtuIgoiHRpLrsi5dk0+WrLXwImDQ0oA3LAd7rNuOTBOzyw9lXIsocy4kxJfA= =PiZP -----END PGP SIGNATURE----- --4AHD5uf60BLFP6W1epE6GWdcCLXE297R4-- From owner-freebsd-doc@FreeBSD.ORG Tue Jan 21 14:00:41 2014 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 4BB3D8F5 for ; Tue, 21 Jan 2014 14:00:41 +0000 (UTC) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 0176C1016 for ; Tue, 21 Jan 2014 14:00:40 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 569BC14D2508 for ; Tue, 21 Jan 2014 15:00:38 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com 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 AUGUjPC4Ywd2 for ; Tue, 21 Jan 2014 15:00:37 +0100 (CET) Received: from [192.168.0.10] (54034B4D.catv.pool.telekom.hu [84.3.75.77]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 058C514D242C for ; Tue, 21 Jan 2014 15:00:37 +0100 (CET) Message-ID: <52DE7D76.5040609@kovesdan.org> Date: Tue, 21 Jan 2014 15:00:22 +0100 From: =?ISO-8859-1?Q?G=E1bor_K=F6vesd=E1n?= User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130801 Thunderbird/17.0.8 MIME-Version: 1.0 To: doc@FreeBSD.org Subject: RFC: line numbered programlisting in HTML docs Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jan 2014 14:00:41 -0000 Hi, in the pdf version of the documentation we have rendered line wrap indicators that show the reader when a long line has been wrapped into multiple lines so that it can be rendered. In the HTML version we have scrollable programlistings, which is not so smart since you may need to scroll to read all of the code, which is not comfortable. Using line wrap indicators in HTML is only possible with an ugly CSS trick but if we number the lines, which in turn is quite easy, it becomes obvious when a long line is wrapped. This is what I propose for programlisting and screen elements. Also, line numbering is a useful feature in itself. Demo: http://kovesdan.org/doc/proglist.html Patch: http://kovesdan.org/patches/programlisting.diff Any objection to this change? Thanks, Gabor From owner-freebsd-doc@FreeBSD.ORG Tue Jan 21 15:30:41 2014 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 6F19FE73 for ; Tue, 21 Jan 2014 15:30:41 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 0473118AD for ; Tue, 21 Jan 2014 15:30:40 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id s0LFUdSx055683; Tue, 21 Jan 2014 08:30:39 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id s0LFUd2F055680; Tue, 21 Jan 2014 08:30:39 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Tue, 21 Jan 2014 08:30:39 -0700 (MST) From: Warren Block To: =?ISO-8859-15?Q?G=E1bor_K=F6vesd=E1n?= Subject: Re: RFC: line numbered programlisting in HTML docs In-Reply-To: <52DE7D76.5040609@kovesdan.org> Message-ID: References: <52DE7D76.5040609@kovesdan.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-ID: X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Tue, 21 Jan 2014 08:30:39 -0700 (MST) Content-Type: TEXT/PLAIN; CHARSET=ISO-8859-15; FORMAT=flowed Content-Transfer-Encoding: 8BIT X-Content-Filtered-By: Mailman/MimeDel 2.1.17 Cc: doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jan 2014 15:30:41 -0000 On Tue, 21 Jan 2014, Gábor Kövesdán wrote: > in the pdf version of the documentation we have rendered line wrap indicators > that show the reader when a long line has been wrapped into multiple lines so > that it can be rendered. In the HTML version we have scrollable > programlistings, which is not so smart since you may need to scroll to read > all of the code, which is not comfortable. Using line wrap indicators in HTML > is only possible with an ugly CSS trick but if we number the lines, which in > turn is quite easy, it becomes obvious when a long line is wrapped. This is > what I propose for programlisting and screen elements. Also, line numbering > is a useful feature in itself. > > Demo: http://kovesdan.org/doc/proglist.html > > Patch: http://kovesdan.org/patches/programlisting.diff It's interesting, and looks nice. There's no clear indicator of what the single-digit line numbers mean, but that's probably not serious. Another concern is cut and paste, whether the long line pastes as a single line or not. Firefox seems to have a ongoing bug and pastes *everything* copied as a single line anyway. With Midori, the long line and the rest of the content pastes correctly. Are blank lines not numbered, or is the blank second line added by the markup after long lines? For programlistings, I think this is fine. On screen elements, the added line numbers may not help, but we have fewer screen elements with too-long lines. From owner-freebsd-doc@FreeBSD.ORG Tue Jan 21 16:23:55 2014 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id AC3A23CE for ; Tue, 21 Jan 2014 16:23:55 +0000 (UTC) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 5E5E71E76 for ; Tue, 21 Jan 2014 16:23:55 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 0F0C614D242D; Tue, 21 Jan 2014 17:23:51 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com 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 lICm7xevgAFh; Tue, 21 Jan 2014 17:23:50 +0100 (CET) Received: from [192.168.0.10] (54034B4D.catv.pool.telekom.hu [84.3.75.77]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 8676114D242C; Tue, 21 Jan 2014 17:23:50 +0100 (CET) Message-ID: <52DE9F0D.3080803@kovesdan.org> Date: Tue, 21 Jan 2014 17:23:41 +0100 From: =?ISO-8859-15?Q?G=E1bor_K=F6vesd=E1n?= User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130801 Thunderbird/17.0.8 MIME-Version: 1.0 To: Warren Block Subject: Re: RFC: line numbered programlisting in HTML docs References: <52DE7D76.5040609@kovesdan.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jan 2014 16:23:55 -0000 On 2014.01.21. 16:30, Warren Block wrote: > Are blank lines not numbered, or is the blank second line added by the > markup after long lines? That was a problem with my hand-written markup. I've just fixed it and it does not happen with generated markup. Gabor From owner-freebsd-doc@FreeBSD.ORG Tue Jan 21 17:58:10 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 1885E757 for ; Tue, 21 Jan 2014 17:58:10 +0000 (UTC) Received: from smtpin1.utoledo.edu (smtpin1.utoledo.edu [131.183.2.213]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id AF0D01726 for ; Tue, 21 Jan 2014 17:58:09 +0000 (UTC) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AjsBAKO03lKDtwIWl2dsb2JhbABZg0M4HoJ9t1aCLxYOAQEBAQEIFgc8gk8VEQo7IAIFFgsCCwMCAQIBSw0IAQGIAQWYEY8RlyiEfxeBKY1zglmBSQSJR5UijxyCDA X-IronPort-AV: E=Sophos;i="4.95,696,1384318800"; d="scan'208";a="307921977" Received: from dlpint00.utoledo.edu ([131.183.2.22]) by smtpin1.utoledo.edu with ESMTP/TLS/DHE-RSA-AES256-SHA; 21 Jan 2014 12:56:47 -0500 Received: from MSGAPP12.utad.utoledo.edu (msgapp12.utad.utoledo.edu [131.183.3.8]) by dlpint00.utoledo.edu (RSA Interceptor) for ; Tue, 21 Jan 2014 12:56:26 -0500 Received: from [192.168.1.79] (76.238.196.183) by Email.Utoledo.Edu (131.183.3.18) with Microsoft SMTP Server (TLS) id 14.3.169.1; Tue, 21 Jan 2014 12:56:26 -0500 Message-ID: <52DEB4C7.6010506@UToledo.edu> Date: Tue, 21 Jan 2014 12:56:23 -0500 From: Robert Burmeister User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.28) Gecko/20120306 Thunderbird/3.1.20 MIME-Version: 1.0 To: Subject: pkg(8) man pages are not yet on www.freebsd.org X-Priority: 1 (Highest) Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: 7bit X-Originating-IP: [76.238.196.183] X-RSA-Inspected: yes X-RSA-Classifications: public X-RSA-Action: allow X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jan 2014 17:58:10 -0000 pkg(8) man pages are not yet on www.freebsd.org I cannot find them elsewhere on the www either. From owner-freebsd-doc@FreeBSD.ORG Tue Jan 21 18:05:11 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id CB082868; Tue, 21 Jan 2014 18:05:11 +0000 (UTC) Received: from mail0.glenbarber.us (mail0.glenbarber.us [IPv6:2607:fc50:1:2300:1001:1001:1001:face]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 9E7EA17FB; Tue, 21 Jan 2014 18:05:11 +0000 (UTC) Received: from glenbarber.us (c-71-224-221-174.hsd1.nj.comcast.net [71.224.221.174]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: gjb) by mail0.glenbarber.us (Postfix) with ESMTPSA id B2677D503; Tue, 21 Jan 2014 18:05:09 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.8.3 mail0.glenbarber.us B2677D503 Authentication-Results: mail0.glenbarber.us; dkim=none reason="no signature"; dkim-adsp=none Date: Tue, 21 Jan 2014 13:05:08 -0500 From: Glen Barber To: Robert Burmeister Subject: Re: pkg(8) man pages are not yet on www.freebsd.org Message-ID: <20140121180508.GE35180@glenbarber.us> References: <52DEB4C7.6010506@UToledo.edu> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="gDGSpKKIBgtShtf+" Content-Disposition: inline In-Reply-To: <52DEB4C7.6010506@UToledo.edu> X-Operating-System: FreeBSD 11.0-CURRENT amd64 User-Agent: Mutt/1.5.22 (2013-10-16) Cc: freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jan 2014 18:05:11 -0000 --gDGSpKKIBgtShtf+ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jan 21, 2014 at 12:56:23PM -0500, Robert Burmeister wrote: > pkg(8) man pages are not yet on www.freebsd.org >=20 > I cannot find them elsewhere on the www either. >=20 The pkg(8) manual pages are installed by the ports-mgmt/pkg port. The pkg(7) manual does exist. http://www.freebsd.org/cgi/man.cgi?query=3Dpkg&sektion=3D7&manpath=3DFreeBS= D+10.0-RELEASE Glen --gDGSpKKIBgtShtf+ Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (FreeBSD) iQIcBAEBCAAGBQJS3rbUAAoJELls3eqvi17QUg4P/i8qVT4ZX6AsNoPfcfFHIHsH XUPwlaOFXS7kUC4abSUPssaDWFodXBfA5dshQjwrbzM4YmSynKYQ8L+QIds8/0+d WQ4+ywSN8O2SbG9WLrygpk9B8c7aVY/anZTzDmwkNjLvvGREIDzBIUCBYqCBKihj FB9SnDET6ZUlk6MIaXs4jRYxJakuo0qq7H2ZwbbfunFJlrq8i0Uh/R+Ru3iYaNkR +kpLAaVBfvk/ThZEsVxLwhdfqZVKy/225mjKmeop7y8s72/qPtnc2dW2xsWefVVX 34C1l8XkuSzFukt7dJ/3I1wjcRVGexNMjYib8a0n6po+L41FTm+sTs5eZbmTv8b9 ayN0zIArMsOkvwyqtNmOsNkoBy8/eSB0+bkEPLS0r+lBO9xVSdmhh2q6c466d6K/ 0Rf461XPckQup5hdDoTCBW1T/4SkwJDI4z7mFU7I9oFH2BYt/mi2oSxBbqr2kXg2 X3Y9BSxtzcUY5q601blW9Nw3zaKMTJSnTuPT7jhAjJ8sFRJcUfhdKJMhsFeprLax Pkjh/xYQ4Y9b7azAo+a5OyyrUbRapOTWeswKj6YBouxj6sNzIGpX5gHI6bBRGtFg v7JWYii/ezfzXNxZ2oacP2qWoyWdR0N0raMKlaRQY0fMm3c+PSQYa36ceNwhYFxS E2sdlDgnu46HVBypuntw =7pV5 -----END PGP SIGNATURE----- --gDGSpKKIBgtShtf+-- From owner-freebsd-doc@FreeBSD.ORG Tue Jan 21 23:34:52 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id D3EACA96 for ; Tue, 21 Jan 2014 23:34:52 +0000 (UTC) Received: from mail-pd0-f174.google.com (mail-pd0-f174.google.com [209.85.192.174]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id AAC02156A for ; Tue, 21 Jan 2014 23:34:52 +0000 (UTC) Received: by mail-pd0-f174.google.com with SMTP id z10so3569545pdj.19 for ; Tue, 21 Jan 2014 15:34:51 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:date:message-id:subject:from :to:cc:content-type; bh=CfCsVx8CjrQNyrxdQZhXLC+Yj7VBiGyH4gFTOLqcMOk=; b=LocXkK9qYdo38J+Aiq1eSt1pPu5wNX6k6yrc2y6BG94z/pjTTHhmTvc/gbbhQ6RLq0 sQ61XH1YBzRGQPmevz5Z3XvlDPrLkHDdKus7G0T5K6J8gGiywBKXNxxGa4lUHxgg8aFb ltoWbTOxFHrpTwcRRVx+TdYRK87awp8YXDQuRnggbVUvK05YJXGW0AMk6Gp2LFallvZA wqh4r5+M0Ygep3qIgMIr5MIo/57k0jNefYibJp3XVAYemxUbOeT43lDGUrrdneNg6Rcp JoM+gg70Sk7s73kRW3yQinwf2WvlX0zTPdjpY9t40ReivZ2lUmixN4MlrdJNfPjK92Fj qucw== X-Gm-Message-State: ALoCoQn/QBZ1mbBdCX7kknG6jadlDpDV/r027vqwppA2L5WGdXM0J8D90x5nZ0JcbRKpNEAa7+hi MIME-Version: 1.0 X-Received: by 10.66.231.6 with SMTP id tc6mr28119699pac.68.1390347291580; Tue, 21 Jan 2014 15:34:51 -0800 (PST) Sender: bsd-src@helfman.org Received: by 10.70.78.130 with HTTP; Tue, 21 Jan 2014 15:34:51 -0800 (PST) Date: Tue, 21 Jan 2014 15:34:51 -0800 X-Google-Sender-Auth: m-F9TTistPXARE1AMNY7GqvyIwg Message-ID: Subject: java documentation From: Jason Helfman To: java@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 Cc: doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Jan 2014 23:34:52 -0000 Hello All, Over time I have sent in patches to documentation for java updates, however there have been far more updates to the software then there is keeping the documentation up-to-date. That being said, are there any efforts into updating the documentation noted here: http://www.freebsd.org/java/dists/16.html http://www.freebsd.org/java/dists/17.html If so, that is great, and look forward to any commits to add any more relevant content. If this isn't the case, and it is more of an effort to be updated, is it possible we can explore other directions for content in this location, or removal of the pages, or another option? Thanks! -jgh -- Jason Helfman | FreeBSD Committer jgh@FreeBSD.org | http://people.freebsd.org/~jgh | The Power to Serve From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 07:01:15 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 835FA69E; Wed, 22 Jan 2014 07:01:15 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 5848A15C1; Wed, 22 Jan 2014 07:01:15 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0M71F95061908; Wed, 22 Jan 2014 07:01:15 GMT (envelope-from jgh@freefall.freebsd.org) Received: (from jgh@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0M71FUk061907; Wed, 22 Jan 2014 07:01:15 GMT (envelope-from jgh) Date: Wed, 22 Jan 2014 07:01:15 GMT Message-Id: <201401220701.s0M71FUk061907@freefall.freebsd.org> To: dbaker@FreeBSD.org, jgh@FreeBSD.org, freebsd-doc@FreeBSD.org From: jgh@FreeBSD.org Subject: Re: docs/138845: Exceeding kern.ipc.maxpipekva refers to tuning(7) which has no info on the problem X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 07:01:15 -0000 Synopsis: Exceeding kern.ipc.maxpipekva refers to tuning(7) which has no info on the problem State-Changed-From-To: open->closed State-Changed-By: jgh State-Changed-When: Wed Jan 22 07:01:15 UTC 2014 State-Changed-Why: this was addressed in r187661 http://www.freebsd.org/cgi/query-pr.cgi?pr=138845 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 10:10:01 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id A0627632 for ; Wed, 22 Jan 2014 10:10:01 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 8B7B11655 for ; Wed, 22 Jan 2014 10:10:01 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0MAA13V016203 for ; Wed, 22 Jan 2014 10:10:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0MAA1JC016202; Wed, 22 Jan 2014 10:10:01 GMT (envelope-from gnats) Date: Wed, 22 Jan 2014 10:10:01 GMT Message-Id: <201401221010.s0MAA1JC016202@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: dfilter@FreeBSD.ORG (dfilter service) Subject: Re: docs/185041: commit references a PR X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 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, 22 Jan 2014 10:10:01 -0000 The following reply was made to PR docs/185041; it has been noted by GNATS. From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/185041: commit references a PR Date: Wed, 22 Jan 2014 10:07:25 +0000 (UTC) Author: gabor Date: Wed Jan 22 10:07:19 2014 New Revision: 43623 URL: http://svnweb.freebsd.org/changeset/doc/43623 Log: - Mark a command part as replaceable PR: docs/185041 Submitted by: wblock Modified: head/en_US.ISO8859-1/books/fdp-primer/book.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/book.xml Tue Jan 21 23:41:48 2014 (r43622) +++ head/en_US.ISO8859-1/books/fdp-primer/book.xml Wed Jan 22 10:07:19 2014 (r43623) @@ -181,7 +181,7 @@ The time is 09:18 To search for a keyword in the manual pages, type man -k - keyword + keyword _______________________________________________ svn-doc-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/svn-doc-all To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org" From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 10:15:56 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 942B473F for ; Wed, 22 Jan 2014 10:15:56 +0000 (UTC) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4793C16EC for ; Wed, 22 Jan 2014 10:15:56 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id B53D614D242D; Wed, 22 Jan 2014 11:15:39 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com 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 8p1jn2JP25gC; Wed, 22 Jan 2014 11:15:38 +0100 (CET) Received: from [152.66.188.131] (vpn3.aut.bme.hu [152.66.188.131]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id CA5AF14D2400; Wed, 22 Jan 2014 11:15:38 +0100 (CET) Message-ID: <52DF9A40.9000904@kovesdan.org> Date: Wed, 22 Jan 2014 11:15:28 +0100 From: =?ISO-8859-1?Q?G=E1bor_K=F6vesd=E1n?= User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20130801 Thunderbird/17.0.8 MIME-Version: 1.0 To: Warren Block Subject: Re: [HEADSUP] Merging DocBook 5.0 update References: <527BADCB.8030308@kovesdan.org> <527BDA8B.3030908@kovesdan.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 10:15:56 -0000 On 2013.11.26. 7:18, Warren Block wrote: > Some automated conversions in the FDP Primer had problems. is > not allowed inside , so some of the entities in the FreeBSD > Entities table lost their markup. > > Is there a better solution than using < and >? > Literal is a literal text, by definition so it cannot have semantic information attached. In this description you explain what literal text to type in and this makes sense, you talk about literal characters < and >. Gabor From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 10:29:07 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 9FC3EB4C; Wed, 22 Jan 2014 10:29:07 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 748221818; Wed, 22 Jan 2014 10:29:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0MAT7RH021481; Wed, 22 Jan 2014 10:29:07 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0MAT7ts021480; Wed, 22 Jan 2014 10:29:07 GMT (envelope-from gabor) Date: Wed, 22 Jan 2014 10:29:07 GMT Message-Id: <201401221029.s0MAT7ts021480@freefall.freebsd.org> To: wblock@FreeBSD.org, gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Subject: Re: docs/185041: HTML rendering: replaceable elements are not distinguished X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 10:29:07 -0000 Synopsis: HTML rendering: replaceable elements are not distinguished State-Changed-From-To: open->closed State-Changed-By: gabor State-Changed-When: Wed Jan 22 10:28:17 UTC 2014 State-Changed-Why: I have fixed this case, thanks! Unfortunately, some other replaceable elements may have been lost in the DB5 conversion. Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Wed Jan 22 10:28:17 UTC 2014 Responsible-Changed-Why: I have fixed this case, thanks! Unfortunately, some other replaceable elements may have been lost in the DB5 conversion. http://www.freebsd.org/cgi/query-pr.cgi?pr=185041 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 13:36:32 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 99B3A959; Wed, 22 Jan 2014 13:36:32 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 6B26318F6; Wed, 22 Jan 2014 13:36:32 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0MDaWKe067258; Wed, 22 Jan 2014 13:36:32 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0MDaVbX067257; Wed, 22 Jan 2014 13:36:31 GMT (envelope-from gabor) Date: Wed, 22 Jan 2014 13:36:31 GMT Message-Id: <201401221336.s0MDaVbX067257@freefall.freebsd.org> To: joe@tao.org.uk, gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Subject: Re: docs/33589: [patch] to doc.docbook.mk to post process .tex files. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 13:36:32 -0000 Synopsis: [patch] to doc.docbook.mk to post process .tex files. State-Changed-From-To: suspended->closed State-Changed-By: gabor State-Changed-When: Wed Jan 22 13:35:51 UTC 2014 State-Changed-Why: We do not use TeX any more in the rendering process. Thanks for your contribution, though. Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Wed Jan 22 13:35:51 UTC 2014 Responsible-Changed-Why: We do not use TeX any more in the rendering process. Thanks for your contribution, though. http://www.freebsd.org/cgi/query-pr.cgi?pr=33589 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 13:38:47 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 1171F9E4; Wed, 22 Jan 2014 13:38:47 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id F158A1914; Wed, 22 Jan 2014 13:38:46 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0MDckGb067331; Wed, 22 Jan 2014 13:38:46 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0MDckPd067330; Wed, 22 Jan 2014 13:38:46 GMT (envelope-from gabor) Date: Wed, 22 Jan 2014 13:38:46 GMT Message-Id: <201401221338.s0MDckPd067330@freefall.freebsd.org> To: wblock@wonkity.com, gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Subject: Re: docs/45303: Bug in PDF DocBook rendering X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 13:38:47 -0000 Synopsis: Bug in PDF DocBook rendering State-Changed-From-To: open->closed State-Changed-By: gabor State-Changed-When: Wed Jan 22 13:37:03 UTC 2014 State-Changed-Why: We now use a different toolchain, which handles better running off text. If there are such parts in the documentation, those should be checked individually. Thanks for your report anyway! Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Wed Jan 22 13:37:03 UTC 2014 Responsible-Changed-Why: We now use a different toolchain, which handles better running off text. If there are such parts in the documentation, those should be checked individually. Thanks for your report anyway! http://www.freebsd.org/cgi/query-pr.cgi?pr=45303 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 13:40:49 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 615A5A4D; Wed, 22 Jan 2014 13:40:49 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 354DC1988; Wed, 22 Jan 2014 13:40:49 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0MDenYv069133; Wed, 22 Jan 2014 13:40:49 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0MDemWT069132; Wed, 22 Jan 2014 13:40:48 GMT (envelope-from gabor) Date: Wed, 22 Jan 2014 13:40:48 GMT Message-Id: <201401221340.s0MDemWT069132@freefall.freebsd.org> To: rinaldo@ukrpost.net, gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Subject: Re: docs/98115: Missing parts after rendering handbook to RTF format X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 13:40:49 -0000 Synopsis: Missing parts after rendering handbook to RTF format State-Changed-From-To: open->closed State-Changed-By: gabor State-Changed-When: Wed Jan 22 13:39:19 UTC 2014 State-Changed-Why: We now a use a more mature toolchain so fixrtf is not used any more. Anyway, thank you for your report. Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Wed Jan 22 13:39:19 UTC 2014 Responsible-Changed-Why: We now a use a more mature toolchain so fixrtf is not used any more. Anyway, thank you for your report. http://www.freebsd.org/cgi/query-pr.cgi?pr=98115 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 13:58:15 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 03CCAE1D; Wed, 22 Jan 2014 13:58:15 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id E5FA41A89; Wed, 22 Jan 2014 13:58:14 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0MDwEQ9071451; Wed, 22 Jan 2014 13:58:14 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0MDwEOV071450; Wed, 22 Jan 2014 13:58:14 GMT (envelope-from gabor) Date: Wed, 22 Jan 2014 13:58:14 GMT Message-Id: <201401221358.s0MDwEOV071450@freefall.freebsd.org> To: admin@canonicaldev.com, gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Subject: Re: docs/178677: *** [article.html] Error code 1 Stop in /usr/doc. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 13:58:15 -0000 Synopsis: *** [article.html] Error code 1 Stop in /usr/doc. State-Changed-From-To: open->closed State-Changed-By: gabor State-Changed-When: Wed Jan 22 13:56:32 UTC 2014 State-Changed-Why: Please update your doc tree, install textproc/docproj and try again. If you still experience troubles, you can look for support on the doc@FreeBSD.org mailing list. Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Wed Jan 22 13:56:32 UTC 2014 Responsible-Changed-Why: Please update your doc tree, install textproc/docproj and try again. If you still experience troubles, you can look for support on the doc@FreeBSD.org mailing list. http://www.freebsd.org/cgi/query-pr.cgi?pr=178677 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 14:35:28 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 2FCB09F2; Wed, 22 Jan 2014 14:35:28 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 016391EC4; Wed, 22 Jan 2014 14:35:28 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0MEZR17080938; Wed, 22 Jan 2014 14:35:27 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0MEZRgt080937; Wed, 22 Jan 2014 14:35:27 GMT (envelope-from gabor) Date: Wed, 22 Jan 2014 14:35:27 GMT Message-Id: <201401221435.s0MEZRgt080937@freefall.freebsd.org> To: cs@FreeBSD.org, gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Subject: Re: docs/184606: Translation of dashes in PDF version X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 14:35:28 -0000 Synopsis: Translation of dashes in PDF version State-Changed-From-To: open->closed State-Changed-By: gabor State-Changed-When: Wed Jan 22 14:35:12 UTC 2014 State-Changed-Why: Fixed, thanks! Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Wed Jan 22 14:35:12 UTC 2014 Responsible-Changed-Why: Fixed, thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=184606 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 14:42:39 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id D45F7CC9; Wed, 22 Jan 2014 14:42:39 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C05F41F7F; Wed, 22 Jan 2014 14:42:39 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s0MEgdCM082803; Wed, 22 Jan 2014 14:42:39 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s0MEgd2o082802; Wed, 22 Jan 2014 14:42:39 GMT (envelope-from gabor) Date: Wed, 22 Jan 2014 14:42:39 GMT Message-Id: <201401221442.s0MEgd2o082802@freefall.freebsd.org> To: aiza21@comclark.com, gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Subject: Re: docs/144515: [handbook] Expand handbook Table of contents X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 14:42:39 -0000 Synopsis: [handbook] Expand handbook Table of contents State-Changed-From-To: open->closed State-Changed-By: gabor State-Changed-When: Wed Jan 22 14:37:11 UTC 2014 State-Changed-Why: Currently, the TOC has three levels: part, chapter and section. I am afraid that expanding more levels would be to verbose and thus affect usability. It is possible to download full PDF or HTML where you can use the search functions. Alternatively, you can use the index, however it needs some impriovements. Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Wed Jan 22 14:37:11 UTC 2014 Responsible-Changed-Why: Currently, the TOC has three levels: part, chapter and section. I am afraid that expanding more levels would be to verbose and thus affect usability. It is possible to download full PDF or HTML where you can use the search functions. Alternatively, you can use the index, however it needs some impriovements. http://www.freebsd.org/cgi/query-pr.cgi?pr=144515 From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 22:18:02 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 58CE9955; Wed, 22 Jan 2014 22:18:02 +0000 (UTC) Received: from smtpin1.utoledo.edu (smtpin1.utoledo.edu [131.183.2.213]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id D7771198D; Wed, 22 Jan 2014 22:18:01 +0000 (UTC) X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AjUBALRC4FKDtwIWl2dsb2JhbABbhBqCfrlzFg4BAQEBAQgWBzyCTxUbOyACBSECEQJMAQwIAQGIAQWnapcohH8XgSmQSYFJBIlHlSKPHIIM X-IronPort-AV: E=Sophos;i="4.95,702,1384318800"; d="scan'208";a="308110849" Received: from dlpint00.utoledo.edu ([131.183.2.22]) by smtpin1.utoledo.edu with ESMTP/TLS/DHE-RSA-AES256-SHA; 22 Jan 2014 17:15:29 -0500 Received: from MSGAPP12.utad.utoledo.edu (msgapp12.utad.utoledo.edu [131.183.3.8]) by dlpint00.utoledo.edu (RSA Interceptor); Wed, 22 Jan 2014 17:15:19 -0500 Received: from [192.168.1.79] (76.238.196.183) by Email.Utoledo.Edu (131.183.3.18) with Microsoft SMTP Server (TLS) id 14.3.169.1; Wed, 22 Jan 2014 17:15:19 -0500 Message-ID: <52E042F5.60008@UToledo.edu> Date: Wed, 22 Jan 2014 17:15:17 -0500 From: Robert Burmeister User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9.2.28) Gecko/20120306 Thunderbird/3.1.20 MIME-Version: 1.0 To: , Subject: Suggest two additions to /usr/src/UPDATING for FreeBSD 10 X-Priority: 1 (Highest) Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: 7bit X-Originating-IP: [76.238.196.183] X-RSA-Inspected: yes X-RSA-Classifications: public X-RSA-Action: allow X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 22:18:02 -0000 Suggest two additions to /usr/src/UPDATING for FreeBSD 10: 1. Note that PKGNG is required in FreeBSD 10, and that functionality of previous port management tools may have change or have been removed. Details of the changed behavior of specific port management tools, when used in conjunction with pkgng, should be noted in /usr/ports/UPDATING. 2. Note that the functionality of /converters/libiconv has been moved into the base system in FreeBSD 10, and that /converters/libiconv should be deinstalled before recompiling all ports after an OS upgrade. From owner-freebsd-doc@FreeBSD.ORG Wed Jan 22 22:20:21 2014 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id A4939CA2; Wed, 22 Jan 2014 22:20:21 +0000 (UTC) Received: from mail0.glenbarber.us (mail0.glenbarber.us [208.86.227.67]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 78EEF19C5; Wed, 22 Jan 2014 22:20:21 +0000 (UTC) Received: from glenbarber.us (c-71-224-221-174.hsd1.nj.comcast.net [71.224.221.174]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: gjb) by mail0.glenbarber.us (Postfix) with ESMTPSA id 1C50BFC92; Wed, 22 Jan 2014 22:20:20 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.8.3 mail0.glenbarber.us 1C50BFC92 Authentication-Results: mail0.glenbarber.us; dkim=none reason="no signature"; dkim-adsp=none Date: Wed, 22 Jan 2014 17:20:18 -0500 From: Glen Barber To: Robert Burmeister Subject: Re: Suggest two additions to /usr/src/UPDATING for FreeBSD 10 Message-ID: <20140122222018.GY35180@glenbarber.us> References: <52E042F5.60008@UToledo.edu> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="hkxLWrKAgbGf75mf" Content-Disposition: inline In-Reply-To: <52E042F5.60008@UToledo.edu> X-Operating-System: FreeBSD 11.0-CURRENT amd64 User-Agent: Mutt/1.5.22 (2013-10-16) Cc: doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Jan 2014 22:20:21 -0000 --hkxLWrKAgbGf75mf Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Jan 22, 2014 at 05:15:17PM -0500, Robert Burmeister wrote: > Suggest two additions to /usr/src/UPDATING for FreeBSD 10: >=20 > 1. Note that PKGNG is required in FreeBSD 10, > and that functionality of previous port management tools may have cha= nge > or have been removed. >=20 > Details of the changed behavior of specific port management tools, > when used in conjunction with pkgng, should be noted in /usr/ports/UP= DATING. >=20 >=20 > 2. Note that the functionality of /converters/libiconv has been moved into > the base system in FreeBSD 10, > and that /converters/libiconv should be deinstalled before recompiling > all ports after an OS upgrade. >=20 Both are documented in /usr/ports/UPDATING. Glen --hkxLWrKAgbGf75mf Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (FreeBSD) iQIcBAEBCAAGBQJS4EQiAAoJELls3eqvi17QHoMP/3284PIhrryYW803qLAm1WzH BOciGOo0WCq77HajjsTkxl5GPcp7ZJikvOXPcbFnf7M8m0aeeHGPKi1aM+vIUXF7 VViSFi97mzxOOPAvwxufS1ozElDDropzfmsHKZHjzzIlbaafYyOmyrinW+ggqolP FSzylrcg3+eFQiix359xWdKBwO6CptUvC33nyf8owRxA5t9d7wrV1nXLUaTma5SF 1xDftxxoSGatiHmWviHKYD/mBpppeh894uQIQvwFGTJoIB+d743Eak0WDEC9UZKI ddHhFT0Dw5DTg49Dd5PpXeMkSttwaxobWGRt8jRrk4/fPj8cvrTErpjz2+a49WVa FN7Jy4hh3VSqu34RAHhv59vPb7HY1A9mR91aapPPVC8WRMeiPcmsbWdLTyjvKexX yonXSbgz/RSUToquFArl3bHKT+McXpduFYVvzyGDms3XORWsGzsLrkCf9l6Of99x MA7KRHRx0UbyTj+7rltP17arRxdb9nyEVqiGR6A5pKWqNVVZpeGvJR3J4SY2jOMB dqM1yY1lA+UeloeAisZEpcBgFnHeDeF3uTkbhHXc8q1KLCP67W8F+dQcgG3m9Mgv ESvqVZNfSkO00O8eei5cR1Sv+N1j09zXH9k9UOa8DDTBDosANn5Pb73pMjEmdZVc Fj6cINZ0a6UkfxJXbkQx =Nykm -----END PGP SIGNATURE----- --hkxLWrKAgbGf75mf-- From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 01:53:35 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 85CD32BF; Thu, 23 Jan 2014 01:53:35 +0000 (UTC) Received: from relay.mailchannels.net (si-004-i103.relay.mailchannels.net [198.20.121.20]) by mx1.freebsd.org (Postfix) with ESMTP id B1E821D39; Thu, 23 Jan 2014 01:53:32 +0000 (UTC) X-Sender-Id: _forwarded-from|111.125.78.19 Received: from mail-24.name-services.com (ip-10-244-196-74.us-west-2.compute.internal [10.244.196.74]) by relay.mailchannels.net (Postfix) with ESMTPA id B4CA8605CE; Thu, 23 Jan 2014 01:53:23 +0000 (UTC) X-Sender-Id: _forwarded-from|111.125.78.19 Received: from mail-24.name-services.com (mail-24.name-services.com [10.246.16.22]) (using TLSv1 with cipher AES128-SHA) by 0.0.0.0:2500 (trex/5.0.19); Thu, 23 Jan 2014 01:53:24 GMT X-MC-Relay: Forwarding X-MailChannels-SenderId: _forwarded-from%7C111.125.78.19 X-MailChannels-Auth-Id: demandmedia Received: from [192.168.111.121] (UnknownHost [111.125.78.19]) by mail-24.name-services.com with SMTP; Wed, 22 Jan 2014 17:53:15 -0800 Message-ID: <52E075F7.7020105@a1poweruser.com> Date: Thu, 23 Jan 2014 09:52:55 +0800 From: Fbsd8 User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: gabor@FreeBSD.org Subject: Re: docs/144515: [handbook] Expand handbook Table of contents References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> In-Reply-To: <201401221442.s0MEgd2o082802@freefall.freebsd.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 01:53:35 -0000 gabor@FreeBSD.org wrote: > Synopsis: [handbook] Expand handbook Table of contents > > State-Changed-From-To: open->closed > State-Changed-By: gabor > State-Changed-When: Wed Jan 22 14:37:11 UTC 2014 > State-Changed-Why: > Currently, the TOC has three levels: part, chapter and section. I am afraid > that expanding more levels would be to verbose and thus affect usability. > It is possible to download full PDF or HTML where you can use the search > functions. Alternatively, you can use the index, however it needs some > impriovements. > > > Responsible-Changed-From-To: freebsd-doc->gabor > Responsible-Changed-By: gabor > Responsible-Changed-When: Wed Jan 22 14:37:11 UTC 2014 > Responsible-Changed-Why: > Currently, the TOC has three levels: part, chapter and section. I am afraid > that expanding more levels would be to verbose and thus affect usability. > It is possible to download full PDF or HTML where you can use the search > functions. Alternatively, you can use the index, however it needs some > impriovements. > > http://www.freebsd.org/cgi/query-pr.cgi?pr=144515 I don't think you read or understood the pr. All the sub-sections are not findable, meaning there hidden. Expanding the TOC just one more level to include the sub-sections is required to make the complete contents accessible from the TOC just like any other professionally published book. I though the goal of the handbook was to be usable and here we have our main documentation looking like something created by people who don't even know the normal standard parts of a published document or the professional way to organize content. Closing this pr with the suggestion that users should use some other method to search the handbook is just ludicrous and sounds like it's nothing but a effort to shorten the open doc pr list with the least amount of work. What every happened to one's pride in one's workmanship? After the FreeBSD website isn't the handbook the second most accessed element of the FreeBSD world seen by the public? The image and reputation of FreeBSD are at stake here. This pr is very important in modernizing the handbook and should have bee opened up for discussion among all the doc members and only closed by agreement of the doc team and not out of hand by someone who in my opinion is misusing their commit privileges in this case. From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 02:00:33 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id AD0C238E; Thu, 23 Jan 2014 02:00:33 +0000 (UTC) Received: from mail0.glenbarber.us (mail0.glenbarber.us [IPv6:2607:fc50:1:2300:1001:1001:1001:face]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 7F9171D71; Thu, 23 Jan 2014 02:00:33 +0000 (UTC) Received: from glenbarber.us (c-71-224-221-174.hsd1.nj.comcast.net [71.224.221.174]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) (Authenticated sender: gjb) by mail0.glenbarber.us (Postfix) with ESMTPSA id 71D03113B8; Thu, 23 Jan 2014 02:00:31 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.8.3 mail0.glenbarber.us 71D03113B8 Authentication-Results: mail0.glenbarber.us; dkim=none reason="no signature"; dkim-adsp=none Date: Wed, 22 Jan 2014 21:00:29 -0500 From: Glen Barber To: Fbsd8 Subject: Re: docs/144515: [handbook] Expand handbook Table of contents Message-ID: <20140123020029.GE52955@glenbarber.us> References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="Dzs2zDY0zgkG72+7" Content-Disposition: inline In-Reply-To: <52E075F7.7020105@a1poweruser.com> X-Operating-System: FreeBSD 11.0-CURRENT amd64 User-Agent: Mutt/1.5.22 (2013-10-16) Cc: freebsd-doc@FreeBSD.org, gabor@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 02:00:33 -0000 --Dzs2zDY0zgkG72+7 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Jan 23, 2014 at 09:52:55AM +0800, Fbsd8 wrote: > I though the goal of the handbook was to be usable and here we have our m= ain > documentation looking like something created by people who don't even know > the normal standard parts of a published document or the professional way= to > organize content. >=20 Your insults are not appreciated. Please reconsider your response, and if you feel there is still a concern, reply in a professional, non-insulting manner. Glen --Dzs2zDY0zgkG72+7 Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (FreeBSD) iQIcBAEBCAAGBQJS4He9AAoJELls3eqvi17QtQEP/A14GgKk9BKC28xgm/Lxs+aN ZbRRlUk66PcLrf6BeSqsE2XtZQvO50rGKKpm55RhZTf6e6QAOacPqxL7WLnj22Tf 0RcARiXfsmcTqS+NrwekYMWF3sp4sX1Zd1eqy68B4q86pPnzWYS5+9arlkU2WbHQ 2y96YvFEL9NMjHoGCBJ4SixPRu2fQlXsJFfyBwk3/J3dkilVvU+peFUllJzPNnX8 WWDuPehyxEj24VUGTdlpoIe6UXvLffICQsoBWLeHEN4cSeRrNTM/efsix//cthdu VXfGSXg4dNzmBBIVXl1Cqlb+yqSGmM0lb5UA6tfEFjfraD0TvIKKIy4B+17TyoYG yXfcBMT+TxcMuUFfPjJl36busIKuxJXH8b5XesitCHZosGunM6H4CS2ZCLaTVp9x XCio8enWvr52kdGa/UeVltHZ0qctk9nQvApB8KWKl6rjxVAmLTVoB8OsuiQ9zIwP oxe3wRkp6AQOPFoMaWxqu3iU2AARl710ig5lcgJFjB6OxCwavqhDlC1wnu5rUAr7 toxRv0Tuk3xxDf7gU1gJdsuDOr7Bacrq4BH2AlXH2zpJZfeXp+zigiQ8AJS6zKbZ BBxQkKSgKTI4IvHH/wlDYsmrObwGXck6O94aWAaBHqHQM7WGe3++2EY3t6ecPMHA TPjkyHhFtzZw+i6sDxY/ =sVui -----END PGP SIGNATURE----- --Dzs2zDY0zgkG72+7-- From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 09:08:50 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 23587639 for ; Thu, 23 Jan 2014 09:08:50 +0000 (UTC) Received: from mail-yk0-x245.google.com (mail-yk0-x245.google.com [IPv6:2607:f8b0:4002:c07::245]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id DD7B61532 for ; Thu, 23 Jan 2014 09:08:49 +0000 (UTC) Received: by mail-yk0-f197.google.com with SMTP id 20so6122945yks.0 for ; Thu, 23 Jan 2014 01:08:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=BDRPN8VrTKH3ZiBC2YkpwW2sGmpSqvLebm8AGmSfZR0=; b=OZOqt1AZcY7DD9SIDUWhKzaSIEyPJ5XbODP3ag30AP6ork4RYEw2Nf6AYE3P7hNAbr /MF72EX8Wzau+b4SzblEa/Q+2V7oUmVAAxIJlij7dSd/N2c9r90gsSfhjbLpvIvVmLU+ Od3zE3iw9xveqn7859gqaVWMa+aXq7+PH4CjVxpNoq7bqTe4jqE/ZC9WAdLHUAudHDP0 umMSvpvV/IxVZLosyTNnMvp2R/gFG5V9eGv+xJTWeh76hcawuLYVeNEVLhnZjzw/Oc3+ /a0okwZE5010DVeUNtoZTBBmZ07c2dw2TyOcRCPPu8ANaHn+j0kLZf+EweNTrQDApYbI AUog== MIME-Version: 1.0 X-Received: by 10.236.137.12 with SMTP id x12mr2346294yhi.17.1390468129098; Thu, 23 Jan 2014 01:08:49 -0800 (PST) Message-ID: <20cf30363713e811bd04f09f96d8@google.com> Date: Thu, 23 Jan 2014 09:08:49 +0000 Subject: www.freebsd.org From: Amus Leung To: doc@freebsd.org Content-Type: text/plain; charset=windows-1252; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 09:08:50 -0000 PGRpdiBkaXI9Imx0ciI+PHA+SGksPC9wPjxkaXY+PHA+SSB3YW50ZWQgdG8gc2VuZCB5b3UgYSBx dWljayBub3RlLiBXaXRoIGEgIA0KZmV3IHNpbXBsZSBjaGFuZ2VzIHRvIG1ha2UgeW91ciBzaXRl IG1vcmUgU0VPLWZyaWVuZGx5IEmSbSBzdXJlIHlvdSBjYW4gIA0KY29udmVydCBtb3JlIHZpc2l0 b3JzIGludG8gbGVhZHMgYW5kIGdldCBpdCBwbGFjZWQgaGlnaGVyIGluIHRoZSBvcmdhbmljICAN CnNlYXJjaCByZXN1bHRzLCBmb3Iga2V5d29yZHMgdGhhdCBtYXR0ZXIgdG8geW91IHRoZSBtb3N0 LjwvcD4NCg0KPC9kaXY+PGRpdj48cD5XZSBhcmUgYSBMb2NhbCBiYXNlZCBjb21wYW55IHdpdGgg Z3JlYXQgaW4taG91c2UgdGVjaG5pY2FsICANCnRlYW0gd2hvIHJlYWxseSBrbm93IHRoZWlyIHN0 dWZmIGFib3V0IHNlYXJjaCBlbmdpbmUgIA0Kb3B0aW1pemF0aW9uLqA8L3A+PC9kaXY+PHA+V291 bGQgeW91IGxpa2UgYSBiaXQgbW9yZSBpbmZvcm1hdGlvbiBhYm91dCBob3cgIA0KdG8gZ2l2ZSB5 b3VyIHdlYnNpdGUgYSBib29zdCB3aXRoIGJldHRlciBTRU8/PC9wPg0KDQo8cD5CZXN0IHJlZ2Fy ZHMsPC9wPjxwPjxzcGFuIHN0eWxlPSJmb250LWZhbWlseTomIzM5O2Jvb2sgIA0KYW50aXF1YSYj Mzk7LHBhbGF0aW5vO2NvbG9yOnJnYigxMzYsMTM2LDEzNikiPjxmb250IHNpemU9IjQiPkFtdXMg IA0KTGV1bmc8L2ZvbnQ+PGJyPjxzcGFuICANCnN0eWxlPSJjb2xvcjpyZ2IoMCwwLDApO2ZvbnQt ZmFtaWx5OmFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTp4eC1zbWFsbCI+U0VP L1dFQiAgDQpTcGVjaWFsaXN0PC9zcGFuPjwvc3Bhbj48L3A+DQoNCjx0YWJsZSBzdHlsZT0ibWFy Z2luLWxlZnQ6YXV0bzttYXJnaW4tcmlnaHQ6YXV0byIgIA0KYm9yZGVyPSIwIj48dGJvZHk+PHRy Pjx0ZD6goKCgoKCgoKCgPC90ZD48dGQgIA0Kc3R5bGU9ImJhY2tncm91bmQtY29sb3I6cmdiKDcy LDExNCwyMzMpIj48Yj6gPC9iPqA8c3BhbiAgDQpzdHlsZT0iZm9udC1mYW1pbHk6JiMzOTt0aW1l cyBuZXcgIA0Kcm9tYW4mIzM5Oyx0aW1lcztmb250LXNpemU6bGFyZ2U7Y29sb3I6cmdiKDI1NSwy NTUsMjU1KSI+Uzwvc3Bhbj48Yj6goDwvYj48L3RkPg0KDQo8dGQgc3R5bGU9ImJhY2tncm91bmQt Y29sb3I6cmdiKDI1NSwwLDUxKSI+oDxzcGFuICANCnN0eWxlPSJmb250LWZhbWlseTomIzM5O3Rp bWVzIG5ldyByb21hbiYjMzk7LHRpbWVzO2ZvbnQtc2l6ZTpsYXJnZSI+PHNwYW4gIA0Kc3R5bGU9 ImZvbnQtc2l6ZTp4LWxhcmdlO2NvbG9yOnJnYigyNTUsMjU1LDI1NSkiPkU8L3NwYW4+oDwvc3Bh bj48L3RkPjx0ZCAgDQpzdHlsZT0iYmFja2dyb3VuZC1jb2xvcjpyZ2IoMTAxLDIzNSwxOSkiPg0K DQo8c3BhbiBzdHlsZT0iZm9udC1zaXplOmxhcmdlO2NvbG9yOnJnYigyNTUsMjU1LDI1NSk7Zm9u dC1mYW1pbHk6JiMzOTt0aW1lcyAgDQpuZXcgcm9tYW4mIzM5Oyx0aW1lcyI+oE+gPC9zcGFuPjwv dGQ+PHRkICANCnN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+oKCgIKAgoCCgIKA8L3RkPjwvdHI+ PHRyPjx0ZCBjb2xzcGFuPSI1IiAgDQpzdHlsZT0iYmFja2dyb3VuZC1jb2xvcjpyZ2IoMCwwLDAp O3RleHQtYWxpZ246Y2VudGVyIj4NCg0KPGI+PHNwYW4gIA0Kc3R5bGU9ImZvbnQtZmFtaWx5OnRh aG9tYSxhcmlhbCxoZWx2ZXRpY2Esc2Fucy1zZXJpZjtjb2xvcjpyZ2IoMjU1LDI1NSwyNTUpIj5T ZWFyY2ggIA0KRW5naW5lIE9wdGltaXphdGlvbjwvc3Bhbj48L2I+PC90ZD48L3RyPjwvdGJvZHk+ PC90YWJsZT48cCAgDQpzdHlsZT0idGV4dC1hbGlnbjpjZW50ZXIiPjxzcGFuICANCnN0eWxlPSJm b250LWZhbWlseTphcmlhbCxoZWx2ZXRpY2Esc2Fucy1zZXJpZjtmb250LXNpemU6eHgtc21hbGw7 Y29sb3I6cmdiKDEzNiwxMzYsMTM2KSI+V2UgIA0KcmVzcGVjdCB5b3VyIHByaXZhY3kgYW5kIHdh bnQgdG8gbWFrZSBzdXJlIHlvdSBhcmUgYXdhcmUgb2YgYSBmZXcgdGhpbmdzLiAgDQpCeSByZXBs eWluZyB0byB0aGlzIGVtYWlsLCB5b3UgYXV0aG9yaXplIG91ciBIb25nIEtvbmcgYWZmaWxpYXRl cyB0aGF0IGNhbiAgDQpoZWxwIHdpdGggeW91ciBwcm9qZWN0IHRvIGNhbGwgeW91IGF0IHRoZSBu dW1iZXIgeW91IHByb3ZpZGVkLCBhbmQgeW91ICANCnVuZGVyc3RhbmQgdGhhdCB0aGV5IG1heSB1 c2UgYXV0b21hdGVkIHBob25lIHRlY2hub2xvZ3kgdG8gY2FsbCB5b3UuIEF0IG5vICANCnRpbWUg YXJlIHlvdSByZXF1aXJlZCB0byBtYWtlIGEgcHVyY2hhc2UuPC9zcGFuPjwvcD4NCg0KPGRpdiBz dHlsZT0idGV4dC1hbGlnbjpjZW50ZXIiPjxzcGFuICANCnN0eWxlPSJmb250LWZhbWlseTphcmlh bCxoZWx2ZXRpY2Esc2Fucy1zZXJpZjtmb250LXNpemU6eHgtc21hbGw7Y29sb3I6cmdiKDEzNiwx MzYsMTM2KSI+VW5zdWJzY3JpYmU8L3NwYW4+PC9kaXY+PC9kaXY+DQo= From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 09:12:41 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 52EC66C5 for ; Thu, 23 Jan 2014 09:12:41 +0000 (UTC) Received: from mail-yk0-x246.google.com (mail-yk0-x246.google.com [IPv6:2607:f8b0:4002:c07::246]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 18CEC15BF for ; Thu, 23 Jan 2014 09:12:41 +0000 (UTC) Received: by mail-yk0-f198.google.com with SMTP id 131so6160529ykp.1 for ; Thu, 23 Jan 2014 01:12:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=aXxAof+aep2OMN/nSv+rTTJZIE5hOmzm/NEoyOwzr/c=; b=QIg/21IEwJKfHvoJFZF860siSzr+lqN+aW5IqmknRILE/M2y1jh2g7jY5QcK/TXPJY hUNtvUE1JVGjGm+/Fk5a3/IXiM14mWhR/dJz94+OZTnHcAhv2qG5OI6Amocx7xwj2KPa 8+vAF2hh71wgbPgr8dP9v+k/qf+3ZoYnyB2MTRUcAseZZmy3fzhA7ubRWBcOlDAnNrJj p/UU+Ndzw/SApKckMEnIa2eexhL1cyYNrUL7gXRfD9K/iphL2YqFizVUFWwm2dHXiV64 GvJJAVQw28mpCjnJkAqQO4Cw6Qi7sFmqRFsG/kZy/65n2vDdpVgL6J5KiJTA/rcopkVi mrpA== MIME-Version: 1.0 X-Received: by 10.236.204.42 with SMTP id g30mr2437614yho.54.1390468360214; Thu, 23 Jan 2014 01:12:40 -0800 (PST) Message-ID: Date: Thu, 23 Jan 2014 09:12:40 +0000 Subject: www.freebsd.org From: Mayleen Ying To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=windows-1252; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 09:12:41 -0000 PGRpdiBkaXI9Imx0ciI+PHA+SGksPC9wPjxkaXY+PHA+SSB3YW50ZWQgdG8gc2VuZCB5b3UgYSBx dWljayBub3RlLiBXaXRoIGEgIA0KZmV3IHNpbXBsZSBjaGFuZ2VzIHRvIG1ha2UgeW91ciBzaXRl IG1vcmUgU0VPLWZyaWVuZGx5IEmSbSBzdXJlIHlvdSBjYW4gIA0KY29udmVydCBtb3JlIHZpc2l0 b3JzIGludG8gbGVhZHMgYW5kIGdldCBpdCBwbGFjZWQgaGlnaGVyIGluIHRoZSBvcmdhbmljICAN CnNlYXJjaCByZXN1bHRzLCBmb3Iga2V5d29yZHMgdGhhdCBtYXR0ZXIgdG8geW91IHRoZSBtb3N0 LjwvcD4NCg0KPC9kaXY+PGRpdj48cD5XZSBhcmUgYSBMb2NhbCBiYXNlZCBjb21wYW55IHdpdGgg Z3JlYXQgaW4taG91c2UgdGVjaG5pY2FsICANCnRlYW0gd2hvIHJlYWxseSBrbm93IHRoZWlyIHN0 dWZmIGFib3V0IHNlYXJjaCBlbmdpbmUgIA0Kb3B0aW1pemF0aW9uLqA8L3A+PC9kaXY+PHA+V291 bGQgeW91IGxpa2UgYSBiaXQgbW9yZSBpbmZvcm1hdGlvbiBhYm91dCBob3cgIA0KdG8gZ2l2ZSB5 b3VyIHdlYnNpdGUgYSBib29zdCB3aXRoIGJldHRlciBTRU8/PC9wPg0KDQo8cD5CZXN0IHJlZ2Fy ZHMsPC9wPjxwPjxzcGFuIHN0eWxlPSJmb250LWZhbWlseTomIzM5O2Jvb2sgIA0KYW50aXF1YSYj Mzk7LHBhbGF0aW5vO2NvbG9yOnJnYigxMzYsMTM2LDEzNikiPjxmb250IHNpemU9IjQiPk1heWxl ZW4gIA0KWWluZzwvZm9udD48YnI+PHNwYW4gIA0Kc3R5bGU9ImNvbG9yOnJnYigwLDAsMCk7Zm9u dC1mYW1pbHk6YXJpYWwsaGVsdmV0aWNhLHNhbnMtc2VyaWY7Zm9udC1zaXplOnh4LXNtYWxsIj5T RU8vV0VCICANClNwZWNpYWxpc3Q8L3NwYW4+PC9zcGFuPjwvcD4NCg0KPHRhYmxlIHN0eWxlPSJt YXJnaW4tbGVmdDphdXRvO21hcmdpbi1yaWdodDphdXRvIiAgDQpib3JkZXI9IjAiPjx0Ym9keT48 dHI+PHRkPqCgoKCgoKCgoKA8L3RkPjx0ZCAgDQpzdHlsZT0iYmFja2dyb3VuZC1jb2xvcjpyZ2Io NzIsMTE0LDIzMykiPjxiPqA8L2I+oDxzcGFuICANCnN0eWxlPSJmb250LWZhbWlseTomIzM5O3Rp bWVzIG5ldyAgDQpyb21hbiYjMzk7LHRpbWVzO2ZvbnQtc2l6ZTpsYXJnZTtjb2xvcjpyZ2IoMjU1 LDI1NSwyNTUpIj5TPC9zcGFuPjxiPqCgPC9iPjwvdGQ+DQoNCjx0ZCBzdHlsZT0iYmFja2dyb3Vu ZC1jb2xvcjpyZ2IoMjU1LDAsNTEpIj6gPHNwYW4gIA0Kc3R5bGU9ImZvbnQtZmFtaWx5OiYjMzk7 dGltZXMgbmV3IHJvbWFuJiMzOTssdGltZXM7Zm9udC1zaXplOmxhcmdlIj48c3BhbiAgDQpzdHls ZT0iZm9udC1zaXplOngtbGFyZ2U7Y29sb3I6cmdiKDI1NSwyNTUsMjU1KSI+RTwvc3Bhbj6gPC9z cGFuPjwvdGQ+PHRkICANCnN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOnJnYigxMDEsMjM1LDE5KSI+ DQoNCjxzcGFuIHN0eWxlPSJmb250LXNpemU6bGFyZ2U7Y29sb3I6cmdiKDI1NSwyNTUsMjU1KTtm b250LWZhbWlseTomIzM5O3RpbWVzICANCm5ldyByb21hbiYjMzk7LHRpbWVzIj6gT6A8L3NwYW4+ PC90ZD48dGQgIA0Kc3R5bGU9InRleHQtYWxpZ246Y2VudGVyIj6goKAgoCCgIKAgoDwvdGQ+PC90 cj48dHI+PHRkIGNvbHNwYW49IjUiICANCnN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOnJnYigwLDAs MCk7dGV4dC1hbGlnbjpjZW50ZXIiPg0KDQo8Yj48c3BhbiAgDQpzdHlsZT0iZm9udC1mYW1pbHk6 dGFob21hLGFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2NvbG9yOnJnYigyNTUsMjU1LDI1NSki PlNlYXJjaCAgDQpFbmdpbmUgT3B0aW1pemF0aW9uPC9zcGFuPjwvYj48L3RkPjwvdHI+PC90Ym9k eT48L3RhYmxlPjxwICANCnN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+PHNwYW4gIA0Kc3R5bGU9 ImZvbnQtZmFtaWx5OmFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTp4eC1zbWFs bDtjb2xvcjpyZ2IoMTM2LDEzNiwxMzYpIj5XZSAgDQpyZXNwZWN0IHlvdXIgcHJpdmFjeSBhbmQg d2FudCB0byBtYWtlIHN1cmUgeW91IGFyZSBhd2FyZSBvZiBhIGZldyB0aGluZ3MuICANCkJ5IHJl cGx5aW5nIHRvIHRoaXMgZW1haWwsIHlvdSBhdXRob3JpemUgb3VyIEhvbmcgS29uZyBhZmZpbGlh dGVzIHRoYXQgY2FuICANCmhlbHAgd2l0aCB5b3VyIHByb2plY3QgdG8gY2FsbCB5b3UgYXQgdGhl IG51bWJlciB5b3UgcHJvdmlkZWQsIGFuZCB5b3UgIA0KdW5kZXJzdGFuZCB0aGF0IHRoZXkgbWF5 IHVzZSBhdXRvbWF0ZWQgcGhvbmUgdGVjaG5vbG9neSB0byBjYWxsIHlvdS4gQXQgbm8gIA0KdGlt ZSBhcmUgeW91IHJlcXVpcmVkIHRvIG1ha2UgYSBwdXJjaGFzZS48L3NwYW4+PC9wPg0KDQo8ZGl2 IHN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+PHNwYW4gIA0Kc3R5bGU9ImZvbnQtZmFtaWx5OmFy aWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTp4eC1zbWFsbDtjb2xvcjpyZ2IoMTM2 LDEzNiwxMzYpIj5VbnN1YnNjcmliZTwvc3Bhbj48L2Rpdj48L2Rpdj4NCg== From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 11:17:47 2014 Return-Path: Delivered-To: www@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 56E3CFB2 for ; Thu, 23 Jan 2014 11:17:47 +0000 (UTC) Received: from mail-ob0-x247.google.com (mail-ob0-x247.google.com [IPv6:2607:f8b0:4003:c01::247]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 2333B116B for ; Thu, 23 Jan 2014 11:17:47 +0000 (UTC) Received: by mail-ob0-f199.google.com with SMTP id vb8so6044111obc.10 for ; Thu, 23 Jan 2014 03:17:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=L6qrfZq+tW1tPdfluxevWE9IR7phLH6SJkSaNY+jXho=; b=vDzhWiVLQ5wD7sJItfjstWEgCIsAKmBPK4B5Hn8mpBwgMdr2h9knmSadP0rD17PUF8 y0EeAiaWs9PNtzi4fdXNrE01SoPVm6TX72jcTGgr6oa6p5vHJk4eAzjRL/yvOFk1ZjaG GSjNAs5eQ768MthNQ+bdMvFJXsmYVbV3oX42GPuzY2PhvBX8J8/hNStKYPyG7nClaLeS lHVb9QuaGiPvHDkCVvJlI3yDbeGX5I5ZzlthX3DeRCFtKY98U+xLxAMChZF/Hw2P2Wga ybaY8Vie2URuDRz3N21JYiUG8gHNXCO350ZuLsajCtdXttQlQuAvMI/GS4vYDoCtudpZ mwDQ== MIME-Version: 1.0 X-Received: by 10.50.67.70 with SMTP id l6mr3456278igt.3.1390475866411; Thu, 23 Jan 2014 03:17:46 -0800 (PST) Message-ID: <047d7bd767c0161be504f0a164c4@google.com> Date: Thu, 23 Jan 2014 11:17:46 +0000 Subject: www.freebsd.org From: Anna Garcia To: www@freebsd.org Content-Type: text/plain; charset=UTF-8; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 11:17:47 -0000 DQoNCg0KDQoNCg0KDQoNCg0KSGkNCg0KDQoNCkkgZm91bmQgeW91ciBjb250YWN0IG92ZXIgdGhl IHdlYiBhbmQgd2FudGVkIHRvIHNob290IHlvdSBhIHF1aWNrIG5vdGUuDQoNCg0KDQpXaXRoIFNl YXJjaCBFbmdpbmUgT3B0aW1pemF0aW9uIChTRU8pIGFuZCBXZWIgRGV2ZWxvcG1lbnQsIEkgY2Fu IGhlbHAgeW91cg0KYnVzaW5lc3MgYWNoaWV2ZSBiZXR0ZXIgcmFua2luZyBvbiBwcm9taW5lbnQg c2VhcmNoIGVuZ2luZXMgbGlrZSBHb29nbGUsDQpCaW5nICYgb3RoZXJzIHRvIGdlbmVyYXRlIG1v cmUgbGVhZHMvc2FsZXMgKE5vIE9mZmVuc2U6IFNFTyBpcyB0aGUgcHJvY2Vzcw0Kb2YgYWZmZWN0 aW5nIHRoZSB2aXNpYmlsaXR5IG9mIGEgd2Vic2l0ZSBvciBhIHdlYiBwYWdlIGluIGEgc2VhcmNo IGVuZ2luZSdzDQoibmF0dXJhbCIgb3IgdW4tcGFpZCAib3JnYW5pYyIgc2VhcmNoIHRocm91Z2gg aW5kZXhpbmcsIHByZXZlbnRpbmcgY3Jhd2xpbmcNCiYgaW5jcmVhc2luZyBwcm9taW5lbmNlKQ0K DQoNCg0KVGhpcyBtYXkgbG9vayBsaWtlIG9uZSBvZiB0aG9zZSBzcHVyaW91cyBmb3JlaWduIGVt YWlscyB5b3UgZ2V0IGluIHlvdXINCmluYm94IGV2ZXJ5IGRheSB0aGF0IHByb21pc2UgYmlnIGJ1 dCBkZWxpdmVycyBub3RoaW5nLiBKdXN0IHRvIGJlIHVwZnJvbnQNCndlIGFyZSBoYXBweSB0byBk aXNjdXNzIHlvdXIgcmVxdWlyZW1lbnQgZnJlZSBvZiBjb3N0Lg0KDQoNCg0KU28sIGxldCBtZSBr bm93IGlmIHlvdSBhcmUgaW50ZXJlc3RlZCBpbiByZWNlaXZpbmcgZnVydGhlcg0KaW5mb3JtYXRp b24vcXVvdGUgd2l0aCBubyBzdHJpbmdzIGF0dGFjaGVkIGZyb20gb3VyIHRlYW0gb2YgU0VPICYg V2ViDQpleHBlcnRzICYgaWYgeW91IGFyZSBhbGwgb2sgdGhhbiBzaW1wbHkgcmVwbHkgd2l0aCBh biDigJxVTlNVQlNDUklCReKAnSBoZWFkZXINCmFuZCBJIHByb21pc2Ugbm90IHRvIHdhc3RlIHlv dXIgdGltZSBldmVyIGFnYWluIChraW5kIGFwb2xvZ3kpLg0KDQoNCg0KVGhhbmsgeW91IGFuZCBo YXZlIGEgbmljZSBkYXkuDQoNCg0KQmVzdCBSZWdhcmRzLA0KDQoqQW5uYSBHYXJjaWEqDQpPbmxp bmUgTWFya2V0aW5nIFNwZWNpYWxpc3QNCg0KKsWgKirDiSoqw5YqDQo= From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 12:04:52 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 29808CE0; Thu, 23 Jan 2014 12:04:52 +0000 (UTC) Received: from relay.mailchannels.net (si-004-i104.relay.mailchannels.net [198.20.121.21]) by mx1.freebsd.org (Postfix) with ESMTP id 8EED915E5; Thu, 23 Jan 2014 12:04:48 +0000 (UTC) X-Sender-Id: _forwarded-from|111.125.78.19 Received: from mail-24.name-services.com (ip-10-227-128-69.us-west-2.compute.internal [10.227.128.69]) by relay.mailchannels.net (Postfix) with ESMTPA id 8B73E606A3; Thu, 23 Jan 2014 12:04:39 +0000 (UTC) X-Sender-Id: _forwarded-from|111.125.78.19 Received: from mail-24.name-services.com (mail-24.name-services.com [10.248.1.104]) (using TLSv1 with cipher AES128-SHA) by 0.0.0.0:2500 (trex/5.0.19); Thu, 23 Jan 2014 12:04:40 GMT X-MC-Relay: Forwarding X-MailChannels-SenderId: _forwarded-from%7C111.125.78.19 X-MailChannels-Auth-Id: demandmedia Received: from [192.168.111.121] (UnknownHost [111.125.78.19]) by mail-24.name-services.com with SMTP; Thu, 23 Jan 2014 04:04:33 -0800 Message-ID: <52E1053A.8000608@a1poweruser.com> Date: Thu, 23 Jan 2014 20:04:10 +0800 From: Fbsd8 User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: Glen Barber Subject: Re: docs/144515: [handbook] Expand handbook Table of contents References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> In-Reply-To: <20140123020029.GE52955@glenbarber.us> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, gabor@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 12:04:52 -0000 Glen Barber wrote: > On Thu, Jan 23, 2014 at 09:52:55AM +0800, Fbsd8 wrote: >> I though the goal of the handbook was to be usable and here we have our main >> documentation looking like something created by people who don't even know >> the normal standard parts of a published document or the professional way to >> organize content. >> > > Your insults are not appreciated. > > Please reconsider your response, and if you feel there is still > a concern, reply in a professional, non-insulting manner. > > Glen > Well Glen what you consider insulting I consider frank and to the point. Since when do people have to accept your censorship? There is no censorship on any of the FreeBSD lists so quite trying to force your personal old fashioned thin skinned attitudes on the members of this list. I find your remarks to be insulting and totally out of place. And as usual you remove from the post the text that explains that statement so you can take it out of context. shame on you, you should know better, you have been called on this before. Any future reply to this thread by you will go unanswered by me for I will not lower myself to your level. From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 12:37:42 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 0E48C763; Thu, 23 Jan 2014 12:37:42 +0000 (UTC) Received: from mail.jr-hosting.nl (mail.jr-hosting.nl [IPv6:2a01:4f8:141:5ffd::25]) by mx1.freebsd.org (Postfix) with ESMTP id 91F1C18C9; Thu, 23 Jan 2014 12:37:41 +0000 (UTC) Received: from scn-lan63.snowcn.snow.nl (gw.snow.nl [213.154.248.74]) by mail.jr-hosting.nl (Postfix) with ESMTPSA id E52EB3F629; Thu, 23 Jan 2014 13:37:38 +0100 (CET) Content-Type: multipart/signed; boundary="Apple-Mail=_DB61AD6C-ED0A-4EEF-9159-539B7C22274E"; protocol="application/pgp-signature"; micalg=pgp-sha1 Mime-Version: 1.0 (Mac OS X Mail 7.1 \(1827\)) Subject: Re: docs/144515: [handbook] Expand handbook Table of contents From: Remko Lodder In-Reply-To: <52E1053A.8000608@a1poweruser.com> Date: Thu, 23 Jan 2014 13:37:37 +0100 Message-Id: <834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org> References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> <52E1053A.8000608@a1poweruser.com> To: Fbsd8 X-Mailer: Apple Mail (2.1827) Cc: Glen Barber , freebsd-doc@FreeBSD.org, Gabor Kovesdan X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 12:37:42 -0000 --Apple-Mail=_DB61AD6C-ED0A-4EEF-9159-539B7C22274E Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=windows-1252 On 23 Jan 2014, at 13:04, Fbsd8 wrote: > Glen Barber wrote: >> On Thu, Jan 23, 2014 at 09:52:55AM +0800, Fbsd8 wrote: >>> I though the goal of the handbook was to be usable and here we have = our main >>> documentation looking like something created by people who don't = even know >>> the normal standard parts of a published document or the = professional way to >>> organize content. >>>=20 >> Your insults are not appreciated. >> Please reconsider your response, and if you feel there is still >> a concern, reply in a professional, non-insulting manner. >> Glen >=20 > Well Glen what you consider insulting I consider frank and to the = point. Since when do people have to accept your censorship? There is no = censorship on any of the FreeBSD lists so quite trying to force your = personal old fashioned thin skinned attitudes on the members of this = list. I find your remarks to be insulting and totally out of place. And = as usual you remove from the post the text that explains that statement = so you can take it out of context. shame on you, you should know better, = you have been called on this before. Any future reply to this thread by = you will go unanswered by me for I will not lower myself to your level. Thank you for proving Glen=92s point. Please move along now, nothing to = see here. >=20 > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" --=20 /"\ Best regards, | remko@FreeBSD.org \ / Remko Lodder | remko@EFnet X http://www.evilcoder.org/ | / \ ASCII Ribbon Campaign | Against HTML Mail and News --Apple-Mail=_DB61AD6C-ED0A-4EEF-9159-539B7C22274E Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=signature.asc Content-Type: application/pgp-signature; name=signature.asc Content-Description: Message signed with OpenPGP using GPGMail -----BEGIN PGP SIGNATURE----- Comment: GPGTools - http://gpgtools.org iQIcBAEBAgAGBQJS4Q0RAAoJEKjD27JZ84ywFcsP/RTWWTlzlT5xjci2U1w+mK5z 1Y12kClI2Cg4qLySIohlfVRFssqd41L6cvI3jPUb76UvgzHSHfJTbAb1Ozbq+Oxl a02Et0v9EEBBdTO+wnuLA9BKsOUZAPrN6GdOrAzlPcV6iUZU6juM4oSuZ25WX6fi o/Qs4NGzVTjdbRKo0JylHOXEjLF900XFnmXO8HGLOOlCt0K2w4XU8YqW2Y1ZkqRM BWmURRr7ZCcRTbbvYC5l1L821fVYueaktqGKbEY+olvURSDZMsJ47JtCT31TwHV+ FRc1BFbIcKvWNqZoC1cBuWnGhLG663SLFHqwRECtos4gKbQ52STKQvrQW1GjmwWk IfI5N7d9Xknf9udM9KUzjZHwjcsAGcWdzbxT4ulgGaUpqywwFL0oz/xXLztB967y VhuP+CpuFRelzL3PN7TaYC3ESlKFI/I3wbScWnjKuiFlMnBZJ+ANgDpGn8+0M5xF 4CJefuKndoOSO9Whmc8mz1l5cTNDP9BkdiovvFNazBj+J0jG1PTnbuAdaAgHCnOw T/iNooWiRSvIelY1rNjImEGZt7LGReK4QoDwlBA2AasrtiFuvy8BRYt7bTMxaIJp sXUOom2ELdc0IZ+kxn9EaKaTTX0qYiEArNeXrKyzf+cYLrWpGUWwjFH1fLWfGeSQ lWoLkkVvsnp+G09ESLhE =7vE2 -----END PGP SIGNATURE----- --Apple-Mail=_DB61AD6C-ED0A-4EEF-9159-539B7C22274E-- From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 13:03:14 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 79C8B1F6 for ; Thu, 23 Jan 2014 13:03:14 +0000 (UTC) Received: from mail-oa0-x247.google.com (mail-oa0-x247.google.com [IPv6:2607:f8b0:4003:c02::247]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 424421B76 for ; Thu, 23 Jan 2014 13:03:14 +0000 (UTC) Received: by mail-oa0-f71.google.com with SMTP id g12so7004392oah.6 for ; Thu, 23 Jan 2014 05:03:13 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=6pcJsCkT1RBq7v9fubMpfoDZliFJV7zMrK+ONBQwcok=; b=sq3kjOmcKlMlhFHlkIfxMG0a7g+4f6+fOeXRMYOtQ6kcx6e/OcQ6MdEM1cIhWTku1n ha69DImqTqaO7k85KF1RU6woNrMRrN9cPoV55YqroAN+XYzeCtynN8q8mY6/WX0iyh6D wXjCnXzIfJrjT+DKTIVePuD1JEkCxcTpWAGR24HuiO4uyFskmC5XGNrqeVP5GDUZ8qX9 br+F3qz+KxFYqrvcun+vbxXke7rrRLtyPcvfut521FUp+opnM0jNAmn1JM1tTw6VEG1R yI+rnHVMsPKT73LDrJxf1N0UfMvzGiFjdv/QqOR9WPuzeR5HX5wCub5SbgDUDYmGdK5F dcwA== MIME-Version: 1.0 X-Received: by 10.50.154.73 with SMTP id vm9mr3633197igb.2.1390482193441; Thu, 23 Jan 2014 05:03:13 -0800 (PST) Message-ID: <047d7bd75ecc34eb8b04f0a2ddcd@google.com> Date: Thu, 23 Jan 2014 13:03:13 +0000 Subject: gain Organic Traffic:Freebsd.Org :PS From: Masha Lockwood To: freebsd-questions@FreeBSD.org, freebsd-doc@FreeBSD.org Content-Type: text/plain; charset=windows-1252; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 13:03:14 -0000 DQoNCkRlYXIgRnJlZWJzZC5PcmcgVGVhbSwNCg0KDQpJIHRob3VnaHQgeW91IG1pZ2h0IGxpa2Ug dG8ga25vdyBzb21lIG9mIHRoZSByZWFzb25zIHdoeSB5b3UgYXJlIG5vdA0KZ2V0dGluZyBlbm91 Z2ggT3JnYW5pYyBzZWFyY2ggZW5naW5lIGFuZCBTb2NpYWwgTWVkaWEgdHJhZmZpY2ZvcnlvdXIg d2Vic2l0ZQ0KLg0KDQoNCjEuWW91ciB3ZWJzaXRlIGlzIG5vdCByYW5raW5nIHRvcCBpbiBHb29n bGUgb3JnYW5pYyBzZWFyY2ggZm9yIG1hbnkNCmNvbXBldGl0aXZlIGtleXdvcmRzLg0KDQoNCjIu WW91ciB3ZWJzaXRlIHByb2ZpbGUgbmVlZHMgdG8gaGF2ZSByZWd1bGFyIHVwZGF0ZSBpbiBtYWpv ciBTb2NpYWwgTWVkaWENCnNpdGVzLg0KDQoNCjMuICBZb3VyIHNpdGUgaGFzIGxlc3MgbnVtYmVy IG9mIEdvb2dsZSAmIFlhaG9vIGJhY2sgbGlua3MsIHRoaXMgY2FuIGJlDQppbXByb3ZlZCBmdXJ0 aGVyLg0KDQoNClRoZXJlIGFyZSBtYW55IGFkZGl0aW9uYWwgaW1wcm92ZW1lbnRzIHRoYXQgY291 bGQgYmUgbWFkZSB0byB5b3VyIHdlYnNpdGUsDQphbmQgaWYgeW91IHdvdWxkIGxpa2UgdG8gbGVh cm4gYWJvdXQgdGhlbSwgYW5kIGFyZSBjdXJpb3VzIHRvIGtub3cgd2hhdCBvdXINCndvcmtpbmcg dG9nZXRoZXIgd291bGQgaW52b2x2ZSwgdGhlbiBJIHdvdWxkIGJlIGdsYWQgdG8gcHJvdmlkZSB5 b3Ugd2l0aCBhDQpkZXRhaWxlZCBhbmFseXNpcyBpbiB0aGUgZm9ybSBvZiBhIFdFQlNJVEUgQVVE SVQgUkVQT1JUIGZvciBGUkVFLg0KDQoNCiAgT3VyIGNsaWVudHMgY29uc2lzdGVudGx5IHRlbGwg dXMgdGhhdCB0aGVpciBjdXN0b21lcnMgZmluZCB0aGVtIGJlY2F1c2UNCnRoZXkgYXJlIGF0IHRo ZSB0b3Agb2YgdGhlIEdvb2dsZSBzZWFyY2ggcmFua2luZ3MuIEJlaW5nIGF0IHRoZSB0b3AgbGVm dCBvZg0KR29vZ2xlICgjMS0gIzMgb3JnYW5pYyBwb3NpdGlvbnMpIGlzIHRoZSBiZXN0IHRoaW5n IHlvdSBjYW4gZG8gZm9yIHlvdXINCmNvbXBhbnkncyB3ZWJzaXRlIHRyYWZmaWMgYW5kIG9ubGlu ZSByZXB1dGF0aW9uLg0KDQoNCk91ciBwYWNrYWdlcyBhcmUgZGVzaWduZWQgZm9yIGEgY29tcGxl dGUgYWR2YW5jZSBTRU8gZXhwZXJpZW5jZSB3aGljaA0KaW5jbHVkZXMgU01PLCBCcmFuZCBtYW5h Z2VtZW50LCBSZXB1dGF0aW9uIG1hbmFnZW1lbnQsIFNFTyBldGMuIGluIG9yZGVyIHRvDQpiZWF0 IHlvdXIgY29tcGV0aXRvcnMuDQoNCg0KU291bmRzIGludGVyZXN0aW5nPyBGZWVsIGZyZWUgdG8g ZW1haWwgdXMgb3IgYWx0ZXJuYXRpdmVseSB5b3UgY2FuIHByb3ZpZGUNCm1lIHdpdGggeW91ciBw aG9uZSBudW1iZXIgYW5kIHRoZSBiZXN0IHRpbWUgdG8gY2FsbCB5b3UuDQoNCg0KICAtLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQ0KDQogIEJlc3QgUmVn YXJkcywNCk1hc2hhIExvY2t3b29kIHxTRU8gQ29uc3VsdGFudA0KUEguIE5vOiA2MzEtMjkyLTQw OTANClNreXBlOiBzZW8ub25saW5lYnVzaW5lc3MNCi0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tDQoNCg0KDQpQUzE6IFRoaXMgaXMgb25ldGltZSBlbWFp bCBhbmQgeW91IG1heSBhc2sgdXMgdG8gk1JFTU9WRZQgeW91IGZyb20gb3VyDQptYWlsaW5nIGxp c3QuDQoNCg0KDQpQUzI6IFdlIG9wZXJhdGUgMjQgeDcuIEkgd2lsbCBiZSBoYXBweSB0byBzZW5k IHlvdSBsaW5rcyB0byBwcmljZSBsaXN0LA0KbW9uZXkgYmFjayBndWFyYW50ZWUsIGNsaWVudCBy YW5raW5ncywgY2xpZW50IHRlc3RpbW9uaWFscywgk0hvdyB3ZSBhcmUNCmRpZmZlcmVudCBmcm9t IG90aGVycz+ULCBhbmQgk1doeSBzaG91bGQgeW91IGNob29zZSB1cz+UIG9uIHJlY2VpdmluZyBh DQpyZXNwb25zZSBmcm9tIHlvdS4NCg0K From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 15:31:02 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id C3A7CF82; Thu, 23 Jan 2014 15:31:02 +0000 (UTC) Received: from mail-ve0-x22b.google.com (mail-ve0-x22b.google.com [IPv6:2607:f8b0:400c:c01::22b]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4226D199F; Thu, 23 Jan 2014 15:31:02 +0000 (UTC) Received: by mail-ve0-f171.google.com with SMTP id pa12so1199353veb.30 for ; Thu, 23 Jan 2014 07:31:01 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=NuhYtckWlQvg32SvcVbiJ9s54uexFaV8mEodo3kpc/8=; b=DdehstLmZBqTYHrwf40srhrGzLqMCMJR6LWHBO/nxw+gvuFJzyKUh5oBXhenbdySiW DpsNUJyHzG7XTKlCQiplcxCDQ4GBXPe1HPdikj4yc+r6OWlk6S+9yJ8ukw81Rr6gQlpq XvECS1ao8chp5USrnO6Y1P2m2HOn7VobX/aA8Qo4sfDa5TD2+ej3kam5NB+jzeReH1I5 sUY3y3vfEQC8Eo9+TK8aYzybtTr67Hiyd1Urm2OU66hZ4nT0cWV5qT9oRNYst2lM2+g+ VTIM9jm0xGlefqnrjUdzkJbulzUaCmxuYbJ99VdusEsM2yb1z50tAVlOVQggefvhhEA2 vs+g== MIME-Version: 1.0 X-Received: by 10.58.85.133 with SMTP id h5mr4856058vez.4.1390491061306; Thu, 23 Jan 2014 07:31:01 -0800 (PST) Received: by 10.220.168.135 with HTTP; Thu, 23 Jan 2014 07:31:01 -0800 (PST) In-Reply-To: <834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org> References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> <52E1053A.8000608@a1poweruser.com> <834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org> Date: Thu, 23 Jan 2014 10:31:01 -0500 Message-ID: Subject: Re: docs/144515: [handbook] Expand handbook Table of contents From: Thomas Hoffmann To: Remko Lodder Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.17 Cc: Glen Barber , freebsd-doc@freebsd.org, Gabor Kovesdan X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 15:31:02 -0000 On Thu, Jan 23, 2014 at 7:37 AM, Remko Lodder wrote: > > On 23 Jan 2014, at 13:04, Fbsd8 wrote: > > > Glen Barber wrote: > >> On Thu, Jan 23, 2014 at 09:52:55AM +0800, Fbsd8 wrote: > >>> I though the goal of the handbook was to be usable and here we have > our main > >>> documentation looking like something created by people who don't even > know > >>> the normal standard parts of a published document or the professional > way to > >>> organize content. > >>> > >> Your insults are not appreciated. > >> Please reconsider your response, and if you feel there is still > >> a concern, reply in a professional, non-insulting manner. > >> Glen > > > > Well Glen what you consider insulting I consider frank and to the point= . > Since when do people have to accept your censorship? There is no > censorship on any of the FreeBSD lists so quite trying to force your > personal old fashioned thin skinned attitudes on the members of this list= . > I find your remarks to be insulting and totally out of place. And as usua= l > you remove from the post the text that explains that statement so you can > take it out of context. shame on you, you should know better, you have be= en > called on this before. Any future reply to this thread by you will go > unanswered by me for I will not lower myself to your level. > > Thank you for proving Glen=92s point. Please move along now, nothing to s= ee > here. > > > > > _______________________________________________ > > freebsd-doc@freebsd.org mailing list > > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > > -- > > /"\ Best regards, | remko@FreeBSD.org > \ / Remko Lodder | remko@EFnet > X http://www.evilcoder.org/ | > / \ ASCII Ribbon Campaign | Against HTML Mail and News > Well, to focus this back on the original point, I'd like to see the Table of Contents for the Handbook take better advantage of the horizontal "page". I use a 24" monitor @ 1920x1200 and there is a lot of [wasted] white space on my screen when viewing the TOC. It takes me eight (8) mouse scroll movements to get from top to bottom (or eighteen (18) scroll bar clicks). It's got to be even worse for folks with small screens. It would be good if we could redesign the TOC to take better advantage of the horizontal "page", something that would work for large an small screen users. The individual sections of the Handbook use the full horizontal "page", why not the TOC? From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 15:49:48 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 9AE82FBF; Thu, 23 Jan 2014 15:49:48 +0000 (UTC) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 1D9D81C93; Thu, 23 Jan 2014 15:49:47 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 982F714D2510; Thu, 23 Jan 2014 16:49:36 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com 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 BWvLtzNyTuOy; Thu, 23 Jan 2014 16:49:36 +0100 (CET) Received: from [192.168.1.117] (catv-80-99-23-232.catv.broadband.hu [80.99.23.232]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id E7F3A14D2436; Thu, 23 Jan 2014 16:49:35 +0100 (CET) Message-ID: <52E13A0D.1010003@FreeBSD.org> Date: Thu, 23 Jan 2014 16:49:33 +0100 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:28.0) Gecko/20100101 Thunderbird/28.0a2 MIME-Version: 1.0 To: Fbsd8 , Glen Barber Subject: Re: docs/144515: [handbook] Expand handbook Table of contents References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> <52E1053A.8000608@a1poweruser.com> In-Reply-To: <52E1053A.8000608@a1poweruser.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 15:49:48 -0000 On 2014.01.23. 13:04, Fbsd8 wrote: > Well Glen what you consider insulting I consider frank and to the > point. Since when do people have to accept your censorship? There is > no censorship on any of the FreeBSD lists so quite trying to force > your personal old fashioned thin skinned attitudes on the members of > this list. I find your remarks to be insulting and totally out of > place. And as usual you remove from the post the text that explains > that statement so you can take it out of context. shame on you, you > should know better, you have been called on this before. Any future > reply to this thread by you will go unanswered by me for I will not > lower myself to your level. Where's your signature? If it is really a frank opinion, why don't you sign it with your real name? Gabor Kovesdan From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 15:52:49 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 7BE5223D; Thu, 23 Jan 2014 15:52:49 +0000 (UTC) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 29E421D13; Thu, 23 Jan 2014 15:52:49 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 68A8414D2515; Thu, 23 Jan 2014 16:52:47 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com 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 iUlA8t_xRT9q; Thu, 23 Jan 2014 16:52:46 +0100 (CET) Received: from [192.168.1.117] (catv-80-99-23-232.catv.broadband.hu [80.99.23.232]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 61E2D14D2436; Thu, 23 Jan 2014 16:52:46 +0100 (CET) Message-ID: <52E13ACC.2020005@FreeBSD.org> Date: Thu, 23 Jan 2014 16:52:44 +0100 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:28.0) Gecko/20100101 Thunderbird/28.0a2 MIME-Version: 1.0 To: Thomas Hoffmann , Remko Lodder Subject: Re: docs/144515: [handbook] Expand handbook Table of contents References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> <52E1053A.8000608@a1poweruser.com> <834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org> In-Reply-To: Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit Cc: Glen Barber , freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 15:52:49 -0000 On 2014.01.23. 16:31, Thomas Hoffmann wrote: > Well, to focus this back on the original point, I'd like to see the > Table of Contents for the Handbook take better advantage of the > horizontal "page". I use a 24" monitor @ 1920x1200 and there is a lot > of [wasted] white space on my screen when viewing the TOC. It takes me > eight (8) mouse scroll movements to get from top to bottom (or > eighteen (18) scroll bar clicks). It's got to be even worse for folks > with small screens. It would be good if we could redesign the TOC to > take better advantage of the horizontal "page", something that would > work for large an small screen users. As you state here, the list is already so long, that's exactly why subsections are not included... > > The individual sections of the Handbook use the full horizontal > "page", why not the TOC? What do you exactly mean by horizontal page? Gabor From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 15:59:01 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 78E4B5CB; Thu, 23 Jan 2014 15:59:01 +0000 (UTC) Received: from mail-ve0-x22f.google.com (mail-ve0-x22f.google.com [IPv6:2607:f8b0:400c:c01::22f]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id EE2121D7E; Thu, 23 Jan 2014 15:59:00 +0000 (UTC) Received: by mail-ve0-f175.google.com with SMTP id c14so1222177vea.34 for ; Thu, 23 Jan 2014 07:59:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=zsu2xLeQDTHrnYZIB/DaUlA+JH6QF8Q+4k4JSUEFGiM=; b=wzjh75TWnpdyNoal2KP9DaiCmCC/nn9HTLsMjrlXEqU49CsteERt1QPf4ZLJDE3LJM I5mCnIqLBXzGBtyzV8esmxuqVfOshKafiNHH5QCJCyKXR8w5dPv/Ke/Pl/ZlG6w1SQYj YTI9bltIK1jw8xgdfWG8W4KcTs3TkNisTw3B7ZEsdVM2cyeZBwuz6qdOq0nN8Q0JBREh wav0chECrEUq2gs5L52Dzwb8Jr2gKFDcwhQnf/7TGWcdID+6sNLaTrZ/eUfocvxgQaVj CSJX0/azuGk0zRkvOQPt+XaHCKAozg+hbkeKtFN9aI6keQpPiVQjSv53uzP6nrvSUnuq g+Zw== MIME-Version: 1.0 X-Received: by 10.220.193.132 with SMTP id du4mr465562vcb.39.1390492740143; Thu, 23 Jan 2014 07:59:00 -0800 (PST) Received: by 10.220.168.135 with HTTP; Thu, 23 Jan 2014 07:59:00 -0800 (PST) In-Reply-To: <52E13ACC.2020005@FreeBSD.org> References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> <52E1053A.8000608@a1poweruser.com> <834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org> <52E13ACC.2020005@FreeBSD.org> Date: Thu, 23 Jan 2014 10:59:00 -0500 Message-ID: Subject: Re: docs/144515: [handbook] Expand handbook Table of contents From: Thomas Hoffmann To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 Cc: Glen Barber , Gabor Kovesdan X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 15:59:01 -0000 On Thu, Jan 23, 2014 at 10:52 AM, Gabor Kovesdan wrote: > On 2014.01.23. 16:31, Thomas Hoffmann wrote: > >> Well, to focus this back on the original point, I'd like to see the Table >> of Contents for the Handbook take better advantage of the horizontal >> "page". I use a 24" monitor @ 1920x1200 and there is a lot of [wasted] >> white space on my screen when viewing the TOC. It takes me eight (8) mouse >> scroll movements to get from top to bottom (or eighteen (18) scroll bar >> clicks). It's got to be even worse for folks with small screens. It would >> be good if we could redesign the TOC to take better advantage of the >> horizontal "page", something that would work for large an small screen >> users. >> > As you state here, the list is already so long, that's exactly why > subsections are not included... > > >> The individual sections of the Handbook use the full horizontal "page", >> why not the TOC? >> > What do you exactly mean by horizontal page? > > Gabor > I agree, the TOC is already too long vertically. Adding subsections would exacerbate the problem. By "horizontal page" I mean taking advantage of the full screen width, for example, by using multi-columns or similar technique. That would get more info on each screen page. Compare the TOC with the x-config.html page ( http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x-config.html), which uses the full page width. -Tom From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 16:18:29 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 9926FF1A; Thu, 23 Jan 2014 16:18:29 +0000 (UTC) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 465D71F31; Thu, 23 Jan 2014 16:18:28 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 56CE714D2510; Thu, 23 Jan 2014 17:18:27 +0100 (CET) X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com 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 Vza_dNNShNY5; Thu, 23 Jan 2014 17:18:26 +0100 (CET) Received: from [192.168.1.117] (catv-80-99-23-232.catv.broadband.hu [80.99.23.232]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 8EE8E14D2436; Thu, 23 Jan 2014 17:18:26 +0100 (CET) Message-ID: <52E140D1.5090809@FreeBSD.org> Date: Thu, 23 Jan 2014 17:18:25 +0100 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:28.0) Gecko/20100101 Thunderbird/28.0a2 MIME-Version: 1.0 To: Thomas Hoffmann , freebsd-doc@freebsd.org Subject: Re: docs/144515: [handbook] Expand handbook Table of contents References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> <52E1053A.8000608@a1poweruser.com> <834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org> <52E13ACC.2020005@FreeBSD.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Glen Barber X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 16:18:29 -0000 On 2014.01.23. 16:59, Thomas Hoffmann wrote: > I agree, the TOC is already too long vertically. Adding subsections > would exacerbate the problem. > > By "horizontal page" I mean taking advantage of the full screen width, > for example, by using multi-columns or similar technique. That would > get more info on each screen page. Compare the TOC with the > x-config.html page ( > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x-config.html), > which uses the full page width. The problem with this is that TOC is a multiple level enumeration by nature, which is conventionally listed vertically in order. Using two columns may be confusing for people since it is not conventional. And if we use 2 columns, what order would it follow? Like this: 1 2 1.1 2.1 1.2 2.2 1.3 2.3 Or this: 1 1.1 1.2 1.3 1.4 And what to do on smaller screens if the two columns do not fit? I believe that a collapsible tree list would be the best option but that requires JavaScript, which we prefer to avoid... Gabor From owner-freebsd-doc@FreeBSD.ORG Thu Jan 23 16:32:46 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id B4964356; Thu, 23 Jan 2014 16:32:46 +0000 (UTC) Received: from mail-vc0-x22f.google.com (mail-vc0-x22f.google.com [IPv6:2607:f8b0:400c:c03::22f]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 2EB5B10CE; Thu, 23 Jan 2014 16:32:46 +0000 (UTC) Received: by mail-vc0-f175.google.com with SMTP id ij19so1177190vcb.20 for ; Thu, 23 Jan 2014 08:32:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=0aBjwRhEr4dNptcCChS6JrCQzGWg1XNfkWUaiUXrNTI=; b=JxQkMbefKgIN3PD/kC9XkK+JSd5EkhgaHJkGX1v1j7zTlJcUl3qHgvQyBlASEUhUJR 6aYMM7V+ancLROmRuqbLLwKxux0zmaXtgQlHQMjaykhbHHtJ4SeMUVJuGHOpTUkr7uzW hWT+pTacU1h+GrjW2tcZJjtXwKFNSKAGSpH6bTGGtY9aXJlgs2m9apXmAQ7jNaMu1+K4 wMYeprZPriwYY9urhMk5UWfjNmGxu+ks1lwt2Ccu20NNBkdQs1dME3L4xtMJerCBPs+W jmWlnnvDWaMtPyzTHhEt8HdbDkQ5iM3UTEI3FG8WYw8mQ8MTbz8RtYsd1FYdVLrYFeeL c2xg== MIME-Version: 1.0 X-Received: by 10.58.161.227 with SMTP id xv3mr4927092veb.31.1390494765323; Thu, 23 Jan 2014 08:32:45 -0800 (PST) Received: by 10.220.168.135 with HTTP; Thu, 23 Jan 2014 08:32:45 -0800 (PST) In-Reply-To: <52E140D1.5090809@FreeBSD.org> References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> <52E1053A.8000608@a1poweruser.com> <834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org> <52E13ACC.2020005@FreeBSD.org> <52E140D1.5090809@FreeBSD.org> Date: Thu, 23 Jan 2014 11:32:45 -0500 Message-ID: Subject: Re: docs/144515: [handbook] Expand handbook Table of contents From: Thomas Hoffmann To: freebsd-doc@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 Cc: Glen Barber , Gabor Kovesdan X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Jan 2014 16:32:46 -0000 On Thu, Jan 23, 2014 at 11:18 AM, Gabor Kovesdan wrote: > On 2014.01.23. 16:59, Thomas Hoffmann wrote: > >> I agree, the TOC is already too long vertically. Adding subsections would >> exacerbate the problem. >> >> By "horizontal page" I mean taking advantage of the full screen width, >> for example, by using multi-columns or similar technique. That would get >> more info on each screen page. Compare the TOC with the x-config.html page >> ( http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x-config.html), >> which uses the full page width. >> > The problem with this is that TOC is a multiple level enumeration by > nature, which is conventionally listed vertically in order. Using two > columns may be confusing for people since it is not conventional. And if we > use 2 columns, what order would it follow? Like this: > > 1 2 > 1.1 2.1 > 1.2 2.2 > 1.3 2.3 > > Or this: > > 1 > 1.1 1.2 > 1.3 1.4 > > And what to do on smaller screens if the two columns do not fit? > > I believe that a collapsible tree list would be the best option but that > requires JavaScript, which we prefer to avoid... > > Gabor > Top to bottom, left to right would be the normal "western" approach, no? Personally, I would have no problem with a TOC that only listed the major chapters. If you want the details sections/subsections) you would drill (click) down as required: 1. 6. 2. 7. 3 8. 4. 9. 5. 10. or even 1. 2. 3. 4. 5. 6. etc. It would require less scrolling, but this might be objectionable to many. I understand completely your desire to avoid JS. This may simply be an intractable problem. -Tom From owner-freebsd-doc@FreeBSD.ORG Fri Jan 24 08:09:51 2014 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 47D51A6A; Fri, 24 Jan 2014 08:09:51 +0000 (UTC) Received: from citadel.icyb.net.ua (citadel.icyb.net.ua [212.40.38.140]) by mx1.freebsd.org (Postfix) with ESMTP id 72A1410A2; Fri, 24 Jan 2014 08:09:50 +0000 (UTC) Received: from porto.starpoint.kiev.ua (porto-e.starpoint.kiev.ua [212.40.38.100]) by citadel.icyb.net.ua (8.8.8p3/ICyb-2.3exp) with ESMTP id KAA05508; Fri, 24 Jan 2014 10:09:48 +0200 (EET) (envelope-from avg@FreeBSD.org) Received: from localhost ([127.0.0.1]) by porto.starpoint.kiev.ua with esmtp (Exim 4.34 (FreeBSD)) id 1W6bpk-0005ku-Hz; Fri, 24 Jan 2014 10:09:48 +0200 Message-ID: <52E21F94.5000104@FreeBSD.org> Date: Fri, 24 Jan 2014 10:08:52 +0200 From: Andriy Gapon User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 MIME-Version: 1.0 To: doc@FreeBSD.org Subject: Fwd: Re: svn commit: r258713 - in head/sys: kern sys References: <52D93F91.502@FreeBSD.org> In-Reply-To: <52D93F91.502@FreeBSD.org> X-Enigmail-Version: 1.6 X-Forwarded-Message-Id: <52D93F91.502@FreeBSD.org> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Cc: hackers@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Jan 2014 08:09:51 -0000 I would like to commit the following manual page update. Could you please review it? Thank you very much! -------- Original Message -------- Message-ID: <52D93F91.502@FreeBSD.org> Date: Fri, 17 Jan 2014 16:34:57 +0200 From: Andriy Gapon To: Justin T. Gibbs CC: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r258713 - in head/sys: kern sys References: <201311281856.rASIuZu8059699@svn.freebsd.org> <3784C560-3648-4E03-93DA-9A60E3AC401D@scsiguy.com> In-Reply-To: <3784C560-3648-4E03-93DA-9A60E3AC401D@scsiguy.com> on 30/11/2013 08:46 Justin T. Gibbs said the following: > Man page update? I came up with the following update that - adds taskqueue_drain_all documentation - extends taskqueue_drain description - adds description for previously undocumented taskqueue_block / taskqueue_unblock, including a warning on taskqueue_block + taskqueue_drain combination All reviews and suggestions are welcome. Both for content and language. diff --git a/share/man/man9/taskqueue.9 b/share/man/man9/taskqueue.9 index 5f6131a..4db3d7a 100644 --- a/share/man/man9/taskqueue.9 +++ b/share/man/man9/taskqueue.9 @@ -86,6 +86,12 @@ struct timeout_task; .Fn taskqueue_drain "struct taskqueue *queue" "struct task *task" .Ft void .Fn taskqueue_drain_timeout "struct taskqueue *queue" "struct timeout_task *timeout_task" +.Ft void +.Fn taskqueue_drain_all "struct taskqueue *queue" +.Ft void +.Fn taskqueue_block "struct taskqueue *queue" +.Ft void +.Fn taskqueue_unblock "struct taskqueue *queue" .Ft int .Fn taskqueue_member "struct taskqueue *queue" "struct thread *td" .Ft void @@ -255,6 +261,74 @@ function is used to wait for the scheduled task to finish. There is no guarantee that the task will not be enqueued after call to .Fn taskqueue_drain . +Because the caller typically would use +.Fn taskqueue_drain +to put the task into a known state, then the caller should use +out-of-band means to ensure, before calling +.Fn taskqueue_drain , +that the task would not be enqueued. +For example, if the task is enqueued by an interrupt filter, then +the interrupt could be disabled. +.Pp +The +.Fn taskqueue_drain_all +function is used to wait for all the pending and running tasks that +are enqueued on the taskqueue to finish. +The caller must arrange that the tasks are not re-enqueued. +Note that +.Fn taskqueue_drain_all +currently does not handle tasks with delayed enqueueing. +.Pp +The +.Fn taskqueue_block +function blocks the taskqueue. +It prevents any enqueued but not running tasks from being executed. +Future calls to +.Fn taskqueue_enqueue +will enqueue tasks, but the tasks will not be run until +.Fn taskqueue_unblock +is called. +Please note that +.Fn taskqueue_block +does not wait for any currently running tasks to finish. +Thus, the +.Fn taskqueue_block +does not provide a guarantee that +.Fn taskqueue_run +is not running after +.Fn taskqueue_block +returns, but it does provide a guarantee that +.Fn taskqueue_run +will not be called again +until +.Fn taskqueue_unblock +is called. +If the caller requires a guarantee that +.Fn taskqueue_run +is not running, then this must be arranged by the caller. +Note that if +.Fn taskqueue_drain +is called on a task that is enqueued on a taskqueue that is blocked by +.Fn taskqueue_block , +then +.Fn taskqueue_drain +can not return until the taskqueue is unblocked. +This can result in a deadlock if the thread blocked in +.Fn taskqueue_drain +is a thread that is supposed to call +.Fn taskqueue_unblock . +Thus, use of +.Fn taskqueue_drain +after +.Fn taskqueue_block +is discouraged, because a state of the task can not be known in advance. +The same applies to +.Fn taskqueue_drain_all . +.Pp +The +.Fn taskqueue_unblock +function unblocks the previously blocked taskqueue. +All enqueued tasks can be run after this call. .Pp The .Fn taskqueue_member -- Andriy Gapon From owner-freebsd-doc@FreeBSD.ORG Fri Jan 24 08:17:37 2014 Return-Path: Delivered-To: doc@FreeBSD.org Received: by hub.freebsd.org (Postfix, from userid 1033) id 86723FF2; Fri, 24 Jan 2014 08:17:37 +0000 (UTC) Date: Fri, 24 Jan 2014 08:17:37 +0000 From: Alexey Dokuchaev To: doc@FreeBSD.org Subject: Re: [patch] PH tells crap about GMAKE (Was: Re: svn commit: r340018 - head/textproc/scew) Message-ID: <20140124081737.GA77854@FreeBSD.org> References: <201401170910.s0H9Aw9O087448@svn.freebsd.org> <20140117093546.GA16656@FreeBSD.org> <20140117095020.GD4006@gahrfit.gahr.ch> <20140117141440.GA94157@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20140117141440.GA94157@FreeBSD.org> User-Agent: Mutt/1.5.22 (2013-10-16) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Jan 2014 08:17:37 -0000 On Fri, Jan 17, 2014 at 02:14:40PM +0000, Alexey Dokuchaev wrote: > On Fri, Jan 17, 2014 at 10:50:21AM +0100, Pietro Cerutti wrote: > > On 2014-Jan-17, 09:35, Alexey Dokuchaev wrote: > > > If possible, particular make(1) implementation should not be referenced in > > > port's Makefile. If you need to call "correct" make(1), use ${MAKE_CMD}, > > > which would be correctly set to "gmake" in this case of yours (per USES= > > > gmake). > > > > That makes sense. What about updating [section] 6.4.2 of the porter's > > handbook? > > Indeed, this section needs some love. [...] > > Please consider attached patch. It is not a polished gem, and most likely > would need a review and wordsmithing from doc@ guys. Retransmit. ./danfe From owner-freebsd-doc@FreeBSD.ORG Fri Jan 24 10:48:48 2014 Return-Path: Delivered-To: www@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 35A44F16 for ; Fri, 24 Jan 2014 10:48:48 +0000 (UTC) Received: from mail-oa0-x248.google.com (mail-oa0-x248.google.com [IPv6:2607:f8b0:4003:c02::248]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 01DEF1F8B for ; Fri, 24 Jan 2014 10:48:47 +0000 (UTC) Received: by mail-oa0-f72.google.com with SMTP id i4so11586896oah.7 for ; Fri, 24 Jan 2014 02:48:47 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:message-id:date:subject:from:to:content-type; bh=Is8yQVyD82lGso9XzmK8PNI2h9dHkF357huvTExUMzI=; b=EhuvrxASWuaOwA5lEvTYD5vxd9ycHqoEsVI4yPflHvXNgCSRbA58SBRadr/J/wXMMx 7VkkwQSs0mtgI+t7TQjKYGBuJBgqOE6GilWTlwqSG64ovlPmUVA+mGzdb7cG8JDQqvbG wS+62J/pq9thECz2MkhGFWIkAxqkXFEW5fGemat0UDWns4KI0v3Lo8pkYPUNZP1qAnUz NP0LPzOtDcbJFSNWd0UDE4BVHKfgg+beh/yZSJAa3qAmsazApJ4ZuSmeYIYyESngj9xM A7m6yW9za73PGguH17M+9gR/pdStgDlozNp2rbL/1xC6a0ubdccLYsvoSa4lNhOvnbGY 8YSg== MIME-Version: 1.0 X-Received: by 10.50.18.4 with SMTP id s4mr1634689igd.5.1390560527341; Fri, 24 Jan 2014 02:48:47 -0800 (PST) Message-ID: <089e013cb8d6455f3504f0b51a6f@google.com> Date: Fri, 24 Jan 2014 10:48:47 +0000 Subject: www.freebsd.org From: Veronica Yuen To: www@freebsd.org Content-Type: text/plain; charset=windows-1252; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Jan 2014 10:48:48 -0000 PGRpdiBkaXI9Imx0ciI+PHA+SGksPC9wPjxkaXY+PHA+SSB3YW50ZWQgdG8gc2VuZCB5b3UgYSBx dWljayBub3RlLiBXaXRoIGEgIA0KZmV3IHNpbXBsZSBjaGFuZ2VzIHRvIG1ha2UgeW91ciBzaXRl IG1vcmUgU0VPLWZyaWVuZGx5IEmSbSBzdXJlIHlvdSBjYW4gIA0KY29udmVydCBtb3JlIHZpc2l0 b3JzIGludG8gbGVhZHMgYW5kIGdldCBpdCBwbGFjZWQgaGlnaGVyIGluIHRoZSBvcmdhbmljICAN CnNlYXJjaCByZXN1bHRzLCBmb3Iga2V5d29yZHMgdGhhdCBtYXR0ZXIgdG8geW91IHRoZSBtb3N0 LjwvcD4NCg0KDQo8L2Rpdj48ZGl2PjxwPldlIGFyZSBhIExvY2FsIGJhc2VkIGNvbXBhbnkgd2l0 aCBncmVhdCBpbi1ob3VzZSB0ZWNobmljYWwgIA0KdGVhbSB3aG8gcmVhbGx5IGtub3cgdGhlaXIg c3R1ZmYgYWJvdXQgc2VhcmNoIGVuZ2luZSAgDQpvcHRpbWl6YXRpb24uoDwvcD48L2Rpdj48cD5X b3VsZCB5b3UgbGlrZSBhIGJpdCBtb3JlIGluZm9ybWF0aW9uIGFib3V0IGhvdyAgDQp0byBnaXZl IHlvdXIgd2Vic2l0ZSBhIGJvb3N0IHdpdGggYmV0dGVyIFNFTz88L3A+DQoNCg0KPHA+QmVzdCBy ZWdhcmRzLDwvcD48cD48c3BhbiBzdHlsZT0iZm9udC1mYW1pbHk6JiMzOTtib29rICANCmFudGlx dWEmIzM5OyxwYWxhdGlubztjb2xvcjpyZ2IoMTM2LDEzNiwxMzYpIj48Zm9udCBzaXplPSI0Ij5W ZXJvbmljYSAgDQpZdWVuPC9mb250Pjxicj48c3BhbiAgDQpzdHlsZT0iY29sb3I6cmdiKDAsMCww KTtmb250LWZhbWlseTphcmlhbCxoZWx2ZXRpY2Esc2Fucy1zZXJpZjtmb250LXNpemU6eHgtc21h bGwiPlNFTy9XRUIgIA0KU3BlY2lhbGlzdDwvc3Bhbj48L3NwYW4+PC9wPg0KDQoNCjx0YWJsZSBz dHlsZT0ibWFyZ2luLWxlZnQ6YXV0bzttYXJnaW4tcmlnaHQ6YXV0byIgIA0KYm9yZGVyPSIwIj48 dGJvZHk+PHRyPjx0ZD6goKCgoKCgoKCgPC90ZD48dGQgIA0Kc3R5bGU9ImJhY2tncm91bmQtY29s b3I6cmdiKDcyLDExNCwyMzMpIj48Yj6gPC9iPqA8c3BhbiAgDQpzdHlsZT0iZm9udC1mYW1pbHk6 JiMzOTt0aW1lcyBuZXcgIA0Kcm9tYW4mIzM5Oyx0aW1lcztmb250LXNpemU6bGFyZ2U7Y29sb3I6 cmdiKDI1NSwyNTUsMjU1KSI+Uzwvc3Bhbj48Yj6goDwvYj48L3RkPg0KDQoNCjx0ZCBzdHlsZT0i YmFja2dyb3VuZC1jb2xvcjpyZ2IoMjU1LDAsNTEpIj6gPHNwYW4gIA0Kc3R5bGU9ImZvbnQtZmFt aWx5OiYjMzk7dGltZXMgbmV3IHJvbWFuJiMzOTssdGltZXM7Zm9udC1zaXplOmxhcmdlIj48c3Bh biAgDQpzdHlsZT0iZm9udC1zaXplOngtbGFyZ2U7Y29sb3I6cmdiKDI1NSwyNTUsMjU1KSI+RTwv c3Bhbj6gPC9zcGFuPjwvdGQ+PHRkICANCnN0eWxlPSJiYWNrZ3JvdW5kLWNvbG9yOnJnYigxMDEs MjM1LDE5KSI+DQoNCg0KPHNwYW4gc3R5bGU9ImZvbnQtc2l6ZTpsYXJnZTtjb2xvcjpyZ2IoMjU1 LDI1NSwyNTUpO2ZvbnQtZmFtaWx5OiYjMzk7dGltZXMgIA0KbmV3IHJvbWFuJiMzOTssdGltZXMi PqBPoDwvc3Bhbj48L3RkPjx0ZCAgDQpzdHlsZT0idGV4dC1hbGlnbjpjZW50ZXIiPqCgoCCgIKAg oCCgPC90ZD48L3RyPjx0cj48dGQgY29sc3Bhbj0iNSIgIA0Kc3R5bGU9ImJhY2tncm91bmQtY29s b3I6cmdiKDAsMCwwKTt0ZXh0LWFsaWduOmNlbnRlciI+DQoNCg0KPGI+PHNwYW4gIA0Kc3R5bGU9 ImZvbnQtZmFtaWx5OnRhaG9tYSxhcmlhbCxoZWx2ZXRpY2Esc2Fucy1zZXJpZjtjb2xvcjpyZ2Io MjU1LDI1NSwyNTUpIj5TZWFyY2ggIA0KRW5naW5lIE9wdGltaXphdGlvbjwvc3Bhbj48L2I+PC90 ZD48L3RyPjwvdGJvZHk+PC90YWJsZT48cCAgDQpzdHlsZT0idGV4dC1hbGlnbjpjZW50ZXIiPjxz cGFuICANCnN0eWxlPSJmb250LWZhbWlseTphcmlhbCxoZWx2ZXRpY2Esc2Fucy1zZXJpZjtmb250 LXNpemU6eHgtc21hbGw7Y29sb3I6cmdiKDEzNiwxMzYsMTM2KSI+V2UgIA0KcmVzcGVjdCB5b3Vy IHByaXZhY3kgYW5kIHdhbnQgdG8gbWFrZSBzdXJlIHlvdSBhcmUgYXdhcmUgb2YgYSBmZXcgdGhp bmdzLiAgDQpCeSByZXBseWluZyB0byB0aGlzIGVtYWlsLCB5b3UgYXV0aG9yaXplIG91ciBIb25n IEtvbmcgYWZmaWxpYXRlcyB0aGF0IGNhbiAgDQpoZWxwIHdpdGggeW91ciBwcm9qZWN0IHRvIGNh bGwgeW91IGF0IHRoZSBudW1iZXIgeW91IHByb3ZpZGVkLCBhbmQgeW91ICANCnVuZGVyc3RhbmQg dGhhdCB0aGV5IG1heSB1c2UgYXV0b21hdGVkIHBob25lIHRlY2hub2xvZ3kgdG8gY2FsbCB5b3Uu IEF0IG5vICANCnRpbWUgYXJlIHlvdSByZXF1aXJlZCB0byBtYWtlIGEgcHVyY2hhc2UuPC9zcGFu PjwvcD4NCg0KDQo8ZGl2IHN0eWxlPSJ0ZXh0LWFsaWduOmNlbnRlciI+PHNwYW4gIA0Kc3R5bGU9 ImZvbnQtZmFtaWx5OmFyaWFsLGhlbHZldGljYSxzYW5zLXNlcmlmO2ZvbnQtc2l6ZTp4eC1zbWFs bDtjb2xvcjpyZ2IoMTM2LDEzNiwxMzYpIj5VbnN1YnNjcmliZTwvc3Bhbj48L2Rpdj48L2Rpdj4N Cg== From owner-freebsd-doc@FreeBSD.ORG Fri Jan 24 14:16:37 2014 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 0A63917D; Fri, 24 Jan 2014 14:16:37 +0000 (UTC) Received: from citadel.icyb.net.ua (citadel.icyb.net.ua [212.40.38.140]) by mx1.freebsd.org (Postfix) with ESMTP id 39092112B; Fri, 24 Jan 2014 14:16:35 +0000 (UTC) Received: from porto.starpoint.kiev.ua (porto-e.starpoint.kiev.ua [212.40.38.100]) by citadel.icyb.net.ua (8.8.8p3/ICyb-2.3exp) with ESMTP id QAA11609; Fri, 24 Jan 2014 16:16:34 +0200 (EET) (envelope-from avg@FreeBSD.org) Received: from localhost ([127.0.0.1]) by porto.starpoint.kiev.ua with esmtp (Exim 4.34 (FreeBSD)) id 1W6hYg-0006By-1Q; Fri, 24 Jan 2014 16:16:34 +0200 Message-ID: <52E27589.8050302@FreeBSD.org> Date: Fri, 24 Jan 2014 16:15:37 +0200 From: Andriy Gapon User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:24.0) Gecko/20100101 Thunderbird/24.2.0 MIME-Version: 1.0 To: doc@FreeBSD.org Subject: taskqueue(9) manual page update References: <52D93F91.502@FreeBSD.org> In-Reply-To: <52D93F91.502@FreeBSD.org> X-Enigmail-Version: 1.6 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit Cc: hackers@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Jan 2014 14:16:37 -0000 [I intended to change the subject line and forgot, so this is a dupe.] I would like to commit the following manual page update. Could you please review it? Thank you very much! -------- Original Message -------- Message-ID: <52D93F91.502@FreeBSD.org> Date: Fri, 17 Jan 2014 16:34:57 +0200 From: Andriy Gapon To: Justin T. Gibbs CC: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r258713 - in head/sys: kern sys References: <201311281856.rASIuZu8059699@svn.freebsd.org> <3784C560-3648-4E03-93DA-9A60E3AC401D@scsiguy.com> In-Reply-To: <3784C560-3648-4E03-93DA-9A60E3AC401D@scsiguy.com> on 30/11/2013 08:46 Justin T. Gibbs said the following: > Man page update? I came up with the following update that - adds taskqueue_drain_all documentation - extends taskqueue_drain description - adds description for previously undocumented taskqueue_block / taskqueue_unblock, including a warning on taskqueue_block + taskqueue_drain combination All reviews and suggestions are welcome. Both for content and language. diff --git a/share/man/man9/taskqueue.9 b/share/man/man9/taskqueue.9 index 5f6131a..4db3d7a 100644 --- a/share/man/man9/taskqueue.9 +++ b/share/man/man9/taskqueue.9 @@ -86,6 +86,12 @@ struct timeout_task; .Fn taskqueue_drain "struct taskqueue *queue" "struct task *task" .Ft void .Fn taskqueue_drain_timeout "struct taskqueue *queue" "struct timeout_task *timeout_task" +.Ft void +.Fn taskqueue_drain_all "struct taskqueue *queue" +.Ft void +.Fn taskqueue_block "struct taskqueue *queue" +.Ft void +.Fn taskqueue_unblock "struct taskqueue *queue" .Ft int .Fn taskqueue_member "struct taskqueue *queue" "struct thread *td" .Ft void @@ -255,6 +261,74 @@ function is used to wait for the scheduled task to finish. There is no guarantee that the task will not be enqueued after call to .Fn taskqueue_drain . +Because the caller typically would use +.Fn taskqueue_drain +to put the task into a known state, then the caller should use +out-of-band means to ensure, before calling +.Fn taskqueue_drain , +that the task would not be enqueued. +For example, if the task is enqueued by an interrupt filter, then +the interrupt could be disabled. +.Pp +The +.Fn taskqueue_drain_all +function is used to wait for all the pending and running tasks that +are enqueued on the taskqueue to finish. +The caller must arrange that the tasks are not re-enqueued. +Note that +.Fn taskqueue_drain_all +currently does not handle tasks with delayed enqueueing. +.Pp +The +.Fn taskqueue_block +function blocks the taskqueue. +It prevents any enqueued but not running tasks from being executed. +Future calls to +.Fn taskqueue_enqueue +will enqueue tasks, but the tasks will not be run until +.Fn taskqueue_unblock +is called. +Please note that +.Fn taskqueue_block +does not wait for any currently running tasks to finish. +Thus, the +.Fn taskqueue_block +does not provide a guarantee that +.Fn taskqueue_run +is not running after +.Fn taskqueue_block +returns, but it does provide a guarantee that +.Fn taskqueue_run +will not be called again +until +.Fn taskqueue_unblock +is called. +If the caller requires a guarantee that +.Fn taskqueue_run +is not running, then this must be arranged by the caller. +Note that if +.Fn taskqueue_drain +is called on a task that is enqueued on a taskqueue that is blocked by +.Fn taskqueue_block , +then +.Fn taskqueue_drain +can not return until the taskqueue is unblocked. +This can result in a deadlock if the thread blocked in +.Fn taskqueue_drain +is a thread that is supposed to call +.Fn taskqueue_unblock . +Thus, use of +.Fn taskqueue_drain +after +.Fn taskqueue_block +is discouraged, because a state of the task can not be known in advance. +The same applies to +.Fn taskqueue_drain_all . +.Pp +The +.Fn taskqueue_unblock +function unblocks the previously blocked taskqueue. +All enqueued tasks can be run after this call. .Pp The .Fn taskqueue_member -- Andriy Gapon From owner-freebsd-doc@FreeBSD.ORG Fri Jan 24 16:23:53 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 96F90AF1; Fri, 24 Jan 2014 16:23:53 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 593C01E98; Fri, 24 Jan 2014 16:23:53 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id s0OGNpY9088606; Fri, 24 Jan 2014 09:23:51 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id s0OGNpVF088603; Fri, 24 Jan 2014 09:23:51 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Fri, 24 Jan 2014 09:23:51 -0700 (MST) From: Warren Block To: Alexey Dokuchaev Subject: Re: [patch] PH tells crap about GMAKE (Was: Re: svn commit: r340018 - head/textproc/scew) In-Reply-To: <20140117141440.GA94157@FreeBSD.org> Message-ID: References: <201401170910.s0H9Aw9O087448@svn.freebsd.org> <20140117093546.GA16656@FreeBSD.org> <20140117095020.GD4006@gahrfit.gahr.ch> <20140117141440.GA94157@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="3512871622-1184828063-1390580631=:87046" X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Fri, 24 Jan 2014 09:23:51 -0700 (MST) Cc: doc@freebsd.org, Pietro Cerutti X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Jan 2014 16:23:53 -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. --3512871622-1184828063-1390580631=:87046 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed On Fri, 17 Jan 2014, Alexey Dokuchaev wrote: > On Fri, Jan 17, 2014 at 10:50:21AM +0100, Pietro Cerutti wrote: >> On 2014-Jan-17, 09:35, Alexey Dokuchaev wrote: >>> If possible, particular make(1) implementation should not be referenced in >>> port's Makefile. If you need to call "correct" make(1), use ${MAKE_CMD}, >>> which would be correctly set to "gmake" in this case of yours (per USES= >>> gmake). >> >> That makes sense. What about updating [section] 6.4.2 of the porter's >> handbook? > > Indeed, this section needs some love. Even more, I think it tells something > that is not true: "GMAKE [variables contains] The full path for gmake if it > is not in the PATH." > > GMAKE is defined in Mk/bsd.commands.mk, and equals to simply "gmake". It > is one of the rare cases when absolute (or relative to ${LOCALBASE}) path > is not used. I did not observe any indication of some PATH inspection to > conditionally set GMAKE variable under /usr/ports/Mk. > > I also think that Table 6.1 which consists of two rows and columns is, hm, > ridicule, I guess. :) IMHO it should be removed. > > Please consider attached patch. It is not a polished gem, and most likely > would need a review and wordsmithing from doc@ guys. > > While here I've also standardized the spelling of "okay", and fixed couple > of grammar nits. These changes are not related to GMAKE ones, and probably > should be committed separately, but I'm not splitting the diff for personal > convenience, sorry. :) Attached is a quick editing pass. I have not tested it for building yet, and edited the diff directly, so it has some a new blank line. --3512871622-1184828063-1390580631=:87046 Content-Type: TEXT/PLAIN; charset=US-ASCII; name=ph-gmake.diff Content-Transfer-Encoding: BASE64 Content-ID: Content-Description: Content-Disposition: attachment; filename=ph-gmake.diff SW5kZXg6IGJvb2sueG1sDQo9PT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQotLS0g Ym9vay54bWwJKHJldmlzaW9uIDQzNTU0KQ0KKysrIGJvb2sueG1sCSh3b3Jr aW5nIGNvcHkpDQpAQCAtMjAxLDcgKzIwMSw3IEBADQogCSAgICA8ZmlsZW5h bWU+UkVBRE1FPC9maWxlbmFtZT4gb3IgbWFucGFnZTwvZW1waGFzaXM+OyB0 b28NCiAJICAgIG9mdGVuIHRoZXkgYXJlIG5vdCBhIGNvbmNpc2UgZGVzY3Jp cHRpb24gb2YgdGhlIHBvcnQgb3INCiAJICAgIGFyZSBpbiBhbiBhd2t3YXJk IGZvcm1hdCAoZS5nLiwgbWFucGFnZXMgaGF2ZSBqdXN0aWZpZWQNCi0JICAg IHNwYWNpbmcsIGFzIGl0IGxvb2tzIHBhcnRpY3VsYXJseSBiYWQgd2l0aCBt b25vc3BhY2VkDQorCSAgICBzcGFjaW5nLCB3aGljaCBsb29rcyBwYXJ0aWN1 bGFybHkgYmFkIHdpdGggbW9ub3NwYWNlZA0KIAkgICAgZm9udHMpLjwvcGFy YT4NCiAJPC9ub3RlPg0KIA0KQEAgLTUxNSw3ICs1MTUsNyBAQA0KICAgPGNo YXB0ZXIgeG1sOmlkPSJzbG93Ij4NCiAgICAgPHRpdGxlPlNsb3cgUG9ydGlu ZzwvdGl0bGU+DQogDQotICAgIDxwYXJhPk9rLCBzbyBpdCB3YXMgbm90IHRo YXQgc2ltcGxlLCBhbmQgdGhlIHBvcnQgcmVxdWlyZWQgc29tZQ0KKyAgICA8 cGFyYT5Pa2F5LCBzbyBpdCB3YXMgbm90IHRoYXQgc2ltcGxlLCBhbmQgdGhl IHBvcnQgcmVxdWlyZWQgc29tZQ0KICAgICAgIG1vZGlmaWNhdGlvbnMgdG8g Z2V0IGl0IHRvIHdvcmsuICBJbiB0aGlzIHNlY3Rpb24sIHdlIHdpbGwNCiAg ICAgICBleHBsYWluLCBzdGVwIGJ5IHN0ZXAsIGhvdyB0byBtb2RpZnkgaXQg dG8gZ2V0IGl0IHRvIHdvcmsgd2l0aA0KICAgICAgIHRoZSBwb3J0cyBwYXJh ZGlnbS48L3BhcmE+DQpAQCAtNDEyOCw3ICs0MTI4LDcgQEANCiANCiAJPHBh cmE+QXZhaWxhYmxlIDx2YXJuYW1lPlVTRV88L3Zhcm5hbWU+IGFuZA0KIAkg IDx2YXJuYW1lPldBTlRfPC92YXJuYW1lPiB2YXJpYWJsZXMgYXJlIGRlZmlu ZWQgaW4gdGhlIGZpbGVzDQotCSAgaW4gPGZpbGVuYW1lPi91c3IvcG9ydHMv TWs8L2ZpbGVuYW1lPi48L3BhcmE+DQorCSAgaW4gPGZpbGVuYW1lIGNsYXNz PSJkaXJlY3RvcnkiPi91c3IvcG9ydHMvTWsvPC9maWxlbmFtZT4uPC9wYXJh Pg0KICAgICAgIDwvc2VjdDI+DQogICAgIDwvc2VjdDE+DQogDQpAQCAtNTY0 NCw0MCArNTY0NCwzMiBAQA0KICAgICAgIDwvc2VjdDI+DQogDQogICAgICAg PHNlY3QyIHhtbDppZD0idXNpbmctbWFrZSI+DQotCTx0aXRsZT48Y29tbWFu ZD5tYWtlPC9jb21tYW5kPiwgPGNvbW1hbmQ+Z21ha2U8L2NvbW1hbmQ+LCBh bmQNCi0JICA8Y29tbWFuZD5pbWFrZTwvY29tbWFuZD48L3RpdGxlPg0KKwk8 dGl0bGU+PGNvbW1hbmQ+bWFrZTwvY29tbWFuZD4sIDxjb21tYW5kPmdtYWtl PC9jb21tYW5kPiwNCisJICA8Y29tbWFuZD5mbWFrZTwvY29tbWFuZD4sIGFu ZCA8Y29tbWFuZD5pbWFrZTwvY29tbWFuZD48L3RpdGxlPg0KIA0KKwk8cGFy YT5TZXZlcmFsIDxsaXRlcmFsPm1ha2U8L2xpdGVyYWw+IGltcGxlbWVudGF0 aW9ucyBleGlzdCBhbmQNCisJICBhcmUgaW4gdXNlLiAgUXVpdGUgb2Z0ZW4s IGEgc3BlY2lmaWMgaW1wbGVtZW50YXRpb24gaXMgcmVxdWlyZWQsDQorCSAg bGlrZSBHTlUgbWFrZSwgb3IgbGVnYWN5ICZvczsgbWFrZS48L3BhcmE+DQor DQogCTxwYXJhPklmIHlvdXIgcG9ydCB1c2VzIDxhcHBsaWNhdGlvbj5HTlUg bWFrZTwvYXBwbGljYXRpb24+LA0KLQkgIHNldCA8bGl0ZXJhbD5VU0VTPSBn bWFrZTwvbGl0ZXJhbD4uPC9wYXJhPg0KKwkgIGFkZCA8bGl0ZXJhbD5nbWFr ZTwvbGl0ZXJhbD4gdG8gPGxpdGVyYWw+VVNFUzwvbGl0ZXJhbD4uICBJZg0K KwkgIHRoZSBsZWdhY3kgJm9zOyA8Y29tbWFuZD5tYWtlPC9jb21tYW5kPiBp cyBuZWVkZWQsIGFkZCA8bGl0ZXJhbD5mbWFrZTwvbGl0ZXJhbD4NCisJICB0 aGVyZS48L3BhcmE+DQogDQotCTx0YWJsZSBmcmFtZT0ibm9uZSI+DQotCSAg PHRpdGxlPlZhcmlhYmxlcyBmb3IgUG9ydHMgUmVsYXRlZCB0bw0KLQkgICAg PGFwcGxpY2F0aW9uPmdtYWtlPC9hcHBsaWNhdGlvbj48L3RpdGxlPg0KKwk8 cGFyYT5UbyByZWZlcmVuY2UgYSBzcGVjaWZpYyA8Y29tbWFuZD5tYWtlPC9j b21tYW5kPiBjb21tYW5kDQorCSAgdGhhdCBkZXBlbmRzIG9uIDxsaXRlcmFs PlVTRVM8L2xpdGVyYWw+IHZhbHVlIGluIGEgcG9ydCdzDQorCSAgPGZpbGVu YW1lPk1ha2VmaWxlPC9maWxlbmFtZT4sIHVzZQ0KKwkgIDx2YXJuYW1lPk1B S0VfQ01EPC92YXJuYW1lPi4gIEluIHJhcmUgY2FzZXMgd2hlcmUNCisJICBz ZXZlcmFsIGRpZmZlcmVudCA8bGl0ZXJhbD5tYWtlPC9saXRlcmFsPiBpbXBs ZW1lbnRhdGlvbnMgYXJlIGxpc3RlZA0KKwkgIGluIDxsaXRlcmFsPlVTRVM8 L2xpdGVyYWw+LCB0aGUgdmFyaWFibGVzDQorCSAgPHZhcm5hbWU+R01BS0U8 L3Zhcm5hbWU+IChmb3IgR05VIHZlcnNpb24pIG9yDQorCSAgPHZhcm5hbWU+ Rk1BS0U8L3Zhcm5hbWU+IChmb3IgbGVnYWN5ICZvczsgdmVyc2lvbikgYXJl IGF2YWlsYWJsZS4NCisJICANCisJICBNb3N0DQorCSAgcG9ydHMgc2hvdWxk IG9ubHkgdXNlIDx2YXJuYW1lPk1BS0VfQ01EPC92YXJuYW1lPiB3aXRoaW4N CisJICB0aGVpciA8ZmlsZW5hbWU+TWFrZWZpbGU8L2ZpbGVuYW1lPnMgKHRo YXQgaXMsIHRvIGNhbGwgdGhlIDxjb21tYW5kPm1ha2U8L2NvbW1hbmQ+DQor CSAgaW1wbGVtZW50YXRpb24gZXhwZWN0ZWQgYnkgdGhlIHBvcnRlZCBzb2Z0 d2FyZSkuPC9wYXJhPg0KIA0KLQkgIDx0Z3JvdXAgY29scz0iMiI+DQotCSAg ICA8dGhlYWQ+DQotCSAgICAgIDxyb3c+DQotCQk8ZW50cnk+VmFyaWFibGU8 L2VudHJ5Pg0KLQkJPGVudHJ5Pk1lYW5zPC9lbnRyeT4NCi0JICAgICAgPC9y b3c+DQotCSAgICA8L3RoZWFkPg0KLQ0KLQkgICAgPHRib2R5Pg0KLQkgICAg ICA8cm93Pg0KLQkJPGVudHJ5Pjx2YXJuYW1lPlVTRVM9IGdtYWtlPC92YXJu YW1lPjwvZW50cnk+DQotCQk8ZW50cnk+VGhlIHBvcnQgcmVxdWlyZXMgPGNv bW1hbmQ+Z21ha2U8L2NvbW1hbmQ+IHRvDQotCQkgIGJ1aWxkLjwvZW50cnk+ DQotCSAgICAgIDwvcm93Pg0KLQ0KLQkgICAgICA8cm93Pg0KLQkJPGVudHJ5 Pjx2YXJuYW1lPkdNQUtFPC92YXJuYW1lPjwvZW50cnk+DQotCQk8ZW50cnk+ VGhlIGZ1bGwgcGF0aCBmb3IgPGNvbW1hbmQ+Z21ha2U8L2NvbW1hbmQ+IGlm DQotCQkgIGl0IGlzIG5vdCBpbiB0aGUgPGVudmFyPlBBVEg8L2VudmFyPi48 L2VudHJ5Pg0KLQkgICAgICA8L3Jvdz4NCi0JICAgIDwvdGJvZHk+DQotCSAg PC90Z3JvdXA+DQotCTwvdGFibGU+DQotDQogCTxwYXJhPklmIHlvdXIgcG9y dCBpcyBhbiBYIGFwcGxpY2F0aW9uIHRoYXQgY3JlYXRlcw0KIAkgIDxmaWxl bmFtZT5NYWtlZmlsZTwvZmlsZW5hbWU+IGZpbGVzIGZyb20NCiAJICA8Zmls ZW5hbWU+SW1ha2VmaWxlPC9maWxlbmFtZT4gZmlsZXMgdXNpbmcNCg== --3512871622-1184828063-1390580631=:87046-- From owner-freebsd-doc@FreeBSD.ORG Fri Jan 24 20:56:58 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 89C91C72; Fri, 24 Jan 2014 20:56:58 +0000 (UTC) Received: from dmz-mailsec-scanner-8.mit.edu (dmz-mailsec-scanner-8.mit.edu [18.7.68.37]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C1E3B17B2; Fri, 24 Jan 2014 20:56:57 +0000 (UTC) X-AuditID: 12074425-f79906d000000cf9-2f-52e2d2651911 Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) (using TLS with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-8.mit.edu (Symantec Messaging Gateway) with SMTP id 82.38.03321.562D2E25; Fri, 24 Jan 2014 15:51:49 -0500 (EST) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id s0OKpmWZ002727; Fri, 24 Jan 2014 15:51:49 -0500 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id s0OKpkN8009934 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 24 Jan 2014 15:51:48 -0500 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id s0OKpk3B017448; Fri, 24 Jan 2014 15:51:46 -0500 (EST) Date: Fri, 24 Jan 2014 15:51:46 -0500 (EST) From: Benjamin Kaduk X-X-Sender: kaduk@multics.mit.edu To: Andriy Gapon Subject: Re: Fwd: Re: svn commit: r258713 - in head/sys: kern sys In-Reply-To: <52E21F94.5000104@FreeBSD.org> Message-ID: References: <52D93F91.502@FreeBSD.org> <52E21F94.5000104@FreeBSD.org> 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+NgFvrBIsWRmVeSWpSXmKPExsUixG6nrpt66VGQwZt1MhaTXnWyW0z9uJPV YsOCQgdmjxmf5rMEMEZx2aSk5mSWpRbp2yVwZdz7dIS5YKZmxYsu+wbGnYpdjJwcEgImEvNu 9bFB2GISF+6tB7K5OIQEZjNJ/Hr4H8rZyChx8kEzM4RziEli+62frBBOA6PEoVOnmUD6WQS0 JT6cmMEMYrMJqEk83tvMCjFXUWLzqUlgcREBJYnHS7+wgNjMAhoSe5r2gNnCAo4Sl6/dA6vh BJrTsGcmWC8vUHzKq11g9wkJuEr823sKbJeogI7E6v1TWCBqBCVOznwCNdNS4tyf62wTGIVm IUnNQpJawMi0ilE2JbdKNzcxM6c4NVm3ODkxLy+1SNdCLzezRC81pXQTIziAXVR3ME44pHSI UYCDUYmHd0bgwyAh1sSy4srcQ4ySHExKorxqpx8FCfEl5adUZiQWZ8QXleakFh9ilOBgVhLh nbsZKMebklhZlVqUD5OS5mBREue9xWEfJCSQnliSmp2aWpBaBJOV4eBQkuA9fhGoUbAoNT21 Ii0zpwQhzcTBCTKcB2j4A5Aa3uKCxNzizHSI/ClGRSlx3nsgCQGQREZpHlwvLMG8YhQHekWY 9yRIFQ8wOcF1vwIazAQ0eMXZByCDSxIRUlINjPJHtVx/3PwRtyliSiTnGSPHiVpcy0xPV4je LOPa8kabJ/ZV0drpN99dT78c+voCi8mdidcOqN/dk9FzyNEnTmFqxQq+fbL/rOa97yhKcEvo 5dkn+XbJ6bM2u2c8rHJf1BkzNfKOIUPKx2OttR/rw/gaM1qXXre9FlkUeePvxqr45EWKDctm 7VdiKc5INNRiLipOBAC7wmdFCwMAAA== Cc: hackers@freebsd.org, doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Jan 2014 20:56:58 -0000 On Fri, 24 Jan 2014, Andriy Gapon wrote: > > I would like to commit the following manual page update. > Could you please review it? > Thank you very much! > > -------- Original Message -------- > Message-ID: <52D93F91.502@FreeBSD.org> > Date: Fri, 17 Jan 2014 16:34:57 +0200 > From: Andriy Gapon > To: Justin T. Gibbs > CC: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org > Subject: Re: svn commit: r258713 - in head/sys: kern sys > References: <201311281856.rASIuZu8059699@svn.freebsd.org> > <3784C560-3648-4E03-93DA-9A60E3AC401D@scsiguy.com> > In-Reply-To: <3784C560-3648-4E03-93DA-9A60E3AC401D@scsiguy.com> > > on 30/11/2013 08:46 Justin T. Gibbs said the following: >> Man page update? > > I came up with the following update that > - adds taskqueue_drain_all documentation > - extends taskqueue_drain description > - adds description for previously undocumented taskqueue_block / > taskqueue_unblock, including a warning on taskqueue_block + taskqueue_drain > combination > > All reviews and suggestions are welcome. Both for content and language. > > diff --git a/share/man/man9/taskqueue.9 b/share/man/man9/taskqueue.9 > index 5f6131a..4db3d7a 100644 > --- a/share/man/man9/taskqueue.9 > +++ b/share/man/man9/taskqueue.9 > @@ -86,6 +86,12 @@ struct timeout_task; > .Fn taskqueue_drain "struct taskqueue *queue" "struct task *task" > .Ft void > .Fn taskqueue_drain_timeout "struct taskqueue *queue" "struct timeout_task > *timeout_task" > +.Ft void > +.Fn taskqueue_drain_all "struct taskqueue *queue" > +.Ft void > +.Fn taskqueue_block "struct taskqueue *queue" > +.Ft void > +.Fn taskqueue_unblock "struct taskqueue *queue" > .Ft int > .Fn taskqueue_member "struct taskqueue *queue" "struct thread *td" > .Ft void > @@ -255,6 +261,74 @@ function is used to wait for the scheduled task to finish. > There is no guarantee that the task will not be > enqueued after call to > .Fn taskqueue_drain . > +Because the caller typically would use > +.Fn taskqueue_drain > +to put the task into a known state, then the caller should use This "then" is a bit odd, I think the sentence is better without it. > +out-of-band means to ensure, before calling > +.Fn taskqueue_drain , > +that the task would not be enqueued. > +For example, if the task is enqueued by an interrupt filter, then > +the interrupt could be disabled. > +.Pp > +The > +.Fn taskqueue_drain_all > +function is used to wait for all the pending and running tasks that > +are enqueued on the taskqueue to finish. > +The caller must arrange that the tasks are not re-enqueued. > +Note that > +.Fn taskqueue_drain_all > +currently does not handle tasks with delayed enqueueing. > +.Pp > +The > +.Fn taskqueue_block > +function blocks the taskqueue. > +It prevents any enqueued but not running tasks from being executed. > +Future calls to > +.Fn taskqueue_enqueue > +will enqueue tasks, but the tasks will not be run until > +.Fn taskqueue_unblock > +is called. > +Please note that > +.Fn taskqueue_block > +does not wait for any currently running tasks to finish. > +Thus, the > +.Fn taskqueue_block > +does not provide a guarantee that > +.Fn taskqueue_run > +is not running after > +.Fn taskqueue_block > +returns, but it does provide a guarantee that > +.Fn taskqueue_run > +will not be called again > +until > +.Fn taskqueue_unblock > +is called. > +If the caller requires a guarantee that > +.Fn taskqueue_run > +is not running, then this must be arranged by the caller. > +Note that if > +.Fn taskqueue_drain > +is called on a task that is enqueued on a taskqueue that is blocked by > +.Fn taskqueue_block , > +then > +.Fn taskqueue_drain > +can not return until the taskqueue is unblocked. I would prefer "cannot" as a single word here, though I don't think our style guide says anything about this case. > +This can result in a deadlock if the thread blocked in > +.Fn taskqueue_drain > +is a thread that is supposed to call Is s/a/the/ correct? That is, by my reading, if the thread blocked in taskqueue_drain is only one of several that could call taskqueue_unblock, the other threads would still (eventually) do so and there is no deadlock. So the risk of deadlock would (only?) be if there is only one thread that is supposed to call taskqueue_unblock. > +.Fn taskqueue_unblock . > +Thus, use of > +.Fn taskqueue_drain > +after > +.Fn taskqueue_block > +is discouraged, because a state of the task can not be known in advance. s/ a / the / here is needed, though, I am certain. > +The same applies to I would put another noun here, as "same caveat" or "same warning" or something like that. -Ben > +.Fn taskqueue_drain_all . > +.Pp > +The > +.Fn taskqueue_unblock > +function unblocks the previously blocked taskqueue. > +All enqueued tasks can be run after this call. > .Pp > The > .Fn taskqueue_member > > > -- > Andriy Gapon > > > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > From owner-freebsd-doc@FreeBSD.ORG Sat Jan 25 03:54:24 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 323F1523; Sat, 25 Jan 2014 03:54:24 +0000 (UTC) Received: from relay.mailchannels.net (si-004-i103.relay.mailchannels.net [198.20.121.20]) by mx1.freebsd.org (Postfix) with ESMTP id 1235A18B3; Sat, 25 Jan 2014 03:54:21 +0000 (UTC) X-Sender-Id: _forwarded-from|111.125.78.19 Received: from mail-24.name-services.com (ip-10-244-196-74.us-west-2.compute.internal [10.244.196.74]) by relay.mailchannels.net (Postfix) with ESMTPA id 7734460C25; Sat, 25 Jan 2014 03:54:11 +0000 (UTC) X-Sender-Id: _forwarded-from|111.125.78.19 Received: from mail-24.name-services.com (mail-24.name-services.com [10.246.16.22]) (using TLSv1 with cipher AES128-SHA) by 0.0.0.0:2500 (trex/5.0.19); Sat, 25 Jan 2014 03:54:12 GMT X-MC-Relay: Forwarding X-MailChannels-SenderId: _forwarded-from%7C111.125.78.19 X-MailChannels-Auth-Id: demandmedia Received: from [192.168.111.121] (UnknownHost [111.125.78.19]) by mail-24.name-services.com with SMTP; Fri, 24 Jan 2014 19:54:05 -0800 Message-ID: <52E3354A.1000904@a1poweruser.com> Date: Sat, 25 Jan 2014 11:53:46 +0800 From: Fbsd8 User-Agent: Thunderbird 2.0.0.17 (Windows/20080914) MIME-Version: 1.0 To: Thomas Hoffmann Subject: Re: docs/144515: [handbook] Expand handbook Table of contents References: <201401221442.s0MEgd2o082802@freefall.freebsd.org> <52E075F7.7020105@a1poweruser.com> <20140123020029.GE52955@glenbarber.us> <52E1053A.8000608@a1poweruser.com> <834FD10A-0519-42F1-B804-DCE7428A863F@FreeBSD.org> <52E13ACC.2020005@FreeBSD.org> <52E140D1.5090809@FreeBSD.org> In-Reply-To: Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, Gabor Kovesdan X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 25 Jan 2014 03:54:24 -0000 Thomas Hoffmann wrote: > On Thu, Jan 23, 2014 at 11:18 AM, Gabor Kovesdan > wrote: > > On 2014.01.23. 16 :59, Thomas Hoffmann wrote: > > I agree, the TOC is already too long vertically. Adding > subsections would exacerbate the problem. > > By "horizontal page" I mean taking advantage of the full screen > width, for example, by using multi-columns or similar technique. > That would get more info on each screen page. Compare the TOC > with the x-config.html page ( > http://www.freebsd.org/doc/en___US.ISO8859-1/books/handbook/x-__config.html > ), > which uses the full page width. > > The problem with this is that TOC is a multiple level enumeration by > nature, which is conventionally listed vertically in order. Using > two columns may be confusing for people since it is not > conventional. And if we use 2 columns, what order would it follow? > Like this: > > 1 2 > 1.1 2.1 > 1.2 2.2 > 1.3 2.3 > > Or this: > > 1 > 1.1 1.2 > 1.3 1.4 > > And what to do on smaller screens if the two columns do not fit? > > I believe that a collapsible tree list would be the best option but > that requires JavaScript, which we prefer to avoid... > > Gabor > > > Top to bottom, left to right would be the normal "western" approach, no? > > Personally, I would have no problem with a TOC that only listed the > major chapters. If you want the details sections/subsections) you would > drill (click) down as required: > 1. 6. > 2. 7. > 3 8. > 4. 9. > 5. 10. > > or even > > 1. > 2. > 3. > 4. > 5. > 6. > etc. > > It would require less scrolling, but this might be objectionable to many. > > I understand completely your desire to avoid JS. > > This may simply be an intractable problem. > > -Tom Since the handbook is published using a new tool set, just how does this new tool set auto build the TOC? If I remember correctly there was some posts a while back about forcing the publish tool to not build a complete TOC, ie: dropping the subsections. Maybe the simple solution is to allow the new tool set to build a complete TOC automatically. From owner-freebsd-doc@FreeBSD.ORG Sat Jan 25 12:06:17 2014 Return-Path: Delivered-To: doc@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 1033) id 37763EE2; Sat, 25 Jan 2014 12:06:17 +0000 (UTC) Date: Sat, 25 Jan 2014 12:06:17 +0000 From: Alexey Dokuchaev To: Warren Block Subject: Re: [patch] PH tells crap about GMAKE (Was: Re: svn commit: r340018 - head/textproc/scew) Message-ID: <20140125120617.GA83823@FreeBSD.org> References: <201401170910.s0H9Aw9O087448@svn.freebsd.org> <20140117093546.GA16656@FreeBSD.org> <20140117095020.GD4006@gahrfit.gahr.ch> <20140117141440.GA94157@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.22 (2013-10-16) Cc: doc@freebsd.org, Pietro Cerutti X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 25 Jan 2014 12:06:17 -0000 On Fri, Jan 24, 2014 at 09:23:51AM -0700, Warren Block wrote: > Attached is a quick editing pass. I have not tested it for building yet, > and edited the diff directly, so it has some a new blank line. Look fine to me; I knew that my version was overly wordily. :) Please commit (unless others have any objections). ./danfe From owner-freebsd-doc@FreeBSD.ORG Sat Jan 25 19:05:03 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 7783A981 for ; Sat, 25 Jan 2014 19:05:03 +0000 (UTC) Received: from mail-pd0-x241.google.com (mail-pd0-x241.google.com [IPv6:2607:f8b0:400e:c02::241]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4ABB819F0 for ; Sat, 25 Jan 2014 19:05:03 +0000 (UTC) Received: by mail-pd0-f193.google.com with SMTP id q10so2639120pdj.0 for ; Sat, 25 Jan 2014 11:05:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=message-id:reply-to:from:to:subject:date:mime-version:content-type :thread-index; bh=/CA/dO0eVhkZqzimdmbBQV+Ik2+dWXlbYlYoLY9K5wA=; b=r+0gy5rMb6YYsxBfDF++u7JPmnDiAMQWhG41qrvXH3un61nN7qmHf1hWi3iH7P1bet wAVPjOhr8GqSGlsGCNReiF7C9VIldAYM9Kit3lWJDUF/JK+pO9EfvvaxINqdWXeqqavK Y8cewvqfHIpxzcvto7SohmVC+V23NoGsbe73K8orPflxMTNv5S96GUldgW7p/FkmC9rg tAxDTyly/mZHxGlCHHoCGy4cHTb58kWeVefwx/5V6birgcDZ5Is+Z1zDlme5k5LNRsBT jDavEmsEB869hng2I2AqFIlZMcLA0YkCiFrTSwUFfpu7iHcLp+MNb3zkqWLtniv5lJAs lEiw== X-Received: by 10.68.75.9 with SMTP id y9mr21278081pbv.61.1390676702968; Sat, 25 Jan 2014 11:05:02 -0800 (PST) Received: from TBSPC ([122.177.153.249]) by mx.google.com with ESMTPSA id ns7sm15473601pbc.32.2014.01.25.11.05.00 for (version=TLSv1 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Sat, 25 Jan 2014 11:05:02 -0800 (PST) Message-ID: <52e40ade.87d5440a.4232.00c7@mx.google.com> From: "Ishan Awasthi" To: Subject: First Page In Google Date: Sun, 26 Jan 2014 00:34:45 +0530 MIME-Version: 1.0 X-Mailer: Microsoft Office Outlook, Build 11.0.5510 Thread-Index: Ac8aAE0pLgjpepqmSYuZ9krDCLllUQ== X-MimeOLE: Produced By Microsoft MimeOLE V6.1.7601.17514 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.17 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list Reply-To: seohclltd@gmail.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 25 Jan 2014 19:05:03 -0000 Hello, We are a fast growing company based in India with primary focus on Search Engine Optimzation(SEO), Link building Services. We have a dedicated team of 130 professionals to serve you in building appropriate links and developing SEO. We are working as an outsourced vendor for many reputed SEO agency based in USA, UK, Canada and Australia. Other Affordable Search Engine Optimizations Services Provided By Us:- 1. SEO (Search Engine Optimization) 2. Link Building 3. Press Release 4. Article Submission/Article Writing 5. Blog Submissions/Writing 6. Directory Submission 7. Social Media Optimization. Please let me know If you are Interested in our services. Note: Kindly let me know your phone number and best timing along with time zone to give you a call to discuss more. Kind Regards, Ishan Awasthi