Documentation/ntweb/index.texi

   1 \input texinfo @c -*-texinfo-*-
   2 @setfilename index.info
   3 @settitle LilyPond Windows NT 4-0/95 Distribution
   4
   5 @chapter LilyPond Windows NT 4.0/95 Distribution
   6
   7 This page documents the NT port of LilyPond.  It reflects  the latest
   8 version of lilypond that was ported.
   9
  10 @section Introduction
  11
  12 This page is dedicated to the distribution of precompiled and
  13 preformatted LilyPond binaries for Windows NT 4.0 .  This package is
  14 covered under the GNU General Public License and all of the source is
  15 available on the official
  16 @uref{http://www.cs.ruu.nl/people/hanwen/lilypond/index.html,LilyPond
  17 Homepage}.  A full set of
  18 @uref{http://www.cs.ruu.nl/people/hanwen/lilypond/Documentation/tex/out-www/index.html,documentation}
  19 in various formats is also available.
  20
  21
  22     LilyPond is a music typesetter.  It produces beautiful sheet music
  23 using a high level description file as input.  LilyPond is part of
  24 the GNU Project.
  25
  26 @section News
  27
  28 @table @samp
  29  @item BUG FIXES
  30   @itemize @bullet
  31    @item
  32       @code{os.rename(this.__base + '.' + str(os.getpid()) + '.dvi', outfile)
  33         os.error: (2, 'No such file or directory')}
  34         This problem was reported by many and thoroughly debugged by
  35         Wolf Lother.  We have abandoned the use of @code{os.getpid()}, which
  36         for one reason or another resulted in negative numbers on
  37         windows 95, in favor of the tempfile module.  We have also
  38         attempted to use only one '.' in naming temporary files.
  39   @end itemize
  40 @end table
  41
  42 @table @samp
  43  @item NOTES
  44   @itemize @bullet
  45    @item  We have had preliminary reports that the Windows 95
  46         installation works on Windows 98.  Many thanks to Christian
  47         Mondrup.
  48
  49    @item  Please use the Add/Remove program control panel entry to
  50         unistall your current version of Lilypond before you attempt to
  51         install this one.
  52
  53    @item  If you are upgrading from a previous version of lilypond you will most
  54         likely need to flush your font cache.  I generally just toss
  55         @file{D:\localtexmf\fonts\tfm\public\ehrhardt} and
  56         @file{D:\localtexmf\fonts\pk\ljfour\public\ehrhardt} in the Recyle
  57         Bin. Your local font directory may be different, please refer to your
  58         local installation of @code{TeX}.
  59
  60    @item  The FAT16, FAT32, and NTFS file system problems have been
  61         corrected.  I have tested various installations that are known
  62         to be operational.
  63   @end itemize
  64 @end table
  65
  66 The installer was created with
  67 @uref{http://www.gentee.com/,CreateInstall}.  This is a shareware
  68 application that has capabilities close to the high dollar installers
  69 @strong{InstallShield}, @strong{Install Vise}, and @strong{WiseInstaller}.
  70 @strong{CreateInstall} does cost $38 to register which is probably going to
  71 be frowned upon, but I was unable to find a freeware install builder
  72 that was suitable.  The self extracting distribution currently:
  73
  74 @itemize @bullet
  75  @item  Installs the lilypond distribution on any valid file system.
  76  @item  Optionally creates a @emph{Lilypond} shortcut group on your start
  77       menu with the following shortcuts.
  78   @itemize @bullet
  79    @item  @strong{lilyshell}
  80    @item  @strong{uninstall}
  81   @end itemize
  82  @item  Allows unistall through the Add/Remove Program interface on the
  83       control panel.
  84  @item  The @strong{lilyshell} uses the /E and /K switches to extend the
  85       environment size and initialize the shell environment.
  86  @item  It has the look and feel of a real Windows installer
  87 @end itemize
  88
  89 The @strong{lilyshell} shortcut initializes the environment so you can
  90 generate music from a MSDOS prompt with commands like:
  91
  92 @itemize @bullet
  93     @item ly2dvi
  94     @item convert-mudela
  95     @item mudela-book
  96     @item lilypond
  97     @item midi2ly
  98 @end itemize
  99
 100 This release has been tested on Windows NT 4.0sp3 and Windows 95 and
 101 found to be operational.  If you have any troubles and or comments
 102 please do not hesitate to drop me a line
 103 @uref{mailto:daboys@@austin.rr.com,Jeffrey B. Reed}.
 104
 105 @section Bugs
 106
 107 @itemize @bullet
 108
 109   @item  Using any text that contains '@{@}' for the value of the any
 110        valid mudela @strong{header} construct will cause @strong{ly2dvi} to
 111        fail.  A work around for the @strong{latexheaders} construct is to
 112        create a @strong{TeX} file and set @strong{latexheaders} to "\input
 113        foo.tex".
 114 @end itemize
 115
 116 @section Required Packages
 117
 118 LilyPond uses the @code{TeX} package as its rendering engine. @code{TeX}
 119 represents the state-of-the-art in computer typesetting. It is used to
 120 generate documentation, article, and book quality output. It is an
 121 assume tool to have in your toolbox.
 122
 123 LilyPond uses a @code{Python} script named @code{ly2dvi} to render a
 124 professional quality music score. @code{Python} is an interpreted,
 125 interactive, object-oriented programming language.  It is often
 126 compared to @code{Tcl}, @code{Perl}, @code{Scheme} or @code{Java}.
 127
 128 Gsview is used to display and print the music scores created by
 129 LilyPond.
 130
 131 @itemize @bullet
 132     @item
 133         @uref{http://www.snafu.de/~cschenk/miktex/,MiKTeX}. Versions
 134         1.10b, 1.11, and 1.20b are known to work.
 135     @item
 136         @uref{http://www.python.org,Python}. Version 1.5.1 and
 137         possibly 1.5 work.
 138     @item
 139         @uref{http://www.cs.wisc.edu/~ghost/gsview/index.html,gsview}.
 140         Version 5.10 is known to work.
 141 @end itemize
 142
 143 @section Download
 144
 145 @itemize @bullet
 146     @item Windows 95
 147         @uref{lilypond-TOPLEVEL_VERSION-95.exe,lilypond-TOPLEVEL_VERSION-95}
 148     @item Windows NT 4.0
 149         @uref{lilypond-TOPLEVEL_VERSION-nt.exe,lilypond-TOPLEVEL_VERSION-nt}
 150 @end itemize
 151
 152 @section Installation
 153
 154 @itemize @bullet
 155  the distribution.
 156   @item run downloaded executable.
 157   @item  The first installation of LilyPond also requires these
 158         additional steps:
 159      @table @samp
 160        @item LaTeX geometry package
 161        @itemize @bullet
 162          @item
 163           @uref{ftp://ctan.tug.org/tex-archive/macros/latex/contrib/supported/geometry.zip,download} the zip file to @code{\Temp}.
 164          @item Extract the zip file into the LaTeX package area of
 165              @code{MiKTeX}. This will be @strong{@emph{MiKTeX-dir}\tex\latex}
 166          @item From a Command Prompt change directory into geometry
 167              directory that was just extracted.
 168          @item In the geometry directory type @strong{latex geometry.ins}
 169        @end itemize
 170        @item Miscellaneous fonts
 171        @itemize @bullet
 172          @item In your favorite editor create a file named
 173              @code{cmbx14.mf}. Add the following lines:
 174              @strong{design_size=14.4; }
 175              @strong{input b-cmbx;}
 176          @item From a Command Prompt copy cmbx14.mf to the public font
 177              area of MiKTeX:
 178              @strong{copy cmbx14.mf @emph{MiKTeX-dir}\fonts\source\public\cm\base}
 179         @end itemize
 180         @item NOTE
 181         MiKTeX-1.11 localtexmf configurations should use
 182         @strong{@emph{localtexmf-dir}} in place of @strong{@emph{MiKTeX-dir}}.
 183       @end table
 184  instructions below
 185 @end itemize
 186
 187 @section Running LilyPond
 188
 189 @itemize @bullet
 190   @item Take a look at @uref{angels.ly,angels.ly}
 191   @item Save angels.ly to your local disk
 192   @item Select the @strong{lilyshell} shortcut from the @emph{Lilypond} group
 193   @item  From a LilyPond Command Prompt run:
 194   @strong{ly2dvi angels.ly}
 195   @strong{dvips angels.dvi}
 196   @strong{start angels.ps}
 197 @end itemize
 198
 199 @section LilyPond Resources
 200
 201 @itemize @bullet
 202   @item
 203         @uref{http://www.cs.ruu.nl/people/hanwen/lilypond/index.html,LilyPond Homepage}
 204   @item
 205         @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/,LilyPond Ftp Site}
 206   @item
 207         @uref{http://jab.org/mail/gnu-music-discuss@@gnu.org/,gnu-music-discuss mail archive}
 208   @item Please feel free to mail us at @uref{mailto:gnu-music-discuss@@gnu.org,gnu-music-discuss}
 209 @end itemize
 210
 211
 212
 213
 214 @bye