-
Notifications
You must be signed in to change notification settings - Fork 609
/
README
175 lines (126 loc) · 5.83 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
Geany - A fast and lightweight IDE
----------------------------------
About
-----
Geany is a small and lightweight integrated development environment.
It was developed to provide a small and fast IDE, which has only a
few dependencies from other packages. Another goal was to be as independent
as possible from a special Desktop Environment like KDE or GNOME. So it
is using only the GTK+ toolkit and therefore you need only the
GTK+ runtime libraries to run Geany.
.. image:: doc/images/main_window.png
:width: 750
:alt: Screenshot of Geany showing the main user interface
:target: doc/images/main_window.png
Features
--------
The basic features of Geany are:
- syntax highlighting
- code completion
- auto completion of often used constructs like if, for and while
- auto completion of XML and HTML tags
- call tips
- folding
- many supported filetypes like C, Java, PHP, HTML, Python, Perl, Pascal
- symbol lists
- embedded terminal emulation
- extensibility through plugins
Installation from distribution packages
---------------------------------------
Using distribution packages on Linux, BSD and similar distributions
is the easiest and recommended way. This way you will also benefit
from automatic Geany updates by the package manager of the distribution.
Packages are available for most distributions including Debian, Fedora, Ubuntu
and many more.
Installation on Mac OS and Windows
----------------------------------
Prebuilt binary packages for Mac OS and Windows can be found on
https://www.geany.org.
Installation from sources
-------------------------
Requirements
++++++++++++
For compiling Geany yourself, you will need the GTK3 libraries and
header files. You will also need its dependency libraries and header
files, such as Pango, Glib and ATK. All these files are available at
https://www.gtk.org.
Furthermore you need, of course, a C compiler and the Make tool; a C++
compiler is also needed for the required Scintilla library included. The
GNU versions of these tools are recommended.
To build the user manual you need *rst2html* from Docutils. A pre-built
version of the manual is available in distribution tarballs and will be used as
fallback if *rst2html* is missing. When building from Git however, that
pre-built version is not included and *rst2html* is required by default.
You can explicitly disable building the user manual using the
``--disable-html-docs`` *configure* flag, but this will result in not
installing a local version of the user manual, and Geany will then try
and open the online version instead when requested.
.. note::
Building Geany from source on Mac OS and Windows is more complicated
and is out of scope of this document. For more information on
building instructions for these platforms, please check the wiki
at https://wiki.geany.org/howtos/.
Installing from a Git clone
+++++++++++++++++++++++++++
Using the Meson build system
++++++++++++++++++++++++++++
N.B. Meson support is still incomplete and a work-in-progress.
Meson requires to chose a separate build directory. Either create
one, or let meson do it:
``meson build`` or ``mkdir build; cd build; meson ..``
Either command will configure the build system. The system is probed
in many ways and system-dependant build files are created. This includes
location of dependencies and compiler and linker flags required for them.
To build Geany, follow with a ``meson compile -C build``
To install Geany, follow the build with a ``sudo meson install -C build``.
By default, meson will install Geany to ``/usr/local``. A different
prefix can be selected at the initial command or via reconfiguration:
``meson --prefix /opt build`` or ``meson configure --prefix /opt build``
Geany has some selectable features that may reduce the required
build and runtime dependencies. See meson_optionts.txt for a full list.
To turn a feature off, use ``-D<feature>=false`` when configuring the build,
for example: ``meson configure -Dvte=false build``
Using Autotools
+++++++++++++++
Install Autotools (*autopoint*, *automake*, *autoconf* and *libtool*),
*gettext*, and the GLib development files **before** running any of the
following commands, as well as *rst2html* from Docutils (see above for
details). Then, run ``./autogen.sh`` and then follow the instructions for
`installing from a release tarball`_.
Installing from a release tarball
+++++++++++++++++++++++++++++++++
Run the the following three commands::
$ ./configure
$ make
(as root, or using sudo)
% make install
For more configuration details run ``./configure --help``.
If there are any errors during compilation, check your build environment
and try to find the error, otherwise contact the mailing list or one of
the authors.
See the manual for details (geany.txt/geany.html).
Usage
-----
To run Geany just type::
$ geany
on a console or use the applications menu from your desktop environment.
For command line options, see the manual page of Geany or run::
$ geany --help
for details. Or look into the documentation in the *doc/* directory.
The most important option probably is ``-c`` or ``--config``, where you can
specify an alternate configuration directory.
License
-------
Geany is distributed under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version. A copy of this license
can be found in the file COPYING included with the source code of this
program.
The included Scintilla library (found in the subdirectory scintilla/)
has its own license, which can be found in the file scintilla/License.txt
included with the source code of this program.
Ideas, questions, patches and bug reports
-----------------------------------------
See https://www.geany.org/.
If you add something, or fix a bug, please create a pull request at
https://github.com/geany/geany/. Also see the HACKING file.