[src/trunk]: src/lib/libc/db/man .Fn, offset indent, complete reference.

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

details:   https://anonhg.NetBSD.org/src/rev/c19e520515d3
branches:  trunk
changeset: 759770:c19e520515d3
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Thu Dec 16 12:08:16 2010 +0000

description:
.Fn, offset indent, complete reference.

diffstat:

 lib/libc/db/man/dbopen.3 |  34 +++++++++++++++++++---------------
 1 files changed, 19 insertions(+), 15 deletions(-)

diffs (99 lines):

diff -r ab9ffe3600ef -r c19e520515d3 lib/libc/db/man/dbopen.3
--- a/lib/libc/db/man/dbopen.3  Thu Dec 16 11:57:20 2010 +0000
+++ b/lib/libc/db/man/dbopen.3  Thu Dec 16 12:08:16 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dbopen.3,v 1.18 2010/03/22 19:30:53 joerg Exp $
+.\"    $NetBSD: dbopen.3,v 1.19 2010/12/16 12:08:16 jruoho Exp $
 .\"
 .\" Copyright (c) 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"    @(#)dbopen.3    8.5 (Berkeley) 1/2/94
 .\"
-.Dd April 17, 2003
+.Dd December 16, 2010
 .Dt DBOPEN 3
 .Os
 .Sh NAME
@@ -60,8 +60,9 @@
 and
 .Xr recno 3 .
 .Pp
-.Nm
-opens
+The
+.Fn dbopen
+function opens
 .Fa file
 for reading and/or writing.
 Files never intended to be preserved on disk may be created by setting
@@ -134,15 +135,16 @@
 .Dv NULL ,
 each access method will use defaults appropriate for the system and
 the access method.
-.Pp
-.Nm
-returns a pointer to a DB structure on success and
+.Ss The DB Structure
+The
+.Fn dbopen
+function returns a pointer to a DB structure on success and
 .Dv NULL
 on error.
 The DB structure is defined in the
 .In db.h
 include file, and contains at least the following fields:
-.Bd -literal
+.Bd -literal -offset indent
 typedef struct {
        DBTYPE type;
        int (*close)(const DB *db);
@@ -162,7 +164,7 @@
 .Nm ,
 and sometimes one or more pointers to key/data structures and a flag
 value.
-.Bl -tag -width closex
+.Bl -tag -width closex -offset indent
 .It Fa type
 The type of the underlying access method (and file format).
 .It Fa close
@@ -420,10 +422,10 @@
 .Va errno )
 and 0 on success.
 .El
-.Ss KEY/DATA PAIRS
+.Ss Key/data Pairs
 Access to all file types is based on key/data pairs.
 Both keys and data are represented by the following data structure:
-.Bd -literal
+.Bd -literal -offset indent
 typedef struct {
        void *data;
        size_t size;
@@ -431,7 +433,7 @@
 .Ed
 .Pp
 The elements of the DBT structure are defined as follows:
-.Bl -tag -width datax
+.Bl -tag -width datax -offset indent
 .It Fa data
 A pointer to a byte string.
 .It Fa size
@@ -515,11 +517,13 @@
 .Xr recno 3
 .Pp
 .Rs
-.%T "LIBTP: Portable, Modular Transactions for UNIX"
+.%T LIBTP: Portable, Modular Transactions for UNIX
 .%A Margo Seltzer
 .%A Michael Olson
-.%J USENIX proceedings
-.%D Winter 1992
+.%I USENIX Association
+.%B Proceedings of the 1992 Winter USENIX Technical Conference
+.%D 1992
+.%P 9-25
 .Re
 .Sh BUGS
 The typedef DBT is a mnemonic for