X-Git-Url: http://sigrok.org/gitweb/?a=blobdiff_plain;f=doc%2Fsigrok-cli.1;h=8fbb3a1f3e3253deb740a37700395f13d764d63f;hb=e4b7762f74a449c7184be68b0cfd1672b2094168;hp=cbd9f878b40f23d1e40521b6986889b85b18e004;hpb=230e607b9b87fa5e2779731006380d2e4331773a;p=sigrok-cli.git

diff --git a/doc/sigrok-cli.1 b/doc/sigrok-cli.1
index cbd9f87..8fbb3a1 100644
--- a/doc/sigrok-cli.1
+++ b/doc/sigrok-cli.1
@@ -229,6 +229,30 @@ is an option supported by the
 protocol decoder. Additionally, the user tells sigrok to decode the SPI
 protocol using channel 1 as MISO signal for SPI, channel 5 as MOSI, channel 3
 as CLK, and channel 0 as CS# signal.
+.br
+.sp
+When multiple decoders are specified in the same
+.BR -P
+option, they will be stacked on top of each other in the specified order.
+.sp
+Example:
+.sp
+ $
+.B "sigrok\-cli \-i <file.sr> \-P i2c,eeprom24xx"
+.br
+ $
+.B "sigrok\-cli \-i <file.sr> \-P uart:baudrate=31250,midi"
+.sp
+When multiple
+.BR -P
+options are specified, each of them creates one decoder stack, which
+executes in parallel to other decoder stacks.
+.sp
+Example:
+.sp
+ $
+.B "sigrok\-cli \-i <file.sr> \-P uart:tx=D0:rx=D1 \-P timing:data=D2"
+.sp
 .TP
 .BR "\-A, \-\-protocol\-decoder\-annotations " <annotations>
 By default, only the stack's topmost protocol decoder's annotation output is