* Make use of mandoc macros, better formatting

install/man/h2pas.1

@@ -0,0 +1,96 @@
+.TH h2pas 1 "12 Dec 1999" FreePascal "Free Pascal C header conversion utility"
+.SH NAME
+h2pas \- The C header to pascal unit conversion program.
+
+.SH SYNOPSIS
+
+.B h2pas
+.I "[options] filename"
+
+.SH DESCRIPTION
+
+.B h2pas
+attempts to convert a C header file to a pascal unit. 
+it can handle most C constructs that one finds in a C header file,
+and attempts to translate them to their pascal counterparts. see the 
+'Constructs' section for a full description of what the translator can
+handle.
+
+.SH USAGE
+
+H2pas is a command-line tool that translates a C header file to a spascal
+unit. It reads the C header file and translates the C declarations to
+equivalent pascal declarations that can be used to access code written in C.
+
+The output of the h2pas program is written to a file with the same name as
+the C header file that was used as input, but with the extension \fI.pp\fP.
+The output file that h2pas creates can be customized in a number of ways by
+means of many options.
+
+.SH OPTIONS
+
+The output of 
+.B h2pas
+can be controlled with the following options:
+
+
+.TP
+.B \-d 
+use 
+.I external;
+for all procedure and function declarations.
+.TP
+.B \-D 
+use 
+.B external
+.I libname 
+.B name
+.I 'func\_name'
+for function and procedure declarations.
+.TP
+.B \-e 
+Emit a series of constants instead of an enumeration type for the C 
+.I enum
+construct.
+.TP
+.B \-i
+create an include file instead of a unit (omits the unit header).
+.TP
+.BI \-l " libname"
+specify the library name for external function declarations.
+.TP
+.BI \-o " outfile"
+Specify the output file name. Default is the input file name with 
+the extension replaced by 
+.I ".pp"
+"."
+.TP
+.B \-p
+use the letter  
+.B P
+in front of pointer type parameters instead of "^".
+.TP
+.B \-s
+Strip comments from the input file. By default comments are converted
+to comments, but they may be displaced, since a comment is handled by the
+scanner.
+.TP
+.B \-t
+prepend typedef type names with the letter
+.B T
+(used to follow Borland's convention that all types should be defined with
+T).
+.TP
+.B \-v
+replace pointer parameters by call by reference parameters.
+Use with care because some calls can expect a NIL pointer.
+.TP
+.B \-w
+Header file is a win32 header file (adds support for some special macros).
+.TP
+.B \-x
+handle SYS\_TRAP of the PalmOS header files.
+.SH SEE ALSO
+.IP 
+.BR  ppc386 (1)
+.BR  ppumove (1)

install/man/ppc386.1

@@ -1,6 +1,7 @@
 .TH ppc386 1 "30 may 1999" FPC "Free Pascal Compiler"
 .SH NAME
-ppc386 \- Free Pascal Compiler (FPC) binary, name derived from Portable Pascal Compiler
+ppc386 \- Free Pascal Compiler (FPC) binary, name derived 
+from Portable Pascal Compiler
 
 .SH SYNOPSIS
 
@@ -13,8 +14,8 @@ This binary is the main binary of the
 which is a
 .I Turbo Pascal
 and
-.I Delphi (2.0) compatible
-standalone (non GCC frontend) multitarget Pascal compiler.
+.I Delphi (2.0) 
+compatible standalone (non GCC frontend) multitarget Pascal compiler.
 .PP
 The compiler uses
 .BR LD (1)
@@ -63,358 +64,498 @@ for more information.
 .PP
 General options
 
-.IP \fI\-h\fP
+.TP
+.BI \-h
 if you specify this option, the compiler outputs a list of all options,
 and exits after that.
-.IP \fI\-?\fP
+.TP
+.BI \-?
 idem as \-h, but waiting after every screenfull for the enter key.
-.IP \fI\-i\fP
+.TP
+.BI \-i
 This option tells the compiler to print the copyright information.
    You can give it an option, as -ixxx} where "xxx" can be one of the
 following:
 .RS
