# README for the ITRANS Song Book 3.1 package (7/26/95)
# July 1995 Release 

               Release 3.1 of the ITRANS Song Book (ISB)
            -------------------------------------------------


This is a package which contains hindi, english, marathi, sanskrit, and 
urdu (can also contain bengali, tamil, or telugu songs in principle) songs 
in ITRANS transliterated form (see docs/mini-FAQ for what transliteration 
means), which allows the songs to be printed out in their native scripts.  

The ITRANS transliteration software (written by Avinash Chopde) is the 
basis for the ISB (ISB 3.1 needs ITRANS version 4.04).  To use ITRANS, you 
must have the TeX/LaTeX text formatting package and some sort of PostScript 
previewer (both are in the public domain).  The SOURCE version of ISB release 
3.1 (to be described later) can be used on Unix and DOS/Windows machines.  
The POSTSCRIPT version of ISB release 3.1 can be used on any machine which 
has the ability of preview PostScript (if the machine doesn't have a Post-
Script previewer, the PostScript songs can still be printed if a PostScript-
capable printer is attached).

The input is in a transliterated form, each letter in an indian language is 
assigned an english equivalent, and the english alphabet is used to construct 
what will eventually print out in the indian language script.  To learn more 
about ITRANS, see the mini-FAQ file in the docs subdir.

Each song is kept in a .s file The name of each file is <filename>.s.  Each 
.s file contains just the song in ascii and some info regarding the song.  
To print out the song, you have to convert the .s file to PostScript using 
a series of steps. See files isitx.hdr and makefile.unx for more details.

New features in ISB Release 3.1 (compared to Release 3.0):

1.  200 new hindi songs, 3 new sanskrit docs.
2.  Many pstats added/corrected and song lyrics fixed.

Needless to say, there are still many errors in the ISB.  I'd really appreciate 
hearing about them.  Please send me mail at anurag@chandra.astro.indiana.edu.

====================================

DESCRIPTION OF THE ISB 3.1 SOFTWARE:

There are three main tar+compressed files in this Unix release:

isongs-3.1_src.tar.gz - contains the ITRANS songs source.

isongs-3.1_ps_land.tar.gz - contains all ISB docs in PostScript 
   format, ready to print in landscape mode (this requires more paper but
   is nicer to look at).

isongs-3.1_ps_port.tar.gz - contains all ISB docs in PostScript 
   format, ready to print in portrait mode (this requires less paper but
   the narrower space sometimes causes the output to be pushed to the
   next line for long lines).

