https://github.com/purcell/whole-line-or-region

In Emacs, operate on current line if no region is active
https://github.com/purcell/whole-line-or-region

Last synced: 3 days ago
JSON representation

In Emacs, operate on current line if no region is active

• Host: GitHub
• URL: https://github.com/purcell/whole-line-or-region
• Owner: purcell
• Created: 2011-09-01T08:21:16.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2024-11-07T07:34:56.000Z (3 months ago)
• Last Synced: 2024-12-02T18:04:19.979Z (2 months ago)
• Language: Emacs Lisp
• Homepage:
• Size: 80.1 KB
• Stars: 121
• Watchers: 4
• Forks: 12
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
[![Melpa Status](http://melpa.org/packages/whole-line-or-region-badge.svg)](http://melpa.org/#/whole-line-or-region)

[![Melpa Stable Status](http://stable.melpa.org/packages/whole-line-or-region-badge.svg)](http://stable.melpa.org/#/whole-line-or-region)

[![Build Status](https://github.com/purcell/whole-line-or-region/actions/workflows/test.yml/badge.svg)](https://github.com/purcell/whole-line-or-region/actions/workflows/test.yml)



# In Emacs, operate on the current line if no region is active

This minor mode allows functions to operate on the current line if

they would normally operate on a region and region is currently

undefined.

The primary use for this is to kill (cut) the current line if no

region is defined, and kill-region is invoked.  It basically saves you

the effort of going to the begining of the line, selecting the text up

to the end of the line, and killing.  Similarly, when yanking, it's

smart enough to know that the string to be yanked was killed as a

whole line, and it should be yanked as one, too.  So you don't need to

position yourself at the start of the line before yanking.  If region

*is* defined, though, all functions act as normal.

This minor mode was originally written by Joe Casadonte in 2001, and

was maintained for recent Emacsen by Steve Purcell for several

years. In 2020 the internals were rewritten to use modern Emacs

features such as `filter-buffer-substring-function` and

`yank-handler`, and thereby behave more consistently.

## Usage

Enabling `whole-line-or-region-global-mode` causes the common

kill/copy commands to be remapped. When no region is active, if you

type `C-w` then the current line will be killed. When yanked using

`C-y`, it will be yanked _before_ the current line. If a region is

active, e.g. if you have selected a word, the commands will behave as

usual.

Other commands are similarly overridden, e.g. `comment-dwim`: see

`whole-line-or-region-local-mode-map` for more details.

Using positive numeric prefix arguments, you can operate on multiple

lines at once, e.g. `C-3 C-w` will kill 3 whole lines, beginning with

the current line. Cycling yanks with `yank-pop` (`M-y`) should also

work correctly.

Functions are provided which allow you to easily wrap other commands

so that they will also operate on the current line by default. The

wrapped commands can then similarly be remapped in

`whole-line-or-region-local-mode-map`.

## Installation

### Manual

Ensure `whole-line-or-region.el` is in a directory on your load-path, and add

the following to your `~/.emacs` or `~/.emacs.d/init.el`:

```elisp

(require 'whole-line-or-region)

```

### MELPA

If you're an Emacs 24 user or you have a recent version of

`package.el` you can install `whole-line-or-region` from the

[MELPA](http://melpa.org) repository. The version of

`whole-line-or-region` there will always be up-to-date.

## About

Author: Steve Purcell 

Homepage: https://github.com/purcell/whole-line-or-region



[💝 Support this project and my other Open Source work](https://www.patreon.com/sanityinc)

[💼 LinkedIn profile](https://uk.linkedin.com/in/stevepurcell)

[✍ sanityinc.com](https://www.sanityinc.com/)