From owner-freebsd-doc Thu May 25 9: 0: 7 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 44D2637C725 for ; Thu, 25 May 2000 09:00:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id JAA89200; Thu, 25 May 2000 09:00:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from news.uni-kl.de (news.uni-kl.de [131.246.137.51]) by hub.freebsd.org (Postfix) with SMTP id C42B837C4C9 for ; Thu, 25 May 2000 08:50:08 -0700 (PDT) (envelope-from naddy@unix-ag.uni-kl.de) Received: from sushi.unix-ag.uni-kl.de ( root@sushi.unix-ag.uni-kl.de [131.246.89.13] ) by news.uni-kl.de id aa12225 for ; 25 May 2000 17:50 MESZ Received: from gnocchi.unix-ag.uni-kl.de (gnocchi.unix-ag.uni-kl.de [131.246.89.12]) by sushi.unix-ag.uni-kl.de (8.9.3/8.9.1) with ESMTP id RAA09083 for ; Thu, 25 May 2000 17:50:01 +0200 Received: (from naddy@localhost) by gnocchi.unix-ag.uni-kl.de (8.9.3/8.9.3) id RAA56255; Thu, 25 May 2000 17:50:15 +0200 (CEST) (envelope-from naddy) Message-Id: <200005251550.RAA56255@gnocchi.unix-ag.uni-kl.de> Date: Thu, 25 May 2000 17:50:15 +0200 (CEST) From: Christian Weisgerber Reply-To: naddy@unix-ag.uni-kl.de To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/18811: Improve uac.1 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 18811 >Category: docs >Synopsis: Improve uac.1 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu May 25 09:00:01 PDT 2000 >Closed-Date: >Last-Modified: >Originator: Christian Weisgerber >Release: FreeBSD 4.0-STABLE alpha >Organization: Unix AG, Uni Kaiserslautern >Environment: alpha >Description: The accompanying patch to the uac.1 man page (src/usr.sbin/uac/uac.1) fixes - some wording, - English usage (somebody more qualified than I am should check this), - nroff end-of-sentence/line agreement. Somebody should decide whether the noun is "bootup", "boot-up", or "boot up" and unify usage throughout the tree. >How-To-Repeat: >Fix: --- /usr/src/usr.bin/uac/uac.1 Thu Jan 27 10:00:51 2000 +++ uac.1 Thu May 25 17:46:22 2000 @@ -35,15 +35,17 @@ .Op Fl fprs .Sh DESCRIPTION .Nm -sets the per-process handling of "Unaligned Access" events. Unlike many -other CPU's the DEC Alpha processor cannot access unaligned data. To work -around this, the Alpha has the ability to fix the UA fault rather than send -the faulting process a +sets the per-process handling of +.Dq unaligned access +events. +Unlike many other CPUs the DEC Alpha processor cannot access unaligned data. +To work around this, the Alpha has the ability to fix the UA fault +rather than send the faulting process a .Dv SIGBUS signal. However, doing so does slow down the execution of the faulting process. -At boot up, the DEC Alpha CPU defaults to printing +At bootup, the DEC Alpha CPU defaults to printing .Bl -tag -width indent .It pid Ar nnn Pq Ar Ns Xo .No : unaligned access: Xo @@ -56,10 +58,10 @@ .Xc .Xc .El -when a UA happens along with fixing it so +when a UA happens, along with fixing it, so the faulting instruction can continue. UA handling settings are inherited by child process. -Issued with out any options, +Issued without any options, .Nm displays the current UA handling for the parent process. .Pp @@ -75,9 +77,8 @@ .It Fl s Unaligned access errors result in a .Dv SIGBUS -being delivered to the parent and -its future descendants. This aid in pin pointing the faulting access so it -debugged. +being delivered to the parent and its future descendants. +This aids in pinpointing the faulting access so it can be debugged. .El .Sh DIAGNOSTICS Exit status is 0 on success, and 1 if the command >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message