{\rtf1\ansi\ansicpg1252\cocoartf949\cocoasubrtf540
{\fonttbl\f0\fnil\fcharset0 LucidaGrande;\f1\fnil\fcharset0 Geneva;\f2\fmodern\fcharset0 Courier;
}
{\colortbl;\red255\green255\blue255;\red0\green0\blue255;}
\margl1440\margr1440\vieww9700\viewh13120\viewkind0
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f0\b\fs28 \cf0 Bol Processor 2.9.8 Read Me\

\fs24 August 8, 2012\

\b0 \
Bol Processor is a program for music composition and improvisation with real-time MIDI, MIDI file, and Csound output.  It produces music from a set of rules (a compositional grammar) or from text scores which may be typed or captured from a MIDI instrument.  Bol Processor 2 began as a shareware application for Macintosh computers developed by Bernard Bel and Srikumar Karaikudi Subramanian.  The original Bol Processor program was developed by Bernard Bel and Jim Kippen on an Apple IIc.\
\
Bol Processor 2 is now distributed as free software (open source) under a BSD-style license (please see the License.txt file for complete terms).  BP development is hosted by Sourceforge at <{\field{\*\fldinst{HYPERLINK "http://bolprocessor.sourceforge.net/"}}{\fldrslt \cf2 http://bolprocessor.sourceforge.net/}}>.  Developers interested in joining the project are most welcome to do so.  Please email us for more information.\
\
This package contains the final release of Bol Processor 2.9.8 for Mac OS X.  Full documentation and a set of examples is included with this package.\
\

\b\fs26 Important Changes in this Version\

\b0\fs24 \
This release fixes the problem that prevented graphical scores from displaying in the Graphics window on Intel Macs.  A few other minor bugs were fixed too.\
\

\b\fs26 System Requirements
\fs24 \

\b0 \
- Mac OS X 10.4 or later to run\
- an Intel or PowerPC Mac\
\

\b\fs26 Installing Bol Processor
\fs24 \

\b0 \
Drag the Bol Processor application wherever you like onto your hard drive.  You can also copy the documentation and example files wherever you would like.  If you plan on using real-time MIDI input or output with Bol Processor, see the next section.  Bol Processor also has input and output options for text, MIDI files, and Csound.\
\

\b\fs26 Configuring Real-Time MIDI Input and Output
\b0\fs24 \
\
Bol Processor uses CoreMIDI for MIDI input and output.  You can choose input sources and output destinations by going to the "Devices" menu and choosing "CoreMIDI settings".  When you launch Bol Processor, it will automatically connect to the first MIDI source and destination that it finds unless you save a startup MIDI settings file.  You can save and load MIDI settings using the buttons in the CoreMIDI settings window.\
\
If you are using external MIDI devices, you may need to configure your studio first by opening the Audio MIDI Setup program in the /Applications/Utilities folder.  Otherwise, to use your Mac's internal speaker for playback, you will need to install and run a software synthesizer.  A good free one is SimpleSynth by Pete Yandell.  You can download SimpleSynth from <{\field{\*\fldinst{HYPERLINK "http://notahat.com/simplesynth"}}{\fldrslt http://notahat.com/simplesynth}}>.  For MIDI input without an external keyboard, we recommend MidiKeys by Chris Reed.  You can download MidiKeys from <{\field{\*\fldinst{HYPERLINK "http://www.manyetas.com/creed/midikeys.html"}}{\fldrslt http://www.manyetas.com/creed/midikeys.html}}>.\
\
For a more extensive description of the MIDI implementation on OS X, see the "CoreMIDI settings" entry in BP2's online help.\
\

\b\fs26 Obtaining Help with Using Bol Processor
\fs24 \

\b0 \
Bol Processor comes with a comprehensive QuickStart Guide and Reference Manual in HTML format that you can read with any web browser.  In addition, BP2 documents most items with a built-in help system: just press the Help key or Command-? and the mouse cursor will change to a question mark.  Then click on any button or label, choose any menu item, or select words in any text window and BP2 will display help on that item.  Browsing through the many included example files can also be a good way to learn about new concepts.\
\
For additional assistance and information, there is a forum for general discussion of Bol Processor at <{\field{\*\fldinst{HYPERLINK "http://sourceforge.net/forum/forum.php?forum_id=555616"}}{\fldrslt \cf2 http://sourceforge.net/forum/forum.php?forum_id=555616}}> and a developer mailing list at <{\field{\*\fldinst{HYPERLINK "http://lists.sourceforge.net/mailman/listinfo/bolprocessor-devel"}}{\fldrslt \cf2 http://lists.sourceforge.net/mailman/listinfo/bolprocessor-devel}}> \'97 both hosted by the Sourceforge project.  Regular announcements are posted on a special "read-only" announcement list: <{\field{\*\fldinst{HYPERLINK "http://lists.sourceforge.net/mailman/listinfo/bolprocessor-announce"}}{\fldrslt \cf2 http://lists.sourceforge.net/mailman/listinfo/bolprocessor-announce}}>.\
\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
\cf0 Some additional documentation is available on the archival site <{\field{\*\fldinst{HYPERLINK "http://sldr.org/wiki/BolProcessor"}}{\fldrslt \cf2 \ul \ulc2 http://sldr.org/wiki/BolProcessor}}>.\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural
\cf0 \
Finally, you can contact the developers of Bol Processor at the email addresses given near the end of this file.\
\

\b\fs26 Future Directions
\fs24 \

\b0 \
The Mac OS X version of BP2 is checked and updated periodically to ensure that it continues to run on the latest Mac systems.  So far, a complete overhaul of the Classic Mac user interface has been beyond our limited developer resources.  Recently though, the Bol Processor development team has doubled in size (from two to four) with the return of former BP2 developer Srikumar Karaikudi Subramanian and the addition of Cazemb\'e9 Henry!\
\
There will soon be some improvements to the graphical score displays.  And perhaps now we will be able to improve the OS X user experience further by taking advantage of newer operating system features.  Our long-term development goals include adding new options for output such as Supercollider or a speech synthesizer and porting some or all of BP2 to Linux or Windows.  These features will likely be a part of "Bol Processor 3".\
\
But to make all of this happen, we need more help from other programmers as well as feedback and suggestions from our users.\
\
Please join and help us determine the future of Bol Processor !!\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f1 \cf0 \
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural

\f2 \cf0 Bernard Bel                           Anthony Kozar\
belbernard@users.sourceforge.net      akozar@users.sourceforge.net\
\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
\cf0 Srikumar Karaikudi Subramanian        Cazemb\'e9 Henry\
}