From 61768b0b173ef26adb2460ce6df48a83245c93b4 Mon Sep 17 00:00:00 2001 From: hrs Date: Wed, 29 Apr 2009 17:50:48 +0000 Subject: [PATCH] Various wording/grammar fixes. Suggested by: keramida Approved by: re (implicit) git-svn-id: svn://svn.freebsd.org/base/releng/7.2@191669 ccf9f872-aa2e-dd11-9fc8-001c23d0bc1f --- .../doc/en_US.ISO8859-1/relnotes/article.sgml | 254 +++++++++--------- 1 file changed, 132 insertions(+), 122 deletions(-) diff --git a/release/doc/en_US.ISO8859-1/relnotes/article.sgml b/release/doc/en_US.ISO8859-1/relnotes/article.sgml index 4d708d6a..cde6e621 100644 --- a/release/doc/en_US.ISO8859-1/relnotes/article.sgml +++ b/release/doc/en_US.ISO8859-1/relnotes/article.sgml @@ -279,29 +279,31 @@ KTR_CALLOUT class to note when a callout routine finishes executing. - Types of variables used to track amount of allocated + Types of variables used to track the amount of allocated System V shared memory have been changed from int to size_t. This - makes it possible to use more than 2 GB shared memory segments - on 64-bit architectures. Please note the new BUGS section in - &man.shmctl.2; and /usr/src/UPDATING for - limitations of this temporary solution. + makes it possible to use more than 2 GB of memory for shared + memory segments on 64-bit architectures. Please note the new + BUGS section in &man.shmctl.2; and + /usr/src/UPDATING for limitations of this + temporary solution. - A &man.sysctl.3; leaf node has a flag to tag itself as - MPSAFE now. + The &man.sysctl.3; leaf nodes have a flag to tag + themselves as MPSAFE now. The &os; 32-bit system call translation layer now supports installing 32-bit system calls for VFS_AIO. The &os; virtual memory subsystem now - supports Superpages. The Superpages is a feature that enables - each entry in the TLB (translation lookaside buffer) to map a - large physical memory region into a virtual address space in - modern CPUs. This provides possible memory savings for - applications that share large amounts of memory between the - address spaces and performance improvements due to fewer TLB - misses. This is disabled by default and can be enabled by + supports Superpages. The + Superpages is a feature that + enables each entry in the TLB (translation lookaside buffer) + to map a large physical memory region into a virtual address + space in modern CPUs. This provides possible memory savings + for applications that share large amounts of memory between + the address spaces and performance improvements due to fewer + TLB misses. This is disabled by default and can be enabled by setting a loader tunable vm.pmap.pg_ps_enabled to 1. @@ -330,7 +332,7 @@ Hardware Support The &os; now supports Ultra SPARC III - (Cheetah) family. + (Cheetah) processor family. The &man.acpi.4; subsystem now supports a &man.sysctl.8; variable debug.batt.batt_sleep_ms. On @@ -347,9 +349,10 @@ The &man.cpuctl.4; driver, which provides a special device /dev/cpuctl as an interface to - the system CPU has been added. The functionality includes - to retrieve CPUID information, read/write machine specific - registers (MSR), and perform CPU firmware updates. + the system CPU has been added. The &man.cpuctl.4; + functionality includes the ability to retrieve CPUID + information, read/write machine specific registers (MSR), + and perform CPU firmware updates. The &man.cpufreq.4; driver now supports an hw.est.msr_info loader tunable. When @@ -365,11 +368,11 @@ added to force this behavior by setting it to non-zero. - The &man.atkbd.4; now disables the interrupt handler - which is called from the keyboard callback function when - polled mode is enabled. This fixes duplicated/missing - characters problem at mountroot on multi CPU systems while - &man.kbdmux.4; is enabled. + The &man.atkbd.4; driver now disables the interrupt + handler which is called from the keyboard callback function + when polled mode is enabled. This fixes the problem of + duplicated/missing characters at the mountroot prompt on + multi CPU systems while &man.kbdmux.4; is enabled. In the &man.pci.4; subsystem INTx is now disabled when MSI/MSIX is enabled. This change fixes interrupt storm @@ -395,8 +398,8 @@ Multimedia Support - The &man.agp.4; now supports Intel G4X series graphics - chipsets. + The &man.agp.4; driver now supports Intel G4X series + graphics chipsets. The DRM, a kernel module named Direct Rendering Manager that gives direct hardware access to DRI clients, @@ -404,28 +407,30 @@ and IGP based chips, XGI V3XE/V5/V8, and Intel i915 chipsets has been improved. - A new loader tunable hw.drm.msi - which controls if DRM uses MSI or not. This is set to - 1 (enabled) by default. + A new loader tunable hw.drm.msi has + been added to control if DRM uses MSI or not. This is set + to 1 (enabled) by default. The snd_au88x0(4) driver for Aureal Vortex 1/2/Advantage PCI has been removed because this was broken for a long time. - The &man.snd.hda.4; driver has been updated. Changes - include: multiple codec per HDA bus, multiple functional - groups per codec, multiple audio devices per functional - group, digital (SPDIF/HDMI) audio input/output, - suspend/resume, and part of multichannel audio. + The &man.snd.hda.4; driver has been updated. This + changes include support for multiple codec per HDA bus, + multiple functional groups per codec, multiple audio + devices per functional group, digital (SPDIF/HDMI) audio + input/output, suspend/resume, and part of multichannel + audio. Note that due to added HDMI audio and logical audio - devices support, updated driver often provides several PCM - devices. In some cases it can make system default audio - device no longer corresponding to the users's habitual - audio connectors. In such cases the default device can be - specified in audio application setup or defined globally - via hw.snd.default_unit sysctl - as described in the &man.sound.4; manual page. + devices support, the updated driver often provides several + PCM devices. This means that in some cases the system + default audio device no longer corresponds to the users's + habitual audio connectors. In such cases the default + device can be specified in audio applications' setup or + defined globally via hw.snd.default_unit + sysctl, as described in the &man.sound.4; manual + page. @@ -451,8 +456,8 @@ The ciphy(4) driver now supports Vitesse VSC8211 PHY. - The &man.cxgb.4; driver has been updated to the - firmware revision 4.7 and now supports hardware MAC + The &man.cxgb.4; driver has been updated to firmware + revision 4.7 and now supports hardware MAC statistics. The &man.fxp.4; driver has been improved. Changes include: @@ -477,7 +482,7 @@ WoL (Wake on LAN) support for 82550, 82551, 82558, and 82559-based controllers has been added. Note that ICH based controllers are treated as 82559, and 82557, - earlier revision of 82558, and 82559ER have no WoL + earlier revisions of 82558, and 82559ER have no WoL capability. @@ -490,9 +495,9 @@ - A bug in &man.igb.4; driver which prevents a loader - tunable hw.igb.ave_latency from working - has been fixed. + A bug in the &man.igb.4; driver, which prevents the + loader tunable hw.igb.ave_latency from + working, has been fixed. The &man.ixgbe.4; driver has been updated to version 1.7.4. @@ -502,7 +507,7 @@ The &man.msk.4; driver has been improved. An issue which makes it hang up in a certain condition has been - fixed. A hardware MAC statistics support has been added + fixed. Hardware MAC statistics support has been added and users can get the information via sysctl variables named dev.msk.N.stats. @@ -516,9 +521,10 @@ The &man.re.4; driver has been improved. It now detects the link status. A new loader tunable - hw.re.prefer_iomap to disable memory - register mapping. This tunable is 0 - for all controllers except RTL8169SC family. + hw.re.prefer_iomap has been added, to + disable memory register mapping. This tunable is + 0 for all controllers except RTL8169SC + family. The &man.rl.4; driver has been improved. It now detects the link status and a bug which prevents it from @@ -529,16 +535,16 @@ been fixed. The &man.txp.4; driver now works on all supported - architecture. Also, &man.altq.4; support, WoL support, - checksum offload when VLAN enabled, better link state - change handling, a new sysctl variable + architectures. Support has been added for &man.altq.4;, + WoL, checksum offload when VLAN enabled, and link state + change handling has been improved, and new sysctl + variables dev.txp.N.stats - for MAC statistics have been added. A new sysctl - variable + for MAC statistics have been added. New sysctl variables dev.txp.N.process_limit - to control how many received frames should be served in Rx - handler (set to 64 by default and valid ranges are 16 to - 128 in unit of frames) has been added. The firmware has + has been added, to control how many received frames should + be served in Rx handler (set to 64 by default and valid + ranges are 16 to 128 in unit of frames). The firmware has been updated to the latest version. @@ -575,23 +581,24 @@ been implemented in the same way it has been implemented for IPv4. - The &man.ng.netflow.4; Netgraph node now supports - ability to generate egress netflow instead or in addition to - ingress. An NGM_NETFLOW_SETCONFIG control - message has been added to control the new functionality. + The &man.ng.netflow.4; Netgraph node now includes + support for generating egress netflow instead or in addition + to ingress. An NGM_NETFLOW_SETCONFIG + control message has been added to control the new + functionality. - The &man.tap.4;, Ethernet tunnel software network - interface now supports TAPGIFNAME + The &man.tap.4; Ethernet tunnel software network + interface now supports a new TAPGIFNAME character device ioctl. This is a convenient shortcut to - obtain network interface name using file descriptor for - character device. + obtain the network interface name using a file descriptor to + a character device. The &man.tap.4; now supports SIOCSIFMTU ioctl to set a higher MTU than - 1500 (ETHERMTU). This allows &man.tap.4; device to be added - to a bridge, which requires all interface members to have - the same MTU, with an interface configured for jumbo - frames. + 1500 (ETHERMTU). This allows &man.tap.4; devices to be + added to the same bridge (which requires all interface + members to have the same MTU) with an interface configured + for jumbo frames. The domains list for handling the list of supported domains in the &man.unix.4; (UNIX domain protocol family) @@ -606,11 +613,11 @@ The &man.ata.4; driver now recognizes nForce MCP67 and MCP73 SATA controllers as AHCI. - The &man.ataraid.4; driver now has an initial support + The &man.ataraid.4; driver now includes preliminary support for DDF metadata found on Adaptec HostRAID controllers. Note that spares and rebuilds are not supported yet. - The &man.cam.4; SCSI subsystem now supports a sysctl + The &man.cam.4; SCSI subsystem now supports a new sysctl variable kern.cam.cd.retry_count. This controls the number of retries for the CD media. When trying to read scratched or damaged CDs and DVDs, the @@ -618,18 +625,18 @@ ddrescue do much better if you turn off the retries entirely since their algorithms do it by themselves. This value is set to 4 - (for a total 5 attempts) by default. Setting to 0 turns off - all retry attempts. + (for a total of 5 attempts) by default. Setting it to + 0 turns off all retry attempts. A bug in the &man.ciss.4; driver which caused low - max device openings count that has led - to poor performance has been fixed. + max device openings count and led to poor + performance has been fixed. The &man.glabel.8; GEOM class now supports a new UFS-based label called ufsid that can be used to reference UFS-carrying devices by the unique file system ID. This file system ID is automatically generated - and detected when &man.glabel.8; GEOM class is enabled. An + and detected when the &man.glabel.8; GEOM class is enabled. An example of this new label is: /dev/ufsid/48e69c8b5c8e1b43. The benefit of using GEOM labels in general is to avoid problems @@ -638,15 +645,15 @@ The &man.gjournal.8; GEOM class now supports the root file system. Previously, an unclean shutdown would make it - impossible to mount root file system at boot. + impossible to mount the root file system at boot. The &man.gpart.8; utility has been updated. The APM scheme now supports Tivo Series 1 partitions (read only), a new EBR scheme to support Extended Boot Records has been - added, the BSD scheme now support bootcode, and bugs in PC98 - and VTOC8 scheme have been fixed. + added, the BSD scheme now support bootcode, and bugs in the + PC98 and VTOC8 schemes have been fixed. - An issue in the &man.gvinum.8; with access permissions + An issue in &man.gvinum.8; with access permissions to underlying disks used by a gvinum plex has been fixed. If the plex is a raid5 plex and is being written to, parity data might have to be read from the underlying disks, requiring them to be opened for @@ -655,7 +662,7 @@ The &man.hptmv.4; driver has been updated to version 1.16 from the vendor. - The &man.mmc.4; and &man.mmcsd.4; driver now support MMC + The &man.mmc.4; and &man.mmcsd.4; drivers now support MMC and SDHC cards, high speed timing, wide bus, and multiblock transfers. @@ -663,8 +670,8 @@ GENERIC kernel. The &man.sdhci.4; driver has been added. This supports - PCI devices with class 8 and subclass 5 according to SD Host - Controller Specification. + PCI devices with class 8 and subclass 5 according to the SD + Host Controller Specification. The &man.sdhci.4; driver now supports kernel dumping and a sysctl variable hw.sdhci.debug for debug @@ -673,24 +680,24 @@ The &man.twa.4; driver now supports 64-bit DMA. The &man.mmc.4; &man.mmcsd.4;, and &man.sdhci.4; driver - are now included as a kernel module. + are now included as kernel modules. File Systems The semantics of &man.acl.3; extended access control - list has been changed as follows: + lists has been changed as follows: The inode modification time (mtime) is not updated - when extended attribute are added, modified, or removed. + when extended attributes are added, modified, or removed. The inode access time (atime) is not updated - when extended attribute are queried. + when extended attributes are queried. @@ -706,7 +713,7 @@ The &os; UDF file system now supports a fifo. The shared vnode locking for pathname lookups in - &man.VFS.9; subsystem has been improved. This is disabled + the &man.VFS.9; subsystem has been improved. This is disabled by default. Setting a sysctl variable vfs.lookup_shared to 1 enables it for better performance. Note that the @@ -718,7 +725,7 @@ Userland Changes - A bug in the &man.atacontrol.8; utility which prevents it + A bug in the &man.atacontrol.8; utility, which prevents it from working when /usr is not mounted or invoked from /rescue, has been fixed. @@ -742,8 +749,8 @@ in the same way that &man.basename.1; does. The &man.du.1; utility now supports an - flag. When specified, the &man.du.1; counts a file with - multiple hard links as multiple different files. + flag. When specified, the &man.du.1; utility counts a file + with multiple hard links as multiple different files. The &man.du.1; utility now supports an flag to display the apparent size instead of the disk usage. This can be @@ -751,11 +758,12 @@ The &man.du.1; utility now supports a option to - calculate block counts in blocksize byte blocks. This is - different from the or - options or setting BLOCKSIZE and gives an - estimate of how much space the examined file hierarchy would - require on a file system with the given + calculate block counts in blocks of + blocksize bytes. This is different + from the or options or + setting BLOCKSIZE and gives an estimate of + how much space the examined file hierarchy would require on a + file system with the given blocksize. Unless in mode, blocksize is rounded up to the next multiple of 512. @@ -774,12 +782,12 @@ both compact and more script-friendly representation. The &man.fetch.1; utility now supports an - flag which supports If-Modified-Since HTTP - 1.1 request. If specified it will cause the file to be + flag which supports the If-Modified-Since + HTTP 1.1 request. If specified it will cause the file to be downloaded only if it is more recent than the mtime of the - file. Also, libfetch now accepts - the mtime in the url structure and a flag to indicate when - this behavior is desired. + local file. Also, libfetch now + accepts the mtime in the url structure and a flag to indicate + when this behavior is desired. The &man.fsck.8; utility now supports a flag for check clean @@ -793,7 +801,7 @@ &man.fsck.8; to survive with file systems that has very serious data damage. This is a useful last resort when on disk data damage is very serious and causes &man.fsck.8; to - crash otherwise. + crash. The &man.getaddrinfo.3; function now supports SCTP. @@ -807,9 +815,9 @@ issue a warning message. The &man.make.1; utility now supports a - flag to print the input graph only, not - executing any commands. The output is the same as . When combined with flag to print the input graph only, + without executing any commands. The output is the same as + . When combined with , only the built-in rules of make are displayed. @@ -821,22 +829,22 @@ The &man.make.1; utility now supports the .MAKE.JOB.PREFIX variable. If - and are specified, it - outputs for each target is prefixed with a token --- + and are specified, its + output for each target is prefixed with a token --- target --- the first part of which can be controlled via the variable. The &man.make.1; utility now supports .MAKE.PID and .MAKE.PPID variable. These are set to process ID of the &man.make.1; - process and one of its parent process respectively. + process and its parent process respectively. The &man.makefs.8; utility to create a file system image from a directory tree has been added. The &man.mergemaster.8; utility now supports an option to automatically install files that - differ only in version control ID strings. + differ only in their version control ID strings. The &man.mount.8; utility now supports an @@ -846,7 +854,7 @@ FUSE, for example. The &man.netstat.1; utility now reports &man.unix.4; - sockets listen queue statistics when an + sockets' listen queue statistics when an flag is specified. A bug in the &man.netstat.1; utility has been fixed. It @@ -867,13 +875,14 @@ The &man.powerd.8; program has been improved. Changes include reasonable CPU load estimation on SMP systems and a new mode named as hiadaptive for AC-powered - systems which rises frequency twice faster, drops it 4 times - slower, prefers twice lower CPU load and has additional delay - before leaving the highest frequency after the period of - maximum load. + systems. The hiadaptive mode raises the + CPU frequency twice as fast as adaptive, it + drops the CPU frequency 4 times slower, prefers twice lower + CPU load and has an additional delay before leaving the + highest frequency after the period of maximum load. The &man.stat.1; utility now displays an octal - representation of suid, sgid and sticky bits when an + representation of suid, sgid and sticky bits when the flag is specified. The &man.strndup.3; function has been added. @@ -882,9 +891,9 @@ flag to output the number of characters in the longest input line. - A bug in the &man.rpc.yppasswdd.8; program which leaves a - zombie process when a password or default shell is changed has - been fixed. + A bug in the &man.rpc.yppasswdd.8; program, which causes + it to leave a zombie process when a password or default shell + is changed, has been fixed.