Skip to content
sinxccc edited this page Dec 28, 2021 · 6 revisions

Items are unordered and not in group, use search to locate a topic.

Formula Options

Please see this page for a detailed options list:

Doom Emacs

If you are using Doom Emacs, be sure to run doom sync after installation or upgrade

  ~/.emacs.d/bin/doom sync

Start Emacs.app GUI from command line/Shell

Whether you install with brew or brew cask, an emacs symlink will be added to your $(brew --prefix)/bin so that you can start Emacs by running the emacs command in your shell. However, this emacs command will behave differently depending on which you used, because brew cask installs a single macOS app bundle, while brew installs files according to the UNIX tradition.

By default, running the emacs command from your shell will start the Emacs.app GUI if you installed from brew cask, while the same command will start the Emacs TUI (emacs -nw) if you installed from brew.

brew users may use the --with-starter install option, which will place a simple GUI starter under $(brew --prefix)/bin, so that the emacs command can be used to start the Emacs.app GUI just as with brew cask.

Other starter scripts can be found from this gist and its comments.

Emacs mac port on macports

Emacs mac port also available on MacPorts with name "emacs-mac-app" and "emacs-mac-app-devel", but they are not maintained by the maintainer of this formula.

Native-comp

Native-comp is not supported currently.

Discussion: #256

Settings for open -a Emacs <filename> to use new frame

The open command sends an Apple Event to Emacs, which is handled by the mac-ae-open-documents function in mac-win.el (found in Contents/Resources/lisp/term inside the application bundle). That function delegates to dnd-open-local-file whose documentation refers to dnd-open-file-other-window.

Setting dnd-open-file-other-window to t will create a new window for an opened document.

You may also need to set pop-up-frames to t or graphic-only. This controls Emacs' preference for using frames instead of windows across commands in general.

Discussion: #249