ui/modeline: update README

To reflect our adoption of the doom-modeline package. Still a WIP, but
is at least more correct now.

Renders #1412 unnecessary.
This commit is contained in:
Henrik Lissner 2019-05-13 19:30:55 -04:00
parent 9bc47ca329
commit 0a0def6a53
No known key found for this signature in database
GPG key ID: 5F6C0EA160557395
2 changed files with 63 additions and 61 deletions

View file

@ -4,54 +4,38 @@
#+STARTUP: inlineimages #+STARTUP: inlineimages
* Table of Contents :TOC_2:noexport: * Table of Contents :TOC_2:noexport:
- [[Description][Description]] - [[#description][Description]]
- [[Module Flags][Module Flags]] - [[#module-flags][Module Flags]]
- [[Plugins][Plugins]] - [[#plugins][Plugins]]
- [[Prerequisites][Prerequisites]] - [[#prerequisites][Prerequisites]]
- [[Usage][Usage]] - [[#usage][Usage]]
- [[Hiding the modeline][Hiding the modeline]] - [[#hiding-the-modeline][Hiding the modeline]]
- [[Switching the modeline and header line][Switching the modeline and header line]] - [[#switching-the-modeline-and-header-line][Switching the modeline and header line]]
- [[Configuration][Configuration]] - [[#configuration][Configuration]]
- [[Changing the default modeline][Changing the default modeline]] - [[#changing-the-default-modeline][Changing the default modeline]]
- [[Activating a format][Activating a format]] - [[#activating-a-format][Activating a format]]
- [[Defining a modeline format][Defining a modeline format]] - [[#defining-a-modeline-format][Defining a modeline format]]
- [[Defining a modeline segment][Defining a modeline segment]] - [[#defining-a-modeline-segment][Defining a modeline segment]]
- [[Extracting Doom's modeline into your config][Extracting Doom's modeline into your config]] - [[#extracting-dooms-modeline-into-your-config][Extracting Doom's modeline into your config]]
- [[Troubleshooting][Troubleshooting]] - [[#troubleshooting][Troubleshooting]]
- [[Where are my minor modes?][Where are my minor modes?]] - [[#where-are-my-minor-modes][Where are my minor modes?]]
- [[Icons in my modeline look strange][Icons in my modeline look strange]] - [[#icons-in-my-modeline-look-strange][Icons in my modeline look strange]]
- [[Appendix][Appendix]] - [[#appendix][Appendix]]
- [[Commands][Commands]] - [[#autodefs][Autodefs]]
- [[Autodefs][Autodefs]] - [[#variables][Variables]]
- [[Functions][Functions]] - [[#faces][Faces]]
- [[Variables][Variables]]
- [[Faces][Faces]]
- [[Modeline segments][Modeline segments]]
* Description * Description
This module provides an Atom-inspired, minimalistic modeline for Doom Emacs, as This module provides an Atom-inspired, minimalistic modeline for Doom Emacs,
well as an API for building your own. powered by [[https://github.com/seagle0128/doom-modeline][the doom-modeline package]] (where you can find screenshots).
+ A match count panel (for ~evil-search~, ~iedit~ and ~evil-substitute~)
+ An indicator for recording a macro
+ Local python/ruby version in the major-mode
+ A customizable mode-line height (see ~+doom-modeline-height~)
+ An error/warning count segment for flycheck
[[/../screenshots/ml.png]]
[[/../screenshots/ml-search.png]]
[[/../screenshots/ml-subst.png]]
[[/../screenshots/ml-macro.png]]
[[/../screenshots/ml-version.png]]
[[/../screenshots/ml-errors.png]]
** Module Flags ** Module Flags
This module provides no flags. This module provides no flags.
** Plugins ** Plugins
+ [[https://github.com/seagle0128/doom-modeline][doom-modeline]]
+ [[https://github.com/syohex/emacs-anzu][anzu]] + [[https://github.com/syohex/emacs-anzu][anzu]]
+ [[https://github.com/syohex/emacs-evil-anzu][evil-anzu]] + [[https://github.com/syohex/emacs-evil-anzu][evil-anzu]]
+ [[https://gitlab.com/bennya/shrink-path.el][shrink-path]]
* Prerequisites * Prerequisites
This module has no prerequisites. This module has no prerequisites.
@ -75,42 +59,62 @@ This module has no prerequisites.
* Troubleshooting * Troubleshooting
** Where are my minor modes? ** Where are my minor modes?
I rarely need to know what minor modes are active, so I removed them. ~M-x I rarely need to know what minor modes are active, so I removed them. ~M-x
doom/what-minor-mode~ was written to substitute for it. doom/describe-active-minor-mode~ was written to substitute for it.
** TODO Icons in my modeline look strange ** TODO Icons in my modeline look strange
* Appendix * Appendix
** Commands
This module exposes no public commands.
** Autodefs ** Autodefs
+ ~def-modeline-format! NAME LEFT &optional RIGHT~ + ~def-modeline-format! NAME LEFT &optional RIGHT~
+ ~def-modeline-segment! NAME &rest REST~ + ~def-modeline-segment! NAME &rest REST~
+ ~set-modeline! NAME &optional DEFAULT~ + ~set-modeline! NAME &optional DEFAULT~
** Functions
+ +modeline-file-path
** Variables ** Variables
+ +modeline-width + doom-modeline-height
+ +modeline-height + doom-modeline-bar-width
+ +modeline-buffer-path-function + doom-modeline-buffer-file-name-style
+ +modeline-format-left + doom-modeline-icon
+ +modeline-format-rigth + doom-modeline-major-mode-icon
+ doom-modeline-major-mode-color-icon
+ doom-modeline-buffer-state-icon
+ doom-modeline-buffer-modification-icon
+ doom-modeline-minor-modes
+ doom-modeline-enable-word-count
+ doom-modeline-buffer-encoding
+ doom-modeline-indent-info
+ doom-modeline-checker-simple-format
+ doom-modeline-vcs-max-length
+ doom-modeline-persp-name
+ doom-modeline-lsp
+ doom-modeline-github
+ doom-modeline-github-interval
+ doom-modeline-env-version
+ doom-modeline-mu4e
+ doom-modeline-irc
+ doom-modeline-irc-stylize
** Faces ** Faces
+ doom-modeline-buffer-path + doom-modeline-buffer-path
+ doom-modeline-buffer-file + doom-modeline-buffer-file
+ doom-modeline-buffer-modified + doom-modeline-buffer-modified
+ doom-modeline-buffer-major-mode + doom-modeline-buffer-major-mode
+ doom-modeline-buffer-minor-mode
+ doom-modeline-project-parent-dir
+ doom-modeline-project-dir
+ doom-modeline-project-root-dir
+ doom-modeline-highlight + doom-modeline-highlight
+ doom-modeline-panel + doom-modeline-panel
+ doom-modeline-debug
+ doom-modeline-info + doom-modeline-info
+ doom-modeline-warning + doom-modeline-warning
+ doom-modeline-urgent + doom-modeline-urgent
+ doom-modeline-unread-number
+ doom-modeline-bar + doom-modeline-bar
** Modeline segments + doom-modeline-inactive-bar
+ +modeline-buffer-state + doom-modeline-evil-emacs-state
+ +modeline-buffer-id + doom-modeline-evil-insert-state
+ +modeline-buffer-directory + doom-modeline-evil-motion-state
+ +modeline-vcs + doom-modeline-evil-normal-state
+ +modeline-encoding + doom-modeline-evil-operator-state
+ +modeline-major-mode + doom-modeline-evil-visual-state
+ +modeline-matches + doom-modeline-evil-replace-state
+ +modeline-selection-info + doom-modeline-persp-name
+ doom-modeline-persp-buffer-not-in-persp

View file

@ -1,7 +1,5 @@
;;; ui/modeline/config.el -*- lexical-binding: t; -*- ;;; ui/modeline/config.el -*- lexical-binding: t; -*-
;; TODO Add themes (default, minimal, spacemacs, etc)
(def-package! doom-modeline (def-package! doom-modeline
:hook (after-init . doom-modeline-mode) :hook (after-init . doom-modeline-mode)
:init :init
@ -84,4 +82,4 @@
(def-package! evil-anzu (def-package! evil-anzu
:when (featurep! :editor evil) :when (featurep! :editor evil)
:after-call (evil-ex-start-search evil-ex-start-word-search)) :after-call (evil-ex-start-search evil-ex-start-word-search evil-ex-search-activate-highlight))