debian/0000755000000000000000000000000012226022645007167 5ustar debian/README.Debian0000644000000000000000000000127111771063016011232 0ustar abcm2ps for Debian ------------------ This is a Debianization of Jef Moine's abcm2ps package. It differs from the original in the following respects: - It contains an SGML-based manual page. - Format files are placed in /usr/share/abcm2ps rather than /usr/local/share/abcm2ps. - abcm2ps assumes A4 paper by default. In the Debian version, Pango support is intentionally disabled to avoid a huge list of dependencies on X11 libraries. Install a libpango development package and remove the `--disable-pango' option from the configure call in abcm2ps's debian/rules file in order to build abcm2ps with Pango support. -- Anselm Lingnau , Thu, 21 Jun 2012 11:52:01 +0200 debian/dirs0000644000000000000000000000001011771061767010056 0ustar usr/bin debian/source/0000755000000000000000000000000011771061767010503 5ustar debian/source/options0000644000000000000000000000027511771061767012125 0ustar # use debian/patches/debian-changes as automatic patch single-debian-patch # ignore changes to config.h and Makefile, which are generated files extend-diff-ignore = "^(config.h|Makefile)$" debian/source/format0000644000000000000000000000001411771061767011711 0ustar 3.0 (quilt) debian/copyright0000644000000000000000000000223111771062774011133 0ustar Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: abcm2ps Upstream-Contact: Jef Moine Source: http://moinejf.free.fr Files: * Copyright: 2003-2012 Jef Moine License: GPL-2+ Files: debian/* Copyright: 2003-2012 Anselm Lingnau License: GPL-2+ License: GPL-2+ This package 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 package 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 package; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA . On Debian systems, the complete text of the GNU General Public License version 2 can be found in the file `/usr/share/common-licenses/GPL-2'. debian/changelog0000644000000000000000000001370312226022645011045 0ustar abcm2ps (6.6.17-1ubuntu1) saucy; urgency=low * Add autotools-dev dependency, to trigger config.guess|sub updates at build time. -- Dmitrijs Ledkovs Fri, 11 Oct 2013 17:21:25 +0100 abcm2ps (6.6.17-1) unstable; urgency=low * mercurial-importorig imported new upstream version. * Converted debian/copyright to machine-readable format. * Bumped Standards-Version up to 3.9.3. -- Anselm Lingnau Fri, 22 Jun 2012 14:24:24 +0200 abcm2ps (5.9.25-1) unstable; urgency=low * New upstream release. * Added debian/source/options file to deal with the automatic patch. * Bumped Standards-Version up to 3.9.2. -- Anselm Lingnau Thu, 24 Nov 2011 12:25:45 +0100 abcm2ps (5.9.22-1.1) unstable; urgency=low * Non-maintainer upload. * Fix "FTBFS: dpkg-buildpackage: error: dpkg-source -b abcm2ps-5.9.22 gave error exit status 2": backup/restore Makefile in debian/rules; inspired by peter green's patch (closes: #643040). (Alternatively we could simply remove Makefile in the clean target but this solution seems more in line with the current style.) -- gregor herrmann Mon, 14 Nov 2011 17:31:43 +0100 abcm2ps (5.9.22-1) unstable; urgency=low * New upstream release. * Added dependency on ${misc:Depends} to binary package for debhelper. * Bumped Standards-Version up to 3.9.1. -- Anselm Lingnau Thu, 17 Feb 2011 10:40:29 +0100 abcm2ps (5.9.13-0.1) unstable; urgency=low * Non-maintainer upload. * Upload new upstream release to fix "some security vulnerabilities" and "more security vulnerabilities" (Closes: #577014) -- Alexander Reichle-Schmehl Fri, 23 Apr 2010 10:15:13 +0200 abcm2ps (5.9.7-1) unstable; urgency=low * New upstream release * Bumped Standards-Version up to 3.8.3 (no changes to the actual package). * Changed package to "3.0 (quilt)" source format. -- Anselm Lingnau Mon, 21 Dec 2009 09:28:10 +0100 abcm2ps (5.9.5-1) unstable; urgency=low * New upstream release * Updated to policy version 3.8.2. * The maintainer for this package isn't dead, he's just pining for the fjords (Closes: #540854). * The "unexpected result with K:D =c" bug no longer applies to the current software version and the current (draft) ABC standard (Closes: #338867). -- Anselm Lingnau Tue, 11 Aug 2009 11:11:26 +0200 abcm2ps (5.8.1-2) unstable; urgency=low * Bug fix: "will not accept '-' as input source", thanks to Francis Larson (Closes: #498630). This used to work and is documented as such but was apparently broken upstream when code to switch off default-on options was introduced. -- Anselm Lingnau Thu, 11 Sep 2008 22:47:43 +0200 abcm2ps (5.8.1-1) unstable; urgency=low * New upstream release * Updated to policy version 3.8.0 -- Anselm Lingnau Sat, 05 Jul 2008 11:32:07 +0200 abcm2ps (5.5.2-1) unstable; urgency=low * New upstream release -- Anselm Lingnau Mon, 20 Aug 2007 13:18:07 +0200 abcm2ps (4.12.27-1) unstable; urgency=low * New upstream release * Changed reference to abc2ps in package description. -- Anselm Lingnau Fri, 13 Oct 2006 02:09:19 +0200 abcm2ps (4.12.18-1) unstable; urgency=low * New upstream release -- Anselm Lingnau Mon, 5 Jun 2006 23:00:12 +0200 abcm2ps (4.12.14-1) unstable; urgency=low * New upstream release * Updated to policy version 3.7.2 -- Anselm Lingnau Sat, 22 Apr 2006 17:31:28 +0200 abcm2ps (4.11.8-1) unstable; urgency=low * New upstream release -- Anselm Lingnau Tue, 18 Oct 2005 02:56:57 +0200 abcm2ps (4.11.7-1) unstable; urgency=low * New upstream release (closes: #303151). * Removed extraneous /usr/sbin directory from the package. * Various documentation changes as per upstream. * Updated to policy version 3.6.2. -- Anselm Lingnau Tue, 11 Oct 2005 20:12:38 +0200 abcm2ps (4.9.4-1) unstable; urgency=low * New upstream release -- Anselm Lingnau Tue, 5 Apr 2005 18:08:18 +0200 abcm2ps (4.9.1-1) unstable; urgency=low * New upstream release -- Anselm Lingnau Tue, 22 Mar 2005 12:18:40 +0100 abcm2ps (4.8.8-1) unstable; urgency=low * New upstream release -- Anselm Lingnau Mon, 17 Jan 2005 14:15:52 +0100 abcm2ps (4.8.5-1) unstable; urgency=low * New upstream release (closes: #280008). * In particular, this fixes the DJB security bug (closes: #285903). -- Anselm Lingnau Tue, 21 Dec 2004 11:07:28 +0100 abcm2ps (4.6.7-1) unstable; urgency=low * New upstream release * Updated manual page as per upstream changes. * Converted control file to UTF-8. * Added versioned depends clause on docbook-to-man (closes: #255804). -- Anselm Lingnau Wed, 25 Aug 2004 00:10:18 +0200 abcm2ps (4.5.0-1) unstable; urgency=low * New upstream release. * Updated manual page as per upstream changes. -- Anselm Lingnau Fri, 21 May 2004 10:38:03 +0200 abcm2ps (4.2.1-1) unstable; urgency=low * New upstream release -- Anselm Lingnau Fri, 20 Feb 2004 12:48:27 +0100 abcm2ps (4.0.8-1) unstable; urgency=low * New upstream release. * Added "%%staff" and "%%halfbeam" to manual page; change wording of clef explanations. * Included examples from upstream distribution. * Updated to policy version 3.6.1. -- Anselm Lingnau Thu, 22 Jan 2004 11:57:19 +0100 abcm2ps (4.0.7-1) unstable; urgency=low * New upstream release. * Removed erroneous doc-base control file. -- Anselm Lingnau Tue, 13 Jan 2004 09:06:54 +0100 abcm2ps (4.0.5-1) unstable; urgency=low * Initial Release. -- Anselm Lingnau Mon, 5 Jan 2004 02:41:57 +0100 debian/control0000644000000000000000000000205212226022665010573 0ustar Source: abcm2ps Section: text Priority: optional Maintainer: Ubuntu Developers XSBC-Original-Maintainer: Anselm Lingnau Build-Depends: dpkg-dev (>= 1.16.1~), debhelper (>> 7.0.0), docbook-to-man (>> 2.0.0-13), autotools-dev Standards-Version: 3.9.3 Package: abcm2ps Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends} Description: Translates ABC music description files to PostScript (or SVG) This is the Debian port of the abcm2ps program by Jean-François Moine. The program translates tunes written in the ABC format to PostScript, which can then be viewed using Ghostview et al. or printed on a PostScript printer or through Ghostscript. It supports various semi-standard extensions to the ABC standard, such as multiple voices and staves, and can also generate SVG output. . This program is a vastly improved spin-off from Michael Methfessel's abc2ps, which is no longer supplied as part of Debian. In particular, it contains a lot of extensions to help typeset classical music. debian/abcm2ps.manpages0000644000000000000000000000001211771061767012240 0ustar abcm2ps.1 debian/rules0000755000000000000000000000550111771063166010257 0ustar #!/usr/bin/make -f # Sample debian/rules that uses debhelper. # GNU copyright 1997 to 1999 by Joey Hess. # Uncomment this to turn on verbose mode. #export DH_VERBOSE=1 # These are used for cross-compiling and for saving the configure script # from having to guess our platform (since we know it already) DEB_HOST_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE) DEB_BUILD_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE) export DEB_BUILD_MAINT_OPTIONS = hardening=+all DPKG_EXPORT_BUILDFLAGS = 1 include /usr/share/dpkg/buildflags.mk ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) CFLAGS += -O0 else CFLAGS += -O2 endif ifeq (,$(findstring nostrip,$(DEB_BUILD_OPTIONS))) INSTALL_PROGRAM += -s endif config.status: configure dh_testdir ifneq "$(wildcard /usr/share/misc/config.sub)" "" [ -e config.sub ] && mv config.sub config.sub.save cp -f /usr/share/misc/config.sub config.sub endif ifneq "$(wildcard /usr/share/misc/config.guess)" "" [ -e config.guess ] && mv config.guess config.guess.save cp -f /usr/share/misc/config.guess config.guess endif [ ! -f Makefile ] || mv Makefile Makefile.save ./configure --host=$(DEB_HOST_GNU_TYPE) \ --build=$(DEB_BUILD_GNU_TYPE) --prefix=/usr \ --mandir=\$${prefix}/share/man \ --infodir=\$${prefix}/share/info --enable-a4 --disable-pango build: build-arch build-indep build-arch: build-stamp build-indep: build-stamp build-stamp: config.status dh_testdir $(MAKE) /usr/bin/docbook-to-man debian/abcm2ps.sgml > abcm2ps.1 touch build-stamp clean: dh_testdir dh_testroot rm -f build-stamp if [ -e config.sub.save ]; then mv config.sub.save config.sub; fi if [ -e config.guess.save ]; then mv config.guess.save config.guess; fi if [ -e Makefile.save ]; then mv Makefile.save Makefile; fi [ ! -f Makefile ] || $(MAKE) clean rm -f abcm2ps abcm2ps.1 dh_clean config.log config.cache config.status install: build dh_testdir dh_testroot dh_prep dh_installdirs # We take care of the documentation files later ourselves. $(MAKE) install prefix=$(CURDIR)/debian/abcm2ps/usr \ docdir=$(CURDIR)/debian/abcm2ps/doc rm -rf $(CURDIR)/debian/abcm2ps/doc # Build architecture-independent files here. binary-indep: build install # We have nothing to do by default. # Build architecture-dependent files here. binary-arch: build install dh_testdir dh_testroot dh_installchangelogs Changes dh_installdocs dh_installexamples *.abc *.eps # dh_install # dh_installmenu # dh_installdebconf # dh_installlogrotate # dh_installemacsen # dh_installpam # dh_installmime # dh_installinit # dh_installcron # dh_installinfo dh_installman dh_link dh_strip dh_compress dh_fixperms # dh_perl # dh_python # dh_makeshlibs dh_installdeb dh_shlibdeps dh_gencontrol dh_md5sums dh_builddeb binary: binary-indep binary-arch .PHONY: build clean binary-indep binary-arch binary install debian/watch0000644000000000000000000000041211771061767010231 0ustar # Example watch control file for uscan # Rename this file to "watch" and then you can run the "uscan" command # to check for upstream updates and more. # Site Directory Pattern Version Script version=2 http://moinejf.free.fr/abcm2ps-(.*)\.tar\.gz debian uupdate debian/abcm2ps.sgml0000644000000000000000000027161711771063034011421 0ustar manpage.1'. You may view the manual page with: `docbook-to-man manpage.sgml | nroff -man | less'. A typical entry in a Makefile or Makefile.am is: manpage.1: manpage.sgml docbook-to-man $< > $@ The docbook-to-man binary is found in the docbook-to-man package. Please remember that if you create the nroff version in one of the debian/rules file targets (such as build), you will need to include docbook-to-man in your Build-Depends control field. --> Anselm"> Lingnau"> June 21, 2012"> 1"> lingnau@debian.org"> ABCM2PS"> Debian"> GNU"> GPL"> ]>
&dhemail;
&dhfirstname; &dhsurname; 2004 &dhusername; &dhdate; &dhucpackage; &dhsection; &dhpackage; translate ABC music notation to PostScript (or SVG) &dhpackage; options abc-file file-options ... &dhpackage; DESCRIPTION &dhpackage; translates tunes written in the ABC music notation format to customary sheet music scores in PostScript or SVG. It is based on abc2ps 1.2.5 and was developed mainly to print Baroque organ scores that have independent voices played on multiple keyboards and a pedal-board. The program has since been extended to support various other notation conventions in use for sheet music. Options given immediately after the command name apply to the run as a whole; options given after an ABC file name apply to that file. Formatting parameters can also be set in `format files' and in the ABC files themselves. OPTIONS Options may be grouped if they have no arguments; the last option in a group may have an argument. Where appropriate, starting an option (group) with +, or finishing it with -, disables the option(s). Set formatting parameter parameter to value. Values established in this way will override values given in format files, and be implicitly locked. See below for a list of formatting parameters. Maximal horizontal compression when staff breaks are chosen automatically. Must be between 0 and 1 (default: 0.65) See the parameter below. This option (`annotate') inserts reference elements into the PostScript or SVG output. Try to typeset b bars on each staff line. See the formatting parameter below. Start measure numbering at b. See the formatting parameter below. The continuation symbol is implicitly appended to each music line. This amounts to automatic line breaking. See the formatting parameter below. Search format files in directory. Set the minimum vertical interstaff space to length (default: 46pt). See the formatting parameter below. Output is generated in EPS format, one file per page. In this mode, each tune is written to a separate numbered file unless the is given; output cannot be directed to standard output. EPS files are useful for embedding into PostScript documents, but can also be used to generate images in (pixel-oriented) graphics formats via GhostScript. Select which tunes from an ABC file to print. list is a comma-separated list of tune numbers (as per the `X:' header). The option must occur after an ABC file name and applies to that file. Ranges of tune numbers may be specified like t1-t2; t2 may be omitted which means `all remaining tunes until the end of file'. Note that filtering may cause problems, e.g., with global (non-tune) definitions in the ABC file. Read the format file file. If file does not have a suffix, .fmt is implied. Do not read the default format file. Enable flat beams in bagpipe tunes. See the formatting parameter below. Omit slurs on grace notes. See the formatting parameter below. Produce SVG output instead of EPS. In this mode, each tune goes to a separate numbered output file unless the is specified. If output is directed to standard output (), all SVG images are output without an XML header. Display the current values of the formatting parameters. Display program usage hints and quit. Display red circles around errors in PostScript output Indent the first line of the tune by length (default: 0). See the formatting parameter below. Output a measure number every b measures. If b is 0, the measure number appears at the left of each staff. The trailing causes a box to be drawn around each measure number (default: no measure numbering). See the formatting parameter below. Generate landscape output. See the formatting parameter below. Suppress end-of-tune lyrics. See the parameter below. Set the left margin to length (default: 1.8cm). See the formatting parameter below. Number pages according to the mode: no page numbers page numbers at top left of page page numbers at top right of page page numbers at top left of even-numbered pages, top right of odd-numbered pages page numbers at top right of even-numbered pages, top left of odd-numbered pages For compatibility, is equivalent to (default: ). If a header is defined using the formatting parameter, this option is ignored. Equivalent to (no page numbering). Include notes and history from ABC tune `N:' fields. See the formatting parameter below. Define the output file directory and/or name. By default, the output goes to the current directory, and the file name is `Out.ps' for PostScript output, `Outnnn.eps' for EPS output (see ), `Outnnn.svg' for SVG output (see options and ), or `Out.xhtml' for XHTML+SVG (see ). When name is present, it replaces `Out' in the output file name. If name is =, it is replaced by the name of the ABC source file. If name is - and standard PostScript or embeddable SVG output is selected, the output will be sent to standard output. Revert to the default output directory and file name. Quiet mode; display only error messages. Set the page scale factor to scale. Note that the header and footer are not scaled (default: 0.75). See the formatting parameter below. Secure mode; disables file inclusion via and and disallows direct PostScript injection via and . , Activate (or deactivate) tabulature drawing. n is the tabulature number as defined in (up to a maximum of 8 tabulatures), and voice is the voice name, full name or subname as found in . When this is absent, the option applies to all voices. Up to 4 such options may be given. See also format.txt. Use implicit decorations as in abc2ps (default: off). See the formatting parameter below. Output version number and quit. Produce SVG output instead of PostScript. In this mode each page goes to a different numbered file. Output to standard output is disallowed. Adjust the right margin such that the staff width is length (default: none). See the formatting parameter below. Include the `X:' tune number in the title. See the formatting parameter below. Produce XML+SVG output instead of PostScript. See for output file naming. Split tunes across page breaks if necessary. See the formatting parameter below. Output one tune per page. See the formatting parameter below. FORMATTING PARAMETERS The following formatting parameters can be used in format files. They can also occur in ABC files when they are preceded by , or on the command line (using a double dash to introduce them). Parameters specified on the command line or within an ABC file override definitions of the same parameter in a format file. If the lock keyword is specified at the end of a parameter list, the value cannot be changed later unless the later definition also uses lock. There is an implicit lock at the end of any parameter specified on the command line. Abcm2ps distinguishes between "global" and "local" parameter settings. Global settings can be established through the use of format files, or by specifying formatting parameters outside of tunes, i.e., at the beginning of a file before the first tune's `X:' or `T:' line, or after the blank line at the end of a tune before the next tune's `X:' or `T:' line. Local settings can be specified inside a tune, and will revert to the current global setting at the end of the tune. Do also note that the result of setting some parameters depends on where they occur in the source file, i.e., setting within a tune applies only to the second and subsequent pages of that tune, not the first page, since when the local setting is seen, output of the tune has already started. If true, set M as the +tenuto+ decoration and do a pitch translation if the notes are too high for a bass clef. Also, an octave translation is applied to bass and alto parts (default: 0; command line: ) Align the bars of the next int lines of music. This works only when the music contains only one voice (no or ) (default: 0). Define where to display the composer field. A negative value displays it flush-left, a value of zero centered, and a positive value flush-right (default: 1). Set the annotation font to font with size size (default: Helvetica 12) Adjust the clefs when they are not defined in `K:' or `V:' lines (default: 1). Synonym for . Try to typeset with int bars per line (default: 0; command line: , ) Start a sequence of PostScript code lines extending until the next line. This parameter may only occur within ABC and format files, not on the command line. Each line between and is included in the PostScript output file. The material may not exceed 128 KiB in size. When the output format is SVG, the PostScript code is executed by the small built-in PostScript interpreter. Sequences which cannot be executed (like font redefinitions) must be made conditional based on the symbol: /svg where {pop} { PostScript code that abcm2ps cannot execute } ifelse Start a sequence of SVG code lines extending until the next line. This parameter may only occur within ABC and format files, not on the command line. Each line between and is included in the SVG output file. This makes it possible to add CSS to the generated SVG files. The parameter is ignored if SVG generation has already started (i.e., after the first K: information field.) Define the background colour of SVG images. This parameter is only used when the output is pure SVG (options and ). The colour may be a colour name (white) or an RGB colour in hexadecimal notation (#faf0e6). Set the bottom margin to length (default: 1cm) If this is set, on finding an end-of-line (eoln), pretend that there was a space before the next note or rest. This prevents a beam to be continued between two input lines (default: 1). If this is set, the stem of the note on the middle of the staff extends downwards. Otherwise it extends up or down depending on the preceding note (default: 0). If this is set together with , voice combination takes place in all cases. Otherwise, notes which are too close together in pitch (i.e., a second interval, in unison, or inverted) are not combined. If this is set, simultaneous notes of the same duration belonging to voices on the same staff are combined into chords. (default: 0). Set the `composer' font to font with size size (default: Times-Italic 14) Set the vertical space before the composer name to length (Default: 0.2cm) If this is not set, the bar numbers of second repeats are set to those of the corresponding first repeats. If this is set, all bars are numbered sequentially (default: 0). If this is set to true, ignore the line breaks in a tune (default: 0; command line: , ) This parameter is deprecated in favour of . Format for date and time output. The admissible values of this parameter are described in the documentation for the strftime(3) C library function. Note that percent signs need to be escaped (default: "\%b \%e, \%Y \%H:\%M") Define a decoration. This is an experimental feature which is subject to change in future releases and requires good knowledge of the internals of abcm2ps. See the files format.txt and deco.abc for details. Define the decoration separator. It may be set to either ! (the default) or + (for compatibility with the ABC 2.0 standard). When set, horizontally align dynamic marks (default: 1) Set the position of dynamic marks (`crescendo', `diminuendo') in relation to the staff. The position may be 0 (or auto) for automatic positioning depending on the presence and position of lyrics, 1 or above to place them above the staff, or 2 or below to place them below the staff. If this parameter occurs outside a tune or inside a tune header, it applies to all voices. If it occurs inside a tune body, it applies to the current voice only. This parameter may also be set using the key of the V: information field. Define the character encoding of subsequent ABC strings. This parameter is the same as . The recognised charset encodings and associated integer 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 value native means that special characters are directly accessed from PostScript code. Draw flat beams (default: 0; command line: ). Define a font and its encoding. Use this parameter when you want to refer to specific fonts in ABC files/tunes. It must occur before any PostScript output is written, generally in a format file. encoding defaults to the encoding set up by the parameter. scale is the width factor to apply to the Times-Roman character width. It is needed to adjust the string width in case computation with the default widths gives erroneous values; if strings clash, set scale to a value less than 1.0, if there is too much space, set it to a value greater than 1.0. Define the text printed at the bottom of every page. There may be one or two lines. When there are two lines, these must be separated by the characters `\\n' (not a real newline). Each of the lines consists of three areas, left, center and right, which are separated by tabs (real tabs, not '\\t') and may be empty - if the left area is empty, the text must be double-quoted. If the footer begins with `-', it will not be printed on the first page of the document. The `$' character introduces variable expansion: The date and time of last modification of the current ABC input file The current date and time The current input file name x The value of header x of the tune The current page number The current pagenumber (when even) The current pagenumber (when odd) The current tune title `abcm2ps-' followed by the program's version number For example, the command line option is equivalent to `%%header "$P0 $P1"' (note the two tabs). (Default: none) Set the footer font to font with size size (default: Times-Roman 12) Note that the footer is not scaled. Read the format (or PostScript) file filename (default: none; command line: ). Set the position of guitar chords in relation to the staff. position may be: 0 or auto for automatic positioning (usually above the staff), 1 or above for positioning above the staff, or 2 or below for positioning below the staff. If this parameter occurs outside a tune or inside a tune header, it applies to all voices. If it occurs inside a tune body, it applies to the current voice only. This parameter may also be set using the key of the V: information field. Draw a box around guitar chords. Can be set to `true' using `%%gchordfont' below. (Default: 0) Set the guitar chord font to font with size size. If is specified, draw a box around guitar chords (default: Helvetica 12, no box) Draw slurs on grace notes if true (default: 1; command line: , ) Define the space before, between, and after the grace notes (default: 6.5 8.0 12.0) Define the text printed at the top of every page. See the parameter above for the syntax (default: none) Set the header font to font with size size (default: Times-Roman 12) Set the font for history entries to font with size size (default: Times-Roman 16) If an under-staff lyrics line ends with a hyphen, put another hyphen at the beginning of the next line (default:0) Indent the first line of a tune by length (default:0; command line: ) Set the information line font to font with size size (default: Times-Italic 14) Display the rhythm (`R:') and the area (`A:') of the tune on a single `information line' before the first music line (default: 0) Define the headers to be printed after a tune when is set. The tag is printed before the actual header value. By default, this outputs the R, B, S, D, N, Z, and H headers, with tags `Rhythm:', `Book:', `Source:', `Discography:', `Notes:', `Transcription:', and `History:', respectively. Set the vertical space before the information line to length (default: 0). Set page orientation to landscape if true (default: 0; command line: , ). Set the left margin to length (default: 1.8cm; command line: ) Define the character(s) for breaking music lines. separators is a blank-separated list of none, one, or more of: >EOL< (system end-of-line character, the default), $, !, or >none<. For compatibility, when >EOL< is in the list, the ! character also causes a line break if it does not look like it is introducing a decoration. The value >none< must be the only value in the list. In this case, the program computes the line breaks by itself. The same behaviour occurs if the separators list is empty. This replaces the former parameter. Set the factor for spacing between lines of text to float times the font size (default: 1.1) If set, outputs a warning when there are too few or too many elements in a music line (default: 1) Set how much the output may be compressed horizontally when staff breaks are chosen automatically. float must be between 0 and 1 (default: 0.65; command line: ) Set the maximum vertical inter-staff space to length (default: 2000pt) Set the maximum vertical system inter-staff space to length (default: 2000pt) When this parameter occurs on the global level or in the tune header, it applies to all staves. Otherwise it defines the maximum vertical offset of the next staff. Draw a box around the measure numbers if true (default: 0; command line: or ). Start measure numbering of the tune at int. This parameter is obsolete and should be replaced with (outside the tune body) Set the font for measure numbers to font at size size. If box is specified, draw a box around the measure number (default: Times-Italic 14, no box). Draw a measure number every int bars. If int is 0, the measure number appears at the left end of each staff. If int is -1, no measure numbers are displayed at all (default: -1; command line: or ). If true, no lyrics are output (default: 0; command line: , ) Set the vertical space before the first staff of a tune to length (default: 0.2cm) Set the note spacing factor to float. This value is used to compute the natural space notes take up. The base space of the crotchet (quarter note) is always 40pt. When the duration of a note type is twice that of another note type, the space it takes up is multiplied by this factor. The default value increases the note space by a factor of 2 when the corresponding note's value increases by a factor of 4. That is, the space of a semibreve is 80pt and that of a semiquaver is 20pt. Setting this value to 1 sets all note spaces to 40pt (default: 1.414). If true, output one tune per page; if false, multiple tunes are output per page if there is sufficient room (default: 0; command line: , ). Set the position of ornaments (like mordent, trill, ...) in relation to the staff. position may be: 0 or auto (default) for automatic positioning (usually above the staff), 1 or above for positioning above the staff, or 2 or below for positioning below the staff. If this parameter occurs outside a tune or inside a tune header, it applies to all voices. If it occurs inside a tune body, it applies to the current voice only. Set the page height to length (default: hardcoded) Set the page width to length (default: hardcoded) Set the factor for spacing between text paragraphs to float (default: 0.4) Draw a box around the part names if true (default: 0) Set the font for part names to font with size size. If is specified, draw a box around the part names. (default: Times-Roman 15) Set the vertical space before a new part to length (default: 0.3cm). If mode is different from 0, output PostScript marks to generate a PDF index after translation to PDF. If mode is greater than 1, generate marks for titles and subtitles; if mode equals 1, generate marks for main titles only (default: 0). Define a postscript sequence to be included in the header of the output file. This formatting parameter may be used to override any postscript function or to define new functions for use in . It should be processed before any output occurs, that is, in a format file or at the beginning of the first ABC file. Set the font for repeat bracket numbers/texts to font at size size. Set the right margin to length (default: 1.8cm) Set the global page scale factor to float. This does not apply to headers and footers (default: 0.75; command line: ). When true, output some indications about the note/chord and/or decorations for purposes of customisation. These indications are stored in the PostScript variable defl. Note: This is a potential compatibility problem. The parameter was introduced in version 4.9.4. (default: 0) Set up alternate fonts for strings. In most strings, you can switch to one of the alternate fonts using $1..$4; $0 switches back to the default value for that string. (default: Times-Roman 0) Usually in multi-voice tunes, when two voices are in unison there is often only one note head. If this flag is set, two note heades are output (one is shifted) if one is a minim (half note) and the other a crotchet (quarter note) or shorter, i.e., a "black" note, or if one note is dotted and the other is not. The parameter is really spelled "shiftunisson" (default: 0). Set the slur height factor to float (default: 1.0). If false, a tune is output on a new page if it doesn't fit on the one currently being output. If true, a tune may be split across page breaks (default: 0). If true, display breve notes in a square shape (default: 0) If false, staves not containing notes are suppressed. This includes staves that only contain visible rests (default: 1) Set the vertical inter-staff space to a minimum of length (default: 46pt; command line: ) Set the right margin such that the staff width is length (default: none - but see and ). Set the stem height to float (default: 20.0) If true, use straight flags on stems (mostly useful for bagpipe tunes (default: 0) If true, stretch the last staff of a tune to fill the whole line even though it may be underfull (default: 0) If true, stretch all underfull staves to fill the whole line (default: 1) Set the font for subtitles (second and subsequent `T:' headers in a tune) to font with size size (default: Times-Roman 16) Set the vertical space before subtitles (second and subsequent `T:' headers in a tune) to length (default: 0.1cm). Set the minimum distance between staves in a system to length (default: 36pt). This parameter applies to all staves if it occurs on the global level or within the tune header. Otherwise, it defines the minimum distance to the next staff. Set the font for tempo (metronome) indications to font with size size (default: Times-Bold 15) Set the text font to font with size size (default: Times-Roman 16) Set the default text option to option. This option is used for text between and , , and . option may be a keyword; see for values. When option is skip, no text (nor EPS) is output. Set the vertical space before text blocks to length (default: 0.5cm). If true, a cautionary time signature is added to the end of the line before if a time signature change occurs at the beginning of a line of music (default: 0). If true, output the tune title in uppercase letters (default: 0) Set the title font to font with size size (default: Times-Roman 20) Defines the format of the tune title. This format overrides the standard way the tune title is displayed. text is a sequence of letters, numbers, commas, plus and minus signs. A letter stands for an ABC header (reasonable values include A, B, C, D, H, N, O, P, R, S, T, X, and Z, but any letter may occur) and can optionally be followed by a number. This number may be 0 (to center the header), 1 (to display it flush-right), or -1 or - (to display it flush-left); if no number is given the default is 0. A plus sign may appear between two fields, in which case these fields are concatenated (this only works if they are of the same type and alignment). A comma starts a new `box' below the previous one. In each box, the fields are placed in their respective alignment zones. Unrecognized characters will be ignored. As an example, `%%titleformat R-1 P-1 Q-1 T C1 O1, T + T N1' will display two stacked boxes. The first box contains the rhythm, part, and tempo on the left, the first (main) title in the centre, and the composer and origin on the right. The second box (below the first) will contain the concatenated subtitles (if any) in the centre and any notes on the right. If true, output the tune title flush left (instead of centered) (default: 0) Set the vertical space before the tune title to length (default: 0.2cm). If true, if the last word of a title starts with a capital letter and is preceded by a comma and a space, this word is moved to the beginning of the title. For example, T:College Hornpipe, The is printed as The College Hornpipe (default: 1). Set the top margin to length (default: 1cm) Set the vertical space at the top of a tune to length (default: 0.8cm) Transpose the music by int (a signed number) halftones for display. If this parameter appears on the global level or inside a tune header, it applies to all voices. If it appears inside a tune body, it applies to the current voice only. If a # or b is present, the new key signature(s) will have sharps or flats in case of enharmonic keys. Note that textual guitar chords will not be transposed. Define how to draw tuplets. The when parameter can be 0 (to decide automatically whether to draw a slur or bracket over the tuplet), 1 (to never draw one) or 2 (to always draw one). The what parameter defines what to draw: 0 means a bracket, 1 a slur; 2 extends beams across rests (does not work yet). The value parameter defines how to annotate the tuplet: 0 means to write a simple number (p), 1 writes nothing, and 2 writes a ratio (p:q). Set the position of lyrics in relation to the staff. position may be: 0 or auto (default) for automatic positioning (usually above the staff), 1 or above for positioning above the staff, or 2 or below for positioning below the staff. If this parameter occurs outside a tune or inside a tune header, it applies to all voices. If it occurs inside a tune body, it applies to the current voice only. If true, output lyrics above the staff (instead of below it) (default: 0) Set the font for lyrics inside a tune to font with size size (default: Times-Bold 13) Set the vertical space between a staff and its lyrics to length (default: 23pt) Set the font for voice names (default: Times-Bold 13). Set the position of volume indications (!p!, !fff!, ...) in relation to the staff. position may be: 0 or auto (default) for automatic positioning (usually below the staff), 1 or above for positioning above the staff, or 2 or below for positioning below the staff. If this parameter occurs outside a tune or inside a tune header, it applies to all voices. If it occurs inside a tune body, it applies to the current voice only. Set the font for lyrics at the end of a tune to font with size size (default: Times-Roman 16) Set the vertical space before the end-of-tune lyrics to length (default: 0.5cm) Determines which ABC information will be output. list is a list of ABC header letters. boolean determines whether that header will be output or not. (default: COPQTWw 1; command line: , ) The following formatting parameters can only occur inside tunes and not in a format file: Start printing a free-form text. The text to be printed appears on the subsequent lines of the the input file up to a line containing . The text lines may start with . The parameter may be: Line breaks in the input file are kept (default) or Lines are justified or Line breaks are ignored but output is left-justified Lines are centered The text lines are not printed at all If mode is omitted, it defaults to the current value of . Inside the text, an empty line starts a new paragraph. Page breaks cannot occur in the middle of a paragraph. Print one line of centered text Include filename as an EPS file The file content is aligned to the left or right or centered according to the current value of . Finish a block of free text started by Define multicolumn printing. command may be: Save the current vertical position and left and right margins. These margins may then be changed to print music or text. Reset the vertical position to the place of the previous and restore the left and right margins. These can then be changed again to display another column. Restore the left and right margins and skip down the page to a `safe place'. This command may also be used to group some tunes and text on the same page. Start a new page, restarting page numbering from int if applicable. Repetition brackets are normally displayed as written in a voice. %%repbra 0 suppresses them for the current voice. Replace a sequence of notes by one or many repeat marks. When placed after a bar line, n indicates the number of measures to be repeated, either 1 or 2. If n is 1, k gives the number of repetitions of the preceding measure. If n is 2, k is not used. When placed after a note or rest, n gives the number of notes and rests to be repeated, and k gives the number of repeats. When omitted, n and k default to 1. See below. Print a separator (line) of length length with vertical space h1 above and h2 below (defaults: h1 and h2: 0.5cm; length: 3cm) Set the number of the next measure to int. When not inside a tune body, this is equivalent to . If the option appears at the beginning of the tune (after K:), the second measure will have the new number. Put the following material on staff num (or the num-th previous or next staff if a sign is given). This will lead, e.g., to beams between notes in different staves. Useful for keyboard music; see, for example, sample4.abc. Leave a space of length in the current staff. If length is greater than 0.5cm, the left side of the staff (system) is redrawn. In a multi-voice tune, a staff break must be specified in each voice. If the f is not given, the staff break is removed if it occurs at the start or the end of a line. See below. Define a tablature for the current voice. See format.txt for the details. Output a single line of text. Leave vertical space of height length. length may be negative, in which case the following material is moved closer to that above. ADDITIONAL FEATURES Clefs Clefs can be given in K: and V: headers. The full syntax is clef=typeline+8|-8 middle=pitch The `clef=' can be omitted when the type is a clef name. type denotes the clef type. It may be: A note pitch (G, C, or F) The pitch indicates which clef is meant: G is the treble clef, C the alto clef and F the bass clef. It also gives the name of the note that appears on the clef's line. A clef name The available clef names are treble (clef gives the pitch for G), alto or tenor (C), and bass (F) perc or P In percussion mode, accidentals change the glyphs used for note heads. By default, sharp notes are drawn as `x' and flat notes as circled `x'. This may be changed by redefining the PostScript functions pshhd and pflhd. none No clef will be displayed. The line gives the number of the line within the staff that the base clef will be written on. The default values are 2 for the treble clef, 3 for the alto clef, and 4 for the tenor and bass clefs. The +8 and -8 options draw an 8 above or below the staff, respectively. `middle=pitch' (or `m=pitch', for short) is an alternative way of defining the line number of the clef: The pitch indicates what note will be displayed on the middle line of the staff. When no clef is specified, clef changes between bass and treble will be inserted automatically. Multi-voice typesetting Multiple voices may be defined within the header or the tune using V:name definition ... where name is a word consisting of letters and digits only (like violin1). In the tune body, the following notes refer to this voice until another V: is encountered. A definition can be one of: clef=... See above name=name or nm=name The name will be displayed at the beginning of the first staff. It can contain sequences which will force line breaks. If it contains whitespace it must be double-quoted. subname=name or snm=name The name will be displayed at the beginning of all staves except for the first. It can contain sequences which will force line breaks. If it contains whitespace it must be double-quoted. merge The voice goes on the same staff as the previous voice. up or down Forces the direction of the stems for the voice. dyn=up or dyn=down or dyn=auto Forces positioning of dynamic marks (above or below the staff) or reverts to automatic positioning (the default) gstem=up or gstem=down or gstem=auto Forces the direction of the stems of grace notes (always up or always down) or reverts to automatic positioning (the default) stem=auto Reverts to automatic positioning of note stems (up or down) (the default) lyrics=up or lyrics=down or lyrics=auto Places lyrics above or below the staff or reverts to automatic positioning (the default) gchord=up or gchord=down Places guitar chords above (the default) or below the staff. stafflines=value Sets the number of lines on the staff in question. (default: 5) staffscale=value Sets the scale of the associated staff up to 3. (default: 1) All other definitions are ignored. By default, each voice goes on its own staff. The `%%staves definition' pseudo-comment can be used to control staff assignment. The definition consists of voice names (from V:) and pairs of parentheses, braces or brackets. When a voice name is not within a pair of special characters, it goes on a separate staff. For voice names enclosed in brackets, a bracket is displayed at the beginning of each line that joins the staves of the voices in question. For voice names enclosed in braces, all the voices go on two staves (keyboard score). There can be at most four voices between a single pair of braces. For voice names enclosed in parentheses, all the voices appear on a single staff. The `|' character prevents measure bars from being drawn between two staves. If `%%staves' occurs in a tune, all the voices not mentioned will not be output at all. The <literal>%%score</literal> directive The %%score directive occurs in the ABC draft 2.0 standard and is similar to the %%staves specification described earlier. The rules are: Voice names within parentheses form a "voice group" and go on a single staff. A voice name that is not within parentheses forms its own voice group and goes on a staff by itself. Voice groups within braces form a "voice block" and are preceded by a big brace in the output. This is especially useful for keyboard music. Voice groups or voice blocks within brackets form a "voice block" and will be preceded by a big bracket in the output. If a `|' character occurs between two voice groups or voice blocks, the bar lines in all of the associated staves will be continuous. A single voice surrounded by two voice groups can be preceded by an asterisk to make it into a `floating' voice. This means that, for each note of the voice, a separate decision is made whether it is printed on the preceding or the following voice group's staff. Voices that appear in the tune body but not in the %%score directive will not be output at all. If there is no %%score directive, each voice will be output on its own staff. A %%score directive inside a tune resets the mechanism so voices can be removed or added. Voice overlay You can add notes to a staff without introducing a complete extra voice by using the ampersand (&). A single measure can be split into two voices like |F2A2Bc&F2c2bc| The (&...&...&) construction allows splitting multiple measures: |!f!(&GG<G|GG F=E| E2 E(_D/E)|_D D C D |C4- |C      &DC<C|CC_D C|=B,2_B,B, |_A,A,(G,/A,/)B,|F,4-|F,)zzD=E| A double ampersand (&&) will allow overlaying more than two lines of music but this feature has not yet been implemented. Lyrics Aligned lyrics under a staff are written as a w: line directly below the staff line. For example: edc2 edc2| w:Three blind mice, three blind mice Each word in the w: line (delimited by blanks) is associated with one note, in sequence. The following special symbols modify this behaviour: * Skips one note. - Splits a word into two syllables which are associated with two adjacent notes. A `-' is drawn between them. | Advances to the next bar line ~ Is output as a space, but unites two words so they appear under a single note. _ Draws a thin underscore from the previous note to the next. To include more than one line of lyrics, use multiple w: lines. To include hyphens without splitting a word over multiple notes, use \-. If a word starts with a digit, this is interpreted as a stanza number and outdented a bit to the left. Slurs and ties The direction of slurs and ties may be controlled using the (, and (', and -, and -', constructions. Microtone pitches Microtone pitches are indicated by a fraction after an accidental, as in ^3/4c. When omitted, the numerator defaultes to 1 and the denominator to 2 (so ^/c is the same as ^1/2c). The numerator and denominator values may not exceed 256. There is built-in support for quarter-tone accidentals (1/2 and 3/2 sharps and flats); for other values, rendering functions must be defined using %%postscript (see features.txt). EPS inclusion EPS files may be included inside tunes using the pseudo-comment `%%EPS file'. SEE ALSO The original documentation can be found in files features.txt, format.txt, and options.txt, which on a Debian system are in /usr/share/doc/abcm2ps. AUTHOR This manual page was written by &dhusername; <&dhemail;> for the &debian; system (but may be used by others). Permission is granted to copy, distribute and/or modify this document as long as its origin is not misrepresented. debian/patches/0000755000000000000000000000000011771067612010625 5ustar debian/patches/non-resettable-pagenumber0000644000000000000000000000437211771063640015620 0ustar Description: Add "$Q" key in header for page numbers that don't reset abcm2ps supports a "$P" key in header or footer lines that will output the current page number and can be reset using "%%newpage". In my books of SCD ball sets, I like to include both the page number inside the tune and the page number inside the book on every page, so the "$Q" adds another page number that is not changeable by the user. Author: Anselm Lingnau Last-Update: 2009-12-21 Index: abcm2ps/abc2ps.c =================================================================== --- abcm2ps.orig/abc2ps.c 2012-06-22 14:26:14.000000000 +0200 +++ abcm2ps/abc2ps.c 2012-06-22 14:27:25.000000000 +0200 @@ -42,6 +42,7 @@ int tunenum; /* number of current tune */ int pagenum = 1; /* current page in output file */ +int pagenum_nr = 1; /* current page (non-resettable) */ /* switches modified by command line flags: */ int quiet; /* quiet mode */ Index: abcm2ps/abc2ps.h =================================================================== --- abcm2ps.orig/abc2ps.h 2012-06-22 14:26:14.000000000 +0200 +++ abcm2ps/abc2ps.h 2012-06-22 14:27:25.000000000 +0200 @@ -293,6 +293,7 @@ extern int outft; /* last font in the output file */ extern int tunenum; /* number of current tune */ extern int pagenum; /* current page number */ +extern int pagenum_nr; /* current page number (non-resettable) */ extern int nbar; /* current measure number */ extern int nbar_rep; /* last repeat bar number */ extern int in_page; Index: abcm2ps/buffer.c =================================================================== --- abcm2ps.orig/buffer.c 2012-06-22 14:26:14.000000000 +0200 +++ abcm2ps/buffer.c 2012-06-22 14:27:25.000000000 +0200 @@ -299,6 +299,18 @@ } d += sprintf(d, "%d", pagenum); break; + case 'Q': /* non-resetting page number */ + if (p[1] == '0') { + p++; + if (pagenum_nr & 1) + break; + } else if (p[1] == '1') { + p++; + if ((pagenum_nr & 1) == 0) + break; + } + d += sprintf(d, "%d", pagenum_nr); + break; case 'T': /* tune title */ q = &info['T' - 'A']->as.text[2]; tex_str(q); @@ -518,6 +530,7 @@ if (cfmt.footer != 0) maxy -= headfooter(0, pwidth, pheight); pagenum++; + pagenum_nr++; outft = -1; } debian/patches/series0000644000000000000000000000003211771067612012035 0ustar non-resettable-pagenumber debian/docs0000644000000000000000000000005311771061767010054 0ustar README features.txt format.txt options.txt debian/compat0000644000000000000000000000000211771061767010401 0ustar 7