shithub: bar

Info  •  Files  •  Log

man: provide an example of mouse click controls

--- a/bar.man

+++ b/bar.man

@@ -22,9 +22,11 @@

 standard input.

 .PP

 .I Bar

-Reacts to mouse clicks by writing the "clicked" portion of the text

+reacts to mouse clicks by writing the "clicked" portion of the text

 (enclosed by the separator) to standard output.  This can be used to

-perform additional actions by a custom script.

+perform additional actions by a custom script. See

+.I Examples

+section.

 .PP

 By default,

 .I bar

@@ -54,6 +56,29 @@

 .I -d

 option, see

 .I tmdate(2).

+.SH EXAMPLES

+An example of how

+.I bar

+can be used along with

+.I riow

+to control

+.I zuke

+playback via mouse clicks:

+.PP

+.EX

+#!/bin/rc

+rfork ne

+fn bar { sed -u 's/$/ │ ⏮ │ ⏯ │ ⏭/g' | /bin/bar | awk -v 'c=plumb -d audio ''key ' '

+	/⏮/{system(c"<''")}

+	/⏯/{system(c"p''")}

+	/⏭/{system(c">''")}

+ ' >[2]/dev/null }

+/bin/riow

+.EE

+.PP

+The script is executed instead of

+.I riow

+directly.

 .SH SOURCE

 https://git.sr.ht/~ft/bar

 .SH BUGS