adamstark@14: .\"Modified from man(1) of FreeBSD, the NetBSD mdoc.template, and mdoc.samples.
adamstark@14: .\"See Also:
adamstark@14: .\"man mdoc.samples for a complete listing of options
adamstark@14: .\"man mdoc for the short list of editing options
adamstark@14: .\"/usr/share/misc/mdoc.template
adamstark@14: .Dd 21/01/2014               \" DATE 
adamstark@14: .Dt BTrack Tests 1      \" Program name and manual section number 
adamstark@14: .Os Darwin
adamstark@14: .Sh NAME                 \" Section Header - required - don't modify 
adamstark@14: .Nm BTrack Tests,
adamstark@14: .\" The following lines are read in generating the apropos(man -k) database. Use only key
adamstark@14: .\" words here as the database is built based on the words here and in the .ND line. 
adamstark@14: .Nm Other_name_for_same_program(),
adamstark@14: .Nm Yet another name for the same program.
adamstark@14: .\" Use .Nm macro to designate other names for the documented program.
adamstark@14: .Nd This line parsed for whatis database.
adamstark@14: .Sh SYNOPSIS             \" Section Header - required - don't modify
adamstark@14: .Nm
adamstark@14: .Op Fl abcd              \" [-abcd]
adamstark@14: .Op Fl a Ar path         \" [-a path] 
adamstark@14: .Op Ar file              \" [file]
adamstark@14: .Op Ar                   \" [file ...]
adamstark@14: .Ar arg0                 \" Underlined argument - use .Ar anywhere to underline
adamstark@14: arg2 ...                 \" Arguments
adamstark@14: .Sh DESCRIPTION          \" Section Header - required - don't modify
adamstark@14: Use the .Nm macro to refer to your program throughout the man page like such:
adamstark@14: .Nm
adamstark@14: Underlining is accomplished with the .Ar macro like this:
adamstark@14: .Ar underlined text .
adamstark@14: .Pp                      \" Inserts a space
adamstark@14: A list of items with descriptions:
adamstark@14: .Bl -tag -width -indent  \" Begins a tagged list 
adamstark@14: .It item a               \" Each item preceded by .It macro
adamstark@14: Description of item a
adamstark@14: .It item b
adamstark@14: Description of item b
adamstark@14: .El                      \" Ends the list
adamstark@14: .Pp
adamstark@14: A list of flags and their descriptions:
adamstark@14: .Bl -tag -width -indent  \" Differs from above in tag removed 
adamstark@14: .It Fl a                 \"-a flag as a list item
adamstark@14: Description of -a flag
adamstark@14: .It Fl b
adamstark@14: Description of -b flag
adamstark@14: .El                      \" Ends the list
adamstark@14: .Pp
adamstark@14: .\" .Sh ENVIRONMENT      \" May not be needed
adamstark@14: .\" .Bl -tag -width "ENV_VAR_1" -indent \" ENV_VAR_1 is width of the string ENV_VAR_1
adamstark@14: .\" .It Ev ENV_VAR_1
adamstark@14: .\" Description of ENV_VAR_1
adamstark@14: .\" .It Ev ENV_VAR_2
adamstark@14: .\" Description of ENV_VAR_2
adamstark@14: .\" .El                      
adamstark@14: .Sh FILES                \" File used or created by the topic of the man page
adamstark@14: .Bl -tag -width "/Users/joeuser/Library/really_long_file_name" -compact
adamstark@14: .It Pa /usr/share/file_name
adamstark@14: FILE_1 description
adamstark@14: .It Pa /Users/joeuser/Library/really_long_file_name
adamstark@14: FILE_2 description
adamstark@14: .El                      \" Ends the list
adamstark@14: .\" .Sh DIAGNOSTICS       \" May not be needed
adamstark@14: .\" .Bl -diag
adamstark@14: .\" .It Diagnostic Tag
adamstark@14: .\" Diagnostic informtion here.
adamstark@14: .\" .It Diagnostic Tag
adamstark@14: .\" Diagnostic informtion here.
adamstark@14: .\" .El
adamstark@14: .Sh SEE ALSO 
adamstark@14: .\" List links in ascending order by section, alphabetically within a section.
adamstark@14: .\" Please do not reference files that do not exist without filing a bug report
adamstark@14: .Xr a 1 , 
adamstark@14: .Xr b 1 ,
adamstark@14: .Xr c 1 ,
adamstark@14: .Xr a 2 ,
adamstark@14: .Xr b 2 ,
adamstark@14: .Xr a 3 ,
adamstark@14: .Xr b 3 
adamstark@14: .\" .Sh BUGS              \" Document known, unremedied bugs 
adamstark@14: .\" .Sh HISTORY           \" Document history if command behaves in a unique manner