[patch] Add manpage for piklab-coff and improve other manpages

0.15.4-manpages.diff (text/plain), 23.58 KB, created by Flavio Cappelli on 2009-07-05 22:26:33 UTC

diff -urN piklab-0.15.4/man/Makefile.am piklab-0.15.4.new/man/Makefile.am
--- piklab-0.15.4/man/Makefile.am	2008-11-22 16:19:46.000000000 +0100
+++ piklab-0.15.4.new/man/Makefile.am	2009-03-30 12:03:15.000000000 +0200
@@ -1,3 +1,3 @@
-man_MANS = piklab.1x piklab-prog.1 piklab-hex.1
+man_MANS = piklab.1x piklab-prog.1 piklab-hex.1 piklab-coff.1
 
 EXTRA_DIST = $(man_MANS)
diff -urN piklab-0.15.4/man/Makefile.in piklab-0.15.4.new/man/Makefile.in
--- piklab-0.15.4/man/Makefile.in	2008-11-22 16:27:35.000000000 +0100
+++ piklab-0.15.4.new/man/Makefile.in	2009-03-30 12:06:23.000000000 +0200
@@ -1,5 +1,5 @@
 # Makefile.in generated by automake 1.10 from Makefile.am.
-# KDE tags expanded automatically by am_edit - $Revision: 877 $ 
+# KDE tags expanded automatically by am_edit - $Revision: 877 $
 # @configure_input@
 
 # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
@@ -298,7 +298,7 @@
 xdg_appsdir = @xdg_appsdir@
 xdg_directorydir = @xdg_directorydir@
 xdg_menudir = @xdg_menudir@
-man_MANS = piklab.1x piklab-prog.1 piklab-hex.1
+man_MANS = piklab.1x piklab-prog.1 piklab-hex.1 piklab-coff.1
 EXTRA_DIST = $(man_MANS)
 #>- all: all-am
 #>+ 1
@@ -541,7 +541,7 @@
 .NOEXPORT:
 
 #>+ 2
-KDE_DIST=Makefile.in piklab-prog.1 piklab.1x Makefile.am piklab-hex.1 
+KDE_DIST=Makefile.in piklab-prog.1 piklab.1x Makefile.am piklab-hex.1 piklab-coff.1
 
 #>+ 2
 docs-am:
@@ -563,7 +563,7 @@
 
 
 #>+ 21
-clean-bcheck: 
+clean-bcheck:
 	rm -f *.bchecktest.cc *.bchecktest.cc.class a.out
 
 bcheck: bcheck-am
@@ -605,5 +605,5 @@
 	-rm -f *.rpo
 
 #>+ 3
-nmcheck: 
+nmcheck:
 nmcheck-am: nmcheck
diff -urN piklab-0.15.4/man/piklab.1x piklab-0.15.4.new/man/piklab.1x
--- piklab-0.15.4/man/piklab.1x	2008-11-22 16:19:46.000000000 +0100
+++ piklab-0.15.4.new/man/piklab.1x	2009-03-30 15:06:01.000000000 +0200
@@ -1,8 +1,7 @@
-.\"                                      Hey, EMACS: -*- nroff -*-
+.\" Hey, EMACS: -*- nroff -*-
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH PIKLAB SECTION "April 11, 2007"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -15,14 +14,14 @@
 .\" .br        insert line break
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
-.SH PIKLAB 
-\- IDE for PIC-microcontroller development.
-.TP
-.SH SYNOPSIS
+.TH "PIKLAB" "1" "April 11, 2007" "" ""
+.SH "NAME"
+piklab \- IDE for PIC\-microcontroller development.
 
-.B piklab [Qt-options] [KDE-options] [file]
+.SH "SYNOPSIS"
+.B piklab [Qt\-options] [KDE\-options] [file]
 
-.br
+.SH "DESCRIPTION"
 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
 .\" \fI<whatever>\fP escape sequences to invode bold face and italics,
 .\" respectively.
@@ -30,53 +29,59 @@
 similar to the MPLAB environment. It integrates with several compiler and assembler toolchains (like gputils, sdcc, c18) and with the
 simulator gpsim. It supports the most common programmers (serial, parallel, ICD2, Pickit2, PicStart+) and debuggers (ICD2).
 
