From 658b4aa1e9ce252ee32621dffbd10f01576a77a3 Mon Sep 17 00:00:00 2001
From: stefanrueger <stefan.rueger@urclocks.com>
Date: Tue, 28 Jul 2026 04:01:54 +0200
Subject: [PATCH] Document default_port programmer property

---
 src/avrdude.conf.in  | 11 ++++++-----
 src/doc/avrdude.texi | 29 +++++++++++++++--------------
 2 files changed, 21 insertions(+), 19 deletions(-)

diff --git a/src/avrdude.conf.in b/src/avrdude.conf.in
index 91ca5953..096a93aa 100644
--- a/src/avrdude.conf.in
+++ b/src/avrdude.conf.in
@@ -28,7 +28,8 @@ avrdude_conf_version = "@AVRDUDE_FULL_VERSION@";
 #       is_serialadapter = <yes|no>               # programmer is also a serialadapter
 #       extra_features = HAS_<fea> {| HAS_<fea>}  # extra features, eg, HAS_SUFFER (2)
 #       connection_type = parallel | serial | usb | spi
-#       baudrate = <num> ;                        # baudrate for avr910-programmer
+#       default_port = <port>                     # default port, quoted string
+#       baudrate = <num> ;                        # baudrate for the programmer
 #       vcc      = <pin1> [, <pin2> ... ] ;       # pin number(s) (3)
 #       buff     = <pin1> [, <pin2> ... ] ;       # pin number(s)
 #       reset    = <pin> ;                        # pin number
@@ -46,9 +47,9 @@ avrdude_conf_version = "@AVRDUDE_FULL_VERSION@";
 #       usbvid   = <hexnum> ;                     # USB vendor ID
 #       usbpid   = <hexnum> [, <hexnum> ...] ;    # USB product ID (4)
 #       usbdev   = <interface> ;                  # USB interface or other device info
-#       usbvendor = <vendorname> ;                # USB Vendor Name
-#       usbproduct = <productname> ;              # USB Product Name
-#       usbsn    = <serialno> ;                   # USB Serial Number
+#       usbvendor = <vendorname> ;                # USB vendor name
+#       usbproduct = <productname> ;              # USB product name
+#       usbsn    = <serialno> ;                   # USB serial number
 #       hvupdi_support = <num> [, <num>, ... ] ;  # HV support for enabling UPDI
 #   ;
 #
@@ -97,7 +98,7 @@ avrdude_conf_version = "@AVRDUDE_FULL_VERSION@";
 #       baudrate = <num> ;                        # optional default baudrate, eg, in .avrduderc
 #       usbvid   = <hexnum> ;                     # USB vendor ID
 #       usbpid   = <hexnum> [, <hexnum> ...] ;    # list of USB product IDs
-#       usbsn    = <serialno> ;                   # USB Serial Number in per-user .avrduderc
+#       usbsn    = <serialno> ;                   # USB serial number in per-user .avrduderc
 #   ;
 #
 #   part
diff --git a/src/doc/avrdude.texi b/src/doc/avrdude.texi
index 27dc87fc..d1ef8714 100644
--- a/src/doc/avrdude.texi
+++ b/src/doc/avrdude.texi
@@ -3793,7 +3793,8 @@ programmer
     is_serialadapter = <yes|no>              # programmer is also a serialadapter
     extra_features = HAS_<fea> @{| HAS_<fea>@}  # extra features, e.g., HAS_SUFFER (2)
     connection_type = parallel | serial | usb | spi
-    baudrate = <num>;                        # baudrate for avr910-programmer
+    default_port = <port>                    # default port, quoted string
+    baudrate = <num>;                        # baudrate for the programmer
     vcc      = <pin1> [, <pin2> ... ];       # pin number(s) (3)
     buff     = <pin1> [, <pin2> ... ];       # pin number(s)
     reset    = <pin>;                        # pin number
@@ -3811,35 +3812,35 @@ programmer
     usbvid   = <hexnum>;                     # USB vendor ID
     usbpid   = <hexnum> [, <hexnum> ...];    # USB product ID (4)
     usbdev   = <interface>;                  # USB interface or other device info
-    usbvendor = <vendorname>;                # USB Vendor Name
-    usbproduct = <productname>;              # USB Product Name
-    usbsn    = <serialno>;                   # USB Serial Number
+    usbvendor = <vendorname>;                # USB vendor name
+    usbproduct = <productname>;              # USB product name
+    usbsn    = <serialno>;                   # USB serial number
     hvupdi_support = <num> [, <num>, ... ];  # HV support for enabling UPDI
 ;
 @end smallexample
 
 @noindent
 If a parent is specified, all settings of it (except its ids) are used for the new
-programmer. These values can be changed by new setting them for the new programmer.
+programmer. These values can be changed by setting them for the new programmer.
 
 @noindent
 Programmer definitions can be modified using the following syntax
 @smallexample
 modify programmer <id>
     # Any property as above, for example
-    baudrate = <num>;                        # baudrate for the programmer
-    usbsn    = <serialno>;                   # USB Serial Number
+    default_port = <port>                    # default port, quoted string
+    usbsn    = <serialno>;                   # USB serial number
 ;
 @end smallexample
 
 @noindent
 The @code{modify} keyword makes most sense in the per-user configuration
-file, where users may want to add specific properties of their programmer
-such as its USB serial number. This technique should not be used for the
-main @code{avrdude.conf} file, as the developer option @code{-c
-<programmer>/S} that prints the programmer definition as AVRDUDE
-understands it will only consider the final definition; it will not print
-@code{modify} statements.
+file, where users may want to add specific properties of their programmer.
+This could be its USB serial number or default port, eg, a serialadapter
+such as @code{"ch340"}. This technique should not be used for the main
+@code{avrdude.conf} file, as the developer option @code{-c <programmer>/S}
+that prints the programmer definition as AVRDUDE understands it will only
+consider the final definition; it will not print @code{modify} statements.
 
 @noindent
 @strong{Notes}
@@ -3953,7 +3954,7 @@ serialadapter
     baudrate = <num>;                         # optional default baudrate, eg, in .avrduderc
     usbvid   = <hexnum>;                      # USB vendor ID
     usbpid   = <hexnum> [, <hexnum> ...];     # list of USB product IDs
-    usbsn    = <serialno>;                    # USB Serial Number in per-user .avrduderc
+    usbsn    = <serialno>;                    # USB serial number in per-user .avrduderc
 ;
 @end smallexample