diff options
Diffstat (limited to 'debian/man-addons.el')
-rw-r--r-- | debian/man-addons.el | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/debian/man-addons.el b/debian/man-addons.el new file mode 100644 index 0000000..d3a0372 --- /dev/null +++ b/debian/man-addons.el @@ -0,0 +1,50 @@ +;;; man-addons.el - some helpful additions for browsing man pages. +;;; +;;; Copyright (c) 1998-2001 Karl M. Hegbloom <karlheg@hegbloom.net> +;;; Released under the terms of the GPL version >= 2.0 +;;; +;;; See: /usr/share/common-licences/GPL-2 +;;; +;;; The usual instructions apply... Place this file in a directory on +;;; your `load-path' and then add (require 'man-addons) to your +;;; `user-init-file'. +;;; +;;; This is tested in XEmacs 21 with both the native XEmacs man.el and +;;; one I ported from GNU Emacs. I hope it works equally well for GNU +;;; Emacs users. +;;; +;;; After loading this file, when you have man page source files +;;; visible from a `dired' buffer, you can push `l' when the cursor is +;;; over them, and preview the page in man mode. I find this very +;;; helpful while editting manual pages! +;;; + +;;;###autoload +(defun dired-man-locally () + "From a dired buffer, view the man page file at point, using \"man + -l file\"." + (interactive) + (if (= 1 (function-max-args #'manual-entry)) + (manual-entry (concat (dired-get-filename) " -l")) + (manual-entry (dired-get-filename) "-l"))) + +;;;###autoload +(add-hook 'dired-setup-keys-hook + #'(lambda () + (define-key dired-mode-map [(?l)] #'dired-man-locally))) + +(require 'thingatpt) + +;;;###autoload +(defun man-locally-at-point () + "From any buffer, view the man page file at point, using \"man -l + file\". This is useful when you use `view-file' to visit one of the + .list files in /var/lib/dpkg/info -- put the cursor over a man page + listed there, and use `M-x man-locally-at-point' to view it." + (interactive) + (let ((manpage (thing-at-point 'filename))) + (if (= 1 (function-max-args #'manual-entry)) + (manual-entry (concat manpage " -l")) + (manual-entry manpage "-l")))) + +(provide 'man-addons) |