-.IP \fID\fP
+.TP
+.I D
 Returns the compiler date.
-.IP \fIV\fP
+.TP
+.I V
 Returns the compiler version.
-.IP \fISO\fP
+.TP
+.I SO
 Returns the compiler OS.
-.IP \fISP\fP
+.TP
+.I SP
 Returns the compiler processor.
-.IP \fITO\fP
+.TP
+.I TO
 Returns the target OS.
-.IP \fITP\fP
+.TP
+.I TP
 Returns the target Processor.
 .RE
-.IP \fI-l\fP
+.TP
+.I -l
 This option tells the compiler to print the
 .I FPC
 logo on standard output. It also gives you the
 .I FPC
 version number.
-.IP \fI-n\fP
+.TP
+.I -n
 Tells the compiler not to read the configuration file
 .BR ppc386.cfg (5)
 
 .PP
 Options for getting feedback
-.IP \fI-vxxx\fP
+.TP
+.BI \-v xxx
 Be verbose. "xxx" is a combination of the following:
 .RS
-.IP \fIe\fP
+.TP
+.I e
 Tells the compiler to show only errors. This option is on by default.
-.IP \fIi\fP
+.TP
+.I i
 Tells the compiler to show some general information.
-.IP \fIw\fP
+.TP
+.I w
 Tells the compiler to issue warnings.
-.IP \fIn\fP
+.TP
+.I n
 Tells the compiler to issue notes.
-.IP \fIh\fP
+.TP
+.I h
 Tells the compiler to issue hints.
-.IP \fIl\fP
+.TP
+.I l
 Tells the compiler to show the line numbers as it processes a
 file. Numbers are shown per 100.
-.IP \fIu\fP
+.TP
+.I u
 Tells the compiler to print the names of the files it opens.
-.IP \fIt\fP
+.TP
+.I t
 Tells the compiler to print the names of the files it tries
 to open.
-.IP \fIp\fP
+.TP
+.I p
 Tells the compiler to print the names of procedures and
 functions as it is processing them.
-.IP \fIc\fP
+.TP
+.I c
 Tells the compiler to warn you when it processes a
 conditional.
-.IP \fIm\fP
+.TP
+.I m
 Tells the compiler to write which macros are defined.
-.IP \fId\fP
+.TP
+.I d
 Tells the compiler to write other debugging info.
-.IP \fIa\fP
+.TP
+.I a
 Tells the compiler to write all possible info. (this is the
 same as specifying all options)
-.IP \fI0\fP
+.TP
+.I 0
 Tells the compiler to write no messages. This is useful when
 you want to override the default setting in the configuration file.
-.IP \fIb\fP
+.TP
+.I b
 Tells the compiler to show all procedure declarations if an
 overloaded function error occurs.
-.IP \fIx\fP
+.TP
+.I x
 Tells the compiler to output some executable info (for Win32
 platform only).
-.IP \fIr\fP
+.TP
+.I r
 Rhide/GCC compatibility mode: formats the error differently, so they
 are understood by RHIDE.
 .RE
 .PP
 Options concerning files and directories
-.IP \fI-exxx\fP
-"xxx" specifies the directory where thc ompiler can find the executables
-as (the assembler) and ld (the compiler).
-
-.IP \fI-FD\fP
+.TP
+.BI -e xxx
+tells the compiler that 
+.I xxx
+is the directory where it can find the executables as (the assembler) and 
+ld (the linker).
+.TP
+.BI \-FD
 same as
-.I -e.
-.IP \fI-Fexxx\fP
+.I \-e.
+.TP
+.BI \-Fe xxx
 This option tells the compiler to write errors, etc. to
-the file "xxx".
-.IP \fI-Fgxxx\fP
-(linux only, obsolete) "xxx" specifies the path where the compiler
-can find the
+the file 
+.I xxx
+.
+.TP
+.BI \-Fg xxx
+(linux only, obsolete) 
+.I xxx
+ specifies the path where the compiler can find the
 .I GNU C
 library. This is superseded by the
