From: obry@flash.bellcore.com (Pascal Obry)
Subject: GUITARE V2.5 ...
Organization: /u/obry/.organization
Distribution: alt.guitar,alt.guitar.tab
Date: 17 Aug 92 09:49:40



Hi,

The new version of GUITARE is now available. You can get it from ftp.

	ftp ftp.nevada.edu
	cd pub/guitar/GUITARE
	get README.1st ...

By the way, many thanks to James that put my program in his archive.
I included here the README for this version ...

Bye,
Pascal.

-----------------------------------------------------------------------------

*******************
** GUITARE V2.5  **
*******************

Pascal OBRY (obry@bellcore.com)

-----------------------------------------------------------------------------

Informations
============

This program is the fifth version. I want it to be a help for the guitarist.
An help to explore the world of scales, chords, fingering ...

I distribute this for free (and without guarantees), so you can copy it and
redistribuate it to your friends freely.

All comments and bugs report will be welcome.


///////////////\
**IMPORTANT **
\\\\\\\\\\\\\\\/

This program is written in Ada, and I can't distribute a true executable 
version. So, you MUST have a Ada compiler to use it. If you have no Ada
compiler, try Ada/Ed from NYU (its free too), I make this program entirely 
with this compiler/interpreter.

Why 'true executable' version, because I can distribute a kind of
executable for PC, SPARC, DEC5000 (see comment at the end of this text).

-----------------------------------------------------------------------------

Acknowledgements
=================

Thank you to the team of NYU that provide a free Ada compiler/interpreter.

Thank you to Geoffrey O. Mendal for making the SEARCH packages.

-----------------------------------------------------------------------------

Compilation
===========

	type amake (script for Ada/Ed)

	All should be without problem.

	If you use another compiler, maybe you will have to change the
	script, but this one will help you to find the dependancies.

-----------------------------------------------------------------------------

PC users
========

1)
	If you plan to use GUITARE you need at least a 386 and 2Mb.

2)
	you must not use emm386 or QEMM.

3)
	If you use my 'binary' version
	you should not be able to use POSITION for the chord with
	many notes (like the thirteenh or eleventh chords)

	Why ?
	Because my compiler is not a commercial one and it don't
	free very well the memory after usage ... So very quickly the
	entire memory of your PC will be used.

	Solution ?
	If somebody have access to a professional Ada compiler, compile
	my sources and send me back the executable version that I will
	put in the nevada archive.

4)
	Since the V2.5, I change the name of some files to be in the PC format.
	(i.e. no more than 8 characters for the filename)

-----------------------------------------------------------------------------

History
=======

*************** (V1.0)  ***************  JUNE, 8 (sources 35 ko)

CHORD <chord name>

	give the notes in the chord, and display these notes in
	the neck of the guitar.

	<chord name> : Cmin/maj7 Cadd9 C7sus4 E#dim6 Dmaj9+11 Ao7 B ...

	know : minor, major, dominant7, seventh, eleventh, thirteenth
	       diminish, half diminish, suspended 4, suspendend 2
	       add, - and + sign

	ex : 
	> chord C
	> chord Ao7
	> chord Bmin9

SCALE <note> [<mode>]

	give the notes in the scale, and display these notes in
	the neck of the guitar.
		
	<note>       : C Db A# E ... (must be in capital letter)
	[<mode>]     : [optional] MAJOR, MINOR, DORIAN ...

	know : MAJOR/IONIAN, MINOR/AEOLIAN, DORIAN, PHRYGIAN, LYDIAN
	       MIXOLYDIAN, LOCRIAN

	ex :
	> scale D
	> scale Gb locrian

DISPLAY [STANDARD/EXTENDED]

	display the neck with 12 or 24 frets. Without parameter, the
	mode STABDARD is used.

TUNE [<note1> <note2> <note3> <note4> <note5> <note6>]

	give the tuning of the guitar. Without parameter, the default
	mode is used (i.e. TUNE E A D G B E)

	ex :
	> tune D G D G B D
	this defined the open G or "slack key" tune.

	> tune D G D G C D
	this defined the G modal or "sawmill" tune.

OUTPUT [STANDARD/<file>]

	write all informations into <file> or into the standard output.
	this allow to keep a log file.

	ex :
	> output
	> output file.out

INFO
	give some informations about the current parameters.

HELP
	display this message.

QUIT
	exit from the program.


*************** (V2.0)  *************** JUNE, 19 (sources 48 ko)

Modifications
-------------

You can display simultaneously 3 objects :

	object 1 can be - scale or chord
	object 2 can be - chord only
	object 3 can be - notes

	(this lead to a better ergonomy)

