ahungry / magit-todos

Show source files' TODOs (and FIXMEs, etc) in Magit status buffer

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

magit-todos

https://melpa.org/packages/magit-todos-badge.svg https://stable.melpa.org/packages/magit-todos-badge.svg

This package displays keyword entries from source code comments and Org files in the Magit status buffer. Activating an item jumps to it in its file. By default, it uses keywords from hl-todo, minus a few (like NOTE).

Contents

Screenshots

screenshots/matrix.png

Org headings can optionally be fontified as such, and sorting can be customized (this shows sorting by filename, then keyword, then buffer position):

screenshots/org.png

Items can also be automatically grouped in a customizable way, which can be helpful in large repos:

screenshots/emacs-grouped.png

This shows grouping items by the first path component, then keyword, then filename, and with optional keyword header fontification:

screenshots/emacs-grouped-by-path.png

Installation

If you installed from MELPA, you’re done!

Manual

Install these required packages:

  • a
  • anaphora
  • async
  • dash
  • f
  • hl-todo
  • magit
  • pcre2el
  • s

Then put this file in your load-path, and put this in your init file:

(require 'magit-todos)

Usage

Run magit-todos-mode, then open a Magit status buffer.

Tips

  • Customize settings in the magit-todos group.
  • Jump to the to-do list in a Magit status buffer by pressing j T.

Credits

  • This package was inspired by magit-org-todos.
  • The ag support was made much simpler by the great pcre2el package by Jon Oddie.

License

GPLv3

About

Show source files' TODOs (and FIXMEs, etc) in Magit status buffer

License:GNU General Public License v3.0


Languages

Language:Emacs Lisp 100.0%