-.I -Fl
+.I \-Fl
 option.
-.IP \fI-Fixxx\fP
-adds "xxx" to the path where the compiler searches for
-its include files.
-.IP \fI-Flxxx\fP
-Adds "xxx" to the library searching path, and is passe to the linker.
-
-.IP \fI-FLxxx\fP
-( Linux only) Tells the compiler to use "xxx" as the
-dynamic linker. Default this is /lib/ld-linux.so.2, or
+.TP
+.BI \-Fi xxx
+adds 
+.I xxx
+to the path where the compiler searches for its include files.
+.TP
+.BI \-Fl xxx
+Adds 
+.I xxx
+to the library searching path, and is passe to the linker.
+.TP
+.BI \-FL xxx
+( Linux only) Tells the compiler to use 
+.I xxx
+as the dynamic linker. Default this is /lib/ld-linux.so.2, or
 lib/ld-linux.so.1, depending on which one is found.
-.IP \fI-Foxxx\fP
-Adds "xxx" to the object file path. This path is used
+.TP
+.BI \-Fo xxx
+Adds 
+.I xxx
+ to the object file path. This path is used
 when looking for files that need to be linked in.
-.IP \fI-Frxxx\fP
-"xxx" specifies the file which contain the compiler
-messages. Default the compiler ahs built-in messages. Specifying this option
-will override the default messages.
-.IP \fI-Fuxxx\fP
-Idem as
-.I -Up
-Add "xxx" to the object path.
-.IP \fI-FUxxx\fP
-Tells the compiler to write units in directory "xxx" instead of the current
-directory.
-.IP \fI-Ixxx\fP
-Add "xxx" to the include file search path.
+.TP
+.BI \-Fr xxx
+tells the compiler that 
+.I xxx
+contains the compiler messages. Default the compiler has built-in 
+messages. Specifying this option will override the default messages.
+(useful if you want to use a language other than the default language).
+.TP
+.BI \-Fu xxx
+Adds
+.I xxx
+to the unit path.
+By default, the compiler only searches for units in the current directory
+and the directory where the compiler itself resides. This option tells the
+compiler also to look in the directory 
+.I xxx
+\.
+.TP
+.BI \-FU xxx
+Tells the compiler to write units in directory 
+.I xxx
+instead of the current directory.
+.TP
+.BI \-I xxx
+Add 
+.I xxx
+to the include file search path.
 This path is used when looking for include files.
-.IP \fI-P\fP
+.TP
+.BI \-P
 uses pipes instead of files when assembling. This may speed up
 the compiler on OS/2 and Linux. Only with assemblers (such as
 .I GNU AS
-that support piping..
-.IP \fI-Upxxx\fP
-Tells the compiler to add "xxx" to the path where to find
-units.
+) that support piping.
+.TP
 By default, the compiler only searches for units in the current directory
 and the directory where the compiler itself resides. This option tells the
 compiler also to look in the directory "xxx."
 
 .PP Options controlling the kind of output
 for more information on these options, see also the programmers manual.
-.IP \fI-a\fP
+.TP
+.BI \-a
 Tells the compiler not to delete the assembler file.
 This also counts for the (possibly) generated batch script.
-.IP \fI-al\fP
+.TP
+.BI \-al
 Tells the compiler to include the sourcecode lines
 in the assembler file as comments. This feature is still experimental, and
 should be used with caution.
-.IP \fI-Axxx\fP
+.TP
+.BI -A xxx
 specifies what kind of assembler should be generated . Here
-"xxx" is one of the following :
+.I xxx
+is one of the following :
 .RS
-.IP \fIAS\fP
+.TP
+.I AS
 A unix .o (object) file, using
 .I GNU AS
-.IP \fInasmcoff\fP
+.TP
+.I nasmcoff
 a coff file using the
 .I nasm
 assembler.
-.IP \fInasmelf\fP
+.TP
+.I nasmelf
 a ELF32 file (LINUX only) using the
 .I nasm
 assembler.
