| 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. |