* processes.texi (Accepting Output): Discourage use of `millisec' argument.
[emacs.git] / lisp / version.el
blobbd30f0f81b8ca642e8772d16e0ebb089ff125b6f
1 ;;; version.el --- record version number of Emacs
3 ;; Copyright (C) 1985, 1992, 1994-1995, 1999-2012
4 ;; Free Software Foundation, Inc.
6 ;; Maintainer: FSF
7 ;; Keywords: internal
8 ;; Package: emacs
10 ;; This file is part of GNU Emacs.
12 ;; GNU Emacs is free software: you can redistribute it and/or modify
13 ;; it under the terms of the GNU General Public License as published by
14 ;; the Free Software Foundation, either version 3 of the License, or
15 ;; (at your option) any later version.
17 ;; GNU Emacs is distributed in the hope that it will be useful,
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 ;; GNU General Public License for more details.
22 ;; You should have received a copy of the GNU General Public License
23 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
25 ;;; Commentary:
27 ;; This file is loaded uncompiled when dumping Emacs.
28 ;; Doc-strings should adhere to the conventions of make-docfile.
30 ;;; Code:
32 (defconst emacs-major-version (progn (string-match "^[0-9]+" emacs-version) (string-to-number (match-string 0 emacs-version))) "\
33 Major version number of this version of Emacs.
34 This variable first existed in version 19.23.")
36 (defconst emacs-minor-version (progn (string-match "^[0-9]+\\.\\([0-9]+\\)" emacs-version) (string-to-number (match-string 1 emacs-version))) "\
37 Minor version number of this version of Emacs.
38 This variable first existed in version 19.23.")
40 (defconst emacs-build-time (current-time) "\
41 Time at which Emacs was dumped out.")
43 (defconst emacs-build-system (system-name) "\
44 Name of the system on which Emacs was built.")
46 (defun emacs-version (&optional here) "\
47 Return string describing the version of Emacs that is running.
48 If optional argument HERE is non-nil, insert string at point.
49 Don't use this function in programs to choose actions according
50 to the system configuration; look at `system-configuration' instead."
51 (interactive "P")
52 (let ((version-string
53 (format (if (not (called-interactively-p 'interactive))
54 "GNU Emacs %s (%s%s%s)\n of %s on %s"
55 "GNU Emacs %s (%s%s%s) of %s on %s")
56 emacs-version
57 system-configuration
58 (cond ((featurep 'motif)
59 (concat ", " (substring motif-version-string 4)))
60 ((featurep 'gtk)
61 (concat ", GTK+ Version " gtk-version-string))
62 ((featurep 'x-toolkit) ", X toolkit")
63 ((featurep 'ns)
64 (format ", NS %s" ns-version-string))
65 (t ""))
66 (if (and (boundp 'x-toolkit-scroll-bars)
67 (memq x-toolkit-scroll-bars '(xaw xaw3d)))
68 (format ", %s scroll bars"
69 (capitalize (symbol-name x-toolkit-scroll-bars)))
70 "")
71 (format-time-string "%Y-%m-%d" emacs-build-time)
72 emacs-build-system)))
73 (if here
74 (insert version-string)
75 (if (called-interactively-p 'interactive)
76 (message "%s" version-string)
77 version-string))))
79 ;; We hope that this alias is easier for people to find.
80 (defalias 'version 'emacs-version)
82 ;; We put version info into the executable in the form that `ident' uses.
83 (or (eq system-type 'windows-nt)
84 (purecopy (concat "\n$Id: " (subst-char-in-string ?\n ?\s (emacs-version))
85 " $\n")))
87 ;; Local Variables:
88 ;; version-control: never
89 ;; no-byte-compile: t
90 ;; End:
92 ;;; version.el ends here