Merged autotools to main trunk.

doc/Makefile.am

@@ -0,0 +1,2 @@
+man_MANS = cuebreakpoints.1 cueconvert.1 cueprint.1
+EXTRA_DIST = $(man_MANS)

doc/cuebreakpoints.1

@@ -0,0 +1,46 @@
+.TH cuetools 1
+.
+.SH NAME
+cuebreakpoints
+.
+.SH DESCRIPTION
+cuebreakpoints \- print the breakpoints from a cue or toc file
+.
+.SH SYNOPSIS
+.B cuebreakpoints
+[option...] [file...]
+.
+.SH OPTIONS
+.TP
+.B \-h, \--help
+print usage information
+.
+.TP
+.B \-i, \--input-format cue|toc
+set format of file(s)
+.
+.TP
+.B \--append-gaps
+append pregaps to previous track (default)
+.
+.TP
+.B \--prepend-gaps
+prefix pregaps to track
+.
+.TP
+.B \--split-gaps
+split at beginning and end of pregaps
+.
+.SH NOTES
+The breakpoints are in a format usable by shnsplit (part of the shntool package).
+.PP
+The first track's pregap cannot be appended to the previous track, so it is prefixed to the track in both append and prepend modes.  If you want the track without it, use the split mode.
+.PP
+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
+Svend Sorensen
+.
+.SH "SEE ALSO"
+cueconvert(1),
+cueprint(1)

doc/cueconvert.1

@@ -0,0 +1,34 @@
+.TH cuetools 1
+.
+.SH NAME
+cueconvert
+.
+.SH DESCRIPTION
+cueconvert \- convert between the cue and toc formats
+.
+.SH SYNOPSIS
+.B cueconvert
+[option...] [infile [outfile]]
+.
+.SH OPTIONS
+.TP
+.B \-h, \--help
+print usage information
+.
+.TP
+.B \-i, \--input-format cue|toc
+set format of input file
+.
+.TP
+.B \-o, \--output-format cue|toc
+set format of output file
+.
+.SH NOTES
+If infile or outfile is not specified, stdin and stdout are used, respectively.  If a filename is specified and the format is not specified, the format will be set based on a ".cue" or ".toc" suffix.  If the output file format is not specified, and it cannot be determined from the suffix, it will be set to the opposite of the input format.
+.
+.SH AUTHOR
+Svend Sorensen
+.
+.SH "SEE ALSO"
+cuebreakpoints(1),
+cueprint(1)

doc/cueprint.1

@@ -0,0 +1,198 @@
+.TH cuetools 1
+.
+.SH NAME
+cueprint
+.
+.SH DESCRIPTION
+cueprint \- print disc and track infomation for a cue or toc file
+.
+.SH SYNOPSIS
+.B cueprint
+[option...] [file...]
+.
+.SH OPTIONS
+.TP
+.B \-h, \--help
+print usage information
+.
+.TP
+.B \-i, \--input-format cue|toc
+set format of file(s)
+.
+.TP
+.B \-n, \--track-number <number>
+only print track information for single track.  The default is to print information for all tracks.
+.
+.TP
+.B \-d, \--disc-template <template>
+set disc template (see TEMPLATE EXPANSION)
+.
+.TP
+.B \-t, \--track-template <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
+.B Disc Conversion Specifiers
+.
+.TP
+.B A
+album arranger
+.
+.TP
+.B C
+album composer
+.
+.TP
+.B G
+album genre
+.
+.TP
+.B M
+album message
+.
+.TP
+.B N
+number of tracks
+.
+.TP
+.B P
+album performer
+.
+.TP
+.B S
+album songwriter
+.
+.TP
+.B T
+album title
+.
+.TP
+.B U
+album UPC/EAN
+.
+.PP
+.B Track Conversion Specifiers
+.
+.TP
+.B a
+track arranger
+.
+.TP
+.B c
+track composer
+.
+.TP
+.B g
+track genre
+.
+.TP
+.B i
+track ISRC
+.
+.TP
+.B m
+track message
+.
+.TP
+.B n
+track number
+.
+.TP
+.B p
+track perfomer
+.
+.TP
+.B t
+track title
+.
+.TP
+.B u
+track ISRC (CD-TEXT)
+.
+.PP
+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 EXAMPLES
+To display disc and track information (using the default template for both), run:
+.PP
+% cueprint album.cue
+.PP
+To print the number of tracks in a cue file, run:
+.PP
+% cueprint -d '%N\en' album.cue
+.
+.SH AUTHOR
+Svend Sorensen
+.
+.SH "SEE ALSO"
+cueconvert(1),
+cuebreakpoints(1)