From 17ba2140980343f6298e96bd96d2e0c16b9dfb46 Mon Sep 17 00:00:00 2001 From: ru Date: Fri, 29 Dec 2000 09:18:45 +0000 Subject: Prepare for mdoc(7)NG. --- share/man/man3/assert.3 | 2 +- share/man/man3/bitstring.3 | 4 +- share/man/man3/fpgetround.3 | 65 +++++++++------------ share/man/man4/ahc.4 | 1 - share/man/man4/atkbd.4 | 2 +- share/man/man4/bktr.4 | 2 +- share/man/man4/bpf.4 | 36 +++++------- share/man/man4/cd.4 | 68 +++++++++------------- share/man/man4/csa.4 | 2 +- share/man/man4/dc.4 | 2 - share/man/man4/ddb.4 | 25 +-------- share/man/man4/dummynet.4 | 13 ++--- share/man/man4/gusc.4 | 4 +- share/man/man4/icmp6.4 | 8 ++- share/man/man4/iic.4 | 2 +- share/man/man4/iicbus.4 | 8 +-- share/man/man4/ipsec.4 | 42 +++++++------- share/man/man4/ispfw.4 | 2 +- share/man/man4/joy.4 | 5 +- share/man/man4/keyboard.4 | 54 +++++++++--------- share/man/man4/kld.4 | 1 + share/man/man4/lp.4 | 1 - share/man/man4/man4.alpha/linux.4 | 2 +- share/man/man4/man4.i386/alpm.4 | 2 +- share/man/man4/man4.i386/cs.4 | 1 + share/man/man4/man4.i386/cx.4 | 3 +- share/man/man4/man4.i386/dgb.4 | 10 ++-- share/man/man4/man4.i386/fe.4 | 6 +- share/man/man4/man4.i386/gsc.4 | 5 +- share/man/man4/man4.i386/linux.4 | 2 +- share/man/man4/man4.i386/lnc.4 | 24 +++++--- share/man/man4/man4.i386/matcd.4 | 109 ++++++++++++++++-------------------- share/man/man4/man4.i386/pnp.4 | 1 - share/man/man4/man4.i386/scd.4 | 1 + share/man/man4/man4.i386/spkr.4 | 1 - share/man/man4/man4.i386/streams.4 | 5 +- share/man/man4/man4.i386/svr4.4 | 7 +-- share/man/man4/man4.i386/vx.4 | 1 + share/man/man4/man4.i386/wd.4 | 2 +- share/man/man4/man4.i386/wt.4 | 8 ++- share/man/man4/netgraph.4 | 29 ++++------ share/man/man4/ng_bpf.4 | 2 +- share/man/man4/ng_one2many.4 | 1 + share/man/man4/ng_tty.4 | 1 + share/man/man4/ng_vjc.4 | 2 + share/man/man4/ohci.4 | 2 +- share/man/man4/pass.4 | 2 +- share/man/man4/pci.4 | 2 +- share/man/man4/pcm.4 | 18 +----- share/man/man4/pcvt.4 | 1 + share/man/man4/ppbus.4 | 4 +- share/man/man4/ppi.4 | 2 +- share/man/man4/sa.4 | 9 ++- share/man/man4/sbc.4 | 4 +- share/man/man4/scsi.4 | 18 +++--- share/man/man4/ses.4 | 14 +++-- share/man/man4/smbus.4 | 6 +- share/man/man4/snd_csa.4 | 2 +- share/man/man4/snd_gusc.4 | 4 +- share/man/man4/snd_sbc.4 | 4 +- share/man/man4/snp.4 | 3 +- share/man/man4/spkr.4 | 1 - share/man/man4/sym.4 | 79 +++++++++++++------------- share/man/man4/tap.4 | 6 +- share/man/man4/twe.4 | 3 + share/man/man4/uhci.4 | 2 +- share/man/man4/ukbd.4 | 1 + share/man/man4/ums.4 | 1 + share/man/man4/urio.4 | 1 + share/man/man4/vpo.4 | 5 +- share/man/man4/xpt.4 | 2 +- share/man/man5/dir.5 | 2 +- share/man/man5/disktab.5 | 2 +- share/man/man5/forward.5 | 2 - share/man/man5/fstab.5 | 1 - share/man/man5/hosts.equiv.5 | 6 +- share/man/man5/hosts.lpd.5 | 1 + share/man/man5/link.5 | 2 +- share/man/man5/make.conf.5 | 11 ++-- share/man/man5/nsswitch.conf.5 | 66 +++++++++++----------- share/man/man5/periodic.conf.5 | 1 - share/man/man5/rc.conf.5 | 1 + share/man/man5/sysctl.conf.5 | 1 + share/man/man7/build.7 | 1 + share/man/man7/operator.7 | 36 ++++++------ share/man/man7/ports.7 | 2 + share/man/man7/security.7 | 2 - share/man/man7/style.perl.7 | 7 +-- share/man/man8/adding_user.8 | 4 +- share/man/man8/crash.8 | 4 +- share/man/man8/diskless.8 | 43 ++++++-------- share/man/man8/man8.alpha/MAKEDEV.8 | 1 + share/man/man8/man8.i386/MAKEDEV.8 | 1 + share/man/man9/DEVICE_PROBE.9 | 1 - share/man/man9/MD5.9 | 1 + share/man/man9/VOP_LINK.9 | 2 +- share/man/man9/accf_http.9 | 2 +- share/man/man9/acl.9 | 2 +- share/man/man9/bios.9 | 1 - share/man/man9/buf.9 | 1 - share/man/man9/devfs_add_devswf.9 | 2 +- share/man/man9/device_quiet.9 | 12 ++-- share/man/man9/extattr.9 | 2 +- share/man/man9/ifnet.9 | 1 + share/man/man9/intro.9 | 2 +- share/man/man9/kthread.9 | 1 + share/man/man9/malloc.9 | 2 +- share/man/man9/mbuf.9 | 1 + share/man/man9/microseq.9 | 6 +- share/man/man9/namei.9 | 15 ++--- share/man/man9/rtalloc.9 | 2 +- share/man/man9/rtentry.9 | 2 +- share/man/man9/spl.9 | 2 +- share/man/man9/style.9 | 3 +- share/man/man9/swi.9 | 10 ++-- share/man/man9/timeout.9 | 12 ++-- share/man/man9/vnode.9 | 3 +- share/man/man9/vrele.9 | 1 - share/termcap/termcap.5 | 16 +++--- 119 files changed, 499 insertions(+), 573 deletions(-) (limited to 'share') diff --git a/share/man/man3/assert.3 b/share/man/man3/assert.3 index 02f58cb..8e1ab1d 100644 --- a/share/man/man3/assert.3 +++ b/share/man/man3/assert.3 @@ -79,7 +79,7 @@ if .Ar expression is false: .Bd -literal -offset indent -"assertion \e"%s\e" failed: file \e"%s\e", line %d\n", \e +"assertion \e"%s\e" failed: file \e"%s\e", line %d\en", \e "expression", __FILE__, __LINE__); .Ed .Sh SEE ALSO diff --git a/share/man/man3/bitstring.3 b/share/man/man3/bitstring.3 index 04f7025..242e640 100644 --- a/share/man/man3/bitstring.3 +++ b/share/man/man3/bitstring.3 @@ -160,11 +160,11 @@ have side effects. #include #include -... +\&... #define LPR_BUSY_BIT 0 #define LPR_FORMAT_BIT 1 #define LPR_DOWNLOAD_BIT 2 -... +\&... #define LPR_AVAILABLE_BIT 9 #define LPR_MAX_BITS 10 diff --git a/share/man/man3/fpgetround.3 b/share/man/man3/fpgetround.3 index 7dce03a..89f3719 100644 --- a/share/man/man3/fpgetround.3 +++ b/share/man/man3/fpgetround.3 @@ -47,56 +47,43 @@ .Nd IEEE floating point interface .Sh SYNOPSIS .Fd #include -.Ft typedef enum { -.br -.Fa FP_RN, -.Li /* round to nearest */ -.br -.Fa FP_RM, -.Li /* round to minus infinity */ -.br -.Fa FP_RP, -.Li /* round to plus infinity */ -.br -.Fa FP_RZ, -.Li /* truncate */ -.br -.Ft } fp_rnd_t; .Pp +.Bd -literal +typedef enum { + FP_RN, /* round to nearest */ + FP_RM, /* round down to minus infinity */ + FP_RP, /* round up to plus infinity */ + FP_RZ /* truncate */ +} fp_rnd_t; +.Ed .Ft fp_rnd_t .Fn fpgetround void .Ft fp_rnd_t .Fn fpsetround "fp_rnd_t direction" .Pp -.nr fZ 0 -.Ft typedef enum { -.br -.Fa FP_PS, -.Li /* 24 bit (single-precision) */ -.br -.Fa FP_PRS, -.Li /* reserved */ -.br -.Fa FP_PD, -.Li /* 53 bit (double-precision) */ -.br -.Fa FP_PE, -.Li /* 64 bit (extended-precision) */ -.br -.Ft } fp_prec_t; -.Pp +.Bd -literal +typedef enum { + FP_PS, /* 24 bit (single-precision) */ + FP_PRS, /* reserved */ + FP_PD, /* 53 bit (double-precision) */ + FP_PE /* 64 bit (extended-precision) */ +} fp_prec_t; +.Ed .Ft fp_prec_t .Fn fpgetprec void .Ft fp_prec_t .Fn fpsetprec "fp_prec_t precision" .Pp -.Fd #define fp_except_t int -.Fd #define FP_X_INV 0x01 /* invalid */ -.Fd #define FP_X_OFL 0x08 /* overflow */ -.Fd #define FP_X_UFL 0x10 /* underflow */ -.Fd #define FP_X_DZ 0x04 /* divide-by-zero */ -.Fd #define FP_X_IMP 0x20 /* loss of precision */ -.Fd #define FP_X_DNML 0x02 /* denormal */ +.Bd -literal +#define fp_except_t int +#define FP_X_INV 0x01 /* invalid operation */ +#define FP_X_DNML 0x02 /* denormal */ +#define FP_X_DZ 0x04 /* zero divide */ +#define FP_X_OFL 0x08 /* overflow */ +#define FP_X_UFL 0x10 /* underflow */ +#define FP_X_IMP 0x20 /* (im)precision */ +#define FP_X_STK 0x40 /* stack fault */ +.Ed .Ft fp_except_t .Fn fpgetmask void .Ft fp_except_t diff --git a/share/man/man4/ahc.4 b/share/man/man4/ahc.4 index cb102f1..ab97a9b 100644 --- a/share/man/man4/ahc.4 +++ b/share/man/man4/ahc.4 @@ -221,7 +221,6 @@ target on multiple SCSI IDs. .El .Ed .Pp - .Sh SCSI CONTROL BLOCKS (SCBs) Every transaction sent to a device on the SCSI bus is assigned a .Sq SCSI Control Block diff --git a/share/man/man4/atkbd.4 b/share/man/man4/atkbd.4 index 36dcb84..5f88d58 100644 --- a/share/man/man4/atkbd.4 +++ b/share/man/man4/atkbd.4 @@ -66,7 +66,7 @@ by the .Xr kbdcontrol 1 command. .Pp -.Bl -tag -width "Function Key Number" -compact -offset +.Bl -tag -width "Function Key Number" -compact .It "Function Key number" Function Key .It "1, 2,...12" diff --git a/share/man/man4/bktr.4 b/share/man/man4/bktr.4 index 6cb9404..01787ad 100644 --- a/share/man/man4/bktr.4 +++ b/share/man/man4/bktr.4 @@ -141,7 +141,7 @@ is set to an integer from 1 to 13 taken from the following table: 12 .It ALPS_TSBH1 13 -.Pp +.El .Sh AUTHORS .An -nosplit This driver is based on the work of diff --git a/share/man/man4/bpf.4 b/share/man/man4/bpf.4 index 6a27776..b0a9571 100644 --- a/share/man/man4/bpf.4 +++ b/share/man/man4/bpf.4 @@ -120,7 +120,7 @@ require .Aq Pa sys/socket.h and .Aq Pa net/if.h . - +.Pp In addition to .Dv FIONREAD and @@ -131,7 +131,6 @@ file. The (third) argument to .Xr ioctl 2 should be a pointer to the type indicated. - .Bl -tag -width BIOCGRTIMEOUT .It Dv BIOCGBLEN .Pq Li u_int @@ -242,7 +241,7 @@ struct bpf_program { struct bpf_insn *bf_insns; }; .Ed - +.Pp The filter program is pointed to by the .Li bf_insns field while its length in units of @@ -298,6 +297,7 @@ interface should be returned by BPF. Set to zero to see only incoming packets on the interface. Set to one to see packets originating locally and remotely on the interface. This flag is initialized to one by default. +.El .Sh BPF HEADER The following structure is prepended to each packet returned by .Xr read 2 : @@ -381,7 +381,7 @@ instruction. Each instruction performs some action on the pseudo-machine state, which consists of an accumulator, index register, scratch memory store, and implicit program counter. - +.Pp The following structure defines the instruction format: .Bd -literal struct bpf_insn { @@ -391,7 +391,7 @@ struct bpf_insn { u_long k; }; .Ed - +.Pp The .Li k field is used in different ways by different instructions, @@ -416,7 +416,7 @@ Various other mode and operator bits are or'd into the class to give the actual instructions. The classes and modes are defined in .Aq Pa net/bpf.h . - +.Pp Below are the semantics for each defined .Nm instruction. @@ -440,7 +440,7 @@ instruction definition. .Dq len refers to the length of the packet. .Pp -.Bl -tag -width BPF_STXx -compact +.Bl -tag -width BPF_STXx .It Dv BPF_LD These instructions copy a value into the accumulator. The type of the source operand is specified by an @@ -489,14 +489,13 @@ A <- k .It Li BPF_LD+BPF_MEM A <- M[k] .El - .It Dv BPF_LDX These instructions load a value into the index register. Note that the addressing modes are more restrictive than those of the accumulator loads, but they include .Dv BPF_MSH , a hack for efficiently loading the IP header length. - +.Pp .Bl -tag -width "BPF_LDX+BPF_W+BPF_MEM" -compact .It Li BPF_LDX+BPF_W+BPF_IMM X <- k @@ -507,25 +506,22 @@ X <- len .It Li BPF_LDX+BPF_B+BPF_MSH X <- 4*(P[k:1]&0xf) .El - .It Dv BPF_ST This instruction stores the accumulator into the scratch memory. We do not need an addressing mode since there is only one possibility for the destination. - +.Pp .Bl -tag -width "BPF_ST" -compact .It Li BPF_ST M[k] <- A .El - .It Dv BPF_STX This instruction stores the index register in the scratch memory store. - +.Pp .Bl -tag -width "BPF_STX" -compact .It Li BPF_STX M[k] <- X .El - .It Dv BPF_ALU The alu instructions perform operations between the accumulator and index register or constant, and store the result back in the accumulator. @@ -535,7 +531,7 @@ For binary operations, a source mode is required or .Dv BPF_X .Pc . - +.Pp .Bl -tag -width "BPF_ALU+BPF_MUL+BPF_K" -compact .It Li BPF_ALU+BPF_ADD+BPF_K A <- A + k @@ -572,7 +568,6 @@ A <- A >> X .It Li BPF_ALU+BPF_NEG A <- -A .El - .It Dv BPF_JMP The jump instructions alter flow of control. Conditional jumps compare the accumulator against a constant @@ -588,7 +583,7 @@ opcode uses the 32 bit .Li k field as the offset, allowing arbitrarily distant destinations. All conditionals use unsigned comparison conventions. - +.Pp .Bl -tag -width "BPF_JMP+BPF_KSET+BPF_X" -compact .It Li BPF_JMP+BPF_JA pc += k @@ -609,7 +604,6 @@ pc += (A == X) ? jt : jf .It Li BPF_JMP+BPF_JSET+BPF_X pc += (A & X) ? jt : jf .El - .It Dv BPF_RET The return instructions terminate the filter program and specify the amount of packet to accept (i.e., they return the truncation amount). A return @@ -618,26 +612,26 @@ The return value is either a constant .Pq Dv BPF_K or the accumulator .Pq Dv BPF_A . - +.Pp .Bl -tag -width "BPF_RET+BPF_K" -compact .It Li BPF_RET+BPF_A accept A bytes .It Li BPF_RET+BPF_K accept k bytes .El - .It Dv BPF_MISC The miscellaneous category was created for anything that doesn't fit into the above classes, and for any new instructions that might need to be added. Currently, these are the register transfer instructions that copy the index register to the accumulator or vice versa. - +.Pp .Bl -tag -width "BPF_MISC+BPF_TAX" -compact .It Li BPF_MISC+BPF_TAX X <- A .It Li BPF_MISC+BPF_TXA A <- X .El +.El .Pp The .Nm diff --git a/share/man/man4/cd.4 b/share/man/man4/cd.4 index e3cdd58..720b8e3 100644 --- a/share/man/man4/cd.4 +++ b/share/man/man4/cd.4 @@ -34,8 +34,8 @@ .Sh SYNOPSIS .Cd device cd .Cd device cd1 at scbus0 target 4 unit 0 -.Cd options "CHANGER_MIN_BUSY_SECONDS=3" -.Cd options "CHANGER_MAX_BUSY_SECONDS=11" +.Cd "options ""CHANGER_MIN_BUSY_SECONDS=3""" +.Cd "options ""CHANGER_MAX_BUSY_SECONDS=11"" .Sh DESCRIPTION The .Nm @@ -105,7 +105,7 @@ in the header files and .Aq Pa sys/disklabel.h . .Pp -.Bl -tag -width CDIOCREADSUBCHANNEL -compact +.Bl -tag -width CDIOCREADSUBCHANNEL .It Dv DIOCGDINFO .It Dv DIOCSDINFO .Pq Li "struct disklabel" @@ -114,7 +114,6 @@ drive. The disklabel is initialized with information read from the scsi inquiry commands, and should be the same as the information printed at boot. This structure is defined in .Xr disklabel 5 . - .It Dv CDIOCCAPABILITY .Pq Li "struct ioc_capability" Retrieve information from the drive on what features it supports. The @@ -178,7 +177,7 @@ struct ioc_capability { /* The tray has dynamic debugging */ }; .Ed -.It Dv CDIOCPLAYTRACKS +.It Dv CDIOCPLAYTRACKS .Pq Li "struct ioc_play_track" Start audio playback given a track address and length. The structure is defined as follows: @@ -191,7 +190,6 @@ struct ioc_play_track u_char end_index; }; .Ed - .It Dv CDIOCPLAYBLOCKS .Pq Li "struct ioc_play_blocks" Start audio playback given a block address and length. The structure @@ -203,8 +201,7 @@ struct ioc_play_blocks int len; }; .Ed - -.It Dv CDIOCPLAYMSF +.It Dv CDIOCPLAYMSF .Pq Li "struct ioc_play_msf" Start audio playback given a `minutes-seconds-frames' address and length. The structure is defined as follows: @@ -219,7 +216,6 @@ struct ioc_play_msf u_char end_f; }; .Ed - .It Dv CDIOCREADSUBCHANNEL .Pq Li "struct ioc_read_subchannel" Read information from the subchannel at the location specified by this @@ -239,7 +235,6 @@ struct ioc_read_subchannel { struct cd_sub_channel_info *data; }; .Ed - .It Dv CDIOREADTOCHEADER .Pq Li "struct ioc_toc_header" Return summary information about the table of contents for the mounted @@ -252,7 +247,6 @@ struct ioc_toc_header { u_char ending_track; }; .Ed - .It Dv CDIOREADTOCENTRYS .Pq Li "struct ioc_read_toc_entry" Return information from the table of contents entries mentioned. (Yes, this @@ -269,7 +263,6 @@ The requested data is written into an area of size .Li data_len and pointed to by .Li data . - .It Dv CDIOCSETPATCH .Pq Li "struct ioc_patch" Attach various audio channels to various output channels. The @@ -280,7 +273,6 @@ struct ioc_patch { /* one for each channel */ }; .Ed - .It Dv CDIOCGETVOL .It Dv CDIOCSETVOL .Pq Li "struct ioc_vol" @@ -293,51 +285,39 @@ struct ioc_vol /* one for each channel */ }; .Ed - -.It Dv CDIOCSETMONO +.It Dv CDIOCSETMONO Patch all output channels to all source channels. - .It Dv CDIOCSETSTEREO Patch left source channel to the left output channel and the right source channel to the right output channel. - -.It Dv CDIOCSETMUTE +.It Dv CDIOCSETMUTE Mute output without changing the volume settings. - .It Dv CDIOCSETLEFT .It Dv CDIOCSETRIGHT Attach both output channels to the left (right) source channel. - -.It Dv CDIOCSETDEBUG -.It Dv CDIOCCLRDEBUG +.It Dv CDIOCSETDEBUG +.It Dv CDIOCCLRDEBUG Turn on (off) debugging for the appropriate device. - -.It Dv CDIOCPAUSE -.It Dv CDIOCRESUME +.It Dv CDIOCPAUSE +.It Dv CDIOCRESUME Pause (resume) audio play, without resetting the location of the read-head. - -.It Dv CDIOCRESET +.It Dv CDIOCRESET Reset the drive. - -.It Dv CDIOCSTART -.It Dv CDIOCSTOP +.It Dv CDIOCSTART +.It Dv CDIOCSTOP Tell the drive to spin-up (-down) the .Tn CD-ROM . - .It Dv CDIOCALLOW .It Dv CDIOCPREVENT Tell the drive to allow (prevent) manual ejection of the .Tn CD-ROM disc. Not all drives support this feature. - -.It Dv CDIOCEJECT +.It Dv CDIOCEJECT Eject the .Tn CD-ROM . - .It Dv CDIOCCLOSE Tell the drive to close its door and load the media. Not all drives support this feature. - .It Dv CDIOCPITCH .Pq Li "struct ioc_pitch" For drives that support it, this command instructs the drive to play @@ -404,17 +384,21 @@ another LUN, the driver will allow indefinite access to a given LUN. .Pp The minimum and maximum time quanta are configurable via kernel options and also via sysctl variables. The kernel options are: - -.Bl -tag -width 1234 -compact -.It Cd options "CHANGER_MIN_BUSY_SECONDS=3" -.It Cd options "CHANGER_MAX_BUSY_SECONDS=11" +.Pp +.Bl -item -compact +.It +.Cd "options ""CHANGER_MIN_BUSY_SECONDS=3""" +.It +.Cd "options ""CHANGER_MAX_BUSY_SECONDS=11""" .El .Pp The sysctl variables are: .Pp -.Bl -tag -width 1234 -compact -.It Cd kern.cam.cd.changer.min_busy_seconds -.It Cd kern.cam.cd.changer.max_busy_seconds +.Bl -item -compact +.It +.Va kern.cam.cd.changer.min_busy_seconds +.It +.Va kern.cam.cd.changer.max_busy_seconds .El .Pp It is suggested that the user try experimenting with the minimum and diff --git a/share/man/man4/csa.4 b/share/man/man4/csa.4 index e7291f3..e7eb400 100644 --- a/share/man/man4/csa.4 +++ b/share/man/man4/csa.4 @@ -39,7 +39,7 @@ The bridge driver allows the generic audio drivers including .Xr pcm 4 to attach to the following PCI sound cards: -.Bl -bullet -tag -width 2m indent +.Bl -bullet -width 2m .It Crystal Semiconductor CS461x/462x Audio Accelerator .It diff --git a/share/man/man4/dc.4 b/share/man/man4/dc.4 index a453a78..a37e4f9 100644 --- a/share/man/man4/dc.4 +++ b/share/man/man4/dc.4 @@ -360,5 +360,3 @@ the end of the transmit ring during a single invocation of the .Fn dc_start routine. This workaround has a negligible impact on transmit performance. - - diff --git a/share/man/man4/ddb.4 b/share/man/man4/ddb.4 index a4648e5..3784af9 100644 --- a/share/man/man4/ddb.4 +++ b/share/man/man4/ddb.4 @@ -125,7 +125,7 @@ the emacs control keys, the usual ANSI arrow keys might be used to browse through the history buffer, and move the cursor within the current line. .Sh COMMANDS -.Bl -ohang -compact +.Bl -ohang .It Cm examine .It Cm x Display the addressed locations according to the formats in the modifier. @@ -180,18 +180,15 @@ don't round to the next long word boundary print register contents .El .El - .It Cm xf Examine forward: Execute an examine command with the last specified parameters to it except that the next address displayed by it is used as the start address. - .It Cm xb Examine backward: Execute an examine command with the last specified parameters to it except that the last start address subtracted by the size displayed by it is used as the start address. - .It Cm print Ns Op Cm /acdoruxz Print .No Ar addr Ns s @@ -219,7 +216,6 @@ will print like: eax = xxxxxx ecx = yyyyyy .Ed - .It Xo .Cm write Ns Op Cm /bhl .No Ar addr Ar expr1 Op Ar "expr2 ..." @@ -241,7 +237,6 @@ long word is assumed. since there is no delimiter between expressions, strange things may happen. It's best to enclose each expression in parentheses. - .It Xo .Cm set .No Li \&$ Ns Ar variable @@ -251,7 +246,6 @@ It's best to enclose each expression in parentheses. Set the named variable or register with the value of .Ar expr . Valid variable names are described below. - .It Cm break Ns Op Cm /u Set a break point at .Ar addr . @@ -280,7 +274,6 @@ routines. If a user text is shadowed by a normal user space debugger, user space break points may not work correctly. Setting a break point at the low-level code paths may also cause strange behavior. - .It Cm delete Ar addr .It Cm delete Li \&# Ns Ar number Delete the break point. The target break point can be specified by a @@ -291,7 +284,6 @@ or by using the same specified in the original .Cm break command. - .It Cm step Ns Op Cm /p Single step .Ar count @@ -307,7 +299,6 @@ single-step through some low-level code paths or user space code. On machines with software-emulated single-stepping (e.g., pmax), stepping through code executed by interrupt handlers will probably do the wrong thing. - .It Cm continue Ns Op Cm /c Continue execution until a breakpoint or watchpoint. If the @@ -319,7 +310,6 @@ Some machines (e.g., pmax) also count loads and stores. when counting, the debugger is really silently single-stepping. This means that single-stepping on low-level code may cause strange behavior. - .It Cm until Ns Op Cm /p Stop at the next call or return instruction. If the @@ -327,7 +317,6 @@ If the modifier is specified, print the call nesting depth and the cumulative instruction count at each call or return. Otherwise, only print when the matching return is hit. - .It Cm next Ns Op Cm /p .It Cm match Ns Op Cm /p Stop at the matching return instruction. @@ -336,7 +325,6 @@ If the modifier is specified, print the call nesting depth and the cumulative instruction count at each call or return. Otherwise, only print when the matching return is hit. - .It Xo .No Cm trace Ns Op Cm /u .Op Ar frame @@ -357,7 +345,6 @@ is omitted, all frames are printed. .Sy Warning : User space stack trace is valid only if the machine dependent code supports it. - .It Xo .No Cm search Ns Op Cm /bhl .Ar addr @@ -372,7 +359,6 @@ ways if it doesn't find the searched-for value. This is because ddb doesn't always recover from touching bad memory. The optional .Ar count argument limits the search. - .It Cm show all procs Ns Op Cm /m .It Cm ps Ns Op Cm /m Display all process information. @@ -383,7 +369,6 @@ The .Li m modifier will alter the display to show VM map addresses for the process and not show other info. - .It Cm show registers Ns Op Cm /u Display the register set. If the @@ -396,7 +381,6 @@ The support of the .Li u modifier depends on the machine. If not supported, incorrect information will be displayed. - .It Xo .Cm show map Ns Op Cm /f .Ar addr @@ -407,7 +391,6 @@ If the .Li f modifier is specified the complete map is printed. - .It Xo .Cm show object Ns Op Cm /f .Ar addr @@ -418,10 +401,8 @@ If the .Li f option is specified the complete object is printed. - .It Cm "show watches" Displays all watchpoints. - .It Xo .Cm watch .No Ar addr Ns Li \&, Ns Ar size @@ -438,7 +419,6 @@ with an error message. Attempts to watch wired kernel memory may cause unrecoverable error in some systems such as i386. Watchpoints on user addresses work best. - .It Cm gdb Toggles between remote GDB and DDB mode. In remote GDB mode, another machine is required that runs @@ -447,13 +427,10 @@ using the remote debug feature, with a connection to the serial console port on the target machine. Currently only available on the .Em i386 architecture. - .It Cm help Print a short summary of the available commands and command abbreviations. - .El - .Sh VARIABLES The debugger accesses registers and variables as .No Li \&$ Ns Em name . diff --git a/share/man/man4/dummynet.4 b/share/man/man4/dummynet.4 index 0a35814..a76dda1 100644 --- a/share/man/man4/dummynet.4 +++ b/share/man/man4/dummynet.4 @@ -42,12 +42,12 @@ Packets are sent to a pipe using the command .Bd -literal ipfw add pipe NNN .... .Ed - +.Pp and pipes are configured as follows: .Bd -literal ipfw pipe NNN config bw B delay D queue Q plr P .Ed - +.Pp where the bandwidth B can be expressed in bit/s, Kbit/s, Mbit/s, Bytes/s, KBytes/s, MBytes/s , delay in milliseconds, queue size in packets or Bytes, plr is the fraction of packets randomly dropped. @@ -75,8 +75,6 @@ link would be the following: ipfw pipe 1 config bw 1Mbit/s delay 80ms ipfw pipe 2 config bw 128Kbit/s delay 300ms .Ed - -.Pp .Sh OPERATION The .Nm ipfw @@ -104,7 +102,7 @@ thus controlled by the kernel option .Bd -literal options HZ .Ed - +.Pp whose default value (100) means a granularity of 10ms. For an accurate simulation of high data rates it might be necessary to reduce the timer granularity to 1ms or less. @@ -114,7 +112,6 @@ time to output packets. So, reducing the granularity too much might actually cause ticks to be missed thus reducing the accuracy of operation. - .Sh KERNEL OPTIONS The following options in the kernel configuration file are related to @@ -134,13 +131,11 @@ Generally, the following options are required: options IPFIREWALL options DUMMYNET .Ed - +.Pp additionally, one may want to increase the number of mbuf clusters (used to store network packets) according to the sum of the bandwidth-delay products and queue sizes of all configured pipes. - - .Sh SYSCTL VARIABLES .Pp .Ql net.inet.ip.fw.one_pass diff --git a/share/man/man4/gusc.4 b/share/man/man4/gusc.4 index f8504e6..65ebe15 100644 --- a/share/man/man4/gusc.4 +++ b/share/man/man4/gusc.4 @@ -43,7 +43,7 @@ The bridge driver allows the generic audio drivers including .Xr pcm 4 to attach to the following ISA sound cards: -.Bl -bullet -tag -width 2m indent +.Bl -bullet -width 2m .It Gravis UltraSound PnP .It @@ -55,7 +55,7 @@ If the secondary DMA channel is C, set the flags to (C | 0x10). For a sound card without the secondary DMA channel, the flags should be set to zero. .Sh DIAGNOSTICS -.Bl -tag -width 2m % begin list +.Bl -tag -width 2m .It xxx: gus pcm not attached, out of memory .Pp There are not enough memory to drive the device. diff --git a/share/man/man4/icmp6.4 b/share/man/man4/icmp6.4 index f0a524e..c778000 100644 --- a/share/man/man4/icmp6.4 +++ b/share/man/man4/icmp6.4 @@ -149,17 +149,23 @@ and an option name of .Pp Six macros operate on an icmp6_filter structure: .\" is "Fn" legal for macros? -.Bl -item -compact -offset indent +.Bl -item -offset indent +.It .Ft void .Fn ICMP6_FILTER_SETPASSALL "struct icmp6_filter *filterp" +.It .Ft void .Fn ICMP6_FILTER_SETBLOCKALL "struct icmp6_filter *filterp" +.It .Ft void .Fn ICMP6_FILTER_SETPASS "int type" "struct icmp6_filter *filterp" +.It .Ft void .Fn ICMP6_FILTER_SETBLOCK "int type" "struct icmp6_filter *filterp" +.It .Ft int .Fn ICMP6_FILTER_WILLPASS "int type" "const struct icmp6_filter *filterp" +.It .Ft int .Fn ICMP6_FILTER_WILLBLOCK "int type" "const struct icmp6_filter *filterp" .El diff --git a/share/man/man4/iic.4 b/share/man/man4/iic.4 index ea69705..24a9c3f 100644 --- a/share/man/man4/iic.4 +++ b/share/man/man4/iic.4 @@ -42,7 +42,7 @@ instance. In order to control I2C devices, use /dev/iic? with the following ioctls: .Pp -.Bl -column "Ioctls" -compact +.Bl -column "I2CRSTCARD" -compact .It Em Ioctl Ta Em Description .It Sy I2CSTART Ta "send start condition to the specified device (with 7-bit address) on the bus" .It Sy I2CSTOP Ta "send stop condition to the bus" diff --git a/share/man/man4/iicbus.4 b/share/man/man4/iicbus.4 index 7c0e874..1fe8392 100644 --- a/share/man/man4/iicbus.4 +++ b/share/man/man4/iicbus.4 @@ -55,7 +55,7 @@ The BUS physically consists of 2 active wires and a ground connection. The active wires, SDA and SCL, are both bidirectional. Where SDA is the Serial DAta line and SCL is the Serial CLock line. - +.Pp Every component hooked up to the bus has its own unique address whether it is a CPU, LCD driver, memory, or complex function chip. Each of these chips @@ -64,7 +64,7 @@ Obviously an LCD driver is only a receiver, while a memory or I/O chip can both be transmitter and receiver. Furthermore there may be one or more BUS MASTERs. - +.Pp The BUS MASTER is the chip issuing the commands on the BUS. In the I2C protocol specification it is stated that the IC that initiates a data transfer on the @@ -90,11 +90,11 @@ interfaces rely on very simple hardware, usually two lines twiddled by 2 registers. Hardware interfaces are more intelligent and receive 8-bit characters they write to the bus according to the I2C protocol. - +.Pp I2C interfaces may act on the bus as slave devices, allowing spontaneous bidirectional communications, thanks to the multi-master capabilities of the I2C protocol. - +.Pp Some I2C interfaces are available: .Pp .Bl -column "Interface drivers" -compact diff --git a/share/man/man4/ipsec.4 b/share/man/man4/ipsec.4 index 8288aa0..ff404cc 100644 --- a/share/man/man4/ipsec.4 +++ b/share/man/man4/ipsec.4 @@ -145,15 +145,15 @@ means .Dq Li require in the syntax. .Bl -column net.inet6.ipsec6.esp_trans_deflev integerxxx -.It Sy Name Type Changeable -.It net.inet.ipsec.esp_trans_deflev integer yes -.It net.inet.ipsec.esp_net_deflev integer yes -.It net.inet.ipsec.ah_trans_deflev integer yes -.It net.inet.ipsec.ah_net_deflev integer yes -.It net.inet6.ipsec6.esp_trans_deflev integer yes -.It net.inet6.ipsec6.esp_net_deflev integer yes -.It net.inet6.ipsec6.ah_trans_deflev integer yes -.It net.inet6.ipsec6.ah_net_deflev integer yes +.It Sy "Name Type Changeable" +.It "net.inet.ipsec.esp_trans_deflev integer yes" +.It "net.inet.ipsec.esp_net_deflev integer yes" +.It "net.inet.ipsec.ah_trans_deflev integer yes" +.It "net.inet.ipsec.ah_net_deflev integer yes" +.It "net.inet6.ipsec6.esp_trans_deflev integer yes" +.It "net.inet6.ipsec6.esp_net_deflev integer yes" +.It "net.inet6.ipsec6.ah_trans_deflev integer yes" +.It "net.inet6.ipsec6.ah_net_deflev integer yes" .El .Pp If kernel finds no matching policy system wide default value is applied. @@ -168,9 +168,9 @@ which asks the kernel to drop the packet. means .Dq Li none . .Bl -column net.inet6.ipsec6.def_policy integerxxx -.It Sy Name Type Changeable -.It net.inet.ipsec.def_policy integer yes -.It net.inet6.ipsec6.def_policy integer yes +.It Sy "Name Type Changeable" +.It "net.inet.ipsec.def_policy integer yes" +.It "net.inet6.ipsec6.def_policy integer yes" .El .\" .Ss Miscellaneous sysctl variables @@ -178,18 +178,18 @@ The following variables are accessible via .Xr sysctl 8 , for tweaking kernel IPsec behavior: .Bl -column net.inet6.ipsec6.inbonud_call_ike integerxxx -.It Sy Name Type Changeable -.It net.inet.ipsec.ah_cleartos integer yes -.It net.inet.ipsec.ah_offsetmask integer yes -.It net.inet.ipsec.dfbit integer yes -.It net.inet.ipsec.ecn integer yes -.It net.inet.ipsec.debug integer yes -.It net.inet6.ipsec6.ecn integer yes -.It net.inet6.ipsec6.debug integer yes +.It Sy "Name Type Changeable" +.It "net.inet.ipsec.ah_cleartos integer yes" +.It "net.inet.ipsec.ah_offsetmask integer yes" +.It "net.inet.ipsec.dfbit integer yes" +.It "net.inet.ipsec.ecn integer yes" +.It "net.inet.ipsec.debug integer yes" +.It "net.inet6.ipsec6.ecn integer yes" +.It "net.inet6.ipsec6.debug integer yes" .El .Pp The variables are interpreted as follows: -.Bl -tag -width "123456" +.Bl -tag -width 6n .It Li ipsec.ah_cleartos If set to non-zero, the kernel clears type-of-service field in the IPv4 header during AH authentication data computation. diff --git a/share/man/man4/ispfw.4 b/share/man/man4/ispfw.4 index f21bcaa..1cced4b 100644 --- a/share/man/man4/ispfw.4 +++ b/share/man/man4/ispfw.4 @@ -28,7 +28,7 @@ .Os .Sh NAME .Nm ispfw -.Nd Firmware Module for Qlogic based SCSI and FibreChannel SCSI Host Adapters +.Nd "Firmware Module for Qlogic based SCSI and FibreChannel SCSI Host Adapters" .Sh SYNOPSIS .Cd "device ispfw" .Sh DESCRIPTION diff --git a/share/man/man4/joy.4 b/share/man/man4/joy.4 index 8b064b7..58ebf5b 100644 --- a/share/man/man4/joy.4 +++ b/share/man/man4/joy.4 @@ -67,9 +67,8 @@ status. .It Dv JOY_GET_Y_OFFSET Fa int *offset Get the value which is added to the Y position when reading the joystick status. - +.El .Sh TECHNICAL SPECIFICATIONS - The pinout of the DB-15 connector is as follow: .Pp 1 XY1 (+5v) @@ -91,11 +90,11 @@ The pinout of the DB-15 connector is as follow: Pots are normally 0-150k variable resistors (0-100k sometimes), and according to the IBM techref, the time is given by Time = 24.2e-6s + 0.011e-6s * R/Ohms - .Sh FILES .Bl -tag -width /dev/joy? .It Pa /dev/joy? joystick device files +.El .Sh AUTHORS .An Jean-Marc Zucconi Aq jmz@cabri.obs-besancon.fr .Sh HISTORY diff --git a/share/man/man4/keyboard.4 b/share/man/man4/keyboard.4 index 6c570da..a0e27d7 100644 --- a/share/man/man4/keyboard.4 +++ b/share/man/man4/keyboard.4 @@ -8,7 +8,6 @@ .Nm keyboard .Nd pc keyboard interface .Sh DESCRIPTION - The PC keyboard is used as the console character input device. The keyboard is owned by the current virtual console. @@ -19,7 +18,7 @@ The virtual console with the same number as the function key is then selected as the current virtual console and given exclusive use of the keyboard and display. - +.Pp The console allows entering values that are not physically present on the keyboard via a special keysequence. To use this facility press and hold down ALT, @@ -34,21 +33,23 @@ It is activated by pressing the scroll-lock key. This holds the display, and enables the cursor arrows for scrolling up and down through the last scrolled out lines. - +.Pp The keyboard is configurable to suit the individual user and the different national layout. - +.Pp The keys on the keyboard can have any of the following functions: - - Normal key - Enter the ASCII value associated with the key. - - Function key - Enter a string of ASCII values. - - Switch Key - Switch virtual console. - - Modifier Key - Change the meaning of another key. - - +.Pp +.Bl -tag -width "Modifier Key" -compact +.It "Normal key" +Enter the ASCII value associated with the key. +.It "Function key" +Enter a string of ASCII values. +.It "Switch Key" +Switch virtual console. +.It "Modifier Key" +Change the meaning of another key. +.El +.Pp The keyboard is seen as a number of keys numbered from 1 to n. This number is often referred to as the "scancode" for a given key. The number @@ -56,7 +57,7 @@ of the key is transmitted as an 8 bit char with bit 7 as 0 when a key is pressed, and the number with bit 7 as 1 when released. This makes it possible to make the mapping of the keys fully configurable. - +.Pp The meaning of every key is programmable via the PIO_KEYMAP ioctl call, that takes a structure keymap_t as argument. The layout of this structure is as @@ -76,19 +77,20 @@ follows: The field n_keys tells the system how many keydefinitions (scancodes) follows. Each scancode is then specified in the key_t substructure. - +.Pp Each scancode can be translated to any of 8 different values, depending on the shift, control, and alt state. These eight possibilities are represented by the map array, as shown below: - +.Bd -literal alt scan cntrl alt alt cntrl code base shift cntrl shift alt shift cntrl shift map[n] 0 1 2 3 4 5 6 7 ---- ------------------------------------------------------ 0x1E 'a' 'A' 0x01 0x01 'a' 'A' 0x01 0x01 - +.Ed +.Pp This is the default mapping for the key labelled 'A' which normally has scancode 0x1E. The eight states are as shown, giving the 'A' key its normal behavior. @@ -101,10 +103,10 @@ If the bit is 1 the key is "special". This means it does not emit anything; instead it changes the "state". That means it is a shift, control, alt, lock, switch-screen, function-key or no-op key. The bitmap is backwards ie. 7 for base, 6 for shift etc. - +.Pp The flgs field defines if the key should react on caps-lock (1), num-lock (2), both (3) or ignore both (0). - +.Pp The .Xr kbdcontrol 1 utility is used to load such a description into/outof @@ -112,9 +114,9 @@ the kernel at runtime. This makes it possible to change the key assignments at runtime, or more important to get (GIO_KEYMAP ioctl) the exact key meanings from the kernel (fx. used by the X server). - +.Pp The function keys can be programmed using the SETFKEY ioctl call. - +.Pp This ioctl takes a argument of the type fkeyarg_t: .Bd -literal -offset indent struct fkeyarg { @@ -127,17 +129,17 @@ This ioctl takes a argument of the type fkeyarg_t: The field keynum defines which function key that is programmed. The array keydef should contain the new string to be used (MAXFK long), and the length should be entered in flen. - +.Pp The GETFKEY ioctl call works in a similar manner, except it returns the current setting of keynum. - +.Pp The function keys are numbered like this: .Bd -literal -offset indent F1-F12 key 1 - 12 Shift F1-F12 key 13 - 24 Ctrl F1-F12 key 25 - 36 Ctrl+shift F1-F12 key 37 - 48 - + Home key 49 Up arrow key 50 Page Up key 51 @@ -156,7 +158,7 @@ The function keys are numbered like this: Left window key 63 Menu key 64 .Ed - +.Pp The .Xr kbdcontrol 1 utility also allows changing these values at runtime. diff --git a/share/man/man4/kld.4 b/share/man/man4/kld.4 index 52b0e50..bb5fabd 100644 --- a/share/man/man4/kld.4 +++ b/share/man/man4/kld.4 @@ -118,6 +118,7 @@ file containing definitions required to compile a module .It Pa /usr/share/examples/kld example source code implementing a sample kld module +.El .Sh SEE ALSO .Xr kldfind 2 , .Xr kldfirstmod 2 , diff --git a/share/man/man4/lp.4 b/share/man/man4/lp.4 index 6dc0012..841ffc8 100644 --- a/share/man/man4/lp.4 +++ b/share/man/man4/lp.4 @@ -155,7 +155,6 @@ the data-out bits can be written in a single instruction - otherwise certain byte values in the packet data would falsely be interpreted as end-of-packet. This is not a problem for the PC printer port, but requires care when implementing this protocol on other equipment. - .Ss Crynwr/Linux CLPIP mode The signal lines are used as follows: .Bl -tag -width dataxxxx(Pinxx) diff --git a/share/man/man4/man4.alpha/linux.4 b/share/man/man4/man4.alpha/linux.4 index 8987e31..3aab977 100644 --- a/share/man/man4/man4.alpha/linux.4 +++ b/share/man/man4/man4.alpha/linux.4 @@ -31,7 +31,7 @@ .Nd Linux ABI support .Sh SYNOPSIS To link Linux ABI support into the kernel: -.Cd options COMPAT_LINUX +.Cd "options COMPAT_LINUX" .Pp To load the Linux ABI support kernel module: .Dl kldload linux diff --git a/share/man/man4/man4.i386/alpm.4 b/share/man/man4/man4.i386/alpm.4 index 841ebcd..caf6bea 100644 --- a/share/man/man4/man4.i386/alpm.4 +++ b/share/man/man4/man4.i386/alpm.4 @@ -37,7 +37,7 @@ This driver provides access to the .Tn Aladdin 15x3 Power Management Unit. Currently, only smbus controller function is implemented. - +.Pp The embedded SMBus controller of the Aladdin chipset may give you access to the monitoring facilities of your mainboard. See diff --git a/share/man/man4/man4.i386/cs.4 b/share/man/man4/man4.i386/cs.4 index f22c712..1d2ac4c 100644 --- a/share/man/man4/man4.i386/cs.4 +++ b/share/man/man4/man4.i386/cs.4 @@ -89,6 +89,7 @@ A PnP adapter was found, but configuration parameters for it could not be read. .It "failed to pnp card parametars" The parameters obtained via PnP were not accepted by the driver. The adapter may not function. +.El .Sh CAVEATS The CS89x0 family of adapters have a very small RAM buffer (4K). This may cause problems with extremely high network loads or bursty network traffic. diff --git a/share/man/man4/man4.i386/cx.4 b/share/man/man4/man4.i386/cx.4 index 4c29088..6cbecd4 100644 --- a/share/man/man4/man4.i386/cx.4 +++ b/share/man/man4/man4.i386/cx.4 @@ -23,6 +23,7 @@ by software at adapter initialization. Legal values are: 3, 5, 7, 10, 11, 12, 15 .It DMA 5, 6, 7 +.El .Sh DESCRIPTION The Cronyx-Sigma driver supports the adapters of models 100, 400, 500, 401, 404, 410, 440, 703, 801, 810, 840. Different models have @@ -78,7 +79,7 @@ An example: .Bd -literal cd /dev sh MAKEDEV cronyx ttyx0 ttyx1 ttyy0 -.El +.Ed .Sh "Asynchronous driver" The asynchronous channel device files have the names: .Pa /dev/ttyx# diff --git a/share/man/man4/man4.i386/dgb.4 b/share/man/man4/man4.i386/dgb.4 index 5dfbbfe..cf3a91e 100644 --- a/share/man/man4/man4.i386/dgb.4 +++ b/share/man/man4/man4.i386/dgb.4 @@ -51,10 +51,11 @@ All values are just examples. The \fBNDGBPORTS\fR option defines the total number of ports on all cards installed in the system. When not defined the number is computed: - -.br - default \fBNDGBPORTS\fR = number_of_described_DigiBoard_cards * 16 - +.Pp +.Bd -ragged -offset 4n +default \fBNDGBPORTS\fR = number_of_described_DigiBoard_cards * 16 +.Ed +.Pp If it is less than the actual number of ports the system will be able to use only the first \fBNDGBPORTS\fR ports. @@ -344,6 +345,7 @@ Internal problems in driver. .Bl -diag .It dgb\fIX\fB: port \fIY\fB: timeout on FEP command Problems in hardware. +.El .Sh SEE ALSO .Xr stty 1 , .Xr termios 4 , diff --git a/share/man/man4/man4.i386/fe.4 b/share/man/man4/man4.i386/fe.4 index 219ad11..ff7661e 100644 --- a/share/man/man4/man4.i386/fe.4 +++ b/share/man/man4/man4.i386/fe.4 @@ -93,7 +93,7 @@ Flag bits not specified below are reserved and must be set to 0. Actually, each bit is either just ignored by the driver, or tested and used to control undocumented features of the driver. Consult the source program for undocumented features. -.Bl -tag -width "99999999" +.Bl -tag -width 8n .It Li 0x007F These flag bits are used to initialize DLCR6 register of MB86960A/MB86965A chip, @@ -218,7 +218,7 @@ The driver tries to get IRQ setting from the configuration EEPROM on the board, if -.Dq irq \&? +.Dq irq ?\& is specified in the configuration file. Unfortunately, AT1700 series and RE2000 series seems to have two types of models; @@ -251,7 +251,7 @@ Statistics on the number of collisions maintained by the .Nm driver is not accurate; the -.Fi i +.Fl i option of .Xr netstat 1 shows slightly less value than true number of collisions. diff --git a/share/man/man4/man4.i386/gsc.4 b/share/man/man4/man4.i386/gsc.4 index d4a25c6..b28ff88 100644 --- a/share/man/man4/man4.i386/gsc.4 +++ b/share/man/man4/man4.i386/gsc.4 @@ -107,7 +107,8 @@ of the bitmap must be supplied in .Em pnm mode since the driver must know at what time the -'end-of-file' shall be reached. +.Sq end-of-file +shall be reached. With this feature you are able to directly copy the scanner output into a pbm file with .Xr cat . @@ -310,7 +311,7 @@ dd if=/dev/gsc0 of=rawfile bs=(width/8) count=(height) cat /dev/gsc0p > pbmfile .Ed .Sh DIAGNOSTICS -.Bl -tag +.Bl -tag -width Cd .It GSCDEBUG When you define this name as an `option' in the kernel configuration you can get debug output if you access the driver with a minor number diff --git a/share/man/man4/man4.i386/linux.4 b/share/man/man4/man4.i386/linux.4 index fef1230..926b4ab 100644 --- a/share/man/man4/man4.i386/linux.4 +++ b/share/man/man4/man4.i386/linux.4 @@ -31,7 +31,7 @@ .Nd Linux ABI support .Sh SYNOPSIS To link Linux ABI support into the kernel: -.Cd options COMPAT_LINUX +.Cd "options COMPAT_LINUX" .Pp To load the Linux ABI support kernel module: .Dl kldload linux diff --git a/share/man/man4/man4.i386/lnc.4 b/share/man/man4/man4.i386/lnc.4 index 70dee2a..84c4341 100644 --- a/share/man/man4/man4.i386/lnc.4 +++ b/share/man/man4/man4.i386/lnc.4 @@ -42,14 +42,22 @@ including the Am7990 and Am79C960. The Ethernet cards supported by the .Nm interface are: -.Bl -tag -width -offset ident -compat -.It Novell NE2100 -.It Novell NE32-VL -.It Isolan BICC -.It Digital DEPCA -.It Hewlett Packard Vectra 486/66XM -.It Hewlett Packard Vectra XU -.It Diamond HomeFree +.Pp +.Bl -item -offset ident -compact +.It +Novell NE2100 +.It +Novell NE32-VL +.It +Isolan BICC +.It +Digital DEPCA +.It +Hewlett Packard Vectra 486/66XM +.It +Hewlett Packard Vectra XU +.It +Diamond HomeFree .El .Sh DIAGNOSTICS .Bl -diag diff --git a/share/man/man4/man4.i386/matcd.4 b/share/man/man4/man4.i386/matcd.4 index 56b799a..e13b021 100644 --- a/share/man/man4/man4.i386/matcd.4 +++ b/share/man/man4/man4.i386/matcd.4 @@ -91,13 +91,9 @@ .Nm matcd .Nd Matsushita (Panasonic) CD-ROM driver .Sh SYNOPSIS -.Pp .Cd "device matcd[0-4] at isa? port [?| addr]" -.br .Cd "/dev/[r]matcd[0-15][a|c] -.br .Cd "/dev/[r]matcdl[0-15][a|c] -.Pp .Sh DESCRIPTION The .Nm @@ -106,44 +102,42 @@ Matsushita-Kotobuki Electronics Industries, or Matsushita for short. These CD-ROM drives have been sold under the Panasonic (which is a trade name for Matsushita), Creative Labs (omniCD) and Reveal names, and have been included in computers made by Tandy, AST, Packard Bell and many others. - +.Pp These drives connect to the PC ISA bus through a proprietary host interface. This interface can exist as a stand-alone ISA card, or can be included on a sound card. - .Sh DRIVER CONFIGURATION The .Nm driver supports up to four host interfaces with up to four drives on each interface. Audio activity may occur on all drives simultaneously. Data read operations are limited to one drive per host interface at any instant. - +.Pp To support multiple host interfaces, it is necessary to modify the entries in the kernel configuration file. Normally your system comes with the file \fI/usr/src/sys/i386/conf/GENERIC\fR. You should make a copy of this file and give it the name of your system. You can then edit the new file to include devices you want the system to support and delete the device entries that you don't want. - +.Pp In this file, you will find an entry like: - - device matcd0 at isa? port ? - +.Bd -literal -offset indent +device matcd0 at isa? port ? +.Ed +.Pp To support two host interfaces, change the file so it reads: - - device matcd0 at isa? port ? -.br - device matcd1 at isa? port ? -.br - +.Bd -literal -offset indent +device matcd0 at isa? port ? +device matcd1 at isa? port ? +.Ed +.Pp (If you want to support up to three or four host interfaces, add additional entries). -.if n .bp -.if t .sp +.Pp Note that the kernel configuration does not need to be modified to support up to four drives on a single host interface. It is also not necessary to have four drives on a single interface before adding a second interface. - +.Pp By default, .Nm searches for the CD-ROM host interface adapters by using a table of known I/O @@ -153,8 +147,7 @@ that are located at the I/O ports that .Nm is checking for CD-ROM host interfaces. In addition, checking multiple locations can cause the boot process to take longer than it could. -.if t .bp -.if n .sp +.Pp If you are having these problems, you can solve them by explicitly specifying where the CD-ROM host interfaces are located. For example, by default most SoundBlaster cards have the Matsushita CD-ROM host interface @@ -166,20 +159,20 @@ opportunity to change settings for any of the devices included the kernel. For example, to change the I/O port for .Nm adapter zero to 0x340, you would type - - config> port matcd0c 0x340 - +.Pp +.Dl "config> port matcd0c 0x340" +.Pp If you recompile the kernel, you can change the entry in the kernel configuration file to specify a specific address by changing an entry like this: - - device matcd0 at isa? port 0x230 - +.Pp +.Dl "device matcd0 at isa? port 0x230" +.Pp With this change, the .Nm driver will only look at I/O port 0x230 for the first CD-ROM host interface and will not disturb any other I/O ports. - +.Pp Once you have adjusted the kernel configuration file, it is necessary to configure and recompile the kernel, install it and reboot for the changes to take effect. @@ -187,40 +180,38 @@ changes to take effect. At this time, there are only two known drive models that work with the .Nm driver: -.Bl -tag -width CR-123-X -compact -offset indent -.br -.It Matsushita CR-562-x -.br -.It Matsushita CR-563-x -.br +.Bl -item -width CR-123-X -compact -offset indent +.It +Matsushita CR-562-x +.It +Matsushita CR-563-x .El Most resellers leave these original markings on the drives since the label also has the FCC, VDE, CSA and RU certification marks. - +.Pp Both of these drive models have motorized trays. There is also a custom version of these drives that does not have the volume control or headphone jack (seen on some Tandy computers), but this drive also works with .Nm . - +.Pp The Matsushita CR-522-x and CR-523-x CD-ROM drive is not usable with .Nm . The CR-522 and CR-523 can also be identified from the front as it requires a CD-caddy. - +.Pp Drives with IDE interfaces must use an IDE driver. - +.Pp The TEAC CD-55 4X CD-ROM drive also uses the Creative/Panasonic interface but the TEAC drive is \fInot\fR compatible with the Matsushita CR-56x drives. The TEAC drive cannot be used with .Nm . -.if t .sp -.if n .bp +.Pp The most common source of host interface adapters for the Panasonic drives are found in products from Creative Labs, including SoundBlaster sound cards. There are numerous models of SoundBlaster sound cards, and most of the newer cards provide the appropriate interface, sometimes labeled as the "Creative/Panasonic" interface. - +.Pp The following host interface adapters are known to work with the .Nm driver: @@ -244,28 +235,26 @@ PhoneBlaster SB16 + Sierra 14.4K Voice/FAX/Data/Speakerphone modem combo (CT3100 .It Reveal (SC400) .El - +.Pp Caution: Some of these sound boards can be optionally manufactured to not include the Panasonic/Creative interface, so check the board before buying solely based on model number. - +.Pp This is by no means a complete list as Creative Labs and other vendors that produce sound cards with an identical Creative/Panasonic drive interface release new versions of their adapters all the time. - +.Pp In addition to Creative Labs adapters, adapters that are compatible with Media Vision, IBM and Lasermate adapters are also supported. However, these adapters use a wide range of I/O port addresses, so the driver must be reconfigured to locate these adapters. - +.Pp It is important to understand that some manufacturers have a different host interface implementation. If you have a board that won't communicate with the drives under MS-DOS using the genuine Creative Labs drivers, then .Nm may not work with that host adapter. -.br -.if t .bp -.if n .sp +.Pp .Sh SUPPORTED OPERATIONS The .Nm @@ -274,15 +263,14 @@ driver supports block and character access. Partition "a" returns 2352-byte Frames from any type of CD, including audio CDs. (Partition "c" cannot be "mounted" with cd9660 or other filesystem emulators.) No other partitions are supported. - +.Pp The .Nm matcdl devices work the same as the normal .Nm devices except that the drive trays are locked and remain locked until all of the devs on that drive are closed. -.if n .bp -.if t .sp +.Pp .Nm Matcd accepts numerous .Fn ioctl @@ -356,7 +344,6 @@ The commands defined above are the only ones that the .Nm driver supports. -.bp .Sh FILES .Bl -tag -width /dev/(r)matcd0a_/dev/(r)matcdl0a -compact .It Pa /dev/[r]matcd0a /dev/[r]matcdl0a @@ -369,7 +356,7 @@ recorded in any format. Source code and compilation options for .Nm . .El - +.Pp The file \fIoptions.h\fR contains all of the compilation options. By default, the driver is configured to run on the current version of .Fx . @@ -377,21 +364,21 @@ By default, the driver is configured to run on the current version of .Pp The Creative/Panasonic interface does not use interrupts or DMA although the drives themselves are capable of using both. - +.Pp If the disc tray is opened while one or more partitions are open, further I/O to all partitions on the drive will be rejected until all partitions are closed. - +.Pp There must be a drive on each host interface that is addressed as physical drive 0. If this isn't the case, the driver will be unable to find the host interface or any of the connected drives. - +.Pp Drives on a second host interface start are considered logical drives 4-7, 8-11 on the third interface and 12-15 on the fourth. - +.Pp The first drive on the second host interface is logical drive 4 regardless of how many drives are present on the first host interface. - +.Pp Host interfaces are numbered in the order they are declared in the kernel configuration file, or in the order they are found if the kernel configuration file uses "?" for the port address. Host interface @@ -401,7 +388,7 @@ numbers are always contiguous. .Sh AUTHORS The driver and documentation was written by .An Frank Durda IV . -.br +.Pp Program and Documentation are Copyright 1994, 1995, All rights reserved. .Sh HISTORY @@ -409,5 +396,3 @@ The .Nm driver appeared in .Fx 2.0.5 . - -509253 diff --git a/share/man/man4/man4.i386/pnp.4 b/share/man/man4/man4.i386/pnp.4 index 86117d5..5f00620 100644 --- a/share/man/man4/man4.i386/pnp.4 +++ b/share/man/man4/man4.i386/pnp.4 @@ -64,7 +64,6 @@ where CSN and LDN are the Card Select Number and Logical Device Number associated to the device. Following this sequence any combination of the following commands can be used: - .Bl -tag -width "mmmmmmmmmm"" .It Dv irqN line Sets the irq line for interrupt 0 or 1 on the card. diff --git a/share/man/man4/man4.i386/scd.4 b/share/man/man4/man4.i386/scd.4 index 3c9aec4..43cd648 100644 --- a/share/man/man4/man4.i386/scd.4 +++ b/share/man/man4/man4.i386/scd.4 @@ -48,6 +48,7 @@ Normally, there is only one file system on a CDROM disc. .It Pa /dev/[r]scd0c accesses the raw device. +.El .Sh SEE ALSO .Pa /sys/i386/isa/scd.c .Sh AUTHORS diff --git a/share/man/man4/man4.i386/spkr.4 b/share/man/man4/man4.i386/spkr.4 index 0d022bb..d5a7571 100644 --- a/share/man/man4/man4.i386/spkr.4 +++ b/share/man/man4/man4.i386/spkr.4 @@ -147,7 +147,6 @@ sustain dots. May also be written .It Ns Li T Sy n Sets the number of quarter notes per minute; default is 120. Musical names for common tempi are: - .Bd -literal -offset indent Tempo Beats Per Minute very slow Larghissimo diff --git a/share/man/man4/man4.i386/streams.4 b/share/man/man4/man4.i386/streams.4 index 8327d72..6860ad0 100644 --- a/share/man/man4/man4.i386/streams.4 +++ b/share/man/man4/man4.i386/streams.4 @@ -69,9 +69,8 @@ SVR4 STREAMS services to BSD applications will be sorely disappointed. .Sh SEE ALSO .Xr svr4 4 .Sh HISTORY -System V Release 4 ABI support first appeared in FreeBSD +System V Release 4 ABI support first appeared in .Fx 4.0 . The ABI was ported from an equivalent facility present in -NetBSD -.Fx 1.3 +.Nx 1.3 written by Christos Zoulas. diff --git a/share/man/man4/man4.i386/svr4.4 b/share/man/man4/man4.i386/svr4.4 index 518c76c..2782fff 100644 --- a/share/man/man4/man4.i386/svr4.4 +++ b/share/man/man4/man4.i386/svr4.4 @@ -31,7 +31,7 @@ .Nd System V Release 4 ABI support .Sh SYNOPSIS To link System V Release 4 (SVR4) ABI support into the kernel: -.Cd options COMPAT_SVR4 +.Cd options COMPAT_SVR4 .Pp To load the SVR4 ABI support kernel module: .Dl kldload svr4 @@ -201,9 +201,8 @@ module entrypoints. .Xr streams 4 , .Xr elf 5 .Sh HISTORY -System V Release 4 ABI support first appeared in FreeBSD +System V Release 4 ABI support first appeared in .Fx 4.0 . The ABI was ported from an equivalent facility present in -NetBSD -.Fx 1.3 +.Nx 1.3 written by Christos Zoulas. diff --git a/share/man/man4/man4.i386/vx.4 b/share/man/man4/man4.i386/vx.4 index dd7f07d..beb45fd 100644 --- a/share/man/man4/man4.i386/vx.4 +++ b/share/man/man4/man4.i386/vx.4 @@ -62,6 +62,7 @@ Use the UTP port. There are not enough devices in the kernel configuration file for the number of adapters present in the system. Add devices to the configuration file, rebuild the kernel, and reboot. +.El .Pp All other diagnostics indicate either a hardware problem or a bug in the driver. diff --git a/share/man/man4/man4.i386/wd.4 b/share/man/man4/man4.i386/wd.4 index 88a4b63..42db826 100644 --- a/share/man/man4/man4.i386/wd.4 +++ b/share/man/man4/man4.i386/wd.4 @@ -53,7 +53,7 @@ the parameter. .Pp For each drive there are six bit-fields encoded in a 16 bit integer: -.Bl -tag -width 0x0000 -offset 1c +.Bl -tag -width 0x0000 .It 0x8000 Test and use the 32bit transfer capability of the drive. .It 0x4000 diff --git a/share/man/man4/man4.i386/wt.4 b/share/man/man4/man4.i386/wt.4 index 2d4134c..5929acb 100644 --- a/share/man/man4/man4.i386/wt.4 +++ b/share/man/man4/man4.i386/wt.4 @@ -37,9 +37,11 @@ The .Nm driver provides support for the following Archive and Wangtek boards: .Pp -.Bl -tag -width -offset indent -compact -.It QIC-02 -.It QIC-36 +.Bl -item -offset indent -compact +.It +QIC-02 +.It +QIC-36 .El .Pp .Sh SEE ALSO diff --git a/share/man/man4/netgraph.4 b/share/man/man4/netgraph.4 index e912b69..2ae6362 100644 --- a/share/man/man4/netgraph.4 +++ b/share/man/man4/netgraph.4 @@ -98,7 +98,7 @@ Nodes may be assigned a globally unique name which can be used to refer to the node. The name must not contain the characters -.Dq \&. +.Dq .\& or .Dq \&: and is limited to @@ -127,7 +127,7 @@ A hook has an name which is unique among all hooks on that node (other hooks on other nodes may have the same name). The name must not contain a -.Dq \&. +.Dq .\& or a .Dq \&: and is @@ -474,7 +474,7 @@ starting hook traversal at the local node. .Pp There are a couple of special possibilities for the node name. The name -.Dq \&. +.Dq .\& (referred to as .Dq \&.: ) always refers to the local node. @@ -556,8 +556,6 @@ addressing to route the messages. The message may have travelled from to .Em B as a synchronous reply, saving time and cycles. - - .Pp A similar graph might be used to represent multi-link PPP running over an ISDN line: @@ -578,7 +576,6 @@ however you should check .Pa sys/netgraph/netgraph.h on your system for more up-to-date versions. - .Bd -literal struct ng_node { char *name; /* Optional globally unique name */ @@ -896,7 +893,6 @@ header fields filled in, plus the NUL-terminated string version of the arguments in the arguments field. If successful, the reply contains the binary version of the control message. .El - .Sh Flow Control Messages In addition to the control messages that affect nodes with respect to the graph, there are also a number of @@ -937,19 +933,15 @@ code may either be statically compiled into the kernel or else loaded dynamically as a KLD via .Xr kldload 8 . In the former case, include -.Bd -literal -offset 4n -compact - - options NETGRAPH - -.Ed +.Pp +.Dl options NETGRAPH +.Pp in your kernel configuration file. You may also include selected node types in the kernel compilation, for example: -.Bd -literal -offset 4n -compact - - options NETGRAPH - options NETGRAPH_SOCKET - options NETGRAPH_ECHO - +.Bd -literal -offset indent +options NETGRAPH +options NETGRAPH_SOCKET +options NETGRAPH_ECHO .Ed .Pp Once the @@ -1106,7 +1098,6 @@ This intriguing node looks like a socket to the system but diverts all data to and from the netgraph system for further processing. This allows such things as UDP tunnels to be almost trivially implemented from the command line. - .El .Pp Refer to the section at the end of this man page for more nodes types. diff --git a/share/man/man4/ng_bpf.4 b/share/man/man4/ng_bpf.4 index 5b58b0e..b1a9a0b 100644 --- a/share/man/man4/ng_bpf.4 +++ b/share/man/man4/ng_bpf.4 @@ -52,7 +52,7 @@ node type allows Berkeley Packet Filter (see filters to be applied to data travelling through a Netgraph network. Each node allows an arbitrary number of connections to arbitrarily named hooks. With each hook is associated a -.Xf bpf 4 +.Xr bpf 4 filter program which is applied to incoming data only, a destination hook for matching packets, a destination hook for non-matching packets, and various statistics counters. diff --git a/share/man/man4/ng_one2many.4 b/share/man/man4/ng_one2many.4 index a38cc0a..5e49d9e 100644 --- a/share/man/man4/ng_one2many.4 +++ b/share/man/man4/ng_one2many.4 @@ -154,6 +154,7 @@ clears the statistics for that link. Same as .Dv NGM_ONE2MANY_GET_STATS , but also atomically clears the statistics for the link as well. +.El .Sh SHUTDOWN This node shuts down upon receipt of a .Dv NGM_SHUTDOWN diff --git a/share/man/man4/ng_tty.4 b/share/man/man4/ng_tty.4 index ebcc836..648680b 100644 --- a/share/man/man4/ng_tty.4 +++ b/share/man/man4/ng_tty.4 @@ -108,6 +108,7 @@ so that all received data is forwarded immediately. .It Dv NGM_TTY_GET_HOTCHAR Returns an integer containing the current hot character in the lower eight bits. +.El .Sh SHUTDOWN This node shuts down when the corresponding device is closed (or the line discipline is uninstalled on the device). diff --git a/share/man/man4/ng_vjc.4 b/share/man/man4/ng_vjc.4 index 3e7a593..d5c7d6f 100644 --- a/share/man/man4/ng_vjc.4 +++ b/share/man/man4/ng_vjc.4 @@ -106,6 +106,7 @@ Downstream compressed TCP packets. Downstream uncompressed TCP packets. .It Dv vjip Downstream uncompressed IP packets. +.El .Sh CONTROL MESSAGES This node type supports the generic control messages, plus the following: .Bl -tag -width foo @@ -179,6 +180,7 @@ node immediately after detecting that a received frame has been lost, due to a bad checksum or for any other reason. Failing to do this can result in corrupted TCP stream data. +.El .Sh SHUTDOWN This node shuts down upon receipt of a .Dv NGM_SHUTDOWN diff --git a/share/man/man4/ohci.4 b/share/man/man4/ohci.4 index da2f071..0acaa48 100644 --- a/share/man/man4/ohci.4 +++ b/share/man/man4/ohci.4 @@ -52,7 +52,7 @@ includes .It CMD Tech 670 (USB0670) .It CMD Tech 673 (USB0673) .El - +.Pp or any other OHCI v1.0 compliant controller. .Sh SEE ALSO .Xr uhci 4 diff --git a/share/man/man4/pass.4 b/share/man/man4/pass.4 index eb7f64b..bd1f243 100644 --- a/share/man/man4/pass.4 +++ b/share/man/man4/pass.4 @@ -89,7 +89,7 @@ ioctl. It is probably more useful to issue this ioctl through the device. .El .Sh FILES -.Bl -tag -width 01234567890 -compact +.Bl -tag -width /dev/passn -compact .It Pa /dev/pass Ns Ar n Character device nodes for the .Nm diff --git a/share/man/man4/pci.4 b/share/man/man4/pci.4 index af51350..b46c3a3 100644 --- a/share/man/man4/pci.4 +++ b/share/man/man4/pci.4 @@ -262,7 +262,7 @@ reading registers, above, also apply to writing configuration registers. .El .Sh FILES -.Bl -tag -width 01234567890 -compact +.Bl -tag -width /dev/pci -compact .It Pa /dev/pci Character device for the .Nm diff --git a/share/man/man4/pcm.4 b/share/man/man4/pcm.4 index 61dbe07..3fb6fb8 100644 --- a/share/man/man4/pcm.4 +++ b/share/man/man4/pcm.4 @@ -70,7 +70,6 @@ since they identify themselves. For legacy ISA cards, the driver looks for MSS cards at addresses 0x530 and 0x604 (obviously, unless overridden in the kernel config file by specifying an address). - .Sh IOCTL The driver supports most of the Voxware ioctls(), and most applications work unmodified (including popular mpeg players and linux @@ -80,16 +79,13 @@ memory-mapped access to the audio buffers). As a consequence, some applications may need to be recompiled with a slightly modified audio module. See /usr/include/sys/soundcard.h for a complete list of the supported ioctls. - .Sh SUPPORTED CARDS .Pp Below we include a list of supported codecs/cards. If your sound card is not listed here, it may be supported by a bridge driver. - -.Bl -tag -width 2m % begin list +.Bl -tag -width 2m .It CS4237, CS4236, CS4232, CS4231 (ISA) -.Pp All these cards work perfectly in full duplex using the MSS mode. This chipset is used, among others, on the A/Open AW35 and AW32, on some Intel motherboards, and (the CS4231) on some non-PnP cards. @@ -99,31 +95,21 @@ I am not sure if this is true. On one of my Intel motherboards, capture does not work simply because the capture DMA channel is not wired to the ISA DMA controller. - .It Yamaha OPL-SAx (ISA) -.Pp Works perfectly in all modes. This chip is used in several PnP cards, but also (in non-PnP mode) on motherboards and laptops (e.g. the Toshiba Libretto). - .It OPTi931 (ISA) -.Pp The chip is buggy, but the driver has many workarounds to make it work in full duplex because for some time these were the only full duplex cards I could find. u-law formats uses U8 format internally because of a bug in the chip. - .It Trident 4DWave DX/NX (PCI) -.Pp .It ENSONIQ AudioPCI ES1370/1371 (PCI) -.Pp Creative Labs SoundBlaster PCI is supported as well. - .It ESS Solo-1/1E (PCI) -.Pp .It NeoMagic 256AV/ZX (PCI) -.Pp .El .Sh FILES The following commonly used symbolic links to real device nodes @@ -184,10 +170,8 @@ should be created last. .Bl -tag -width 2m .It ac97: dac not ready AC97 codec is not likely to be accompanied with the sound card. - .It unsupported subdevice XX A device node is not created properly. - .El .Sh BUGS Some features of your cards (e.g. global volume control) might not diff --git a/share/man/man4/pcvt.4 b/share/man/man4/pcvt.4 index 2df8ef9..315a2c3 100644 --- a/share/man/man4/pcvt.4 +++ b/share/man/man4/pcvt.4 @@ -700,6 +700,7 @@ driver .Pq relative to the kernel source tree Documents the various compile-time options to tailor .Nm . +.El .Sh HISTORY The .Nm diff --git a/share/man/man4/ppbus.4 b/share/man/man4/ppbus.4 index 1ee649cc..735e931 100644 --- a/share/man/man4/ppbus.4 +++ b/share/man/man4/ppbus.4 @@ -50,7 +50,7 @@ and to utilize different parallel port chipsets. .Sh DEVICE DRIVERS In order to write new drivers or port existing drivers, the ppbus system provides the following facilities: -.Bl -bullet -item -offset indent +.Bl -bullet -offset indent .It architecture-independent macros or functions to access parallel ports .It @@ -106,7 +106,7 @@ But, for an other architecture, accesses to one of our logical registers (data, status, control...) may require more than one I/O access. .Ss Description The parallel port may operate in the following modes: -.Bl -bullet -item -offset indent +.Bl -bullet -offset indent .It compatible mode, also called Centronics mode .It diff --git a/share/man/man4/ppi.4 b/share/man/man4/ppi.4 index ea29e7b..336167a 100644 --- a/share/man/man4/ppi.4 +++ b/share/man/man4/ppi.4 @@ -54,7 +54,7 @@ All I/O on the interface is performed using .Fn ioctl calls. Each command takes a single -.Ty u_int8_t +.Ft u_int8_t argument, transferring one byte of data. The following commands are available: .Bl -tag -width 10 diff --git a/share/man/man4/sa.4 b/share/man/man4/sa.4 index 649dc72..f3ec8fc 100644 --- a/share/man/man4/sa.4 +++ b/share/man/man4/sa.4 @@ -103,6 +103,7 @@ If the tape has been written, then a file mark will be written before the rewind is requested. On completion of the rewind an unload command will be issued. The device is unmounted. +.El .Sh BLOCKING MODES .Tn SCSI tapes may run in either @@ -184,6 +185,7 @@ Eject on close (if capable) .It Pa /dev/sa0.ctl Control mode device (to examine state while another program is accessing the device, e.g.). +.El .Sh BUGS This driver lacks many of the hacks required to deal with older devices. Many older @@ -221,7 +223,10 @@ Many ideas were gleaned from the device driver written and ported from .Tn Mach 2.5 -by Julian Elischer. +by +.An Julian Elischer . .Pp -The current owner of record is Matthew Jacob who has suffered too many +The current owner of record is +.An Matthew Jacob +who has suffered too many years of breaking tape drivers. diff --git a/share/man/man4/sbc.4 b/share/man/man4/sbc.4 index 03de523..7f44313 100644 --- a/share/man/man4/sbc.4 +++ b/share/man/man4/sbc.4 @@ -43,7 +43,7 @@ The bridge driver allows the generic audio drivers including .Xr pcm 4 to attach to the following ISA sound cards: -.Bl -bullet -tag -width 2m indent +.Bl -bullet -width 2m .It Creative SB16, SB32, SB AWE64 (including Gold) and ViBRA16 .It @@ -57,7 +57,7 @@ If the secondary DMA channel is C, set the flags to (C | 0x10). For a sound card without the secondary DMA channel, the flags should be set to zero. .Sh DIAGNOSTICS -.Bl -tag -width 2m % begin list +.Bl -tag -width 2m .It sb_dspwr(XX) timed out. .Pp A command to the DSP has timed out. diff --git a/share/man/man4/scsi.4 b/share/man/man4/scsi.4 index a0c6647..c2da1f6 100644 --- a/share/man/man4/scsi.4 +++ b/share/man/man4/scsi.4 @@ -43,15 +43,15 @@ .Cd "device pt" .Cd "device sa" .Cd "device ch1 at scbus0 target 4 unit 0" -.Cd options CAMDEBUG -.Cd options CAM_DEBUG_BUS=-1 -.Cd options CAM_DEBUG_TARGET=-1 -.Cd options CAM_DEBUG_LUN=-1 -.Cd options CAM_DEBUG_FLAGS=CAM_DEBUG_INFO|CAM_DEBUG_CDB -.Cd options CAM_MAX_HIGHPOWER=4 -.Cd options SCSI_NO_SENSE_STRINGS -.Cd options SCSI_NO_OP_STRINGS -.Cd options SCSI_DELAY=8000 +.Cd "options CAMDEBUG" +.Cd "options CAM_DEBUG_BUS=-1" +.Cd "options CAM_DEBUG_TARGET=-1" +.Cd "options CAM_DEBUG_LUN=-1" +.Cd "options CAM_DEBUG_FLAGS=CAM_DEBUG_INFO|CAM_DEBUG_CDB" +.Cd "options CAM_MAX_HIGHPOWER=4" +.Cd "options SCSI_NO_SENSE_STRINGS" +.Cd "options SCSI_NO_OP_STRINGS" +.Cd "options SCSI_DELAY=8000" .Sh DESCRIPTION The CAM .Tn SCSI diff --git a/share/man/man4/ses.4 b/share/man/man4/ses.4 index aa41885..e9fc6b6 100644 --- a/share/man/man4/ses.4 +++ b/share/man/man4/ses.4 @@ -63,18 +63,18 @@ on the bus. .Pp A separate option, -.B SES_ENABLE_PASSTHROUGH , +.Va SES_ENABLE_PASSTHROUGH , may be specified to allow the .Nm driver to perform functions on devices of other classes that claim to also support -.B SES +.Nm functionality. .Sh IOCTLS The following .Xr ioctl 2 calls apply to -.B SES +.Nm devices. They are defined in the header file .Aq Pa cam/scsi/scsi_ses.h @@ -83,12 +83,12 @@ They are defined in the header file .Bl -tag -width SESIOC_GETENCSTAT .It Dv SESIOC_GETNOBJ Used to find out how many -.B SES +.Nm objects are driven by this particular device instance. .It Dv SESIOC_GETOBJMAP Read, from the kernel, an array of SES objects which contains the object identifier, which subenclosure it is in, and the -.B SES +.Nm type of the object. .It Dv SESIOC_GETENCSTAT Get the overall enclosure status. @@ -100,11 +100,12 @@ Get the status of a particular object. Set the status of a particular object. .It Dv SESIOC_GETTEXT Get the associated help text for an object (not yet implemented). -.B SES +.Nm devices often have descriptive text for an object which can tell you things like location (e.g, "left power supply"). .It Dv SESIOC_INIT Initialize the enclosure. +.El .Sh EXAMPLE USAGE The files contained in .Aq Pa usr/share/examples/ses @@ -117,6 +118,7 @@ The .Em Nth .Nm SES device. +.El .Sh DIAGNOSTICS When the kernel is configured with .Tn DEBUG diff --git a/share/man/man4/smbus.4 b/share/man/man4/smbus.4 index 4899bdd..41f892b 100644 --- a/share/man/man4/smbus.4 +++ b/share/man/man4/smbus.4 @@ -49,15 +49,15 @@ is a two-wire interface through which simple power-related chips can communicate with rest of the system. It uses I2C as its backbone (see .Xr iicbus 4 ). - +.Pp A system using SMB passes messages to and from devices instead of tripping individual control lines. - +.Pp With the SMBus, a device can provide manufacturer information, tell the system what its model/part number is, save its state for a suspend event, report different types of errors, accept control parameters, and return its status. - +.Pp The SMBus may share the same host device and physical bus as ACCESS bus components provided that an appropriate electrical bridge is provided between the internal SMB devices and external ACCESS bus devices. diff --git a/share/man/man4/snd_csa.4 b/share/man/man4/snd_csa.4 index e7291f3..e7eb400 100644 --- a/share/man/man4/snd_csa.4 +++ b/share/man/man4/snd_csa.4 @@ -39,7 +39,7 @@ The bridge driver allows the generic audio drivers including .Xr pcm 4 to attach to the following PCI sound cards: -.Bl -bullet -tag -width 2m indent +.Bl -bullet -width 2m .It Crystal Semiconductor CS461x/462x Audio Accelerator .It diff --git a/share/man/man4/snd_gusc.4 b/share/man/man4/snd_gusc.4 index f8504e6..65ebe15 100644 --- a/share/man/man4/snd_gusc.4 +++ b/share/man/man4/snd_gusc.4 @@ -43,7 +43,7 @@ The bridge driver allows the generic audio drivers including .Xr pcm 4 to attach to the following ISA sound cards: -.Bl -bullet -tag -width 2m indent +.Bl -bullet -width 2m .It Gravis UltraSound PnP .It @@ -55,7 +55,7 @@ If the secondary DMA channel is C, set the flags to (C | 0x10). For a sound card without the secondary DMA channel, the flags should be set to zero. .Sh DIAGNOSTICS -.Bl -tag -width 2m % begin list +.Bl -tag -width 2m .It xxx: gus pcm not attached, out of memory .Pp There are not enough memory to drive the device. diff --git a/share/man/man4/snd_sbc.4 b/share/man/man4/snd_sbc.4 index 03de523..7f44313 100644 --- a/share/man/man4/snd_sbc.4 +++ b/share/man/man4/snd_sbc.4 @@ -43,7 +43,7 @@ The bridge driver allows the generic audio drivers including .Xr pcm 4 to attach to the following ISA sound cards: -.Bl -bullet -tag -width 2m indent +.Bl -bullet -width 2m .It Creative SB16, SB32, SB AWE64 (including Gold) and ViBRA16 .It @@ -57,7 +57,7 @@ If the secondary DMA channel is C, set the flags to (C | 0x10). For a sound card without the secondary DMA channel, the flags should be set to zero. .Sh DIAGNOSTICS -.Bl -tag -width 2m % begin list +.Bl -tag -width 2m .It sb_dspwr(XX) timed out. .Pp A command to the DSP has timed out. diff --git a/share/man/man4/snp.4 b/share/man/man4/snp.4 index 7fde378..27cb120 100644 --- a/share/man/man4/snp.4 +++ b/share/man/man4/snp.4 @@ -18,7 +18,7 @@ .Sh DESCRIPTION /dev/snp? are snoop devices which allow user to attach to any tty and watch activities on it. - +.Pp To associate a given .Nm device with a tty to be observed, open the @@ -46,6 +46,7 @@ tty not attached. .Nm device has been detached by user or tty device has been closed and detached. +.El .Sh SEE ALSO .Xr pty 4 , .Xr sio 4 , diff --git a/share/man/man4/spkr.4 b/share/man/man4/spkr.4 index 0d022bb..d5a7571 100644 --- a/share/man/man4/spkr.4 +++ b/share/man/man4/spkr.4 @@ -147,7 +147,6 @@ sustain dots. May also be written .It Ns Li T Sy n Sets the number of quarter notes per minute; default is 120. Musical names for common tempi are: - .Bd -literal -offset indent Tempo Beats Per Minute very slow Larghissimo diff --git a/share/man/man4/sym.4 b/share/man/man4/sym.4 index d437531..a76ddcf 100644 --- a/share/man/man4/sym.4 +++ b/share/man/man4/sym.4 @@ -181,12 +181,12 @@ The user can indicate a balancing of chip types between the two drivers by defining the .Ar SYM_SETUP_LP_PROBE_MAP kernel configuration option as follows: -.Bl -column "Bit " "53C8XXA, 53C8XX, 53C8XX, 53C8XX, 53C8XX, 53C8XX" -.Em Bit Devices to be attached by ncr instead -0x01 53C810a, 53C860 -0x02 53C825a, 53C875, 53C876, 53C885, 53C895 -0x04 53C895a, 53C896, 53C897, 53C1510d -0x40 53C810, 53C815, 53C825 +.Bl -column "0x40" +.It Em "Bit Devices to be attached by ncr instead" +.It "0x01 53C810a, 53C860" +.It "0x02 53C825a, 53C875, 53C876, 53C885, 53C895" +.It "0x04 53C895a, 53C896, 53C897, 53C1510d" +.It "0x40 53C810, 53C815, 53C825" .El .Pp For example, if @@ -228,24 +228,23 @@ layout are currently supported. If the reading of the NVRAM succeeds, the following settings are taken into account and reported to CAM: .Pp -.Bl -column "SCSI parity checking " "Symbios " "Tekram" -.Em Host settings Symbios Tekram -SCSI parity checking Y N -Host SCSI ident Y Y -Verbose messages Y N -Scan targets hi-lo Y N -Avoid SCSI bus reset Y N -.Pp +.Bl -column "SCSI parity checking" "Symbios" +.It Em "Host settings Symbios Tekram" +.It "SCSI parity checking Y N" +.It "Host SCSI ident Y Y" +.It "Verbose messages Y N" +.It "Scan targets hi-lo Y N" +.It "Avoid SCSI bus reset Y N" .El -.Bl -column "Synchronous period " "Symbios " "Tekram" -.Em Device settings Symbios Tekram -Synchronous period Y Y -SCSI bus width Y Y -Queue tag enable Y Y -Number of tags NA Y -Disconnect enable Y Y -Scan at boot time Y N -Scan LUN Y N +.Bl -column "Synchronous period" "Symbios" +.It Em "Device settings Symbios Tekram" +.It "Synchronous period Y Y" +.It "SCSI bus width Y Y" +.It "Queue tag enable Y Y" +.It "Number of tags NA Y" +.It "Disconnect enable Y Y" +.It "Scan at boot time Y N" +.It "Scan LUN Y N" .El .Pp Devices that are configured as disabled for 'scan' in the NVRAM are not @@ -258,23 +257,23 @@ command. The table below summarizes the main features and capabilities of the NCR/Symbios/LSI Logic 53C8XX family of PCI SCSI controllers. .Pp -.Bl -column sym53c1510d "Sync " "Width " "SRAM " "PCI64" -.Em Chip Sync Width SRAM PCI64 Supported -sym53c810 10MHz 8Bit N N Y -sym53c810a 10MHz 8Bit N N Y -sym53c815 10MHz 8Bit N N Y -sym53c825 10MHz 16Bit N N Y -sym53c825a 10MHz 16Bit 4KB N Y -sym53c860 20MHz 8Bit N N Y -sym53c875 20MHz 16Bit 4KB N Y -sym53c876 20MHz 16Bit 4KB N Y -sym53c885 20MHz 16Bit 4KB N Y -sym53c895 40MHz 16Bit 4KB N Y -sym53c895A 40MHz 16Bit 8KB N Y -sym53c896 40MHz 16Bit 8KB Y Y -sym53c897 40MHz 16Bit 8KB Y Y -sym53c1510D 40MHz 16Bit 4KB Y Y -sym53c1010 80MHz 16Bit 8KB Y Y +.Bl -column sym53c1510d "80MHz" "Width" "SRAM" "PCI64" +.It Em "Chip Sync Width SRAM PCI64 Supported" +.It "sym53c810 10MHz 8Bit N N Y" +.It "sym53c810a 10MHz 8Bit N N Y" +.It "sym53c815 10MHz 8Bit N N Y" +.It "sym53c825 10MHz 16Bit N N Y" +.It "sym53c825a 10MHz 16Bit 4KB N Y" +.It "sym53c860 20MHz 8Bit N N Y" +.It "sym53c875 20MHz 16Bit 4KB N Y" +.It "sym53c876 20MHz 16Bit 4KB N Y" +.It "sym53c885 20MHz 16Bit 4KB N Y" +.It "sym53c895 40MHz 16Bit 4KB N Y" +.It "sym53c895A 40MHz 16Bit 8KB N Y" +.It "sym53c896 40MHz 16Bit 8KB Y Y" +.It "sym53c897 40MHz 16Bit 8KB Y Y" +.It "sym53c1510D 40MHz 16Bit 4KB Y Y" +.It "sym53c1010 80MHz 16Bit 8KB Y Y" .El .Pp .Sh BUGS diff --git a/share/man/man4/tap.4 b/share/man/man4/tap.4 index cbd4b75..bac035a 100644 --- a/share/man/man4/tap.4 +++ b/share/man/man4/tap.4 @@ -27,12 +27,10 @@ driver, like the .Nm pty driver, provides two interfaces: an interface like the usual facility it is simulating -.Po -an Ethernet network interface in the case of +(an Ethernet network interface in the case of .Nm , or a terminal for -.Nm pty -.Pc , +.Nm pty ) , and a character-special device .Dq control interface. diff --git a/share/man/man4/twe.4 b/share/man/man4/twe.4 index 6e93230..92a45ae 100644 --- a/share/man/man4/twe.4 +++ b/share/man/man4/twe.4 @@ -63,6 +63,7 @@ This process is retried several times. Several attempts to reset and initialise the controller have failed; initialisation has failed and the driver will not attach to this controller. +.El .Ss Driver initialisation/shutdown phase .Bl -diag .It twe%d: register window not available @@ -88,6 +89,7 @@ Fetching the list of attached units failed; initialisation has failed. Creation of the disk devices failed, either due to communications problems with the adapter or due to resource shortage; attachment of one or more units may have been aborted. +.El .Ss Operational phase .Bl -diag .It twe%d: command completed - %s @@ -189,6 +191,7 @@ No further I/O will be handled. .Pp The controller was successfully reset, and outstanding commands were restarted. +.El .Sh BUGS The controller cannot handle I/O transfers that are not aligned to a 512-byte boundary. diff --git a/share/man/man4/uhci.4 b/share/man/man4/uhci.4 index 9c1dd69..e44bd65 100644 --- a/share/man/man4/uhci.4 +++ b/share/man/man4/uhci.4 @@ -51,7 +51,7 @@ includes .It Intel 82371SB (PIIX3) .It VIA 83C572 .El - +.Pp or any other UHCI v1.1 compliant controller. .Sh SEE ALSO .Xr ohci 4 diff --git a/share/man/man4/ukbd.4 b/share/man/man4/ukbd.4 index 2448b25..0e53a9e 100644 --- a/share/man/man4/ukbd.4 +++ b/share/man/man4/ukbd.4 @@ -136,6 +136,7 @@ also has effect on the AT keyboard driver `atkbd'. .Bl -tag -width /dev/kbd0 -compact .It Pa /dev/kbd* blocking device nodes +.El .Sh EXAMPLES .Bd -literal -offset indent device ukbd diff --git a/share/man/man4/ums.4 b/share/man/man4/ums.4 index d3b2042..d091fc7 100644 --- a/share/man/man4/ums.4 +++ b/share/man/man4/ums.4 @@ -63,6 +63,7 @@ for an explanation of these mouse types. .Bl -tag -width /dev/ums0 -compact .It Pa /dev/ums0 blocking device node +.El .Sh EXAMPLES .Dl device ums .Pp diff --git a/share/man/man4/urio.4 b/share/man/man4/urio.4 index 6234f87..3655895 100644 --- a/share/man/man4/urio.4 +++ b/share/man/man4/urio.4 @@ -60,6 +60,7 @@ device can be used by the Rio500 userland applications. .Bl -tag -width /dev/ums0 -compact .It Pa /dev/urio0 blocking device node +.El .Sh EXAMPLES The following line in the kernel configuration file adds the .Nm diff --git a/share/man/man4/vpo.4 b/share/man/man4/vpo.4 index 070d332..1b669b9 100644 --- a/share/man/man4/vpo.4 +++ b/share/man/man4/vpo.4 @@ -61,13 +61,14 @@ filesystem, check the slice of the disk with the utility. .Pp In order to unixify a ZIP disk, put the following in /etc/disktab: - +.Bd -literal zip|zip 100:\\ :ty=removable:se#512:nc#96:nt#64:ns#32:\\ :pa#196608:oa#0:ba#4096:fa#512:\\ :pb#196608:ob#0:bb#4096:fb#512:\\ :pc#196608:oc#0:bc#4096:fc#512: - +.Ed +.Pp and use .Xr disklabel 8 . .Pp diff --git a/share/man/man4/xpt.4 b/share/man/man4/xpt.4 index 4d400ec..39e3aa1 100644 --- a/share/man/man4/xpt.4 +++ b/share/man/man4/xpt.4 @@ -83,7 +83,7 @@ This ioctl takes an XPT_GDEVLIST CCB, and returns the passthrough device corresponding to the device in question. .El .Sh FILES -.Bl -tag -width 01234567890 -compact +.Bl -tag -width /dev/xpt0 -compact .It Pa /dev/xpt0 Character device node for the .Nm diff --git a/share/man/man5/dir.5 b/share/man/man5/dir.5 index ab81b22..5b1a6d3 100644 --- a/share/man/man5/dir.5 +++ b/share/man/man5/dir.5 @@ -62,7 +62,7 @@ and is called a file system (or referred to as a file system tree). Each directory file contains two special directory entries; one is a pointer to the directory itself called dot -.Ql \&. +.Ql .\& and the other a pointer to its parent directory called dot-dot .Ql \&.. . Dot and dot-dot diff --git a/share/man/man5/disktab.5 b/share/man/man5/disktab.5 index 1be240c..e1cd888 100644 --- a/share/man/man5/disktab.5 +++ b/share/man/man5/disktab.5 @@ -63,7 +63,7 @@ the disk. The following list indicates the normal values stored for each disk entry. .Bl -column "indent" "boolx" -.It Sy Name Type Description +.It Sy "Name Type Description" .It "\&ty str Type of disk (e.g. removable, winchester)" .It "\&dt str Type of controller (e.g." .Tn SMD , ESDI , diff --git a/share/man/man5/forward.5 b/share/man/man5/forward.5 index 1088eba..bb3dad6 100644 --- a/share/man/man5/forward.5 +++ b/share/man/man5/forward.5 @@ -83,11 +83,9 @@ chris@otherhost One copy of mail would be forwarded to .Ar chris@otherhost and another copy would be retained as mail for local user chris. - .Sh FILES .Bl -tag -width $HOME/.forward -compact .It Pa $HOME/.forward - The user's forwarding instructions. .El .Sh SEE ALSO diff --git a/share/man/man5/fstab.5 b/share/man/man5/fstab.5 index 6c0119e..40bd501 100644 --- a/share/man/man5/fstab.5 +++ b/share/man/man5/fstab.5 @@ -89,7 +89,6 @@ everything else will be automatically loaded at mount time. (Exception: the UFS family - FFS, MFS, and LFS cannot currently be demand-loaded.) Some people still prefer to statically compile other filesystems as well. - .Bl -tag -width indent -offset indent .It Em ufs a local diff --git a/share/man/man5/hosts.equiv.5 b/share/man/man5/hosts.equiv.5 index 5a84d8a..8e9c0f7 100644 --- a/share/man/man5/hosts.equiv.5 +++ b/share/man/man5/hosts.equiv.5 @@ -47,12 +47,12 @@ files contain information regarding trusted hosts and users on the network. For each host a single line should be present with the following information: - +.Pp simple .Bd -unfilled -offset indent hostname [username] .Ed - +.Pp or the more verbose .Bd -unfilled -offset indent [+-][hostname|@netgroup] [[+-][username|@netgroup]] @@ -79,7 +79,7 @@ a comment; characters up to the end of the line are not interpreted by routines which search the file. .Pp Host names are specified in the conventional -.Dq \&. +.Dq .\& (dot) notation using the .Xr inet_addr 3 routine diff --git a/share/man/man5/hosts.lpd.5 b/share/man/man5/hosts.lpd.5 index e5041fa..03fbe5c 100644 --- a/share/man/man5/hosts.lpd.5 +++ b/share/man/man5/hosts.lpd.5 @@ -50,6 +50,7 @@ The .Nm file resides in .Pa /etc . +.El .Sh SEE ALSO .Xr printcap 5 , .Xr lpd 8 diff --git a/share/man/man5/link.5 b/share/man/man5/link.5 index aa4f4e3..2106230 100644 --- a/share/man/man5/link.5 +++ b/share/man/man5/link.5 @@ -476,7 +476,7 @@ struct ld_entry { char *(*dlerror)(void); }; .Ed - +.Pp The .Fa crt_ldso structure defines the interface between the start-up code in crt0 and diff --git a/share/man/man5/make.conf.5 b/share/man/man5/make.conf.5 index 0860da4..6b3971d 100644 --- a/share/man/man5/make.conf.5 +++ b/share/man/man5/make.conf.5 @@ -87,7 +87,7 @@ makefiles for things other than builds. .It Ar CFLAGS (str) Controls the compiler setting when compiling C code. Optimization levels above -.Op -O ( -O2 , ...) +.Op -O ( -O2 , ...\& ) are not supported. BDECFLAGS is provided as a set of gcc settings suggested by Bruce Evans for developing and testing changes. They can be used by: @@ -184,9 +184,8 @@ set to 0. .It Ar COPTFLAGS (str) Controls the compiler settings when building the kernel. Optimization levels above -.Op -O -.Op -O2 , -...) are not supported. +.Op -O ( -O2 , ...\& ) +are not supported. .It Ar NO_KERNELCONFIG (bool) Set this to skip running .Xr config 8 @@ -475,6 +474,7 @@ need to can attemp to comply with U.S. export regulations. .It Ar X11BASE (str) Should be set to where the X11 distribution has been installed if it is installed anywhere other than /usr/X11R6. +.El .Sh FILES .Bl -tag -width /etc/defaults/make.conf -compact .It Pa /etc/defaults/make.conf @@ -484,6 +484,7 @@ installed if it is installed anywhere other than /usr/X11R6. .It Pa /usr/src/Makefile.inc1 .It Pa /usr/ports/Mk/bsd.port.mk .It Pa /usr/ports/Mk/bsd.sites.mk +.El .Sh SEE ALSO .Xr gcc 1 , .Xr install 1 , @@ -502,7 +503,7 @@ file appeared sometime before .Sh BUGS This manual page may occasionally be out of date with respect to the options currently available for use in -.Nm make.conf . +.Nm . Please check the .Pa /etc/defaults/make.conf file for the latest options which are available. diff --git a/share/man/man5/nsswitch.conf.5 b/share/man/man5/nsswitch.conf.5 index 7734707..1e7deff 100644 --- a/share/man/man5/nsswitch.conf.5 +++ b/share/man/man5/nsswitch.conf.5 @@ -63,12 +63,12 @@ take if that status code occurs. .Ss Sources The following sources are implemented: .Bl -column "compat" -offset indent -compact -.Sy Source Description -.It files Local files, such as +.It Sy "Source Description +.It "files Local files, such as" .Pa /etc/hosts , and .Pa /etc/passwd . -.It dns Internet Domain Name System. +.It "dns Internet Domain Name System." .Dq hosts and .Sq networks @@ -77,8 +77,8 @@ use class entries, all other databases use .Sy HS class (Hesiod) entries. -.It nis NIS (formerly YP) -.It compat support +.It "nis NIS (formerly YP)" +.It "compat support" .Sq +/- in the .Dq passwd @@ -90,33 +90,33 @@ If this is present, it must be the only source for that entry. .Ss Databases The following databases are used by the following C library functions: .Bl -column "networks" -offset indent -compact -.Sy Database Used by -.It group +.It Sy "Database Used by" +.It "group " .Xr getgrent 3 -.It hosts +.It "hosts " .Xr gethostbyname 3 -.It networks +.It "networks " .Xr getnetbyname 3 -.It passwd +.It "passwd " .Xr getpwent 3 -.It shells +.It "shells " .Xr getusershell 3 .El .Ss Status codes The following status codes are available: .Bl -column "tryagain" -offset indent -compact -.Sy Status Description -.It success The requested entry was found. -.It notfound The entry is not present at this source. -.It tryagain The source is busy, and may respond to retries. -.It unavail The source is not responding, or entry is corrupt. +.It Sy "Status Description" +.It "success The requested entry was found." +.It "notfound The entry is not present at this source." +.It "tryagain The source is busy, and may respond to retries." +.It "unavail The source is not responding, or entry is corrupt." .El .Ss Actions For each of the status codes, one of two actions is possible: .Bl -column "continue" -offset indent -compact -.Sy Action Description -.It continue Try the next source -.It return Return with the current result +.It Sy "Action Description" +.It "continue Try the next source" +.It "return Return with the current result" .El .Ss Format of file A @@ -125,15 +125,15 @@ description of the syntax of .Nm is: .Bl -column "" -offset indent -.It ::= +.It " ::=" ":" [ []]* -.It ::= +.It " ::=" "[" + "]" -.It ::= +.It " ::=" "=" -.It ::= +.It " ::=" "success" | "notfound" | "unavail" | "tryagain" -.It ::= +.It " ::=" "return" | "continue" .El .Pp @@ -207,12 +207,12 @@ will default to an entry of for the requested database. Exceptions are: .Bl -column passwd_compat "dns files" -offset indent -.Sy Database Default source list -.It group compat -.It group_compat nis -.It hosts dns files -.It passwd compat -.It passwd_compat nis +.It Sy "Database Default source list" +.It "group compat" +.It "group_compat nis" +.It "hosts dns files" +.It "passwd compat" +.It "passwd_compat nis" .El .Sh FILES .Bl -tag -width /etc/nsswitch.conf -compact @@ -229,9 +229,9 @@ and then from the DNS, and lookup user information from .Tn NIS then files, use: .Bl -column "passwd:" -offset indent -.It hosts: files dns -.It passwd: nis [notfound=return] files -.It group: nis [notfound=return] files +.It "hosts: files dns" +.It "passwd: nis [notfound=return] files" +.It "group: nis [notfound=return] files" .El .Pp The criteria diff --git a/share/man/man5/periodic.conf.5 b/share/man/man5/periodic.conf.5 index 0c9fafe..e48d2e3 100644 --- a/share/man/man5/periodic.conf.5 +++ b/share/man/man5/periodic.conf.5 @@ -126,7 +126,6 @@ Refer to the .Xr periodic 8 man page for how script return codes are interpreted. .El -.B Daily variables .Pp The following variables are used by the standard scripts that reside in .Pa /etc/periodic/daily : diff --git a/share/man/man5/rc.conf.5 b/share/man/man5/rc.conf.5 index 05f4cc8..ffa014d 100644 --- a/share/man/man5/rc.conf.5 +++ b/share/man/man5/rc.conf.5 @@ -1446,6 +1446,7 @@ daemon. (bool) If set to .Ar NO then unaligned access warnings will not be printed. (alpha) +.El .Sh FILES .Bl -tag -width /etc/defaults/rc.conf -compact .It Pa /etc/defaults/rc.conf diff --git a/share/man/man5/sysctl.conf.5 b/share/man/man5/sysctl.conf.5 index 537713c..bcbc9f6 100644 --- a/share/man/man5/sysctl.conf.5 +++ b/share/man/man5/sysctl.conf.5 @@ -54,6 +54,7 @@ section, below. .It Pa /etc/sysctl.conf Initial settings for .Xr sysctl 8 . +.El .Sh EXAMPLES To turn off logging of programs that exit due to fatal signals, as well as telling Linux programs that you are running diff --git a/share/man/man7/build.7 b/share/man/man7/build.7 index 4de5f2b..753ae85 100644 --- a/share/man/man7/build.7 +++ b/share/man/man7/build.7 @@ -117,6 +117,7 @@ For more information about the ports build process, see .It Pa /usr/src/Makefile.inc1 .It Pa /usr/ports/Mk/bsd.port.mk .It Pa /usr/ports/Mk/bsd.sites.mk +.El .Sh EXAMPLES The .Dq approved diff --git a/share/man/man7/operator.7 b/share/man/man7/operator.7 index 1f4d9b8..2f67448 100644 --- a/share/man/man7/operator.7 +++ b/share/man/man7/operator.7 @@ -40,24 +40,24 @@ .Nd C operator precedence and order of evaluation .Sh DESCRIPTION .Bd -ragged -offset indent -compact -.Bl -column "Operator Associativity " -.It Operator Associativity -.It -------- ------------- -.It \&() [] -> . left to right -.It "! ~ ++ -- - (type) * & sizeof" right to left -.It \&* / % left to right -.It \&+ - left to right -.It \&<< >> left to right -.It \&< <= > >= left to right -.It \&== != left to right -.It \&& left to right -.It \&^ left to right -.It \&| left to right -.It \&&& left to right -.It \&|| left to right -.It \&?: right to left -.It \&= += -= etc. right to left -.It \&, left to right +.Bl -column "! ~ ++ -- - (type) * & sizeof" +.It Sy "Operator Associativity" +.It "-------- -------------" +.It "\&() [] -> . left to right" +.It "! ~ ++ -- - (type) * & sizeof right to left" +.It "\&* / % left to right" +.It "\&+ - left to right" +.It "\&<< >> left to right" +.It "\&< <= > >= left to right" +.It "\&== != left to right" +.It "\&& left to right" +.It "\&^ left to right" +.It "\&| left to right" +.It "\&&& left to right" +.It "\&|| left to right" +.It "\&?: right to left" +.It "\&= += -= etc. right to left" +.It "\&, left to right" .El .Ed .Sh FILES diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7 index 4794c3e..2589b8f 100644 --- a/share/man/man7/ports.7 +++ b/share/man/man7/ports.7 @@ -186,6 +186,7 @@ Create a port's This can be used from .Pa /usr/ports to create a browsable web of all ports on your system! +.El .Sh ENVIRONMENT You can change all of these. .Bl -tag -width MASTER_SITES @@ -273,6 +274,7 @@ and The default ports directory (NetBSD). .It Pa /usr/ports/Mk/bsd.port.mk The big Kahuna. +.El .Sh SEE ALSO .Xr make 1 , .Xr pkg_add 1 , diff --git a/share/man/man7/security.7 b/share/man/man7/security.7 index 99f222a..b45f44c 100644 --- a/share/man/man7/security.7 +++ b/share/man/man7/security.7 @@ -671,7 +671,6 @@ option that ssh allows in its .Pa authorized_keys file to make the key only useable to entities logging in from specific machines. - .Sh SEE ALSO .Pp .Xr chflags 1 , @@ -690,7 +689,6 @@ machines. .Xr sysctl 8 , .Xr syslogd 8 , .Xr vipw 8 - .Sh HISTORY The .Nm diff --git a/share/man/man7/style.perl.7 b/share/man/man7/style.perl.7 index 51b71df..5b5ec5b 100644 --- a/share/man/man7/style.perl.7 +++ b/share/man/man7/style.perl.7 @@ -32,7 +32,7 @@ .Nd "FreeBSD Perl source file style guide" .Sh DESCRIPTION This file specifies the preferred style for perl scripts in the -.Tn FreeBSD +.Fx source tree. .Bd -literal -offset 0i # @@ -221,13 +221,12 @@ where appropriate. Use .Fa unless instead of -.Fa if (! ... ) +.Fa if (! ...\& ) where it improves readability. .Pp Where it doesn't conflict with this guide read .Xr perlstyle 1 and adopt Larry Wall's style recommendations. - .Sh SEE ALSO .Xr perlsec 1 , .Xr perlstyle 1 , @@ -236,4 +235,4 @@ and adopt Larry Wall's style recommendations. This man page is largely based on the .Xr style 9 man-page in -.Tn FreeBSD . +.Fx . diff --git a/share/man/man8/adding_user.8 b/share/man/man8/adding_user.8 index eed945b..cdae3e3 100644 --- a/share/man/man8/adding_user.8 +++ b/share/man/man8/adding_user.8 @@ -48,7 +48,7 @@ It must also not begin with the hyphen character. It is strongly recommended that it be all lower-case, and not contain the dot -.Ql \&. +.Ql .\& character, as that tends to confuse mailers. An account can be added by editing a line into the passwd file; this must be done with the password file locked e.g. by using @@ -64,7 +64,7 @@ At the University of California, Berkeley, we have groups for system staff, faculty, graduate students, and special groups for large projects. .Pp A skeletal account for a new user -\*(lqernie\*(rq +.Dq ernie might look like: .Bd -literal ernie::25:30::0:0:Ernie Kovacs,508 Evans Hall,x7925, diff --git a/share/man/man8/crash.8 b/share/man/man8/crash.8 index 30666a1..c732d64 100644 --- a/share/man/man8/crash.8 +++ b/share/man/man8/crash.8 @@ -178,6 +178,7 @@ If this happens, make the timeout table bigger. The system initialization process has exited with the specified signal number and exit code. This is bad news, as no new users will then be able to log in. Rebooting is the only fix, so the system just does it right away. +.El .Pp That completes the list of panic types you are likely to see. .Pp @@ -203,7 +204,8 @@ the panic message is printed. For more details consult the chapter on kernel debugging in the .Fx -handbook (http://www.FreeBSD.org). +handbook +.Pq Pa http://www.FreeBSD.org . .Sh SEE ALSO .Xr gdb 1 , .Xr dumpon 8 , diff --git a/share/man/man8/diskless.8 b/share/man/man8/diskless.8 index 9fa28c9..e1fedcb 100644 --- a/share/man/man8/diskless.8 +++ b/share/man/man8/diskless.8 @@ -48,12 +48,12 @@ configuring a server for diskless Sun clients. When booting a system over the network, there are three phases of interaction between client and server: .Pp -.Bl -tag -width 1.2 -compact -.It 1. +.Bl -enum -compact +.It The PROM (or stage-1 bootstrap) loads a boot program. -.It 2. +.It The boot program loads a kernel. -.It 3. +.It The kernel does NFS mounts for root. .El .Pp @@ -81,7 +81,7 @@ this phase depends on the design of the boot program. (The design described here is the one used by Sun and NetBSD/hp300.) The boot program: .Pp -.Bl -tag -width 2.2 -compact +.Bl -tag -width \&2.2 -compact .It 2.1 gets the client IP address using .Tn RARP . @@ -118,7 +118,7 @@ because there is no standard way for the boot program to pass the information it gathered on to the kernel. The procedure used by the kernel is as follows: .Pp -.Bl -tag -width 2.2 -compact +.Bl -tag -width \&2.2 -compact .It 3.1 The kernel finds a boot server using the same procedure as described in steps 2.1 and 2.2 above. @@ -142,8 +142,8 @@ might be configured -- other clients should be similar. Assuming the client's hostname is to be "myclient", .Pp -.Bl -tag -width 2.1 -compact -.It 1. +.Bl -enum +.It Add an entry to .Pa /etc/ethers corresponding to the client's ethernet address: @@ -152,16 +152,14 @@ corresponding to the client's ethernet address: .Ed This will be used by .Xr rarpd 8 . -.Pp -.It 2. +.It Assign an IP address for myclient in your .Pa /etc/hosts or DNS database: .Bd -literal -offset indent -compact 192.197.96.12 myclient .Ed -.Pp -.It 3. +.It If booting a Sun machine, ensure that .Pa /etc/inetd.conf is configured to run @@ -180,8 +178,7 @@ An entry might look like this: See the .Xr rbootd 8 manual page for more information. -.Pp -.It 4. +.It If booting a SPARC machine, install a copy of the appropriate diskless boot loader (such as .Pa /usr/mdec/boot ) @@ -212,8 +209,7 @@ If booting an HP 300-series machine, ensure that the network boot program before installation) is installed in the directory .Pa /usr/mdec/rbootd . - -.It 5. +.It Add myclient to the bootparams database .Pa /etc/bootparams : .Bd -literal -offset indent -compact @@ -224,8 +220,7 @@ Note: For the swap file to be mountable, you have to make sure that mountd is started with the .Fl r flag. - -.It 6. +.It Build the swap file for myclient: .Bd -literal -offset indent -compact # mkdir /export/myclient @@ -233,8 +228,7 @@ Build the swap file for myclient: # dd if=/dev/zero of=swap bs=16k count=1024 .Ed This creates a 16 Megabyte swap file. -.Pp -.It 7. +.It Populate myclient's .Pa / filesystem on the server. How this is done depends on the @@ -248,8 +242,7 @@ client's swap: .Bd -literal -offset indent -compact # mkdir /export/myclient/root/swap .Ed -.Pp -.It 8. +.It Export the required filesystems in .Pa /etc/exports : .Bd -literal -offset indent -compact @@ -278,8 +271,7 @@ lines: /export/usr.sun3 -ro myclient /export/myclient -rw=myclient,root=myclient .Ed -.Pp -.It 9. +.It Copy and customize at least the following files in .Pa /export/myclient/root : .Bd -literal -offset indent -compact @@ -292,8 +284,7 @@ Copy and customize at least the following files in .Pp Note that "le0" above should be replaced with the name of the network interface that the client will use for booting. -.Pp -.It 10. +.It Correct the critical mount points and the swap file in the client's .Pa /etc/fstab (which will be diff --git a/share/man/man8/man8.alpha/MAKEDEV.8 b/share/man/man8/man8.alpha/MAKEDEV.8 index 6e3592e..bbeee28 100644 --- a/share/man/man8/man8.alpha/MAKEDEV.8 +++ b/share/man/man8/man8.alpha/MAKEDEV.8 @@ -99,6 +99,7 @@ QIC-interfaced (e.g. not SCSI) 3M cartridge tape .Bl -tag -width /dev/xxxx -compact .It Pa /dev The special file directory. +.El .Sh SEE ALSO .Xr intro 4 , .Xr config 8 , diff --git a/share/man/man8/man8.i386/MAKEDEV.8 b/share/man/man8/man8.i386/MAKEDEV.8 index 0876c63..a27b857 100644 --- a/share/man/man8/man8.i386/MAKEDEV.8 +++ b/share/man/man8/man8.i386/MAKEDEV.8 @@ -97,6 +97,7 @@ QIC-interfaced (e.g. not SCSI) 3M cartridge tape .Bl -tag -width /dev/xxxx -compact .It Pa /dev The special file directory. +.El .Sh SEE ALSO .Xr intro 4 , .Xr config 8 , diff --git a/share/man/man9/DEVICE_PROBE.9 b/share/man/man9/DEVICE_PROBE.9 index c621a57..1522175 100644 --- a/share/man/man9/DEVICE_PROBE.9 +++ b/share/man/man9/DEVICE_PROBE.9 @@ -76,7 +76,6 @@ zero indicates an error (errno). For values equal to or less than zero: zero indicates highest priority, no further probing is done; for a value less then zero, the lower the value the lower the priority, e.g. -100 indicates a lower priority than -50. - .Sh SEE ALSO .Xr device 9 , .Xr DEVICE_ATTACH 9 diff --git a/share/man/man9/MD5.9 b/share/man/man9/MD5.9 index 37a5ded..58a221d 100644 --- a/share/man/man9/MD5.9 +++ b/share/man/man9/MD5.9 @@ -70,6 +70,7 @@ to reflect the addition of 64 characters of new data passed in .Fa block argument. +.El .Sh COPYRIGHTS The code for MD5 transform was taken from Colin Plumb's implementation, which has been placed in the public domain. The diff --git a/share/man/man9/VOP_LINK.9 b/share/man/man9/VOP_LINK.9 index 463dc80..dcf02bf 100644 --- a/share/man/man9/VOP_LINK.9 +++ b/share/man/man9/VOP_LINK.9 @@ -43,7 +43,7 @@ This links a new name in the specified directory to an existing file. .Pp Its arguments are: -.Bl -tag -width 8X +.Bl -tag -width 8n .It Ar dvp the vnode of the directory .It Ar vp diff --git a/share/man/man9/accf_http.9 b/share/man/man9/accf_http.9 index c33301e..4c20f02 100644 --- a/share/man/man9/accf_http.9 +++ b/share/man/man9/accf_http.9 @@ -30,7 +30,7 @@ .Dt accf_http 9 .Sh NAME .Nm accf_http -.Nd buffer incoming connections until a certain complete HTTP requests arrive +.Nd "buffer incoming connections until a certain complete HTTP requests arrive" .Sh SYNOPSIS .Nm options INET .Nm options ACCEPT_FILTER_HTTP diff --git a/share/man/man9/acl.9 b/share/man/man9/acl.9 index 902d569..6fa9a55 100644 --- a/share/man/man9/acl.9 +++ b/share/man/man9/acl.9 @@ -99,7 +99,7 @@ field of the appropriate vnode ACL calls, .Xr VOP_GETACL 9 , and .Xr VOP_SETACL 9 . - +.Pp Currently, each ACL is represented in-kernel by a fixed-size acl structure. An ACL is constructed from a fixed size array of ACL entries, each of which consists of a set of permissions, principal namespace, and principal diff --git a/share/man/man9/bios.9 b/share/man/man9/bios.9 index 8b2d3db..9929d14 100644 --- a/share/man/man9/bios.9 +++ b/share/man/man9/bios.9 @@ -112,4 +112,3 @@ If not NULL, points to a structure describing the PCI BIOS entrypoint which was found during system startup. .El - diff --git a/share/man/man9/buf.9 b/share/man/man9/buf.9 index 7ac458d..42bdef3 100644 --- a/share/man/man9/buf.9 +++ b/share/man/man9/buf.9 @@ -125,4 +125,3 @@ manual page was originally written by and first appeared in .Fx 3.1 , December 1998. - diff --git a/share/man/man9/devfs_add_devswf.9 b/share/man/man9/devfs_add_devswf.9 index be67340..ecaa844 100644 --- a/share/man/man9/devfs_add_devswf.9 +++ b/share/man/man9/devfs_add_devswf.9 @@ -43,7 +43,7 @@ The call that adds an entry into devfs is .Nm . .Pp Its arguments are: -.Bl -tag -width 8X +.Bl -tag -width 8n .It Ar devsw the address of the devsw entry the name should access .It Ar minor diff --git a/share/man/man9/device_quiet.9 b/share/man/man9/device_quiet.9 index 9a9baf9..5dfa5d5 100644 --- a/share/man/man9/device_quiet.9 +++ b/share/man/man9/device_quiet.9 @@ -51,13 +51,13 @@ Each device has a quiet flag associated with it. A device is verbose by default when it is created but may be quieted to prevent the device identification string to be printed during probe. To quiet a device, call -.Xr device_quiet 9 -, to reenable to probe message (to make the message appear again, for +.Xr device_quiet 9 , +to reenable to probe message (to make the message appear again, for example after a -.Xr device_detach 9 -) call -.Xr device_verbose 9 -. To test to see if a device is quieted, call +.Xr device_detach 9 ) +call +.Xr device_verbose 9 . +To test to see if a device is quieted, call .Xr device_is_quiet 9 . .Sh SEE ALSO .Xr device 9 diff --git a/share/man/man9/extattr.9 b/share/man/man9/extattr.9 index 9a0eb4e..894f791 100644 --- a/share/man/man9/extattr.9 +++ b/share/man/man9/extattr.9 @@ -51,7 +51,7 @@ semantics of the supporting file system. Authorization schemes for extended attribute data may also vary by file system, as well as maximum attribute size, and whether or not any or specific new attributes may be defined. - +.Pp Extended attributes are named using a null-terminated character string. Depending on file system semantics, this name may or may not be case-sensitive. Appropriate vnode extended attribute calls are: diff --git a/share/man/man9/ifnet.9 b/share/man/man9/ifnet.9 index b9e7518..1555538 100644 --- a/share/man/man9/ifnet.9 +++ b/share/man/man9/ifnet.9 @@ -858,6 +858,7 @@ structures are converted into old-style (no .Li sa_len member). .El +.El .Pp .Fn if_down , .Fn ifioctl , diff --git a/share/man/man9/intro.9 b/share/man/man9/intro.9 index 33be8ad..912a7d0 100644 --- a/share/man/man9/intro.9 +++ b/share/man/man9/intro.9 @@ -78,7 +78,7 @@ in #endif /* DDB */ .Ed - +.Pp And the name of the procedure should start with the prefix .Li DDB_ to clearly identify the procedure as a debugger routine. diff --git a/share/man/man9/kthread.9 b/share/man/man9/kthread.9 index e894c3a..efdeee0 100644 --- a/share/man/man9/kthread.9 +++ b/share/man/man9/kthread.9 @@ -256,6 +256,7 @@ The flag was specified in the .Fa flags parameter. +.El .Sh SEE ALSO .Xr SYSINIT 9 , .Xr rfork 2 diff --git a/share/man/man9/malloc.9 b/share/man/man9/malloc.9 index 2c93e63..0b47142 100644 --- a/share/man/man9/malloc.9 +++ b/share/man/man9/malloc.9 @@ -171,7 +171,7 @@ MALLOC_DEFINE(M_FOOBUF, "foobuffers", "Buffers to foo data into the ether"); /* sys/something/foo_subr.c */ -... +\&... MALLOC(buf, struct foo_buf *, sizeof *buf, M_FOOBUF, M_NOWAIT); .Ed diff --git a/share/man/man9/mbuf.9 b/share/man/man9/mbuf.9 index ea795c6..2374ee1 100644 --- a/share/man/man9/mbuf.9 +++ b/share/man/man9/mbuf.9 @@ -473,6 +473,7 @@ bytes. In case of failure, it returns .Dv NULL and attempts to restore the chain to its original state. +.El .Sh RETURN VALUES See above. .Sh HISTORY diff --git a/share/man/man9/microseq.9 b/share/man/man9/microseq.9 index 0a7f93e..dce4b2e 100644 --- a/share/man/man9/microseq.9 +++ b/share/man/man9/microseq.9 @@ -133,7 +133,7 @@ Available microinstructions are: The .Em execution context of microinstructions is: -.Bl -bullet -item -offset indent +.Bl -bullet -offset indent .It the .Em program counter @@ -172,7 +172,7 @@ is used to assert/clear some bits of a particular parallel port register, two masks are applied. .Pp Parameters: -.Bl -enum -offset ident +.Bl -enum -offset indent .It register .It @@ -214,7 +214,7 @@ integer value .El .Pp Predefined macro: MS_SET(accum) -.Ss MS_OP_DBRA - Do BRAnch +.Ss MS_OP_DBRA - \&Do BRAnch is used to branch if internal branch register decremented by one result value is positive. .Pp diff --git a/share/man/man9/namei.9 b/share/man/man9/namei.9 index 5063ee1..8fc5954 100644 --- a/share/man/man9/namei.9 +++ b/share/man/man9/namei.9 @@ -47,9 +47,7 @@ .Ft void .Fn NDINIT "struct nameidata *ndp" "int operation" "int operflags" "int segflag" "const char *path" "struct proc *proc" .Fn NDFREE "struct nameidata *ndp" "int operflags" - .Sh DESCRIPTION - .Fn namei is used to get from a pathname to a vnode for the object. This is a necessity to start doing VFS operations. The vnode @@ -160,16 +158,15 @@ In the normal case, this is either the current directory or the root. It is the current directory if the name passed in doesn't start with / and we have not gone through any symlinks with an absolute path, and the root otherwise. - +.Pp In this case, it is is only used by lookup(), and should not be considered valid after a call to namei(). - +.Pp If SAVESTART is set, this is set to the same as ni_dvp, with an extra VREF(). - +.Pp To block NDFREE from releasing ni_startdir when it is set, use the flag NDF_NO_STARTDIR_RELE. - .It Dv ni_dvp The directory vp for the directory the object we're looking up is in. This is available on successful return if LOCKPARENT or WANTPARENT is @@ -180,19 +177,19 @@ be inhibited by NDF_NO_DVP_RELE, NDF_NO_DVP_PUT, or NDF_NO_DVP_UNLOCK The vp for the target of the of the pathname exists, NULL otherwise. The vp is returned with increased reference count (VREF'ed). If LOCKLEAF is set, it is also locked. - +.Pp Freeing this in NDFREE can be inhibited by NDF_NO_VP_RELE, NDF_NO_VP_PUT, or NDF_NO_VP_UNLOCK (with the obvious effects). - .It Dv ni_cnd.cn_pnbuf Path name buffer. This is allocated through zalloc(namei_zone) and freed through zfree(namei_zone, ...). - +.Pp This is available to the caller (who must free it using .Xr NDFREE 9 ) if SAVESTART or SAVENAME is set. To free only the ni_cnd.cn_pnbuf, there is a special flags NDF_ONLY_PNBUF. To not free the cnd, use the flag ND_NO_FREE_PNBUF. +.El .Sh BUGS LOCKPARENT does not always result in parent vp being locked (see details in description). diff --git a/share/man/man9/rtalloc.9 b/share/man/man9/rtalloc.9 index 785d01c..eaca160 100644 --- a/share/man/man9/rtalloc.9 +++ b/share/man/man9/rtalloc.9 @@ -53,7 +53,7 @@ family of routines is used by protocols to query this structure for a route corresponding to a particular end-node address, and to cause certain protocol\- and interface-specific actions to take place. .\" XXX - -mdoc should contain a standard request for getting em and - \" en dashes. +.\" en dashes. .Pp When a route with the flag .Dv RTF_CLONING diff --git a/share/man/man9/rtentry.9 b/share/man/man9/rtentry.9 index da3abb5..5c75560 100644 --- a/share/man/man9/rtentry.9 +++ b/share/man/man9/rtentry.9 @@ -222,7 +222,7 @@ MTU for this path. Number of intermediate systems on the path to this destination. .It Li "u_long rmx_expire;" The time -(\*(aga la +(a la .Xr time 3 ) at which this route should expire, or zero if it should never expire. It is the responsibility of individual protocol suites to ensure that routes diff --git a/share/man/man9/spl.9 b/share/man/man9/spl.9 index b463e73..9abcaba 100644 --- a/share/man/man9/spl.9 +++ b/share/man/man9/spl.9 @@ -118,7 +118,7 @@ the system is about to return to user mode. .Pp The traditional assignment of the various device drivers to the interrupt priority groups can be roughly classified as: -.Bl -tag -width Fn splnet +.Bl -tag -width Fn .It Fn splnet All network interface drivers. .It Fn splbio diff --git a/share/man/man9/style.9 b/share/man/man9/style.9 index 07f128e..fc21355 100644 --- a/share/man/man9/style.9 +++ b/share/man/man9/style.9 @@ -492,7 +492,7 @@ to mention avoiding stupid bugs. Usage statements should look like the manual pages synopsis. The usage statement should be structured in the following order: .Pp -.Bl -enum -compat +.Bl -enum .It Options without operands come first, in alphabetical order, @@ -549,7 +549,6 @@ Whenever possible, code should be run through a code checker .Xr lint 1 or "gcc -Wall") and produce minimal warnings. - .Sh SEE ALSO .Xr indent 1 , .Xr lint 1 , diff --git a/share/man/man9/swi.9 b/share/man/man9/swi.9 index dc586d3..c6fe18f 100644 --- a/share/man/man9/swi.9 +++ b/share/man/man9/swi.9 @@ -35,11 +35,11 @@ .Fd #include .Fd #include .Fd #include -.Vt extern struct ithd *tty_ithd; -.Vt extern struct ithd *clk_ithd; -.Vt extern struct intrhand *net_ih; -.Vt extern struct intrhand *softclock_ih; -.Vt extern struct intrhand *vm_ih; +.Vt "extern struct ithd *tty_ithd;" +.Vt "extern struct ithd *clk_ithd;" +.Vt "extern struct intrhand *net_ih;" +.Vt "extern struct intrhand *softclock_ih;" +.Vt "extern struct intrhand *vm_ih;" .Ft void .Fn sched_swi "struct intrhand *handler" "int flags" .Ft struct intrhand * diff --git a/share/man/man9/timeout.9 b/share/man/man9/timeout.9 index 8f7db5d..2040fe3 100644 --- a/share/man/man9/timeout.9 +++ b/share/man/man9/timeout.9 @@ -50,14 +50,18 @@ .Sh SYNOPSIS .Fd #include .Fd #include -.Ft typedef void timeout_t \*(lpvoid *\*(rp; - +.Pp +.Bd -literal +typedef void timeout_t (void *); +.Ed .Ft struct callout_handle .Fn timeout "timeout_t *func" "void *arg" "int ticks" .Ft void .Fn callout_handle_init "struct callout_handle *handle" - -.Li struct callout_handle handle = CALLOUT_HANDLE_INITIALIZER(&handle) +.Pp +.Bd -literal +struct callout_handle handle = CALLOUT_HANDLE_INITIALIZER(&handle) +.Ed .Ft void .Fn untimeout "timeout_t *func" "void *arg" "struct callout_handle handle" .Ft void diff --git a/share/man/man9/vnode.9 b/share/man/man9/vnode.9 index 9ed6375..02b4c9b 100644 --- a/share/man/man9/vnode.9 +++ b/share/man/man9/vnode.9 @@ -239,7 +239,6 @@ A FIFO (named pipe). Advisory locking won't work on this. .It Dv VBAD An old style bad sector map .El - .Sh NOTES VFIFO uses the "struct fileops" from .Pa /sys/kern/sys_pipe.c . @@ -247,7 +246,7 @@ VSOCK uses the "struct fileops" from .Pa /sys/kern/sys_socket.c . Everything else uses the one from .Pa /sys/kern/vfs_vnops.c . - +.Pp The VFIFO/VSOCK code, which is why "struct fileops" is used at all, is an artifact of an incomplete integration of the VFS code into the kernel. diff --git a/share/man/man9/vrele.9 b/share/man/man9/vrele.9 index 02572f5..56517b5 100644 --- a/share/man/man9/vrele.9 +++ b/share/man/man9/vrele.9 @@ -62,4 +62,3 @@ field of the vnode reaches zero, then it will be placed on the free list. .Sh AUTHORS This man page was written by .An Doug Rabson . - diff --git a/share/termcap/termcap.5 b/share/termcap/termcap.5 index 0004c50..05acc04 100644 --- a/share/termcap/termcap.5 +++ b/share/termcap/termcap.5 @@ -109,7 +109,7 @@ The following suffixes should be used where possible: .Pp .Bd -filled -offset indent .Bl -column indent "With automatic margins (usually default)xx" -.Sy Suffix Meaning Example +.Sy "Suffix Meaning Example" -w Wide mode (more than 80 columns) vt100-w -am With automatic margins (usually default) vt100-am -nam Without automatic margins vt100-nam @@ -927,7 +927,7 @@ give this as (Normally this will be carriage-return, .Sy \&^M . ) If there is a code to produce an audible signal (bell, beep, -etc. ) , +etc.), give this as .Sy \&bl . .Pp @@ -1090,7 +1090,7 @@ no output .It "%r reverse order of two parameters, no output" .It "%i increment by one, no output" .It "%n exclusive-or all parameters with 0140 (Datamedia 2500)" -.It "%B" Ta Tn BCD No "(16*(value/10)) + (value%10), no output" +.It "\&%B" Ta Tn BCD No "(16*(value/10)) + (value%10), no output" .It "%D Reverse coding (value \- 2*(value%16)), no output (Delta Data)." .El .Pp @@ -1111,7 +1111,7 @@ The Datamedia 2500 needs the current row and column sent encoded in binary using .Dq \&%. . Terminals that use -.Dq \&%. +.Dq %.\& need to be able to backspace the cursor .Po Sy \&le Pc @@ -1550,13 +1550,13 @@ If there are function keys such as f0, f1, ..., f9, the codes they send can be given as .Sy \&k0 , .Sy \&k1 , -..., +\&..., .Sy \&k9 . If these keys have labels other than the default f0 through f9, the labels can be given as .Sy \&l0 , .Sy \&l1 , -..., +\&..., .Sy \&l9 . The codes transmitted by certain other special keys can be given: .Sy \&kH @@ -2030,7 +2030,9 @@ should indicate .Sy \&xt (destructive tabs). This glitch is also taken to mean that it is not possible -to position the cursor on top of a \*(lqmagic cookie\*(rq, and that +to position the cursor on top of a +.Dq magic cookie , +and that to erase standout mode it is necessary to use delete and insert line. .Pp The Beehive Superbee, which is unable to correctly transmit the -- cgit v1.1