This project is for integrating fossil (http://fossil-scm.org/) into emacs (https://www.gnu.org/software/emacs/) vc-mode.
You need emacs version 24.1 or better. 23.* is not supported anymore.
How Do I load Fossil support into emacs?
Install the vc-fossil package from the MELPA package repository then customize the vc-handled-backend variable by adding "Fossil" to its list of names.
Alternative, slightly longer, answer:
Instead of installing from MELPA you may clone this source repository directly then add it manually to your Emacs setup as follows.
Add this to your .emacs file, or cut and paste this into the *scratch*
buffer and do
C-x C-e to execute it.
(add-to-list 'vc-handled-backends 'Fossil) (load-file "/path/to/this/project/vc/el/vc-fossil.el")or if you would rather load the file lazily, compile the file (see below) and use this instead.
(add-to-list 'vc-handled-backends 'Fossil) (autoload 'vc-fossil-registered "/path/to/this/project/vc/el/vc-fossil.elc")
To compile the file (with warnings) do the following
emacs -batch -q -no-site-file -eval '(byte-compile-file "vc-fossil.el")'then you can load vc-fossil.elc, which should be nominally faster.
What emacs keys do I need?
This integrates fossil into emacs vc builtin mode. The same keys will work for fossil inside a fossil tree as for other scms outside.
A few are:
|Run Fossil dired - like cvs-examine|
|When in a file, show log|
|In VC, do next action: merge/update/checkin|
Over the years many folks have helped me (Venkat Iyer, firstname.lastname@example.org) with building and improving emacs-fossil. Notable are:
- Barak A. Pearlmutter, barak pearlmutter net : Major cleanup of my initial versions
- Frank Fisher, frank-fischer shadow-soft de : colorized logs, annotate, a few fixes for the diff
- Paul Onions, ponions37 gmail com : emacs 25 support
This project is also mirrored into github at https://github.com/venks1/emacs-fossil , primarily for MELPA.