Date: Wed, 30 Jan 2013 20:54:43 -0700 From: Warner Losh <imp@bsdimp.com> To: Benjamin Kaduk <kaduk@MIT.EDU> Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org, Eitan Adler <eadler@freebsd.org> Subject: Re: svn commit: r40807 - head/en_US.ISO8859-1/htdocs Message-ID: <CA4B6C93-1CC0-49AB-9BC5-9AAD76848B0B@bsdimp.com> In-Reply-To: <alpine.GSO.1.10.1301292239300.9389@multics.mit.edu> References: <201301292324.r0TNOdit094312@svn.freebsd.org> <alpine.GSO.1.10.1301292239300.9389@multics.mit.edu>
next in thread | previous in thread | raw e-mail | index | archive | help
On Jan 30, 2013, at 8:49 PM, Benjamin Kaduk wrote: > Sorry this didn't come sooner; the latest draft with inline patch is = still in my inbox waiting to be replied to. >=20 > On Tue, 29 Jan 2013, Eitan Adler wrote: >=20 >> Author: eadler >> Date: Tue Jan 29 23:24:39 2013 >> New Revision: 40807 >> URL: http://svnweb.freebsd.org/changeset/doc/40807 >>=20 >> Log: >> Update and modernize the features.xml page >>=20 >> Translators take note: this is a full rewrite. Starting with old >> content will likely not be helpful. >=20 > I will trim large blocks of removed text from the quoted portion. >=20 >> Submitted by: Chris Petrik <c.petrik.sosa@gmail.com> >> Submitted by: Isaac (.ike) Levy <ike@blackskyresearch.net> >> Reviewed by: -doc >> Approved by: bcr (mentor) >>=20 >> Modified: >> head/en_US.ISO8859-1/htdocs/features.xml >>=20 >> Modified: head/en_US.ISO8859-1/htdocs/features.xml >> = =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D >> --- head/en_US.ISO8859-1/htdocs/features.xml Tue Jan 29 22:37:44 2013 = (r40806) >> +++ head/en_US.ISO8859-1/htdocs/features.xml Tue Jan 29 23:24:39 2013 = (r40807) >> @@ -13,222 +13,120 @@ >>=20 >> <body class=3D"navinclude.about"> >>=20 >> - <h1>FreeBSD offers many advanced features.</h1> >> + <h1>&os; offers many unique features.</h1> >>=20 >> + <p>No matter what the application, you want your system's >> + resources performing at their full potential. &os;'s focus >> + on performance, networking, and storage, combined with easy >> + system administration and excellent documentation to allow >=20 > "easy system administration" feels like it lacks proper parallelism = here; "its ease of system administration" is probably better. >=20 >> + you to do what you want.</p> >>=20 >> <h2>A complete operating system based on 4.4BSD.</h2> >>=20 >> + <p>&os;'s distinguished roots derive from the <b>BSD</b> >> + software releases from the Computer Systems Research Group at >> + the University of California, Berkeley. Over fifteen years of >=20 > FreeBSD 2.0 was 1995, no? That would be seventeen years, which is not = as round a number, I guess. FreeBSD 1.0 was in 1993. So over twenty years have been put into = improving it.... =20 >> + work have been put into enhancing &os;, adding >> + industry-leading scalability, network performance, management >> + tools, file systems, and security features. As a result, >> + &os; may be found across the Internet, in the operating system >> + of core router products, running root name servers, hosting >> + major web sites, and as the foundation for widely used desktop >> + operating systems. This is only possible because of the >> + diverse and world-wide membership of the >> + volunteer &os; Project.</p> >> + >> + <p><b>&os; 9.0</b>, brings many new features >> + and performance enhancements with a special focus on desktop >> + support and security features.</p> >>=20 >> <ul> >> + <li><b>Capsicum Capability Mode</b>: >> + Capsicum is a set of features for sandboxing support, using >> + a capability model in which the capabilities are file >> + descriptors. Two new kernel options CAPABILITIES and >> + CAPABILITY_MODE have been added to the GENERIC kernel.</li> >> + >> + <li><b>Hhook</b>: (Helper Hook) and khelp(9) (Kernel Helpers) >> + KPIs have been implemented. These are a kind of superset of >> + pfil(9) framework for more general use in the kernel. The >=20 > This sentence's grammar is pretty lousy. "kind of" should arguably = removed, and there are other issues. >=20 > It's really too bad that we don't get entities for man pages, here (or = do we?). Hyperlinks would be handy. >=20 >> + hhook(9) KPI provides a way for kernel subsystems to export >> + hook points that khelp(9) modules can hook to provide >> + enhanced or new functionality to the kernel. The khelp(9) >> + KPI provides a framework for managing khelp(9) modules, >> + which indirectly use the hhook(9) KPI to register their hook >> + functions with hook points of interest within the kernel. >> + These allow a structured way to dynamically extend the >> + kernel at runtime in an ABI preserving manner.</li> >> + <li><b>Accounting API:</b> has been implemented. It can keep >> + per-process, per-jail, and per-loginclass resource >=20 > login class takes a space (or a hyphen), at least in login.1. >=20 >> + accounting information. Note that this is not built nor >=20 > I believe that "neither ... nor" is the more conventional usage. >=20 >> + installed by default. To build and install them, specify >=20 > "this" (above) and "them" are inconsistent. >=20 >> + options RACCT in the kernel configuration file and rebuild >=20 > <tt class=3D"LITERAL">? >=20 >> + the base system as described in the FreeBSD Handbook</li> >=20 > Could link to a more specific page... >=20 >> + >> + <li><b>Resource-limiting API:</b> has been implemented. >> + It works in conjunction with the RACCT resource accounting >> + implementation and takes user-configurable actions based on >> + the set of rules it maintains and the current resource >> + usage. The rctl(8) utility has been added to manage the >> + rules in userland. Note that this is not built nor >=20 > "neither" again. >=20 >> + installed by default.</li> >> + >> + <li><b>Usb:</b> subsystem now supports USB packet filter. >=20 > Not a complete sentence. >=20 >> + This allows to capture packets which go through each USB >=20 > "allows to capture" is very awkward. "allows capturing" or similar? >=20 >> + host controller. The implementation is almost based on >> + bpf(4) code. The userland program usbdump(8) has been >=20 > This sentence does not realy convey any useful information. > Grabbing at straws, I think the intent is "The architecture of the = packet filter is similar to that of bpf(4)." >=20 >> + added.</li> >> + >> + <li><b>Infiniband support:</b>, OFED (OpenFabrics Enterprise >> + Distribution) version 1.5.3 has been imported into the >> + base system.</li> >> + <li><b>TCP/IP network:</b> stack now supports the mod_cc(9) >> + pluggable congestion control framework. This allows TCP >=20 > Not a complete sentence. >=20 >> + congestion control algorithms to be implemented as >> + dynamically loadable kernel modules. The following kernel >> + modules are available cc_chd(4) for the CAIA-Hamilton-Delay >=20 > Some punctuation is neede before the list, most likely a colon. >=20 >> + algorithm, cc_cubic(4) for the CUBIC algorithm, cc_hd(4) >> + for the Hamilton-Delay algorithm, cc_htcp(4) for the H-TCP >> + algorithm, cc_newreno(4) for the NewReno algorithm, and >> + cc_vegas(4) for the Vegas algorithm. The default algorithm >> + can be set by a new sysctl(8) variable >> + net. inet. tcp. cc. algorithm.</li> >=20 > Something seems horribly wrong with the formatting of this MIB entry. >=20 >> + >> + <li><b>SU+J:</b> &os; Fast File System now supports soft >> + updates with journaling. It introduces an intent log into a >=20 > That's "FreeBSD's FFS" (possessive). >=20 >> + softupdates-enabled file system which eliminates the need for >> + background fsck(8) even on unclean shutdowns.</li> >> </ul> >>=20 >> + <p><b>&os; 8.x</b> brings many new >=20 > Whitespace looks funky here? >=20 >> + features and performance enhancements. With special focus on >> + a new USB stack, &os;-8.x shipped with experimental support >> + for NFSv4. As well as a new TTY layer. Which improves >=20 > Not a complete sentence. >=20 >> + scalability and resources handling in SMP enabled systems.</p> >=20 > Nor this. >=20 >>=20 >> <ul> >> + <li><b>Netisr framework:</b> has been reimplemented for >> + parallel threading support. This is a kernel network >=20 > (Nor this. The document seems to switch what format it uses for list = entries midway through, it seems.) >=20 >> + dispatch interface which allows device drivers (and other >> + packet sources) to direct packets to protocols for directly >> + dispatched or deferred processing. The new implementation >> + supports up to one netisr thread per CPU, and several >> + benchmarks on SMP machines show substantial performance >> + improvement over the previous version.</li> >> + >> + <li><b>Linux emulation:</b> layer has been updated to version >> + 2. 6. 16 and the default Linux infrastructure port is now >=20 > Looks like someone got too enthusiastic about french spacing at the = end of sentences... >=20 >> + emulators/linux_base-f10 (Fedora 10)</li> >=20 > Markup for the port name? >=20 >> + <li><b>Network Virtualization:</b> Container named vimage has >=20 > What does "container named vimage" mean? >=20 >> + been implemented, extending the FreeBSD kernel to maintain >> + multiple independent instances of networking state. >> + vimage facilities can be used independently to create fully >=20 > Sentence starts with a lowercase letter. >=20 > -Ben >=20 >> + virtualized network topologies, and jail(8) can directly >> + take advantage of a fully virtualized network stack.</li> >> </ul>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CA4B6C93-1CC0-49AB-9BC5-9AAD76848B0B>