Skip to content

Latest commit

 

History

History
77 lines (67 loc) · 2.87 KB

README.org

File metadata and controls

77 lines (67 loc) · 2.87 KB

Elemacs (working in progress)

Contents

Introduction

Elemacs is a personal Emacs config. It may not be the best Emacs configuration, but it is definitely the most comfortable and efficient one for me to use. I have made a lot of hacks to adapt Emacs to suit me, so please be sure to read the README before trying my configuration.

It is compatible ONLY with GNU Emacs 29 and above.

Features

  • Fast
  • Modular
  • Package installation and configuration separation

Structure

/core

This folder contains essential libraries, useful functions, macros, and some settings.
  1. core-incremental-loading.el

    The code in this file is mainly taken from doomemacs .

    Load packages incrementally. Any large packages here may cause noticeable pauses, so it’s recommended you break them up into sub-packages.

  2. core-setup.el

    Elemacs use SetupEl as its configuration manager. The main reason for choosing it is its simplicity and extensibility. You can use emacs-lisp-macroexpand or pp-macroexpand-last-sexp to expand any setup config to get more information.

    This file defines some useful setup-local macros, such as :iload , :silence , :option* .

  3. core-lib.el

    core-lib.el provides utilities that will be used in all configuration, such as elemacs-completing-read.

  4. core-better-defaults.el

    Just like its file name, this file includes modifications to many default settings in Emacs.

  5. core-benchmarking.el

    This is a simple benchmark of calls to Emacs require and load functions. It can be used to keep track of where time is being spent during Emacs startup in order to optimize startup times.

  6. core-ui.el

    UI config. See Elilif/mindre-theme for more details.

/lisp and /lib

These two folders contain configurations of many packages.