diff --git a/doc/xschem_man/graphs.html b/doc/xschem_man/graphs.html
index 590c8464..4c1c2d71 100644
--- a/doc/xschem_man/graphs.html
+++ b/doc/xschem_man/graphs.html
@@ -240,9 +240,26 @@ The following syntax:
all graphs with data taken from the updated raw file(s).

-
+ The general syntax for a signal in a graph is the following:
+ "alias_name; signal_name % dataset# raw_file sim_type
+ where:
+ dataset# is the dataset index to display (only meaningful and needed
+ if multiple datasets are present like in Montecarloo / Mismatch simulations).
+ raw_file is the location and name of the raw file to load. You can use
+ $netlist_dir to quickly reference the simulation directory where usually such
+ raw files are located.
+ sim_type is the simulation type, like
+ ac, sp, spectrum, dc, op,
+ tran, noise.
+ Example:
+ "SAOUT; saout % 2 $netlist_dir/autozero_comp.raw tran
+
+ 
+