From 4d77056da1e1f8030be955820566a0192e8011d7 Mon Sep 17 00:00:00 2001
From: Matthias Koefferlein <matthias@klayout.de>
Date: Sun, 24 May 2026 00:11:57 +0200
Subject: [PATCH] For more clarity change 'snap to objects (unless disabled in
 template)' to 'never snap to object' (inverted) in rulers config.

---
 src/ant/ant/RulerConfigPage4.ui         | 6 +++---
 src/ant/ant/antConfigPage.cc            | 4 ++--
 src/doc/doc/manual/ruler_properties.xml | 6 +++---
 3 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/ant/ant/RulerConfigPage4.ui b/src/ant/ant/RulerConfigPage4.ui
index 1f5ec4a29..c732cebde 100644
--- a/src/ant/ant/RulerConfigPage4.ui
+++ b/src/ant/ant/RulerConfigPage4.ui
@@ -594,12 +594,12 @@
           </widget>
          </item>
          <item row="10" column="1">
-          <widget class="QCheckBox" name="t_snap_cbx">
+          <widget class="QCheckBox" name="t_never_snap_cbx">
            <property name="toolTip">
             <string>If checked, snap to edges or vertices of objects unless disabled above</string>
            </property>
            <property name="text">
-            <string>Snap to objects</string>
+            <string>Never snap to objects</string>
            </property>
           </widget>
          </item>
@@ -893,7 +893,7 @@
   <tabstop>style_cb</tabstop>
   <tabstop>outline_cb</tabstop>
   <tabstop>t_angle_cb</tabstop>
-  <tabstop>t_snap_cbx</tabstop>
+  <tabstop>t_never_snap_cbx</tabstop>
  </tabstops>
  <resources>
   <include location="../../icons/icons.qrc"/>
diff --git a/src/ant/ant/antConfigPage.cc b/src/ant/ant/antConfigPage.cc
index f92c2c58e..9706615ef 100644
--- a/src/ant/ant/antConfigPage.cc
+++ b/src/ant/ant/antConfigPage.cc
@@ -375,7 +375,7 @@ ConfigPage4::show ()
   mp_ui->style_cb->setCurrentIndex ((unsigned int) m_ruler_templates [m_current_template].style ());
   mp_ui->outline_cb->setCurrentIndex ((unsigned int) m_ruler_templates [m_current_template].outline ());
   mp_ui->t_angle_cb->setCurrentIndex ((unsigned int) m_ruler_templates [m_current_template].angle_constraint ());
-  mp_ui->t_snap_cbx->setChecked (m_ruler_templates [m_current_template].snap ());
+  mp_ui->t_never_snap_cbx->setChecked (! m_ruler_templates [m_current_template].snap ());
   mp_ui->t_mode_cb->setCurrentIndex ((unsigned int) m_ruler_templates [m_current_template].mode ());
 
   mp_ui->main_position->setCurrentIndex ((unsigned int) m_ruler_templates [m_current_template].main_position ());
@@ -410,7 +410,7 @@ ConfigPage4::commit ()
   ant::Template::ruler_mode_type mode = ant::Template::ruler_mode_type (mp_ui->t_mode_cb->currentIndex ());
   m_ruler_templates [m_current_template].set_mode (mode);
 
-  m_ruler_templates [m_current_template].snap (mp_ui->t_snap_cbx->isChecked ());
+  m_ruler_templates [m_current_template].snap (! mp_ui->t_never_snap_cbx->isChecked ());
 
   m_ruler_templates [m_current_template].set_main_position (Object::position_type (mp_ui->main_position->currentIndex ()));
   m_ruler_templates [m_current_template].set_main_xalign (Object::alignment_type (mp_ui->main_xalign->currentIndex ()));
diff --git a/src/doc/doc/manual/ruler_properties.xml b/src/doc/doc/manual/ruler_properties.xml
index 8a23920d4..184c02f41 100644
--- a/src/doc/doc/manual/ruler_properties.xml
+++ b/src/doc/doc/manual/ruler_properties.xml
@@ -33,14 +33,14 @@
       just being horizontal. By default, the ruler uses the global setting. It can however be configured 
       to provide its own constraint.
     </li>
-    <li><b>Object snapping:</b> each ruler can be configure to snap to the closest object edge or vertex.
-      By default, the rulers use the global setting. It may be disabled however for each ruler.
-    </li>
     <li><b>Mode:</b> in normal mode, two clicks are required to define a ruler: to set the first
       point and to set the second one. In "Single click" mode, a single click will set both 
       points to the same. In "Auto measure" mode, the points will be determined by looking
       for edges in the vicinity of the click point and adjusting the points accordingly.
     </li>
+    <li><b>Never snap to objects:</b> if this option is on, the ruler never snaps to drawing
+      objects, even if that global option is enabled.
+    </li>
   </ul>
 
   <p>