-.IP \fInasmonj\fP
+.TP
+.I nasmonj
 a obj file  using the
 .I nasm
 assembler.
-.IP \fImasm\fP
+.TP
+.I masm
 An obj file using the Microsoft
 .I masm
 assembler.
-.IP \fItasm\fP
+.TP
+.I tasm
 An obj file using the Borland
 .I tasm
 assembler.
 .RE
 
-.IP \fI-CD\fP
+.TP
+.BI \-CD
 Create dynamic library.
-.IP \fI-Chxxx\fP
-Reserves "xxx" bytes heap. "xxx" shoul be between 1024 and 67107840.
-.IP \fI-Ci\fP
+.TP
+.BI \-Ch xxx
+Reserves 
+.I xxx
+bytes heap. 
+.I xxx
+should be between 1024 and 67107840.
+.TP
+.BI \-Ci
 Generate Input/Output checking code.
-.IP \fI-Cn\fP
+.TP
+.BI \-Cn
 Omit the linking stage.
-.IP \fI-Co\fP
+.TP
+.BI \-Co
 Generate Integer overflow checking code.
-.IP \fI-Cr\fP
+.TP
+.BI \-Cr
 Generate Range checking code.
-.IP \fI-Csxxx\fP
-Set stack size to "xxx".
-.IP \fI-CS\fP
+.TP
+.BI \-Cs xxx
+Set stack size to 
+.I xxx
+bytes.
+.TP
+.BI \-CS
 Create static library.
-.IP \fI-Ct\fP
+.TP
+.BI \-Ct
 generate stack checking code.
-.IP \fI-Cx\fP
+.TP
+.BI \-Cx
 Use smartlinking when compiling and linking units.
-.IP \fI-dxxx\fP
-Define the symbol name "xxx". This can be used
-to conditionally compile parts of your code.
-
+.TP
+.BI \-d xxx
+Define the symbol name 
+.I xxx
+This can be used to conditionally compile parts of your code.
 
-
-.IP \fI-E\fP
+.TP
+.BI \-E
 Same as -Cn.
-.IP \fI-g\fP
+.TP
+.BI \-g
 Generate debugging information for debugging with
 .I GDB
 
-.IP \fI-gg\fP
-idem as -g.
-.IP \fI-gd\fP
+.TP
+.BI \-gg
+idem as 
+.B -g.
+.TP
+.BI \-gd
 generate debugging info for dbx.
-.IP \fI-gh\fP
+.TP
+.BI \-gh
 use the heaptrc unit (see the units part of the FPC manual).
-.IP \fI-Oxxx\fP
-optimize the compiler's output; "xxx" can have one
-of the following values :
+.TP
+.BI \-O xxx
+optimize the compiler's output; 
+.I xxx
+can have one of the following values :
 .RS
-.IP \fIg\fP
+.TP
+.I g
 optimize for size, try to generate smaller code.
-.IP \fIG\fP
+.TP
+.I G
 optimize for time, try to generate faster code (default).
-.IP \fIr\fP
+.TP
+.I r
 keep certain variables in registers (experimental, use with caution).
-.IP \fIu\fP
+.TP
+.I u
 uncertain optimizations
-.IP \fI1\fP
+.TP
+.I 1
 Level 1 optimizations (quick optimizations).
-.IP \fI2\fP
+.TP
+.I 2
 Level 2 optimizations (-O1 plus some slower optimizations).
-.IP \fI3\fP
+.TP
+.I 3
 Level 3 optimizations (-O2 plus -Ou).
-.IP \fIPn\fP
+.TP
+.I Pn
 Specify processor : n can be one of
 .RS
-.IP \fI1\fP
+.TP
+.I 1
 optimize for 386/486
-.IP \fI2\fP
+.TP
+.I 2
 optimize for Pentium/PentiumMMX (tm)
-.IP \fI3\fP
+.TP
+.I 3
 optimizations for PentiumPro / P-II / Cyrix 6x86 / K6 (tm)
 .RE
 
 The exact effect of these effects can be found in the programmers part of the manual.
 .RE
