~ubuntu-branches/ubuntu/karmic/gnustep-base/karmic

« back to all changes in this revision

Viewing changes to debian/README.Debian

  • Committer: Bazaar Package Importer
  • Author(s): Eric Heintzmann
  • Date: 2005-04-17 00:14:38 UTC
  • mfrom: (1.2.1 upstream) (2.1.2 hoary)
  • Revision ID: james.westby@ubuntu.com-20050417001438-enf0y07c9tku85z1
Tags: 1.10.3-1
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
6
6
 
7
7
GNUstep is a free implementation of the OpenStep specification by NeXT.
8
8
OpenStep is the foundation of Apple's new Mac OS X GUI API.
 
9
The full OpenStep specification can be found at :
 
10
 
 
11
  http://www.gnustep.org/resources/OpenStepSpec/OpenStepSpec.html
9
12
 
10
13
 
11
14
Debian specific
12
15
---------------
13
16
 
14
17
GNUstep has its own directory layout concept. The Debian GNUstep packages
15
 
are set up to populate a tree /usr/lib/GNUstep. The exact layout is described
16
 
in /usr/share/doc/gnustep-make/DESIGN.gz.
17
 
Documentation is in /usr/share/doc/GNUstep.
18
 
 
19
 
GNUstep currently supports two display engines for X11: X/DPS and X/GPS.
20
 
Since there's no free Display PostScript for Debian, the Debian packages
21
 
currently only include the X/GPS backend. X/GPS works via a DPS emulation
22
 
engine to use Xlib calls to emulate the DPS functions required by the
23
 
front-end system.
 
18
are set up to populate a tree /usr/lib/GNUstep. Debian's layout for
 
19
System, Local and Network is:
 
20
 
 
21
        GNUSTEP_SYSTEM_ROOT     /usr/lib/GNUstep/System
 
22
        GNUSTEP_LOCAL_ROOT      /usr/local/lib/GNUstep/Local
 
23
        GNUSTEP_NETWORK_ROOT    /usr/local/lib/GNUstep/Network
 
24
 
 
25
The exact layout is described in /usr/share/doc/gnustep-make/DESIGN.gz.
 
26
See also the GNUstep Filesystem Hierarchy Document available at :
 
27
 
 
28
  http://www.gnustep.org/resources/documentation/filesystem.ps
 
29
 
24
30
 
25
31
To run GNUstep applications or to develop for GNUstep using the GNUstep
26
32
Makefiles package, you'll have to set up the environment first. This can
27
33
be done by sourcing /usr/lib/GNUstep/System/Makefiles/GNUstep.sh (resp.
28
34
GNUstep.csh):
29
35
 
30
 
  source /usr/lib/GNUstep/System/Makefiles/GNUstep.sh (bash users etc.)
31
 
  source /usr/lib/GNUstep/System/Makefiles/GNUstep.csh (tcsh users etc.)
 
36
 . /usr/lib/GNUstep/System/Library/Makefiles/GNUstep.sh       (bash users etc.)
 
37
 source /usr/lib/GNUstep/System/Library/Makefiles/GNUstep.csh (tcsh users etc.)
32
38
 
33
39
If you're going to run GNUstep applications regularly, you certainly
34
40
want to put this in your .bashrc or something.
37
43
Examples
38
44
--------
39
45
 
40
 
Install gstep-xraw-examples to view some basic test applications:
41
 
 
42
 
  openapp Edit.app
43
 
 
44
 
You find the examples in /usr/lib/GNUstep/System/Apps
 
46
Install gnustep-examples to view some basic test applications :
 
47
 
 
48
    openapp Ink.app
 
49
 
 
50
You find the examples in /usr/lib/GNUstep/System/Applications
45
51
 
46
52
 
47
53
Name server for GNUstep Distributed Objects
48
54
-------------------------------------------
49
55
 
50
56
The name server (gdomap) can use several methods for finding other servers.
51
 