the .gz version is made with GNU-zip (use 

   gunzip -c isongs-3.1_whatever.tar.gz | tar xvf -

to uncompress+untar.

1. THE ISB SOURCE:

The ISB source contains all of the ITRANS songs in ascii plus additional
files which are necessary to convert them from ascii to PostScript.  In 
addition to the ISB source, you need to have the following packages installed 
on your machine before you can do the conversion (of course, you DON'T HAVE
to do any of this if you just want to print the songs - a PostScript only
version of the ISB - described below - is all you need):

(a) ITRANS version 4.04
(b) TeX/LaTeX 
(c) dvips, and 
(d) ghostscript/ghostview  (or some other PostScript previewer)

Installation of the ISB source is an involved procedure and requires some
knowledge of the Unix operating system.  If you know little about Unix, this 
maybe the time to experiment and learn.

Of course, you could just use the ascii songs if you can't read hindi/marathi/
sanskrit...  

The ISB source is in the file isongs-3.1_src.tar.(gz or Z).  These files
contain the following (when uncompressed and untarred):

Directories:

	docs/      : more documents about the ISB, ITRANS, etc.  I HIGHLY
		     RECOMMEND READING EVERYTHING IN THIS DIRECTORY.
	english/   : the English poetry (contains Gitanjali)
	hindi/0/   : the Hindi film songs, bhajans, ghazals, etc. (100/subdir)
	hindi/1/        "
	hindi/2/        "
          .             .
          .             .
          .             .
	hindi/11/       "
	hindi/12/       "
	hindi/db/  : ascii database by film, actor, singer, md, and lyricist
	marathi/0/ : the Marathi songs
	marathi/1/      "
	sanskrit/  : the Sanskrit/Hindi documents/prayers etc.
  	urdu/      : the Urdu docs - Ghalib ghazals.

You'll also find a small file called "dist" in each dir.  Don't worry about it 
(it is used to produce a distribution release by the archiver).

Each of the hindi/ directories contains 100 songs.  The marathi/, sanskrit/, 
and english/ directories contain more documents.

Files:

   DEDICATE:    The ITRANS Song Book dedication to V. K. Gopalakrishnan.

   DISKSPACE.NEEDED:   Tell you all about how much disk space ISB needs.

   NOTICE:	A message about the ITRANS Song Book package and some
		copyright issues.

   README.sys:  A little note for system administrators who want to make
	 	the ISB available at their site.

   TRANS.DOC:	Contains the transliteration scheme used in all the
		documents. Use this scheme if you wish to send me files
		to be added to the package.

   VERSION:     Tells you which version of ISB it is.

Subdirs and their contents:

    hindi/hindex.s: Contains the sorted list of "hcontent.s".
    		Note: the sorting is with respect to the English alphabet.

    hindi/hcontent.s: Contains the table of contents of the hindi songs.

    hindi/raga.itx, raga.ps:  Contains songs listed by ragas.

    hindi/dbase: Contains the database of all hindi songs in the ISB.
                 Each line represents the dbase entry for one songs.
                 The fields are separated by colons (:).  The fields
                 are as follows: 

                 songnumber:songtitle:film:actor:singer:music director:lyricist

                 This database is being provided so people can grep
                 for their favorite film/singer/actor/music director/lyricist.

    hindi/inquire: a little shell script to search the database.  Just
                   do "inquire string" to look for it in the dbase on
	           unix boxes.

    idevn.tex:	Contains TeX macros for use with ITRANS.
		Copy this file to a location where TeX can find it, or,
		set the environment variable TEXINPUTS to include the
		name of the directory where this file is present.
    
    dvng_is.ifm: Contains IFM table needed by ITRANS.
		Copy this file to a location where ITRANS can find it, or,
		set the environment variable ITRANSPATH to include the
		name of the directory where this file is present.
    
    isitx.hdr:	Contains the ITRANS/TeX commands necessary to print out
		the songs from the individual .s files.
		The top of file contains some configurable options:
		whether to print in two column mode, whether to use
		landscape mode, and what size devanagari font to use.

    isips.hdr:	Contains the ITRANS/PostScript commands necessary to print
		out the songs from the individual .s files.
		(Note: using isips.hdr requires manual modifications to
		each source file, and is just provided as an sample, it
		may not work.  TeX with isitx.hdr is much easier to handle,
		so use it if you can.)
		
    makefile.pc: (makefile for MS-DOS - Borland Make)

    makefile.unx: (UNIX makefile)
		These makefiles provide automated conversion
		of the .s file to a .itx and then to a .tex, and then
		a .dvi and a .ps file for eventual printing.
		You will have to edit these makefiles to match your
		system configuration and your needs.
		Copy the required makefile to "makefile", and edit it as
		needed.
		The best way to convert .s or .itx files is to go to the
		directory where the .s or .itx file is present, and then
		run:
		make -f ../../makefile 1.ps
		or
		make -f ../makefile bhagvad.ps

    makefile.dist: (Unix distribution makefile)
                Don't mess with this makefile unless you know about makefiles.
		It is used for making a distribution copy of the entire 
		release by the archiver.

    isongcat.c:	C Source file.
                It is a utility used for combining a bunch of .s files into
    		a single .s file. Use this to create a single printout
    		containing a bunch of songs.

    		Run "make allsongs" to create files containing bunches of
		songs in the hindi/ directory.  To make your own bunch of
		songs, create a text file containing isong file numbers
		one to a line, and pass it to isongcat...(see isongcat.c
		for details).

    isongcat.com: isongcat.c executable for MS-DOS machines.

    
2. THE POSTSCRIPT ISB SONGBOOK:

For those who have no desire to play with the ISB source (and I can't blame
you if you don't), all of the songs in ISB 3.1 have already been converted 
into PostScript and are available here.

The files isongs-3.1_ps_land.tar.gz (~ 2.4 MBytes) or isongs-3.1_ps.tar.Z 
(~ 2.4 MBytes) contain all ISB documents in the devnag script in PostScript form
(either landscape or portrait mode).  You can directly print them on a 
PostScript printer or preview them on-screen using a PostScript previewer 
(such as ghostview/ghostscript/gsview/whatever).

The compressed tarfiles contain:

Directories:

	ps/english/   : the English poetry (contains Gitanjali)

	ps/hindi/land : the Hindi film songs, bhajans, ghazals, etc. 
            or            in landscape or portrait mode depending on
	ps/hindi/port   whether you have _ps_land.tar.gz or _ps_port.tar.gz

	ps/marathi/   : the Marathi documents
	ps/sanskrit/  : the sanskrit/religious hindi documents
	ps/urdu/      : the Urdu documents (Ghalib's ghazals with an 
			explanation)

Files:

	ps/hcontent.s : the table of contents for the hindi song archive
	ps/hindex.s   : the alphabetical hindi song index
	ps/hindi/land or port/h???-???.ps : Hindi songs, 100 songs per file
	ps/marathi/m???-???.ps: Marathi song archive, 100 songs per file

The PostScript songs are also available in unarchived format at the anonymous 
ftp site chandra.astro.indiana.edu (/pub/isongs/ps and the subdirs).  You can 
also look at them on-line individually by connecting to one of the two WWW 
servers:

 chandra.astro.indiana.edu (URL: http://chandra.astro.indiana.edu/isongs)

 or

 www.cs.wisc.edu (URL: http://www.cs.wisc.edu/~navin/india/songs/index.html)

The first server allows you to search for specific songs by keywords in 
song titles.
    
====================================
Acknowledgements:

    Please see the DEDICATE file for the dedication.

    Numerous people have been involved in this free rolling project, it is
    impossible to thank all of them, but each person who contributed to
    a song has his or her name listed in the *.s or *.itx song file itself.

    To list a few names, here are some who contributed much to this
    collection:

	Anurag Acharya          (anurag.acharya@cs.cmu.edu)
	Arati Deo		(arati@soma.rice.edu)
	R. Gopalakrishnan       (gopalakr@cis.udel.edu)
	V.K. Gopalakrishnan     (gopala@cs.wisc.edu)
	Preetham Gopalaswamy	(preetham@eng.umd.edu)
	Shripad Lale            (lale@cent.gud.siemens.co.at)
	Preeti Ranjan Panda	(ppanda@cliff.ICS.UCI.EDU)
	Rajan P. Parrikar	(parrikar@csn.org)
	Ravi Rai		(rrai@ndsun.cs.ndsu.NoDak.edu)
	Satish Subramanian	(subraman@cs.umn.edu)
	C. S. Sudarshana Bhat	(cesaa129@utacnvx.uta.edu>
	Vivek Vohra             (vivek@che.rochester.edu)
	Mani Upadhyaya          (mani@eng.utoledo.edu)

    The following people played a major role in the production of the
    ISB 3.1:

        Preetham Gopalaswamy (preetham@eng.umd.edu)
	Prince Kohli (prince@cs.gatech.edu)
        Ravi Rai (rrai@isc.cs.ndsu.nodak.edu)
        Satish Subramanian (subraman@cs.umn.edu)

    And of course, none of this would have been possible without Avinash 
    Chopde (avinash@acm.org), the man who wrote ITRANS and started the ISB.

    Thanks are also due to the numerous others who have made ITRANS Songs 
    available through their Gopher, Mosaic, or FTP servers.  And of course, 
    the USENET newsgroup rec.music.indian.misc is where this all began...

    I am always looking for additional songs, in ITRANS transliterated
    form or otherwise. The transliteration map used by ITRANS is present 
    in the "TRANS.DOC" file. Send any ITRANS texts to me at the email 
    address anurag@chandra.astro.indiana.edu.  (If you will be doing any
    transliteration, note that you must stick to the new ITRANS song format.
    See the files docs/new_song_format for details.)
    
====================================

WHERE DO I GET THE ADDITIONAL PACKAGES REQUIRED TO RUN ISB 3.1?

    Using the ISB source fully (i.e. converting a *.s file to *.ps) requires
    several freeware packages.  The sources for of them are listed below.

    1) ITRANS 4.04, available at these sites:

       chandra.astro.indiana.edu:/pub/itrans-4/itrans40.tar.gz
			         /pub/itrans-4/itransps.tar.gz
			         /pub/itrans-4/itrans40.zip, itransps.zip

       read the README file at this site for further details.

       cs.duke.edu   dist/sources/itrans32.tar.Z and itransps.tar.Z
       ftp.stolaf.edu 
       niord.shsu.edu [FILESERV.ITRANS]:ITRANS32.ZIP and ITRANSPS.ZIP
       ftp.tex.ac.uk     pub/archive/languages/indian
       SIMTEL20 (or, oak.oakland.edu pub/msdos/tex) ITRANS32.ZIP

    Optional (but highly recommended) font requirement:

    2) Frans Velthuis's devnag (devanagari font). Metafont form.
       devnag.tar.Z, available at:

            chandra.astro.indiana.edu, in /pub/devnag/devnag.tar.gz
	    cs.duke.edu (128.109.140.1), in the directory "dist/sources"
	    rugrcx.rug.nl (129.125.4.12), in the directory "pub"
	    june.cs.washington.edu, in the directory "/tex"

    In addition, you need gs/ghostview and TeX/LaTeX (on Unix boxes).
    It is best to request your system administrator to install them if they
    are not already at your site.

    -----
    If you have ITRANS but do not have Frans Velthuis's font installed,
    you can still print out the songs in Devanagari using the font available
    with ITRANS.  Just edit the file isitx.hdr, and comment the lines that 
    refer to Frans's font, and uncomment the lines that refer to the Devnac 
    font.  (Details are present in the isitx.hdr file.) Then, run the makefile 
    to create the .itx and .ps files.

    If you have ITRANS but do not have TeX installed, it is still possible to
    print out the songs---but requires more work.  Instead of isitx.hdr, the 
    header file used is isips.hdr.  There are some commands in the .s files 
    that PostScript interpretors barf on, so these have to be edited. See the 
    file isips.hdr for more comments---but the comments are not sufficient, 
    it requires a lot of manual modifications to get everything working
    (so it is best to get the TeX interface working with Velthuis' font).

    Read the files docs/isb.FAQ for more info.

------------------------------------------------------------
Anurag Shankar
E-Mail Address:  anurag@chandra.astro.indiana.edu
