jonathanchu / homebrew-emacs-head

GNU Emacs formula for the Homebrew package manager

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Banner

Emacs Head

GNU General Public License Version 3.0 Travis CI Status

Emacs Head is an Homebrew formula based on the original Homebrew Emacs one.

This formula currently supports:

  • GNU Emacs 26.3
  • GNU Emacs 27.1 (or HEAD)
  • GNU Emacs HEAD (currently 28.0.50)

Bottles for GNU Emacs 26.3 and 27.1 are available for the following macOS versions:

  • Catalina
  • Mojave
  • High Sierra

GNU Emacs 26.3 bottles have been built with the following options:

--with-cocoa
--with-no-frame-refocus
--with-imagemagick (6)
--with-multicolor-fonts

GNU Emacs 27.1 bottles have been built with the following options:

--with-cocoa
--with-no-frame-refocus
--with-imagemagick (7)
--with-pdumper
--with-xwidgets

if you need support for an older macOS version please open an Issue.

Installation

You can install this formula using:

GNU Emacs 26 (Bottle)

brew tap daviderestivo/emacs-head
brew install emacs-head@26

GNU Emacs 27 (Bottle or HEAD)

brew tap daviderestivo/emacs-head
brew install emacs-head

If you wish to install the HEAD version of GNU Emacs 27 please do:

brew tap daviderestivo/emacs-head
brew install --HEAD emacs-head --with-cocoa

GNU Emacs 28 (HEAD)

brew tap daviderestivo/emacs-head
brew install emacs-head@28 --with-cocoa

Screenshots

GNU Emacs running in terminal mode (28.x)

/images/emacs-head-terminal.png

GNU Emacs running in GUI mode (28.x)

GUI Theme: atom-one-dark-theme

Modeline Theme: smart-mode-line-atom-one-dark-theme

/images/emacs-head-cocoa.png

Compilation options

The following compilation options are available:

OptionDescription
--with-crash-debugAppend `-g3` to CFLAGS to enable crash debugging
--with-cocoaBuild a Cocoa version of GNU Emacs
--with-ctagsDon’t remove the ctags executable that GNU Emacs provides
--with-dbusBuild with dbus support
--without-gnutlsDisable gnutls support
--with-imagemagickBuild with imagemagick support
--without-librsvgDisable librsvg support
--with-mailutilsBuild with mailutils support
--with-multicolor-fontsEnable multicolor fonts support on macOS (only for emacs-head)
--without-modulesDisable dynamic modules support
--with-no-frame-refocusDisables frame re-focus (ie. closing one frame does not refocus another one)
--without-libxml2Disable libxml2 support
--with-pdumperEnable pdumper support (only for emacs-head@27 and emacs-head@28)
--with-xwidgetsEnable xwidgets support (only for emacs-head@27 and emacs-head@28)

For the terminal version only of GNU Emacs please omit --with-cocoa.

By default:

  • gnutls
  • librsvg
  • libxml2
  • dynamic modules

are enabled. If you want to disable them please use the above --without-* options.

System appearance change support

This patch is enabled by default and can’t be disabled. It adds a hook, ns-system-appearance-change-functions, that is called once the system appearance is changed. Functions added to this hook will be called with one argument, a symbol that is either light or dark. This mainly allows loading a different theme to better match the system appearance.

(add-hook 'ns-system-appearance-change-functions
          #'(lambda (appearance)
              (mapc #'disable-theme custom-enabled-themes)
              (pcase appearance
                ('light (load-theme 'tango t))
                ('dark (load-theme 'tango-dark t)))))

Note that this hook is run early in the startup process, so if you want your theme to match the system appearance when GNU Emacs starts, you can register your function(s) in your early-init.el. The hook is NOT run in TTY sessions.

Pdumper support

The portable dumper is available in HEAD. To enable this feature please use --HEAD --with-pdumper.

For a pdumper configuration example, you could take inspiration from Galactic Emacs: pdumper-init.el and pdumper-config.el configuration files.

Xwidgets support

This formula support via a (patch) native macOS X Cocoa Xwidgets support via embedding a native webkit window. To enable this feature please use --HEAD --with-xwidgets.

Available icons

