1@c -*- texinfo -*-
2@chapter Installation
3@node Top, Introduction, (dir), (dir)
4@include version.texi
5
6
7@menu
8* Introduction::
9* Configuration::
10* Compilation::
11* Installing::
12* Post-Installation::
13@end menu
14
15@node Introduction, Configuration, Top, Top
16@section Introduction
17
18This file documents the installation of the GNUstep GUI Library,
19@samp{gnustep-gui}. If you are installing this package as part of the
20GNUstep core package, read the file GNUstep-HOWTO for more complete
21instructions on how to install the entire GNUstep package (including
22this library).  GNUstep-HOWTO is located at @url{http://www.gnustep.org}
23and in the gnustep-make package (which you should install first).
24
25You must have installed gnustep-base and gnustep-make
26before building this library. GNUstep Make version 2.0.0 or greater is
27required. GNUstep Base version 1.15.0 or greater is required.
28
29Other external libraries that you should have installed include:
30
31@itemize
32@item tiff (REQUIRED)
33@item jpeg (RECOMMENDED)
34@item png (RECOMMENDED)
35@item gif or ungif (OPTIONAL)
36@item aspell (OPTIONAL)
37@item cups (OPTIONAL)
38@item audiofile (OPTIONAL)
39@item portaudio, v19 which has several API changes previous version (OPTIONAL)
40@end itemize
41
42Read the GNUstep-HOWTO for more information.  After installing this
43library, install gnustep-back.
44
45@node Configuration, Compilation, Introduction, Top
46@section Configuration
47
48Configuration is performed by running the @file{configure} program at a
49shell prompt. You may want to use some of the optional arguments to the
50@file{configure} program. Type @code{configure --help} for a list. GNUstep
51specific options are at the end of this list (if any).
52
53@node Compilation, Installing, Configuration, Top
54@section Compilation
55
56To compile this library, type make. After this is complete, type make
57install (make sure you are the root user). Some additional options you
58can use with make are @samp{debug=yes} to make a debugging version of
59the library and @samp{shared=no} to make a static version of the
60library. See the gstep-make package for more information on these options.
61
62@node Installing, Post-Installation, Compilation, Top
63@section Installing
64
65To install, type
66
67@example
68make install
69@end example
70
71@node Post-Installation,  , Installing, Top
72@section Post Installation
73
74GNUstep gui comes with a tool called @samp{make_services} which builds
75a list of installed applications and services. This list is used to find
76services for the services menu, for instance. This tool should be run
77after a new service or application is installed in the system. Theoretically,
78a workspace application, such as GWorkspace, should do this automatically.
79But this is not done at the current time. You might consider running this
80service automatically, perhaps in a login script, to make sure the service
81and application lists are updated regularly.
82
83@bye
84