(menu-bar-help-menu): Change menu-item "Show Emacs Version" to "About
[bpt/emacs.git] / lisp / menu-bar.el
CommitLineData
55535639 1;;; menu-bar.el --- define a default menu bar
235aa29b 2
25fe14a0 3;; Copyright (C) 1993, 1994, 1995, 2000, 2001, 2002 Free Software Foundation, Inc.
b578f267 4
235aa29b 5;; Author: RMS
e4874521 6;; Maintainer: FSF
dbcee71a 7;; Keywords: internal, mouse
235aa29b 8
1db87953
RS
9;; This file is part of GNU Emacs.
10
11;; GNU Emacs is free software; you can redistribute it and/or modify
12;; it under the terms of the GNU General Public License as published by
13;; the Free Software Foundation; either version 2, or (at your option)
14;; any later version.
15
16;; GNU Emacs is distributed in the hope that it will be useful,
17;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19;; GNU General Public License for more details.
20
21;; You should have received a copy of the GNU General Public License
b578f267
EN
22;; along with GNU Emacs; see the file COPYING. If not, write to the
23;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24;; Boston, MA 02111-1307, USA.
1db87953 25
260130bb
KH
26;; Avishai Yacobi suggested some menu rearrangements.
27
55535639
PJ
28;;; Commentary:
29
b578f267
EN
30;;; Code:
31
d537086b
RS
32;;; User options:
33
30e19aee 34(defcustom buffers-menu-max-size 10
d537086b
RS
35 "*Maximum number of entries which may appear on the Buffers menu.
36If this is 10, then only the ten most-recently-selected buffers are shown.
37If this is nil, then all buffers are shown.
30e19aee
RS
38A large number or nil slows down menu responsiveness."
39 :type '(choice integer
40 (const :tag "All" nil))
41 :group 'mouse)
d537086b 42
b132f2b1
RM
43;; Don't clobber an existing menu-bar keymap, to preserve any menu-bar key
44;; definitions made in loaddefs.el.
45(or (lookup-key global-map [menu-bar])
46 (define-key global-map [menu-bar] (make-sparse-keymap "menu-bar")))
22390f50 47(defvar menu-bar-help-menu (make-sparse-keymap "Help"))
ffbdd83d
RS
48
49;; Force Help item to come last, after the major mode's own items.
0d31efcd
KH
50;; The symbol used to be called `help', but that gets confused with the
51;; help key.
52(setq menu-bar-final-items '(help-menu))
ffbdd83d 53
0d31efcd 54(define-key global-map [menu-bar help-menu] (cons "Help" menu-bar-help-menu))
ffbdd83d
RS
55(defvar menu-bar-tools-menu (make-sparse-keymap "Tools"))
56(define-key global-map [menu-bar tools] (cons "Tools" menu-bar-tools-menu))
7f315c7c
EZ
57;; This definition is just to show what this looks like.
58;; It gets overridden below when menu-bar-update-buffers is called.
59(define-key global-map [menu-bar buffer]
60 (cons "Buffers" (make-sparse-keymap "Buffers")))
61(defvar menu-bar-options-menu (make-sparse-keymap "Options"))
62(define-key global-map [menu-bar options]
63 (cons "Options" menu-bar-options-menu))
64(defvar menu-bar-edit-menu (make-sparse-keymap "Edit"))
65(define-key global-map [menu-bar edit] (cons "Edit" menu-bar-edit-menu))
66(defvar menu-bar-files-menu (make-sparse-keymap "File"))
67(define-key global-map [menu-bar files] (cons "File" menu-bar-files-menu))
1b009b97
RS
68
69;; This alias is for compatibility with 19.28 and before.
70(defvar menu-bar-file-menu menu-bar-files-menu)
9bb8e471 71\f
7f315c7c 72;; The "File" menu items
ffbdd83d 73(define-key menu-bar-files-menu [exit-emacs]
7f315c7c
EZ
74 '(menu-item "Exit Emacs" save-buffers-kill-emacs
75 :help "Save unsaved buffers, then exit"))
ffbdd83d
RS
76
77(define-key menu-bar-files-menu [separator-exit]
78 '("--"))
79
7f315c7c
EZ
80;; Don't use delete-frame as event name because that is a special
81;; event.
82(define-key menu-bar-files-menu [delete-this-frame]
83 '(menu-item "Delete Frame" delete-frame
84 :visible (fboundp 'delete-frame)
85 :enable (delete-frame-enabled-p)
86 :help "Delete currently selected frame"))
87(define-key menu-bar-files-menu [make-frame-on-display]
88 '(menu-item "New Frame on Display..." make-frame-on-display
89 :visible (fboundp 'make-frame-on-display)
90 :help "Open a new frame on another display"))
91(define-key menu-bar-files-menu [make-frame]
92 '(menu-item "New Frame" make-frame-command
93 :visible (fboundp 'make-frame-command)
94 :help "Open a new frame"))
95
ffbdd83d 96(define-key menu-bar-files-menu [one-window]
7f315c7c
EZ
97 '(menu-item "Unsplit Windows" delete-other-windows
98 :enable (not (one-window-p t nil))
99 :help "Make selected window fill its frame"))
ffbdd83d
RS
100
101(define-key menu-bar-files-menu [split-window]
7f315c7c
EZ
102 '(menu-item "Split Window" split-window-vertically
103 :help "Split selected window in two"))
104
105(define-key menu-bar-files-menu [separator-window]
106 '(menu-item "--"))
107
108(define-key menu-bar-files-menu [ps-print-region]
438c2df0
GM
109 '(menu-item "Postscript Print Region (B+W)" ps-print-region
110 :enable mark-active
111 :help "Pretty-print marked region in black and white to PostScript printer"))
112(define-key menu-bar-files-menu [ps-print-buffer]
113 '(menu-item "Postscript Print Buffer (B+W)" ps-print-buffer
114 :help "Pretty-print current buffer in black and white to PostScript printer"))
115(define-key menu-bar-files-menu [ps-print-region-faces]
7f315c7c
EZ
116 '(menu-item "Postscript Print Region" ps-print-region-with-faces
117 :enable mark-active
118 :help "Pretty-print marked region to PostScript printer"))
438c2df0 119(define-key menu-bar-files-menu [ps-print-buffer-faces]
7f315c7c
EZ
120 '(menu-item "Postscript Print Buffer" ps-print-buffer-with-faces
121 :help "Pretty-print current buffer to PostScript printer"))
122(define-key menu-bar-files-menu [print-region]
123 '(menu-item "Print Region" print-region
124 :enable mark-active
125 :help "Print region between mark and current position"))
126(define-key menu-bar-files-menu [print-buffer]
127 '(menu-item "Print Buffer" print-buffer
128 :help "Print current buffer with page headings"))
129
130(define-key menu-bar-files-menu [separator-print]
131 '(menu-item "--"))
9bb8e471 132
f3e1e0dd 133(define-key menu-bar-files-menu [recover-session]
7f315c7c
EZ
134 '(menu-item "Recover Crashed Session..." recover-session
135 :enable (and auto-save-list-file-prefix
db3ca487
NF
136 (file-directory-p
137 (file-name-directory auto-save-list-file-prefix))
138 (directory-files
7f315c7c
EZ
139 (file-name-directory auto-save-list-file-prefix)
140 nil
141 (concat "\\`"
142 (regexp-quote
143 (file-name-nondirectory
144 auto-save-list-file-prefix)))
145 t))
146 :help "Recover edits from a crashed session"))
ffbdd83d 147(define-key menu-bar-files-menu [revert-buffer]
7f315c7c
EZ
148 '(menu-item "Revert Buffer" revert-buffer
149 :enable (or revert-buffer-function
150 revert-buffer-insert-file-contents-function
151 (and (buffer-file-name)
152 (or (buffer-modified-p)
153 (not (verify-visited-file-modtime
154 (current-buffer))))))
155 :help "Re-read current buffer from its file"))
ffbdd83d 156(define-key menu-bar-files-menu [write-file]
7f315c7c
EZ
157 '(menu-item "Save Buffer As..." write-file
158 :enable (not (window-minibuffer-p
159 (frame-selected-window menu-updating-frame)))
160 :help "Write current buffer to another file"))
161(define-key menu-bar-files-menu [save-buffer]
162 '(menu-item "Save (current buffer)" save-buffer
163 :enable (and (buffer-modified-p)
7a98d821 164 (buffer-file-name)
7f315c7c
EZ
165 (not (window-minibuffer-p
166 (frame-selected-window menu-updating-frame))))
167 :help "Save current buffer to its file"))
168
169(define-key menu-bar-files-menu [separator-save]
170 '(menu-item "--"))
171
172(define-key menu-bar-files-menu [kill-buffer]
173 '(menu-item "Close (current buffer)" kill-this-buffer
174 :enable (kill-this-buffer-enabled-p)
ae65cd84 175 :help "Discard current buffer"))
7f315c7c
EZ
176(define-key menu-bar-files-menu [insert-file]
177 '(menu-item "Insert File..." insert-file
178 :enable (not (window-minibuffer-p
179 (frame-selected-window menu-updating-frame)))
180 :help "Insert another file into current buffer"))
181(define-key menu-bar-files-menu [dired]
182 '(menu-item "Open Directory..." dired
183 :help "Read a directory, operate on its files"))
184(define-key menu-bar-files-menu [open-file]
185 '(menu-item "Open File..." find-file
186 :enable (not (window-minibuffer-p
187 (frame-selected-window menu-updating-frame)))
188 :help "Read a file into an Emacs buffer"))
189
9bb8e471 190\f
7f315c7c 191;; The "Edit" menu items
ffbdd83d
RS
192(defun nonincremental-search-forward (string)
193 "Read a string and search for it nonincrementally."
194 (interactive "sSearch for string: ")
195 (if (equal string "")
196 (search-forward (car search-ring))
197 (isearch-update-ring string nil)
198 (search-forward string)))
199
200(defun nonincremental-search-backward (string)
201 "Read a string and search backward for it nonincrementally."
202 (interactive "sSearch for string: ")
203 (if (equal string "")
204 (search-backward (car search-ring))
205 (isearch-update-ring string nil)
206 (search-backward string)))
207
208(defun nonincremental-re-search-forward (string)
209 "Read a regular expression and search for it nonincrementally."
210 (interactive "sSearch for regexp: ")
211 (if (equal string "")
212 (re-search-forward (car regexp-search-ring))
213 (isearch-update-ring string t)
214 (re-search-forward string)))
215
216(defun nonincremental-re-search-backward (string)
217 "Read a regular expression and search backward for it nonincrementally."
218 (interactive "sSearch for regexp: ")
219 (if (equal string "")
220 (re-search-backward (car regexp-search-ring))
221 (isearch-update-ring string t)
222 (re-search-backward string)))
223
1f50590a 224(defun nonincremental-repeat-search-forward ()
ffbdd83d
RS
225 "Search forward for the previous search string."
226 (interactive)
008c8493
RS
227 (if (null search-ring)
228 (error "No previous search"))
ffbdd83d
RS
229 (search-forward (car search-ring)))
230
1f50590a 231(defun nonincremental-repeat-search-backward ()
ffbdd83d
RS
232 "Search backward for the previous search string."
233 (interactive)
008c8493
RS
234 (if (null search-ring)
235 (error "No previous search"))
ffbdd83d
RS
236 (search-backward (car search-ring)))
237
1f50590a 238(defun nonincremental-repeat-re-search-forward ()
ffbdd83d
RS
239 "Search forward for the previous regular expression."
240 (interactive)
97565dd9 241 (if (null regexp-search-ring)
008c8493 242 (error "No previous search"))
ffbdd83d
RS
243 (re-search-forward (car regexp-search-ring)))
244
1f50590a 245(defun nonincremental-repeat-re-search-backward ()
ffbdd83d
RS
246 "Search backward for the previous regular expression."
247 (interactive)
97565dd9 248 (if (null regexp-search-ring)
008c8493 249 (error "No previous search"))
ffbdd83d
RS
250 (re-search-backward (car regexp-search-ring)))
251
7f315c7c
EZ
252(defvar menu-bar-search-menu (make-sparse-keymap "Search"))
253(defvar menu-bar-adv-search-menu
254 (make-sparse-keymap "Advanced Search/Replace"))
255
256(define-key menu-bar-adv-search-menu [tags-continue]
257 '(menu-item "Continue Tags Search/Replace" tags-loop-continue
258 :help "Continue last tags search/replace operation"))
259(define-key menu-bar-adv-search-menu [tags-repl]
260 '(menu-item "Replace in all tagged files" tags-query-replace
261 :help "Interactively replace a regexp in all tagged files"))
262(define-key menu-bar-adv-search-menu [tags-srch]
263 '(menu-item "Search in all tagged files" tags-search
264 :help "Search for a regexp in all tagged files"))
265
266(define-key menu-bar-adv-search-menu [separator-tag-search]
267 '(menu-item "--"))
268
269(define-key menu-bar-adv-search-menu [query-replace-regexp]
270 '(menu-item "Replace Regexp..." query-replace-regexp
271 :enable (not buffer-read-only)
272 :help "Replace regular expression, ask about each occurrence"))
273(define-key menu-bar-adv-search-menu [repeat-regexp-back]
274 '(menu-item "Repeat Regexp Backwards"
275 nonincremental-repeat-re-search-backward
276 :enable regexp-search-ring
277 :help "Repeat last regular expression search backwards"))
278(define-key menu-bar-adv-search-menu [repeat-regexp-fwd]
279 '(menu-item "Repeat Regexp" nonincremental-repeat-re-search-forward
280 :enable regexp-search-ring
281 :help "Repeat last regular expression search forward"))
282(define-key menu-bar-adv-search-menu [re-search-backward]
283 '(menu-item "Search Regexp Backwards..." nonincremental-re-search-backward
284 :help "Search backwards for a regular expression"))
285(define-key menu-bar-adv-search-menu [re-search-forward]
286 '(menu-item "Search Regexp..." nonincremental-re-search-forward
287 :help "Search forward for a regular expression"))
288(define-key menu-bar-search-menu [re-search]
289 (list 'menu-item "Advanced Search/Replace" menu-bar-adv-search-menu
290 :help "Regexp and Tags search and replace"))
ffbdd83d 291
7f315c7c
EZ
292(define-key menu-bar-search-menu [query-replace]
293 '(menu-item "Replace..." query-replace
294 :enable (not buffer-read-only)
295 :help "Replace string interactively, ask about each occurrence"))
fe74180c 296(define-key menu-bar-search-menu [repeat-search-back]
7f315c7c
EZ
297 '(menu-item "Repeat Backwards" nonincremental-repeat-search-backward
298 :enable search-ring
299 :help "Repeat last search backwards"))
fe74180c 300(define-key menu-bar-search-menu [repeat-search-fwd]
7f315c7c
EZ
301 '(menu-item "Repeat Search" nonincremental-repeat-search-forward
302 :enable search-ring
303 :help "Repeat last search forward"))
fe74180c 304(define-key menu-bar-search-menu [search-backward]
7f315c7c
EZ
305 '(menu-item "Search Backwards..." nonincremental-search-backward
306 :help "Search backwards for a string"))
fe74180c 307(define-key menu-bar-search-menu [search-forward]
7f315c7c
EZ
308 '(menu-item "Search..." nonincremental-search-forward
309 :help "Search forward for a string"))
9bb8e471 310
7f315c7c
EZ
311;;; Assemble the top-level Edit menu items.
312(define-key menu-bar-edit-menu [props]
313 '(menu-item "Text Properties" facemenu-menu
314 :help "Change properties of text in region"))
3dd92899 315
2eef02ab
EZ
316(define-key menu-bar-edit-menu [fill]
317 '(menu-item "Fill" fill-region
318 :enable (and mark-active (not buffer-read-only))
319 :help
320 "Fill text in region to fit between left and right margin"))
321
322(define-key menu-bar-edit-menu [separator-bookmark]
7f315c7c
EZ
323 '(menu-item "--"))
324
325(define-key menu-bar-edit-menu [bookmark]
326 '(menu-item "Bookmarks" menu-bar-bookmark-map
327 :help "Record positions and jump between them"))
328
7f315c7c
EZ
329(defvar menu-bar-goto-menu (make-sparse-keymap "Go To"))
330
331(define-key menu-bar-goto-menu [set-tags-name]
332 '(menu-item "Set Tags File Name" visit-tags-table
333 :help "Tell Tags commands which tag table file to use"))
334
335(define-key menu-bar-goto-menu [separator-tag-file]
336 '(menu-item "--"))
337
338(define-key menu-bar-goto-menu [apropos-tags]
339 '(menu-item "Tags Apropos" tags-apropos
340 :help "Find function/variables whose names match regexp"))
341(define-key menu-bar-goto-menu [next-tag-otherw]
342 '(menu-item "Next Tag in Other Window"
343 (function (lambda () (find-tag-other-window nil t)))
0ae27881
EZ
344 :enable (and (boundp 'tags-location-ring)
345 (not (ring-empty-p tags-location-ring)))
7f315c7c
EZ
346 :help "Find next function/variable matching last tag name in another window"))
347(define-key menu-bar-goto-menu [next-tag]
348 '(menu-item "Find Next Tag"
349 (function (lambda () (find-tag nil t)))
0ae27881
EZ
350 :enable (and (boundp 'tags-location-ring)
351 (not (ring-empty-p tags-location-ring)))
7f315c7c
EZ
352 :help "Find next function/variable matching last tag name"))
353(define-key menu-bar-goto-menu [find-tag-otherw]
354 '(menu-item "Find Tag in Other Window..." find-tag-other-window
355 :help "Find function/variable definition in another window"))
356(define-key menu-bar-goto-menu [find-tag]
357 '(menu-item "Find Tag..." find-tag
358 :help "Find definition of function or variable"))
359
360(define-key menu-bar-goto-menu [separator-tags]
361 '(menu-item "--"))
362
363(define-key menu-bar-goto-menu [end-of-buf]
364 '(menu-item "Goto End of Buffer" end-of-buffer))
365(define-key menu-bar-goto-menu [beg-of-buf]
366 '(menu-item "Goto Beginning of Buffer" beginning-of-buffer))
367(define-key menu-bar-goto-menu [go-to-pos]
368 '(menu-item "Goto Buffer Position..." goto-char
369 :help "Read a number N and go to buffer position N"))
370(define-key menu-bar-goto-menu [go-to-line]
371 '(menu-item "Goto Line..." goto-line
372 :help "Read a line number and go to that line"))
373
374(define-key menu-bar-edit-menu [goto]
375 (list 'menu-item "Go To" menu-bar-goto-menu))
376
377(define-key menu-bar-edit-menu [search]
378 (list 'menu-item "Search" menu-bar-search-menu))
379
2eef02ab
EZ
380(define-key menu-bar-edit-menu [separator-search]
381 '(menu-item "--"))
382
496b7491
EZ
383(define-key menu-bar-edit-menu [mark-whole-buffer]
384 '(menu-item "Select All" mark-whole-buffer
385 :help "Mark the whole buffer for a subsequent cut/copy."))
7f315c7c
EZ
386(define-key menu-bar-edit-menu [clear]
387 '(menu-item "Clear" delete-region
388 :enable (and mark-active
389 (not buffer-read-only)
390 (not (mouse-region-match)))
391 :help
ae65cd84 392 "Delete the text in region between mark and current position"))
3dd92899
KH
393(defvar yank-menu (cons "Select Yank" nil))
394(fset 'yank-menu (cons 'keymap yank-menu))
7f315c7c
EZ
395(define-key menu-bar-edit-menu [select-paste]
396 '(menu-item "Select and Paste" yank-menu
397 :enable (and (cdr yank-menu) (not buffer-read-only))
19bd58e8 398 :help "Paste (yank) text cut or copied earlier"))
7f315c7c
EZ
399(define-key menu-bar-edit-menu [paste]
400 '(menu-item "Paste" yank
721c26b8
EZ
401 :enable (and
402 ;; Emacs compiled --without-x doesn't have
403 ;; x-selection-exists-p.
404 (fboundp 'x-selection-exists-p)
405 (x-selection-exists-p) (not buffer-read-only))
19bd58e8 406 :help "Paste (yank) text most recently cut/copied"))
7f315c7c
EZ
407(define-key menu-bar-edit-menu [copy]
408 '(menu-item "Copy" menu-bar-kill-ring-save
409 :enable mark-active
84932bf6
SM
410 :help "Copy text in region between mark and current position"
411 :keys "\\[kill-ring-save]"))
7f315c7c
EZ
412(define-key menu-bar-edit-menu [cut]
413 '(menu-item "Cut" kill-region
414 :enable (and mark-active (not buffer-read-only))
ae65cd84
DL
415 :help
416 "Cut (kill) text in region between mark and current position"))
7f315c7c
EZ
417(define-key menu-bar-edit-menu [undo]
418 '(menu-item "Undo" undo
419 :enable (and (not buffer-read-only)
420 (not (eq t buffer-undo-list))
421 (if (eq last-command 'undo)
422 pending-undo-list
423 (consp buffer-undo-list)))
424 :help "Undo last operation"))
425
057d49d1 426
4c0317b1
RS
427(defun menu-bar-kill-ring-save (beg end)
428 (interactive "r")
429 (if (mouse-region-match)
b1a4cc61 430 (message "Selecting a region with the mouse does `copy' automatically")
4c0317b1
RS
431 (kill-ring-save beg end)))
432
9e18f0a0
RS
433(autoload 'ispell-menu-map "ispell" nil t 'keymap)
434
f9cf0be2 435;; These are alternative definitions for the cut, paste and copy
4c0317b1 436;; menu items. Use them if your system expects these to use the clipboard.
f9cf0be2 437
f9cf0be2
RS
438(put 'clipboard-kill-region 'menu-enable 'mark-active)
439(put 'clipboard-kill-ring-save 'menu-enable 'mark-active)
440(put 'clipboard-yank 'menu-enable
721c26b8
EZ
441 '(or (and (fboundp 'x-selection-exists-p) (x-selection-exists-p))
442 (x-selection-exists-p 'CLIPBOARD)))
f9cf0be2
RS
443
444(defun clipboard-yank ()
ee497664 445 "Insert the clipboard contents, or the last stretch of killed text."
f9cf0be2
RS
446 (interactive)
447 (let ((x-select-enable-clipboard t))
448 (yank)))
449
450(defun clipboard-kill-ring-save (beg end)
451 "Copy region to kill ring, and save in the X clipboard."
452 (interactive "r")
453 (let ((x-select-enable-clipboard t))
454 (kill-ring-save beg end)))
455
456(defun clipboard-kill-region (beg end)
457 "Kill the region, and save it in the X clipboard."
458 (interactive "r")
459 (let ((x-select-enable-clipboard t))
460 (kill-region beg end)))
461
462(defun menu-bar-enable-clipboard ()
5cbdeb30
RS
463 "Make CUT, PASTE and COPY (keys and menu bar items) use the clipboard.
464Do the same for the keys of the same name."
f9cf0be2 465 (interactive)
5754d7f2
RS
466 ;; We can't use constant list structure here because it becomes pure,
467 ;; and because it gets modified with cache data.
468 (define-key menu-bar-edit-menu [paste]
7f315c7c 469 (cons "Paste" (cons "Paste text from clipboard" 'clipboard-yank)))
5754d7f2 470 (define-key menu-bar-edit-menu [copy]
7f315c7c
EZ
471 (cons "Copy" (cons "Copy text in region to the clipboard"
472 'clipboard-kill-ring-save)))
5754d7f2 473 (define-key menu-bar-edit-menu [cut]
7f315c7c
EZ
474 (cons "Cut" (cons "Delete text in region and copy it to the clipboard"
475 'clipboard-kill-region)))
5cbdeb30
RS
476
477 (define-key global-map [f20] 'clipboard-kill-region)
478 (define-key global-map [f16] 'clipboard-kill-ring-save)
479 (define-key global-map [f18] 'clipboard-yank)
480 ;; X11R6 versions
481 (define-key global-map [cut] 'clipboard-kill-region)
482 (define-key global-map [copy] 'clipboard-kill-ring-save)
483 (define-key global-map [paste] 'clipboard-yank))
f9cf0be2 484\f
7f315c7c 485;; The "Options" menu items
a9f53ffb 486
25fe14a0
PJ
487;; The "Show/Hide" submenu of menu "Options"
488
489(defvar menu-bar-showhide-menu (make-sparse-keymap "Show/Hide"))
490(defvar menu-bar-showhide-scroll-bar-menu (make-sparse-keymap "Scroll-bar"))
491
492(defun menu-bar-scroll-bar-right ()
493 "Turn on the scroll-bar on the right side."
494 (interactive)
495 (set-scroll-bar-mode 'right))
496
497(defun menu-bar-scroll-bar-left ()
498 "Turn on the scroll-bar on the left side."
499 (interactive)
500 (set-scroll-bar-mode 'left))
501
502(defun menu-bar-scroll-bar-none ()
503 "Turn off the scroll-bar."
504 (interactive)
505 (set-scroll-bar-mode nil))
506
507(define-key menu-bar-showhide-scroll-bar-menu [right]
508 '(menu-item "On the Right" menu-bar-scroll-bar-right
509 :help "Scroll-bar on the right side"
510 :visible window-system
511 :button (:radio . (eq scroll-bar-mode 'right))))
512
513(define-key menu-bar-showhide-scroll-bar-menu [left]
514 '(menu-item "On the Left" menu-bar-scroll-bar-left
515 :help "Scroll-bar on the left side"
516 :visible window-system
517 :button (:radio . (eq scroll-bar-mode 'left))))
518
519(define-key menu-bar-showhide-scroll-bar-menu [none]
520 '(menu-item "None" menu-bar-scroll-bar-none
521 :help "Turn off scroll-bar"
522 :visible window-system
523 :button (:radio . (eq scroll-bar-mode nil))))
524
525(define-key menu-bar-showhide-menu [showhide-scroll-bar]
526 (list 'menu-item "Scroll-Bar" menu-bar-showhide-scroll-bar-menu
a27aa320 527 :visible 'window-system
25fe14a0
PJ
528 :help "Select scroll-bar mode"))
529
530(defun showhide-menu-bar ()
531 "Toggle whether to turn menu-bar on/off."
532 (interactive)
533 (if (menu-bar-mode)
534 (message "Menu-bar mode enabled.")
535 (message "Menu-bar mode disabled. Use M-x menu-bar-mode to make the menu bar appear.")))
536
537(define-key menu-bar-showhide-menu [showhide-menu-bar]
538 '(menu-item "Menu-bar" showhide-menu-bar
539 :help "Toggle menu-bar on/off"
540 :button (:toggle . menu-bar-mode)))
541
542(defun showhide-tool-bar ()
543 "Toggle whether to turn tool-bar on/off."
544 (interactive)
545 (if (tool-bar-mode)
546 (message "Tool-bar mode enabled.")
547 (message "Tool-bar mode disabled.")))
548
549(define-key menu-bar-showhide-menu [showhide-tool-bar]
550 '(menu-item "Tool-bar" showhide-tool-bar
551 :help "Turn tool-bar on/off"
552 :visible window-system
553 :button (:toggle . tool-bar-mode)))
554
555(define-key menu-bar-options-menu [showhide]
556 (list 'menu-item "Show/Hide" menu-bar-showhide-menu
557 :help "Toggle on/off various display features"))
558
559(define-key menu-bar-options-menu [showhide-separator]
560 '("--"))
561
562\f
a9f53ffb
RS
563(defvar menu-bar-custom-menu (make-sparse-keymap "Customize"))
564
b0f661de 565(define-key menu-bar-custom-menu [customize-apropos-groups]
7f315c7c
EZ
566 '(menu-item "Groups Matching Regexp..." customize-apropos-groups
567 :help "Browse groups whose names match regexp"))
b0f661de 568(define-key menu-bar-custom-menu [customize-apropos-faces]
7f315c7c
EZ
569 '(menu-item "Faces Matching Regexp..." customize-apropos-faces
570 :help "Browse faces whose names match regexp"))
b0f661de 571(define-key menu-bar-custom-menu [customize-apropos-options]
7f315c7c
EZ
572 '(menu-item "Options Matching Regexp..." customize-apropos-options
573 :help "Browse options whose names match regexp"))
a9f53ffb 574(define-key menu-bar-custom-menu [customize-apropos]
7f315c7c
EZ
575 '(menu-item "Settings Matching Regexp..." customize-apropos
576 :help "Browse customizable settings whose names match regexp"))
b0f661de
RS
577(define-key menu-bar-custom-menu [separator-2]
578 '("--"))
c9a86e71 579(define-key menu-bar-custom-menu [customize-group]
7f315c7c
EZ
580 '(menu-item "Specific Group..." customize-group
581 :help "Customize settings of specific group"))
a9f53ffb 582(define-key menu-bar-custom-menu [customize-face]
7f315c7c
EZ
583 '(menu-item "Specific Face..." customize-face
584 :help "Customize attributes of specific face"))
b0f661de 585(define-key menu-bar-custom-menu [customize-option]
7f315c7c
EZ
586 '(menu-item "Specific Option..." customize-option
587 :help "Change value of specific option"))
6fe9c658 588(define-key menu-bar-custom-menu [customize-changed-options]
7f315c7c
EZ
589 '(menu-item "Recently Changed Options..." customize-changed-options
590 :help "Customize options changed in recent versions"))
b0f661de
RS
591(define-key menu-bar-custom-menu [separator-3]
592 '("--"))
e6354b3e 593(define-key menu-bar-custom-menu [customize-browse]
7f315c7c
EZ
594 '(menu-item "Browse Customization Groups" customize-browse
595 :help "Browse all customization groups"))
b0f661de 596(define-key menu-bar-custom-menu [customize]
7f315c7c
EZ
597 '(menu-item "Top-level Customization Group" customize
598 :help "The master group called `Emacs'"))
a9f53ffb 599
7f315c7c 600;(defvar menu-bar-preferences-menu (make-sparse-keymap "Preferences"))
bacb2d12 601
7f315c7c 602(defmacro menu-bar-make-toggle (name variable doc message help &rest body)
bacb2d12
RS
603 `(progn
604 (defun ,name ()
e8dd28e7
RS
605 ,(concat "Toggle whether to " (downcase (substring help 0 1))
606 (substring help 1) ".")
bacb2d12
RS
607 (interactive)
608 (if ,(if body `(progn . ,body)
609 `(setq ,variable (not ,variable)))
506c6d61
DL
610 (message ,message "enabled")
611 (message ,message "disabled")))
7f315c7c
EZ
612 '(menu-item ,doc ,name
613 :help ,help
614 :button (:toggle . (and (boundp ',variable) ,variable)))))
615
616;;; Assemble all the top-level items of the "Options" menu
617(define-key menu-bar-options-menu [customize]
618 (list 'menu-item "Customize Emacs" menu-bar-custom-menu
619 :help "Full customization of every Emacs feature"))
10013d74
DL
620
621(defun menu-bar-options-save ()
622 "Save current values of Options menu items using Custom."
623 (interactive)
624 (dolist (elt '(debug-on-quit debug-on-error auto-compression-mode
625 case-fold-search truncate-lines show-paren-mode
626 transient-mark-mode global-font-lock-mode
627 current-language-environment default-input-method))
628 (if (default-value elt)
629 (customize-save-variable elt (default-value elt))))
630 (if (memq 'turn-on-auto-fill text-mode-hook)
631 (customize-save-variable 'text-mode-hook
632 (default-value 'text-mode-hook)))
633 (if (featurep 'saveplace)
634 (customize-save-variable 'save-place (default-value 'save-place)))
635 (if (featurep 'uniquify)
636 (customize-save-variable 'uniquify-buffer-name-style
637 (default-value 'uniquify-buffer-name-style))))
638
639(define-key menu-bar-options-menu [save]
48c9f054 640 '(menu-item "Save Options" menu-bar-options-save
10013d74
DL
641 :help "Save options set from the menu above"))
642
643(define-key menu-bar-options-menu [custom-separator]
644 '("--"))
645
7f315c7c
EZ
646(define-key menu-bar-options-menu [mule]
647 ;; It is better not to use backquote here,
648 ;; because that makes a bootstrapping problem
649 ;; if you need to recompile all the Lisp files using interpreted code.
650 (list 'menu-item "Mule (Multilingual Environment)" mule-menu-keymap
506c6d61
DL
651;; Most of the MULE menu actually does make sense in unibyte mode,
652;; e.g. language selection.
653;;; ':visible 'default-enable-multibyte-characters
7f315c7c
EZ
654 ':help "Default language, encodings, input method"))
655;(setq menu-bar-final-items (cons 'mule menu-bar-final-items))
656;(define-key menu-bar-options-menu [preferences]
657; (list 'menu-item "Preferences" menu-bar-preferences-menu
658; :help "Toggle important global options"))
659
660(define-key menu-bar-options-menu [mule-separator]
506c6d61 661 '("--"))
bacb2d12
RS
662
663(define-key menu-bar-options-menu [debug-on-quit]
664 (menu-bar-make-toggle toggle-debug-on-quit debug-on-quit
e8dd28e7 665 "Enter Debugger on Quit/C-g" "Debug on Quit %s"
7f315c7c 666 "Enter Lisp debugger when C-g is pressed"))
bacb2d12
RS
667(define-key menu-bar-options-menu [debug-on-error]
668 (menu-bar-make-toggle toggle-debug-on-error debug-on-error
e8dd28e7
RS
669 "Enter Debugger on Error" "Debug on Error %s"
670 "Enter Lisp debugger when an error is signaled"))
7f315c7c 671(define-key menu-bar-options-menu [debugger-separator]
bacb2d12 672 '("--"))
7f315c7c
EZ
673(define-key menu-bar-options-menu [toggle-auto-compression]
674 '(menu-item "Automatic File De/compression"
675 auto-compression-mode
676 :help "Transparently decompress compressed files"
677 :button (:toggle . (rassq 'jka-compr-handler
678 file-name-handler-alist))))
bacb2d12
RS
679(define-key menu-bar-options-menu [save-place]
680 (menu-bar-make-toggle toggle-save-place-globally save-place
89f1709f 681 "Save Place in Files between Sessions"
bacb2d12 682 "Saving place in files %s"
7f315c7c 683 "Save Emacs state for next session"
89f1709f 684 (require 'saveplace)
10013d74
DL
685 (setq-default save-place
686 (not (default-value save-place)))))
bacb2d12
RS
687(define-key menu-bar-options-menu [uniquify]
688 (menu-bar-make-toggle toggle-uniquify-buffer-names uniquify-buffer-name-style
89f1709f 689 "Use Directory Names in Buffer Names"
bacb2d12 690 "Directory name in buffer names (uniquify) %s"
e8dd28e7 691 "Uniquify buffer names by adding parent directory names"
bacb2d12
RS
692 (require 'uniquify)
693 (setq uniquify-buffer-name-style
694 (if (not uniquify-buffer-name-style)
695 'forward))))
7f315c7c
EZ
696(define-key menu-bar-options-menu [edit-options-separator]
697 '("--"))
3f51f129
RS
698(define-key menu-bar-options-menu [case-fold-search]
699 (menu-bar-make-toggle toggle-case-fold-search case-fold-search
7f315c7c
EZ
700 "Case-Insensitive Search"
701 "Case-Insensitive Search %s"
e8dd28e7 702 "Ignore letter-case in search"))
7f315c7c
EZ
703(define-key menu-bar-options-menu [auto-fill-mode]
704 '(menu-item "Word Wrap in Text Modes (Auto Fill)"
705 toggle-text-mode-auto-fill
706 :help "Automatically fill text between left and right margins"
707 :button (:toggle . (member 'turn-on-auto-fill text-mode-hook))))
43c35fd7
RS
708(define-key menu-bar-options-menu [truncate-lines]
709 (menu-bar-make-toggle
710 toggle-truncate-lines truncate-lines
506c6d61 711 "Truncate Long Lines in this Buffer" "Long Line Truncation %s"
e8dd28e7 712 "Truncate long lines on the screen"
43c35fd7
RS
713 (prog1 (setq truncate-lines (not truncate-lines))
714 (set-buffer-modified-p (buffer-modified-p)))))
7f315c7c
EZ
715(define-key menu-bar-options-menu [highlight-separator]
716 '("--"))
717(define-key menu-bar-options-menu [highlight-paren-mode]
718 (menu-bar-make-toggle toggle-highlight-paren-mode show-paren-mode
e5b31424 719 "Paren Match Highlighting (Show Paren mode)"
7f315c7c 720 "Show Paren mode %s"
e5b31424 721 "Highlight matching/mismatched parentheses at cursor"
d004e96a 722 (show-paren-mode)))
bacb2d12
RS
723(define-key menu-bar-options-menu [transient-mark-mode]
724 (menu-bar-make-toggle toggle-transient-mark-mode transient-mark-mode
e5b31424 725 "Active Region Highlighting (Transient Mark mode)"
7f315c7c 726 "Transient Mark mode %s"
e5b31424 727 "Make text in active region stand out in color"))
8ad97b87 728(define-key menu-bar-options-menu [toggle-global-lazy-font-lock-mode]
89f1709f 729 (menu-bar-make-toggle toggle-global-lazy-font-lock-mode global-font-lock-mode
e5b31424 730 "Syntax Highlighting (Global Font Lock mode)"
53ca4610 731 "Global Font Lock mode %s"
e5b31424 732 "Colorize text based on language syntax"
dbcee71a 733 (global-font-lock-mode)))
7f315c7c 734
e5683624 735\f
7f315c7c
EZ
736;; The "Tools" menu items
737
e4ca8f8c
EZ
738(defun send-mail-item-name ()
739 (let* ((known-send-mail-commands '((sendmail-user-agent . "sendmail")
740 (mh-e-user-agent . "MH")
741 (message-user-agent . "Gnus Message")
742 (gnus-user-agent . "Gnus")))
743 (name (assq mail-user-agent known-send-mail-commands)))
744 (if name
745 (setq name (cdr name))
746 (setq name (symbol-name mail-user-agent))
747 (if (string-match "\\(.+\\)-user-agent" name)
748 (setq name (match-string 1 name))))
749 name))
750
0a1f9f1d
EZ
751(defun read-mail-item-name ()
752 (let* ((known-rmail-commands '((rmail . "RMAIL")
753 (mh-rmail . "MH")
754 (gnus . "Gnus")))
755 (known (assq read-mail-command known-rmail-commands)))
756 (if known (cdr known) (symbol-name read-mail-command))))
757
7f315c7c
EZ
758(defvar menu-bar-games-menu (make-sparse-keymap "Games"))
759
760(define-key menu-bar-tools-menu [games]
761 (list 'menu-item "Games" menu-bar-games-menu))
762
763(define-key menu-bar-tools-menu [separator-games]
764 '("--"))
765
7bff37dc
EZ
766(define-key menu-bar-games-menu [zone]
767 '(menu-item "Zone Out" zone
768 :help "Play tricks with Emacs display when Emacs is idle"))
7f315c7c
EZ
769(define-key menu-bar-games-menu [yow]
770 '(menu-item "Random Quotation" yow
771 :help "Display a random Zippy quotation"))
772(define-key menu-bar-games-menu [tetris]
773 '(menu-item "Tetris" tetris))
774(define-key menu-bar-games-menu [solitaire]
775 '(menu-item "Solitaire" solitaire))
776(define-key menu-bar-games-menu [snake]
777 '(menu-item "Snake" snake
778 :help "Move snake around avoiding collisions"))
779(define-key menu-bar-games-menu [mult]
780 '(menu-item "Multiplication Puzzle" mpuz
781 :help "Excercise brain with multiplication"))
782(define-key menu-bar-games-menu [life]
783 '(menu-item "Life" life
784 :help "Watch how John Conway's cellular automaton evolves"))
785(define-key menu-bar-games-menu [hanoi]
786 '(menu-item "Towers of Hanoi" hanoi
787 :help "Watch Towers-of-Hanoi puzzle solved by Emacs"))
788(define-key menu-bar-games-menu [gomoku]
789 '(menu-item "Gomoku" gomoku
790 :help "Mark 5 contiguous squares (like tic-tac-toe)"))
791(define-key menu-bar-games-menu [black-box]
792 '(menu-item "Blackbox" blackbox
793 :help "Find balls in a black box by shooting rays"))
794(define-key menu-bar-games-menu [adventure]
795 '(menu-item "Adventure" dunnet
796 :help "Dunnet, a text Adventure game for Emacs"))
797(define-key menu-bar-games-menu [5x5]
798 '(menu-item "5x5" 5x5
799 :help "Fill in all the squares on a 5x5 board"))
800
506c6d61 801(define-key menu-bar-tools-menu [calendar]
7f315c7c
EZ
802 '(menu-item "Display Calendar" calendar))
803(define-key menu-bar-tools-menu [speedbar]
804 '(menu-item "Display Speedbar" speedbar-frame-mode))
805(define-key menu-bar-tools-menu [directory-search]
806 '(menu-item "Directory Search" eudc-tools-menu
807 :help "Query directory servers via LDAP, CCSO PH/QI or BBDB"))
506c6d61 808(define-key menu-bar-tools-menu [compose-mail]
e4ca8f8c
EZ
809 (list
810 'menu-item `(format "Send Mail (with %s)" (send-mail-item-name))
811 'compose-mail
812 :visible `(and mail-user-agent (not (eq mail-user-agent 'ignore)))
813 :help "Send a mail message"))
506c6d61 814(define-key menu-bar-tools-menu [rmail]
0a1f9f1d
EZ
815 (list
816 'menu-item `(format "Read Mail (with %s)" (read-mail-item-name))
817 (lambda ()
818 (interactive)
819 (call-interactively read-mail-command))
e4ca8f8c 820 :visible `(and read-mail-command (not (eq read-mail-command 'ignore)))
0a1f9f1d 821 :help "Read your mail and reply to it"))
7f315c7c 822(define-key menu-bar-tools-menu [gnus]
0a1f9f1d 823 '(menu-item "Read Net News (Gnus)" gnus
7f315c7c
EZ
824 :help "Read network news groups"))
825
826(define-key menu-bar-tools-menu [separator-vc]
827 '("--"))
828
829(defvar vc-menu-map (make-sparse-keymap "Version Control"))
eccd9bd5
SM
830(define-key menu-bar-tools-menu [pcl-cvs]
831 `(menu-item "PCL-CVS" ,cvs-global-menu
832 :help "Module-level interface to CVS"))
7f315c7c
EZ
833(define-key menu-bar-tools-menu [vc]
834 (list 'menu-item "Version Control" vc-menu-map
835 :help "Interface to RCS, CVS, SCCS"))
836
837(define-key menu-bar-tools-menu [separator-compare]
838 '("--"))
839
840(define-key menu-bar-tools-menu [ediff-misc]
841 '(menu-item "Ediff Miscellanea" menu-bar-ediff-misc-menu
842 :help "Ediff manual, customization, sessions, etc."))
843(define-key menu-bar-tools-menu [epatch]
844 '(menu-item "Apply Patch" menu-bar-epatch-menu))
845(define-key menu-bar-tools-menu [ediff-merge]
846 '(menu-item "Merge" menu-bar-ediff-merge-menu
847 :help "Merge different revisions of files/directories"))
848(define-key menu-bar-tools-menu [compare]
849 '(menu-item "Compare (Ediff)" menu-bar-ediff-menu
850 :help "Display differences between files/directories"))
851
852
853(define-key menu-bar-tools-menu [separator-spell]
854 '("--"))
855
856(define-key menu-bar-tools-menu [spell]
857 '(menu-item "Spell Checking" ispell-menu-map))
858
859(define-key menu-bar-tools-menu [separator-prog]
860 '("--"))
861
862(define-key menu-bar-tools-menu [gdb]
863 '(menu-item "Debugger (GUD)..." gdb
0a1f9f1d 864 :help "Debug a program from within Emacs"))
7f315c7c
EZ
865(define-key menu-bar-tools-menu [shell-on-region]
866 '(menu-item "Shell Command on Region..." shell-command-on-region
867 :enable mark-active
868 :help "Pass marked region to a shell command"))
869(define-key menu-bar-tools-menu [shell]
870 '(menu-item "Shell Command..." shell-command
871 :help "Invoke a shell command and catch its output"))
872(define-key menu-bar-tools-menu [compile]
873 '(menu-item "Compile..." compile
874 :help "Invoke compiler or Make, view compilation errors"))
875(define-key menu-bar-tools-menu [grep]
876 '(menu-item "Search Files (Grep)..." grep
877 :help "Search files for strings or regexps (with Grep)"))
878
879\f
880;; The "Help" menu items
881
e5683624
RS
882(defvar menu-bar-describe-menu (make-sparse-keymap "Describe"))
883
7f315c7c
EZ
884(define-key menu-bar-describe-menu [mule-diag]
885 '(menu-item "Show All of Mule Status" mule-diag
886 :visible default-enable-multibyte-characters
887 :help "Display multilingual environment settings"))
df5bde6d
SS
888(define-key menu-bar-describe-menu [describe-coding-system-briefly]
889 '(menu-item "Describe Coding System (Briefly)..."
890 describe-current-coding-system-briefly
891 :visible default-enable-multibyte-characters))
7f315c7c
EZ
892(define-key menu-bar-describe-menu [describe-coding-system]
893 '(menu-item "Describe Coding System..." describe-coding-system
894 :visible default-enable-multibyte-characters))
895(define-key menu-bar-describe-menu [describe-input-method]
896 '(menu-item "Describe Input Method..." describe-input-method
897 :visible default-enable-multibyte-characters
898 :help "Keyboard layout for specific input method"))
899(define-key menu-bar-describe-menu [describe-language-environment]
506c6d61
DL
900 (list 'menu-item "Describe Language Environment"
901 describe-language-environment-map
902 :help "Show multilingual settings for a specific language"))
7f315c7c
EZ
903
904(define-key menu-bar-describe-menu [separator-desc-mule]
506c6d61 905 '("--"))
7f315c7c
EZ
906
907(define-key menu-bar-describe-menu [list-keybindings]
908 '(menu-item "List Key Bindings" describe-bindings
909 :help "Display a list of all current keybindings"))
df5bde6d
SS
910(define-key menu-bar-describe-menu [describe-current-display-table]
911 '(menu-item "Describe Display Table" describe-current-display-table
912 :help "Describe the current display table"))
913(define-key menu-bar-describe-menu [describe-face]
914 '(menu-item "Describe Face..." describe-face
915 :help "Display the properties of a face"))
e5683624 916(define-key menu-bar-describe-menu [describe-variable]
7f315c7c
EZ
917 '(menu-item "Describe Variable..." describe-variable
918 :help "Display documentation of variable/option"))
e5683624 919(define-key menu-bar-describe-menu [describe-function]
7f315c7c
EZ
920 '(menu-item "Describe Function..." describe-function
921 :help "Display documentation of function/command"))
e5683624 922(define-key menu-bar-describe-menu [describe-key]
7f315c7c 923 '(menu-item "Describe Key..." describe-key
506c6d61
DL
924 ;; Users typically don't identify keys and menu items...
925 :help "Display documentation of command bound to a \
926key (or menu-item)"))
df5bde6d
SS
927(define-key menu-bar-describe-menu [describe-mode]
928 '(menu-item "Describe Buffer Modes" describe-mode
929 :help "Describe this buffer's major and minor mode"))
930
931(defvar menu-bar-apropos-menu (make-sparse-keymap "Apropos"))
5275d6a8
EZ
932(defun menu-bar-read-lispref ()
933 "Display the Emacs Lisp Reference manual in Info mode."
934 (interactive)
935 (info "elisp"))
936
937(defun menu-bar-read-lispintro ()
938 "Display the Introduction to Emacs Lisp Programming in Info mode."
939 (interactive)
940 (info "eintr"))
941
942(defun menu-bar-read-emacs-man ()
943 "Display Emacs User Manual in Info mode."
944 (interactive)
945 (info "emacs"))
946
947(defun search-emacs-glossary ()
948 "Display the Glossary node of the Emacs manual in Info mode."
949 (interactive)
950 (info "(emacs)Glossary"))
951
952(defun emacs-index-search (topic)
953 "Look up TOPIC in the indices of the Emacs User Manual."
954 (interactive "sSubject to look up: ")
955 (info "emacs")
956 (Info-index topic))
957
958(defun elisp-index-search (topic)
959 "Look up TOPIC in the indices of the Emacs Lisp Reference Manual."
960 (interactive "sSubject to look up: ")
961 (info "elisp")
962 (Info-index topic))
df5bde6d
SS
963
964(define-key menu-bar-apropos-menu [apropos-documentation]
5275d6a8
EZ
965 '(menu-item "Search Documentation Strings..." apropos-documentation
966 :help
967 "Find functions and variables whose doc strings match a regexp"))
df5bde6d 968(define-key menu-bar-apropos-menu [apropos]
5275d6a8
EZ
969 '(menu-item "Find Any Object by Name..." apropos
970 :help "Find symbols of any kind whose names match a regexp"))
df5bde6d 971(define-key menu-bar-apropos-menu [apropos-value]
5275d6a8
EZ
972 '(menu-item "Find Options by Value..." apropos-value
973 :help "Find variables whose values match a regexp"))
df5bde6d 974(define-key menu-bar-apropos-menu [apropos-variables]
5275d6a8
EZ
975 '(menu-item "Find Options by Name..." apropos-variable
976 :help "Find variables whose names match a regexp"))
df5bde6d 977(define-key menu-bar-apropos-menu [apropos-commands]
5275d6a8
EZ
978 '(menu-item "Find Commands by Name..." apropos-command
979 :help "Find commands whose names match a regexp"))
980(define-key menu-bar-apropos-menu [sep1]
981 '("--"))
982(define-key menu-bar-apropos-menu [elisp-index-search]
983 '(menu-item "Look Up Subject in ELisp Manual..." elisp-index-search
984 :help "Find description of a subject in Emacs Lisp manual"))
985(define-key menu-bar-apropos-menu [emacs-index-search]
986 '(menu-item "Look Up Subject in User Manual..." emacs-index-search
987 :help "Find description of a subject in Emacs User manual"))
988(define-key menu-bar-apropos-menu [emacs-glossary]
989 '(menu-item "Emacs Terminology" search-emacs-glossary
990 :help "Display the Glossary section of the Emacs manual"))
991
992(defvar menu-bar-manuals-menu (make-sparse-keymap "More Manuals"))
e5683624
RS
993
994(define-key menu-bar-manuals-menu [man]
7f315c7c
EZ
995 '(menu-item "Read Man Page..." manual-entry
996 :help "Man-page docs for external commands and libraries"))
e5683624
RS
997(define-key menu-bar-manuals-menu [sep2]
998 '("--"))
5275d6a8
EZ
999(define-key menu-bar-manuals-menu [order-emacs-manuals]
1000 '(menu-item "Ordering Manuals" view-order-manuals
1001 :help "How to order manuals from the Free Software Foundation"))
e5683624 1002(define-key menu-bar-manuals-menu [info]
5275d6a8 1003 '(menu-item "All Other Manuals (Info)" Info-directory
7f315c7c 1004 :help "Read any of the installed manuals"))
5275d6a8
EZ
1005(define-key menu-bar-manuals-menu [info-elisp]
1006 '(menu-item "Emacs Lisp Reference" menu-bar-read-lispref
1007 :help "Read the Emacs Lisp Reference manual"))
1008(define-key menu-bar-manuals-menu [info-elintro]
1009 '(menu-item "Introduction to Emacs Lisp" menu-bar-read-lispintro
1010 :help "Read the Introduction to Emacs Lisp Programming"))
1011(define-key menu-bar-manuals-menu [sep3]
1012 '("--"))
7f315c7c
EZ
1013(define-key menu-bar-manuals-menu [command]
1014 '(menu-item "Find Command in Manual" Info-goto-emacs-command-node
1015 :help "Display manual section that describes a command"))
1016(define-key menu-bar-manuals-menu [key]
1017 '(menu-item "Find Key in Manual" Info-goto-emacs-key-command-node
1018 :help "Display manual section that describes a key"))
bacb2d12 1019
7f315c7c
EZ
1020(define-key menu-bar-help-menu [eliza]
1021 '(menu-item "Emacs Psychiatrist" doctor
1022 :help "Our doctor will help you feel better"))
5275d6a8 1023(define-key menu-bar-help-menu [sep4]
7f315c7c 1024 '("--"))
f3e1e0dd 1025(define-key menu-bar-help-menu [describe-no-warranty]
7f315c7c
EZ
1026 '(menu-item "(Non)Warranty" describe-no-warranty
1027 :help "Explain that Emacs has NO WARRANTY"))
f3e1e0dd 1028(define-key menu-bar-help-menu [describe-copying]
7f315c7c
EZ
1029 '(menu-item "Copying Conditions" describe-copying
1030 :help "Show the Emacs license (GPL)"))
f3e1e0dd 1031(define-key menu-bar-help-menu [describe-distribution]
7f315c7c
EZ
1032 '(menu-item "Getting New Versions" describe-distribution
1033 :help "How to get latest versions of Emacs"))
ae65cd84
DL
1034(define-key menu-bar-help-menu [more]
1035 '(menu-item "Find Extra Packages"
1036 (lambda ()
1037 (interactive)
1038 (let (enable-local-variables)
1039 (view-file (expand-file-name "MORE.STUFF"
1040 data-directory))
1041 (goto-address)))
1042 :help "Where to find some extra packages and possible updates"))
008cea2c
PJ
1043(define-key menu-bar-help-menu [about]
1044 '(menu-item "About Emacs" display-splash-screen
1045 :help "Display splash screen, version, and instructions"))
e5683624
RS
1046(define-key menu-bar-help-menu [sep2]
1047 '("--"))
260130bb 1048(define-key menu-bar-help-menu [finder-by-keyword]
7f315c7c
EZ
1049 '(menu-item "Find Emacs Packages..." finder-by-keyword
1050 :help "Find packages and features by keyword"))
5275d6a8
EZ
1051(define-key menu-bar-help-menu [manuals]
1052 (list 'menu-item "More Manuals" menu-bar-manuals-menu
1053 :help "Search and browse on-line manuals"))
1054(define-key menu-bar-help-menu [emacs-manual]
1055 '(menu-item "Read the Emacs Manual" menu-bar-read-emacs-man
1056 :help "Full documentation of Emacs features"))
e5683624 1057(define-key menu-bar-help-menu [describe]
7f315c7c
EZ
1058 (list 'menu-item "Describe" menu-bar-describe-menu
1059 :help "Describe commands, variables, keys"))
5275d6a8
EZ
1060(define-key menu-bar-help-menu [apropos]
1061 (list 'menu-item "Search Documentation" menu-bar-apropos-menu
1062 :help "Look up terms, find commands, options, etc. (Apropos)"))
e5683624
RS
1063(define-key menu-bar-help-menu [sep1]
1064 '("--"))
7f315c7c
EZ
1065(define-key menu-bar-help-menu [report-emacs-bug]
1066 '(menu-item "Send Bug Report..." report-emacs-bug
1067 :help "Send e-mail to Emacs maintainers"))
1068(define-key menu-bar-help-menu [emacs-problems]
1069 '(menu-item "Emacs Known Problems" view-emacs-problems))
1070(define-key menu-bar-help-menu [emacs-news]
1071 '(menu-item "Emacs News" view-emacs-news
1072 :help "New features of this version"))
1073(define-key menu-bar-help-menu [emacs-faq]
1074 '(menu-item "Emacs FAQ" view-emacs-FAQ))
451ec4e3
GM
1075(define-key menu-bar-help-menu [emacs-tutorial-language-specific]
1076 '(menu-item "Emacs Tutorial (choose language)..."
1077 (lambda () (interactive) (help-with-tutorial t))
1078 :help "Learn how to use Emacs (choose a language)"))
7f315c7c
EZ
1079(define-key menu-bar-help-menu [emacs-tutorial]
1080 '(menu-item "Emacs Tutorial" help-with-tutorial
1081 :help "Learn how to use Emacs"))
889560ed 1082
db774a16 1083(defun kill-this-buffer () ; for the menubar
506c6d61 1084 "Kill the current buffer."
db774a16
RS
1085 (interactive)
1086 (kill-buffer (current-buffer)))
1087
2f1139a4
RS
1088(defun kill-this-buffer-enabled-p ()
1089 (let ((count 0)
1090 (buffers (buffer-list)))
1091 (while buffers
1092 (or (string-match "^ " (buffer-name (car buffers)))
1093 (setq count (1+ count)))
1094 (setq buffers (cdr buffers)))
a6f8cbf1 1095 (and (not (window-minibuffer-p (frame-selected-window menu-updating-frame)))
1f50590a
RS
1096 (> count 1))))
1097
1f50590a 1098(put 'dired 'menu-enable
a6f8cbf1 1099 '(not (window-minibuffer-p (frame-selected-window menu-updating-frame))))
1f50590a 1100
a0213a97 1101;; Permit deleting frame if it would leave a visible or iconified frame.
82a74107
KH
1102(defun delete-frame-enabled-p ()
1103 "Return non-nil if `delete-frame' should be enabled in the menu bar."
1104 (let ((frames (frame-list))
27aa8132
RS
1105 (count 0))
1106 (while frames
1107 (if (frame-visible-p (car frames))
1108 (setq count (1+ count)))
1109 (setq frames (cdr frames)))
1110 (> count 1)))
2f1139a4 1111
30e19aee
RS
1112(defcustom yank-menu-length 20
1113 "*Maximum length to display in the yank-menu."
1114 :type 'integer
1115 :group 'mouse)
3dd92899
KH
1116
1117(defun menu-bar-update-yank-menu (string old)
1118 (let ((front (car (cdr yank-menu)))
1119 (menu-string (if (<= (length string) yank-menu-length)
1120 string
c3e1d435
RS
1121 (concat
1122 (substring string 0 (/ yank-menu-length 2))
1123 "..."
1124 (substring string (- (/ yank-menu-length 2)))))))
7c70a955
RS
1125 ;; Don't let the menu string be all dashes
1126 ;; because that has a special meaning in a menu.
1127 (if (string-match "\\`-+\\'" menu-string)
1128 (setq menu-string (concat menu-string " ")))
3dd92899
KH
1129 ;; If we're supposed to be extending an existing string, and that
1130 ;; string really is at the front of the menu, then update it in place.
1131 (if (and old (or (eq old (car front))
1132 (string= old (car front))))
dfabc98f 1133 (progn
3dd92899
KH
1134 (setcar front string)
1135 (setcar (cdr front) menu-string))
1136 (setcdr yank-menu
1137 (cons
1138 (cons string (cons menu-string 'menu-bar-select-yank))
1139 (cdr yank-menu)))))
1140 (if (> (length (cdr yank-menu)) kill-ring-max)
1141 (setcdr (nthcdr kill-ring-max yank-menu) nil)))
1142
4cca6fbd 1143(put 'menu-bar-select-yank 'apropos-inhibit t)
3dd92899
KH
1144(defun menu-bar-select-yank ()
1145 (interactive "*")
1146 (push-mark (point))
1147 (insert last-command-event))
40954111 1148\f
d0690d12
RS
1149(defvar list-buffers-directory nil)
1150
08e8171f
RS
1151(defvar menu-bar-update-buffers-maxbuf)
1152
09642d97
RS
1153(defun menu-bar-select-buffer ()
1154 (interactive)
1155 (switch-to-buffer last-command-event))
1156
1157(defun menu-bar-select-frame ()
1158 (interactive)
dfe5e27f
DL
1159 (let (frame)
1160 (dolist (f (frame-list))
1161 (when (equal last-command-event (frame-parameter f 'name))
1162 (setq frame f)))
1163 (make-frame-visible frame)
1164 (raise-frame frame)
1165 (select-frame frame)))
09642d97 1166
c171b42f
RS
1167(defun menu-bar-update-buffers-1 (elt)
1168 (cons (format
75547194
RS
1169 ;; (format "%%%ds %%s%%s %%s" menu-bar-update-buffers-maxbuf)
1170 "%s %s%s -- %s"
c171b42f
RS
1171 (cdr elt)
1172 (if (buffer-modified-p (car elt))
1173 "*" " ")
1174 (save-excursion
1175 (set-buffer (car elt))
1176 (if buffer-read-only "%" " "))
1177 (let ((file
1178 (or (buffer-file-name (car elt))
1179 (save-excursion
1180 (set-buffer (car elt))
1181 list-buffers-directory)
1182 "")))
1183 (setq file (or (file-name-directory file)
1184 ""))
1185 (if (> (length file) 20)
1186 (setq file (concat "..." (substring file -17))))
1187 file))
1188 (car elt)))
1189
06ff7539
RS
1190(defvar menu-bar-buffers-menu-list-buffers-entry nil)
1191
ee1dbceb 1192(defun menu-bar-update-buffers (&optional force)
29397c58 1193 ;; If user discards the Buffers item, play along.
4d587a6c 1194 (and (lookup-key (current-global-map) [menu-bar buffer])
ee1dbceb 1195 (or force (frame-or-buffer-changed-p))
29397c58
RS
1196 (let ((buffers (buffer-list))
1197 (frames (frame-list))
b3398af1 1198 (maxlen 0)
29397c58
RS
1199 buffers-menu frames-menu)
1200 ;; If requested, list only the N most recently selected buffers.
1201 (if (and (integerp buffers-menu-max-size)
1202 (> buffers-menu-max-size 1))
1203 (if (> (length buffers) buffers-menu-max-size)
1204 (setcdr (nthcdr buffers-menu-max-size buffers) nil)))
1205
1206 ;; Make the menu of buffers proper.
1207 (setq buffers-menu
1208 (cons "Select Buffer"
c171b42f
RS
1209 (let* ((buffer-list
1210 (mapcar 'list buffers))
1211 tail
08e8171f 1212 (menu-bar-update-buffers-maxbuf 0)
c171b42f
RS
1213 alist
1214 head)
1215 ;; Put into each element of buffer-list
1216 ;; the name for actual display,
1217 ;; perhaps truncated in the middle.
1218 (setq tail buffer-list)
1219 (while tail
1220 (let ((name (buffer-name (car (car tail)))))
1221 (setcdr (car tail)
1222 (if (> (length name) 27)
1223 (concat (substring name 0 12)
1224 "..."
1225 (substring name -12))
1226 name)))
1227 (setq tail (cdr tail)))
1228 ;; Compute the maximum length of any name.
1229 (setq tail buffer-list)
29397c58 1230 (while tail
c171b42f 1231 (or (eq ?\ (aref (cdr (car tail)) 0))
08e8171f
RS
1232 (setq menu-bar-update-buffers-maxbuf
1233 (max menu-bar-update-buffers-maxbuf
c171b42f 1234 (length (cdr (car tail))))))
29397c58 1235 (setq tail (cdr tail)))
c171b42f
RS
1236 ;; Set ALIST to an alist of the form
1237 ;; ITEM-STRING . BUFFER
1238 (setq tail buffer-list)
29397c58
RS
1239 (while tail
1240 (let ((elt (car tail)))
c171b42f 1241 (or (eq ?\ (aref (cdr elt) 0))
29397c58 1242 (setq alist (cons
c171b42f 1243 (menu-bar-update-buffers-1 elt)
29397c58
RS
1244 alist)))
1245 (and alist (> (length (car (car alist))) maxlen)
1246 (setq maxlen (length (car (car alist))))))
1247 (setq tail (cdr tail)))
1248 (setq alist (nreverse alist))
06ff7539
RS
1249 ;; Make the menu item for list-buffers
1250 ;; or reuse the one we already have.
1251 ;; The advantage in reusing one
1252 ;; is that it already has the keyboard equivalent
1253 ;; cached, so we save the time to look that up again.
1254 (or menu-bar-buffers-menu-list-buffers-entry
1255 (setq menu-bar-buffers-menu-list-buffers-entry
1256 (cons
1257 'list-buffers
1258 (cons
1259 ""
1260 'list-buffers))))
1261 ;; Update the item string for menu's new width.
1262 (setcar (cdr menu-bar-buffers-menu-list-buffers-entry)
1263 (concat (make-string (max (- (/ maxlen 2) 8) 0)
1264 ?\ )
1265 "List All Buffers"))
1266 ;; Now make the actual list of items,
1267 ;; ending with the list-buffers item.
f2116cf9 1268 (nconc (mapcar (lambda (pair)
10013d74
DL
1269 ;; This is somewhat risque, to use
1270 ;; the buffer name itself as the event
1271 ;; type to define, but it works.
1272 ;; It would not work to use the buffer
1273 ;; since a buffer as an event has its
1274 ;; own meaning.
1275 (nconc (list (buffer-name (cdr pair))
1276 (car pair)
1277 (cons nil nil))
1278 'menu-bar-select-buffer))
29397c58 1279 alist)
06ff7539 1280 (list menu-bar-buffers-menu-list-buffers-entry)))))
29397c58
RS
1281
1282
1283 ;; Make a Frames menu if we have more than one frame.
1284 (if (cdr frames)
b3398af1
RS
1285 (let ((name (concat (make-string (max (- (/ maxlen 2) 3) 0)
1286 ?\ )
1287 "Frames"))
1288 (frames-menu
1289 (cons 'keymap
1290 (cons "Select Frame"
10013d74
DL
1291 (mapcar
1292 (lambda (frame)
1293 (nconc
dfe5e27f 1294 (list (frame-parameter frame 'name)
ce9561ac 1295 (frame-parameter frame 'name)
10013d74
DL
1296 (cons nil nil))
1297 'menu-bar-select-frame))
b3398af1
RS
1298 frames)))))
1299 ;; Put it underneath the Buffers menu.
1300 (setq buffers-menu (cons (cons 'frames (cons name frames-menu))
1301 buffers-menu))))
29397c58
RS
1302 (if buffers-menu
1303 (setq buffers-menu (cons 'keymap buffers-menu)))
4d587a6c 1304 (define-key (current-global-map) [menu-bar buffer]
b3398af1 1305 (cons "Buffers" buffers-menu)))))
09642d97
RS
1306
1307(add-hook 'menu-bar-update-hook 'menu-bar-update-buffers)
2f1139a4 1308
3f557298
RS
1309(menu-bar-update-buffers)
1310
40954111
RS
1311;; this version is too slow
1312;;;(defun format-buffers-menu-line (buffer)
1313;;; "Returns a string to represent the given buffer in the Buffer menu.
1314;;;nil means the buffer shouldn't be listed. You can redefine this."
1315;;; (if (string-match "\\` " (buffer-name buffer))
1316;;; nil
1317;;; (save-excursion
1318;;; (set-buffer buffer)
1319;;; (let ((size (buffer-size)))
1320;;; (format "%s%s %-19s %6s %-15s %s"
1321;;; (if (buffer-modified-p) "*" " ")
1322;;; (if buffer-read-only "%" " ")
1323;;; (buffer-name)
1324;;; size
1325;;; mode-name
1326;;; (or (buffer-file-name) ""))))))
1327\f
25b048ee
RS
1328;;; Set up a menu bar menu for the minibuffer.
1329
32993295
SM
1330(dolist (map (list minibuffer-local-map
1331 ;; This shouldn't be necessary, but there's a funny
1332 ;; bug in keymap.c that I don't understand yet. -stef
d918e2dc
SM
1333 minibuffer-local-completion-map))
1334 (define-key map [menu-bar minibuf]
1335 (cons "Minibuf" (make-sparse-keymap "Minibuf"))))
1336
32993295 1337(let ((map minibuffer-local-completion-map))
d918e2dc
SM
1338 (define-key map [menu-bar minibuf ?\?]
1339 (list 'menu-item "List Completions" 'minibuffer-completion-help
1340 :help "Display all possible completions"))
1341 (define-key map [menu-bar minibuf space]
1342 (list 'menu-item "Complete Word" 'minibuffer-complete-word
1343 :help "Complete at most one word"))
1344 (define-key map [menu-bar minibuf tab]
1345 (list 'menu-item "Complete" 'minibuffer-complete
1346 :help "Complete as far as possible")))
1347
32993295 1348(let ((map minibuffer-local-map))
d918e2dc
SM
1349 (define-key map [menu-bar minibuf quit]
1350 (list 'menu-item "Quit" 'keyboard-escape-quit
1351 :help "Abort input and exit minibuffer"))
1352 (define-key map [menu-bar minibuf return]
1353 (list 'menu-item "Enter" 'exit-minibuffer
1354 :help "Terminate input and exit minibuffer")))
25b048ee 1355\f
88a26eb4
DL
1356(defcustom menu-bar-mode nil
1357 "Toggle display of a menu bar on each frame.
1358Setting this variable directly does not take effect;
1359use either \\[customize] or the function `menu-bar-mode'."
1360 :set (lambda (symbol value)
1361 (menu-bar-mode (or value 0)))
1362 :initialize 'custom-initialize-default
1363 :type 'boolean
1364 :group 'frames)
7b7d6615 1365
6fa40743 1366(defun menu-bar-mode (&optional flag)
dfd29450 1367 "Toggle display of a menu bar on each frame.
057d49d1
RS
1368This command applies to all frames that exist and frames to be
1369created in the future.
e1d18ad8
RS
1370With a numeric argument, if the argument is positive,
1371turn on menu bars; otherwise, turn off menu bars."
dad8e392 1372 (interactive "P")
dad8e392 1373
7b7d6615
RS
1374 ;; Make menu-bar-mode and default-frame-alist consistent.
1375 (let ((default (assq 'menu-bar-lines default-frame-alist)))
1376 (if default
1377 (setq menu-bar-mode (not (eq (cdr default) 0)))
1378 (setq default-frame-alist
1379 (cons (cons 'menu-bar-lines (if menu-bar-mode 1 0))
1380 default-frame-alist))))
1381
1382 ;; Toggle or set the mode, according to FLAG.
1383 (setq menu-bar-mode (if (null flag) (not menu-bar-mode)
1384 (> (prefix-numeric-value flag) 0)))
1385
1386 ;; Apply it to default-frame-alist.
1387 (let ((parameter (assq 'menu-bar-lines default-frame-alist)))
1388 (if (consp parameter)
1389 (setcdr parameter (if menu-bar-mode 1 0))
1390 (setq default-frame-alist
1391 (cons (cons 'menu-bar-lines (if menu-bar-mode 1 0))
1392 default-frame-alist))))
1393
1394 ;; Apply it to existing frames.
1395 (let ((frames (frame-list)))
1396 (while frames
1397 (let ((height (cdr (assq 'height (frame-parameters (car frames))))))
1398 (modify-frame-parameters (car frames)
1399 (list (cons 'menu-bar-lines
1400 (if menu-bar-mode 1 0))))
1401 (modify-frame-parameters (car frames)
1402 (list (cons 'height height))))
1403 (setq frames (cdr frames)))))
1db87953 1404
bffa5d4d
RS
1405(provide 'menu-bar)
1406
235aa29b 1407;;; menu-bar.el ends here