summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJoel Dahl <joel@FreeBSD.org>2012-06-02 08:47:26 +0000
committerJoel Dahl <joel@FreeBSD.org>2012-06-02 08:47:26 +0000
commit9ee2158b550b70d35c13246cf263ff24d283e062 (patch)
tree9a7ad4b9911b70d7cea7162197e15d6d6ef1c70b
parentb9c473b2ed7cb81aa7520a55311f53283d1c15ec (diff)
downloadsrc-test2-9ee2158b550b70d35c13246cf263ff24d283e062.tar.gz
src-test2-9ee2158b550b70d35c13246cf263ff24d283e062.zip
Notes
-rw-r--r--lib/libc/gen/posix_spawnattr_getflags.32
-rw-r--r--lib/libcrypt/crypt.32
-rw-r--r--lib/libelf/elf.316
-rw-r--r--lib/libelf/gelf.314
-rw-r--r--lib/libgpib/gpib.310
-rw-r--r--lib/libpmc/pmc.322
-rw-r--r--lib/libusb/libusb20.39
7 files changed, 42 insertions, 33 deletions
diff --git a/lib/libc/gen/posix_spawnattr_getflags.3 b/lib/libc/gen/posix_spawnattr_getflags.3
index a2dda02c128b..4064011f1d0e 100644
--- a/lib/libc/gen/posix_spawnattr_getflags.3
+++ b/lib/libc/gen/posix_spawnattr_getflags.3
@@ -70,7 +70,7 @@ or
It is the bitwise-inclusive OR of zero or more of the following flags
(see
.Fn posix_spawn ) :
-.Bl -tag -offset indent
+.Bl -tag -width "POSIX_SPAWN_SETSCHEDPARAM" -offset indent
.It Dv POSIX_SPAWN_RESETIDS
.It Dv POSIX_SPAWN_SETPGROUP
.It Dv POSIX_SPAWN_SETSIGDEF
diff --git a/lib/libcrypt/crypt.3 b/lib/libcrypt/crypt.3
index 949a7a70e46f..535ccdd4df56 100644
--- a/lib/libcrypt/crypt.3
+++ b/lib/libcrypt/crypt.3
@@ -196,7 +196,7 @@ SHA-512
.Pp
Other crypt formats may be easily added.
An example salt would be:
-.Bl -tag -offset indent
+.Bl -tag -width 6n -offset indent
.It Cm "$4$thesalt$rest"
.El
.Ss "Traditional" crypt:
diff --git a/lib/libelf/elf.3 b/lib/libelf/elf.3
index 609fab60c0a2..35bba9c3e8ee 100644
--- a/lib/libelf/elf.3
+++ b/lib/libelf/elf.3
@@ -385,9 +385,9 @@ See
This section contains a brief overview of the available functionality
in the ELF library.
Each function listed here is described further in its own manual page.
-.Bl -tag -width indent
+.Bl -tag -width 2n
.It "Archive Access"
-.Bl -tag -compact
+.Bl -tag -width 17n -compact
.It Fn elf_getarsym
Retrieve the archive symbol table.
.It Fn elf_getarhdr
@@ -404,7 +404,7 @@ Random access inside an
archive.
.El
.It "Data Structures"
-.Bl -tag -compact
+.Bl -tag -width 17n -compact
.It Fn elf_getdata
Retrieve translated data for an ELF section.
.It Fn elf_getscn
@@ -437,7 +437,7 @@ Allocate an Executable Header in an ELF object.
Allocate or resize the Program Header Table in an ELF object.
.El
.It "Data Translation"
-.Bl -tag -compact
+.Bl -tag -width 17n -compact
.It Fn elf32_xlatetof , Fn elf64_xlatetof
Translate an ELF data structure from its native representation to its
file representation.
@@ -446,14 +446,14 @@ Translate an ELF data structure from its file representation to a
native representation.
.El
.It "Error Reporting"
-.Bl -tag -compact
+.Bl -tag -width 17n -compact
.It Fn elf_errno
Retrieve the current error.
.It Fn elf_errmsg
Retrieve a human readable description of the current error.
.El
.It "Initialization"
-.Bl -tag -compact
+.Bl -tag -width 17n -compact
.It Fn elf_begin
Opens an
.Xr ar 1
@@ -468,7 +468,7 @@ archive or ELF object present in a memory area.
Sets the operating version.
.El
.It "IO Control"
-.Bl -tag -width ".Fn elf_setshstrndx" -compact
+.Bl -tag -width 17n -compact
.It Fn elf_cntl
Manage the association between and ELF descriptor and its underlying file.
.It Fn elf_flagdata
@@ -492,7 +492,7 @@ Recompute ELF object layout and optionally write the modified object
back to the underlying file.
.El
.It "Queries"
-.Bl -tag -width ".Fn elf_getshstrndx" -compact
+.Bl -tag -width 17n -compact
.It Fn elf32_checksum , Fn elf64_checkum
Compute checksum of an ELF object.
.It Fn elf_getident
diff --git a/lib/libelf/gelf.3 b/lib/libelf/gelf.3
index d541388aee39..1c2f0108f6c7 100644
--- a/lib/libelf/gelf.3
+++ b/lib/libelf/gelf.3
@@ -115,7 +115,7 @@ routines will signal an error if a GElf value is out of range
for the underlying ELF data type.
.Ss Namespace use
The GElf interface uses the following symbols:
-.Bl -tag
+.Bl -tag -width 8n
.It GElf_*
Class-independent data types.
.It gelf_*
@@ -125,16 +125,16 @@ For functions defined in the API set.
This section provides an overview of the GElf programming APIs.
Further information is provided in the manual page of each function
listed here.
-.Bl -tag
+.Bl -tag -width 2n
.It "Allocating ELF Data Structures"
-.Bl -tag -compact
+.Bl -tag -width 19n -compact
.It Fn gelf_newehdr
Allocate a new ELF Executable Header.
.It Fn gelf_newphdr
Allocate a new ELF Program Header Table.
.El
.It "Data Translation"
-.Bl -tag -compact
+.Bl -tag -width 19n -compact
.It Fn gelf_xlatetof
Translate the native representation of an ELF data structure to its
file representation.
@@ -143,7 +143,7 @@ Translate from the file representation of an ELF data structure to a
native representation.
.El
.It "Retrieving ELF Data"
-.Bl -tag -compact
+.Bl -tag -width 19n -compact
.It Fn gelf_getdyn
Retrieve an ELF
.Sy .dynamic
@@ -162,7 +162,7 @@ Retrieve an ELF Section Header Table entry from the underlying ELF descriptor.
Retrieve an ELF symbol table entry.
.El
.It Queries
-.Bl -tag -compact
+.Bl -tag -width 19n -compact
.It Fn gelf_checksum
Retrieves the ELF checksum for an ELF descriptor.
.It Fn gelf_fsize
@@ -171,7 +171,7 @@ Retrieves the size of the file representation of an ELF type.
Retrieves the ELF class of an ELF descriptor.
.El
.It "Updating ELF Data"
-.Bl -tag -compact -width ".Fn gelf_update_shdr"
+.Bl -tag -width 19n -compact
.It Fn gelf_update_dyn
Copy back an ELF
.Sy .dynamic
diff --git a/lib/libgpib/gpib.3 b/lib/libgpib/gpib.3
index fef47c7da2bf..01f778b08be9 100644
--- a/lib/libgpib/gpib.3
+++ b/lib/libgpib/gpib.3
@@ -207,7 +207,8 @@ The variable
.Dv iberr
provides an error code for the most recent library call.
The possible error codes are:
-.Bl -tag -offset indent -compact
+.Pp
+.Bl -tag -width 6n -offset indent -compact
.It EDVR
System error
.It ECIC
@@ -244,7 +245,8 @@ The variable
.Dv ibsta
contains the controller status.
This is an ORed status value, with the following individual bit names:
-.Bl -tag -offset indent -compact
+.Pp
+.Bl -tag -width 6n -offset indent -compact
.It ERR
Error
.It TIMO
@@ -329,7 +331,8 @@ The lower 8 bits of
are interpreted as an end-of-string character,
.Li EOS .
This character can be ORed with the following values:
-.Bl -tag -compact -offset indent
+.Pp
+.Bl -tag -width 6n -compact -offset indent
.It Dv REOS
When receiving a message byte on the bus that matches the
.Li EOS
@@ -348,6 +351,7 @@ If set, include all 8 bits of the
character in the comparison; if unset, compare only 7 bit ASCII
values.
.El
+.Pp
Passing 0 as
.Fa eos
will turn off any special character treatment, allowing for a fully
diff --git a/lib/libpmc/pmc.3 b/lib/libpmc/pmc.3
index cf74f321076d..c970da846056 100644
--- a/lib/libpmc/pmc.3
+++ b/lib/libpmc/pmc.3
@@ -111,7 +111,7 @@ processor.
Certain kinds of PMCs require that a log file be configured before
they may be started.
These include:
-.Bl -bullet -compact
+.Bl -bullet
.It
System scope sampling PMCs.
.It
@@ -120,6 +120,7 @@ Process scope sampling PMCs.
Process scope counting PMCs that have been configured to report PMC
readings on process context switches or process exits.
.El
+.Pp
Up to one log file may be configured per owner process.
Events logged to a log file may be subsequently analyzed using the
.Xr pmclog 3
@@ -129,6 +130,7 @@ The CPUs known to the PMC library are named by the
.Vt "enum pmc_cputype"
enumeration.
Supported CPUs include:
+.Pp
.Bl -tag -width "Li PMC_CPU_INTEL_CORE2" -compact
.It Li PMC_CPU_AMD_K7
.Tn "AMD Athlon"
@@ -185,6 +187,7 @@ PMC supported by this library are named by the
.Vt enum pmc_class
enumeration.
Supported PMC kinds include:
+.Pp
.Bl -tag -width "Li PMC_CLASS_IAF" -compact
.It Li PMC_CLASS_IAF
Fixed function hardware counters presents in CPUs conforming to the
@@ -232,6 +235,7 @@ the
.Vt "enum pmc_caps"
enumeration.
Supported capabilities include:
+.Pp
.Bl -tag -width "Li PMC_CAP_INTERRUPT" -compact
.It Li PMC_CAP_CASCADE
The ability to cascade counters.
@@ -273,9 +277,9 @@ Operations on non-existent CPUs will return an error.
This section contains a brief overview of the available functionality
in the PMC library.
Each function listed here is described further in its own manual page.
-.Bl -tag -width indent
+.Bl -tag -width 2n
.It Administration
-.Bl -tag -compact
+.Bl -tag -width 6n -compact
.It Fn pmc_disable , Fn pmc_enable
Administratively disable (enable) specific performance monitoring
counter hardware.
@@ -283,7 +287,7 @@ Counters that are disabled will not be available to applications to
use.
.El
.It "Convenience Functions"
-.Bl -tag -compact
+.Bl -tag -width 6n -compact
.It Fn pmc_event_names_of_class
Returns a list of event names supported by a given PMC type.
.It Fn pmc_name_of_capability
@@ -308,13 +312,13 @@ constant to a human-readable name.
Return a human-readable string describing a PMC's current state.
.El
.It "Library Initialization"
-.Bl -tag -compact
+.Bl -tag -width 6n -compact
.It Fn pmc_init
Initialize the library.
This function must be called before any other library function.
.El
.It "Log File Handling"
-.Bl -tag -compact
+.Bl -tag -width 6n -compact
.It Fn pmc_configure_logfile
Configure a log file for
.Xr hwpmc 4
@@ -331,7 +335,7 @@ side of the stream.
Append arbitrary user data to the current log file.
.El
.It "PMC Management"
-.Bl -tag -compact
+.Bl -tag -width 6n -compact
.It Fn pmc_allocate , Fn pmc_release
Allocate (free) a PMC.
.It Fn pmc_attach , Fn pmc_detach
@@ -344,7 +348,7 @@ Start (stop) a software PMC.
Set the reload value for a sampling PMC.
.El
.It "Queries"
-.Bl -tag -compact
+.Bl -tag -width 6n -compact
.It Fn pmc_capabilities
Retrieve the capabilities for a given PMC.
.It Fn pmc_cpuinfo
@@ -363,7 +367,7 @@ Return information about the state of a given CPU's PMCs.
Determine the width of a hardware counter in bits.
.El
.It "x86 Architecture Specific API"
-.Bl -tag -compact
+.Bl -tag -width 6n -compact
.It Fn pmc_get_msr
Returns the processor model specific register number
associated with
diff --git a/lib/libusb/libusb20.3 b/lib/libusb/libusb20.3
index 2253ece27779..c9bf9024abea 100644
--- a/lib/libusb/libusb20.3
+++ b/lib/libusb/libusb20.3
@@ -401,7 +401,7 @@ The callback type is defined by libusb20_tr_callback_t.
.
.Fn libusb20_tr_set_flags
is used to set various USB flags for the given USB transfer.
-.Bl -tag
+.Bl -tag -width "LIBUSB20_TRANSFER_SINGLE_SHORT_NOT_OK"
.It LIBUSB20_TRANSFER_SINGLE_SHORT_NOT_OK
Report a short frame as error.
.It LIBUSB20_TRANSFER_MULTI_SHORT_NOT_OK
@@ -709,13 +709,14 @@ This function returns zero if the device is still connected else a LIBUSB20_ERRO
sets the power mode of the USB device.
.
Valid power modes:
-.Bl -tag
+.Bl -tag -width "LIBUSB20_POWER_OFF"
.It LIBUSB20_POWER_OFF
.It LIBUSB20_POWER_ON
.It LIBUSB20_POWER_SAVE
.It LIBUSB20_POWER_SUSPEND
.It LIBUSB20_POWER_RESUME
.El
+.Pp
.
This function returns zero on success else a LIBUSB20_ERROR value is
returned.
@@ -793,7 +794,7 @@ Valid bus numbers start at zero.
returns the current operation mode of the USB entity.
.
Valid return values are:
-.Bl -tag
+.Bl -tag -width "LIBUSB20_MODE_DEVICE"
.It LIBUSB20_MODE_HOST
.It LIBUSB20_MODE_DEVICE
.El
@@ -803,7 +804,7 @@ Valid return values are:
.Fn libusb20_dev_get_speed
returns the current speed of the given USB device.
.
-.Bl -tag
+.Bl -tag -width "LIBUSB20_SPEED_VARIABLE"
.It LIBUSB20_SPEED_UNKNOWN
.It LIBUSB20_SPEED_LOW
.It LIBUSB20_SPEED_FULL