mirror of
https://git.savannah.gnu.org/git/emacs.git
synced 2024-12-01 08:17:38 +00:00
ecf08f0621
dc4e6b1329; Update copyright years in more files64b3777631; Run set-copyright from admin.el8e1c56ae46; Add 2024 to copyright years # Conflicts: # doc/misc/modus-themes.org # doc/misc/texinfo.tex # etc/NEWS # etc/refcards/ru-refcard.tex # etc/themes/modus-operandi-theme.el # etc/themes/modus-themes.el # etc/themes/modus-vivendi-theme.el # lib/alloca.in.h # lib/binary-io.h # lib/c-ctype.h # lib/c-strcasecmp.c # lib/c-strncasecmp.c # lib/careadlinkat.c # lib/cloexec.c # lib/close-stream.c # lib/diffseq.h # lib/dup2.c # lib/filemode.h # lib/fpending.c # lib/fpending.h # lib/fsusage.c # lib/getgroups.c # lib/getloadavg.c # lib/gettext.h # lib/gettime.c # lib/gettimeofday.c # lib/group-member.c # lib/malloc.c # lib/md5-stream.c # lib/md5.c # lib/md5.h # lib/memmem.c # lib/memrchr.c # lib/nanosleep.c # lib/save-cwd.h # lib/sha1.c # lib/sig2str.c # lib/stdlib.in.h # lib/strtoimax.c # lib/strtol.c # lib/strtoll.c # lib/time_r.c # lib/xalloc-oversized.h # lisp/auth-source-pass.el # lisp/emacs-lisp/lisp-mnt.el # lisp/emacs-lisp/timer.el # lisp/info-look.el # lisp/jit-lock.el # lisp/loadhist.el # lisp/mail/rmail.el # lisp/net/ntlm.el # lisp/net/webjump.el # lisp/progmodes/asm-mode.el # lisp/progmodes/project.el # lisp/progmodes/sh-script.el # lisp/textmodes/flyspell.el # lisp/textmodes/reftex-toc.el # lisp/textmodes/reftex.el # lisp/textmodes/tex-mode.el # lisp/url/url-gw.el # m4/alloca.m4 # m4/clock_time.m4 # m4/d-type.m4 # m4/dirent_h.m4 # m4/dup2.m4 # m4/euidaccess.m4 # m4/fchmodat.m4 # m4/filemode.m4 # m4/fsusage.m4 # m4/getgroups.m4 # m4/getloadavg.m4 # m4/getrandom.m4 # m4/gettime.m4 # m4/gettimeofday.m4 # m4/gnulib-common.m4 # m4/group-member.m4 # m4/inttypes.m4 # m4/malloc.m4 # m4/manywarnings.m4 # m4/mempcpy.m4 # m4/memrchr.m4 # m4/mkostemp.m4 # m4/mktime.m4 # m4/nproc.m4 # m4/nstrftime.m4 # m4/pathmax.m4 # m4/pipe2.m4 # m4/pselect.m4 # m4/pthread_sigmask.m4 # m4/readlink.m4 # m4/realloc.m4 # m4/sig2str.m4 # m4/ssize_t.m4 # m4/stat-time.m4 # m4/stddef_h.m4 # m4/stdint.m4 # m4/stdio_h.m4 # m4/stdlib_h.m4 # m4/stpcpy.m4 # m4/strnlen.m4 # m4/strtoimax.m4 # m4/strtoll.m4 # m4/time_h.m4 # m4/timegm.m4 # m4/timer_time.m4 # m4/timespec.m4 # m4/unistd_h.m4 # m4/warnings.m4 # nt/configure.bat # nt/preprep.c # test/lisp/register-tests.el
419 lines
14 KiB
EmacsLisp
419 lines
14 KiB
EmacsLisp
;;; pcmpl-gnu.el --- completions for GNU project tools -*- lexical-binding: t -*-
|
|
|
|
;; Copyright (C) 1999-2024 Free Software Foundation, Inc.
|
|
|
|
;; Package: pcomplete
|
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
;; GNU Emacs 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.
|
|
|
|
;; GNU Emacs 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 GNU Emacs. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
;;; Commentary:
|
|
|
|
;;; Code:
|
|
|
|
(provide 'pcmpl-gnu)
|
|
|
|
(require 'pcomplete)
|
|
(require 'pcmpl-unix)
|
|
|
|
(defgroup pcmpl-gnu nil
|
|
"Completions for GNU project tools."
|
|
:group 'pcomplete)
|
|
|
|
;; User Variables:
|
|
|
|
(defcustom pcmpl-gnu-makefile-regexps
|
|
'("\\`GNUmakefile" "\\`[Mm]akefile" "\\.ma?k\\'")
|
|
"A list of regexps that will match Makefile names."
|
|
:type '(repeat regexp))
|
|
|
|
(defcustom pcmpl-gnu-makefile-includes t
|
|
"If non-nil, `pcomplete/make' completes on targets in included files."
|
|
:type 'boolean
|
|
:version "27.1"
|
|
:safe 'booleanp)
|
|
|
|
;; Functions:
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/gzip ()
|
|
"Completion for `gzip'."
|
|
(let ((pcomplete-help "(gzip)"))
|
|
(pcomplete-opt "cdfhlLnNqrStvV123456789")
|
|
(while (pcomplete-here
|
|
(pcmpl-gnu-zipped-files
|
|
(catch 'has-d-flag
|
|
(let ((args pcomplete-args))
|
|
(while args
|
|
(if (string-match "\\`-.*[dt]" (car args))
|
|
(throw 'has-d-flag t))
|
|
(setq args (cdr args))))))))))
|
|
|
|
(defun pcmpl-gnu-zipped-files (unzip-p)
|
|
"Find all zipped or unzipped files: the inverse of UNZIP-P."
|
|
(pcomplete-entries
|
|
nil
|
|
(lambda (entry)
|
|
(or (file-directory-p entry)
|
|
(when (and (file-readable-p entry)
|
|
(file-regular-p entry))
|
|
(let ((zipped (string-match "\\.\\(t?gz\\|\\(ta\\)?Z\\)\\'"
|
|
entry)))
|
|
(or (and unzip-p zipped)
|
|
(and (not unzip-p) (not zipped)))))))))
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/bzip2 ()
|
|
"Completion for `bzip2'."
|
|
(pcomplete-opt "hdzkftcqvLVs123456789")
|
|
(while (pcomplete-here
|
|
(pcmpl-gnu-bzipped-files
|
|
(catch 'has-d-flag
|
|
(let ((args pcomplete-args))
|
|
(while args
|
|
(if (string-match "\\`-.*[dt]" (car args))
|
|
(throw 'has-d-flag t))
|
|
(setq args (cdr args)))))))))
|
|
|
|
(defun pcmpl-gnu-bzipped-files (unzip-p)
|
|
"Find all zipped or unzipped files: the inverse of UNZIP-P."
|
|
(pcomplete-entries
|
|
nil
|
|
(lambda (entry)
|
|
(when (and (file-readable-p entry)
|
|
(file-regular-p entry))
|
|
(let ((zipped (string-match "\\.\\(t?z2\\|bz2\\)\\'" entry)))
|
|
(or (and unzip-p zipped)
|
|
(and (not unzip-p) (not zipped))))))))
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/make ()
|
|
"Completion for GNU `make'."
|
|
(let ((pcomplete-help "(make)Top"))
|
|
(pcomplete-opt "bmC/def(pcmpl-gnu-makefile-names)hiI/j?kl?no.pqrsStvwW.")
|
|
(while (pcomplete-here (completion-table-in-turn
|
|
(pcmpl-gnu-make-rule-names)
|
|
(pcomplete-entries))
|
|
nil #'identity))))
|
|
|
|
(defun pcmpl-gnu-makefile-names ()
|
|
"Return a list of possible makefile names."
|
|
(pcomplete-entries (mapconcat 'identity pcmpl-gnu-makefile-regexps "\\|")))
|
|
|
|
(defun pcmpl-gnu-make-targets (targets)
|
|
"Add to TARGETS the list of makefile targets in the current buffer.
|
|
Return the new list."
|
|
(goto-char (point-min))
|
|
(while (re-search-forward
|
|
"^\\([^\t\n#%.$][^:=\n]*\\)\\s-*:[^=]" nil t)
|
|
(setq targets (nconc (split-string (match-string-no-properties 1))
|
|
targets)))
|
|
targets)
|
|
|
|
(defun pcmpl-gnu-make-includes ()
|
|
"Return a list of all included file names in the current buffer."
|
|
(let (filenames)
|
|
(goto-char (point-min))
|
|
(while (search-forward-regexp "^include +\\(.*\\)$" nil t)
|
|
(push (match-string-no-properties 1) filenames))
|
|
filenames))
|
|
|
|
(defun pcmpl-gnu-make-all-targets (makefile targets)
|
|
"Add to TARGETS the list of target names in MAKEFILE and files it includes.
|
|
Return the new list."
|
|
(with-temp-buffer
|
|
(with-demoted-errors "Error inserting makefile: %S"
|
|
(insert-file-contents makefile))
|
|
|
|
(let ((filenames (when pcmpl-gnu-makefile-includes (pcmpl-gnu-make-includes))))
|
|
(setq targets (pcmpl-gnu-make-targets targets))
|
|
(dolist (file filenames)
|
|
(when (file-readable-p file)
|
|
(setq targets (pcmpl-gnu-make-all-targets file targets))))
|
|
))
|
|
targets)
|
|
|
|
(defun pcmpl-gnu-make-rule-names ()
|
|
"Return a list of possible make targets in a makefile in the current directory."
|
|
(let* ((minus-f (member "-f" pcomplete-args))
|
|
(makefile (or (cadr minus-f)
|
|
(cond
|
|
((file-exists-p "GNUmakefile") "GNUmakefile")
|
|
((file-exists-p "makefile") "makefile")
|
|
(t "Makefile"))))
|
|
rules)
|
|
(if (not (file-readable-p makefile))
|
|
(unless minus-f (list "-f"))
|
|
(setq rules (pcmpl-gnu-make-all-targets makefile rules))
|
|
(pcomplete-uniquify-list rules))))
|
|
|
|
(defcustom pcmpl-gnu-tarfile-regexp
|
|
"\\.t\\(ar\\(\\.\\(gz\\|bz2\\|Z\\|xz\\)\\)?\\|gz\\|a[zZ]\\|z2\\)\\'"
|
|
"A regexp which matches any tar archive."
|
|
:version "24.3" ; added xz
|
|
:type 'regexp)
|
|
|
|
;; Only used in tar-mode buffers.
|
|
(defvar tar-parse-info)
|
|
(declare-function tar-header-name "tar-mode" t t)
|
|
|
|
(defmacro pcmpl-gnu-with-file-buffer (file &rest body)
|
|
"Run BODY inside a buffer visiting FILE."
|
|
(declare (debug t) (indent 1))
|
|
(let ((exist (make-symbol "exist"))
|
|
(filesym (make-symbol "file"))
|
|
(buf (make-symbol "buf")))
|
|
`(let* ((,filesym ,file)
|
|
(,exist (find-buffer-visiting ,filesym))
|
|
(,buf (or ,exist (find-file-noselect ,filesym))))
|
|
(unwind-protect
|
|
(with-current-buffer ,buf
|
|
,@body)
|
|
(when (and (not ,exist) (buffer-live-p ,buf))
|
|
(kill-buffer ,buf))))))
|
|
|
|
(defvar pcmpl-gnu--tar-long-options
|
|
;; FIXME: Extract this list from "tar --help".
|
|
'("--absolute-names"
|
|
"--after-date="
|
|
"--append"
|
|
"--atime-preserve"
|
|
"--backup"
|
|
"--block-number"
|
|
"--blocking-factor="
|
|
"--catenate"
|
|
"--checkpoint"
|
|
"--compare"
|
|
"--compress"
|
|
"--concatenate"
|
|
"--confirmation"
|
|
"--create"
|
|
"--delete"
|
|
"--dereference"
|
|
"--diff"
|
|
"--directory="
|
|
"--exclude="
|
|
"--exclude-from="
|
|
"--extract"
|
|
"--file="
|
|
"--files-from="
|
|
"--force-local"
|
|
"--get"
|
|
"--group="
|
|
"--gzip"
|
|
"--help"
|
|
"--ignore-failed-read"
|
|
"--ignore-zeros"
|
|
"--incremental"
|
|
"--info-script="
|
|
"--interactive"
|
|
"--keep-old-files"
|
|
"--label="
|
|
"--list"
|
|
"--listed-incremental"
|
|
"--mode="
|
|
"--modification-time"
|
|
"--multi-volume"
|
|
"--new-volume-script="
|
|
"--newer="
|
|
"--newer-mtime"
|
|
"--no-recursion"
|
|
"--null"
|
|
"--numeric-owner"
|
|
"--old-archive"
|
|
"--one-file-system"
|
|
"--owner="
|
|
"--portability"
|
|
"--posix"
|
|
"--preserve"
|
|
"--preserve-order"
|
|
"--preserve-permissions"
|
|
"--read-full-records"
|
|
"--record-size="
|
|
"--recursive-unlink"
|
|
"--remove-files"
|
|
"--rsh-command="
|
|
"--same-order"
|
|
"--same-owner"
|
|
"--same-permissions"
|
|
"--sparse"
|
|
"--starting-file="
|
|
"--suffix="
|
|
"--tape-length="
|
|
"--to-stdout"
|
|
"--totals"
|
|
"--uncompress"
|
|
"--ungzip"
|
|
"--unlink-first"
|
|
"--update"
|
|
"--use-compress-program="
|
|
"--verbose"
|
|
"--verify"
|
|
"--version"
|
|
"--volno-file="))
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/tar ()
|
|
"Completion for the GNU tar utility."
|
|
;; options that end in an equal sign will want further completion...
|
|
(let (saw-option complete-within)
|
|
(while (pcomplete-match "^-" 0)
|
|
(setq saw-option t)
|
|
(if (pcomplete-match "^--" 0)
|
|
(cond
|
|
((pcomplete-match "^--\\([^= \t\n\f]*\\)\\'" 0)
|
|
(pcomplete-here* pcmpl-gnu--tar-long-options))
|
|
((pcomplete-match "\\`--directory=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcomplete-dirs)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--exclude-from=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcomplete-entries)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--\\(extract\\|list\\)\\'" 0)
|
|
(setq complete-within t))
|
|
((pcomplete-match "\\`--file=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcomplete-dirs-or-entries
|
|
pcmpl-gnu-tarfile-regexp)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--files-from=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcomplete-entries)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--group=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcmpl-unix-group-names)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--info-script=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcomplete-entries)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--new-volume-script=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcomplete-entries)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--owner=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcmpl-unix-user-names)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--rsh-command=\\(.*\\)" 0)
|
|
(pcomplete-here* (funcall pcomplete-command-completion-function)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--starting-file=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcomplete-entries)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--use-compress-program=\\(.*\\)" 0)
|
|
(pcomplete-here* (funcall pcomplete-command-completion-function)
|
|
(pcomplete-match-string 1 0)))
|
|
((pcomplete-match "\\`--volno-file=\\(.*\\)" 0)
|
|
(pcomplete-here* (pcomplete-entries)
|
|
(pcomplete-match-string 1 0)))
|
|
(t
|
|
(pcomplete-here*)))
|
|
(pcomplete-opt "01234567ABCFGKLMNOPRSTUVWXZbcdfghiklmoprstuvwxz")
|
|
(when (pcomplete-match "\\`-\\'" 0)
|
|
(pcomplete-here*))))
|
|
(unless saw-option
|
|
(pcomplete-here
|
|
(mapcar #'char-to-string
|
|
(string-to-list
|
|
"01234567ABCFGIKLMNOPRSTUVWXZbcdfghiklmoprstuvwxz")))
|
|
(if (pcomplete-match "[xt]" 'first 1)
|
|
(setq complete-within t)))
|
|
(pcomplete-here (pcomplete-dirs-or-entries pcmpl-gnu-tarfile-regexp))
|
|
(while (pcomplete-here
|
|
(if (and complete-within
|
|
(let* ((fa (file-attributes (pcomplete-arg 1)))
|
|
(size (file-attribute-size fa)))
|
|
(and (numberp size)
|
|
(or (null large-file-warning-threshold)
|
|
(< size large-file-warning-threshold)))))
|
|
(let ((file (pcomplete-arg 1)))
|
|
(completion-table-dynamic
|
|
(lambda (_string)
|
|
(pcmpl-gnu-with-file-buffer
|
|
file (mapcar #'tar-header-name tar-parse-info)))))
|
|
(pcomplete-entries))
|
|
nil #'identity))))
|
|
|
|
;;;###autoload
|
|
|
|
(defun pcomplete/find ()
|
|
"Completion for the GNU find utility."
|
|
(let ((prec (pcomplete-arg 'last -1)))
|
|
(cond ((and (pcomplete-match "^-" 'last)
|
|
(string= "find" prec))
|
|
(pcomplete-opt "HLPDO"))
|
|
((pcomplete-match "^-" 'last)
|
|
(while (pcomplete-here
|
|
'("-amin" "-anewer" "-atime" "-cmin" "-cnewer" "-context"
|
|
"-ctime" "-daystart" "-delete" "-depth" "-empty" "-exec"
|
|
"-execdir" "-executable" "-false" "-fls" "-follow"
|
|
"-fprint" "-fprint0" "-fprintf" "-fstype" "-gid" "-group"
|
|
"-help" "-ignore_readdir_race" "-ilname" "-iname"
|
|
"-inum" "-ipath" "-iregex" "-iwholename"
|
|
"-links" "-lname" "-ls" "-maxdepth"
|
|
"-mindepth" "-mmin" "-mount" "-mtime"
|
|
"-name" "-newer" "-nogroup" "-noignore_readdir_race"
|
|
"-noleaf" "-nouser" "-nowarn" "-ok"
|
|
"-okdir" "-path" "-perm" "-print"
|
|
"-print0" "-printf" "-prune" "-quit"
|
|
"-readable" "-regex" "-regextype" "-samefile"
|
|
"-size" "-true" "-type" "-uid"
|
|
"-used" "-user" "-version" "-warn"
|
|
"-wholename" "-writable" "-xdev" "-xtype"))))
|
|
((string= "-type" prec)
|
|
(while (pcomplete-here (list "b" "c" "d" "p" "f" "l" "s" "D"))))
|
|
((string= "-xtype" prec)
|
|
(while (pcomplete-here (list "b" "c" "d" "p" "f" "l" "s"))))
|
|
((or (string= prec "-exec")
|
|
(string= prec "-execdir"))
|
|
(while (pcomplete-here* (funcall pcomplete-command-completion-function)
|
|
(pcomplete-arg 'last) t))))
|
|
(while (pcomplete-here (pcomplete-dirs) nil #'identity))))
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/awk ()
|
|
"Completion for the `awk' command."
|
|
(pcomplete-here-using-help "awk --help"
|
|
:margin "\t"
|
|
:separator " +"
|
|
:description "\0"
|
|
:metavar "[=a-z]+"))
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/gpg ()
|
|
"Completion for the `gpg` command."
|
|
(pcomplete-here-using-help "gpg --help" :narrow-end "^ -se"))
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/gdb ()
|
|
"Completion for the `gdb' command."
|
|
(while
|
|
(cond
|
|
((string= "--args" (pcomplete-arg 1))
|
|
(funcall pcomplete-command-completion-function)
|
|
(funcall (or (pcomplete-find-completion-function (pcomplete-arg 1))
|
|
pcomplete-default-completion-function)))
|
|
((string-prefix-p "-" (pcomplete-arg 0))
|
|
(pcomplete-here (pcomplete-from-help "gdb --help")))
|
|
(t (pcomplete-here (pcomplete-entries))))))
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/emacs ()
|
|
"Completion for the `emacs' command."
|
|
(pcomplete-here-using-help "emacs --help" :margin "^\\(\\)-"))
|
|
|
|
;;;###autoload
|
|
(defun pcomplete/emacsclient ()
|
|
"Completion for the `emacsclient' command."
|
|
(pcomplete-here-using-help "emacsclient --help" :margin "^\\(\\)-"))
|
|
|
|
;;; pcmpl-gnu.el ends here
|