-.IP \fI-oxxx\fP
-Tells the compiler to use "xxx" as the name of the output
-file (executable). Only with programs.
-.IP \fI-pg\fP
+.TP
+.BI \-o xxx
+Tells the compiler to use 
+.I xxx
+as the name of the output file (executable). Only with programs.
+.TP
+.BI \-pg
 Generate profiler code for gprof.
-.IP \fI-s\fP
+.TP
+.BI \-s
 Tells the compiler not to call the assembler and linker.
 Instead, the compiler writes a script, PPAS.BAT under DOS, or
 ppas.sh under Linux, which can then be executed to produce an
 executable.
-.IP \fI-Txxx\fP
-Specifies the target operating system. "xxx" can be one of the following:
+.TP
+.BI \-T xxx
+Specifies the target operating system. 
+.I xxx
+can be one of the following:
 .RS
-.IP \fIGO32V1\fP
+.TP
+.I GO32V1
 DOS and version 1 of the DJ DELORIE extender (no longer maintained).
-.IP \fIGO32V2\fP
+.TP
+.I GO32V2
 DOS and version 2 of the DJ DELORIE extender.
-.IP \fILINUX\fP
+.TP
+.I LINUX
 Linux.
-.IP \fIOS2\fP
+.TP
+.I OS2
 OS/2 (2.x) (this is still under development).
-.IP \fIWIN32\fP
+.TP
+.I WIN32
 Windows 32 bit.
 .RE
-.IP \fI-uxxx\fP
-undefine the symbol "xxx". This is the opposite
-of the -d option.
-.IP \fI-uxxx\fP
-Undefine symbol "xxx".
-.IP \fI-Xx\fP
+.TP
+.BI -u xxx
+undefine the symbol 
+.I xxx
+\. This is the opposite of the 
+.B \-d 
+option.
+.TP
+.BI \-u xxx
+Undefine symbol 
+.I xxx
+\.
+.TP
+.BI \-X x
 Executable options. These tell the compiler what
-kind of executable should be generated. the parameter "x"
+kind of executable should be generated. the parameter 
+.I x
 can be one of the following:
 .RS
-.IP \fIc\fP
-(Linux only) Link with the C library. You should only use this when
-you start to port \fpc to another operating system.
-.IP \fID\fP
+.TP
+.I c
+(Linux only, obsolete) Link with the C library. You should only use this when
+you start to port Free Pascal to another operating system.
+.TP
+.I D
 Link with dynamic libraries (defines the FPC_LINK_DYNAMIC symbol)
-.IP \fIs\fP
+.TP
+.I s
 Strip the symbols from the executable.
-.IP \fIS\fP
+.TP
+.I S
 Link with static libraries (defines th FPC_LINK_STATIC symbol)
 .RE
 
 .PP
 Options concerning the sources (language options)
 for more information on these options, see also Programmers Manual
-.IP \fI-Rxxx\fP
+.TP
+.BI \-R xxx
 Specifies what assembler you use in your "asm" assembler code
-blocks. Here "xxx" is one of the following:
+blocks. Here 
+.I xxx
+is one of the following:
 .RS
-.IP \fIatt\fP
+.TP
+.I att
 Asm blocks contain AT&T assembler.
-.IP \fIintel\fP
+.TP
+.I intel
 Asm blocks contain Intel assembler.
-.IP \fIdirect\fP
+.TP
+.I direct
 Asm blocks should be copied as-is in the assembler
 file.
 .RE
-.IP \fI-S2\fP
+.TP
+.BI \-S2
 Switch on Delphi 2 extensions.
-.IP \fI-Sc\fP
+.TP
+.BI \-Sc
 Support C-style operators, i.e. *=, +=, /= and -=.
-.IP \fI-Sd\fP
+.TP
+.BI \-Sd
 tells the compiler to dispose asmlists. This uses less memory,
 but is slower.
