Update Catalan translation (#1375)
[geany-mirror.git] / README
blob52003a64a4e94fde5a4aabc5abe1f4f70d784b00
1 Geany - A fast and lightweight IDE
2 ----------------------------------
5 About
6 -----
7 Geany is a small and lightweight integrated development environment.
8 It was developed to provide a small and fast IDE, which has only a
9 few dependencies from other packages. Another goal was to be as independent
10 as possible from a special Desktop Environment like KDE or GNOME. So it
11 is using only the GTK+ toolkit and therefore you need only the
12 GTK+ runtime libraries to run Geany.
15 Features
16 --------
17 The basic features of Geany are:
19 - syntax highlighting
20 - code completion
21 - auto completion of often used constructs like if, for and while
22 - auto completion of XML and HTML tags
23 - call tips
24 - folding
25 - many supported filetypes like C, Java, PHP, HTML, Python, Perl, Pascal
26 - symbol lists
27 - embedded terminal emulation
28 - extensibility through plugins
31 Installation from distribution packages
32 ---------------------------------------
33 Using distribution packages on Linux, BSD and similar distributions
34 is the easiest and recommended way. This way you will also benefit
35 from automatic Geany updates by the package manager of the distribution.
37 Packages are available for most distributions including Debian, Fedora, Ubuntu
38 and many more.
41 Installation on Mac OS and Windows
42 ----------------------------------
43 Prebuilt binary packages for Mac OS and Windows can be found on
44 http://www.geany.org.
47 Installation from sources
48 -------------------------
50 Requirements
51 ++++++++++++
52 For compiling Geany yourself, you will need the GTK2 (>= 2.24) or
53 GTK3 libraries and header files. You will also need its dependency libraries
54 and header files, such as Pango, Glib and ATK. All these files are
55 available at http://www.gtk.org.
57 Furthermore you need, of course, a C compiler and the Make tool; a C++
58 compiler is also needed for the required Scintilla library included. The
59 GNU versions of these tools are recommended.
62 To build the user manual you need *rst2html* from Docutils. A pre-built
63 version of the manual is available in distribution tarballs and will be used as
64 fallback if *rst2html* is missing. When building from Git however, that
65 pre-built version is not included and *rst2html* is required by default.
66 You can explicitly disable building the user manual using the
67 ``--disable-html-docs`` *configure* flag, but this will result in not
68 installing a local version of the user manual, and Geany will then try
69 and open the online version instead when requested.
72 .. note::
73     Building Geany from source on Mac OS and Windows is more complicated
74     and is out of scope of this document. For more information on
75     building instructions for these platforms, please check the wiki
76     at http://wiki.geany.org/howtos/.
78 Installing from a Git clone
79 +++++++++++++++++++++++++++
81 Install Autotools (*automake*, *autoconf* and *libtool*), *intltool*,
82 and the GLib development files **before** running any of the following
83 commands, as well as *rst2html* from Docutils (see above for details).
84 Then, run ``./autogen.sh`` and then follow the instructions for
85 `installing from a release tarball`_.
87 Installing from a release tarball
88 +++++++++++++++++++++++++++++++++
90 Run the the following three commands::
92     $ ./configure
93     $ make
94     (as root, or using sudo)
95     % make install
97 For more configuration details run ``./configure --help``.
99 If there are any errors during compilation, check your build environment
100 and try to find the error, otherwise contact the mailing list or one of
101 the authors.
103 See the manual for details (geany.txt/geany.html).
106 Usage
107 -----
108 To run Geany just type::
110     $ geany
112 on a console or use the applications menu from your desktop environment.
113 There a few command line options. See the manual page of Geany or run::
115     $ geany --help
117 for details. Or look into the documentation in the *doc/* directory.
118 The most important option probably is ``-c`` or ``--config``, where you can
119 specify an alternate configuration directory.
122 License
123 -------
124 Geany is distributed under the terms of the GNU General Public License
125 as published by the Free Software Foundation; either version 2 of the
126 License, or (at your option) any later version.  A copy of this license
127 can be found in the file COPYING included with the source code of this
128 program.
129 The included Scintilla library (found in the subdirectory scintilla/)
130 has its own license, which can be found in the file scintilla/License.txt
131 included with the source code of this program.
134 Ideas, questions, patches and bug reports
135 -----------------------------------------
136 See http://www.geany.org/.
137 If you add something, or fix a bug, please create a pull request at
138 https://github.com/geany/geany/. Also see the HACKING file.
141 ----
143 | 2005-2016 by Enrico Tröger, Nick Treleaven, Colomban Wendling, Matthew Brush and Frank Lanitz
144 | enrico(dot)troeger(at)uvena(dot)de
145 | nick(dot)treleaven(at)btinternet(dot)com
146 | ban(at)herbesfolles(dot)org
147 | mbrush(at)codebrainz(dot)ca
148 | frank(at)frank(dot)uvena(dot)de