Initial import of bww2tex-2.00, a Bagpipe Music Writer Gold to BagpipeTeX

converter, submitted by David Griffith in PR pkg/19978.

7 files changed, 242 insertions, 0 deletions

diff --git a/print/bww2tex/DESCR b/print/bww2tex/DESCR
new file mode 100644
index 00000000000..74e3043c3c6
--- /dev/null
+++ b/print/bww2tex/DESCR
@@ -0,0 +1,4 @@
+Bagpipe Music Writer Gold is one of the most popular formats for
+typesetting bagpipe music.  This package provides bww2tex, a program to
+convert such files into BagpipeTex format.  bww2tex also handles files
+created by the earlier DOS program, Bagpipe Music Writer.
diff --git a/print/bww2tex/Makefile b/print/bww2tex/Makefile
new file mode 100644
index 00000000000..fc105b9f9ee
--- /dev/null
+++ b/print/bww2tex/Makefile
@@ -0,0 +1,26 @@
+# $NetBSD: Makefile,v 1.1.1.1 2003/01/23 18:16:40 fredb Exp $
+#
+
+DISTNAME=	bww2tex-2.00
+PKGNAME=	tex-${DISTNAME}
+CATEGORIES=	print
+MASTER_SITES=	http://www.stanford.edu/~wrinnes/bagpipe.tex/bww2tex/
+DISTFILES=	bww2tex200.tar.gz
+
+MAINTAINER=	dgriffi@cs.csubak.edu
+HOMEPAGE=	http://www.stanford.edu/~wrinnes/bagpipe.tex/bww2tex/
+COMMENT=	Bagpipe Music Writer Gold to BagpipeTeX converter
+
+BUILD_DEPENDS+=	bison-[0-9]*:../../devel/bison
+
+NO_CONFIGURE=	yes
+WRKSRC=		${WRKDIR}
+MAKEFILE=	${WRKSRC}/makefile
+
+do-install:
+	${INSTALL_MAN} ${FILESDIR}/bww2tex.1 \
+		${PREFIX}/man/man1
+	${INSTALL_PROGRAM} ${WRKSRC}/bww2tex \
+		${PREFIX}/bin
+
+.include "../../mk/bsd.pkg.mk"
diff --git a/print/bww2tex/PLIST b/print/bww2tex/PLIST
new file mode 100644
index 00000000000..3eced9b3468
--- /dev/null
+++ b/print/bww2tex/PLIST
@@ -0,0 +1,3 @@
+@comment $NetBSD: PLIST,v 1.1.1.1 2003/01/23 18:16:41 fredb Exp $
+bin/bww2tex
+man/man1/bww2tex.1
diff --git a/print/bww2tex/distinfo b/print/bww2tex/distinfo
new file mode 100644
index 00000000000..2b22fda99e5
--- /dev/null
+++ b/print/bww2tex/distinfo
@@ -0,0 +1,6 @@
+$NetBSD: distinfo,v 1.1.1.1 2003/01/23 18:16:41 fredb Exp $
+
+SHA1 (bww2tex200.tar.gz) = 5ff680d5b5d01ec09c3b8631975b3ed972a50035
+Size (bww2tex200.tar.gz) = 274364 bytes
+SHA1 (patch-aa) = 494da8b380d292dc09569d382dd0fd0a8f135542
+SHA1 (patch-ab) = d921a372d3a61642ec92115b112359f776c6b9c2
diff --git a/print/bww2tex/files/bww2tex.1 b/print/bww2tex/files/bww2tex.1
new file mode 100644
index 00000000000..4f1e8eaa058
--- /dev/null
+++ b/print/bww2tex/files/bww2tex.1
@@ -0,0 +1,104 @@
+.\" -*- nroff -*-
+.TH BWW2TEX 1 2.00
+.SH NAME
+bww2tex \- Bagpipe Music Writer Gold to BagpipeTeX converter
+
+.SH SYNOPSIS
+.B bww2tex
+[\ infile.bww\ [\ outfile\ ]\ ]
+
+.SH DESCRIPTION
+
+.B bww2tex 
+is designed to translate BWW/BMW source as specified in the Bagpipe
+Music Writer Gold help, or the BMWDM Version 5.0/BMWPS Version 2.0
+manual.  I infer from the archives that earlier BMW versions were more
+tolerant of non-conforming code than this release. (Actually I think it
+is that BMWDM is more tolerant than BMWPS or BMW gold). I have not found
+it convenient to emulate all of these unknown (to me) abilities, but
+have accommodated a few of the more common deviations.  bww2tex is less
+accomodating than bmw2tex.  I have implemented the old symbols which
+have new names so that both old and new symbols will work. This version
+successfully parses all but a dozen of the tunes in the Peter Mohr and
+Michael Bell collections and the sample tunes in the BMW Gold
+distribution. The translated files (at least those free of blatant
+copyright problems) are available on the Ceolas archive. The failing
+input files have fairly gross errors (at least as they arrive on my
+machine), e.g., no tabs whatsoever. I have only spot checked that the
+files produced TeX properly.
+.P
+The code is written in flex and bison source. These are processed into C
+*.c and *.h files which can then be compiled into the executable. The
+final program can be used as a UNIX filter, that is, it uses standard
+input and output. Alternatively, input and output files may be specified
+on the command line. Enter 'bww2tex help' to get the details. This
+should be easy to use on UNIX boxes, and in Win32 console mode. Windows
+GUI mode and MAC systems are another story. Such programs require
+additional App wrapper code, a developers environment, or a shell
+program to use on MACs or as a Windows application. The MAC application
+uses the DropUNIX app-wrapper. In the current version the drag and drop
+feature still does not work, but you can convert files using the select
+file menu item. The result is awkward in that one has to restart the
+application for each file converted, but at least it can be used.
+
+.SH USAGE
+.PP
+bww2tex does not add information that is not in the BWW/BMW source. For
+example, it does not generate sloped beams. It also does not adjust the
+spacing. Many strathspeys will have overfull hboxes when TeXed. See
+bagdoc.tex for solutions for crowded music. There are a small number of
+items which BWW/BMW does that MusicTeX does not. I have made reasonable
+substitutions. The formatting instructions in BWW files are mostly
+ignored. The font size is reduced to two sizes, and the landscape spec
+is honored. bww2tex can't, of course, handle user defined BMW tokens.
+musicsize16 (small music) is specified and the note spacing is set to a
+minimal value. The TeX output may edited to improve the appearance of
+tunes which do attempt to crowd the lines.
+.P
+Unrecognized tokens are echoed to the output between bagpipe.tex lines.
+Recognized tokens in an unrecognized order cause the parser to fail and
+drop the current line. Sometimes this is the fault of bww2tex and
+sometimes of the BWW/BMW source. The most common cause is a missing tab.
+Other problems I've seen in archived BMW tunes include missing CLEFTs,
+missing spaces, missing line termination, missing beam (l,r) characters,
+capitalization errors, and tokens between a note and its dot.
+.P
+Once the input file has been parsed, the next question is will it TeX?
+The most likely cause for a TeX failure is an unknown beamed group
+macro. Often the only solution to this is to add the appropriate
+definition to the TeX file. Sometimes the note grouping may be
+rearranged so that an existing macro may be used. Another cause is a
+beamed group of a single note. This can result an unknown macro or a
+misused macro. These are usually due to errors in the BWW/BMW source,
+either an inappropriate beam character or tabs in mid-beam.
+.P
+A parser trace may be generated by using a debugger to set the global
+variable yydebug to 1 after breaking at yyparse.
+.P
+Please test only plausible BWW/BMW source, not arbitrary combinations of
+tokens. If you get a parsing error please verify that the BWW/BMW file
+is legal. This is best done by running the source through the current
+version of BMW gold. The most common problem is that something happened
+to the tabs. There must be a tab separating every beat. and none in the
+middle of a beamed note group. (The "group" may include things like
+trailing dots, ties, and triplet signs, trailing embellishments, and
+first/second time indicators).
+
+.SH CAVEATS
+.PP
+In UNIX, if the input director (<) is intended, but the
+output director (>) is typed, the bmw file will be wiped out.
+This can be avoided by using an explicit file argument.
+
+.SH AUTHORS
+.B bww2tex
+was written by Walt Innes (walt@slac.stanford.edu) in 2002.  Content of 
+the manpage is also by him.
+.br
+Manpage created by David Griffith (dgriffi@cs.csubak.edu) using the
+README from bww2tex 2.00 for inclusion in the NetBSD pkgsrc tree.
+
+.SH "SEE ALSO"
+.BR musixtex(1)
+.BR musixflx(1)
+.BR bagpipetex(1)
diff --git a/print/bww2tex/patches/patch-aa b/print/bww2tex/patches/patch-aa
new file mode 100644
index 00000000000..58c37e6613a
--- /dev/null
+++ b/print/bww2tex/patches/patch-aa
@@ -0,0 +1,31 @@
+$NetBSD: patch-aa,v 1.1.1.1 2003/01/23 18:16:41 fredb Exp $
+
+--- grammar.y.orig	Sun Jan 19 16:02:42 2003
++++ grammar.y	Sun Jan 19 16:02:59 2003
+@@ -697,18 +697,15 @@
+ 
+     if (argc > 1)   /* if a file was named, open it for reading*/
+     {
+-        if(! strncmp(argv[1],"help",4))
++        if(! strncmp(argv[1],"help",4) || ! strncmp(argv[1],"--help",4)
++		|| ! strncmp(argv[1],"-h",4))
+         {
+-            printf("%s","bmw2tex [input [output]]\n"
+-                "The extension .bww will be added to the input"
+-                " file name if .bmw or .bww is not already present\n"
+-                "The extension .tex will be added to the output"
+-                " file name if not already present\n"
+-                "If an output file name is not given,"
+-                " the input file name with .bww or .bmw replaced\n by"
+-                " .tex will be used.\n"
+-                "If no file names are given, stdin and stdout"
+-                " will be used.\n");
++            printf("usage: bmw2tex [ input [ output ] ]\n\n"
++"Bagpipe Music Writer Gold to BagpipeTeX converter.\n\n"
++"If an extension is not specified for the input file, \".bmw\" or \".bww\"\n"
++"will be assumed.  If an extension is not specified for the output file,\n"
++"\".tex\" is used.  If no file names are given, standard input and\n"
++"output are used.\n\n");
+             exit(0);
+               }
+ 
diff --git a/print/bww2tex/patches/patch-ab b/print/bww2tex/patches/patch-ab
new file mode 100644
index 00000000000..e956866be27
--- /dev/null
+++ b/print/bww2tex/patches/patch-ab
@@ -0,0 +1,68 @@
+$NetBSD: patch-ab,v 1.1.1.1 2003/01/23 18:16:41 fredb Exp $
+
+--- makefile.orig	Sun Jan 19 16:02:51 2003
++++ makefile	Sun Jan 19 16:04:19 2003
+@@ -1,19 +1,58 @@
++CC = cc
++#CC = gcc
++
++LEX = flex
++YACC = bison
++
++BINNAME = bww2tex
++VERSION = 2.00
++
++DISTNAME = $(BINNAME)-$(VERSION)
++distdir = $(DISTNAME)
++
+ #
+ #
+ all: bww2tex
+ #
+ bww2tex: y.tab.o  lex.yy.o
+-	cc -g -o bww2tex y.tab.o lex.yy.o
++	$(CC) -g -o bww2tex y.tab.o lex.yy.o
+ #
+ lex.yy.o: lex.yy.c  y.tab.h
+-	cc -c lex.yy.c
++	$(CC) -c lex.yy.c
+ #
+ lex.yy.c: expressions.l tokensDat.h tokens.h
+-	flex expressions.l
++	$(LEX) expressions.l
+ #
+ y.tab.o: y.tab.h y.tab.c tokensDat.h tokens.h
+-	cc -c -g y.tab.c
++	$(CC) -c -g y.tab.c
+ #
+ y.tab.h  y.tab.c:  grammar.y
+-	bison  -t -v -b y -d  grammar.y
++	$(YACC)  -t -v -b y -d  grammar.y
+ #
++
++clean:
++	rm -f  y.*
++	-rm -rf $(distdir)
++	-rm -f $(distdir).tar $(distdir).tar.gz
++
++distclean: clean
++	rm -f $(BINNAME) *core *.o
++	chmod 644 *.tex *.bww *.y *.h *.l *.c makefile README
++	
++
++distro: dist
++dist: distclean
++	mkdir $(distdir)
++	@for file in `ls`; do \
++		if test $$file != $(distdir); then \
++			cp -Rp $$file $(distdir)/$$file; \
++		fi; \
++	done
++	find $(distdir) -type l -exec rm -f {} \;
++	tar chof $(distdir).tar $(distdir)
++	gzip -f --best $(distdir).tar
++	rm -rf $(distdir)
++	@echo
++	@echo "$(distdir).tar.gz created"
++	@echo
++