2001-09-04 Andrew Choi <akochoi@cse.cuhk.edu.hk>
[bpt/emacs.git] / lisp / menu-bar.el
CommitLineData
55535639 1;;; menu-bar.el --- define a default menu bar
235aa29b 2
dfe5e27f 3;; Copyright (C) 1993, 1994, 1995, 2000, 2001 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
7f315c7c
EZ
316(define-key menu-bar-search-menu [separator-search]
317 '(menu-item "--"))
318
319(define-key menu-bar-edit-menu [bookmark]
320 '(menu-item "Bookmarks" menu-bar-bookmark-map
321 :help "Record positions and jump between them"))
322
323(define-key menu-bar-edit-menu [separator-bookmark]
324 '(menu-item "--"))
325
326(defvar menu-bar-goto-menu (make-sparse-keymap "Go To"))
327
328(define-key menu-bar-goto-menu [set-tags-name]
329 '(menu-item "Set Tags File Name" visit-tags-table
330 :help "Tell Tags commands which tag table file to use"))
331
332(define-key menu-bar-goto-menu [separator-tag-file]
333 '(menu-item "--"))
334
335(define-key menu-bar-goto-menu [apropos-tags]
336 '(menu-item "Tags Apropos" tags-apropos
337 :help "Find function/variables whose names match regexp"))
338(define-key menu-bar-goto-menu [next-tag-otherw]
339 '(menu-item "Next Tag in Other Window"
340 (function (lambda () (find-tag-other-window nil t)))
0ae27881
EZ
341 :enable (and (boundp 'tags-location-ring)
342 (not (ring-empty-p tags-location-ring)))
7f315c7c
EZ
343 :help "Find next function/variable matching last tag name in another window"))
344(define-key menu-bar-goto-menu [next-tag]
345 '(menu-item "Find Next Tag"
346 (function (lambda () (find-tag nil t)))
0ae27881
EZ
347 :enable (and (boundp 'tags-location-ring)
348 (not (ring-empty-p tags-location-ring)))
7f315c7c
EZ
349 :help "Find next function/variable matching last tag name"))
350(define-key menu-bar-goto-menu [find-tag-otherw]
351 '(menu-item "Find Tag in Other Window..." find-tag-other-window
352 :help "Find function/variable definition in another window"))
353(define-key menu-bar-goto-menu [find-tag]
354 '(menu-item "Find Tag..." find-tag
355 :help "Find definition of function or variable"))
356
357(define-key menu-bar-goto-menu [separator-tags]
358 '(menu-item "--"))
359
360(define-key menu-bar-goto-menu [end-of-buf]
361 '(menu-item "Goto End of Buffer" end-of-buffer))
362(define-key menu-bar-goto-menu [beg-of-buf]
363 '(menu-item "Goto Beginning of Buffer" beginning-of-buffer))
364(define-key menu-bar-goto-menu [go-to-pos]
365 '(menu-item "Goto Buffer Position..." goto-char
366 :help "Read a number N and go to buffer position N"))
367(define-key menu-bar-goto-menu [go-to-line]
368 '(menu-item "Goto Line..." goto-line
369 :help "Read a line number and go to that line"))
370
371(define-key menu-bar-edit-menu [goto]
372 (list 'menu-item "Go To" menu-bar-goto-menu))
373
374(define-key menu-bar-edit-menu [search]
375 (list 'menu-item "Search" menu-bar-search-menu))
376
377(define-key menu-bar-edit-menu [fill]
378 '(menu-item "Fill" fill-region
379 :enable (and mark-active (not buffer-read-only))
380 :help
381 "Fill text in region to fit between left and right margin"))
496b7491
EZ
382(define-key menu-bar-edit-menu [mark-whole-buffer]
383 '(menu-item "Select All" mark-whole-buffer
384 :help "Mark the whole buffer for a subsequent cut/copy."))
7f315c7c
EZ
385(define-key menu-bar-edit-menu [clear]
386 '(menu-item "Clear" delete-region
387 :enable (and mark-active
388 (not buffer-read-only)
389 (not (mouse-region-match)))
390 :help
ae65cd84 391 "Delete the text in region between mark and current position"))
3dd92899
KH
392(defvar yank-menu (cons "Select Yank" nil))
393(fset 'yank-menu (cons 'keymap yank-menu))
7f315c7c
EZ
394(define-key menu-bar-edit-menu [select-paste]
395 '(menu-item "Select and Paste" yank-menu
396 :enable (and (cdr yank-menu) (not buffer-read-only))
19bd58e8 397 :help "Paste (yank) text cut or copied earlier"))
7f315c7c
EZ
398(define-key menu-bar-edit-menu [paste]
399 '(menu-item "Paste" yank
400 :enable (and (x-selection-exists-p) (not buffer-read-only))
19bd58e8 401 :help "Paste (yank) text most recently cut/copied"))
7f315c7c
EZ
402(define-key menu-bar-edit-menu [copy]
403 '(menu-item "Copy" menu-bar-kill-ring-save
404 :enable mark-active
ae65cd84 405 :help "Copy text in region between mark and current position"))
7f315c7c
EZ
406(define-key menu-bar-edit-menu [cut]
407 '(menu-item "Cut" kill-region
408 :enable (and mark-active (not buffer-read-only))
ae65cd84
DL
409 :help
410 "Cut (kill) text in region between mark and current position"))
7f315c7c
EZ
411(define-key menu-bar-edit-menu [undo]
412 '(menu-item "Undo" undo
413 :enable (and (not buffer-read-only)
414 (not (eq t buffer-undo-list))
415 (if (eq last-command 'undo)
416 pending-undo-list
417 (consp buffer-undo-list)))
418 :help "Undo last operation"))
419
057d49d1 420
4c0317b1
RS
421(defun menu-bar-kill-ring-save (beg end)
422 (interactive "r")
423 (if (mouse-region-match)
b1a4cc61 424 (message "Selecting a region with the mouse does `copy' automatically")
4c0317b1
RS
425 (kill-ring-save beg end)))
426
9e18f0a0
RS
427(autoload 'ispell-menu-map "ispell" nil t 'keymap)
428
f9cf0be2 429;; These are alternative definitions for the cut, paste and copy
4c0317b1 430;; menu items. Use them if your system expects these to use the clipboard.
f9cf0be2 431
f9cf0be2
RS
432(put 'clipboard-kill-region 'menu-enable 'mark-active)
433(put 'clipboard-kill-ring-save 'menu-enable 'mark-active)
434(put 'clipboard-yank 'menu-enable
435 '(or (x-selection-exists-p) (x-selection-exists-p 'CLIPBOARD)))
436
437(defun clipboard-yank ()
ee497664 438 "Insert the clipboard contents, or the last stretch of killed text."
f9cf0be2
RS
439 (interactive)
440 (let ((x-select-enable-clipboard t))
441 (yank)))
442
443(defun clipboard-kill-ring-save (beg end)
444 "Copy region to kill ring, and save in the X clipboard."
445 (interactive "r")
446 (let ((x-select-enable-clipboard t))
447 (kill-ring-save beg end)))
448
449(defun clipboard-kill-region (beg end)
450 "Kill the region, and save it in the X clipboard."
451 (interactive "r")
452 (let ((x-select-enable-clipboard t))
453 (kill-region beg end)))
454
455(defun menu-bar-enable-clipboard ()
5cbdeb30
RS
456 "Make CUT, PASTE and COPY (keys and menu bar items) use the clipboard.
457Do the same for the keys of the same name."
f9cf0be2 458 (interactive)
5754d7f2
RS
459 ;; We can't use constant list structure here because it becomes pure,
460 ;; and because it gets modified with cache data.
461 (define-key menu-bar-edit-menu [paste]
7f315c7c 462 (cons "Paste" (cons "Paste text from clipboard" 'clipboard-yank)))
5754d7f2 463 (define-key menu-bar-edit-menu [copy]
7f315c7c
EZ
464 (cons "Copy" (cons "Copy text in region to the clipboard"
465 'clipboard-kill-ring-save)))
5754d7f2 466 (define-key menu-bar-edit-menu [cut]
7f315c7c
EZ
467 (cons "Cut" (cons "Delete text in region and copy it to the clipboard"
468 'clipboard-kill-region)))
5cbdeb30
RS
469
470 (define-key global-map [f20] 'clipboard-kill-region)
471 (define-key global-map [f16] 'clipboard-kill-ring-save)
472 (define-key global-map [f18] 'clipboard-yank)
473 ;; X11R6 versions
474 (define-key global-map [cut] 'clipboard-kill-region)
475 (define-key global-map [copy] 'clipboard-kill-ring-save)
476 (define-key global-map [paste] 'clipboard-yank))
f9cf0be2 477\f
7f315c7c 478;; The "Options" menu items
a9f53ffb
RS
479
480(defvar menu-bar-custom-menu (make-sparse-keymap "Customize"))
481
b0f661de 482(define-key menu-bar-custom-menu [customize-apropos-groups]
7f315c7c
EZ
483 '(menu-item "Groups Matching Regexp..." customize-apropos-groups
484 :help "Browse groups whose names match regexp"))
b0f661de 485(define-key menu-bar-custom-menu [customize-apropos-faces]
7f315c7c
EZ
486 '(menu-item "Faces Matching Regexp..." customize-apropos-faces
487 :help "Browse faces whose names match regexp"))
b0f661de 488(define-key menu-bar-custom-menu [customize-apropos-options]
7f315c7c
EZ
489 '(menu-item "Options Matching Regexp..." customize-apropos-options
490 :help "Browse options whose names match regexp"))
a9f53ffb 491(define-key menu-bar-custom-menu [customize-apropos]
7f315c7c
EZ
492 '(menu-item "Settings Matching Regexp..." customize-apropos
493 :help "Browse customizable settings whose names match regexp"))
b0f661de
RS
494(define-key menu-bar-custom-menu [separator-2]
495 '("--"))
c9a86e71 496(define-key menu-bar-custom-menu [customize-group]
7f315c7c
EZ
497 '(menu-item "Specific Group..." customize-group
498 :help "Customize settings of specific group"))
a9f53ffb 499(define-key menu-bar-custom-menu [customize-face]
7f315c7c
EZ
500 '(menu-item "Specific Face..." customize-face
501 :help "Customize attributes of specific face"))
b0f661de 502(define-key menu-bar-custom-menu [customize-option]
7f315c7c
EZ
503 '(menu-item "Specific Option..." customize-option
504 :help "Change value of specific option"))
6fe9c658 505(define-key menu-bar-custom-menu [customize-changed-options]
7f315c7c
EZ
506 '(menu-item "Recently Changed Options..." customize-changed-options
507 :help "Customize options changed in recent versions"))
b0f661de
RS
508(define-key menu-bar-custom-menu [separator-3]
509 '("--"))
e6354b3e 510(define-key menu-bar-custom-menu [customize-browse]
7f315c7c
EZ
511 '(menu-item "Browse Customization Groups" customize-browse
512 :help "Browse all customization groups"))
b0f661de 513(define-key menu-bar-custom-menu [customize]
7f315c7c
EZ
514 '(menu-item "Top-level Customization Group" customize
515 :help "The master group called `Emacs'"))
a9f53ffb 516
7f315c7c 517;(defvar menu-bar-preferences-menu (make-sparse-keymap "Preferences"))
bacb2d12 518
7f315c7c 519(defmacro menu-bar-make-toggle (name variable doc message help &rest body)
bacb2d12
RS
520 `(progn
521 (defun ,name ()
e8dd28e7
RS
522 ,(concat "Toggle whether to " (downcase (substring help 0 1))
523 (substring help 1) ".")
bacb2d12
RS
524 (interactive)
525 (if ,(if body `(progn . ,body)
526 `(setq ,variable (not ,variable)))
506c6d61
DL
527 (message ,message "enabled")
528 (message ,message "disabled")))
7f315c7c
EZ
529 '(menu-item ,doc ,name
530 :help ,help
531 :button (:toggle . (and (boundp ',variable) ,variable)))))
532
533;;; Assemble all the top-level items of the "Options" menu
534(define-key menu-bar-options-menu [customize]
535 (list 'menu-item "Customize Emacs" menu-bar-custom-menu
536 :help "Full customization of every Emacs feature"))
10013d74
DL
537
538(defun menu-bar-options-save ()
539 "Save current values of Options menu items using Custom."
540 (interactive)
541 (dolist (elt '(debug-on-quit debug-on-error auto-compression-mode
542 case-fold-search truncate-lines show-paren-mode
543 transient-mark-mode global-font-lock-mode
544 current-language-environment default-input-method))
545 (if (default-value elt)
546 (customize-save-variable elt (default-value elt))))
547 (if (memq 'turn-on-auto-fill text-mode-hook)
548 (customize-save-variable 'text-mode-hook
549 (default-value 'text-mode-hook)))
550 (if (featurep 'saveplace)
551 (customize-save-variable 'save-place (default-value 'save-place)))
552 (if (featurep 'uniquify)
553 (customize-save-variable 'uniquify-buffer-name-style
554 (default-value 'uniquify-buffer-name-style))))
555
556(define-key menu-bar-options-menu [save]
48c9f054 557 '(menu-item "Save Options" menu-bar-options-save
10013d74
DL
558 :help "Save options set from the menu above"))
559
560(define-key menu-bar-options-menu [custom-separator]
561 '("--"))
562
7f315c7c
EZ
563(define-key menu-bar-options-menu [mule]
564 ;; It is better not to use backquote here,
565 ;; because that makes a bootstrapping problem
566 ;; if you need to recompile all the Lisp files using interpreted code.
567 (list 'menu-item "Mule (Multilingual Environment)" mule-menu-keymap
506c6d61
DL
568;; Most of the MULE menu actually does make sense in unibyte mode,
569;; e.g. language selection.
570;;; ':visible 'default-enable-multibyte-characters
7f315c7c
EZ
571 ':help "Default language, encodings, input method"))
572;(setq menu-bar-final-items (cons 'mule menu-bar-final-items))
573;(define-key menu-bar-options-menu [preferences]
574; (list 'menu-item "Preferences" menu-bar-preferences-menu
575; :help "Toggle important global options"))
576
577(define-key menu-bar-options-menu [mule-separator]
506c6d61 578 '("--"))
bacb2d12
RS
579
580(define-key menu-bar-options-menu [debug-on-quit]
581 (menu-bar-make-toggle toggle-debug-on-quit debug-on-quit
e8dd28e7 582 "Enter Debugger on Quit/C-g" "Debug on Quit %s"
7f315c7c 583 "Enter Lisp debugger when C-g is pressed"))
bacb2d12
RS
584(define-key menu-bar-options-menu [debug-on-error]
585 (menu-bar-make-toggle toggle-debug-on-error debug-on-error
e8dd28e7
RS
586 "Enter Debugger on Error" "Debug on Error %s"
587 "Enter Lisp debugger when an error is signaled"))
7f315c7c 588(define-key menu-bar-options-menu [debugger-separator]
bacb2d12 589 '("--"))
7f315c7c
EZ
590(define-key menu-bar-options-menu [toggle-auto-compression]
591 '(menu-item "Automatic File De/compression"
592 auto-compression-mode
593 :help "Transparently decompress compressed files"
594 :button (:toggle . (rassq 'jka-compr-handler
595 file-name-handler-alist))))
bacb2d12
RS
596(define-key menu-bar-options-menu [save-place]
597 (menu-bar-make-toggle toggle-save-place-globally save-place
89f1709f 598 "Save Place in Files between Sessions"
bacb2d12 599 "Saving place in files %s"
7f315c7c 600 "Save Emacs state for next session"
89f1709f 601 (require 'saveplace)
10013d74
DL
602 (setq-default save-place
603 (not (default-value save-place)))))
bacb2d12
RS
604(define-key menu-bar-options-menu [uniquify]
605 (menu-bar-make-toggle toggle-uniquify-buffer-names uniquify-buffer-name-style
89f1709f 606 "Use Directory Names in Buffer Names"
bacb2d12 607 "Directory name in buffer names (uniquify) %s"
e8dd28e7 608 "Uniquify buffer names by adding parent directory names"
bacb2d12
RS
609 (require 'uniquify)
610 (setq uniquify-buffer-name-style
611 (if (not uniquify-buffer-name-style)
612 'forward))))
7f315c7c
EZ
613(define-key menu-bar-options-menu [edit-options-separator]
614 '("--"))
3f51f129
RS
615(define-key menu-bar-options-menu [case-fold-search]
616 (menu-bar-make-toggle toggle-case-fold-search case-fold-search
7f315c7c
EZ
617 "Case-Insensitive Search"
618 "Case-Insensitive Search %s"
e8dd28e7 619 "Ignore letter-case in search"))
7f315c7c
EZ
620(define-key menu-bar-options-menu [auto-fill-mode]
621 '(menu-item "Word Wrap in Text Modes (Auto Fill)"
622 toggle-text-mode-auto-fill
623 :help "Automatically fill text between left and right margins"
624 :button (:toggle . (member 'turn-on-auto-fill text-mode-hook))))
43c35fd7
RS
625(define-key menu-bar-options-menu [truncate-lines]
626 (menu-bar-make-toggle
627 toggle-truncate-lines truncate-lines
506c6d61 628 "Truncate Long Lines in this Buffer" "Long Line Truncation %s"
e8dd28e7 629 "Truncate long lines on the screen"
43c35fd7
RS
630 (prog1 (setq truncate-lines (not truncate-lines))
631 (set-buffer-modified-p (buffer-modified-p)))))
7f315c7c
EZ
632(define-key menu-bar-options-menu [highlight-separator]
633 '("--"))
634(define-key menu-bar-options-menu [highlight-paren-mode]
635 (menu-bar-make-toggle toggle-highlight-paren-mode show-paren-mode
636 "Highlight Matching Parentheses"
637 "Show Paren mode %s"
d004e96a
AS
638 "Highlight matching and mismatched parentheses"
639 (show-paren-mode)))
bacb2d12
RS
640(define-key menu-bar-options-menu [transient-mark-mode]
641 (menu-bar-make-toggle toggle-transient-mark-mode transient-mark-mode
b2408b0f 642 "Highlight Marked Text (Transient Mark mode)"
7f315c7c 643 "Transient Mark mode %s"
79f5f9ec 644 "Highlight the marked region when active"))
8ad97b87 645(define-key menu-bar-options-menu [toggle-global-lazy-font-lock-mode]
89f1709f 646 (menu-bar-make-toggle toggle-global-lazy-font-lock-mode global-font-lock-mode
53ca4610
GM
647 "Highlight Syntactically"
648 "Global Font Lock mode %s"
e8dd28e7 649 "Highlight text based on language syntax"
dbcee71a 650 (global-font-lock-mode)))
7f315c7c 651
e5683624 652\f
7f315c7c
EZ
653;; The "Tools" menu items
654
e4ca8f8c
EZ
655(defun send-mail-item-name ()
656 (let* ((known-send-mail-commands '((sendmail-user-agent . "sendmail")
657 (mh-e-user-agent . "MH")
658 (message-user-agent . "Gnus Message")
659 (gnus-user-agent . "Gnus")))
660 (name (assq mail-user-agent known-send-mail-commands)))
661 (if name
662 (setq name (cdr name))
663 (setq name (symbol-name mail-user-agent))
664 (if (string-match "\\(.+\\)-user-agent" name)
665 (setq name (match-string 1 name))))
666 name))
667
0a1f9f1d
EZ
668(defun read-mail-item-name ()
669 (let* ((known-rmail-commands '((rmail . "RMAIL")
670 (mh-rmail . "MH")
671 (gnus . "Gnus")))
672 (known (assq read-mail-command known-rmail-commands)))
673 (if known (cdr known) (symbol-name read-mail-command))))
674
7f315c7c
EZ
675(defvar menu-bar-games-menu (make-sparse-keymap "Games"))
676
677(define-key menu-bar-tools-menu [games]
678 (list 'menu-item "Games" menu-bar-games-menu))
679
680(define-key menu-bar-tools-menu [separator-games]
681 '("--"))
682
7bff37dc
EZ
683(define-key menu-bar-games-menu [zone]
684 '(menu-item "Zone Out" zone
685 :help "Play tricks with Emacs display when Emacs is idle"))
7f315c7c
EZ
686(define-key menu-bar-games-menu [yow]
687 '(menu-item "Random Quotation" yow
688 :help "Display a random Zippy quotation"))
689(define-key menu-bar-games-menu [tetris]
690 '(menu-item "Tetris" tetris))
691(define-key menu-bar-games-menu [solitaire]
692 '(menu-item "Solitaire" solitaire))
693(define-key menu-bar-games-menu [snake]
694 '(menu-item "Snake" snake
695 :help "Move snake around avoiding collisions"))
696(define-key menu-bar-games-menu [mult]
697 '(menu-item "Multiplication Puzzle" mpuz
698 :help "Excercise brain with multiplication"))
699(define-key menu-bar-games-menu [life]
700 '(menu-item "Life" life
701 :help "Watch how John Conway's cellular automaton evolves"))
702(define-key menu-bar-games-menu [hanoi]
703 '(menu-item "Towers of Hanoi" hanoi
704 :help "Watch Towers-of-Hanoi puzzle solved by Emacs"))
705(define-key menu-bar-games-menu [gomoku]
706 '(menu-item "Gomoku" gomoku
707 :help "Mark 5 contiguous squares (like tic-tac-toe)"))
708(define-key menu-bar-games-menu [black-box]
709 '(menu-item "Blackbox" blackbox
710 :help "Find balls in a black box by shooting rays"))
711(define-key menu-bar-games-menu [adventure]
712 '(menu-item "Adventure" dunnet
713 :help "Dunnet, a text Adventure game for Emacs"))
714(define-key menu-bar-games-menu [5x5]
715 '(menu-item "5x5" 5x5
716 :help "Fill in all the squares on a 5x5 board"))
717
506c6d61 718(define-key menu-bar-tools-menu [calendar]
7f315c7c
EZ
719 '(menu-item "Display Calendar" calendar))
720(define-key menu-bar-tools-menu [speedbar]
721 '(menu-item "Display Speedbar" speedbar-frame-mode))
722(define-key menu-bar-tools-menu [directory-search]
723 '(menu-item "Directory Search" eudc-tools-menu
724 :help "Query directory servers via LDAP, CCSO PH/QI or BBDB"))
506c6d61 725(define-key menu-bar-tools-menu [compose-mail]
e4ca8f8c
EZ
726 (list
727 'menu-item `(format "Send Mail (with %s)" (send-mail-item-name))
728 'compose-mail
729 :visible `(and mail-user-agent (not (eq mail-user-agent 'ignore)))
730 :help "Send a mail message"))
506c6d61 731(define-key menu-bar-tools-menu [rmail]
0a1f9f1d
EZ
732 (list
733 'menu-item `(format "Read Mail (with %s)" (read-mail-item-name))
734 (lambda ()
735 (interactive)
736 (call-interactively read-mail-command))
e4ca8f8c 737 :visible `(and read-mail-command (not (eq read-mail-command 'ignore)))
0a1f9f1d 738 :help "Read your mail and reply to it"))
7f315c7c 739(define-key menu-bar-tools-menu [gnus]
0a1f9f1d 740 '(menu-item "Read Net News (Gnus)" gnus
7f315c7c
EZ
741 :help "Read network news groups"))
742
743(define-key menu-bar-tools-menu [separator-vc]
744 '("--"))
745
746(defvar vc-menu-map (make-sparse-keymap "Version Control"))
eccd9bd5
SM
747(define-key menu-bar-tools-menu [pcl-cvs]
748 `(menu-item "PCL-CVS" ,cvs-global-menu
749 :help "Module-level interface to CVS"))
7f315c7c
EZ
750(define-key menu-bar-tools-menu [vc]
751 (list 'menu-item "Version Control" vc-menu-map
752 :help "Interface to RCS, CVS, SCCS"))
753
754(define-key menu-bar-tools-menu [separator-compare]
755 '("--"))
756
757(define-key menu-bar-tools-menu [ediff-misc]
758 '(menu-item "Ediff Miscellanea" menu-bar-ediff-misc-menu
759 :help "Ediff manual, customization, sessions, etc."))
760(define-key menu-bar-tools-menu [epatch]
761 '(menu-item "Apply Patch" menu-bar-epatch-menu))
762(define-key menu-bar-tools-menu [ediff-merge]
763 '(menu-item "Merge" menu-bar-ediff-merge-menu
764 :help "Merge different revisions of files/directories"))
765(define-key menu-bar-tools-menu [compare]
766 '(menu-item "Compare (Ediff)" menu-bar-ediff-menu
767 :help "Display differences between files/directories"))
768
769
770(define-key menu-bar-tools-menu [separator-spell]
771 '("--"))
772
773(define-key menu-bar-tools-menu [spell]
774 '(menu-item "Spell Checking" ispell-menu-map))
775
776(define-key menu-bar-tools-menu [separator-prog]
777 '("--"))
778
779(define-key menu-bar-tools-menu [gdb]
780 '(menu-item "Debugger (GUD)..." gdb
0a1f9f1d 781 :help "Debug a program from within Emacs"))
7f315c7c
EZ
782(define-key menu-bar-tools-menu [shell-on-region]
783 '(menu-item "Shell Command on Region..." shell-command-on-region
784 :enable mark-active
785 :help "Pass marked region to a shell command"))
786(define-key menu-bar-tools-menu [shell]
787 '(menu-item "Shell Command..." shell-command
788 :help "Invoke a shell command and catch its output"))
789(define-key menu-bar-tools-menu [compile]
790 '(menu-item "Compile..." compile
791 :help "Invoke compiler or Make, view compilation errors"))
792(define-key menu-bar-tools-menu [grep]
793 '(menu-item "Search Files (Grep)..." grep
794 :help "Search files for strings or regexps (with Grep)"))
795
796\f
797;; The "Help" menu items
798
e5683624
RS
799(defvar menu-bar-describe-menu (make-sparse-keymap "Describe"))
800
7f315c7c
EZ
801(define-key menu-bar-describe-menu [mule-diag]
802 '(menu-item "Show All of Mule Status" mule-diag
803 :visible default-enable-multibyte-characters
804 :help "Display multilingual environment settings"))
805(define-key menu-bar-describe-menu [describe-coding-system]
806 '(menu-item "Describe Coding System..." describe-coding-system
807 :visible default-enable-multibyte-characters))
808(define-key menu-bar-describe-menu [describe-input-method]
809 '(menu-item "Describe Input Method..." describe-input-method
810 :visible default-enable-multibyte-characters
811 :help "Keyboard layout for specific input method"))
812(define-key menu-bar-describe-menu [describe-language-environment]
506c6d61
DL
813 (list 'menu-item "Describe Language Environment"
814 describe-language-environment-map
815 :help "Show multilingual settings for a specific language"))
7f315c7c
EZ
816
817(define-key menu-bar-describe-menu [separator-desc-mule]
506c6d61 818 '("--"))
7f315c7c
EZ
819
820(define-key menu-bar-describe-menu [list-keybindings]
821 '(menu-item "List Key Bindings" describe-bindings
822 :help "Display a list of all current keybindings"))
823(define-key menu-bar-describe-menu [list-keybindings]
824 '(menu-item "List Key Bindings" describe-bindings
825 :help "Display a list of all current keybindings"))
e5683624 826(define-key menu-bar-describe-menu [describe-variable]
7f315c7c
EZ
827 '(menu-item "Describe Variable..." describe-variable
828 :help "Display documentation of variable/option"))
e5683624 829(define-key menu-bar-describe-menu [describe-function]
7f315c7c
EZ
830 '(menu-item "Describe Function..." describe-function
831 :help "Display documentation of function/command"))
e5683624 832(define-key menu-bar-describe-menu [describe-key]
7f315c7c 833 '(menu-item "Describe Key..." describe-key
506c6d61
DL
834 ;; Users typically don't identify keys and menu items...
835 :help "Display documentation of command bound to a \
836key (or menu-item)"))
a16f6b16 837(define-key menu-bar-describe-menu [apropos-variables]
7f315c7c
EZ
838 '(menu-item "Apropos Variables..." apropos-variable
839 :help "List variables whose names match a regexp"))
a16f6b16 840(define-key menu-bar-describe-menu [apropos-commands]
7f315c7c
EZ
841 '(menu-item "Apropos Commands..." apropos-command
842 :help "List commands whose names match a regexp"))
e5683624 843(define-key menu-bar-describe-menu [describe-mode]
7f315c7c
EZ
844 '(menu-item "Describe Buffer Modes" describe-mode
845 :help "Describe this buffer's major and minor mode"))
e5683624
RS
846
847(defvar menu-bar-manuals-menu (make-sparse-keymap "Manuals"))
848
849(define-key menu-bar-manuals-menu [man]
7f315c7c
EZ
850 '(menu-item "Read Man Page..." manual-entry
851 :help "Man-page docs for external commands and libraries"))
e5683624
RS
852(define-key menu-bar-manuals-menu [sep2]
853 '("--"))
e5683624 854(define-key menu-bar-manuals-menu [info]
506c6d61 855 '(menu-item "Browse Manuals with Info" Info-directory
7f315c7c
EZ
856 :help "Read any of the installed manuals"))
857(define-key menu-bar-manuals-menu [command]
858 '(menu-item "Find Command in Manual" Info-goto-emacs-command-node
859 :help "Display manual section that describes a command"))
860(define-key menu-bar-manuals-menu [key]
861 '(menu-item "Find Key in Manual" Info-goto-emacs-key-command-node
862 :help "Display manual section that describes a key"))
bacb2d12 863
7f315c7c
EZ
864(define-key menu-bar-help-menu [eliza]
865 '(menu-item "Emacs Psychiatrist" doctor
866 :help "Our doctor will help you feel better"))
867(define-key menu-bar-help-menu [sep3]
868 '("--"))
f3e1e0dd 869(define-key menu-bar-help-menu [describe-no-warranty]
7f315c7c
EZ
870 '(menu-item "(Non)Warranty" describe-no-warranty
871 :help "Explain that Emacs has NO WARRANTY"))
f3e1e0dd 872(define-key menu-bar-help-menu [describe-copying]
7f315c7c
EZ
873 '(menu-item "Copying Conditions" describe-copying
874 :help "Show the Emacs license (GPL)"))
f3e1e0dd 875(define-key menu-bar-help-menu [describe-distribution]
7f315c7c
EZ
876 '(menu-item "Getting New Versions" describe-distribution
877 :help "How to get latest versions of Emacs"))
ae65cd84
DL
878(define-key menu-bar-help-menu [more]
879 '(menu-item "Find Extra Packages"
880 (lambda ()
881 (interactive)
882 (let (enable-local-variables)
883 (view-file (expand-file-name "MORE.STUFF"
884 data-directory))
885 (goto-address)))
886 :help "Where to find some extra packages and possible updates"))
efb166ff 887(define-key menu-bar-help-menu [emacs-version]
7f315c7c 888 '(menu-item "Show Emacs Version" emacs-version))
e5683624
RS
889(define-key menu-bar-help-menu [sep2]
890 '("--"))
260130bb 891(define-key menu-bar-help-menu [finder-by-keyword]
7f315c7c
EZ
892 '(menu-item "Find Emacs Packages..." finder-by-keyword
893 :help "Find packages and features by keyword"))
e5683624 894(define-key menu-bar-help-menu [describe]
7f315c7c
EZ
895 (list 'menu-item "Describe" menu-bar-describe-menu
896 :help "Describe commands, variables, keys"))
e5683624 897(define-key menu-bar-help-menu [manuals]
968280cc
EZ
898 (list 'menu-item "Manuals" menu-bar-manuals-menu
899 :help "Lookup commands and keys in docs, read manuals"))
e5683624
RS
900(define-key menu-bar-help-menu [sep1]
901 '("--"))
7f315c7c
EZ
902(define-key menu-bar-help-menu [report-emacs-bug]
903 '(menu-item "Send Bug Report..." report-emacs-bug
904 :help "Send e-mail to Emacs maintainers"))
ac0a4646
GM
905(define-key menu-bar-help-menu [order-emacs-manuals]
906 '(menu-item "Ordering Manuals" view-order-manuals
907 :help "How to order manuals from the Free Software Foundation"))
506c6d61 908(define-key menu-bar-help-menu [emacs-manual]
dbcee71a 909 '(menu-item "Read the Emacs Manual"
506c6d61 910 (lambda () (interactive) (info "emacs"))))
7f315c7c
EZ
911(define-key menu-bar-help-menu [emacs-problems]
912 '(menu-item "Emacs Known Problems" view-emacs-problems))
913(define-key menu-bar-help-menu [emacs-news]
914 '(menu-item "Emacs News" view-emacs-news
915 :help "New features of this version"))
916(define-key menu-bar-help-menu [emacs-faq]
917 '(menu-item "Emacs FAQ" view-emacs-FAQ))
451ec4e3
GM
918(define-key menu-bar-help-menu [emacs-tutorial-language-specific]
919 '(menu-item "Emacs Tutorial (choose language)..."
920 (lambda () (interactive) (help-with-tutorial t))
921 :help "Learn how to use Emacs (choose a language)"))
7f315c7c
EZ
922(define-key menu-bar-help-menu [emacs-tutorial]
923 '(menu-item "Emacs Tutorial" help-with-tutorial
924 :help "Learn how to use Emacs"))
889560ed 925
db774a16 926(defun kill-this-buffer () ; for the menubar
506c6d61 927 "Kill the current buffer."
db774a16
RS
928 (interactive)
929 (kill-buffer (current-buffer)))
930
2f1139a4
RS
931(defun kill-this-buffer-enabled-p ()
932 (let ((count 0)
933 (buffers (buffer-list)))
934 (while buffers
935 (or (string-match "^ " (buffer-name (car buffers)))
936 (setq count (1+ count)))
937 (setq buffers (cdr buffers)))
a6f8cbf1 938 (and (not (window-minibuffer-p (frame-selected-window menu-updating-frame)))
1f50590a
RS
939 (> count 1))))
940
1f50590a 941(put 'dired 'menu-enable
a6f8cbf1 942 '(not (window-minibuffer-p (frame-selected-window menu-updating-frame))))
1f50590a 943
a0213a97 944;; Permit deleting frame if it would leave a visible or iconified frame.
82a74107
KH
945(defun delete-frame-enabled-p ()
946 "Return non-nil if `delete-frame' should be enabled in the menu bar."
947 (let ((frames (frame-list))
27aa8132
RS
948 (count 0))
949 (while frames
950 (if (frame-visible-p (car frames))
951 (setq count (1+ count)))
952 (setq frames (cdr frames)))
953 (> count 1)))
2f1139a4 954
30e19aee
RS
955(defcustom yank-menu-length 20
956 "*Maximum length to display in the yank-menu."
957 :type 'integer
958 :group 'mouse)
3dd92899
KH
959
960(defun menu-bar-update-yank-menu (string old)
961 (let ((front (car (cdr yank-menu)))
962 (menu-string (if (<= (length string) yank-menu-length)
963 string
c3e1d435
RS
964 (concat
965 (substring string 0 (/ yank-menu-length 2))
966 "..."
967 (substring string (- (/ yank-menu-length 2)))))))
7c70a955
RS
968 ;; Don't let the menu string be all dashes
969 ;; because that has a special meaning in a menu.
970 (if (string-match "\\`-+\\'" menu-string)
971 (setq menu-string (concat menu-string " ")))
3dd92899
KH
972 ;; If we're supposed to be extending an existing string, and that
973 ;; string really is at the front of the menu, then update it in place.
974 (if (and old (or (eq old (car front))
975 (string= old (car front))))
dfabc98f 976 (progn
3dd92899
KH
977 (setcar front string)
978 (setcar (cdr front) menu-string))
979 (setcdr yank-menu
980 (cons
981 (cons string (cons menu-string 'menu-bar-select-yank))
982 (cdr yank-menu)))))
983 (if (> (length (cdr yank-menu)) kill-ring-max)
984 (setcdr (nthcdr kill-ring-max yank-menu) nil)))
985
4cca6fbd 986(put 'menu-bar-select-yank 'apropos-inhibit t)
3dd92899
KH
987(defun menu-bar-select-yank ()
988 (interactive "*")
989 (push-mark (point))
990 (insert last-command-event))
40954111 991\f
d0690d12
RS
992(defvar list-buffers-directory nil)
993
08e8171f
RS
994(defvar menu-bar-update-buffers-maxbuf)
995
09642d97
RS
996(defun menu-bar-select-buffer ()
997 (interactive)
998 (switch-to-buffer last-command-event))
999
1000(defun menu-bar-select-frame ()
1001 (interactive)
dfe5e27f
DL
1002 (let (frame)
1003 (dolist (f (frame-list))
1004 (when (equal last-command-event (frame-parameter f 'name))
1005 (setq frame f)))
1006 (make-frame-visible frame)
1007 (raise-frame frame)
1008 (select-frame frame)))
09642d97 1009
c171b42f
RS
1010(defun menu-bar-update-buffers-1 (elt)
1011 (cons (format
08e8171f 1012 (format "%%%ds %%s%%s %%s" menu-bar-update-buffers-maxbuf)
c171b42f
RS
1013 (cdr elt)
1014 (if (buffer-modified-p (car elt))
1015 "*" " ")
1016 (save-excursion
1017 (set-buffer (car elt))
1018 (if buffer-read-only "%" " "))
1019 (let ((file
1020 (or (buffer-file-name (car elt))
1021 (save-excursion
1022 (set-buffer (car elt))
1023 list-buffers-directory)
1024 "")))
1025 (setq file (or (file-name-directory file)
1026 ""))
1027 (if (> (length file) 20)
1028 (setq file (concat "..." (substring file -17))))
1029 file))
1030 (car elt)))
1031
06ff7539
RS
1032(defvar menu-bar-buffers-menu-list-buffers-entry nil)
1033
ee1dbceb 1034(defun menu-bar-update-buffers (&optional force)
29397c58 1035 ;; If user discards the Buffers item, play along.
4d587a6c 1036 (and (lookup-key (current-global-map) [menu-bar buffer])
ee1dbceb 1037 (or force (frame-or-buffer-changed-p))
29397c58
RS
1038 (let ((buffers (buffer-list))
1039 (frames (frame-list))
b3398af1 1040 (maxlen 0)
29397c58
RS
1041 buffers-menu frames-menu)
1042 ;; If requested, list only the N most recently selected buffers.
1043 (if (and (integerp buffers-menu-max-size)
1044 (> buffers-menu-max-size 1))
1045 (if (> (length buffers) buffers-menu-max-size)
1046 (setcdr (nthcdr buffers-menu-max-size buffers) nil)))
1047
1048 ;; Make the menu of buffers proper.
1049 (setq buffers-menu
1050 (cons "Select Buffer"
c171b42f
RS
1051 (let* ((buffer-list
1052 (mapcar 'list buffers))
1053 tail
08e8171f 1054 (menu-bar-update-buffers-maxbuf 0)
c171b42f
RS
1055 alist
1056 head)
1057 ;; Put into each element of buffer-list
1058 ;; the name for actual display,
1059 ;; perhaps truncated in the middle.
1060 (setq tail buffer-list)
1061 (while tail
1062 (let ((name (buffer-name (car (car tail)))))
1063 (setcdr (car tail)
1064 (if (> (length name) 27)
1065 (concat (substring name 0 12)
1066 "..."
1067 (substring name -12))
1068 name)))
1069 (setq tail (cdr tail)))
1070 ;; Compute the maximum length of any name.
1071 (setq tail buffer-list)
29397c58 1072 (while tail
c171b42f 1073 (or (eq ?\ (aref (cdr (car tail)) 0))
08e8171f
RS
1074 (setq menu-bar-update-buffers-maxbuf
1075 (max menu-bar-update-buffers-maxbuf
c171b42f 1076 (length (cdr (car tail))))))
29397c58 1077 (setq tail (cdr tail)))
c171b42f
RS
1078 ;; Set ALIST to an alist of the form
1079 ;; ITEM-STRING . BUFFER
1080 (setq tail buffer-list)
29397c58
RS
1081 (while tail
1082 (let ((elt (car tail)))
c171b42f 1083 (or (eq ?\ (aref (cdr elt) 0))
29397c58 1084 (setq alist (cons
c171b42f 1085 (menu-bar-update-buffers-1 elt)
29397c58
RS
1086 alist)))
1087 (and alist (> (length (car (car alist))) maxlen)
1088 (setq maxlen (length (car (car alist))))))
1089 (setq tail (cdr tail)))
1090 (setq alist (nreverse alist))
06ff7539
RS
1091 ;; Make the menu item for list-buffers
1092 ;; or reuse the one we already have.
1093 ;; The advantage in reusing one
1094 ;; is that it already has the keyboard equivalent
1095 ;; cached, so we save the time to look that up again.
1096 (or menu-bar-buffers-menu-list-buffers-entry
1097 (setq menu-bar-buffers-menu-list-buffers-entry
1098 (cons
1099 'list-buffers
1100 (cons
1101 ""
1102 'list-buffers))))
1103 ;; Update the item string for menu's new width.
1104 (setcar (cdr menu-bar-buffers-menu-list-buffers-entry)
1105 (concat (make-string (max (- (/ maxlen 2) 8) 0)
1106 ?\ )
1107 "List All Buffers"))
1108 ;; Now make the actual list of items,
1109 ;; ending with the list-buffers item.
f2116cf9 1110 (nconc (mapcar (lambda (pair)
10013d74
DL
1111 ;; This is somewhat risque, to use
1112 ;; the buffer name itself as the event
1113 ;; type to define, but it works.
1114 ;; It would not work to use the buffer
1115 ;; since a buffer as an event has its
1116 ;; own meaning.
1117 (nconc (list (buffer-name (cdr pair))
1118 (car pair)
1119 (cons nil nil))
1120 'menu-bar-select-buffer))
29397c58 1121 alist)
06ff7539 1122 (list menu-bar-buffers-menu-list-buffers-entry)))))
29397c58
RS
1123
1124
1125 ;; Make a Frames menu if we have more than one frame.
1126 (if (cdr frames)
b3398af1
RS
1127 (let ((name (concat (make-string (max (- (/ maxlen 2) 3) 0)
1128 ?\ )
1129 "Frames"))
1130 (frames-menu
1131 (cons 'keymap
1132 (cons "Select Frame"
10013d74
DL
1133 (mapcar
1134 (lambda (frame)
1135 (nconc
dfe5e27f 1136 (list (frame-parameter frame 'name)
ce9561ac 1137 (frame-parameter frame 'name)
10013d74
DL
1138 (cons nil nil))
1139 'menu-bar-select-frame))
b3398af1
RS
1140 frames)))))
1141 ;; Put it underneath the Buffers menu.
1142 (setq buffers-menu (cons (cons 'frames (cons name frames-menu))
1143 buffers-menu))))
29397c58
RS
1144 (if buffers-menu
1145 (setq buffers-menu (cons 'keymap buffers-menu)))
4d587a6c 1146 (define-key (current-global-map) [menu-bar buffer]
b3398af1 1147 (cons "Buffers" buffers-menu)))))
09642d97
RS
1148
1149(add-hook 'menu-bar-update-hook 'menu-bar-update-buffers)
2f1139a4 1150
3f557298
RS
1151(menu-bar-update-buffers)
1152
40954111
RS
1153;; this version is too slow
1154;;;(defun format-buffers-menu-line (buffer)
1155;;; "Returns a string to represent the given buffer in the Buffer menu.
1156;;;nil means the buffer shouldn't be listed. You can redefine this."
1157;;; (if (string-match "\\` " (buffer-name buffer))
1158;;; nil
1159;;; (save-excursion
1160;;; (set-buffer buffer)
1161;;; (let ((size (buffer-size)))
1162;;; (format "%s%s %-19s %6s %-15s %s"
1163;;; (if (buffer-modified-p) "*" " ")
1164;;; (if buffer-read-only "%" " ")
1165;;; (buffer-name)
1166;;; size
1167;;; mode-name
1168;;; (or (buffer-file-name) ""))))))
1169\f
25b048ee
RS
1170;;; Set up a menu bar menu for the minibuffer.
1171
d918e2dc
SM
1172(dolist (map (list minibuffer-local-ns-map
1173 minibuffer-local-must-match-map
1174 minibuffer-local-isearch-map
1175 minibuffer-local-map
1176 minibuffer-local-completion-map))
1177 (define-key map [menu-bar minibuf]
1178 (cons "Minibuf" (make-sparse-keymap "Minibuf"))))
1179
1180(dolist (map (list minibuffer-local-must-match-map
1181 minibuffer-local-completion-map))
1182 (define-key map [menu-bar minibuf ?\?]
1183 (list 'menu-item "List Completions" 'minibuffer-completion-help
1184 :help "Display all possible completions"))
1185 (define-key map [menu-bar minibuf space]
1186 (list 'menu-item "Complete Word" 'minibuffer-complete-word
1187 :help "Complete at most one word"))
1188 (define-key map [menu-bar minibuf tab]
1189 (list 'menu-item "Complete" 'minibuffer-complete
1190 :help "Complete as far as possible")))
1191
1192(dolist (map (list minibuffer-local-ns-map
1193 minibuffer-local-must-match-map
1194 minibuffer-local-isearch-map
1195 minibuffer-local-map
1196 minibuffer-local-completion-map))
1197 (define-key map [menu-bar minibuf quit]
1198 (list 'menu-item "Quit" 'keyboard-escape-quit
1199 :help "Abort input and exit minibuffer"))
1200 (define-key map [menu-bar minibuf return]
1201 (list 'menu-item "Enter" 'exit-minibuffer
1202 :help "Terminate input and exit minibuffer")))
25b048ee 1203\f
88a26eb4
DL
1204(defcustom menu-bar-mode nil
1205 "Toggle display of a menu bar on each frame.
1206Setting this variable directly does not take effect;
1207use either \\[customize] or the function `menu-bar-mode'."
1208 :set (lambda (symbol value)
1209 (menu-bar-mode (or value 0)))
1210 :initialize 'custom-initialize-default
1211 :type 'boolean
1212 :group 'frames)
7b7d6615 1213
057d49d1 1214(defun menu-bar-mode (flag)
dfd29450 1215 "Toggle display of a menu bar on each frame.
057d49d1
RS
1216This command applies to all frames that exist and frames to be
1217created in the future.
e1d18ad8
RS
1218With a numeric argument, if the argument is positive,
1219turn on menu bars; otherwise, turn off menu bars."
dad8e392 1220 (interactive "P")
dad8e392 1221
7b7d6615
RS
1222 ;; Make menu-bar-mode and default-frame-alist consistent.
1223 (let ((default (assq 'menu-bar-lines default-frame-alist)))
1224 (if default
1225 (setq menu-bar-mode (not (eq (cdr default) 0)))
1226 (setq default-frame-alist
1227 (cons (cons 'menu-bar-lines (if menu-bar-mode 1 0))
1228 default-frame-alist))))
1229
1230 ;; Toggle or set the mode, according to FLAG.
1231 (setq menu-bar-mode (if (null flag) (not menu-bar-mode)
1232 (> (prefix-numeric-value flag) 0)))
1233
1234 ;; Apply it to default-frame-alist.
1235 (let ((parameter (assq 'menu-bar-lines default-frame-alist)))
1236 (if (consp parameter)
1237 (setcdr parameter (if menu-bar-mode 1 0))
1238 (setq default-frame-alist
1239 (cons (cons 'menu-bar-lines (if menu-bar-mode 1 0))
1240 default-frame-alist))))
1241
1242 ;; Apply it to existing frames.
1243 (let ((frames (frame-list)))
1244 (while frames
1245 (let ((height (cdr (assq 'height (frame-parameters (car frames))))))
1246 (modify-frame-parameters (car frames)
1247 (list (cons 'menu-bar-lines
1248 (if menu-bar-mode 1 0))))
1249 (modify-frame-parameters (car frames)
1250 (list (cons 'height height))))
1251 (setq frames (cdr frames)))))
1db87953 1252
bffa5d4d
RS
1253(provide 'menu-bar)
1254
235aa29b 1255;;; menu-bar.el ends here