README 6.24 KB
Newer Older
1
                         Anjuta Version 2.0.0 Alpha Release
Stéphane Démurget's avatar
Stéphane Démurget committed
2

Johannes Schmid's avatar
Johannes Schmid committed
3
                       Copyright (C) 2000-2005 Naba Kumar
4
                       Home site => http://anjuta.org/
Stéphane Démurget's avatar
Stéphane Démurget committed
5 6 7 8

Introduction:
-------------

9 10 11 12 13 14
Anjuta DevStudio is a versatile Integrated Development Environment (IDE)
on GNOME Desktop Environment and features a number of advanced
programming facilities. These include project management, application and
class wizards, an on-board interactive debugger, powerful source editor,
syntax highlighting, intellisense autocompletions, symbol navigation,
version controls, integrated GUI designing and other tools.
Stéphane Démurget's avatar
Stéphane Démurget committed
15

Naba Kumar's avatar
Naba Kumar committed
16 17
Anjuta is an effort to marry the flexibility and power of text-based 
command-line tools with the ease-of-use of the GNOME graphical user 
18 19
interface. We thrive to make it very usable by eleminating developers
burden with mudane programming tasks.
Stéphane Démurget's avatar
Stéphane Démurget committed
20

21
Anjuta 2.x is the next generation Anjuta development studio with extensible
22
plugin architecture. The new architecture allows writing independent
23 24 25 26 27 28 29 30 31 32 33 34
plugins that could interact with existing plugins. Most of the older
features have been already ported to the new architecture and are working.

The new architecture has:

    * Complex docking shell that allows arbitrary docking of IDE widgets.
    * Dynamic plugin activation and deactivation.
    * Extensible architecture.
    * Plugins can interact with other plugins through interface.
    * Plugins can install dynamic UIs (menus/toolbars), including installing
	  context menus in other plugins.

Naba Kumar's avatar
Naba Kumar committed
35 36 37 38 39
At present, Anjuta is only a beta release and lots of work needs to be done to 
improve it. In the future, Anjuta is going to be much more capable and stable! 
Extensive debugging has not yet been performed, so at the moment it will 
undoubtedly have lots of bugs. It would be great if you use it and report any 
problems to us. That way, you will be helping to improve the software as well 
40 41
as helping the Open Source community. Please read the file COPYRIGHT for
details. 
Stéphane Démurget's avatar
Stéphane Démurget committed
42

43
Any sort of suggestions or patches for Anjuta are also most welcome. 
Stéphane Démurget's avatar
Stéphane Démurget committed
44 45 46 47

Presently available features in Anjuta:
---------------------------------------

48
	1. Fully customizable integrated editor.
Andy Piper's avatar
Andy Piper committed
49
		o Automatic syntax highlighting.
50
		o Automatic code formatting.
Stéphane Démurget's avatar
Stéphane Démurget committed
51
		o Code folding/hiding.
52 53
		o Line numbers/markers display.
		o Text zooming.
Andy Piper's avatar
Andy Piper committed
54
		o Code autocompletion.
55
		o Calltips for Linux/GNOME function prototypes.
Andy Piper's avatar
Andy Piper committed
56
		o Automatic indentation and indentation guides.
Stéphane Démurget's avatar
Stéphane Démurget committed
57 58
		o ... and much more.
	
59 60
	2. Each file opened can be operated in either paged mode
	or windowed mode. 
Stéphane Démurget's avatar
Stéphane Démurget committed
61
	
Naba Kumar's avatar
Naba Kumar committed
62
	3. Highly interactive source level debugger (built over gdb).
Stéphane Démurget's avatar
Stéphane Démurget committed
63
		o Interactive execution.
64
		o Breakpoints/watches/signal/stack manipulation.
65 66
		o Local Variables view.
		o Variables tips.
Stéphane Démurget's avatar
Stéphane Démurget committed
67 68
		o ... and much more.
	
69 70
	4. Inbuilt application wizards to create terminal/GTK/GNOME
	applications on-the-fly. 
Stéphane Démurget's avatar
Stéphane Démurget committed
71 72
	
	5. Dynamic Tags browsing.
73
		o Function definition, structure, classes etc.
Stéphane Démurget's avatar
Stéphane Démurget committed
74
		o Full tags management for project.
75 76
		o Symbol Browser.
		o File Brwoser.
Stéphane Démurget's avatar
Stéphane Démurget committed
77
	
78
	6. Full project and build files management. 
Stéphane Démurget's avatar
Stéphane Démurget committed
79
	
80
	6. Bookmark management.
Stéphane Démurget's avatar
Stéphane Démurget committed
81 82 83 84
	
	7. Basic windows are attachable and detachable.

	9. Support for other languages 
85 86
		o Java, Perl, Pascal ... etc. (only file mode, no project
		managements).
Stéphane Démurget's avatar
Stéphane Démurget committed
87 88 89

	10. Interactive messaging system.

90
	11. GNOME2 platform compliant.
Stéphane Démurget's avatar
Stéphane Démurget committed
91 92
	
Contact Email addresses for Anjuta:
Andy Piper's avatar
Andy Piper committed
93
-----------------------------------
Stéphane Démurget's avatar
Stéphane Démurget committed
94

95
Anjuta Home site:	http://anjuta.org.
Stéphane Démurget's avatar
Stéphane Démurget committed
96

