~lxsameer/FG42

The ultimate editor for true believers
7b08b4ed — Sameer Rahmani 6 days ago
Switch to JetBrainsMono Nerd Font and add ligature mode
2607bdc4 — Sameer Rahmani 28 days ago
haskell: Add support for consult-hoogle
6f15e68a — Sameer Rahmani a month ago
Disable flycheck for haskell

clone

read-only
https://git.sr.ht/~lxsameer/FG42
read/write
git@git.sr.ht:~lxsameer/FG42

You can also use your local clone with git send-email.

#Future Gadgets 42 (v4.1.0)

FG42 is an Emacs based editor that utilizes Nix, and shipped preconfigured. While it is the Emacs that you love :heart:, it breaks the tradition by not using any of Emace's package managers (More on that later). It provides a self-contained program and contains all the runtime dependencies including Emacs itself.

#Requirements

The only requirement to install FG42, is Nix. If you don't use Nix, try it today. It's amazing.

#Installation

If you're using Nix (and not NixOS), then you can install FG42 like:

# Install emacs, make and texinfo
  nix profile install "git+https://git.sr.ht/~lxsameer/FG42#"

  # Or via nix build like:
  nix build "git+https://git.sr.ht/~lxsameer/FG42#"

If you're using NixOS or HomeManager you can use FG42 as an input to your flake. If your not using flakes, I'm pretty sure you know what you are doing so I leave it to your experience.

{
    description = "Exmaple flake";

    inputs = {
      fg42.url = "git+https://git.sr.ht/~lxsameer/FG42";
    };

    outputs = { self, fg42, ... } @ inputs:
      let
        system = "x86_64-linux"
      in
      {
         nixosConfigurations = {
           yourhost = nixpkgs.lib.nixosSystem {
           ....
           imports = [
             fg42.homeManagerModules.${system}.default
           ];
           programs.fg42 = {
             enable = true;
             ... rest of the configuration ...
           };
      };
  }

#Configuration

TBD

#Debugging

Debugging is OFF by default in FG42. You can turn it on by setting the FG42_DEBUG environment variable to 1.

#FAQ

#Why Nix? Have you tried Emacsian package manager?

Yes we tried many of them. We started by a manual solution that the name fpkg remains as remembrance of that effort. We moved to el-get, then Cask, Eldev and finally we landed on straight.el on ~V3~. But none of the provided the stability that we need.

But on ~V4~ (Current version), We've change the approach by disabling all the package managers (don't worry you can still use them if you want to) and used Nix to manage everything. Both elisp dependencies and system dependencies. This way we get reproducible builds that gives us stability and reliability. Also we get to pin every single dependency version even Emacs itself. So no more ":shrug: But it works on my computer".

#what's with the name?

I'm a huge fan of Steins Gate anime and I followed its naming convensions on Future Gadgets 42.

#Why we moved from Github ?

We're not happy with Microsoft aquiring Github and we don't trust a company like Microsoft because of their history and their strategies (For more information take a look at the Halloween documents. So we decided to move to Devheroes as an alternative and we are happy here so far.

#Contribute

FG42 made possible by the effort of the community of Contributors.

If you're interested in FG42 and wants to contribute to the project please follow the How to Contribute Guide. Also please read our Code of Conduct as well.

#License

FG42 is free software; you can redistribute it and/or modify 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.

FG42 is distributed in the hope that it will be useful, 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.

All the documents of FG42 that locate in 'doc' directories release under the term of GNU FDL.

Copyright (C) 2010-2024 Sameer Rahmani lxsameer@gnu.org