-.IP \fI-Se\fP
+.TP
+.BI \-Se
 The compiler stops after the first error. Normally,
 the compiler tries to continue compiling after an error, until 50 errors are
 reached, or a fatal error is reached, and then it stops. With this switch,
 the compiler will stop after the first error.
-.IP \fI-Sg\fP
+.TP
+.BI \-Sg
 Support the label and goto commands.
-.IP \fI-Si\fP
+.TP
+.BI \-Si
 Support C++ style INLINE.
-.IP \fI-Sm\fP
+.TP
+.BI \-Sm
 Support C-style macros.
-.IP \fI-So\fP
+.TP
+.BI \-So
 Try to be Borland TP 7.0 compatible (no function
 overloading etc.).
-.IP \fI-Sp\fP
+.TP
+.BI \-Sp
 Try to be
 .I GPC (GNU Pascal Compiler)
 compatible.
-.IP \fI-Ss\fP
+.TP
+.BI \-Ss
 The name of constructors must be "init", and the
 name of destructors should be "done".
-.IP \fI-St\fP
+.TP
+.BI \-St
 Allow the "static" keyword in objects.
-.IP \fI-Un\fP
+.TP
+.BI \-Un
 Do not check the unit name. Normally, the unit name
 is the same as the filename. This option allows both to be different.
-.IP \fI-Us\fP
+.TP
+.BI \-Us
 Compile a system unit. This option causes the
 compiler to define only some very basic types.
 
-.SH Acknowledgements
-
-The manual (on which the manpage is based) was mainly written by Michael van Canneyt.
-.PP
-Questions/corrections can be mailed to fpc\[email protected]
-.PP
-Also thanks to the rest of the FPC development team.
-
 .SH SEE ALSO
 .BR  ppc386.cfg (5)
 .BR  ppdep (1)

install/man/ppdep.1

@@ -8,51 +8,87 @@ ppdep \- The FPC Pascal unit dependency tracking program.
 
 .SH Description
 
-\fBppdep\fP dumps the dependencies of a unit in a format that can be
-understood by GNU \fBmake\fP. It writes these dependencies to standard 
+.B ppdep
+dumps the dependencies of a unit in a format that can be
+understood by GNU 
+.B make
+. It writes these dependencies to standard 
 output. It takes care of dependencies both in the interface and 
 implemntation section of the unit, and it can handle conditional defines.
 
 .SH Usage
 
-You can invoke \fBppdep\fP with as the only required argument the name of the
+You can invoke 
+.B ppdep
+with as the only required argument the name of the
 file (program or unit) whose dependecies you wish to list. You don't need 
-to specify an extension, by default \fB.pp\fP is assumed.
+to specify an extension, by default 
+.B .pp
+is assumed.
 
 .SH Options
 
-\fBppdep\fP has several options, which are case insensitive:
+.B ppdep
+has several options, which are case insensitive:
 
-.IP \fI\-a[call]\fP 
-This option tells \fBppdep\fP to generate a compiler call for the 
+.TP
+.BI \-a call
+This option tells 
+.B ppdep
+to generate a compiler call for the 
 makefile. The compiler call will be generated for each file that 
 is found in the current directory. If you do no specify an explicit 
-compiler call, \fBppc386\fP is used.
-.IP \fI\-dKeyword\fP
-This option defines \fBkeyword\fP that can be used to verify conditional
-defines. \fBppdep\fP understands conditional defines, you should use this
-switch if the \fIuses\fP clause of the programs or units can contain conditional
-defines.
-.IP \fI\-eext\fP
+compiler call, 
+.B ppc386
+is used.
+.TP
+.BI \-d keyword
+This option defines 
+.B keyword
+ that can be used to verify conditional
+defines. 
+.B ppdep
+understands conditional defines, you should use this switch if the 
+.I uses
+clause of the programs or units can contain conditional defines.
+.TP
+.BI \-e ext
 This allows you to specify a different extension for the unit files.
-By default, \fB.ppu\fP is assumed. This extension is written to the
+By default, 
+.B .ppu
+is assumed. This extension is written to the
 makefile.
