╔═══════════════════════════════════════════╗
                                                         
                    W E L C O M E    T O    D M U S E    
                  ═════════════════════════════════════  
                ╚═══════════════════════════════════════════╝

                 ┌────────────────────────────────────────┐
                 │ <shft> F1  =  Toggle to regular window │
                 └────────────────────────────────────────┘

    ┌──────────────────────────────────────────────────────────────────┐
                                                                    
          If you are reading this document for the first time and   
      are unfamiliar with the commands for scrolling the text, you  
      should be aware that <ctrl> ▲ (hold down the <ctrl> key and   
      push the cursor UP key) will scroll the text UP and <ctrl> ▼  
      will scroll the text DOWN.  You can also use the PageUp and   
      PageDown keys to scroll quickly through the document.         
                                                                    
    └──────────────────────────────────────────────────────────────────┘


1.1       Dmuse is a multi-tiered program.  At the most basic level,
      it is a program designed to display and print musical scores and
      parts.  You may use it for this purpose without knowing about or
      using any of its other features.  But Dmuse can also function as
      a multi-window, multi-tasking research environment.  It includes
      a resident file manager, a fully integrated screen editor with
      30 overlapped windows and a powerful programming language called
      Zbex.  Each of the 30 windows can act like a computer terminal
      and run a Zbex program.  At the same time, these windows
      continue to respond to screen editor commands.


1.2       We have attempted to organize the documentation for Dmuse
      in a way that reflects its multi-tiered character.  At the
      simplist level, the operation of the program is designed to be
      self evident -- hence the menu bar at the top, with its five
      pull-down menus.  Using these menus, you can perform the basic
      operations necessary to display and print music.  The help
      subjects Displaying Music and Printing Music (included in the
      help menu), will give you the information you need to perform
      these functions.


1.3       The next level of complexity is learning to use the screen
      editor.  This knowledge will be useful if you decide you want
      to edit the music files.  Also, learning to use the editor is
      a prerequisite to using any of the advanced features of Dmuse.
      The help subject, Using the Screen Editor gives a complete
      description of how the editor functions.  You may also learn
      about the editor keystrokes through The Editor Keystrokes
      utility included in the help menu.


1.4       If you want to edit or change the music, you will need to
      understand the format of the Music Page Files (.MPG files)
      and the Compressed Format Files (.CFT files).  You will find
      documentation for these subjects in the help selections
      MPG file format and CFT file format.


1.5       You will find the resident file manager to be an extremely
      useful utility.  A detailed description of this utility can be
      found in the help selection Resident File Manager.


1.6       The advance applications fall into three categories:
      (1) using wordwrap with the editor, (2) the Zbex programming
      language, and (3) the use of dictionaries.  Dmuse is installed
      with these applications disabled.  The idea is that Dmuse
      should appear initially as a simple and easy-to-use program
      for those people who only want to display and print music.
      If you are interested in one or more of the advanced
      applications, the help selection Advanced Topics contains
      the documentation you need, including instructions on how
      to activate these features.


1.7       This completes the introduction to Dmuse.  For those
      users who are curious about the origin and evolution of the
      Dmuse program, what follows is a history of how this program
      came to be written and what future purposes it might serve.


    ──────────────────────────────────────────────────────────────────


2.1       The story begins in the mid 1970's before the advent of
      personal computers.  At that time, the smallest computer a user
      could buy was called a MINI computer.  In terms of today's PC
      hardware and software, the MINI computer was a technological
      infant.  Memory size and disk space were measured in kilobytes
      instead of megabytes; and computer speed was measured in
      thousands of Hertz instead of billions.


2.2       The software required to run the MINI computer was arcane
      a user pretty much needed a background in computer science to
      use one.  Nevertheless, there were visionaries at that time
      who understood the potential the computer held for changing
      the way we work.  One of these was David Woodley Packard, a
      professor of Classics at UCLA.  Packard was interested in
      using the MINI computer for research and teaching in ancient
      languages, principally ancient Greek.  Using knowledge he had
      gained from working with the computer system at UCLA, Packard
      designed a specialized time sharing system called Ibycus,
      which ran on Hewlett Packard hardware and displayed ancient
      Greek on computer terminals, something that had not been done
      before.  To assist the development of applications on this
      system, Packard developed a specialized programming language
      called Ibex.


2.3       I first became interested in computer applications in music
      in 1982.  At that time, commercial software applications for
      the Humanities were practically non existant.  Most of the work
      being done in this area was confined to university research
      projects using large, centralized computing facilites.  I did
      not have access to these kinds of resources, but fortunately I
      was familiar with the progress that David Packard had made in
      creating a scaled down, affordable system for humanities
      research.  I therefore arranged to acquire an Ibycus system for
      my own research.  The Ibycus system turned out to be ideal for
      this purpose, and its availability was one of the primary factors
      in my decision in 1985 to formally establish the non-profit
      Center for Computer Assisted Research in the Humanities (CCARH).


