Edit: 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. - [[http://cvs.savannah.gnu.org/viewvc/*checkout*/emacs/etc/refcards/refcard.pdf?revision=1.1&root=emacs|emacs refcard.pdf]] - [[http://www.gnu.org/software/emacs/manual/emacs.pdf|emacs PDF manual]] == Quickstart for Mac OS X Emacs == See [[Emacs Integration on OS X]]. == Quickstart for Windows Emacs == Download [[http://ourcomments.org/cgi-bin/emacsw32-dl-latest.pl|emacs-w32]] and install it to "\\Program Files\\Emacs" or "\\Program Files(x86)\\Emacs". Factor will autodetect it from these locations. Make a .emacs with your path to FUEL: [lisp{;;; Factor (load-file "d:/Program Files/factor/misc/fuel/fu.el") }] Run Factor, and copy the .emacs file to both %"HOME" os-env .% and %"HOMEPATH" os-env .% [factor{USE: editors.emacs}] Your emacs should now be running, and commands like %\ + edit% or %"calendar" edit-vocab% should work. == 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: [lisp{;;; 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. In Win32 environment, if you encounter "M-x run-factor" terminated with "Prompt not found", you should indicate "<FACTOR-DIR>/factor.com" as your "fuel-listener-factor-binary". [lisp{; ...additional win32 fuel setting: (setq fuel-listener-factor-binary "d:/factor/factor.com") }] == 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 [factor{USE: io.pathnames home .}] and you can even have factor create a blank file in the proper location with [factor{USE: io.directories home "factor-rc" append-path touch-file}] Edit that file and add something like: [factor{USING: namespaces editors.emacs ; "d:/Program Files/emacs-22.3/bin/emacs.exe" \ emacsclient-path set-global}] again, change the path appropriately. Per [[http://tunes.org/~nef//logs/concatenative/08.11.16|a recent IRC log]], you will probably also need to edit %c:/Program_Files/factor/basis/editors/emacs/emacs.factor% You should comment out the call to %--no-wait% because this doesn't exist on Emacsclient for Windows. At this point Factor should now be integrated with emacs. Invoke the following in the listener to test: [factor{\ + 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. - [[http://blip.tv/file/1658806|FUEL screencast]] == FUEL Cheatsheet == You'll find here a small sheet (in pdf and OpenOffice) for using FUEL inside Emacs : [[http://kib2.free.fr/muse/FACTOR.html|Cheatsheets]]

Describe this revision:

Save