CHORD [<chord name>]
	with parameter : put this chord into object1
	without : clear object 1.

SCALE [<note> [<mode>]]
	with parameter : put this chord into object 1
	without : clear object 1.

DISPLAY become FINGERBOARD


-> the program handle more exceptions, (bad note, bad scale name ...) so it must exit
   less often and give more informations about the problems.


New
---

FINGERBOARD
	is the same as DISPLAY in V1.0

DISPLAY
	display the fingerboard

OVERLAY [<chord name>]
	with parameter : put this chord into object2
	without : clear object 2.

	ex :
	> chord C
	> overlay Dmin

NOTE [<note> [<note> ...]]
	with parameter : put these notes into object 3
	without : clear object 3.

	ex :
	> chord C
	> overlay Dmin
	> note B
	> note
	> overlay

TRANSPOSE <from_key> <to_key> MINOR/MAJOR <chord> [<chord> ...]
	transpose all the chords from the from_key to the to_key in the given
	mode.

TRANSPOSE <to_key>
	transpose in a new key (after the command above)

	ex :
	> transpose E G major E G#min7 D#dim
	> transpose B


And more modes :      WHOLE, HARMONIC_MINOR, DIMINISHED, BLUES,
		      PENTATONIC_MAJOR, PENTATONIC_MINOR, NEAPOLITAN_MAJOR,
		      NEAPOLITAN_MINOR, ENIGMATIC, HUNGARIAN


*************** (V2.0a)  *************** JUNE, 22 (sources 48 ko)

I fix 2 bugs :

	- the scale was bad formatted for the creation of extended chord like
	  Cadd9, Cadd11, Cm9, Cmaj13 ...

	- Synonym m9 for min9 was not handled.

*************** (V2.0b)  *************** JULY, 16 (sources 50 ko)

I fix 1 bug :

	- Synonym m for min was not handled.

I modify the output

	- a fingerboard is not cut in the output file. (formated in one page)

	- a '>' symbol before the string indicate that the unfreted string give
	  a note contained in the curent display.

I add the CHROMATIC scale.


*************** (V2.5)  *************** August, 3 (sources 90 ko)

----------------------

PC Users :

I change the name of some files to be in the PC format.
(i.e. no more than 8 characters for the filename)

----------------------

Now GUITARE handle a new chord format : C/E or D/F# ...


I add the POSITION, WITHOUT, COMMON_CHORDS and KEY_FOR commands.

POSITION [EASY / MEDIUM / DIFFICULT]

	display the fingering for the current chord in object 1.
	if object 1 is a scale it does nothing.
	if object 1 is a chord then it clear object 2 and 3 display the
	new fingerboard and then display the fingering positions.


WITHOUT <THIRD / SEVENTH / NINTH / ELEVENTH>

	without is only needed with the thirteenth chord. Why ?
	because a thirteenth chord has 7 notes and a guitar has only
	six strings. So, for this kind of chord you can delete one note
	from the chord. By default it is the eleventh.

	ex : 

	> chord C13-9
	> without ninth
	> position difficult

COMMON_CHORDS

	display the common chords found in a special key.
	this command is active only when the object 1 is a scale (of course !)
	The scale define the key.

KEY_FOR <chord name> [<chord name> ... ]

	return the key for the set of chord.

	ex :
	> key_for Abdim C#min D

-----------------------------------------------------------------------------

New release
===========

I plan to make the following enhancement :

(V3.0)
	analyse <note> <note> <note> [<note> ...]
		give the name(s) of the chord contaning the given notes.


-----------------------------------------------------------------------------

Now the program is avalaible by ftp.

	ftp ftp.nevada.edu
	cd /pub/guitar/GUITARE

	get README.1st (explain what to get, and how to make it running)
	get README (this file)

	get ...

I you have not a FTP access, send me a mail, I will send you the
program.

	- Ada sources
	- PC binary       (read PC users section)
	- SPARC binary
	- DEC 5000 binary

-----------------------------------------------------------------------------

bugs report
===========

Please, if you report a bug include :

	- your sample
	- the answer of my program
	- and the answer that you were expecting
	- and some comments.



Enjoy it !
Pascal.
--

-------------------------------------------------------------------------------
--  Pascal OBRY								     --
--  Room 2D-337				e_mail : obry@bellcore.com  	     --
--  Bellcore								     --
--  445 South Street			voice : 1 - 201 829 4039	     --
--  Post Office Box 1910						     --
--  Morristown, New Jersey 07962-1910					     --
-------------------------------------------------------------------------------

  `` inheritance is surely a good answer, but who knows the question ? ''

Newsgroups: alt.guitar