The Debian default setup disables the broadcast to to the local networks
 
57
The Debian default setup disables the broadcast to the local networks
52
58
with the option -p. To change the setup, you can edit /etc/init.d/gdomap
53
59
 
54
60
* Reenable the broadcast by removing the -p option.
56
62
* Delimit the broadcast to specific hosts by replacing the -p option
57
63
  with -c /etc/GNUstep/gdomap_probes (probe specific hosts).
58
64
 
59
 
You can get more information calling `gdomap -H' and `gdomap -C'.
 
65
You can get more information calling `man gdomap', `gdomap -H' and `gdomap -C'.
 
66
 
 
67
 
 
68
GNUstep Distributed Notification Center
 
69
---------------------------------------
 
70
 
 
71
Every user needs to have his own instance of gdnc running.  While  gdnc
 
72
will  be started automatically as soon as it is needed, it is recommended
 
73
to start gdnc in a personal login script like  ~/.bashrc  or  ~/.cshrc.
 
74
 
 
75
You can get more information calling `man gdnc'.
 
76
 
 
77
 
 
78
GNUstep PasteBoard Server
 
79
-------------------------
 
80
 
 
81
Every user needs to have his own instance of gpbs running.
 
82
While  gpbs  will  be started automatically as soon as it is needed, 
 
83
it is recommended to start gpbs when your windowing system 
 
84
or the window manager is started. For example, on systems with X11 
 
85
you can launch gpbs from your .xinitrc script or 
 
86
alternatively - if you are running Window Maker - put  it  in  
 
87
Window  Maker's autostart  script.
 
88
 
 
89
You can get more information calling `man gpbs'.
60
90
 
61
91
 
62
92
Resources
66
96
 
67
97
  http://www.gnustep.org/
68
98
 
69
 
There's a nice unofficial site by Michael Hanni and Avi Bercovich:
70
 
 
71
 
        http://gnustep.current.nu/
72
 
 
73
 
There's also a news group gnu.gnustep.discuss, which is gatewayed to the
74
 
mailing list discuss-gnustep@gnu.org. To subscribe, send a mail to
75
 
discuss-gnustep-request@gnu.org.
 
99
 
 
100
The GNUstep Community Website :
 
101
 
 
102
  http://www.gnustep.net/
 
103
 
 
104
 
 
105
The GNUstep Wiki Website :
 
106
 
 
107
  http://wiki.gnustep.org
 
108
 
 
109
 
 
110
There's also several GNUstep newsgroups and mailing lists :
 
111
 
 
112
  http://www.gnustep.org/information/gethelp.html
 
113
 
76
114
 
77
115
On a regular basis snapshots of the sources are made and placed online at:
78
116
 
79
 
        ftp://alpha.gnu.org/gnu/gnustep/snap
 
117
  ftp://ftp.gnustep.org/pub/daily-snapshots/
 
118
 
80
119
 
81
120
The source repository of the GNUstep project is available via anonymous CVS.
82
 
For instructions, have a look at the GNUstep-HOWTO. For a first start,
83
 
 
84
 
  CVSROOT=":pserver:anoncvs@cvs.net-community.com:/gnustep"
85
 
  cvs login                            (password "anoncvs")
86
 
  cvs -z 3 checkout core
87
 
 
88
 
For updating the repository, use
89
 
 
90
 
  cvs -z 3 update
 
121
For instructions, have a look at the GNUstep-HOWTO.
 
122
For a first start, look at :
 
123
 
 
124
  http://savannah.gnu.org/cvs/?group=gnustep
91
125
 
92
126
 
93
127
    11/09/98
94
128
    Gregor Hoffleit <flight@debian.org>
95
129
    05/08/99
96
130
    Matthias Klose <doko@debian.org>
 
131
    04/04/03
 
132
    Eric Heintzmann <debian@gnustep.fr.st>
 
133
    24/09/03
 
134
    Eric Heintzmann <eric@gnustep.fr.st>