From ed3aff9179bde64b541826cc2755fc0c8cb22f6b Mon Sep 17 00:00:00 2001
From: Luke Harold Miles <10591373+qpwo@users.noreply.github.com>
Date: Tue, 13 Feb 2024 09:40:42 -0800
Subject: [PATCH] add more ngspice_get_value info

---
 doc/xschem_man/tutorial_ngspice_backannotation.html | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/xschem_man/tutorial_ngspice_backannotation.html b/doc/xschem_man/tutorial_ngspice_backannotation.html
index f830894b..3a498c3c 100644
--- a/doc/xschem_man/tutorial_ngspice_backannotation.html
+++ b/doc/xschem_man/tutorial_ngspice_backannotation.html
@@ -134,6 +134,16 @@ write cmos_example.raw
   component, but does not need to be attached to any specific point or wire.
   Edit its attributes and set its <kbd>node</kbd> attribute to an existing saved variable in the raw file.
  </p>
+ <p><b><kbd>ngspice_get_value.sym</kbd> debugging tips:</b></p>
+  <ul>
+    <li>See all available devices in ngspice with <kbd>display</kbd></li>
+    <li>See all values for a device with <kbd>print @somedevice</kbd></li>
+    <ul><li>eg <kbd>print @m.xm6.xmain1.msky130_fd_pr__nfet_g5v0d16v0__base[vth]</kbd></li></ul>
+    <li><b>Some values must explicitly be saved</b> before the analysis to be available for annotation.</li>
+    <ul><li>eg <kbd>save @m.xm6.xmain1.msky130_fd_pr__nfet_g5v0d16v0__base[vth]</kbd></li></ul>
+    <li>Usually you'll need to wrap your value with <kbd>v()</kbd> in the symbol properties in xschem.</li>
+    <ul><li>eg <kbd>node=v(@m.xm6.xmain1.msky130_fd_pr__nfet_g5v0d16v0__base[vth])</kbd></li></ul>
+</ul>
  <img src="backannotation9.png">
  <p>
   Run again the simulation and the <kbd>xschem annotate_op</kbd> command and values will be updated.