From 3d0e326b2fdb3d1b72e34aca01aab87ca88a4aa1 Mon Sep 17 00:00:00 2001
From: Stefan Rueger <stefan.rueger@urclocks.com>
Date: Thu, 18 Jun 2026 12:48:04 +0100
Subject: [PATCH] Document changed -P parsing for PICKit5 programmers

---
 src/avrdude.1        | 10 +++++-----
 src/doc/avrdude.texi | 14 +++++++-------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/src/avrdude.1 b/src/avrdude.1
index 9e2a5ff6..347ec1d9 100644
--- a/src/avrdude.1
+++ b/src/avrdude.1
@@ -698,12 +698,12 @@ For examples, see the respective
 .Em Troubleshooting
 entry in the detailed pdf documentation.
 .Pp
-The -c pickit5 programmer allows overriding the product ID with a
-hexadecimal number <pid> using -P usb::<pid> and the vendor and product
-IDs with hexadecimal numbers <vid> and <pid> using -P usb:<vid>:<pid>. The
+The -c pickit5 programmer allows overriding the vendor and product IDs
+with hexadecimal numbers <vid> and <pid> using -P usb:<vid>:<pid>. The
 form -P usb:<serialno> requests AVRDUDE select the PICkit5 programmer with
-a serial number that ends in <serialno> (and with vid/pid from the
-configuration files).
+a serial number that ends in <serialno> and with vid/pid from the
+configuration files. It is also possible to override vid/pid and require a
+serialno match via -P usb:<vid>:<pid>:<serialno>.
 .Pp
 For the XBee programmer the target MCU is to be programmed wirelessly over a
 ZigBee mesh using the XBeeBoot bootloader.  The ZigBee 64-bit address for the
diff --git a/src/doc/avrdude.texi b/src/doc/avrdude.texi
index 2a98217e..f225bfc7 100644
--- a/src/doc/avrdude.texi
+++ b/src/doc/avrdude.texi
@@ -889,13 +889,13 @@ usb:@var{serialno}}. The USBasp serial number is matched from the end, so
 only the unique least significant bytes are needed. For examples, see the
 respective entry in @ref{Troubleshooting}.
 
-The @code{-c pickit5} programmer allows overriding the product ID with a
-hexadecimal number @var{pid} using @code{-P usb::@var{pid}} and the vendor
-and product IDs with hexadecimal numbers @var{vid} and @var{pid} using
-@code{-P usb:@var{vid}:@var{pid}}. The form @code{-P usb:@var{serialno}}
-requests AVRDUDE select the PICkit5 programmer with a serial number that
-ends in @var{serialno} (and with @var{vid}/@var{pid} from the
-configuration files).
+The @code{-c pickit5} programmer allows overriding the vendor and product
+IDs with hexadecimal numbers @var{vid} and @var{pid} using @code{-P
+usb:@var{vid}:@var{pid}}. The form @code{-P usb:@var{serialno}} requests
+AVRDUDE select the PICkit5 programmer with a serial number that ends in
+@var{serialno} and with @var{vid}/@var{pid} from the configuration files.
+It is also possible to override @var{vid}/@var{pid} and require a
+@var{serialno} match via @code{-P usb:@var{vid}:@var{pid}:@var{serialno}}.
 
 For the XBee programmer the target MCU is to be programmed wirelessly
 over a ZigBee mesh using the XBeeBoot bootloader.  The ZigBee 64-bit