97
For general discussions and queries use the discussion forums (two forums) 
98 99
at the project site. Please report bugs at the projects bug tracking system
or the mailing lists at the project site. News of Anjuta is also available
100
at the project site.
Stéphane Démurget's avatar
Stéphane Démurget committed
101

102
To subscribe to one or more of the mailing lists, visit 
103 104 105
[http://mail.gnome.org/mailman/listinfo/anjuta-devel-list].
or send a mail at <listname>-request@gnome.org with a subject 
just "subscribe". Where, <listname> is anjuta-list or anjuta-devel-list.
Stéphane Démurget's avatar
Stéphane Démurget committed
106 107

Mailing lists:
108
	o anjuta-list@gnome.org
Stéphane Démurget's avatar
Stéphane Démurget committed
109 110
		For general discussion.
	
111
	o anjuta-devel-list@gnome.org
112
		For development discussion.
Stéphane Démurget's avatar
Stéphane Démurget committed
113

114
-------------
Stéphane Démurget's avatar
Stéphane Démurget committed
115 116 117
REQUIREMENTS:
-------------

118
1) Installation from tarball:
Johannes Schmid's avatar
Johannes Schmid committed
119 120
	* GTK libs (2.0 or later)
	* GNOME libs (2.0 or later)
121
	* gnome-xml (aka libxml1) (1.4.0 or later)
Johannes Schmid's avatar
Johannes Schmid committed
122
	* gnome-print
123
	* gdk-pixbuf
Johannes Schmid's avatar
Johannes Schmid committed
124
	* scrollkeeper
125
	* pkgconfig
126 127
	* gnome-build (the latest release)
	* gdl (the latest release)
Johannes Schmid's avatar
Johannes Schmid committed
128 129

	Optional:
130 131 132 133
	* devhelp (0.13 or later): for integrated API help
	* glade3 (3.1.5 or later): for integrated UI designing
	* libsvn: (www.subversion.org) to build subversion plugin
	* graphviz: for class hierarchy view and profiler.
134

135
2) Installation from repository:
136 137 138 139 140
	* All the requirements for tarball
	* GNU gettext 0.10.x (or later)
	* Automake 1.4 (or later)
	* Autoconf 2.13 (or later)

141 142 143
3) Running
	* X-Windows, any window manager should do as long as the gnome libs
	  are installed)
Stéphane Démurget's avatar
Stéphane Démurget committed
144
	* Bash command shell
145
	* GNU Indent
Johannes Schmid's avatar
Johannes Schmid committed
146
	* yelp to browse docs
147 148 149
	* Automake/Autoconf
	* GNU Make
	* GNU C/C++ compiler
150
	* GNU debugger (gdb)
151
	* GNU grep
Johannes Schmid's avatar
Johannes Schmid committed
152
	* For cvs plugin: cvs
Naba Kumar's avatar
Naba Kumar committed
153

Stéphane Démurget's avatar
Stéphane Démurget committed
154 155 156
INSTALLATION:
-------------

157 158 159
Note:- The package as an example is taken as anjuta-1.0.tar.gz
and '#' is the shell prompt. You must be logged in as root to
install Anjuta.
Stéphane Démurget's avatar
Stéphane Démurget committed
160

Johannes Schmid's avatar
Johannes Schmid committed
161
	1) Get the tarball
Stéphane Démurget's avatar
Stéphane Démurget committed
162
	2) copy it to your home dir.
Johannes Schmid's avatar
Johannes Schmid committed
163 164 165 166 167
	3) tar xfzv anjuta-<version>.tar.gz
	4) Change dir:   # cd anjuta-<version>
	5) Type:  # ./configure
	6) Type:  # make
	7) Type:  # make install
168

169 170 171
That's all. If everything went smoothly, congratulations. If not,
then please check that you have the latest libgnome and libgnomeui
installed. Get them if you don't have and repeat the above steps.
Stéphane Démurget's avatar
Stéphane Démurget committed
172

Naba Kumar's avatar
Naba Kumar committed
173

174 175 176 177 178 179
KNOWN ISSUES:
-------------
	* Calltips flicker when the cursor touches them if you have your window
	manager set to follow-mouse-cursor for focus. Change it to focus-follow
	mouse click to fix it.
	
Naba Kumar's avatar
Naba Kumar committed
180 181 182
RUNNING:
--------

183 184
To run Anjuta, choose Applications->Programming->Anjuta IDE from the GNOME
Main Menu, or type:   # anjuta
Naba Kumar's avatar
Naba Kumar committed
185 186

If you get the shell error 'Command not found', then make sure your PATH
187 188 189
variable contains the executable path of Anjuta binary (by default:
/usr/local/bin). Usually, the PATH variable is set in the file
/etc/profile. Check it out.
Naba Kumar's avatar
Naba Kumar committed
190

191
Usage: anjuta [--no-splash | -s] [ files ...] [ project ]
Naba Kumar's avatar
Naba Kumar committed
192

193 194 195
If you do not want to see the Anjuta splash screen / logo, run Anjuta with 
the command-line option "--no-splash". See the User Manual for further
instructions.
Naba Kumar's avatar
Naba Kumar committed
196

Stéphane Démurget's avatar
Stéphane Démurget committed
197 198

** Good Luck **