OptionDescriptionImageURL
--with-modern-icon-sjrmanningUse a modern style icon by Sjrmannings/icons/modern-icon-sjrmanning.pngLink
--with-modern-icon-asingh4242Use a modern style icon by Asingh4242/icons/modern-icon-asingh4242.pngLink
--with-modern-icon-paper-iconsUse a modern style icon by Sam Hewitt/icons/modern-icon-paper-icons.pngLink
--with-modern-icon-azhilinUse a modern style icon by Andrew Zhilin/icons/modern-icon-azhilin.pngLink
--with-modern-icon-mzaplotnikUse a modern style icon by Matjaz Zaplotnik/icons/modern-icon-mzaplotnik.pngLink
--with-modern-icon-bananxanUse a modern style icon by BananXan/icons/modern-icon-bananxan.pngLink
--with-modern-icon-vscodeUse a modern style icon by Valentin Degenne/icons/modern-icon-vscode.pngLink
--with-modern-icon-sexy-v1Use a modern style icon by Emacs is Sexy/icons/modern-icon-sexy-v1.pngLink
--with-modern-icon-sexy-v2Use a modern style icon by Emacs is Sexy/icons/modern-icon-sexy-v2.pngLink
--with-modern-icon-cg433nUse a modern style icon by Cg433n/icons/modern-icon-cg433n.pngLink
--with-modern-icon-purpleUse a modern style icon by Nicolas Petton/icons/modern-icon-purple.pngLink
--with-modern-icon-yellowUse a modern style icon by Unknown/icons/modern-icon-yellow.pngLink
--with-modern-icon-orangeUse a modern style icon by Omar Jair Purata Funes/icons/modern-icon-orange.pngLink
--with-modern-icon-papirusUse a modern style icon by Papirus Development Team/icons/modern-icon-papirus.pngLink
--with-modern-icon-penUse a modern style icon by Kentaro Ohkouchi/icons/modern-icon-pen.pngLink
--with-modern-icon-pen-3dUse a modern style icon by Unknown/icons/modern-icon-pen-3d.pngLink
--with-modern-icon-pen-blackUse a modern style icon by Cayetano Santos/icons/modern-icon-pen-black.pngLink
--with-modern-icon-black-variantUse a modern style icon by BlackVariant (Patrick)/icons/modern-icon-black-variant.pngLink
--with-modern-icon-purple-flatUse a modern style icon by Jeremiah Foster/icons/modern-icon-purple-flat.pngLink
--with-modern-icon-spacemacsUse a modern style icon by Nasser Alshammari/icons/modern-icon-spacemacs.pngLink
--with-modern-icon-alecive-flatwokenUse a modern style icon by Alessandro Roncone/icons/modern-icon-alecive-flatwoken.pngLink
--with-modern-icon-bokehlicia-captivaUse a modern style icon by Bokehlicia/icons/modern-icon-bokehlicia-captiva.pngLink
--with-modern-icon-nuvolaUse a modern style icon by David Vignoni/icons/modern-icon-nuvola.pngLink
--with-modern-icon-black-gnu-headUse a modern style icon by Aha-Soft/icons/modern-icon-black-gnu-head.pngLink
--with-modern-icon-black-dragonUse a modern style icon by Osike/icons/modern-icon-black-dragon.pngLink
--with-modern-icon-emacs-icon1Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon1.pngLink
--with-modern-icon-emacs-icon2Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon2.pngLink
--with-modern-icon-emacs-icon3Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon3.pngLink
--with-modern-icon-emacs-icon4Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon4.pngLink
--with-modern-icon-emacs-icon5Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon5.pngLink
--with-modern-icon-emacs-icon6Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon6.pngLink
--with-modern-icon-emacs-icon7Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon7.pngLink
--with-modern-icon-emacs-icon8Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon8.pngLink
--with-modern-icon-emacs-icon9Use a modern style icon by Jasonm23/icons/modern-icon-EmacsIcon9.pngLink
--with-modern-icon-emacs-card-blue-deepUse a modern style icon by Jasonm23/icons/modern-icon-emacs-card-blue-deep.pngLink
--with-modern-icon-emacs-card-british-racing-greenUse a modern style icon by Jasonm23/icons/modern-icon-emacs-card-british-racing-green.pngLink
--with-modern-icon-emacs-card-carmineUse a modern style icon by Jasonm23/icons/modern-icon-emacs-card-carmine.pngLink
--with-modern-icon-emacs-card-greenUse a modern style icon by Jasonm23/icons/modern-icon-emacs-card-green.pngLink
--with-retro-icon-emacs-logoUse a retro style icon by Luis Fernandes/icons/retro-icon-emacs-logo.pngLink
--with-retro-icon-gnu-headUse a retro style icon by Aurélio A. Heckert/icons/retro-icon-gnu-head.pngLink
--with-retro-icon-gnu-meditate-levitateUse a retro style icon by Nevrax Design Team/icons/retro-icon-gnu-meditate-levitate.pngLink
--with-retro-icon-sink-bwUse a retro style icon by Unknown/icons/retro-icon-sink-bw.pngLink
--with-retro-icon-sinkUse a retro style icon by Erik Mugele/icons/retro-icon-sink.pngLink

Why yet another Homebrew GNU Emacs formula?

Since the option --with-cocoa is not available in the latest GNU Emacs homebrew-core formula (see pull request), I decided to build my own formula.

About the logo

‘Kitchen Sink’ OS Announced

Coding has begun on a new operating system code named ‘Kitchen Sink’. The new OS will be based entirely on GNU Emacs. One programmer explained, “Since many hackers spend a vast amount of their time in Emacs, why not just make it the operating system?” When asked about the name, he responded, “Well, it has been often said that Emacs has everything except a kitchen sink. Now it will.” — James Baughn (http://humorix.org/10016)

Collaborating

If you are interested in collaborating please open a Pull Request.

About

GNU Emacs formula for the Homebrew package manager

License:GNU General Public License v3.0


Languages

Language:Ruby 100.0%