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