-.IP \fI-f[call]\fP
-This option tells \fBppdep\fP to generate a compiler call for the 
+.TP
+.BI \-f [call]
+This option tells 
+.B ppdep
+to generate a compiler call for the 
 makefile. The compiler call will be generated only for the file that
-was specified on the \fBppdep\fP command line. If you want to generate a
-compiler call for each file found, use the \fI\-a\fP option.
-If you do no specify an explicit compiler call, \fBppc386\fP is used.
-.IP \fI\-h\fP 
+was specified on the 
+.B ppdep
+command line. If you want to generate a
+compiler call for each file found, use the 
+.I \-a
+option.
+If you do no specify an explicit compiler call, 
+.B ppc386
+is used.
+.TP
+.BI \-h 
 Shows a short help screen.
-.IP \fI\-ofile\fP 
+.TP
+.BI \-o file 
 This option allows you to specify a file to which the dependencies should be
 written. By default the dependencies are written to standard output.
-If you specify this option, the dependencies are written to \fBfile\fP
+If you specify this option, the dependencies are written to 
+.B file
+
 instead.
-.IP \fI\-v\fP 
+.TP
+.BI \-v 
 Writes some diagnostic messages. If you use this option, be sure to use
-\fI\-o\fP as well, since the diagnostic messages will also be written to 
+.I \-o
+as well, since the diagnostic messages will also be written to 
 standard output.
 .RE
 

install/man/ppudump.1

@@ -8,8 +8,9 @@ ppudump \- The FPC Pascal unit dump program.
 
 .SH Description
 
-\fIppudump\fP writes the contents of a Free Pascal unit file to standard
-output. It gives a listing of all definitions in the unit file. The format
+.B ppudump
+writes the contents of a Free Pascal unit file to standard output. 
+It gives a listing of all definitions in the unit file. The format
 of the listing can be controlled by the options.
 
 .SH Usage
@@ -20,28 +21,39 @@ assumed. The output goes to standard output.
 
 .SH Options
 
-\fIppudump\fP has only two options:
+.B ppudump
+has only two options:
 
-.IP \fI\-h\fP 
+.TP
+.BI \-h
 shows a short help screen.
-.IP \fI\-v\fP
-Controls the level of verbosity. \-v accepts any combination of the following 
-letters behind it:
+.TP
+.BI \-v xxx
+Controls the level of verbosity. 
+.I xxx 
+is  any combination of the following letters:
 .RS
-.IP \fIa\fP
+.TP
+.I a
 Shows all information stored in the PPU file.
-.IP \fIb\fP
+.TP
+.I b
 Shows the browser information in the PPU file (if present).
-.IP \fId\fP
+.TP
+.I d
 Shows the definitions in the PPU file.
-.IP \fIh\fP 
+.TP
+.I h 
 Shows the header information in the PPU file.
-.IP \fIi\fP
+.TP
+.I i
 Shows only interface information, implementation information is
 not shown.
-.IP \fIm\fP
+.TP
+.I m
 Shows only implementation information, interface interface is not shown.
-.IP \fIs\fP
+.TP
+.I s
 Shows the symbols stored in the PPU file.
 .RE
 

install/man/ppumove.1

@@ -21,30 +21,35 @@ multiple files is also possible, they will be put in the same archive.
 
 \fBppumove\fP has several options, which are case sensitive:
 
-.IP \fI\-b\fP 
+.TP
+.B \-b
 This option tells \fBppumove\fP to write a shell script (a batch file on
 DOS) that performs the needed calls to \fBar\fP and \fBld\fP. The script
 will be called \fBpmove\fP, with an extension of \fB.sh\fP on Linux,
 and \fB.bat\fP on DOS. You can then call this script manually afterwards.
 
-.IP \fI\-d\ path\fP 
+.TP 
+.BI \-d " path"
 This option tells \fBppumove\fP where to generate the new unit files.
 By default, this is the same directory as where the files are found. 
 If you specify as the output extension the same extension as the units
 you want to move, not specifying the destination directory may cause
 problems.
 
