README

   1                          Anjuta Version 2.0.0 Alpha Release
   2
   3                        Copyright (C) 2000-2005 Naba Kumar
   4                        Home site => http://anjuta.org/
   5
   6 Introduction:
   7 -------------
   8
   9 Anjuta DevStudio is a versatile Integrated Development Environment (IDE)
  10 on GNOME Desktop Environment and features a number of advanced
  11 programming facilities. These include project management, application and
  12 class wizards, an on-board interactive debugger, powerful source editor,
  13 syntax highlighting, intellisense autocompletions, symbol navigation,
  14 version controls, integrated GUI designing and other tools.
  15
  16 Anjuta is an effort to marry the flexibility and power of text-based
  17 command-line tools with the ease-of-use of the GNOME graphical user
  18 interface. We thrive to make it very usable by eleminating developers
  19 burden with mudane programming tasks.
  20
  21 Anjuta 2.x is the next generation Anjuta development studio with extensible
  22 plugin architecture. The new architecture allows writing independent
  23 plugins that could interact with existing plugins. Most of the older
  24 features have been already ported to the new architecture and are working.
  25
  26 The new architecture has:
  27
  28     * Complex docking shell that allows arbitrary docking of IDE widgets.
  29     * Dynamic plugin activation and deactivation.
  30     * Extensible architecture.
  31     * Plugins can interact with other plugins through interface.
  32     * Plugins can install dynamic UIs (menus/toolbars), including installing
  33           context menus in other plugins.
  34
  35 At present, Anjuta is only a beta release and lots of work needs to be done to
  36 improve it. In the future, Anjuta is going to be much more capable and stable!
  37 Extensive debugging has not yet been performed, so at the moment it will
  38 undoubtedly have lots of bugs. It would be great if you use it and report any
  39 problems to us. That way, you will be helping to improve the software as well
  40 as helping the Open Source community. Please read the file COPYRIGHT for
  41 details.
  42
  43 Any sort of suggestions or patches for Anjuta are also most welcome.
  44
  45 Presently available features in Anjuta:
  46 ---------------------------------------
  47
  48         1. Fully customizable integrated editor.
  49                 o Automatic syntax highlighting.
  50                 o Automatic code formatting.
  51                 o Code folding/hiding.
  52                 o Line numbers/markers display.
  53                 o Text zooming.
  54                 o Code autocompletion.
  55                 o Calltips for Linux/GNOME function prototypes.
  56                 o Automatic indentation and indentation guides.
  57                 o ... and much more.
  58
  59         2. Each file opened can be operated in either paged mode
  60         or windowed mode.
  61
  62         3. Highly interactive source level debugger (built over gdb).
  63                 o Interactive execution.
  64                 o Breakpoints/watches/signal/stack manipulation.
  65                 o Local Variables view.
  66                 o Variables tips.
  67                 o ... and much more.
  68
  69         4. Inbuilt application wizards to create terminal/GTK/GNOME
  70         applications on-the-fly.
  71
  72         5. Dynamic Tags browsing.
  73                 o Function definition, structure, classes etc.
  74                 o Full tags management for project.
  75                 o Symbol Browser.
  76                 o File Brwoser.
  77
  78         6. Full project and build files management.
  79
  80         6. Bookmark management.
  81
  82         7. Basic windows are attachable and detachable.
  83
  84         9. Support for other languages
  85                 o Java, Perl, Pascal ... etc. (only file mode, no project
  86                 managements).
  87
  88         10. Interactive messaging system.
  89
  90         11. GNOME2 platform compliant.
  91
  92 Contact Email addresses for Anjuta:
  93 -----------------------------------
  94
  95 Anjuta Home site:       http://anjuta.org.
  96 Anjuta Project site:    http://www.sourceforge.net/projects/anjuta
  97
  98 For general discussions and queries use the discussion forums (two forums)
  99 at the project site. Please report bugs at the projects bug tracking system
 100 or the mailing lists at the project site. News of Anjuta is also available
 101 at the project site.
 102
 103 To subscribe to one or more of the mailing lists, visit
 104 [ http://www.sourceforge.net/mail/?group_id=14222 ].
 105 or send a mail at <listname>-request@lists.sourceforge.net with a subject
 106 just "subscribe". Where, <listname> is anjuta-list or anjuta-devel.
 107
 108 Mailing lists:
 109         o anjuta-list@lists.anjuta.sourceforge.net
 110                 For general discussion.
 111
 112         o anjuta-devel@lists.anjuta.sourceforge.net
 113                 For development discussion.
 114
 115         o anjuta-announce@lists.anjuta.sourceforge.net
 116                 For announcements of new releases.
 117
 118 -------------
 119 REQUIREMENTS:
 120 -------------
 121
 122 1) Installation from tarball:
 123         * GTK libs (2.0 or later)
 124         * GNOME libs (2.0 or later)
 125         * gnome-xml (aka libxml1) (1.4.0 or later)
 126         * gnome-print
 127         * gdk-pixbuf
 128         * scrollkeeper
 129         * pkgconfig
 130         * gnome-build (the latest release)
 131         * gdl (the latest release)
 132
 133         Optional:
 134         * devhelp (0.13 or later): for integrated API help
 135         * glade3 (3.1.5 or later): for integrated UI designing
 136         * libsvn: (www.subversion.org) to build subversion plugin
 137         * graphviz: for class hierarchy view and profiler.
 138
 139 2) Installation from repository:
 140         * All the requirements for tarball
 141         * GNU gettext 0.10.x (or later)
 142         * Automake 1.4 (or later)
 143         * Autoconf 2.13 (or later)
 144
 145 3) Running
 146         * X-Windows, any window manager should do as long as the gnome libs
 147           are installed)
 148         * Bash command shell
 149         * GNU Indent
 150         * yelp to browse docs
 151         * Automake/Autoconf
 152         * GNU Make
 153         * GNU C/C++ compiler
 154         * GNU debugger (gdb)
 155         * GNU grep
 156         * For cvs plugin: cvs
 157
 158 INSTALLATION:
 159 -------------
 160
 161 Note:- The package as an example is taken as anjuta-1.0.tar.gz
 162 and '#' is the shell prompt. You must be logged in as root to
 163 install Anjuta.
 164
 165         1) Get the tarball
 166         2) copy it to your home dir.
 167         3) tar xfzv anjuta-<version>.tar.gz
 168         4) Change dir:   # cd anjuta-<version>
 169         5) Type:  # ./configure
 170         6) Type:  # make
 171         7) Type:  # make install
 172
 173 That's all. If everything went smoothly, congratulations. If not,
 174 then please check that you have the latest libgnome and libgnomeui
 175 installed. Get them if you don't have and repeat the above steps.
 176
 177
 178 KNOWN ISSUES:
 179 -------------
 180         * Calltips flicker when the cursor touches them if you have your window
 181         manager set to follow-mouse-cursor for focus. Change it to focus-follow
 182         mouse click to fix it.
 183
 184 RUNNING:
 185 --------
 186
 187 To run Anjuta, choose Applications->Programming->Anjuta IDE from the GNOME
 188 Main Menu, or type:   # anjuta
 189
 190 If you get the shell error 'Command not found', then make sure your PATH
 191 variable contains the executable path of Anjuta binary (by default:
 192 /usr/local/bin). Usually, the PATH variable is set in the file
 193 /etc/profile. Check it out.
 194
 195 Usage: anjuta [--no-splash | -s] [ files ...] [ project ]
 196
 197 If you do not want to see the Anjuta splash screen / logo, run Anjuta with
 198 the command-line option "--no-splash". See the User Manual for further
 199 instructions.
 200
 201
 202 ** Good Luck **