FG42/README.md

78 lines
2.9 KiB
Markdown
Raw Normal View History

2018-01-26 15:49:23 +00:00
<div align="center"><img src="https://github.com/FG42/FG42/raw/master/share/icons/hicolor/128x128/apps/fg42.png" alt="FG42" align="center" /></div>
2018-01-26 15:43:21 +00:00
# Future Gadgets 42
2015-07-07 12:55:33 +01:00
If you love **GNU/Emacs**, If you love to program in an editor instead of big slow IDE but still enjoy to
have a handy code editor then **FG42** is the right choice for you.
2010-12-23 13:25:40 +00:00
2017-04-08 09:32:12 +01:00
If you need help, or even want to just say hello, try our **IRC** channel on freenode: **#5hit**.
2015-07-18 10:08:19 +01:00
2017-04-08 09:32:12 +01:00
## Dependencies
2010-12-23 13:25:40 +00:00
2017-04-08 09:32:12 +01:00
In order to run **FG42** you need **GNU Emacs >= 25**. FG42 uses several extensions internally
which each of the has different external dependencies. To gain more information about external
dependencies ( If we failed to tell you inside the **FG42** ) just run the `describe-extension`
command.
2015-07-07 12:55:33 +01:00
2017-04-08 09:32:12 +01:00
## Installation
2010-12-23 13:25:40 +00:00
2017-04-08 09:32:12 +01:00
In order to install **FG42**, issue the following commands:
2011-12-03 18:33:27 +00:00
2017-04-08 09:32:12 +01:00
```bash
# clonse the FG42 repository in ~/.fg42 directory
$ git clone git://github.com/FG42/FG42.git ~/.fg42/
# You can clone it where ever your want
$ cd ~/.fg42/
$ make install
```
Since the installer script uses `sudo`, during the installation process,
you'll have to enter your password. Make sure that you're user account has
a `sudo` access.
2011-12-03 18:33:27 +00:00
2017-04-08 09:32:12 +01:00
Enjoy using **FG42** ;)
2017-04-08 09:32:12 +01:00
## Configuration
2011-12-03 18:33:27 +00:00
2017-04-08 09:32:12 +01:00
After installation there would be a file at `~/.fg42.el` which is the user specific
configuration of **FG42**. You can configure your copy of **FG42** using this file.
Also you can generally use this file to configure Emacs as well.
2011-07-22 15:19:51 +01:00
2017-04-08 09:32:12 +01:00
## Documentation
2014-03-23 14:27:44 +00:00
2017-04-08 09:32:12 +01:00
If you're familiar with **GNU/Emacs** you're not going to have a problem with getting
help. But just to clrearify here is a list of keybindings that may guide you during
your experience:
2017-04-08 09:46:28 +01:00
2017-04-08 09:32:12 +01:00
| Key bindings | Description |
2017-04-08 09:46:28 +01:00
|:------------:|------------------|
| `C-?` | Quick cheatsheet |
| `C-h m` | All the information and keybindings of your current modes. e.g open of a `ruby` file and use the this keybinding to take a look at all the keybinding of ruby extension |
2017-04-08 09:32:12 +01:00
## what's with the name?
2014-03-23 14:27:44 +00:00
2015-07-07 12:55:33 +01:00
I'm a huge fan of [Steins Gate](https://en.wikipedia.org/wiki/Steins;Gate) anime and I follow its
naming convensions on **Future Gadgets 42**.
2014-03-23 14:27:44 +00:00
2017-04-08 09:32:12 +01:00
# License
2015-07-07 12:55:33 +01:00
FG42 is free software; you can redistribute it and/or modify
2014-03-23 14:27:44 +00:00
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
any later version.
2015-07-07 12:55:33 +01:00
FG42 is distributed in the hope that it will be useful,
2014-03-23 14:27:44 +00:00
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
2015-07-07 12:55:33 +01:00
All the documents of FG42 that locate in 'doc' directories release
2014-03-23 14:27:44 +00:00
under the term of GNU FDL.
2018-01-26 15:43:21 +00:00
Copyright (C) 2010-2018 Sameer Rahmani <lxsameer@gnu.org>