Re: [Audacity-manual] Allegro and Adagio (ASCII text-based score representation)

[Peter S. <pet...@gm...>]

Oops I just noticed I gave a second copy of our Glossary link rather
than the Wikipedia page, so here it is:
https://en.wikipedia.org/wiki/Allegro#Science_and_software

Peter.


On Fri, Sep 8, 2017 at 10:17 AM, Peter Sampson <petersampsonaudacity@gmail.
com> wrote:

>
>
> On Thu, Sep 7, 2017 at 3:16 PM, Peter Sampson <
> pet...@gm...> wrote:
>
>> 1) I added Steve's suggested text as a new Glossary entry for Allegro
>> https://alphamanual.audacityteam.org/man/Glossary#allegro
>>
>> 2) I added links in the Note Tracks page to that Allegro entry
>> https://alphamanual.audacityteam.org/man/Note_Tracks
>>
>> 3) i added an entry on the Wikipedia disambiguation page for our Allegro
>> https://alphamanual.audacityteam.org/man/Glossary#allegro
>> this may or may not remain - I'm only a minor Wikipedian Minion
>>
>
> This new entry has survived in Wikipedia - trimmed and edited by a more
> senior page editor - so it should be ok now.
>
> I note from that editor's user page on Wikipedia that he just happens to be
> an Audacity user:
> https://en.wikipedia.org/wiki/User:Lambtron
>
> Peter.
>
>
>>
>> 4) I adjusted the Allegro Wikipedia button in the Glossary to link to the
>> Wikipedia page/secion that 3 was created in.
>>
>> If 3 gets removed (out of my hands) I may/will need to adjust the link in
>> 4
>>
>> Peter
>>
>>
>>
>> https://en.wikipedia.org/wiki/Allegro#Science_and_software
>>
>>
>>
>> On Tue, Aug 29, 2017 at 5:32 PM, Steve the Fiddle <
>> ste...@gm...> wrote:
>>
>>> On 29 August 2017 at 17:20, Peter Sampson
>>> <pet...@gm...> wrote:
>>> > On Tue, Aug 29, 2017 at 3:45 PM, Steve the Fiddle <
>>> ste...@gm...>
>>> > wrote:
>>> >
>>> >> On 29 August 2017 at 15:20, Peter Sampson
>>> >> <pet...@gm...> wrote:
>>> >> > On Tue, Aug 29, 2017 at 2:18 PM, Steve the Fiddle <
>>> >> ste...@gm...>
>>> >> > wrote:
>>> >> >
>>> >> >> Thanks Roger,
>>> >> >> I now see that there is documentation for Allegro in:
>>> >> >> /lib-src/portsmf/allegro.htm
>>> >> >>
>>> >> >> Is that version more up to date (for Audacity) than the on-line
>>> version
>>> >> at:
>>> >> >> http://www.cs.cmu.edu/~rbd/software/allegro.htm
>>> >> >>
>>> >> >> @ documentation team: How much documentation about Allegro should
>>> be
>>> >> >> included in the manual?
>>> >> >>
>>> >> >
>>> >> > Well, we don't tell the vey much about MIDI - not on the Note Tracks
>>> >> page:
>>> >> > https://alphamanual.audacityteam.org/man/Note_Tracks
>>> >> >
>>> >> > Nor on the Import MIDI page section:
>>> >> > https://alphamanual.audacityteam.org/man/File_Menu:_Import#midi
>>> >> >
>>> >> > Nor on the Export MIDI page section:
>>> >> > https://alphamanual.audacityteam.org/man/File_
>>> >> Menu:_Save_Other#export_midi
>>> >> >
>>> >> > We have a terse desription in the Glossary:
>>> >> > https://alphamanual.audacityteam.org/man/Glossary#midi
>>> >> >
>>> >> > So I'm guessing that for Allegro - not much more ...
>>> >> >
>>> >> > We do have a link to this page:
>>> >> > https://www.cs.cmu.edu/afs/cs.cmu.edu/project/music/web/
>>> >> music.software.html
>>> >> > for Allegro from the Export page above - but it's not a very good
>>> page to
>>> >> > link to imo
>>> >> >
>>> >> > So a Glossary entry for Allegro with suitable links would probably
>>> be
>>> >> good
>>> >> > - and good enough.
>>> >>
>>> >> There is a difference with MIDI though, which is that there is a huge
>>> >> amount of information readily available about MIDI, but I think
>>> >> Audacity is unique(?) in supporting Allegro .gro files, and there is
>>> >> hardly any information anywhere other than that one, fairly hard to
>>> >> find page on the CMU website.
>>> >>
>>> >> If Roger confirms that the page in the Audacity source code is the
>>> >> most relevant / up to  date version, then perhaps I could add that
>>> >> page to the Audacity  wiki, and we could link from the manual to that?
>>> >>
>>> >
>>> > Sounds like a plan +1.
>>> >
>>> > But a Glossary entry could be good too - but you'd have to tell me
>>> waht to
>>> > write ;-))
>>>
>>> How about something like:
>>>
>>> "Allegro is a text-based language for music representation. In common
>>> with MIDI<link> it represents notes, tempo, and other commands that
>>> may instruct a synthesizer<link> or sampler<link> what to play. In
>>> Audacity, Allegro (,gro) files may be imported as Note tracks<link> or
>>> exported from Note tracks."
>>>
>>> (Perhaps Roger could offer some refinement to that?)
>>>
>>> Steve
>>>
>>> >
>>> > Peter
>>> >
>>> >
>>> >>
>>> >> Steve
>>> >>
>>> >> >
>>> >> > Peter.
>>> >> >
>>> >> >
>>> >> >
>>> >> >
>>> >> >>
>>> >> >> Steve
>>> >> >>
>>> >> >>
>>> >> >> On 29 August 2017 at 13:28, Roger Dannenberg <rb...@cs...>
>>> wrote:
>>> >> >> > Yes, it's confusing. "Adagio" is actually pre-midi and goes back
>>> to
>>> >> 1983
>>> >> >> > and was written for a microcomputer in Pascal (!)  It made its
>>> way to
>>> >> >> > the CMU MIDI Toolkit in C, and was incorporated into XLISP and
>>> then
>>> >> into
>>> >> >> > Nyquist. Around 2000, it seemed time for an overhaul and
>>> extension to
>>> >> >> > support more general timed event annotations with attribute/value
>>> >> pairs,
>>> >> >> > but some of the Adagio notation and general idea of simple ASCII
>>> text
>>> >> >> > supporting notes, duration, tempo, and other musical concepts.
>>> >> Audacity
>>> >> >> > was part of that effort and "note tracks" were originally
>>> implemented
>>> >> >> > for annotation of audio data using this new Allegro library for
>>> >> >> > import/export of annotations.
>>> >> >> >
>>> >> >> > In short, Adagio was incorporated into Nyquist, and Allegro was
>>> >> >> > incorporated to make Note Tracks. They are functionally similar,
>>> but
>>> >> not
>>> >> >> > compatible.
>>> >> >> >
>>> >> >> > -Roger
>>> >> >> >
>>> >> >> >
>>> >> >> > On 8/29/17 6:45 AM, Steve the Fiddle wrote:
>>> >> >> >> Added Roger to the recipient list as he is probably the only
>>> person
>>> >> >> >> able to give a definitive answer to this.
>>> >> >> >>
>>> >> >> >> In the Audacity manual there are references to "Allegro" (.gro)
>>> >> files,
>>> >> >> >> but no mention of Adagio (that I can find).
>>> >> >> >>
>>> >> >> >> In the Nyquist manual there are references to "Adagio" (.gio)
>>> files,
>>> >> >> >> but mo mention of Allegro (that I can find).
>>> >> >> >>
>>> >> >> >> Adagio is described in the Nyquist manual as:
>>> >> >> >> "an easy-to-use, non-procedural notation for scores"
>>> >> >> >>
>>> >> >> >> Allegro is only loosely referred to in the Audacity manual in
>>> >> relation
>>> >> >> >> to Note tracks, but is not defined.
>>> >> >> >>
>>> >> >> >> Audacity supports importing and exporting Allegro (.gro) files
>>> but
>>> >> not
>>> >> >> >> Adagio (.gio) files.
>>> >> >> >>
>>> >> >> >> What is an "Allegro" file, and what, other than the file
>>> extension,
>>> >> is
>>> >> >> >> the difference between Allegro and Adagio?
>>> >> >> >>
>>> >> >> >> Steve
>>> >> >> >
>>> >> >> >
>>> >> >>
>>> >>
>>> >> ------------------------------------------------------------
>>> >> ------------------
>>> >> Check out the vibrant tech community on one of the world's most
>>> >> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
>>> >> _______________________________________________
>>> >> Audacity-manual mailing list
>>> >> Aud...@li...
>>> >> https://lists.sourceforge.net/lists/listinfo/audacity-manual
>>> >>
>>> > ------------------------------------------------------------
>>> ------------------
>>> > Check out the vibrant tech community on one of the world's most
>>> > engaging tech sites, Slashdot.org! http://sdm.link/slashdot
>>> > _______________________________________________
>>> > Audacity-manual mailing list
>>> > Aud...@li...
>>> > https://lists.sourceforge.net/lists/listinfo/audacity-manual
>>>
>>> ------------------------------------------------------------
>>> ------------------
>>> Check out the vibrant tech community on one of the world's most
>>> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
>>> _______________________________________________
>>> Audacity-manual mailing list
>>> Aud...@li...
>>> https://lists.sourceforge.net/lists/listinfo/audacity-manual
>>>
>>
>>
>