You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

147 lines
2.2 KiB

  1. .TH cuetools 1
  2. .SH NAME
  3. cueprint
  4. .SH DESCRIPTION
  5. cueprint \- print disc and track infomation for a cue or toc file
  6. .SH SYNTAX
  7. cueprint [\-h] [\-i cue|toc] [\-d TEMPLATE] [\-t TEMPLATE] [file...]
  8. .SH OPTIONS
  9. .TP
  10. .B \-h
  11. print usage information
  12. .TP
  13. .B \-i cue|toc
  14. set format of file(s)
  15. .TP
  16. .B \-d TEMPLATE
  17. set disc template (see TEMPLATE EXPANSION)
  18. .TP
  19. .B \-t TEMPLATE
  20. set track template (see TEMPLATE EXPANSION)
  21. .SH TEMPLATE EXPANSION
  22. All characters in the template are reproduced in the output except for conversions, which begin with `%'.
  23. .PP
  24. A conversion has the form `%[flags][width][.precision]<conversion\-char>'.
  25. .PP
  26. There may be zero or more of the following flags:
  27. .TP
  28. .B \-
  29. left justification
  30. .TP
  31. .B +
  32. place sign before numbers
  33. .TP
  34. .B ` '
  35. (space) place a space before a positive number
  36. .TP
  37. .B 0
  38. pad with zeros
  39. .TP
  40. .B #
  41. (unused)
  42. .PP
  43. width is the minimum field width. precision is the maximum width for strings.
  44. .PP
  45. Disc template expansion characters are valid for both the disc and track templates.
  46. .PP
  47. Disc:
  48. .TP
  49. .B A
  50. album arranger
  51. .TP
  52. .B C
  53. album composer
  54. .TP
  55. .B G
  56. album genre
  57. .TP
  58. .B M
  59. album message
  60. .TP
  61. .B N
  62. number of tracks
  63. .TP
  64. .B P
  65. album performer
  66. .TP
  67. .B S
  68. album songwriter
  69. .TP
  70. .B T
  71. album title
  72. .TP
  73. .B U
  74. album UPC/EAN
  75. .PP
  76. Track:
  77. .TP
  78. .B a
  79. track arranger
  80. .TP
  81. .B c
  82. track composer
  83. .TP
  84. .B g
  85. track genre
  86. .TP
  87. .B i
  88. track ISRC
  89. .TP
  90. .B m
  91. track message
  92. .TP
  93. .B n
  94. track number
  95. .TP
  96. .B p
  97. track perfomer
  98. .TP
  99. .B t
  100. track title
  101. .TP
  102. .B u
  103. track ISRC (CD-TEXT)
  104. .PP
  105. Any other character is expanded to that character. For example, a % expands to a literal `%'.
  106. .SH ESCAPES
  107. The following single-character escapes are recognized:
  108. .TP
  109. .B \ea
  110. alert (bell)
  111. .TP
  112. .B \eb
  113. backspace
  114. .TP
  115. .B \ef
  116. formfeed
  117. .TP
  118. .B \en
  119. newline
  120. .TP
  121. .B \er
  122. carriage return
  123. .TP
  124. .B \et
  125. horizontal tab
  126. .TP
  127. .B \ev
  128. vertial tab
  129. .TP
  130. .B \e0
  131. NULL
  132. .SH NOTES
  133. 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.
  134. .SH EXAMPLES
  135. To display disc and track information (using the default template for both), run:
  136. .PP
  137. % cueprint album.cue
  138. .PP
  139. To print the number of tracks in a cue file, run:
  140. .PP
  141. % cueprint -d '%N\en' album.cue
  142. .SH AUTHOR
  143. Svend Sorensen
  144. .SH "SEE ALSO"
  145. cueconvert(1),
  146. cuebreakpoints(1)