-.IP \fI\-e\ ext\fP
+.TP 
+.BI \-e " ext"
 This option sets the extension of the new unit files to \fBext\fP. By
 default \fB.ppl\fP is used. However, you can specify \fB.ppu\fP as the
 extension. If you do, be sure to use also the \fI\-d\fP switch, or you will
 overwrite the old units. Note however, that the compiler will only look for
 extensions \fB.ppu\fP and \fB.ppl\fP when looking for units.
 
-.IP \fI\-h\fP 
+.TP
+.B -h
 Shows a short help screen.
 
-.IP \fI\-o\ file\fP 
+.TP 
+.BI \-o " file"
 This option allows you to specify the name of the library to be generated.
 You \fBmust\fP use this option if you specify more than one unit on the
 command-line. If you specified only one unit on the command-line, the generated library
@@ -52,14 +57,17 @@ will have the unit name, with \fBlib\fP prepended (on Linux).
 You do not need to specify the \fBlib\fP part, this will be prepended
 automatically if needed.
 
-.IP \fI\-q\fP
+.TP
+.B \-q
 Tells \fBppumove\fP to operate quietly.
 
-.IP \fI\-s\fP
+.TP
+.B \-s
 Tells \fBppumove\fP to generate a static library. By default, a shared
 library is generated (except on DOS). 
 
-.IP \fI\-w\fP
+.TP 
+.B \-w
 Tells \fBppumove\fP it should use the windows linker and archiver. Do not
 use this option on Linux.
 

install/man/ptop.1

@@ -6,37 +6,57 @@ Origin probably Pascal\-TO\-Pascal.
 
 .SH SYNOPSIS
 
-\fIptop\fP "[-v] [-i indent] [-b bufsize ][-c optsfile] infile outfile"
+.BI ptop "[-v] [-i indent] [-b bufsize ][-c optsfile] infile outfile"
 
 .SH Description
 
-\fIptop\fP is a more or less configurable \fIsource beautifier\fP for pascal sources,
-and specially the ones supported by FPC (which are more or less TurboPascal or
-Delphi 2.0 compatible).
+.B ptop
+is a more or less configurable 
+.I "source beautifier"
+for pascal sources, and specially the ones supported by FPC (which are 
+more or less Turbo Pascal or Delphi 2.0 compatible).
 .PP
-ptop belongs to the \fIFPC utils\fP package, which currently also contains ppdep, h2pas, ppudump
-and ppumove.
+ptop belongs to the 
+.I "FPC utils"
+package, which currently also contains 
+.B ppdep
+, 
+.B h2pas
+, 
+.B ppudump
+and 
+.B ppumove
+\.
 
 .SH Usage
 
-ptop basically reformats "infile" and outputs the result to "outfile". ptop uses
-a configuration file explained further below, and can generate a default
+.B ptop 
+basically reformats "infile" and outputs the result to "outfile". 
+ituses a configuration file explained further below, and can generate a default
 configurationfile for you to edit. (not needed if you use the defaults)
 
 .SH Options
-.IP \-h
+.TP
+.B \-h
 Writes a short description of these switches.
-.IP \-c
+.TP
+.B \-c
 read options from configuration file. A configuration file is not needed, ptop
 will revert to internal defaults then. See also \-g
-.IP \-i ident
+.TP
+.BI \-i " ident"
 Sets the number of indent spaces used for BEGIN END; and other blocks.
-.IP \-b bufsize
+.TP
+.BI \-b " bufsize"
 Sets the buffersize to bufsize. Default 255, 0 is considered non\-valid and ignored.
-.IP \-v
+.TP
+.B \-v
 be verbose. Currently only outputs the number of lines read/written and some error messages.
-.IP \-g ptop.cfg
-Writes a default configuration file to be edited to the file "ptop.cfg"
+.TP 
+.BI \-g " ptop.cfg"
+Writes a default configuration file to be edited to the file 
+.I ptop.cfg
+
 .PP
 Try to play with ptop and its configfile until you find the effect you desire. The
 configurability and possibilities of ptop are quite large compared to shareware