From f68d7aad407f2b6ddbd3ccd4b620e156e37ba651 Mon Sep 17 00:00:00 2001
From: Svend Sorensen <svend@ciffer.net>
Date: Wed, 1 Sep 2004 10:03:50 +0000
Subject: [PATCH] Update with conversion information.

---
 man/cueprint.1 | 87 +++++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 68 insertions(+), 19 deletions(-)

diff --git a/man/cueprint.1 b/man/cueprint.1
index 100a7ae..71caa69 100644
--- a/man/cueprint.1
+++ b/man/cueprint.1
@@ -19,67 +19,116 @@ set disc template (see TEMPLATE EXPANSION)
 .B \-t TEMPLATE
 set track template (see TEMPLATE EXPANSION)
 .SH TEMPLATE EXPANSION
+All characters in the template are reproduced in the output except for conversions, which begin with `%'.
+.PP
+A conversion has the form `%[flags][width][.precision]<conversion\-char>'.
+.PP
+There may be zero or more of the following flags:
+.TP
+.B \-
+left justification
+.TP
+.B +
+place sign before numbers
+.TP
+.B ` '
+(space) place a space before a positive number
+.TP
+.B 0
+pad with zeros
+.TP
+.B #
+(unused)
+.PP
+width is the minimum field width.  precision is the maximum width for strings.
+.PP
 Disc template expansion characters are valid for both the disc and track templates.
 .PP
 Disc:
 .TP
-.B %A
+.B A
 album arranger
 .TP
-.B %C
+.B C
 album composer
 .TP
-.B %G
+.B G
 album genre
 .TP
-.B %M
+.B M
 album message
 .TP
-.B %N
+.B N
 number of tracks
 .TP
-.B %P
+.B P
 album performer
 .TP
-.B %S
+.B S
 album songwriter
 .TP
-.B %T
+.B T
 album title
 .TP
-.B %U
+.B U
 album UPC/EAN
 .PP
 Track:
 .TP
-.B %a
+.B a
 track arranger
 .TP
-.B %c
+.B c
 track composer
 .TP
-.B %g
+.B g
 track genre
 .TP
-.B %i
+.B i
 track ISRC
 .TP
-.B %m
+.B m
 track message
 .TP
-.B %n
+.B n
 track number
 .TP
-.B %p
+.B p
 track perfomer
 .TP
-.B %t
+.B t
 track title
 .TP
-.B %u
+.B u
 track ISRC (CD-TEXT)
 .PP
-Any other %<character> is expanded to that character.  For example, %% expands to a literal `%'.
+Any other character is expanded to that character.  For example, a % expands to a literal `%'.
+.SH ESCAPES
+The following single-character escapes are recognized:
+.TP
+.B \ea
+alert (bell)
+.TP
+.B \eb
+backspace
+.TP
+.B \ef
+formfeed
+.TP
+.B \en
+newline
+.TP
+.B \er
+carriage return
+.TP
+.B \et
+horizontal tab
+.TP
+.B \ev
+vertial tab
+.TP
+.B \e0
+NULL
 .SH NOTES
 If no files are specified, stdin is used.  If a filename is specified and the format is not specified, the format will be set based on a ".cue" or ".toc" suffix.
 .SH AUTHOR