Add long options like --part

src/avrdude.1

@@ -25,33 +25,32 @@
 .Nd driver program for ``simple'' Atmel AVR MCU programmer
 .Sh SYNOPSIS
 .Nm
-.Fl p Ar partno
-.Op Fl b Ar baudrate
-.Op Fl r
-.Op Fl B Ar bitclock
-.Op Fl c Ar programmer-id
-.Op Fl C Ar config-file
-.Op Fl N
+.Op Fl p, \-part Ar partno
+.Op Fl b, \-baud Ar baudrate
+.Op Fl B, \-bitclock Ar bitclock
+.Op Fl c, \-programmer Ar programmer-id
+.Op Fl C, \-config Ar config-file
+.Op Fl N, \-noconfig
 .Op Fl A
-.Op Fl D
-.Op Fl e
+.Op Fl D, \-noerase
+.Op Fl e, \-erase
 .Oo Fl E Ar exitspec Ns
 .Op \&, Ns Ar exitspec
 .Oc
 .Op Fl F
 .Op Fl i Ar delay
-.Op Fl l Ar logfile
-.Op Fl n
-.Op Fl O
-.Op Fl P Ar port
-.Op Fl r
-.Op Fl q
+.Op Fl l, \-logfile Ar logfile
+.Op Fl n, \-test
+.Op Fl O, \-osccal 
+.Op Fl P, \-port Ar port
+.Op Fl r, \-reconnect
+.Op Fl q, \-quell
 .Op Fl T Ar cmd
-.Op Fl t
-.Op Fl U Ar memory:op:filename:filefmt
-.Op Fl v
+.Op Fl t, \-terminal
+.Op Fl U, \-memory Ar memory:op:filename:filefmt
+.Op Fl v, \-verbose
 .Op Fl x Ar extended_param
-.Op Fl V
+.Op Fl V, \-noverify
 .Sh DESCRIPTION
 .Nm Avrdude
 is a program for downloading and uploading on-chip memories of Atmel AVR
@@ -326,7 +325,7 @@ In order to control all the different operation modi, a number of options
 need to be specified to
 .Nm avrdude .
 .Bl -tag -offset indent -width indent
-.It Fl p Ar partno
+.It Fl p \-part Ar partno
 This option specifies the MCU connected to the programmer. The MCU
 descriptions are read from the config file. To see a list of currently
 supported MCUs use ? as partno, which will print the part ids and official
@@ -351,35 +350,34 @@ programmers talking the STK500v2 protocol.
 .It "AT90S2343"
 The AT90S2323 and ATtiny22 use the same algorithm.
 .It "ATmega2560, ATmega2561"
-Flash addressing above 128 KB is not supported by all
-programming hardware.  Known to work are jtag2, stk500v2,
-and bit-bang programmers.
+Flash addressing above 128 KB may not be supported by all
+programming hardware.
 .It "ATtiny11"
 The ATtiny11 can only be
 programmed in high-voltage serial mode.
 .El
-.It Fl p Ar wildcard/flags
+.It Fl p \-part Ar wildcard/flags
 Run developer options for MCUs that are matched by wildcard. Whilst
 their main use is for developers some flags can be of utility for users, e.g.,
 avrdude -p m328p/S outputs AVRDUDE's understanding of ATmega328P MCU properties;
 for more information run avrdude -p x/h.
-.It Fl b Ar baudrate
+.It Fl b \-baud Ar baudrate
 Override the RS-232 connection baud rate specified in the respective
 programmer's entry of the configuration file or defined by the default_baudrate
 entry in your user configuration file
 .Pa ${HOME}/.config/avrdude/avrdude.rc
 or
 .Pa ${HOME}/.avrduderc
 if no baudrate was defined for this programmer.
-.It Fl r
+.It Fl r \-reconnect
 Opens the serial port at 1200 baud and immediately closes it, waits 400 ms
 for each -r on the command line and then establishes communication with
 the programmer. This is commonly known as a "1200bps touch", and is used
 to trigger programming mode for certain boards like Arduino Leonardo,
 Arduino Micro/Pro Micro and the Arduino Nano Every. Longer waits, and
 therefore multiple -r options, are sometimes needed for slower, less
 powerful hosts.
-.It Fl B Ar bitclock
+.It Fl B \-bitclock
 Specify the bit clock period for the JTAG, PDI, TPI, UPDI, or ISP
 interface. The value is a floating-point number in microseconds.
 Alternatively, the value might be suffixed with "Hz", "kHz" or
@@ -404,7 +402,7 @@ will continue to use it until a different value is provided. This applies to
 "3rd gen"programmers (JTAGICE3, Atmel ICE, Power Debugger). "4th gen"
 programmers (PICkit 4, MPLAB SNAP) will store the last user-specified bitclock
 until the programmer is disconnected from the computer.
