Debian Codegraph @

upstream/debian-unstable/man1/abc2abc.1

raw
1 .TH ABC2ABC 1 "07 June 2011"
2 .SH NAME
3 abc2abc \- a simple abc checker/re-formatter/transposer
4 .SH SYNOPSIS
5 \fBabc2abc\fP \fIfile\fP [ \fB-s\fP ] [ \fB-n\fP ] [ \fB-b\fP ]
6 [ \fB-r\fP ] [ \fB-e\fP ] [ \fB-t \fP\fIsemitones\fP ] [ \fB-nda\fP ]
7 [ \fB-u\fP ] [ \fB-d\fP ] [ \fB-v\fP ] [ \fB-V\fP\fIvoice number\fP]
8 [\fB-P\fP\fivoice number\fp] [\fB-nokeys\fP]
9 [ \fB-nokeyf\fP] [ \fB-usekey\fP\fI(sharps/flats)\fP]
10 [\fB-useclef\fP\fI(treble/clef)\fP] [ \fB-OCC\fP ]
11 .SH "DESCRIPTION"
12 .PP
13 .B abc2abc
14 is a simple abc checker/re-formatter/transposer.
15 It will check whether the \fIfile\fP given on the command line
16 obeys basic abc syntax.
17 .PP
18 If you want to check an abc tune,
19 it is recommended that you use
20 .B abc2midi
21 with the \fB-c\fP option.
22 This performs extra checks that
23 .B abc2abc
24 does not do.
25 .PP
26 The output of
27 .B abc2abc
28 goes to standard output.
29 Use redirection to save it to a file.
30 .SH OPTIONS
31 .TP
32 .B \-s
33 Rework spacing in the file (which affects how notes are beamed together
34 when the music is printed out). This option does not appear to be working
35 correctly.
36 .TP
37 .BI \-n " X"
38 Reformats the abc file with line breaks every \fIX\fP bars.
39 .TP
40 .B \-b
41 Don't do bar checking.
42 .TP
43 .B \-r
44 Don't do repeat checking.
45 .TP
46 .B \-e
47 Don't report errors.
48 .TP
49 .BI \-t " n"
50 Transpose tune by \fIn\fP semitones. This function will also
51 work with K: none or one of \-nokeys or \-nokeyf.
52 If a voice is assigned to channel 10 (drum channel) using a
53 %%MIDI channel 10
54 command, then this voice is never transposed.
55
56 .TP
57 .B \-nda
58 Convert double accidentals in guitar chord to another chord though
59 strictly not correct.
60 .TP
61 .B \-u
62 Update notation; the older notation \fB+ +\fP for chords is replaced by
63 \fB[]\fP and \fBs s\fP for slurs is replaced by \fB()\fP.
64 .TP
65 .B \-OCC
66 Accept the old notation for chord. Normally this is turned off,
67 since it conflicts with abc draft standard version 2.0 for
68 decorations (eg. +crescendo(+).
69 .TP
70 .B \-d
71 Re-notate the tune with all note lengths doubled. The unit length specified by the L: field
72 command is halved (e.g. L:1/8 to L:1/16).
73 .TP
74 .B \-v
75 Re-notate the tune with all note lengths halved. The unit length specified by the L: field
76 command is doubled (e.g. L:1/8 to L:1/4).
77 .TP
78 .B \-ver
79 Prints version number and exits.
80 .TP
81 .BI \-V " X[,Y...]"
82 For multivoiced abc files (i.e. contains V: field commands), only voices \fIX[,Y,...]\fP are copied.
83 .TP
84 .BI \-P " X,[,Y...]"
85 For multivoiced abc files (i.e. contains V: field commands), all voices except \fIX[,Y...]\fP remain the same. Voices X,Y... are modified according the other runtime parameters.
86 .TP
87 .BI \-X " n"
88 For a file containing many tunes, the X: reference numbers are renumbered sequentially
89 starting from number \fIn\fP.
90 .TP
91 .BI \-xref " n"
92 Only the tune with X: n is processed.
93 .TP
94 .B \-nokeys
95 No key signature will be assumed. Instead, sharps and naturals will
96 be placed wherever they are needed.
97 .TP
98 .B \-nokeyf
99 No key signature will be assumed. Instead, flats and naturals will
100 be placed wherever they are needed.
101 .TP
102 .B \-usekey " sf
103 This will force abc2abc to output the notes in the key signature
104 keys[sf] where sf specifies the number of flats (\-negative) or
105 sharps (+positive) in the key signature. It is a number between
106 \-5 and +5 inclusive.
107 .TP
108 .B \-useclef
109 This works with only the -t (transpose) and provided the abc
110 file does not already have a clef command in the K: field. It
111 does not support voices.
112 .PP
113 * Normally abc2abc will convert the deprecated notation for
114 decorations (eg. !ppp!) to the abc version 2.0 draft standard (eg. +ppp+).
115 If you do not wish to change to this standard include the \-OCC flag.
116
117 .SH "SEE ALSO"
118 .IR abcmtex "(1), " abc2midi "(1), " midi2abc "(1), " mftext "(1)"
119 .SH AUTHOR
120 This manual page was written by Anselm Lingnau <[email protected]> and is now supported by Seymour Shlien <[email protected]>
121 for the GNU/Linux system.
122 .SH VERSION
123 This man page describes abc2abc version 2.04 from January 22 2020.