Commits

Lee S. committed 9209830

Removed outdated docs.

  • Participants
  • Parent commits 78dbd3d

Comments (0)

Files changed (33)

docs/abc/abcm2ps/dev/Changes

----- Version 7.0.9 - 12/05/23 ----
-
-Fix program loop when width of measure bigger than staff width.
-Fix bad last measure bar position again
-	(reported by many people).
-Fix loss of music line break when line ending with grace note(s),
-		note and no bar
-	(reported by John Chambers).
-
----- Version 7.0.8 - 12/05/21 ----
-
-Fix loss of paragraph break on empty lines.
-Fix crash in %%begintext with fill/justify and pango on an empty line.
-Fix bad offset of lyrics after tune when new page
-	(reported by Christian Schnarr).
-Fix bad last measure bar position since 7.0.6.
-Handle 'X' (invisible multi-rest).
-Don't do "titletrim" when the length of last word of the title
-	is greater than 4.
-Fix lack of tempo at start of tune when "%%writefields Q 0" later.
-
----- Version 7.0.7 - 12/05/16 ----
-
-Fix bad line numbers in errors and svg annotations
-	(reported by Nils Liberg).
-
----- Version 7.0.6 - 12/05/13 ----
-
-Fix lack of key signature when K: + clef inside music line.
-Fix lack of accidentals when spaces in the accidental list of K:.
-Fix placement errors when scaled voice or staff
-	(reported by: Glenn Arthur Jr).
-Don't put a measure bar at end of line when the measure is incomplete
-	(reported by Christian Schnarr).
-Fix ps2pdf error when unknown UTF-8 characters
-	(reported by Nils Liberg).
-
----- Version 7.0.5 - 12/04/30 ----
-
-Update the documentation: there is no %%ignore
-	(reported-by: Glenn Arthur Jr).
-Bad offset of %%EPS since version 5.x.x
-	(reported-by: Glenn Arthur Jr).
-Handle more lowercase to uppercase letters when %%titlecaps
-	(reported by Christian Schnarr).
-
----- Version 7.0.4 - 12/03/31 ----
-
-Fix loss of music after abc 2.0 continuation ('\').
-Fix a loss of voices when appearing in a new %%staves/%%score.
-Handle the ABC 2.1 "w:" behaviour (with "+:").
-Fix misplaced part (P:) when followed by K:, or M:
-	(reported by Richard Walker).
-Accept 'K' in %%titleformat and (text) notes after tune.
-Crash when misplaced dble repeat bar in second voice at end of tune
-	(reported by Simon Wascher).
-Fix X: value in title when ', The' at end of T:
-	(reported by Paul Hardy).
-
----- Version 7.0.3 - 12/03/03 ----
-
-Don't print the tempo in tune when '%%writefields Q 0'
-	(reported by Martin Tarenskeen).
-Let less space at end of line when key signature change.
-Fix a scanning problem with the command line parameter '--header'.
-Update the %%staves/%%score in tune(s) when defined in %%tune.
-
----- Version 7.0.2 - 12/02/21 ----
-
-Don't add the %%transpose values
-	(reported by Alex Scheutzow).
-Accept empty K: as K:none.
-Fix lack of key signature change when exp accidental list of the same size.
-Fix bad slur on grace notes when staffscale != 1
-	(reported by Pete Showman).
-Treat 'I:' as '%%' (accept I:abc-include and I:abc-charset).
-Ignore %%sep and %%vskip when global and -E or -g.
-Accept any format parameter in %%tune sequences.
-Fix crash when some output needed in format files by ignoring %%text...
-Stop %%tune/%%voice options on empty lines.
-Fix %%abc2pscompat again.
-Fix some errors "??? buffer not empty:".
-Fix vertical offset problems on page breaks with %%multicol.
-Fix bad page header when %%multicol outside and inside tunes.
-Don't use pango when only accidentals in string
-	(reported by John Collins).
-Ignore %%writefields when outputting %%titleformat
-	(reported by Pete S).
-Reset the default standard title format when %%titleformat is empty.
-
----- Version 7.0.1 - 12/02/06 ----
-
-Fix loss of music when voices disappear and reappear by %%score
-	(reported by John Collins).
-Fix some warnings in slre.c compilation
-	(reported by Chuck Boody).
-Add %%custos.
-Fix some cases of error "Line too much shrunk".
-Bad computation of the page height letting to much space in (portrait)
-	or going out of (landscape) the bottom of the page when
-	using %%multicol.
-
----- Version 7.0.0 - 12/02/02 ----
-
-Permit more pseudo-comments to be defined at command-line level.
-Add %%tune, %%voice, %%break, %%clip and %%select.
-Add tune selection with '-e' by regular expression.
-Permit the clefs to go under or above the notes/rests.
-Creation from abcm2ps version 6.6.4.

docs/abc/abcm2ps/dev/INSTALL

-		--- abcm2ps installation ---
-
-
-Unix(-like) systems
-===================
-
-This version uses the GNU 'autoconf' package, so, after untarring the
-sources, run:
-
-	./configure
-	make
-
-and then, as root, do:
-
-	make install
-
-The 'abcm2ps' command should work if '/usr/local/bin' is in your path
-(try 'abcm2ps -h' for a list of the command line options).
-
-You may change some compile options at configure level. To know which,
-run:
-
-	configure --help
-
-
-Windows or MAC systems
-======================
-
-Change the file 'config.h' according to your preferences, compile all
-the '.c' files using an ANSI C compiler, and link them together. The
-resulting binary file should run immediately from where it has been
-generated. You may then move it at any place you want.
-
-
-Testing
-=======
-
-To test the program, run it with one of the .abc files as the command
-line argument:
-
-	abcm2ps sample
-
-The resulting file, 'Out.ps', may be displayed using a PostScript
-previewer such as ghostscript, or may be sent directly to a PostScript
-printer, or indirectly to a simple printer using a postscript filter.
-
-
-About the 'pango' library
-=========================
-
-abcm2ps now uses the 'pango' library to render texts with non latin
-characters. If you don't have such texts, you don't need this library.
-
-In Unix(-like) systems, at configure time, the pango generation elements
-are searched by pkg-config in the gdk-2.0 library. If this library or
-pkg_config are not found, the rendering of non latin characters with
-pango will be disabled, but this rendering may be done by other means,
-especially by CMap (see the file chinese.abc). Note also that, when
-pango is defined, it may be disabled at command line level by
-'--pango 0' (you may try it with chinese.abc).

docs/abc/abcm2ps/dev/License

-		    GNU GENERAL PUBLIC LICENSE
-		       Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
-                          675 Mass Ave, Cambridge, MA 02139, USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-			    Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-License is intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users.  This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it.  (Some other Free Software Foundation software is covered by
-the GNU Library General Public License instead.)  You can apply it to
-your programs, too.
-
-  When we speak of free software, we are referring to freedom, not
-price.  Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-this service if you wish), that you receive source code or can get it
-if you want it, that you can change the software or use pieces of it
-in new free programs; and that you know you can do these things.
-
-  To protect your rights, we need to make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have.  You must make sure that they, too, receive or can get the
-source code.  And you must show them these terms so they know their
-rights.
-
-  We protect your rights with two steps: (1) copyright the software, and
-(2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
-
-  Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software.  If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
-
-  Finally, any free program is threatened constantly by software
-patents.  We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary.  To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-		    GNU GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License applies to any program or other work which contains
-a notice placed by the copyright holder saying it may be distributed
-under the terms of this General Public License.  The "Program", below,
-refers to any such program or work, and a "work based on the Program"
-means either the Program or any derivative work under copyright law:
-that is to say, a work containing the Program or a portion of it,
-either verbatim or with modifications and/or translated into another
-language.  (Hereinafter, translation is included without limitation in
-the term "modification".)  Each licensee is addressed as "you".
-
-Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running the Program is not restricted, and the output from the Program
-is covered only if its contents constitute a work based on the
-Program (independent of having been made by running the Program).
-Whether that is true depends on what the Program does.
-
-  1. You may copy and distribute verbatim copies of the Program's
-source code as you receive it, in any medium, provided that you
-conspicuously and appropriately publish on each copy an appropriate
-copyright notice and disclaimer of warranty; keep intact all the
-notices that refer to this License and to the absence of any warranty;
-and give any other recipients of the Program a copy of this License
-along with the Program.
-
-You may charge a fee for the physical act of transferring a copy, and
-you may at your option offer warranty protection in exchange for a fee.
-
-  2. You may modify your copy or copies of the Program or any portion
-of it, thus forming a work based on the Program, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) You must cause the modified files to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    b) You must cause any work that you distribute or publish, that in
-    whole or in part contains or is derived from the Program or any
-    part thereof, to be licensed as a whole at no charge to all third
-    parties under the terms of this License.
-
-    c) If the modified program normally reads commands interactively
-    when run, you must cause it, when started running for such
-    interactive use in the most ordinary way, to print or display an
-    announcement including an appropriate copyright notice and a
-    notice that there is no warranty (or else, saying that you provide
-    a warranty) and that users may redistribute the program under
-    these conditions, and telling the user how to view a copy of this
-    License.  (Exception: if the Program itself is interactive but
-    does not normally print such an announcement, your work based on
-    the Program is not required to print an announcement.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Program,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Program, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Program.
-
-In addition, mere aggregation of another work not based on the Program
-with the Program (or with a work based on the Program) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may copy and distribute the Program (or a work based on it,
-under Section 2) in object code or executable form under the terms of
-Sections 1 and 2 above provided that you also do one of the following:
-
-    a) Accompany it with the complete corresponding machine-readable
-    source code, which must be distributed under the terms of Sections
-    1 and 2 above on a medium customarily used for software interchange; or,
-
-    b) Accompany it with a written offer, valid for at least three
-    years, to give any third party, for a charge no more than your
-    cost of physically performing source distribution, a complete
-    machine-readable copy of the corresponding source code, to be
-    distributed under the terms of Sections 1 and 2 above on a medium
-    customarily used for software interchange; or,
-
-    c) Accompany it with the information you received as to the offer
-    to distribute corresponding source code.  (This alternative is
-    allowed only for noncommercial distribution and only if you
-    received the program in object code or executable form with such
-    an offer, in accord with Subsection b above.)
-
-The source code for a work means the preferred form of the work for
-making modifications to it.  For an executable work, complete source
-code means all the source code for all modules it contains, plus any
-associated interface definition files, plus the scripts used to
-control compilation and installation of the executable.  However, as a
-special exception, the source code distributed need not include
-anything that is normally distributed (in either source or binary
-form) with the major components (compiler, kernel, and so on) of the
-operating system on which the executable runs, unless that component
-itself accompanies the executable.
-
-If distribution of executable or object code is made by offering
-access to copy from a designated place, then offering equivalent
-access to copy the source code from the same place counts as
-distribution of the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  4. You may not copy, modify, sublicense, or distribute the Program
-except as expressly provided under this License.  Any attempt
-otherwise to copy, modify, sublicense or distribute the Program is
-void, and will automatically terminate your rights under this License.
-However, parties who have received copies, or rights, from you under
-this License will not have their licenses terminated so long as such
-parties remain in full compliance.
-
-  5. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Program or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Program (or any work based on the
-Program), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Program or works based on it.
-
-  6. Each time you redistribute the Program (or any work based on the
-Program), the recipient automatically receives a license from the
-original licensor to copy, distribute or modify the Program subject to
-these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties to
-this License.
-
-  7. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Program at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Program by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Program.
-
-If any portion of this section is held invalid or unenforceable under
-any particular circumstance, the balance of the section is intended to
-apply and the section as a whole is intended to apply in other
-circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system, which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  8. If the distribution and/or use of the Program is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License
-may add an explicit geographical distribution limitation excluding
-those countries, so that distribution is permitted only in or among
-countries not thus excluded.  In such case, this License incorporates
-the limitation as if written in the body of this License.
-
-  9. The Free Software Foundation may publish revised and/or new versions
-of the General Public License from time to time.  Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-Each version is given a distinguishing version number.  If the Program
-specifies a version number of this License which applies to it and "any
-later version", you have the option of following the terms and conditions
-either of that version or of any later version published by the Free
-Software Foundation.  If the Program does not specify a version number of
-this License, you may choose any version ever published by the Free Software
-Foundation.
-
-  10. If you wish to incorporate parts of the Program into other free
-programs whose distribution conditions are different, write to the author
-to ask for permission.  For software which is copyrighted by the Free
-Software Foundation, write to the Free Software Foundation; we sometimes
-make exceptions for this.  Our decision will be guided by the two goals
-of preserving the free status of all derivatives of our free software and
-of promoting the sharing and reuse of software generally.
-
-			    NO WARRANTY
-
-  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
-OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
-OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
-PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-REPAIR OR CORRECTION.
-
-  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
-INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
-OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
-YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
-PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGES.
-
-		     END OF TERMS AND CONDITIONS
-
-	Appendix: How to Apply These Terms to Your New Programs
-
-  If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
-  To do so, attach the following notices to the program.  It is safest
-to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) 19yy  <name of author>
-
-    This program is free software; you can redistribute it and/or modify
-    it under the terms of the GNU General Public License as published by
-    the Free Software Foundation; either version 2 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU General Public License for more details.
-
-    You should have received a copy of the GNU General Public License
-    along with this program; if not, write to the Free Software
-    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
-
-Also add information on how to contact you by electronic and paper mail.
-
-If the program is interactive, make it output a short notice like this
-when it starts in an interactive mode:
-
-    Gnomovision version 69, Copyright (C) 19yy name of author
-    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-    This is free software, and you are welcome to redistribute it
-    under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, the commands you use may
-be called something other than `show w' and `show c'; they could even be
-mouse-clicks or menu items--whatever suits your program.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary.  Here is a sample; alter the names:
-
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
-  `Gnomovision' (which makes passes at compilers) written by James Hacker.
-
-  <signature of Ty Coon>, 1 April 1989
-  Ty Coon, President of Vice
-
-This General Public License does not permit incorporating your program into
-proprietary programs.  If your program is a subroutine library, you may
-consider it more useful to permit linking proprietary applications with the
-library.  If this is what you want to do, use the GNU Library General
-Public License instead of this License.

docs/abc/abcm2ps/dev/README

-		--- abcm2ps version 6.x.x ---
-
-Overview
-========
-
-abcm2ps is a program which converts music tunes from ABC format to
-PostScript or SVG. Based on abc2ps version 1.2.5 (see Contacts below),
-it was developped mainly to print barock organ scores which have
-independant voices played on one or many keyboards and a pedal-board
-(the 'm' of abcm2ps stands for many or multi staves/voices).
-
-
-Features
-========
-
-The main features of abcm2ps are quite the same as the abc2ps ones,
-but they are closer to the ABC standard 2.0 (draft IV - 14/8/2003):
-
-	http://abc.sourceforge.net/standard/abc2-draft.html
-
-
-Installation and usage
-======================
-
-The installation procedure is described in the file INSTALL.
-
-Basically, the program usage is:
-
-   abcm2ps [options] file1 [file1_options] file2 [file2_options] ...
-
-where file1, file2, .. are the ABC input files. This will generate
-a Postscript file (default name: 'Out.ps' - run 'abcm2ps -h' to
-know the list of the command line options).
-
-
-Documentation
-=============
-
-- options.txt contains the list of the command line options.
-
-- format.txt contains the list of the format parameters.
-
-- features.txt lists the differences from the current ABC standard.
-
-
-Differences with abc2ps
-=======================
-
-- the algorithms relative to voice and staff handling are different and
-  may give better or worse results depending on the tunes.
-
-- abcm2ps does not print the list of tunes and has different filtering
-  functions. On the command line:
-	- '-o' is implicit
-	- '-e' accepts only one parameter.
-	- '-C', '-R', '-S', '-T' don't exist anymore. If you want such
-	  filtering, you should to use some external script or program
-	  instead.
-
-- There is no interactive mode ('-i').
-
-- The scale is global (it was restricted to the music part in abc2ps).
-
-- The characters '\\' don't do a line break.
-
-- In landscape format, the values of 'pagewidth' and 'pageheight'
-  are internally exchanged, so there is no need to set them explicitely.
-
-- The format 'staffwidth' is obsolete. Use 'pagewidth' instead.
-
-- Look also in the file 'sample.abc' for other incompatibilities.
-
-
-Limits
-======
-
-Many limits may be changed at compilation time (number of voices, staves,
-..).
-
-
-Contacts
-========
-
-The primary abcm2ps site is:
-
-	http://moinejf.free.fr/
-
-Guido Gonzatto maintains Win32 and RedHat binaries and some more
-documentation at:
-
-	http://abcplus.sourceforge.net/
-
-abc2ps was developped by Michael Methfessel:
-
-	http://www.ihp-ffo.de/~msm/
-	mailto:msm@ihp-ffo.de
-
-To know more about the ABC notation, have a look at:
-
-	http://abcnotation.com/
-
-For any comment:
-	mailto:moinejf (at) free (dot) fr

docs/abc/abcm2ps/dev/accordion.abc

-% tablature examples
-% --- diatonic accordion
-%%beginps
-% length x y n accordh - accordion tablature header with 2 or 3 lines
-/accordh{
-%	/Times-Roman 14 selectfont
-	/nlines exch def
-	.8 SLW
-	gsave 20 add T /w exch def
-	0 0 M w 0 RL
-	0 3 M w 0 RL
-	0 21 M w 0 RL
-	0 39 M w 0 RL
-	nlines 2 eq{
-		0 42 M w 0 RL
-		stroke
-		/barh 42 def
-		3 7 M (T:) show
-		3 25 M (P:) show
-	}{
-		0 57 M w 0 RL
-		0 60 M w 0 RL
-		stroke
-		/barh 60 def
-		3 7 M (B/a:) show
-		3 25 M (T:) show
-		3 43 M (P:) show
-	}ifelse
-	grestore
-}!
-% string x y n accordn - accordion tablature
-/accordn{
-	-18 mul add barh add 3 add M showc
-}!
-/accordb{
-	0 eq{20 add M 0 barh RL stroke}
-	{pop pop}ifelse pop}!
-%%endps
-
-X:3
-T:Andro à Patrice Corbel
-N: validé 03/05/01 -- 04/08/02
-R:Andro
-O:Bretagne
-M:4/4
-K:Am
-%%tablature 70 accordh accordn accordb
- "A"A2 cA "F" aAce | "G"dGBd "C"e4 | "F"fedc "G"B2 AB |1 "F"cABc "E"B4 :|2 "F"cABc "A"A4 :|\
-w:    *  * * * * * *   8 6 7 8  7'   * * * *  * * *   * * * *  7   * * * *  *  
-w:    7  8 7 11 7 8 9   * * * *  *   8' 9 7' 8  6' 7 6'   8 7 6' 8  *   8 7 6' 8  7  
- "A"A2 GF "E"E3 B | "E"c2 d2 "C"e4 | "F"fedc "G"B2 AB |1 "F"cABc "E"B4 :|2 "F"cABc "A"A4 :|
-w:    * 6 *  4' 7   6' 8  7'   * * * *  * * *   * * * *  7   * * * *  *  
-w:    7 * 4'  * *   * *  *   8' 9 7' 8  6' 7 6'   8 7 6' 8  *   8 7 6' 8  7  
-
-X:51
-T:Jeune fille de quinze ans (50-51-52)
-T:Une fille de rose
-N: rev. 01/06/01
-R:hanter dro
-C:trad
-A:Bretagne
-O:France
-M:3/4
-L:1/8
-Q:100
-K:Am
-%%tablature 90 accordh accordn accordb
- |: "Am" ee/f/ "Am" ed "Am" c2   | "Am" ed/c/ "G" Bd "Am" cA | "Am" ee/f/ "Am" ed "Am" c2   |1 "Am" ed/c/ "G" BG "Em" E2 :|2 "Am" ed/c/ "G" BG "Am" A2 |
-w:     * * *  * *  * | * * *  7 8  * * | * * *  * *  * | * * *  7 6  4'| * * *  7 6  *  
-w:     9 9 8'  9 7'  8 | 9 7' 8  * *  8 7 | 9 9 8'  9 7'  8 | 9 7' 8  * *  * | 9 7' 8  * *  7  
-w: A a *  A a A~~a | A a * G g E e | A a *  A a A~~a | A a * G g E~~e | A a * G g E~~e | 
- |: "Am" AA/B/ "Am" cd "C" e2 | "G" de/f/ "F" af "Am" e2 | "Am" cd/e/ "F" fe "G" d2 |1 "G" Bc/d/ "Em" cB "Em" cB :|2 "G" Bc/d/ "Em" cB "Am" A2 ||
-w:     * * *  * *  7' | 8 7' *  * *  * | * * *  * *  8 | 7 6' 8  6' 7  6' 7 | 7 6' 8  6' 7  *  
-w:     7 7 6'  8 7' * | * * 8'  9' 8'  9 | 8 7' 9  8' 9  * | * * *  * *  * * | * * *  * *  7  
-w: A a * A a C~c | G g * F f A~a | A a * F f G~g | G g * E e E e | G g * E e A~a |  

docs/abc/abcm2ps/dev/chinese.abc

-% abcm2ps sample file with chinese characters
-
-% define the chinese utf-8 truetype font
-%%font UKaiCN-UTF8-H native
-
-% add the utf8 -> CID translator
-%%beginps nosvg
-/UKaiCN-UTF8-H /UniGB-UTF8-H [ /UKaiCN ] composefont pop
-%%endps
-
-% define some fonts
-%%titlefont UKaiCN-UTF8-H native 20
-%%subtitlefont UKaiCN-UTF8-H native 16
-%%textfont UKaiCN-UTF8-H native 16
-%%vocalfont UKaiCN-UTF8-H native 13
-%%wordsfont UKaiCN-UTF8-H native 16
-
-X: 1
-T: Green Island Serenade
-T: 绿岛小夜曲
-T: 綠島小夜曲
-T: Lǜ Dǎo Xiǎoyèqǔ
-T: Зелёный Остров
-T: جزيرة اخضرة
-C: Chen Chang-shou
-D: Vienna Teng "Warm Strangers"
-M: 4/4
-L: 1/8
-K: D
-A,2 \
-| "D"A3 B "(F#m)"A2 F2 | "A7"E2 {FE}DE "Bm"F3 E \
-| "G"DD2 B, "D"A,3 B, | "D"A,4 "(A7)"z4 \
-| "G"B,3 A, B,2 D2 | "A7"E2 {FE}DE "D"F3 A \
-| "Em"EE2 F "A7"A3 B | "D"A4 "(A7)"z4 |
-| "G"BB2 A "D"F2 FE | "Bm"DE F[AD] "F#m"F4 \
-| "Em"EE2 D "G"B,A, B,D | "A7"E4 z4 \
-| "D"FF2 E "Bm"FA F2 | "Em"EF ED "G"B,4 \
-| "D"A,A FE "A7"AB FE | "D"{E}D4 z4 |]
-[|"G"B>B BA "D"F F3 | "Em"EE2 D "G"B,A, B,D | "A7"E4 z4 \
-| "D"A>B AE "F#m"FF2 F | "Em"EE2 D "G"B,2 D2 | "D"A4 "A7"z3A |
-| "D"A2 {BA}FA "G"B3 d | "D"AB AF "Em"E4 \
-| "Bm"F2 ED "G"B,3 D | "A7"E2 {FE}DE "D"F3A \
-| "G"B3 F "A7"E3 F/E/ | "D"D4 z2 |]
-%
-W: 这绿岛像一隻船在月夜里摇呀摇
-W: 姑娘哟妳也在我的心海裡飘呀飘
-W: 让我的歌声随那微风吹開了妳的窗簾
-W: 让我的衷情随那流水不断的向妳倾诉
-W:
-W: 椰子树的长影掩不住我的情意
-W: 明媚的月光更照亮了我的心
-W: 这绿岛的夜已经这样沉静
-W: 姑娘哟妳为什么还是默默无语
-W:
-W: zhè lǜ dǎo xiàng yī zhī chuàn, zài yué yè lǐ yáo ya yáo.
-W: gū niang yo, nǐ ye zài wǒde xīn hǎi lǐ piao ya piao.
-W: ràng wǒde ge sheng sui na wei feng, chui kai le nǐ de chuang lian.
-W: ràng wǒde zhong qing sui na liu shui, bu duan de xiang nǐ qing su.
-W:
-W: ye zi shu de chang ying yan bu zhu wǒde qing yi;
-W: mìng mèi de yuè guang geng zhao liang le wǒde xīn.
-W: zhe lǜ dao de ye yi jing zhe yang de chen jing
-W: gū niang ya, nǐ wei shen ma hai shì muò muò wú yǚ?
-W:
-W: This Green Island is like a boat, floating in the moonlight,
-W: My darling, you too are floating in the sea of my heart,
-W: Let the sound of my song follow the breeze, blowing open the curtain of your window,
-W: Let my love follow the flowing water, endlessly pouring out its feelings for you.
-W:
-W: The long shadows of the palm trees cannot conceal my love,
-W: The bright beauty of the moonlight casts its brilliance into my heart.
-W: This Green Island night is so calm and serene,
-W: My darling, why are you silent, saying nothing?

docs/abc/abcm2ps/dev/deco.abc

-%!! here is an experimental decoration extension !!
-%!! syntax may change in next releases !!
-%
-% this option is required for !trem!
-% %setdefl 1
-%
-% == postscript definitions - must be before any tune ==
-%
-%%beginps
-% -- cresc / decresc / dimin
-/crdc{		% usage: str x y crdc - cresc, decresc, ..
-	/Times-Italic 14 selectfont
-	M -6 4 RM show}!
-%
-% -- alternate piano/forte indication between parenthesis
-/apf{		% usage: str x y apf
-	M -6 5 RM
-	/Times-Italic 16 selectfont(\()show
-	/Times-BoldItalic 16 selectfont show
-	/Times-Italic 16 selectfont(\))show}!
-%
-% -- draw parenthesis around a note
-/opnot{		% usage: x y opnot
-	M -5.5 -3 RM /Times-Roman 15 selectfont(\(   \))show}!
-% -- same, but inside a chord (x is not the same)
-/opchnot{	% usage: x y opchnot
-	M -10.5 -3 RM /Times-Roman 15 selectfont(\(   \))show}!
-%
-% -- sforzando accent
-/sfa{		% usage: x y sfa	
-	1.2 SLW M -2.4 4.8 RM
-	2.4 8.0 RL
-	2.4 -7.4 RL
-	-1.0 0.0 RL
-	-1.8 6.4 RL
-	stroke}!
-%
-% -- draw octava indication
-/octava{	% usage: w x y octava
-	exch -10 add exch 2 copy
-	M 0 10 RM /Times-Roman 16 selectfont(8)show
-	/Times-Roman 12 selectfont(va)show
-	M 0 6 RL currentpoint stroke M
-	[6] 0 setdash 30 add 0 RL currentpoint stroke M
-	[] 0 setdash 0 -6 RL stroke}!
-/octavab{	% usage: w x y octavab
-	exch -14 add exch 2 copy 
-	M 0 2 RM /Times-Roman 16 selectfont(8)show
-	/Times-Roman 12 selectfont(va basso)show
-	22 add M 0 -6 RL currentpoint stroke M
-	[6] 0 setdash 30 add 0 RL stroke
-	[] 0 setdash}!
-%
-% -- write big letters (position marks) above the staff
-% (from Guido Gonzato)
-/bigl{		% usage: str x y bigl
-	/Times-Bold 26 selectfont
-	4 add M showc
-	1 SLW 1 -2 RM 
-	0 22 RL -22 0 RL
-	0 -22 RL 22 0 RL stroke}!
-% (from Jonas Petersson)
-/biglc{		% usage: str x y biglc
-	2 copy 5 2 roll /Times-Bold 22 selectfont
-	6 add M showc
-	1 SLW 13 add newpath
-	12 0 360 arc stroke}!
-%
-% -- pedal glyph
-% (from CMN http://ccrma-www.stanford.edu/software/cmn/cmn/cmn.html)
-/ped{		% usage: str x y ped
-	gsave 4 add exch -10 add exch T 26 dup scale
-	0.368 0.074 moveto
-	0.341 0.121 0.335 0.147 0.371 0.203 curveto
-	0.435 0.289 0.531 0.243 0.488 0.155 curveto
-	0.472 0.117 0.434 0.096 0.414 0.080 curveto
-	0.429 0.038 0.494 -0.006 0.541 0.075 curveto
-	0.559 0.123 0.558 0.224 0.663 0.252 curveto
-	0.603 0.354 0.449 0.393 0.461 0.405 curveto
-	0.902 0.262 0.705 -0.124 0.555 0.046 curveto
-	0.488 -0.032 0.417 0.021 0.389 0.055 curveto
-	0.303 -0.018 0.303 -0.020 0.248 0.040 curveto
-	0.218 0.108 0.191 0.062 0.164 0.047 curveto
-	0.010 -0.056 0.032 0.019 0.124 0.062 curveto
-	0.229 0.117 0.200 0.091 0.228 0.195 curveto
-	0.240 0.241 0.149 0.250 0.166 0.311 curveto
-	0.207 0.493 lineto
-	-0.041 0.441 0.049 0.261 0.126 0.387 curveto
-	0.138 0.381 lineto
-	-0.020 0.119 -0.100 0.472 0.220 0.507 curveto
-	0.548 0.486 0.399 0.171 0.254 0.374 curveto
-	0.264 0.384 lineto
-	0.338 0.259 0.521 0.449 0.228 0.488 curveto
-	0.198 0.356 lineto
-	0.181 0.304 0.273 0.294 0.262 0.241 curveto
-	0.229 0.101 lineto
-	0.273 0.070 0.282 -0.038 0.368 0.074 curveto
-	0.391 0.094 moveto
-	0.456 0.130 0.476 0.171 0.468 0.213 curveto
-	0.452 0.276 0.333 0.171 0.391 0.094 curveto
-	0.627 0.019 moveto
-	0.533 0.041 0.586 0.228 0.678 0.229 curveto
-	0.729 0.170 0.712 0.025 0.627 0.019 curveto
-	eofill
-	0.8 0.04 0.04 0 360 newpath arc fill
-	pop grestore}!
-%
-% -- pedal off glyph
-% (from CMN http://ccrma-www.stanford.edu/software/cmn/cmn/cmn.html)
-/pedoff{	% usage: str x y ped
-	gsave 4 add exch -5 add exch T 26 dup scale
-	0.219 0.198 moveto
-	0.231 0.172 0.195 0.138 0.162 0.173 curveto
-	0.149 0.219 0.206 0.231 0.219 0.198 curveto
-	0.144 0.242 moveto
-	0.166 0.223 0.193 0.230 0.181 0.267 curveto
-	0.178 0.306 0.144 0.302 0.151 0.335 curveto
-	0.160 0.381 0.225 0.377 0.224 0.330 curveto
-	0.228 0.302 0.198 0.306 0.197 0.267 curveto
-	0.194 0.237 0.213 0.222 0.237 0.247 curveto
-	0.263 0.276 0.234 0.297 0.268 0.322 curveto
-	0.314 0.347 0.354 0.297 0.316 0.259 curveto
-	0.296 0.237 0.273 0.266 0.246 0.237 curveto
-	0.223 0.217 0.232 0.194 0.266 0.197 curveto
-	0.303 0.202 0.302 0.232 0.332 0.228 curveto
-	0.381 0.232 0.388 0.156 0.332 0.152 curveto
-	0.302 0.148 0.302 0.185 0.266 0.183 curveto
-	0.231 0.186 0.228 0.169 0.245 0.143 curveto
-	0.273 0.116 0.297 0.141 0.316 0.117 curveto
-	0.350 0.075 0.303 0.029 0.258 0.062 curveto
-	0.237 0.082 0.261 0.102 0.233 0.133 curveto
-	0.212 0.151 0.194 0.147 0.197 0.113 curveto
-	0.203 0.075 0.232 0.075 0.230 0.043 curveto
-	0.223 -0.004 0.159 -0.002 0.152 0.042 curveto
-	0.148 0.075 0.185 0.076 0.183 0.113 curveto
-	0.183 0.147 0.163 0.150 0.141 0.133 curveto
-	0.113 0.104 0.140 0.079 0.113 0.059 curveto
-	0.069 0.037 0.033 0.077 0.063 0.117 curveto
-	0.082 0.141 0.104 0.117 0.132 0.142 curveto
-	0.153 0.163 0.144 0.188 0.113 0.182 curveto
-	0.073 0.182 0.075 0.147 0.046 0.152 curveto
-	-0.003 0.152 -0.003 0.227 0.048 0.227 curveto
-	0.075 0.231 0.075 0.198 0.113 0.196 curveto
-	0.141 0.197 0.147 0.207 0.133 0.237 curveto
-	0.102 0.264 0.082 0.237 0.062 0.261 curveto
-	0.028 0.302 0.077 0.347 0.118 0.318 curveto
-	0.138 0.297 0.116 0.275 0.144 0.242 curveto
-	fill pop grestore}!
-%
-% -- glissendo
-/gliss{	% usage: x2 y2 x1 y1 gliss
-	gsave exch 13 add exch 2 copy T 0 0 M
-	exch 4 -1 roll exch sub 3 1 roll sub	% dx dy
-	2 copy exch atan dup rotate	% dx dy alpha
-	exch pop cos div		% len
-% 	9 sub 0 RL			% simple line
-	9 sub 0 8 3 -1 roll{		% squiggly line
-		2 -1.15 2.30 150 30 arcn 4 0 T
-		2 1.15 2.30 -150 -30 arc 4 0 T pop
-	}for
-	1 SLW stroke grestore}!
-%
-% -- upper glissendo
-/glissup{	% usage: x y glissup
-	gsave T 5 0 T
-	25 rotate 10 0 T 0 0 M
-	0 8 8{
-		2 -1.15 2.30 150 30 arcn 4 0 T
-		2 1.15 2.30 -150 -30 arc 4 0 T pop
-	}for
-	1 SLW stroke grestore}!
-%
-% -- note decorations
-% (sorry for I don't know the name of these: there so many ones)
-% The convention I use here is:
-%	- t2 or t3: mordent with 2 or 3 peeks
-%	- ta or tb: turn from above or from below
-%	- b, ub or db: middle, upper or lower bar
-/tr3{		% usage: x y tr3 - mordent with 3 peeks
-	M 2.2 2.2 RL 2.1 -2.9 RL 0.7 0.7 RL
-	2.2 2.2 RL 2.1 -2.9 RL 0.7 0.7 RL
-	2.2 2.2 RL 2.1 -2.9 RL 0.7 0.7 RL
-	-2.2 -2.2 RL -2.1 2.9 RL -0.7 -0.7 RL
-	-2.2 -2.2 RL -2.1 2.9 RL -0.7 -0.7 RL
-	-2.2 -2.2 RL -2.1 2.9 RL -0.7 -0.7 RL fill}!
-/t2ub{		% usage: x y t2ub - mordent ending with an upper bar
-	2 copy umrd 0.6 SLW
-	M 5 4 RM 0 6 RL stroke}!
-/t3tab{		% usage: x y t3tab - mordent + upper turn and bar
-	4 add 2 copy exch 7.5 sub exch tr3 exch 7.5 add exch
-	2 copy 0.6 SLW M 2 6 14 6 16 0 RC
-	M 8 1 RM 0 6 RL stroke}!
-/ubt3ta{	% usage: x y ubt3ta - up bar + mordent + upper turn
-	4 add 2 copy 0.6 SLW
-	M -7.5 0 RM 0 6 RL stroke
-	2 copy exch 7.5 sub exch tr3
-	M 7.5 0 RM 2 6 14 6 16 0 RC stroke}!
-/tbt3{		% usage: x y tbt3 - low turn + long mordent
-	exch 10 sub exch 6 add 2 copy 0.6 SLW
-	M -8 0 RM 2 -6 14 -6 16 0 RC stroke
-	exch 8 add exch tr3}!
-/t2ta{		% usage: x y t2ta - mordent + upper turn
-	2 copy umrd
-	M 5 4 RM 1 5 9 5 10 0 RC stroke}!
-/t3b{		% usage: x y t3b - upper + lower mordent
-	2 copy exch -7.5 add exch 4 add tr3 0.6 SLW
-	M 2.5 0 RM 0 8 RL stroke}!
-/sharp{		% usage: x y sharp - sharp above note
-	4 add gsave T 0.6 dup scale 0 0 sh0 grestore}!
-/flat{		% usage: x y flat - flat above note
-	4 add gsave T 0.6 dup scale 0 0 ft0 grestore}!
-/natural{	% usage: x y natural - natural sign above note
-	4 add gsave T 0.6 dup scale 0 0 nt0 grestore}!
-%
-% -- 'treble-8' customization
-/octl{
-	/Times-BoldItalic 16 selectfont M 5.5 -14 RM(8vb)show}!
-%
-% -- latin guitar chords
-/gcshow{
-	dup 0 get
-	dup dup 65 ge exch 71 le and{
-		65 sub[(La)(Si)(Do)(Ré)(Mi)(Fa)(Sol)]exch get
-	}if show
-	dup length 1 sub 1 exch getinterval show}!
-%
-% -- 'tr' + long trill
-/trtrill{	% usage: w x y trtrill
-	2 copy trl
-	3 1 roll 9 add 3 1 roll 9 sub 3 1 roll 2 add ltr}!
-%
-% -- guitar diagrams
-/guitar{	% usage: x y guitar
-	gsave exch 10 sub exch 8 add T
-	1.5 SLW -0.3 24.6 M 20.6 0 RL stroke
-	0.6 SLW 0 0 M 20 0 RL 0 6 M 20 0 RL
-	0 12 M 20 0 RL 0 18 M 20 0 RL
-	0 0 M 0 24 RL 4 0 M 0 24 RL 8 0 M 0 24 RL
-	12 0 M 0 24 RL 16 0 M 0 24 RL 20 0 M 0 24 RL
-	stroke 0.5 SLW}!
-/gdot{newpath 1.4 0 360 arc fill}!
-/gx{28 M -1.3 -1.3 RM 2.6 2.6 RL 0 -2.6 RM -2.6 2.6 RL stroke}!
-/go{28 newpath 1.5 0 360 arc stroke}!
-/Dm{		% usage: x y Dm
-	guitar
-	0 gx 4 gx 8 go
-	20 21 gdot 12 15 gdot 16 9 gdot
-	grestore}!
-/Bb{
-	guitar
-	0 gx 20 gx
-	4 21 gdot 8 9 gdot 12 9 gdot 16 9 gdot
-	grestore}!
-/C7{
-	guitar
-	0 gx 20 go
-	16 21 gdot 8 15 gdot 4 9 gdot 12 9 gdot
-	grestore}!
-%
-% -- arpeggio variations
-%	arpeggio with arrow 1st version
-/arpu{	2 copy 4 index add M -6.5 0 RM 2.5 5 RL 2.5 -5 RL fill
-	arp}!
-/arpd{	2 copy M -6.5 0 RM 2.5 -5 RL 2.5 5 RL fill
-	arp}!
-%	arpeggio with arrow other version
-% /arpu{	2 copy 4 index add M -7 0 RM 3 5 RL 3 -5 RL
-%	0.7 SLW stroke arp}!
-% /arpd{	2 copy M -7 0 RM 3 -5 RL 3 5 RL
-%	0.7 SLW stroke arp}!
-%	arpeggio crossing the staves
-% (! this works because the decoration are drawn sorted by time !)
-/arps{		% arpeggio start - stack: h x ylow
-	exch /x exch def	% memorize 'x'
-	add /y exch def}!	% memorize the upper vert offset
-/arpe{		% arpeggio end - stack: h x ylow
-	3 -1 roll pop		% discard 'h'
-	exch dup x gt {pop x} if exch	% have room for accidentals
-	y 1 index sub 3 1 roll	% new height
-	arp}!
-%
-% -- optional breath
-/brth{6 add /xbr 2 index def /ybr 1 index def
-	/Times-BoldItalic 30 selectfont M (,) show}!
-/opbrth{pop pop xbr 10 sub ybr 5 sub
-	/Times-Roman 20 selectfont M (\(  \)) show}!
-%
-% -- head decorations / replacement
-% lower mordent
-/hlmrd{		% usage: x y hlmrd
-	exch 12 sub exch 4 sub lmrd}!
-% small note head
-/shd{		% usage: x y shd
-	M 3 1.3 RM
-	-1 2.5 -6.5 0 -5.5 -2.5 RC
-	1 -2.5 6.5 0 5.5 2.5 RC fill}!
-% -- measure bar between two staves (1 and 2)
-/hbar{		% usage: x y hbar
-	dlw pop dup 0 y0 M 24 y1 lineto stroke}!
-%%endps
-%
-% == decoration definitions ==
-%
-% actual syntax (see format.txt):
-%	%%deco <name> <c_func> <ps_func> <h> <wl> <wr> [<str>]
-%
-% -- accent near the note / sforzando
-%%deco accn 0 accent 8 4 4
-%%deco sfa 3 sfa 12 5 5
-%
-% -- dynamic indication below the staff
-%%deco fp 6 pf 18 5 11 fp
-%%deco cresc 6 crdc 20 4 28 Cresc.
-%%deco decresc 6 crdc 20 4 32 Decresc.
-%%deco dimin 6 crdc 20 4 28 Dimin.
-%%deco riten 6 crdc 20 8 40 Poco riten.
-%
-% -- dynamic indication below the staff between parenthesis
-%%deco (p) 6 apf 20 8 16 p
-%%deco (pp) 6 apf 20 8 24 pp
-%%deco (f) 6 apf 20 8 16 f
-%%deco (ff) 6 apf 20 8 24 ff
-%
-% -- repeat indication above the staff
-%%deco alcoda 3 dacs 20 0 0 al Coda
-%
-% -- who asked for a Pedal indication ?
-%%deco ped 6 ped 20 0 0
-%%deco ped-end 6 pedoff 20 0 0
-%
-% -- optional note
-%%deco () 1 opnot 0 0 0
-%
-% -- start / stop of octava indication
-%%deco 8( 5 - 24 0 0
-%%deco 8) 5 octava 24 0 0
-%%deco 8b( 7 - 24 0 0
-%%deco 8b) 7 octavab 24 0 0
-%
-% -- big letters
-%%deco biga 3 bigl 20 0 0 A
-%%deco bigb 3 biglc 20 0 0 B
-% ...
-%
-% -- glissendo
-%%deco -( 1 - 0 0 0
-%%deco -) 1 gliss 0 0 0
-%%deco - 1 glissup 0 2 10
-%
-% -- note decorations
-%%deco t2ub 3 t2ub 12 5 5
-%%deco t3tab 3 t3tab 12 8 24
-%%deco ubt3ta 3 ubt3ta 12 8 24
-%%deco tbt3 3 tbt3 14 14 18
-%%deco t2ta 3 t2ta 12 5 15
-%%deco t3b 3 t3b 12 5 15
-%%deco # 3 sharp 8 0 0
-%%deco b 3 flat 8 0 0
-%%deco = 3 natural 8 0 0
-%%deco = 3 natural 8 0 0
-%
-% -- 'tr' + long trill
-%%deco tr( 5 - 11 0 0
-%%deco tr) 5 trtrill 11 0 0
-%
-% -- guitar chords
-%%deco Dm 3 Dm 36 0 0
-%%deco Bb 3 Bb 36 0 0
-%%deco C7 3 C7 36 0 0
-%
-% -- arpeggios
-%%deco arpu 2 arpu 0 0 0
-%%deco arpd 2 arpd 0 0 0
-%%deco arps 2 arps 0 0 0
-%%deco arpe 2 arpe 0 0 0
-%
-% -- optional breath
-%%deco opbrth 3 opbrth 0 0 0
-%
-% -- head decorations
-%%deco op 1 opchnot 0 0 0	% optional head
-%%deco m 0 hlmrd 0 0 0		% lower mordent on the left
-%%deco head-x 0 dsh0 0 0 0	% X head
-%%deco head-shd 0 shd 0 0 0	% small head
-%
-% -- measure bar between two staves
-%%deco hbar 3 hbar 0 0 0
-
-X:1
-T:Customized decorations
-M:C
-L:1/8
-K:C treble-8
-!biga!y!fp!"C"C!t2ub!C !cresc!"D"D!t3tab!D !decresc!"E"E!ubt3ta!E !dimin!"F"F!tbt3!F|\
-!mp!"G"G!t2ta!G !(p)!A!t3b!c T!b!!(pp)!A2 P!#!!(f)!B2|M!=!!(ff)!c8|
-%
-K: clef=treble
-!8(!!riten!EF !-!G2 !ped!GA!ped-end!B!8)!c|!8b(!!bigb!C2!()!E2 !tr(!G3!tr)!!8b)!c!alcoda!|\
-CE!-(!G2!-)!C2c2|
-%
-"Dm"!Dm!e3/d/ d6 | "Bb"!Bb!z2 d/d3/ "C7"!C7!cB/A/- AG |\
-F!accent!G!accn!AB !sfa!c4||
-
-X:3
-T:Decorations with abcm2ps 4.x.x
-M:C
-L:1/4
-%%staves {1 2}
-K:C
-V:1
-!arpu![!op!C!op!Gc]4 !hbar![] !breath!!opbrth!!arpd![CGc]4 |\
-	!arps![CGc]4 | z3/[!head-x!B]/ [c!m!eg]2 | c4 ||
-V:2
-!arpeggio![C,,G,,C,]4 [] [C,,G,,C,]4 |\
-	!arpe![C,,G,,C,]4 | [C,,!head-shd!C,][G,,!head-shd!G,]C,2 | C,4 ||

docs/abc/abcm2ps/dev/features.txt

-	Features of abcm2ps 7.0.8 (J.F. Moine, May 2012)
-	================================================
-
-abcm2ps tries to follow the ABC standard version 2.1 (december 2011):
-
-	http://abcnotation.com/wiki/abc:standard:v2.1
-
-Here are listed only the differences from the standard.
-
-
-Features not implemented.
-========================
-
-Information fields.
-
-	- The continuation field ('+:') is implemented for w: only.
-
-	- The charsets iso-8859-5 .. iso-8859-8 are not implemented.
-
-Tune body.
-
-[H	- The following decorations are not implemented:
-		!dacoda!, !dacapo!
-
-	- 'U:' fields cannot contain guitar chord nor annotations.
-
-	- The values assigned by the 'U:' field are always global (they
-	  are not restored at end of tune).
-
-	- Multiple measure overlay (as '&&') is not implemented.
-	  Use the '(& .. & .. & .. &) extension instead.
-
-Data format.
-
-	- The HTML sequences are not implemented.
-
-	- The unicode '\Uxxxxxxxx' 32 bits character is not implemented.
-	  Use the UTF-16 surrogates instead.
-
-
-Features that work differently.
-===============================
-
-File structure.
-
-	- The X: header field may be omitted in tunebooks in which case
-	  a tune starts on a T: header field.
-
-	- The T: header field may be omitted when 'X:' is present.
-
-	- There is no notion of 'file header': any valid ABC field
-	  found outside the tunes is considered as global, and applies
-	  to the remaining tunes.
-
-Information fields.
-
-	- In a tune body, the lines beginning with a letter in range A-G
-	  or a-g and immediately followed by a colon are interpreted as
-	  information fields.
-
-	- When the %%abc-version is different from '2.0', the field 'A:' is
-	  'Area', and not 'Author of lyrics'. It is displayed only when
-	  'infoline' is set.
-
-	- In 'K:' fields, the list of accidentals may be 'none' (for
-	  no accidental).
-
-	- In 'U:' fields, the character may be
-	  '\ ' (back-slash - space) to redefine the character space, or
-	  '\t' (back-slash - t) to redefine the character tabulation.
-	  The default value of these characters is !beambreak! (see below).
-
-	- In 'U:' fields, !none! means that the character must not appear
-	  in the body.
-
-	- In 'U:' fields, !nil! means that the character is ignored.
-	  This is the default value for the character '`' (back-quote).
-
-	- In 'U:' fields, !beambreak! means that the character stops note
-	  beaming. This is the default value for the characters '\ '
-	  (space) and '\t' (tabulation).
-
-Tune body.
-
-	- Some bar lines are drawn as defined (ex: ':|:'), some other
-	  ones are expanded, as '|::' to '[|::'.
-
-	- The decorations on notes inside chords cannot be standard ones
-	  because their offset is relative to the note they are attached to,
-	  and not to the chord. They must be explicitly defined by %%deco
-	  and %%postscript.
-
-	- '@' in annotations must be followed by the <x> and <y> offsets
-	  of the text from the note position (in points). The <x> and <y>
-	  values are separated by a comma, and <y> may be followed by a
-	  space (usefull if the text begins with a digit, a dot or the
-	  letters 'E' or 'e' - see sample3.abc for an example).
-
-	- Grace notes may appear before any symbol and may contain
-	  chords. Their note lengths are handled. The unit note length
-	  is not tied to L: (or M:). Instead, for compatibility, it is:
-		- a quaver for a single note and
-		  a semi-quaver for many notes in standard tunes,
-		- a demi-semi-quaver in bagpipe tunes.
-	  Grace notes greater than crotchets are drawn as crotchets.
-
-	- Tuplets values may be greater than 9.
-
-	- Tuplets may be nested.
-
-Clefs.
-
-	- When 'clef=' is present, the clef name may be a note with its
-	  pitch optionnaly followed by the staff line on which it is defined.
-	  The note may be only 'G' (treble clef), 'C' (alto clef)
-	  or 'F' (bass clef).
-	  The two following definitions are equivalent:
-		K: clef=f
-		K: bass middle=d
-
-Multiple voices.
-
-	- When the voices are synchronized, a P: field alone in a line
-	  (not enclosed by '[' and ']') is set in the first voice, without
-	  changing the current voice. This fixes the common error:
-		P:A
-		V:1
-		..
-		V:2
-		..
-		P:B		% misplaced P: (in voice 2)
-		V:1
-		%		should be here
-		..
-		V:2
-		%		and normally repeated here
-		..
-
-ABC Stylesheet specification.
-
-	- The star ('*' = floating voice) is not treated in '%%score'.
-
-	- '%%staves' coexists with '%%score'.
-	  The differences in '%%staves' are:
-		- measure bars are drawn between staves when there is
-		  no '|' between the voice names (this feature is inverted
-		  in %%score).
-		- A floating voice may be only the second one in a
-		  3 voices brace.
-
-	- Some formatting directives are not implemented, and some new
-	  ones are defined. See the file 'format.txt' for details.
-
-
-Extensions.
-==========
-
-File structure.
-
-	- Lines starting with '\' (back-slash) are ignored (abc2mtex
-	  compatibility).
-
-Information fields.
-
-	- The field 'M:' may specify more complex meters with a
-	  combination of digits, parenthesis, slashes and blanks.
-	  It may also specify ancient meters as 'M:2' or 'M:3',
-	  and also 'M:o' (perfect minor), 'M:o.' (perfect major),
-	  'M:c' (imperfect minor) and 'M:c.' (imperfect major).
-	  An explicit measure duration may be specified putting its
-	  value after an '=' sign (ex: 'M:C|=2/1').
-
-	- The field 'd:' is the same as 's:' (symbol line).
-
-Tune body.
-
-	- Microtone pitches are indicated by a fraction after an
-	  accidental, as "^3/4c". When omitted, the numerator defaults
-	  to 1 and the denominator to 2 ("^/c" is the same as "^1/2c").
-	  The numerator and denominator cannot be greater than 256.
-	  Support exists for 1/2 and 3/2 sharps and flats. For other
-	  values, PostScript functions must be defined (by %%postscript).
-	  The name of such a function is:
-		<accidental_type><micro_value>
-	  where:
-		  - <accidental_type> is "sh" (sharp) or "ft" (flat)
-			(may be also "nt", "dsh" or "dft" !)
-		  - <micro_value> is computed from the fraction as:
-			( <numerator> - 1 ) * 256 + <denominator> - 1
-
-	- A note length starting with '0' (zero') indicates a stemless
-	  note.
-
-	- A space ('y') may be followed by a width in points.
-	  The default width is 20 pts.
-
-	- '[]' is the same as '[|]' (invisible bar).
-
-	- ':' (colon alone) is the same as '.|' (dotted bar).
-
-	- Repeat bars may contain a set of digits, '-' (hyphen),
-	  ',' (comma) or '.' (dot), or even a free string. Ex:
-		|: ... [1,3 ... :|2,4-6 ... :|["last time" ...
-	  (note that a '[' is needed before the string - this one may
-	   be empty).
-
-	- There may be slurs from notes to grace notes and reverse.
-
-	- Opening slurs ("(") may be followed by "'" or "," to force their
-	  direction (above or below).
-
-	- The tie character ("-") may be followed by "'" or "," to force
-	  the tie direction (above or below).
-
-	- The following decorations are added:
-		!beamon!	do not break beaming (on a measure bar)
-		!beambr1! and !beambr2!
-				let only 1 or 2 beams from the previous note
-		!gmark!		grace mark ('~' like sign)
-		!invisible!	prevent a note to be displayed
-		!rbstop!	stop here the current repeat bracket
-		!trem1! .. !trem4!
-				tremolo (on the second of a couple of notes
-				- see sample4.abc for example)
-		!xstem!		draw a stem up to the note on the previous
-				staff
-		!/! .. !///!	tremolo on one note
-
-	- There may be decorations on grace notes.
-
-	- Multiple lines of guitar chord / annotation may also be
-	  indicated by '\n' or ';' in which case, the lines are of
-	  the same type (gchord or annotation).
-	  The 3 next notations are equivalent:
-		"_ann1" "_ann2" "G3" "4" G
-		"_ann1;ann2" "G3;4" G
-		"_ann1\nann2" "G3\n4" G
-	  (annotation on 2 lines and guitar chord on 2 lines)
-	  The two next notations are NOT equivalent:
-		"_ann1" "G"
-		"_ann1;G"
-	  (in the 1st line, 'G' is a guitar chord, in the 2nd one,
-	  it is the 2nd line of the annotation)
-	  A new annotation type may be indicated after the new line as:
-		"^above;_below"
-
-Clefs.
-
-	- 'clef=P' is the same as 'perc'.
-
-	- When the clef name is 'perc' (or 'P'), accidentals change the
-	  note head glyph. By default, sharp notes are drawn as a 'x'
-	  and flat notes as a circled 'x'. This behaviour may be changed
-	  redefineding the PostScript functions 'pshhd' and 'pfthd', or
-	  defining 'pnthd' (natural), 'pdshhd' (double sharp) and
-	  'pdfthd' (double flat).
-
-	- When no clef is specified, clef changes are automatically
-	  inserted when needed ('bass' or 'treble').
-
-	- The clef name may be enclosed by double quotes in which case
-	  it is the name of a PostScript function which will draw the
-	  clef. This function arguments are the x and y offsets.
-
-Multiple voices.
-
-	- 'stem=auto' and 'gstem=auto' in a V: field re-enables the
-	  automatic computation of the direction of the stems (default
-	  values).
-
-	- 'gstem=up' or 'gstem=down' in a V: field forces the direction
-	  of the stems of the grace notes.
-
-	- For compatibility with previous abcm2ps version, V: fields may
-	  contain:
-		- 'gchord=up' (default) and 'gchord=down'
-		  which forces the display of guitar chords above or
-		  below the staff,
-
-		- 'dyn=up', 'dyn=down' or 'dyn=auto'
-		  which forces the place of the dynamic marks (above
-		  or below the staff - default is 'auto').
-
-		- 'lyrics=up', 'lyrics=down' or 'lyrics=auto'
-		  which forces the place of the lyrics (above or below
-		  the staff - default is 'auto').
-	  (use pseudo comments instead - see format.txt)
-
-	- 'staffscale=<value>' in a V: field sets the scale of the
-	  associated staff. The default value is '1'.
-
-	- 'merge' in a V: field makes the voice to go on the same staff
-	  as the previous voice (BarFly compatibility).
-
-	- The BarFly voice switch in tune ('V:x <notes>', i.e.
-	  voice + notes on the same line) may work.
-
-	- The operator '(&...&...&)' permits voice overlay on many
-	  measures. See sample3.abc for an example.
-
-Data format.
-
-	- The guitar chords and annotations may contain '\#', '\b' and '\='
-	  to display accidentals.
-
-	- Strings may contain characters from '\001' to '\005' to display
-	  accidentals. For compatibility, the values '\201' to '\205'
-	  are handled the same way.
-
-	- In quoted string, the '%' does not need to be escaped.
-
-Deprecated ABC syntax.
-
-	- Most of the deprecated ABC syntax is supported.
-
-	- Some incompatible syntaxes are handled according to the ABC version
-	  of the file as the ABC 2.0 continuation mechanism.

docs/abc/abcm2ps/dev/format.txt

-			Format parameters
-			=================
-
-The general layout of the printed scores may be changed in four ways:
-	1- at compilation time setting the values in abc2ps.h,
-	2- at running time in a 'format' file,
-	3- at startup time in the command line,
-	4- by pseudo-comments inside the tunes.
-
-For more about 3), have a look at options.txt.
-
-A format file contains lines giving the parameters values, format:
-
-	parameter [parameter list]
-
-In a format file, empty lines and lines starting with '%' are ignored.
-
-The pseudo-comments used for formatting have the format:
-
-	%%parameter [parameter list]
-
-Format parameters may appear in the command line as:
-
-	--parameter [parameter list]
-
-The keyword "lock" may appear at the end of the parameter list, in
-which case, the parameter will not be settable anymore (except with
-"lock" again). It is implicitly added in the command line parameters.
-
-Some pseudo-comments are treated while being parsed and cannot appear
-in a format file nor in the command line. These ones are listed at the
-end of this file.
-
-In font definitions, <font>, <encoding> and <size> may be specified
-as '*' (star), in which case the font, encoding or size remains
-the same. When the <encoding> is omitted, it defaults to 'utf-8'
-or to the last 'font' definition of the same font. The <encoding> values
-are described in 'annotationfont'.
-
-
-List of the format parameters
------------------------------
-
-  abc2pscompat <bool>
-	Default: 0
-	Compilation: none
-	Command line: -u
-	Description:
-		When true, set 'M' as the +tenuto+ decoration and do a
-		pitch translation for the bass and alto clefs.
-
-  alignbars <int>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		Align the bars of the next <int> music lines.
-		Such an alignment works only when there is only one
-		voice in each music line (no V:, %%staves or %%score
-		is allowed).
-
-  aligncomposer <int>
-	Default: 1
-	Compilation: none
-	Command line: none
-	Description:
-		Tell where to display the composer field.
-		A negative value means 'on the left', 0 means 'center',
-		and a positive value means 'on the right'.
-			
-
-  annotationfont <font> [<encoding>] [<size>]
-	Default: Helvetica 12
-	Compilation: none
-	Command line: none
-	Description:
-		Set the annotation font to <font> with a size <size>.
-		When present, <encoding> may be either 'us-ascii', 'utf-8'
-		or 'native'. It is used only for PostScript output without
-		pango. When the <encoding> is not 'native', a PostScript
-		convertion table is build to handle most latin characters.
-		It may be extended to handle more characters, but a good
-		PostScript knowledge is required (see the file sample.abc).
-
-  autoclef <bool>
-	Default: 1
-	Compilation: none
-	Command line: none
-	Description:
-		When true, set the clefs and possibly insert clef
-		changes when no clef is defined in K: or V:.
-
-  barnumbers <int>
-	Same as 'measurenb'.
-
-  barsperstaff <int>
-	Default: 0
-	Compilation: none
-	Command line: -B<int>
-	Description:
-		Try to typeset with <int> bars on each line.
-
-  breakoneoln <bool>
-	Default: 1
-	Compilation: none
-	Command line: none
-	Description:
-		When set, on finding an end of line (eoln), do as if
-		a space was set before the next note or rest.
-		This prevents a beam to be continued between two
-		music lines.
-
-  beginps
-	Default: none
-	Compilation: none
-	Command line: none
-	Description:
-		Start a PostScript sequence which ends on 'endps'.
-		This parameter may be found only in a format or a ABC
-		file (it cannot appear in the command line).
-		Each line between 'beginps' and 'endps' is included in
-		the PostScript output file.
-		Such a sequence cannot be greater than 128 Kb.
-		When the output file format is SVG (command options '-g',
-		'-v' or '-X'), the PostScript code is executed by the
-		small abcm2ps PS interpreter. Sequences which cannot
-		be executed (as font redefinitions) must be skipped
-		checking the presence of the symbol 'svg':
-
-		/svg where {pop} {
-		.. PostScript code which cannot be executed by abcm2ps ..
-		} ifelse
-
-  beginsvg
-	Default: none
-	Compilation: none
-	Command line: none
-	Description:
-		Start a SVG sequence which ends on 'endsvg'.
-		This parameter may be found only in a format or a ABC
-		file (it cannot appear in the command line).
-		Each line between 'beginsvg' and 'endsvg' is included in
-		the SVG output file.
-		It permits to add CSS to the generated SVG files.
-		It is ignored when the SVG generation is started (as
-		after the first K: information field).
-
-  bgcolor <color>
-	Default: none
-	Compilation: none
-	Command line: none
-	Description:
-		Define the background color of SVG images.
-		This parameter is used only when the output is pure SVG
-		(options '-g' and '-v').
-		The <color> may be a color name (as 'white') or a hexadecimal
-		RGB color (as '#faf0e6').
-
-  botmargin <unit>
-	Default: 1cm
-	Compilation: none
-	Command line: none
-	Description:
-		Set the bottom margin to <unit>.
-
-  bstemdown <bool>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		When set, the stem of the note in the middle of the
-		staff goes downwards. Otherwise, it goes upwards
-		or downwards according to the previous note.
-
-  comball <bool>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		When 'combinevoices' is set, voice combination does not
-		occurs when the pitches are a second, unisson or inverted.
-		Setting this flag makes the combination to occur in all
-		cases.
-
-  combinevoices <bool>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		If set, the notes of same duration belonging to voices of
-		the same staff are combined giving chords.
-
-  composerfont <font> [<encoding>] [<size>]
-	Default: Times-Italic 14
-	Compilation: none
-	Command line: none
-	Description:
-		Set the composer font to <font> with a size <size>.
-
-  composerspace <unit>
-	Default: 0.2cm
-	Compilation: none
-	Command line: none
-	Description:
-		Set the vertical space before the composer to <unit>.
-
-  contbarnb <bool>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		If not set, the bar number of the second repeat(s) is reset to
-		the number of the first repeat.
-		If set, the bars are sequencially numbered.
-
-  continueall <bool>
-	Default: 0
-	Compilation: none
-	Command line: -c
-	Description:
-		If true, ignore the line breaks in tune.
-		This parameter is deprecated in favour of '%%linebreak <none>'.
-
-  custos <bool>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		Add a custos at the end of the music lines.
-		This parameter works with single voice tunes only.
-
-  dateformat <text>
-	Default: "%b %e, %Y %H:%M"
-	Compilation: none
-	Command line: none
-	Description:
-		Define the format of the date and time.
-		The possible values of this parameter are described in the
-		manual pages of date(1) and strftime(3).
-		Note: the '%'s must be escaped as '\%' if the is not enclosed
-		in double quotes (otherwise it is taken as the start of a
-		comment).
-
-  deco <name> <c_func> <ps_func> <h> <wl> <wr> [<str>]
-	Default: none
-	Compilation: none
-	Command line: none
-	Description:
-		Define a decoration.
-		!! this is an experimental feature which is subject to change
-		   in next releases and asks for a good knowledge of the
-		   internals of abcm2ps - see deco.abc for examples !!
-		The actual arguments are:
-		<name>: name of the decoration. If it is the name of an
-			existing decoration, this one is redefined.
-		<c_func>: index of a C function (defined in deco.c).
-			The possible values are:
-			0, 1, 2: decoration near the note, inside the staff.
-				0: 'dot' and 'tenuto'
-				1: 'slide'
-				2: 'arpeggio'
-			3, 4, 5: decoration near the note, outside the staff,
-					generally printed above the staff.
-				3: general
-				4: below the staff
-				5: long 'trill' (with start and stop)
-			6, 7: decoration tied to the staff (dynamic marks),
-					generally printed below the staff.
-				6: general
-				7: long dynamic (with start and stop)
-		<ps_func>: postscript function name or '-' if start of a long
-			decoration.
-		<h>: decoration height.
-			It is the minimum height for +arpeggio+.
-		<wl> and <wr>: left and right widths.
-			These values are actually used for general dynamic
-			marks only.
-		<str>: text to display (for some postscript functions
-			- see code).
-		Decorations which names begin with 'head-' prevent the
-		note head(s) to be drawn.
-
-  decoration <character>
-	Default: !
-	Compilation: none
-	Command line: none
-	Description:
-		Define the decoration separator.
-		It may be set only to '!' (default) or '+' (for compatibility
-		with the ABC standard 2.0).
-
-
-  dynalign <bool>
-	Default: 1
-	Compilation: none
-	Command line: none
-	Description:
-		When true, horizontally align the dynamic marks.
-
-  dynamic <int>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		Set the position from the staff of the dynamic informations
-		(crescendo, diminuendo..).
-		<int> may be
-			0 or 'auto' for automatic position (it depends on
-				the presence and position of lyrics)
-			1 or 'above' above the staff
-			2 or 'below' below the staff
-		When this parameter appears outside a tune or inside a tune
-		header, it applies to all voices. When inside a tune body,
-		it applies to the current voice only.
-		This parameter may also be set by the parameter 'dyn='
-		of the V: information field.
-
-  encoding <charset encoding> | <int>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		Define the character encoding of the next ABC strings.
-		This parameter is the same as 'abc-charset'.
-		The recognized charset encodings and the associated <int>
-		values are:
-			us-ascii or utf-8		0
-			iso-8859-1 or latin1		1
-			iso-8859-2 or latin2		2
-			iso-8859-3 or latin3		3
-			iso-8859-4 or latin4		4
-			iso-8859-9 or latin5		5 or 9
-			iso-8859-10 or latin6		6 or 10
-		The extra value 'native' may be used in format files
-		when a font is direclty acceded by PostScript code.
-
-  flatbeams <bool>
-	Default: 0
-	Compilation: none
-	Command line: -f
-	Description:
-		Draw flat beams.
-
-  font <font> [[<encoding>] <scale>]
-	Default: none
-	Compilation: none
-	Command line: none
-	Description:
-		Define a font and its encoding.
-		This parameter is required with PostScript output when
-		specific fonts are defined later in ABC files/tunes.
-		It must be defined before any PostScript output is done,
-		generally in a format file.
-		When absent, <encoding> defaults to the current
-		'encoding' parameter (see above).
-		<scale> is the width factor to apply to the Time-Roman
-		character width. It is needed to adjust the string width
-		in case the computation with the default scale gives
-		erroneous values (if string clash, set <scale> lower than 1.0
-		- if too much space, set it greater than 1.0).
-
-  footer <text>
-	Default: none
-	Compilation: none
-	Command line: none
-	Description:
-		Define the text printed at the bottom of each page.
-		There may be one or two lines. When 2 lines, these
-		ones must be separated by the 2 characters "\n" (not
-		a real 'newline').
-		In each lines 3 areas may be defined: left, center and
-		right.
-		These areas are separated by tabulations (real TABs,
-		not "\t") and may be empty (if the left area is empty,
-		double quote the string - see sample3.abc for example).
-		The character '$' introduces variable expansion:
-			- '$d' is the date and time of the last modification
-			   of the current ABC input file,
-			- '$D' is the current date and time,
-			- '$F' is the current input file name,
-			- '$Ix' is any header information type ('x' is a
-			   letter range 'A' to 'Z').
-			- '$P' is the current page number,
-			- '$P0' and '$P1' are also the page number, but only
-			   when this one is even ('0') or odd ('1'),
-			- '$T' is the current tune title,
-			- '$V' is 'abcm2ps-' followed by the program version.
-		For example, the command line option '-N3' is the same
-		as:
-			%%header "$P0		$P1"
-		(note the 2 TABs).
-		If the footer (or header) begins with '-' (hyphen/minus),
-		it is not printed on the first page.
-
-  footerfont <font> [<encoding>] [<size>]
-	Default: Times-Roman 12
-	Compilation: none
-	Command line: none
-	Description:
-		Set the footer font to <font> with a size <size>.
-		Note that the footer is not scaled.
-
-  format <filename>
-	Default: none
-	Compilation: none
-	Command line: none
-	Description:
-		Read the format (or PostScript) file <filename>.
-		When found in the command line, this parameter is the
-		same as '-F'.
-
-  gchord <int>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		Set the position from the staff of the guitar chords.
-		<int> may be
-			0 or 'auto' for automatic position (usually
-				above the staff)
-			1 or 'above' above the staff
-			2 or 'below' below the staff
-		When this parameter appears outside a tune or inside a tune
-		header, it applies to all voices. When inside a tune body,
-		it applies to the current voice only.
-		This parameter may also be set by the parameter 'gchord='
-		of the V: information field.
-
-  gchordbox <bool>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		Draw a box around the guitar chords.
-		This value may be set to 'true' by %%gchordfont.
-
-  gchordfont <font> [<encoding>] <size> [box]
-	Default: Helvetica 12
-	Compilation: none
-	Command line: none
-	Description:
-		Set the guitar chord font to <font> with a size <size>.
-		If 'box' is present, draw a box around the guitar chords.
-
-  graceslurs <bool>
-	Default: 1
-	Compilation: none
-	Command line: -G
-	Description:
-		Draw slurs on grace notes.
-
-  gracespace <float> <float> <float>
-	Default: 6.5 8.0 12.0
-	Compilation: none
-	Command line: none
-	Description:
-		Define the space before, inside and after the grace notes.
-
-  header <text>
-	Default: none
-	Compilation: none
-	Command line: none
-	Description:
-		Set the text printed at the top of each page.
-		See 'footer' above for the header syntax.
-
-  headerfont <font> [<encoding>] [<size>]
-	Default: Times-Roman 12
-	Compilation: none
-	Command line: none
-	Description:
-		Set the header font to <font> with a size <size>.
-		Note that the header is not scaled.
-
-  historyfont <font> [<encoding>] [<size>]
-	Default: Times-Roman 16
-	Compilation: none
-	Command line: none
-	Description:
-		Set the history font to <font> with a size <size>.
-
-  hyphencont <bool>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		When a word of lyric under staff ends with a hyphen, put a
-		hyphen in the next line.
-
-  indent <unit>
-	Default: 0
-	Compilation: none
-	Command line: -I<unit>
-	Description:
-		Indent the first line of the tune by <unit>.
-
-  infofont <font> [<encoding>] [<size>]
-	Default: Times-Italic 14
-	Compilation: none
-	Command line: none
-	Description:
-		Set the infoline font to <font> with a size <size>.
-
-  infoline <bool>
-	Default: 0
-	Compilation: none
-	Command line: none
-	Description:
-		Display the rhythm (R:) and area (A:) on a same line
-		before the first music line:
-			Rhythm (Area)
-
-  infoname <uppercase letter> <information name>
-	Default:
-		R "Rhythm: "
-		B "Book: "
-		S "Source: "
-		D "Discography: "
-		N "Notes: "
-		Z "Transcription: "
-		H "History: "