Emacs Integration

Factor ships with FUEL, which is a powerful Emacs mode which communicates with a runing Factor instance and provides semantic editing and navigation features.

• emacs refcard.pdf
• emacs PDF manual

Setup emacs

These instructions should be readily adaptable for other operating systems; in its current form it pertains to Windows XP.

• emacs23 for Windows

Add the following to your _/.emacs or other appropriate startup location:

;;; Factor
(load-file "d:/Program Files/factor/misc/fuel/fu.el")

To set the executable and image path for factor use M-x customize-group fuel, then select the Fuel Listener group. Remember to save the changes by selecting "Save for Future Sessions" when finished. Be sure to change the paths appropriately of course.

To start the listener use M-x run-factor.

FUEL, the Factor mode for emacs, has many advanced features. Consult misc/fuel/README for details.

Setup Factor

Finally you need to inform Factor that you want to use Emacs as your editor. Create or modify the .factor-rc file in your home directory. You can find out what factor thinks is your home directory with

USE: io.pathnames home .

and you can even have factor create a blank file in the proper location with

USE: io.directories home "factor-rc" append-path touch-file

Edit that file and add something like:

USING: namespaces editors.emacs ;
"d:/Program Files/emacs-22.3/bin/emacs.exe" \ emacsclient set-global

again, change the path appropriately.

At this point Factor should now be integrated with emacs. Invoke the following in the listener to test:

\ + edit

Semantic Editing and Navigation

FUEL includes many useful features for editing Factor code. Press C-c C-h inside a Factor buffer to see a list of keyboard commands.

• FUEL screencast

FUEL Cheatsheet

You'll find here a small sheet (in pdf and OpenOffice) for using FUEL inside Emacs :

Cheatsheets