[DOCs][Excellon] Warn about left/right digits

It will most probably go away.

Author: set-soft

docs/samples/generic_plot.kibot.yaml

@@ -1344,7 +1344,9 @@ outputs:
       exclude_filter: '_null'
       # [boolean=true] Generate drill files. Set to False and choose map format if only map is to be generated
       generate_drill_files: true
-      # [number=0] number of digits for integer part of coordinates (0 is auto)
+      # [number=0] number of digits for integer part of coordinates (0 is auto).
+      # Doesn't apply to DECIMAL_FORMAT.
+      # Default is 3 and currently can't be configured from the GUI, avoid using it
       left_digits: 0
       # [dict|string='None'] [hpgl,ps,gerber,dxf,svg,pdf,None] Format for a graphical drill map.
       # Not generated unless a format is specified.
@@ -1379,7 +1381,9 @@ outputs:
         # [string=''] Name of the drill report. Not generated unless a name is specified.
         # (%i='drill_report' %x='txt')
         filename: ''
-      # [number=0] number of digits for mantissa part of coordinates (0 is auto)
+      # [number=0] number of digits for mantissa part of coordinates (0 is auto).
+      # Doesn't apply to DECIMAL_FORMAT.
+      # Default is 3 and currently can't be configured from the GUI, avoid using it
       right_digits: 0
       # [boolean=true] Use route command for oval holes (G00), otherwise use G85
       route_mode_for_oval_holes: true

docs/source/configuration/outputs/ExcellonOptions.rst

@@ -22,6 +22,8 @@ ExcellonOptions parameters
 
 -  ``generate_drill_files`` :index:`: <pair: output - excellon - options; generate_drill_files>` [:ref:`boolean <boolean>`] (default: ``true``) Generate drill files. Set to False and choose map format if only map is to be generated.
 -  ``left_digits`` :index:`: <pair: output - excellon - options; left_digits>` [:ref:`number <number>`] (default: ``0``) number of digits for integer part of coordinates (0 is auto).
+   Doesn't apply to DECIMAL_FORMAT. |br|
+   Default is 3 and currently can't be configured from the GUI, avoid using it.
 -  ``map`` :index:`: <pair: output - excellon - options; map>`  [:ref:`DrillMap parameters <DrillMap>`] [:ref:`dict <dict>` | :ref:`string <string>`] (default: ``'None'``) (choices: "hpgl", "ps", "gerber", "dxf", "svg", "pdf", "None") Format for a graphical drill map.
    Not generated unless a format is specified. |br|
    KiCad 10 doesn't support HPGL.
@@ -35,6 +37,8 @@ ExcellonOptions parameters
 -  ``pth_id`` :index:`: <pair: output - excellon - options; pth_id>` [:ref:`string <string>`] Force this replacement for %i when generating PTH and unified files.
 -  ``report`` :index:`: <pair: output - excellon - options; report>`  [:ref:`DrillReport parameters <DrillReport>`] [:ref:`dict <dict>` | :ref:`string <string>`] (default: ``''``) Name of the drill report. Not generated unless a name is specified.
 -  ``right_digits`` :index:`: <pair: output - excellon - options; right_digits>` [:ref:`number <number>`] (default: ``0``) number of digits for mantissa part of coordinates (0 is auto).
+   Doesn't apply to DECIMAL_FORMAT. |br|
+   Default is 3 and currently can't be configured from the GUI, avoid using it.
 -  ``route_mode_for_oval_holes`` :index:`: <pair: output - excellon - options; route_mode_for_oval_holes>` [:ref:`boolean <boolean>`] (default: ``true``) Use route command for oval holes (G00), otherwise use G85.
 -  ``table`` :index:`: <pair: output - excellon - options; table>`  [:ref:`DrillTable parameters <DrillTable>`] [:ref:`dict <dict>` | :ref:`string <string>`] (default: ``''``) Name of the drill table. Not generated unless a name is specified.
 -  ``use_aux_axis_as_origin`` :index:`: <pair: output - excellon - options; use_aux_axis_as_origin>` [:ref:`boolean <boolean>`] (default: ``false``) Use the auxiliary axis as origin for coordinates.

kibot/out_excellon.py

@@ -33,9 +33,13 @@ def __init__(self):
             self.zeros_format = 'DECIMAL_FORMAT'
             """ [DECIMAL_FORMAT,SUPPRESS_LEADING,SUPPRESS_TRAILING,KEEP_ZEROS] How to handle the zeros """
             self.left_digits = 0
-            """ number of digits for integer part of coordinates (0 is auto) """
+            """ number of digits for integer part of coordinates (0 is auto).
+                Doesn't apply to DECIMAL_FORMAT.
+                Default is 3 and currently can't be configured from the GUI, avoid using it """
             self.right_digits = 0
-            """ number of digits for mantissa part of coordinates (0 is auto) """
+            """ number of digits for mantissa part of coordinates (0 is auto).
+                Doesn't apply to DECIMAL_FORMAT.
+                Default is 3 and currently can't be configured from the GUI, avoid using it """
             self.route_mode_for_oval_holes = True
             """ Use route command for oval holes (G00), otherwise use G85 """
         self._ext = 'drl'