2.4       We continued to use the Ibycus system at CCARH until 1989,
      at which time we decided the system needed upgrading.  David
      Packard had already made the decision to abandon the outdated
      MINI computer hardware and to implement his next version of
      Ibycus on a dedicated personal computer which he designed and
      built himself and which he called the Baby Ibycus.  Moving in
      a slightly different direction, I decided to implemented a
      stripped down version of the Ibycus system first on a UNIX
      workstation using X-Windows and later on the PC.  I called my
      program "the Monster," because it ran all of my Ibex software
      and served as a complete working environment.  I added some
      features to the Ibex programming language but dropped others.
      In particular, the system lost its capability to display
      ancient Greek but gained the capability to display musical
      notation.  I have named this Ibex variant Zbex.


2.5       We have been using the Monster at CCARH since 1992.  We use
      it for all of our data entry, data storage, music typesetting
      and publishing, and music research applications.  We also use
      it for running the Center.  All of the financial operations of
      the Center -- check writing, book keeping, payroll and payroll
      taxes are done with Ibex programs running on the Monster.  All
      software development is done using the Monster's editor.  All
      research software is written in Zbex.


2.6       When it came time to write a user program for displaying
      and printing music, what I needed was a user interface.  I
      already had versions of these programs written in Zbex and
      running on the Monster.  My two choices were (1) to write a
      new, dedicated interface for this purpose, or (2) to graft
      the music display and printing applications onto the existing
      Monster program.  I chose the second option for two reasons:
      (1) I determined that it would take less time to get the job
      done if I used the interface I had already developed, and (2)
      I saw good reasons for making the Monster available to other
      people.  This inproved version of the Monster was completed
      in 1995 and was given the name Dmuse.


2.7       From 1995 until 2006, the Dmuse environment stayed
      basically the same and became quite stable over these years
      of use.  But the world of computing changed radically during
      this same time period.  The DOS operating system, upon which
      Dmuse was built, virtually became extinct.  Computer speed
      and memory increased more than 100 fold, and graphical interfaces
      were completely redesigned.  These changes -- especially the
      death of DOS -- threatened to choke off Dmuse as a viable user
      interface.  It was clear that Dmuse needed to be moved to a
      new platform.  My choice was Linux.


2.8       In the fall of 2006, I began a process of revising Dmuse
      to run in a X-Window on Linux.  Fortunately, I had the experience
      in 1989 of writing to X, and also the necessary documentation.
      I say "fortunately," because in today's world (2007) most
      interface programmers never deal with X-Windows directly;
      instead, they write using higher level "Widgets."  The problem
      with Widgets is that they presuppose certain interface
      conventions such as popup windows, buttons, slide bars, etc.,
      all of which are made easy.  But other interface conventions
      such as the blackboard metaphone used by Dmuse become extremely
      difficult if not impossible to implement with Widget style
      programming.  The transfer of the Dmuse environment to Linux
      was competed in the fall of 2007.


    ──────────────────────────────────────────────────────────────────


3.1       I believe that Dmuse could become a valuable asset to anyone
      wishing to use the computer for research in many branches of the
      Humanities, including but not limited to music.  As people in the
      field of Classics are aware, David Woodley Packard's Ibycus
      system was highly successful for both teaching and research
      purposes and was instrumental in the development of the great
      databases of classical literature, the TLG at UC Irvine and the
      TLL at the Packard Humanities Institute and Yale University.  I
      believe other such opportunites also exist.  The fact is that
      scholars have just barely scratched the surface of what computers
      can do in aiding research in their disciplines.  Each of today's
      PCs is 1000 times more powerful than the big, multi-million
      dollar mainframes of the 1960's that used to sit behind glass
      walls at major universities.  Yet in terms of reseach applications
      in the humanities, in most cases (Classics is an exception) we
      have not progressed very far from those days.


3.2       This brings me to the final help selection, namely, New
      Directions.  Here I discuss possible new directions that
      Dmuse could take, including both musical and non-musical
      applications.  We cannot move forward in all directions at
      once.  The decision about what we do next depends in large
      part on what you, the users of this program, would like to
      have.  We recognize that there are a lot of software
      alternatives available to today's user and that a program
      like Dmuse will be useful only if it occupies a niche that
      is both useful and unique.  We welcome your feedback.


      Walter B. Hewlett
      Stanford, CA
      December, 2007