Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

82 lines (67 sloc) 2.965 kb
;;; helm-man.el --- Man and woman UI
;; Copyright (C) 2012 Thierry Volpiatto <thierry.volpiatto@gmail.com>
;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;;; Code:
(eval-when-compile (require 'cl))
(require 'helm)
(declare-function woman-file-name-all-completions "woman.el" (topic))
(declare-function Man-getpage-in-background "man.el" (topic))
(defvar helm-c-man-pages nil
"All man pages on system.
Will be calculated the first time you invoke helm with this
source.")
(defun helm-c-man-default-action (candidate)
"Default action for jumping to a woman or man page from helm."
(let ((wfiles (mapcar 'car (woman-file-name-all-completions candidate))))
(condition-case err
(if (> (length wfiles) 1)
(woman-find-file
(helm-comp-read
"ManFile: " wfiles :must-match t))
(woman candidate))
;; If woman is unable to format correctly
;; use man instead.
(error (kill-buffer) ; Kill woman buffer.
(Man-getpage-in-background candidate)))))
(defvar helm-c-source-man-pages
`((name . "Manual Pages")
(candidates . (lambda ()
(if helm-c-man-pages
helm-c-man-pages
;; XEmacs doesn't have a woman :)
(setq helm-c-man-pages
(ignore-errors
(require 'woman)
(woman-file-name "")
(sort (mapcar 'car woman-topic-all-completions)
'string-lessp))))))
(action ("Show with Woman" . helm-c-man-default-action))
;; Woman does not work OS X
;; http://xahlee.org/emacs/modernization_man_page.html
(action-transformer . (lambda (actions candidate)
(if (eq system-type 'darwin)
'(("Show with Man" . man))
actions)))
(requires-pattern . 2)))
;;;###autoload
(defun helm-man-woman ()
"Preconfigured `helm' for Man and Woman pages."
(interactive)
(helm-other-buffer 'helm-c-source-man-pages "*Helm man woman*"))
(provide 'helm-man)
;; Local Variables:
;; byte-compile-warnings: (not cl-functions obsolete)
;; coding: utf-8
;; indent-tabs-mode: nil
;; byte-compile-dynamic: t
;; End:
;;; helm-man.el ends here
Jump to Line
Something went wrong with that request. Please try again.