Date: Sat, 2 Jun 2012 08:47:27 +0000 (UTC) From: Joel Dahl <joel@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r236438 - in head/lib: libc/gen libcrypt libelf libgpib libpmc libusb Message-ID: <201206020847.q528lREJ076666@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: joel (doc committer) Date: Sat Jun 2 08:47:26 2012 New Revision: 236438 URL: http://svn.freebsd.org/changeset/base/236438 Log: mdoc: minor Bl improvements. Modified: head/lib/libc/gen/posix_spawnattr_getflags.3 head/lib/libcrypt/crypt.3 head/lib/libelf/elf.3 head/lib/libelf/gelf.3 head/lib/libgpib/gpib.3 head/lib/libpmc/pmc.3 head/lib/libusb/libusb20.3 Modified: head/lib/libc/gen/posix_spawnattr_getflags.3 ============================================================================== --- head/lib/libc/gen/posix_spawnattr_getflags.3 Sat Jun 2 08:29:07 2012 (r236437) +++ head/lib/libc/gen/posix_spawnattr_getflags.3 Sat Jun 2 08:47:26 2012 (r236438) @@ -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 Modified: head/lib/libcrypt/crypt.3 ============================================================================== --- head/lib/libcrypt/crypt.3 Sat Jun 2 08:29:07 2012 (r236437) +++ head/lib/libcrypt/crypt.3 Sat Jun 2 08:47:26 2012 (r236438) @@ -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: Modified: head/lib/libelf/elf.3 ============================================================================== --- head/lib/libelf/elf.3 Sat Jun 2 08:29:07 2012 (r236437) +++ head/lib/libelf/elf.3 Sat Jun 2 08:47:26 2012 (r236438) @@ -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 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 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 memor 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 optional 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 Modified: head/lib/libelf/gelf.3 ============================================================================== --- head/lib/libelf/gelf.3 Sat Jun 2 08:29:07 2012 (r236437) +++ head/lib/libelf/gelf.3 Sat Jun 2 08:47:26 2012 (r236438) @@ -115,7 +115,7 @@ routines will signal an error if a GElf 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 o 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 ent 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 represent 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 Modified: head/lib/libgpib/gpib.3 ============================================================================== --- head/lib/libgpib/gpib.3 Sat Jun 2 08:29:07 2012 (r236437) +++ head/lib/libgpib/gpib.3 Sat Jun 2 08:47:26 2012 (r236438) @@ -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 Modified: head/lib/libpmc/pmc.3 ============================================================================== --- head/lib/libpmc/pmc.3 Sat Jun 2 08:29:07 2012 (r236437) +++ head/lib/libpmc/pmc.3 Sat Jun 2 08:47:26 2012 (r236438) @@ -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 na .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 .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 ret 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 a 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 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 Modified: head/lib/libusb/libusb20.3 ============================================================================== --- head/lib/libusb/libusb20.3 Sat Jun 2 08:29:07 2012 (r236437) +++ head/lib/libusb/libusb20.3 Sat Jun 2 08:47:26 2012 (r236438) @@ -401,7 +401,7 @@ The callback type is defined by libusb20 . .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 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201206020847.q528lREJ076666>