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