-.It Fl c Ar programmer-id
+.It Fl c \-programmer Ar programmer-id
 Use the programmer specified by the argument.  Programmers and their pin
 configurations are read from the config file (see the
 .Fl C
@@ -426,12 +424,12 @@ If -c ? is specified with a specific part, see
 to be able to handle this part, together with the programming interface(s) that can be
 used in that combination. In reality there can be deviations from this list,
 particularly if programming is directly via a bootloader.
-.It Fl c Ar wildcard/flags
+.It Fl c \-programmer Ar wildcard/flags
 Run developer options for programmers that are matched by wildcard. Whilst
 their main use is for developers some flags can be of utility for users, e.g.,
 avrdude -c usbtiny/S shows AVRDUDE's understanding of usbtiny's properties;
 for more information run avrdude -c x/h.
-.It Fl C Ar config-file
+.It Fl C \-config Ar config-file
 Use the specified config file to load configuration data.  This file
 contains all programmer and part definitions that
 .Nm avrdude
@@ -449,7 +447,7 @@ files. This can be used to add entries to the configuration
 without patching your system wide configuration file. It can be used
 several times, the files are read in same order as given on the command
 line.
-.It Fl N
+.It Fl N \-noconfig
 Do not load the personal configuration file that is usually located at
 ~/.config/avrdude/avrdude.rc, ~/.avrduderc or in the same directory as the
 avrdude executable
@@ -467,9 +465,9 @@ Arduino bootloaders exhibit this behaviour; for this reason
 is engaged by default when specifying
 . Fl c
 arduino.
-.It Fl D
+.It Fl D \-noerase
 Disable auto-erase for flash. When the
-.Fl U
+.Fl U \-memory
 option for writing to any flash memory is specified,
 .Nm
 will perform a chip erase before starting any of the programming
@@ -482,7 +480,7 @@ operation will retain its previous contents. Setting
 .Fl D
 implies
 .Fl A.
-.It Fl e
+.It Fl e \-erase
 Causes a chip erase to be executed. This will reset the contents of the
 flash ROM and EEPROM to the value
 .Ql 0xff ,
@@ -572,7 +570,7 @@ is running.
 On Win32 operating systems, a preconfigured number of cycles per
 microsecond is assumed that might be off a bit for very fast or very
 slow machines.
-.It Fl l Ar logfile
+.It Fl l \-logfile Ar logfile
 Use
 .Ar logfile
 rather than
@@ -582,18 +580,18 @@ Note that initial diagnostic messages (during option parsing) are still
 written to
 .Va stderr
 anyway.
-.It Fl n
+.It Fl n \-test
 No-write: disables writing data to the MCU whilst processing -U
 (useful for debugging
 .Nm avrdude
 ). The terminal mode continues to write to the device.
-.It Fl O
+.It Fl O \-osccal
 Perform an RC oscillator run-time calibration according to Atmel
 application note AVR053.
 This is only supported on the STK500v2, AVRISP mkII, and JTAG ICE mkII
 hardware.
 Note that the result will be stored in the EEPROM cell at address 0.
-.It Fl P Ar port
+.It Fl P \-port Ar port
 Use
 .Ar port
 to identify the connection through which the programmer is attached. This
@@ -718,7 +716,7 @@ for a STK500.
 .Pp
 Note: The ability to handle IPv6 hostnames and addresses is limited to
 Posix systems (by now).
-.It Fl q
+.It Fl q \-quell
 Disable (or quell) output of the progress bar while reading or writing
 to the device.  Specify it more often for even quieter operations.
 .It Fl s, u
@@ -733,13 +731,13 @@ of terminal commands the argument
 .Ar cmd
 will most likely need to be set in quotes, see your OS shell manual for
 details. See below for a detailed description of all terminal commands.
-.It Fl t
+.It Fl t \-terminal
 Tells
 .Nm
 to run an interactive terminal when it is its turn in relation to
 other -t interactive terminals, -T terminal commands and -U memory
 operations.
-.It Xo Fl U Ar memory Ns
+.It Xo Fl U \-memory Ar memory Ns
 .Ar \&: Ns Ar op Ns
 .Ar \&: Ns Ar filename Ns
 .Op \&: Ns Ar format
@@ -928,12 +926,12 @@ This will only work if
 does not have a pair of colons in it that sandwich a single character
 as otherwise the first part might be interpreted as memory, and the single
 character as memory operation.
-.It Fl v
+.It Fl v \-verbose
 Enable verbose output.
 More
 .Fl v
 options increase verbosity level.
-.It Fl V
+.It Fl V \-noverify
 Disable automatic verify check when writing data to the AVR with -U.
 .It Fl x Ar extended_param
 Pass
@@ -2125,6 +2123,7 @@ This option will leave the 8 data pins on the parallel port active.
 This option will leave the 8 data pins on the parallel port inactive.
 .Pq \&i. \&e. Em low
 .El
+.El
 .Sh FILES
 .Bl -tag -offset indent -width /dev/ppi0XXX
 .It Pa /dev/ppi0
@@ -2191,7 +2190,9 @@ normal ISP communication.
 .Pp
 The AVR microcontroller product description can be found at
 .Pp
-.Dl "https://www.microchip.com/en-us/products/microcontrollers-and-microprocessors/8-bit-mcus/avr-mcus"
+.nf
+https://www.microchip.com/en-us/products/microcontrollers-and-microprocessors/8-bit-mcus/avr-mcus
+.fi
 .\" .Sh HISTORY
 .Sh AUTHORS
 .Nm Avrdude