-.TP
-.SH OPTIONS
-These programs follow the usual GNU command line syntax, with long
-options starting with two dashes (`-').
+.SH "OPTIONS"
+This program follows the usual GNU command line syntax, with long
+options starting with two dashes ('\-').
 A summary of options is included below.
 .TP
+.B GENERIC OPTIONS:
+.TP
 .B \-h, \-\-help
 Show summary of options.
 .TP
-.B \-v, \-\-version
-Show version of program.
-.TP
-.B \-\-help-qt
-	Show Qt specific options
+.B \-\-help\-qt
+Show Qt specific options.
 .TP
-.B \-\-help-kde
-	Show KDE specific options
+.B \-\-help\-kde
+Show KDE specific options.
 .TP
-.B \-\-help-all
-	Show all options
+.B \-\-help\-all
+Show all options.
 .TP
 .B \-\-author
-	Show author information
+Show author information.
+.TP
+.B \-v, \-\-version
+Show version information.
 .TP
 .B \-\-license
-	Show license information
+Show license information.
 .TP
 .B \-\-
-	End of options
-.TP
+End of options.
+
 .br
-.sp 3
-.SH SEE ALSO
-.BR piklab-prog (1),
-.BR piklab-hex (1),
+.TP
+.B ARGUMENTS:
+.TP
+.B file
+Optional filename(s) to be opened upon startup.
+
+.SH "SEE ALSO"
+.BR piklab\-prog (1),
+.BR piklab\-hex (1),
+.BR piklab\-coff (1),
 .BR gputils (1),
 .BR sdcc (1).
-.br
-.SH AUTHORS
-piklab was written by Nicolas Hadacek and many others, including:
 
+.SH "AUTHORS"
+Piklab was written by Nicolas Hadacek and many others, including:
     * Alain Gibaud: author of Pikdev; main infrastructure; IDE interface; direct programmers; gputils integration.
     * Keith Baker: direct programmer support for 16F7X devices.
     * Xiaofan Chen: numerous tests of PICkit1/2 and ICD2 programmers.
     * Craig Franklin: author of gputils (disassembler and coff parser).
     * Manwlis Giannos: direct programmer support for PIC18FXX2/FXX8 devices.
-    * Stephen Landamore: author of LPLAB (microchip command-line programmer).
+    * Stephen Landamore: author of LPLAB (microchip command\-line programmer).
     * Brian C. Lane: original code for direct programming.
     * Sébastion Laoût: author of Likeback.
     * Nestor A. Marchesini: tests of PicStart+ programmer.
@@ -89,11 +94,10 @@
     * Alain Portal: French translation.
     * Stefan von Halenbach: German translation.
     * Nagy Lázló: Hungarian translation.
-.sp 3
-.SH COPYRIGHT
-	This  is  free  software.   You  may  redistribute  copies  of  it  under  the  terms   of   the   GNU   General   Public   License
-       	<http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to the extent permitted by law.
 
+.SH "COPYRIGHT"
+This is free software. You may redistribute copies of it under the terms of the GNU General Public License
+<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
 .PP
 This manual page was written by Stefan <[e-mail]>,
 for the Debian project (but may be used by others).
diff -urN piklab-0.15.4/man/piklab-coff.1 piklab-0.15.4.new/man/piklab-coff.1
--- piklab-0.15.4/man/piklab-coff.1	1970-01-01 01:00:00.000000000 +0100
+++ piklab-0.15.4.new/man/piklab-coff.1	2009-03-30 15:08:46.000000000 +0200
@@ -0,0 +1,155 @@
+.\" Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.TH "PIKLAB" "1" "January 25, 2008" "" ""
+.SH "NAME"
+piklab\-coff \- Command\-line utility to view COFF files.
+
+.SH "SYNOPSIS"
+.B piklab\-coff [Qt\-options] [KDE\-options] [options] [file]
+
+.SH "DESCRIPTION"
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+\fBPiklab\-coff\fP is a command line tool to view COFF files.
+
+.SH "OPTIONS"
+This program follows the usual GNU command line syntax, with long
+options starting with two dashes ('\-').
+A summary of options is included below.
+.TP
+.B GENERIC OPTIONS:
+.TP
+.B \-h, \-\-help
+Show summary of options.
+.TP
+.B \-\-help\-qt
+Show Qt specific options.
+.TP
+.B \-\-help\-kde
+Show KDE specific options.
+.TP
+.B \-\-help\-all
+Show all options.
+.TP
+.B \-\-author
+Show author information.
+.TP
+.B \-v, \-\-version
+Show version information.
+.TP
+.B \-\-license
+Show license information.
+.TP
+.B \-\-
+End of options.
+
+.br
+.TP
+.B SPECIFIC OPTIONS:
+.TP
+.B \-c, \-\-command <name>
+Perform the requested command.
+.TP
+.B \-\-command\-list
+Return the list of recognized commands.
+.TP
+.B \-\-debug
+Display debug messages.
+.TP
+.B \-\-extra\-debug
+Display extra debug messages.
+.TP
+.B \-\-max\-debug
+Display all debug messages.
+.TP
+.B \-\-lowlevel\-debug
+Display low level debug messages.
+.TP
+.B \-\-quiet
+Do not display messages.
+.TP
+.B \-f, \-\-force
+Overwrite files and answer "yes" to questions.
+.TP
+.B \-d, \-\-device <name>
+Target device.
+.TP
+.B \-\-device\-list
+Return the list of supported devices.
+
+.br
+.TP
+.B SUPPORTED COMMANDS:
+.TP
+.B info
+Return general informations.
+.TP
+.B variables
+Return informations about variables (for object).
+.TP
+.B symbols
+Return informations about symbols.
+.TP
+.B sections
+Return informations about sections (for object).
+.TP
+.B lines
+Return informations about code lines (for object).
+.TP
+.B files
+Return informations about files.
+
+.br
+.TP
+.B ARGUMENTS:
+.TP
+.B file
+COFF filename.
+
+.SH "SEE ALSO"
+.BR piklab (1),
+.BR piklab\-prog (1),
+.BR piklab\-hex (1).
+
+.SH "AUTHORS"
+Piklab was written by Nicolas Hadacek and many others, including:
+    * Alain Gibaud: author of Pikdev; main infrastructure; IDE interface; direct programmers; gputils integration.
+    * Keith Baker: direct programmer support for 16F7X devices.
+    * Xiaofan Chen: numerous tests of PICkit1/2 and ICD2 programmers.
+    * Craig Franklin: author of gputils (disassembler and coff parser).
+    * Manwlis Giannos: direct programmer support for PIC18FXX2/FXX8 devices.
+    * Stephen Landamore: author of LPLAB (microchip command\-line programmer).
+    * Brian C. Lane: original code for direct programming.
+    * Sébastion Laoût: author of Likeback.
+    * Nestor A. Marchesini: tests of PicStart+ programmer.
+    * Lorenz Mösenlechner and Matthias Kranz: USB support for ICD2 programmer.
+    * Mirko Panciri: direct programmers with bidirectionnal buffers.
+    * Sean A. Walberg: direct programmer support for 16F676/630 devices.
+
+.B Translations:
+    * Michele Petrecca: Italian translation.
+    * Alain Portal: French translation.
+    * Stefan von Halenbach: German translation.
+    * Nagy Lázló: Hungarian translation.
+
+.SH "COPYRIGHT"
+This is free software. You may redistribute copies of it under the terms of the GNU General Public License
+<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
+.PP
+This manual page was written by Miriam Ruiz <[e-mail]>,
+for the Debian project (but may be used by others).
diff -urN piklab-0.15.4/man/piklab-hex.1 piklab-0.15.4.new/man/piklab-hex.1
--- piklab-0.15.4/man/piklab-hex.1	2008-11-22 16:19:46.000000000 +0100
+++ piklab-0.15.4.new/man/piklab-hex.1	2009-03-30 15:14:58.000000000 +0200
@@ -1,8 +1,7 @@
-.\"                                      Hey, EMACS: -*- nroff -*-
+.\" Hey, EMACS: -*- nroff -*-
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH PIKLAB SECTION "April 11, 2007"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -15,65 +14,132 @@
 .\" .br        insert line break
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
-.SH PIKLAB-HEX \- Tool to check INHEX-files.
-.SH SYNOPSIS
-.B piklab-hex [options] [command] [file].hex
-.RI
+.TH "PIKLAB" "1" "April 11, 2007" "" ""
+.SH "NAME"
+piklab\-hex \- Tool to check INHEX\-files.
 
-.SH DESCRIPTION
-
-This manual page documents briefly the
-.B piklab-hex command.
+.SH "SYNOPSIS"
+.B piklab\-hex [Qt\-options] [KDE\-options] [options] [file]
 
+.SH "DESCRIPTION"
 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
 .\" \fI<whatever>\fP escape sequences to invode bold face and italics,
 .\" respectively.
-\fBPiklab-hex\fP is a command line tool to check files, if they are valid Hex-files which comply with the INHEX-Standard defined by Intel corporation.
+\fBPiklab\-hex\fP is a command line tool to check files, if they are valid Hex\-files which comply with the INHEX\-Standard defined by Intel corporation.
 
-.SH OPTIONS
+.SH "OPTIONS"
 This program follows the usual GNU command line syntax, with long
-options starting with two dashes (`-').
+options starting with two dashes ('\-').
 A summary of options is included below.
 .TP
+.B GENERIC OPTIONS:
+.TP
 .B \-h, \-\-help
-	Show summary of options.
+Show summary of options.
 .TP
-.B \-v, \-\-version
-	Show version of program.
+.B \-\-help\-qt
+Show Qt specific options.
+.TP
+.B \-\-help\-kde
+Show KDE specific options.
+.TP
+.B \-\-help\-all
+Show all options.
 .TP
 .B \-\-author
-	Show author information
+Show author information.
+.TP
+.B \-v, \-\-version
+Show version information.
 .TP
 .B \-\-license
-	Show license information
+Show license information.
+.TP
+.B \-\-
+End of options.
+
+.br
+.TP
+.B SPECIFIC OPTIONS:
+.TP
+.B \-c, \-\-command <name>
+Perform the requested command.
+.TP
+.B \-\-command\-list
+Return the list of recognized commands.
+.TP
+.B \-\-debug
+Display debug messages.
+.TP
+.B \-\-extra\-debug
+Display extra debug messages.
+.TP
+.B \-\-max\-debug
+Display all debug messages.
 .TP
-.B \-c [command]
-	Option to issue a command.
+.B \-\-lowlevel\-debug
+Display low level debug messages.
 .TP
-.SH COMMANDS
+.B \-\-quiet
+Do not display messages.
 .TP
-.B check		Check file, if it is a valid intel-hex-file.
+.B \-f, \-\-force
+Overwrite files and answer "yes" to questions.
 .TP
-.B info			Return information about hex file.
+.B \-d, \-\-device <name>
+Target device.
 .TP
-.B fix			Clean hex file and fix errors (wrong CRC, truncated line, truncated file).
+.B \-\-device\-list
+Return the list of supported devices.
 .TP
-.B compare		Compare two hex files.
+.B \-\-fill <value>
+Fill option.
 .TP
+.B \-\-fill\-list
+Return the list of supported fill options.
+
 .br
-.sp 3
-.SH SEE ALSO
-.BR piklab (1),
-.BR piklab-prog (1),
+.TP
+.B SUPPORTED COMMANDS:
+.TP
+.B check
+Check hex file for correctness (if a device is specified, check if hex file is compatible with it).
+.TP
+.B info
+Return information about hex file.
+.TP
+.B fix
+Clean hex file and fix errors (wrong CRC, truncated line, truncated file).
+.TP
+.B compare
+Compare two hex files.
+.TP
+.B checksum
+Return checksum.
+.TP
+.B create
+Create an hex file for the specified device.
+
 .br
-.SH AUTHORS
-piklab was written by Nicolas Hadacek and many others, including:
+.TP
+.B ARGUMENTS:
+.TP
+.B file
+HEX filename(s).
+
+.SH "SEE ALSO"
+.BR piklab (1),
+.BR piklab\-prog (1),
+.BR piklab\-coff (1).
+
+.SH "AUTHORS"
+Piklab was written by Nicolas Hadacek and many others, including:
     * Alain Gibaud: author of Pikdev; main infrastructure; IDE interface; direct programmers; gputils integration.
     * Keith Baker: direct programmer support for 16F7X devices.
     * Xiaofan Chen: numerous tests of PICkit1/2 and ICD2 programmers.
     * Craig Franklin: author of gputils (disassembler and coff parser).
     * Manwlis Giannos: direct programmer support for PIC18FXX2/FXX8 devices.
-    * Stephen Landamore: author of LPLAB (microchip command-line programmer).
+    * Stephen Landamore: author of LPLAB (microchip command\-line programmer).
     * Brian C. Lane: original code for direct programming.
     * Sébastion Laoût: author of Likeback.
     * Nestor A. Marchesini: tests of PicStart+ programmer.
@@ -86,11 +152,10 @@
     * Alain Portal: French translation.
     * Stefan von Halenbach: German translation.
     * Nagy Lázló: Hungarian translation.
-.sp 3
-.SH COPYRIGHT
-	This  is  free  software.   You  may  redistribute  copies  of  it  under  the  terms   of   the   GNU   General   Public   License
-       	<http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to the extent permitted by law.
 
+.SH "COPYRIGHT"
+This is free software. You may redistribute copies of it under the terms of the GNU General Public License
+<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
 .PP
 This manual page was written by Stefan <[e-mail]>,
 for the Debian project (but may be used by others).
diff -urN piklab-0.15.4/man/piklab-prog.1 piklab-0.15.4.new/man/piklab-prog.1
--- piklab-0.15.4/man/piklab-prog.1	2008-11-22 16:19:46.000000000 +0100
+++ piklab-0.15.4.new/man/piklab-prog.1	2009-03-30 15:06:40.000000000 +0200
@@ -1,8 +1,7 @@
-.\"                                      Hey, EMACS: -*- nroff -*-
+.\" Hey, EMACS: -*- nroff -*-
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH PIKLAB SECTION "April 11, 2007"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -15,131 +14,174 @@
 .\" .br        insert line break
 .\" .sp <n>    insert n+1 empty lines
 .\" for manpage-specific macros, see man(7)
-.SH PIKLAB-PROG \- Commandline program for PIC-microcontroller programming.
-.SH SYNOPSIS
-.B piklab-prog [Qt-options] [KDE-options] [options] [file]
-.RI
+.TH "PIKLAB" "1" "April 11, 2007" "" ""
+.SH "NAME"
+piklab\-prog \- Commandline program for PIC\-microcontroller programming.
 
-.br
-.SH DESCRIPTION
-This manual page documents briefly the
-.B piklab-prog command.
-.PP
+.SH "SYNOPSIS"
+.B piklab\-prog [Qt\-options] [KDE\-options] [options] [file]
+
+.SH "DESCRIPTION"
 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
 .\" \fI<whatever>\fP escape sequences to invode bold face and italics,
 .\" respectively.
-\fBPiklab-prog\fP is a command line tool, which can be used to program microcontrollers with program and data, stored in a HEX-file to a connected programmer. It supports the most common serial, parallel and usb programmers, like  ICD2, Pickit2, PicStart+) and debuggers (ICD2).
+\fBPiklab\-prog\fP is a command line tool, which can be used to program microcontrollers with program and data, stored in a HEX\-file to a connected programmer. It supports the most common serial, parallel and usb programmers, like  ICD2, Pickit2, PicStart+) and debuggers (ICD2).
 
