56

GitHub - coldnew/linum-relative: display relative line number in the left margin...

 6 years ago
source link: https://github.com/coldnew/linum-relative
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

README.md

linum-relative.el

display relative line number in emacs.

License GPLv2 MELPA MELPA Stable

Screenshot

linum-relative lets you display relative line numbers for current buffer.

Installation

If you have melpa and emacs24 installed, simply type:

M-x package-install linum-relative

And add the following to your .emacs

(require 'linum-relative)

Setup & Tips

The non-interactive function linum-on (which should already be built into recent GNU Emacs distributions), turns on side-bar line numbering:

(linum-on)

and alternatively, by using command:

M-x linum-relative-mode

Relative line numbering should already be enabled by default (by installing this package), following linum-on or enabling linum-mode. One can also use the linum-relative-toggle interactive function to switch between relative and non-relative line numbering:

M-x linum-relative-toggle

Backends

By default, linum-relative use linum-mode as backend, since linum-mode is based on emacs-lisp, you may have performance issue on large file.

Since linum-relative 0.6, if you also use emacs version 26.1 or above, you can setup linum-relative-backend to make linum-relative-mode use display-line-number-mode as backend, which is implement in C so the performance is really nice.

However some linum-relative's customize function may not work propely.

Here's how to use display-line-number-mode as backend:

     ;; Use `display-line-number-mode` as linum-mode's backend for smooth performance
	(setq linum-relative-backend 'display-line-numbers-mode)

Function Documentation

(linum-relative-in-helm-p)

Return non nil when in an helm session.

(linum-relative-on)

Turn ON linum-relative.

(linum-relative-off)

Turn OFF linum-relative.

(linum-relative-toggle)

Toggle between linum-relative and linum.

Markdown README file generated by make-readme-markdown.el

report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK