mssammon|csil-mm24|/scratch/tutorial/preprocessing|[1]% ls
sentenceboundary.tar.gz
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[2]% tar xzf sentenceboundary.tar.gz
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[3]% ls
HONORIFICS	      sentenceboundary.tar.gz 		 README
sentence-boundary.pl*
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[4]% mv sentenceboundary.tar.gz ../tars

<copy a text file to this directory>

mssammon|csil-mm24|/scratch/tutorial/preprocessing|[5]% ls
HONORIFICS	     nyttext.txt 		sentenceboundary.tar.gz
README		     sentence-boundary.pl*
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[5]% 

<sometimes stuff doesn't work first time: here I try a couple of common
 fixes for perl scripts (suffix .pl).  First, I check the file permissions
 are OK, and reset them for good measure...>

mssammon|csil-mm24|/scratch/tutorial/preprocessing|[10]% ./sentence-boundary.pl
./sentence-boundary.pl: Command not found.
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[11]% ls -l sentence-boundary.pl
-rwx------  1 mssammon grad 14192 Jun 28  2001 sentence-boundary.pl*
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[12]% chmod 744 sentence-boundary.pl
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[14]% ./sentence-boundary.pl
./sentence-boundary.pl: Command not found.
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[15]% xemacs sentence-boundary.pl

<next, I check the first line of the .pl file, which should point to the
 directory in which perl is installed on the computer you're using...
 in this case, change first line to 
 
 #!/usr/bin/perl
 
 >

mssammon|csil-mm24|/scratch/tutorial/preprocessing|[17]% ./sentence-boundary.pl
Usage: boundary.pl -d honorifics_file -i input_file -o output_file

<NOTE: if you still have problems running sentence-boundary.pl, try

 % perl sentence-boundary.pl

>

< the next command assumes you have the file nyttext.txt in the same directory
  as sentence-splitter.pl; the command 'cat' just displays the content of 
  the file >

mssammon|csil-mm24|/scratch/tutorial/preprocessing|[18]%cat nyttext.txt
Mr. Keyes will face State Senator Barack Obama in the campaign to replace Senator Peter Fitzgerald, a Republican, who is retiring.  Both Mr. Keyes and Mr. Obama are African-American, seemingly assuring Illinois of producing the fifth black elected senator.
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[19]% ./sentence-boundary.pl -d HONORIFICS -i nyttext.txt -o nyttext.sent
mssammon|csil-mm24|/scratch/tutorial/preprocessing|[20]%cat nyttext.sent
Mr. Keyes will face State Senator Barack Obama in the campaign to replace Senator Peter Fitzgerald, a Republican, who is retiring.
Both Mr. Keyes and Mr. Obama are African-American, seemingly assuring Illinois of producing the fifth black elected senator.

< ...et voila -- the sentences are split correctly. >