You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Matthew Brush 8abe5342c5
Merge pull request #2212 from TwlyY29/bibtex-parser
1 week ago
ctags moved bibtex definition to the end of filetypes and parser definitions 1 month ago
data Merge pull request #2212 from TwlyY29/bibtex-parser 1 week ago
doc doc: added documentation for the Color Chooser 1 month ago
icons icon: regenerate png/ico files based on the svg 4 years ago
m4 Fix configure to show "default=auto" for --enable-api-docs (#2190) 3 months ago
plugins Update all copyright notices to mention only the first publish year 7 months ago
po Small update of Latvian translation (#2383) 2 weeks ago
scintilla scintilla: Fix GCC 4.8 support wrt noexcept move constructors 6 months ago
scripts Update functions and variables for the NSIS filetype 4 months ago
src Merge pull request #2212 from TwlyY29/bibtex-parser 1 week ago
tests utils: fix suboptimal elipsis substitution by utils_strv_shorten_file_list() 1 month ago
.gitignore Remove unused spec (RPM) file 9 months ago
.travis.yml travis: Add binreloc to the build matrix 11 months ago
AUTHORS Add Matthew Brush as developer 8 years ago
COMMITTERS Add Colomban to the COMMITTERS list 8 years ago
COPYING Update FSF address 7 years ago
ChangeLog Generate ChangeLog from Git log 7 years ago
ChangeLog.pre-1-22 Concatenate ChangeLog.pre-0-17 and ChangeLog.pre-1-22 3 years ago
HACKING Fix broken markup in HACKING 2 months ago
INSTALL Remove faulty empty lines 2 years ago
Makefile.am Remove unused spec (RPM) file 9 months ago
NEWS Post release version bump 1 month ago
README Update all copyright notices to mention only the first publish year 7 months ago
README.I18N Use HTTPS URL for domain www.geany.org 1 year ago
README.Packagers Update all copyright notices to mention only the first publish year 7 months ago
README.rst Add a README.rst link for GitHub to know the format and render it 3 years ago
THANKS Update Indonesian translation (#1501) 2 years ago
TODO Remove GNU regex now we have GRegex 7 years ago
autogen.sh Don't warn about missing configure flags if configure shall be skipped 7 years ago
configure.ac Post release version bump 1 month ago
geany.desktop.in geany.desktop.in: Add Keywords field entry 3 years ago
geany.exe.manifest Post release version bump 1 month ago
geany.gladep Don't regenerate the support.[hc] files, to prevent unnecessary rebuilding of files dependent on support.h. 12 years ago
geany.nsi.in Windows installer: Migrate to NSIS 3.x 5 months ago
geany.pc.in Replace references to GTK2 with GTK+ 4 years ago
geany_private.rc Post release version bump 1 month ago

README

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.


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 GTK2 (>= 2.24) or
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
+++++++++++++++++++++++++++

Install Autotools (*automake*, *autoconf* and *libtool*), *intltool*,
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.