From b7e133d6ba79bc0f623eec984765c88eff3c3f87 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Mangano-Tarumi?= <fmang@mg0.fr>
Date: Sat, 24 Nov 2018 12:05:55 -0500
Subject: [PATCH] add exmaple to the man page

---
 opustags.1 | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/opustags.1 b/opustags.1
index f9d5271..4403abb 100644
--- a/opustags.1
+++ b/opustags.1
@@ -89,6 +89,24 @@ All the original tags are deleted and new ones are read from standard input.
 Each line must specify a \fIFIELD=VALUE\fP pair and be separated with line feeds.
 Invalid lines are skipped and cause a warning to be issued. Blank lines are ignored.
 This mode could be useful for batch processing tags through an utility like \fBsed\fP.
+.SH EXAMPLES
+.PP
+List all the tags in file foo.opus:
+.PP
+	opustags foo.opus
+.PP
+Copy in.opus to out.opus, with the TITLE tag added:
+.PP
+	opustags in.opus --output out.opus --add "TITLE=Hello world!"
+.PP
+Replace all the tags in dest.opus with the ones from src.opus:
+.PP
+	opustags src.opus | opustags --in-place dest.opus --set-all
+.PP
+Remove the previously existing ARTIST tags and add the two X and Y ARTIST tags, then display the new
+tags without writing them to the Opus file:
+.PP
+	opustags in.opus --add ARTIST=X --add ARTIST=Y --delete ARTIST
 .SH SEE ALSO
 .BR vorbiscomment (1),
 .BR sed (1)