-.SH OPTIONS
+.SH "OPTIONS"
 This program follows the usual GNU command line syntax, with long
-options starting with two dashes (`-').
+options starting with two dashes ('\-').
 A summary of options is included below.
 .TP
-.B \-h, \-\-help
-	Show summary of options.
+.B GENERIC OPTIONS:
 .TP
-.B \-v, \-\-version
-	Show version of program.
+.B \-h, \-\-help
+Show summary of options.
 .TP
-.B \-\-help-qt
-	Show Qt specific options
+.B \-\-help\-qt
+Show Qt specific options.
 .TP
-.B \-\-help-kde
-	Show KDE specific options
+.B \-\-help\-kde
+Show KDE specific options.
 .TP
-.B \-\-help-all
-	Show all options
+.B \-\-help\-all
+Show all options.
 .TP
 .B \-\-author
-	Show author information
+Show author information.
+.TP
+.B \-v, \-\-version
+Show version information.
 .TP
 .B \-\-license
-	Show license information
+Show license information.
 .TP
 .B \-\-
-	End of options
+End of options.
+
 .br
-.B Options:
+.TP
+.B SPECIFIC OPTIONS:
+.TP
 .B \-c, \-\-command <name>
-	Perform the requested command.
+Perform the requested command.
 .TP
-.B \-\-command-list
-	Return the list of recognized commands.
+.B \-\-command\-list
+Return the list of recognized commands.
 .TP
 .B \-\-debug
-	Display debug messages.
+Display debug messages.
+.TP
+.B \-\-extra\-debug
+Display extra debug messages.
 .TP
-.B \-\-extra-debug
-	Display extra debug messages.
+.B \-\-max\-debug
+Display all debug messages.
 .TP
-.B \-\-max-debug
-	Display all debug messages.
+.B \-\-lowlevel\-debug
+Display low level debug messages.
 .TP
 .B \-\-quiet
-	Do not display messages.
+Do not display messages.
 .TP
 .B \-f, \-\-force
-	Overwrite files and answer "yes" to questions.
+Overwrite files and answer "yes" to questions.
 .TP
 .B \-i, \-\-cli
-	Interactive mode
+Interactive mode.
 .TP
 .B \-r, \-\-range <name>
-	Memory range to operate on.
+Memory range to operate on.
 .TP
-.B \-\-range-list
-	Return the list of memory ranges.
+.B \-\-range\-list
+Return the list of memory ranges.
 .TP
 .B \-p, \-\-programmer <name>
-	Programmer to use.
+Programmer to use.
 .TP
-.B \-\-programmer-list
-	Return the list of supported programmers.
+.B \-\-programmer\-list
+Return the list of supported programmers.
+.TP
+.B \-h, \-\-hardware <name>
+Programmer hardware configuration to use (for direct programmer).
+.TP
+.B \-\-hardware\-list
+Return the list of supported programmer hardware configurations.
 .TP
 .B \-d, \-\-device <name>
-	Target device.
+Target device.
 .TP
-.B \-\-device-list
-	Return the list of supported devices.
+.B \-\-device\-list
+Return the list of supported devices.
 .TP
 .B \-f, \-\-format <name>
-	HEX output file format.
+HEX output file format.
 .TP
-.B \-\-format-list
-	Return the list of supported HEX file formats.
+.B \-\-format\-list
+Return the list of supported HEX file formats.
 .TP
 .B \-t, \-\-port <name>
-	Programmer port ("usb" or device such as "/dev/ttyS0")
+Programmer port ("usb" or device such as "/dev/ttyS0").
 .TP
-.B \-\-port-list
-	Return the list of detected ports.
+.B \-\-port\-list
+Return the list of detected ports.
 .TP
-.B \-\-firmware-dir <dir>
-	Firmware directory.
+.B \-\-firmware\-dir <dir>
+Firmware directory.
 .TP
-.B \-\-target-self-powered
-	Indicates that device is self-powered.
-.br
-.SH Arguments:
-.B file  <HEX-filename for programming>.
+.B \-\-target\-self\-powered <true|false>
+Set if target device is self-powered.
+
 .br
-.sp 2
-.SH SEE ALSO
-.BR piklab-prog (1),
-.BR piklab-hex (1),
-.BR gputils (1),
-.BR sdcc (1).
+.TP
+.B SUPPORTED COMMANDS:
+.TP
+.B connect
+Connect programmer.
+.TP
+.B run
+Run device (release reset).
+.TP
+.B stop
+Stop device (hold reset).
+.TP
+.B program
+Program device memory: "program <hexfilename>".
+.TP
+.B verify
+Verify device memory: "verify <hexfilename>".
+.TP
+.B read
+Read device memory: "read <hexfilename>".
+.TP
+.B erase
+Erase device memory.
+.TP
+.B blank_check
+Blank check device memory.
+.TP
+.B upload_firmware
+Upload firmware to programmer: "upload_firmware <hexfilename>".
+
 .br
-.SH AUTHORS
-piklab was written by Nicolas Hadacek and many others, including:
+.TP
+.B ARGUMENTS:
+.TP
+.B file
+HEX filename for programming.
 
-    * Alain Gibaud: author of Pikdev; main infrastructure; IDE interface; direct programmers; gputils integration.
+.SH "SEE ALSO"
+.BR piklab (1),
+.BR piklab\-hex (1),
+.BR piklab\-coff (1).
 
+.SH "AUTHORS"
+Piklab was written by Nicolas Hadacek and many others, including:
+    * Alain Gibaud: author of Pikdev; main infrastructure; IDE interface; direct programmers; gputils integration.
     * Keith Baker: direct programmer support for 16F7X devices.
     * Xiaofan Chen: numerous tests of PICkit1/2 and ICD2 programmers.
     * Craig Franklin: author of gputils (disassembler and coff parser).
     * Manwlis Giannos: direct programmer support for PIC18FXX2/FXX8 devices.
-    * Stephen Landamore: author of LPLAB (microchip command-line programmer).
+    * Stephen Landamore: author of LPLAB (microchip command\-line programmer).
     * Brian C. Lane: original code for direct programming.
     * Sébastion Laoût: author of Likeback.
     * Nestor A. Marchesini: tests of PicStart+ programmer.
@@ -152,11 +194,10 @@
     * Alain Portal: French translation.
     * Stefan von Halenbach: German translation.
     * Nagy Lázló: Hungarian translation.
-.sp 2
-.SH COPYRIGHT
-	This  is  free  software.   You  may  redistribute  copies  of  it  under  the  terms   of   the   GNU   General   Public   License
-       	<http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to the extent permitted by law.
 
+.SH "COPYRIGHT"
+This is free software. You may redistribute copies of it under the terms of the GNU General Public License
+<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
 .PP
 This manual page was written by Stefan <[e-mail]>,
 for the Debian project (but may be used by others).