Humdrum Extras

The list of programs on the main page contains links to compiled versions of the program for various operating systems. Here is a sample entry in the alphabetical listing of programs on the main page:

barnum: Number, renumber, or remove barline numbers in Humdrum files.
description
examples 		program:
9 Sep 2004 		linux
10 Sep 2004		 osx/ppc
11 Mar 2005		 osx/i386
1 May 2009		 windows
10 Mar 2005

The list of the components given in the example program entry above is:

  1. description -- the man page for the program describing its options in detail.
  2. examples -- example usages of the program.
  3. program -- a link to the source code for the program. Download the full source code distribution file if you want to change/compile a program yourself. The date under the program link indicate the last date that it was edited. If this date is later than other dates for the compiled programs, then the compiled programs may need to be compiled for new features or bug fixes. Of course, the library code which a program uses could have been changed more recently that the acutal program source code, so this method of checking on the updatedness of a compiled program is not 100% accurate.
  4. linux -- compiled program for linux (statically linked). The date underneath the link indicate the date on which the linux executable was compiled.
  5. osx/ppc -- compiled program for Macintosh OS X.2 and higher on a computer using a PowerPC CPU. The date underneath the link indicate the date on which the osx executable was compiled.
  6. osx/i386 -- compiled program for Macintosh OS X.2 and higher on a computer using an Intel Pentium CPU. The date underneath the link indicate the date on which the osx executable was compiled.
  7. windows -- compiled program for the command prompt terminal in Microsoft Windows 95 and higher.. The date underneath the link indicate the date on which the window executable was compiled.

To save the compiled programs to your hard disk, you could try clicking on the link and your web browser might prompt you about saving the file. If your browser instead tries to display the compiled program as text, then you should try to right click (in windows/linux) on the link and choose the "Save As..." option in the menu which appears at the location of the mouse (or do a option-click in OSX).

In linux, cygwin, and osx (with GNU utilities installed), you can use the wget program to download the executable prorams from the command-line. For example, here are the commands for copying the barnum executable program to your computer for various operating systems: 

   wget http://extras.humdrum.org/bin/linux-static/barnum
   wget http://extras.humdrum.org/bin/cygwin/barnum
   wget http://extras.humdrum.org/bin/osxppc/barnum
   wget http://extras.humdrum.org/bin/osxintel/barnum
   wget http://extras.humdrum.org/bin/windows/barnum
In Apple OS X, if you do not have wget installed, you can try downloading from the command-line terminal with the apple-specific (thus inferior) curl program: 
   curl http://extras.humdrum.org/bin/osxintel/barnum -o barnum
In unix-like operating systems (OSX and linux), you may need to run the following command to let the operating system know that the file is a program: 
   chmod 0755 barnum

You can run the program from any location. If you run it from the current directory, you may need to add an explicit path so that the operating system knows where it is. For example, if a program call such as: 

   barnum file.krn
Results in an error stating that barnum is not found, then you may be able to fix the problem by adding ./ before the program name (without any spaces): 
   ./barnum file.krn
Likewise, in cygwin, you may need to run the command like this: 
   ./barnum.exe file.krn