[src/trunk]: src/lib/libexecinfo Sort sections.

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/9251738161db
branches:  trunk
changeset: 779419:9251738161db
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun May 27 12:03:02 2012 +0000

description:
Sort sections.
Remove dot at end of Nd
Sort SEE ALSO.
Punctuation fixes.
Bump date to import date.
Comment out a partial sentence.

diffstat:

 lib/libexecinfo/backtrace.3 |  39 ++++++++++++++++++++-------------------
 1 files changed, 20 insertions(+), 19 deletions(-)

diffs (84 lines):

diff -r 979f8c6e6f0d -r 9251738161db lib/libexecinfo/backtrace.3
--- a/lib/libexecinfo/backtrace.3       Sun May 27 11:59:12 2012 +0000
+++ b/lib/libexecinfo/backtrace.3       Sun May 27 12:03:02 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: backtrace.3,v 1.1 2012/05/26 22:02:29 christos Exp $
+.\"    $NetBSD: backtrace.3,v 1.2 2012/05/27 12:03:02 wiz Exp $
 .\"
 .\" Copyright (c) 2012 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,12 +27,12 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 24, 2012
+.Dd May 26, 2012
 .Dt BACKTRACE 3
 .Os
 .Sh NAME
 .Nm backtrace
-.Nd fill in the backtrace of the currently executing thread.
+.Nd fill in the backtrace of the currently executing thread
 .Sh LIBRARY
 .Lb libexecinfo
 .Sh SYNOPSIS
@@ -61,7 +61,7 @@
 .Pp
 The
 .Fn backtrace_symbols_fmt
-function, takes an array of previously filled addresses from
+function takes an array of previously filled addresses from
 .Fn backtrace
 in
 .Fa addrlist
@@ -126,8 +126,17 @@
 on failure, setting
 .Va errno .
 .\" XXX
-Diagnostic output may also be produced, by the ELF symbol lookup functions.
-function returns a pointer to a string that is the parent directory of
+Diagnostic output may also be produced by the ELF symbol lookup functions.
+.\" XXX: what's this?
+.\" function returns a pointer to a string that is the parent directory of
+.Sh SEE ALSO
+.Xr dladdr 3 ,
+.Xr elf 3
+.Sh HISTORY
+The
+.Fn backtrace
+library of functions first appeared in
+.Nx 6 .
 .Sh BUGS
 .Bl -enum
 .It
@@ -135,10 +144,10 @@
 .It
 Because these functions use
 .Xr elf 3
-this is a separate library instead of be part of libc/libutil so that library
-dependencies are not introduced.
+this is a separate library instead of being part of libc/libutil
+so that no library dependencies are introduced.
 .It
-The linux versions of the functions (there are no _fmt variants), use
+The Linux versions of the functions (there are no _fmt variants) use
 .Ft int
 instead of
 .Ft size_t
@@ -148,14 +157,6 @@
 .Xr dladdr 3
 only deals with dynamic symbols, we need to find the symbols from the main
 portion of the program.
-For that we need to locate the executable, and we use procfs for to find it
-which is not portable.
+For that we need to locate the executable, and we use procfs for
+finding it, which is not portable.
 .El
-.Sh SEE ALSO
-.Xr elf 3
-.Xr dladdr 3
-.Sh HISTORY
-The
-.Fn backtrace
-library of functions first appeared in
-.Nx 6 .