Some fixes to follow coding conventions in files maintained by FSF.
[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))
397 :help "Paste text cut/copied earlier"))
398(define-key menu-bar-edit-menu [paste]
399 '(menu-item "Paste" yank
400 :enable (and (x-selection-exists-p) (not buffer-read-only))
401 :help "Paste text most recently cut/copied"))
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"
638 "Highlight matching and mismatched parentheses"))
bacb2d12
RS
639(define-key menu-bar-options-menu [transient-mark-mode]
640 (menu-bar-make-toggle toggle-transient-mark-mode transient-mark-mode
89f1709f 641 "Transient Mark Mode (highlights region)"
7f315c7c
EZ
642 "Transient Mark mode %s"
643 "Highlight the marked region when it's active"))
8ad97b87 644(define-key menu-bar-options-menu [toggle-global-lazy-font-lock-mode]
89f1709f 645 (menu-bar-make-toggle toggle-global-lazy-font-lock-mode global-font-lock-mode
7f315c7c
EZ
646 "Highlight Syntax (Global Font Lock)"
647 "Syntax Highlighting %s"
e8dd28e7 648 "Highlight text based on language syntax"
dbcee71a 649 (global-font-lock-mode)))
7f315c7c 650
e5683624 651\f
7f315c7c
EZ
652;; The "Tools" menu items
653
e4ca8f8c
EZ
654(defun send-mail-item-name ()
655 (let* ((known-send-mail-commands '((sendmail-user-agent . "sendmail")
656 (mh-e-user-agent . "MH")
657 (message-user-agent . "Gnus Message")
658 (gnus-user-agent . "Gnus")))
659 (name (assq mail-user-agent known-send-mail-commands)))
660 (if name
661 (setq name (cdr name))
662 (setq name (symbol-name mail-user-agent))
663 (if (string-match "\\(.+\\)-user-agent" name)
664 (setq name (match-string 1 name))))
665 name))
666
0a1f9f1d
EZ
667(defun read-mail-item-name ()
668 (let* ((known-rmail-commands '((rmail . "RMAIL")
669 (mh-rmail . "MH")
670 (gnus . "Gnus")))
671 (known (assq read-mail-command known-rmail-commands)))
672 (if known (cdr known) (symbol-name read-mail-command))))
673
7f315c7c
EZ
674(defvar menu-bar-games-menu (make-sparse-keymap "Games"))
675
676(define-key menu-bar-tools-menu [games]
677 (list 'menu-item "Games" menu-bar-games-menu))
678
679(define-key menu-bar-tools-menu [separator-games]
680 '("--"))
681
7bff37dc
EZ
682(define-key menu-bar-games-menu [zone]
683 '(menu-item "Zone Out" zone
684 :help "Play tricks with Emacs display when Emacs is idle"))
7f315c7c
EZ
685(define-key menu-bar-games-menu [yow]
686 '(menu-item "Random Quotation" yow
687 :help "Display a random Zippy quotation"))
688(define-key menu-bar-games-menu [tetris]
689 '(menu-item "Tetris" tetris))
690(define-key menu-bar-games-menu [solitaire]
691 '(menu-item "Solitaire" solitaire))
692(define-key menu-bar-games-menu [snake]
693 '(menu-item "Snake" snake
694 :help "Move snake around avoiding collisions"))
695(define-key menu-bar-games-menu [mult]
696 '(menu-item "Multiplication Puzzle" mpuz
697 :help "Excercise brain with multiplication"))
698(define-key menu-bar-games-menu [life]
699 '(menu-item "Life" life
700 :help "Watch how John Conway's cellular automaton evolves"))
701(define-key menu-bar-games-menu [hanoi]
702 '(menu-item "Towers of Hanoi" hanoi
703 :help "Watch Towers-of-Hanoi puzzle solved by Emacs"))
704(define-key menu-bar-games-menu [gomoku]
705 '(menu-item "Gomoku" gomoku
706 :help "Mark 5 contiguous squares (like tic-tac-toe)"))
707(define-key menu-bar-games-menu [black-box]
708 '(menu-item "Blackbox" blackbox
709 :help "Find balls in a black box by shooting rays"))
710(define-key menu-bar-games-menu [adventure]
711 '(menu-item "Adventure" dunnet
712 :help "Dunnet, a text Adventure game for Emacs"))
713(define-key menu-bar-games-menu [5x5]
714 '(menu-item "5x5" 5x5
715 :help "Fill in all the squares on a 5x5 board"))
716
506c6d61 717(define-key menu-bar-tools-menu [calendar]
7f315c7c
EZ
718 '(menu-item "Display Calendar" calendar))
719(define-key menu-bar-tools-menu [speedbar]
720 '(menu-item "Display Speedbar" speedbar-frame-mode))
721(define-key menu-bar-tools-menu [directory-search]
722 '(menu-item "Directory Search" eudc-tools-menu
723 :help "Query directory servers via LDAP, CCSO PH/QI or BBDB"))
506c6d61 724(define-key menu-bar-tools-menu [compose-mail]
e4ca8f8c
EZ
725 (list
726 'menu-item `(format "Send Mail (with %s)" (send-mail-item-name))
727 'compose-mail
728 :visible `(and mail-user-agent (not (eq mail-user-agent 'ignore)))
729 :help "Send a mail message"))
506c6d61 730(define-key menu-bar-tools-menu [rmail]
0a1f9f1d
EZ
731 (list
732 'menu-item `(format "Read Mail (with %s)" (read-mail-item-name))
733 (lambda ()
734 (interactive)
735 (call-interactively read-mail-command))
e4ca8f8c 736 :visible `(and read-mail-command (not (eq read-mail-command 'ignore)))
0a1f9f1d 737 :help "Read your mail and reply to it"))
7f315c7c 738(define-key menu-bar-tools-menu [gnus]
0a1f9f1d 739 '(menu-item "Read Net News (Gnus)" gnus
7f315c7c
EZ
740 :help "Read network news groups"))
741
742(define-key menu-bar-tools-menu [separator-vc]
743 '("--"))
744
745(defvar vc-menu-map (make-sparse-keymap "Version Control"))
eccd9bd5
SM
746(define-key menu-bar-tools-menu [pcl-cvs]
747 `(menu-item "PCL-CVS" ,cvs-global-menu
748 :help "Module-level interface to CVS"))
7f315c7c
EZ
749(define-key menu-bar-tools-menu [vc]
750 (list 'menu-item "Version Control" vc-menu-map
751 :help "Interface to RCS, CVS, SCCS"))
752
753(define-key menu-bar-tools-menu [separator-compare]
754 '("--"))
755
756(define-key menu-bar-tools-menu [ediff-misc]
757 '(menu-item "Ediff Miscellanea" menu-bar-ediff-misc-menu
758 :help "Ediff manual, customization, sessions, etc."))
759(define-key menu-bar-tools-menu [epatch]
760 '(menu-item "Apply Patch" menu-bar-epatch-menu))
761(define-key menu-bar-tools-menu [ediff-merge]
762 '(menu-item "Merge" menu-bar-ediff-merge-menu
763 :help "Merge different revisions of files/directories"))
764(define-key menu-bar-tools-menu [compare]
765 '(menu-item "Compare (Ediff)" menu-bar-ediff-menu
766 :help "Display differences between files/directories"))
767
768
769(define-key menu-bar-tools-menu [separator-spell]
770 '("--"))
771
772(define-key menu-bar-tools-menu [spell]
773 '(menu-item "Spell Checking" ispell-menu-map))
774
775(define-key menu-bar-tools-menu [separator-prog]
776 '("--"))
777
778(define-key menu-bar-tools-menu [gdb]
779 '(menu-item "Debugger (GUD)..." gdb
0a1f9f1d 780 :help "Debug a program from within Emacs"))
7f315c7c
EZ
781(define-key menu-bar-tools-menu [shell-on-region]
782 '(menu-item "Shell Command on Region..." shell-command-on-region
783 :enable mark-active
784 :help "Pass marked region to a shell command"))
785(define-key menu-bar-tools-menu [shell]
786 '(menu-item "Shell Command..." shell-command
787 :help "Invoke a shell command and catch its output"))
788(define-key menu-bar-tools-menu [compile]
789 '(menu-item "Compile..." compile
790 :help "Invoke compiler or Make, view compilation errors"))
791(define-key menu-bar-tools-menu [grep]
792 '(menu-item "Search Files (Grep)..." grep
793 :help "Search files for strings or regexps (with Grep)"))
794
795\f
796;; The "Help" menu items
797
e5683624
RS
798(defvar menu-bar-describe-menu (make-sparse-keymap "Describe"))
799
7f315c7c
EZ
800(define-key menu-bar-describe-menu [mule-diag]
801 '(menu-item "Show All of Mule Status" mule-diag
802 :visible default-enable-multibyte-characters
803 :help "Display multilingual environment settings"))
804(define-key menu-bar-describe-menu [describe-coding-system]
805 '(menu-item "Describe Coding System..." describe-coding-system
806 :visible default-enable-multibyte-characters))
807(define-key menu-bar-describe-menu [describe-input-method]
808 '(menu-item "Describe Input Method..." describe-input-method
809 :visible default-enable-multibyte-characters
810 :help "Keyboard layout for specific input method"))
811(define-key menu-bar-describe-menu [describe-language-environment]
506c6d61
DL
812 (list 'menu-item "Describe Language Environment"
813 describe-language-environment-map
814 :help "Show multilingual settings for a specific language"))
7f315c7c
EZ
815
816(define-key menu-bar-describe-menu [separator-desc-mule]
506c6d61 817 '("--"))
7f315c7c
EZ
818
819(define-key menu-bar-describe-menu [list-keybindings]
820 '(menu-item "List Key Bindings" describe-bindings
821 :help "Display a list of all current keybindings"))
822(define-key menu-bar-describe-menu [list-keybindings]
823 '(menu-item "List Key Bindings" describe-bindings
824 :help "Display a list of all current keybindings"))
e5683624 825(define-key menu-bar-describe-menu [describe-variable]
7f315c7c
EZ
826 '(menu-item "Describe Variable..." describe-variable
827 :help "Display documentation of variable/option"))
e5683624 828(define-key menu-bar-describe-menu [describe-function]
7f315c7c
EZ
829 '(menu-item "Describe Function..." describe-function
830 :help "Display documentation of function/command"))
e5683624 831(define-key menu-bar-describe-menu [describe-key]
7f315c7c 832 '(menu-item "Describe Key..." describe-key
506c6d61
DL
833 ;; Users typically don't identify keys and menu items...
834 :help "Display documentation of command bound to a \
835key (or menu-item)"))
a16f6b16 836(define-key menu-bar-describe-menu [apropos-variables]
7f315c7c
EZ
837 '(menu-item "Apropos Variables..." apropos-variable
838 :help "List variables whose names match a regexp"))
a16f6b16 839(define-key menu-bar-describe-menu [apropos-commands]
7f315c7c
EZ
840 '(menu-item "Apropos Commands..." apropos-command
841 :help "List commands whose names match a regexp"))
e5683624 842(define-key menu-bar-describe-menu [describe-mode]
7f315c7c
EZ
843 '(menu-item "Describe Buffer Modes" describe-mode
844 :help "Describe this buffer's major and minor mode"))
e5683624
RS
845
846(defvar menu-bar-manuals-menu (make-sparse-keymap "Manuals"))
847
848(define-key menu-bar-manuals-menu [man]
7f315c7c
EZ
849 '(menu-item "Read Man Page..." manual-entry
850 :help "Man-page docs for external commands and libraries"))
e5683624
RS
851(define-key menu-bar-manuals-menu [sep2]
852 '("--"))
e5683624 853(define-key menu-bar-manuals-menu [info]
506c6d61 854 '(menu-item "Browse Manuals with Info" Info-directory
7f315c7c
EZ
855 :help "Read any of the installed manuals"))
856(define-key menu-bar-manuals-menu [command]
857 '(menu-item "Find Command in Manual" Info-goto-emacs-command-node
858 :help "Display manual section that describes a command"))
859(define-key menu-bar-manuals-menu [key]
860 '(menu-item "Find Key in Manual" Info-goto-emacs-key-command-node
861 :help "Display manual section that describes a key"))
bacb2d12 862
7f315c7c
EZ
863(define-key menu-bar-help-menu [eliza]
864 '(menu-item "Emacs Psychiatrist" doctor
865 :help "Our doctor will help you feel better"))
866(define-key menu-bar-help-menu [sep3]
867 '("--"))
f3e1e0dd 868(define-key menu-bar-help-menu [describe-no-warranty]
7f315c7c
EZ
869 '(menu-item "(Non)Warranty" describe-no-warranty
870 :help "Explain that Emacs has NO WARRANTY"))
f3e1e0dd 871(define-key menu-bar-help-menu [describe-copying]
7f315c7c
EZ
872 '(menu-item "Copying Conditions" describe-copying
873 :help "Show the Emacs license (GPL)"))
f3e1e0dd 874(define-key menu-bar-help-menu [describe-distribution]
7f315c7c
EZ
875 '(menu-item "Getting New Versions" describe-distribution
876 :help "How to get latest versions of Emacs"))
ae65cd84
DL
877(define-key menu-bar-help-menu [more]
878 '(menu-item "Find Extra Packages"
879 (lambda ()
880 (interactive)
881 (let (enable-local-variables)
882 (view-file (expand-file-name "MORE.STUFF"
883 data-directory))
884 (goto-address)))
885 :help "Where to find some extra packages and possible updates"))
efb166ff 886(define-key menu-bar-help-menu [emacs-version]
7f315c7c 887 '(menu-item "Show Emacs Version" emacs-version))
e5683624
RS
888(define-key menu-bar-help-menu [sep2]
889 '("--"))
260130bb 890(define-key menu-bar-help-menu [finder-by-keyword]
7f315c7c
EZ
891 '(menu-item "Find Emacs Packages..." finder-by-keyword
892 :help "Find packages and features by keyword"))
e5683624 893(define-key menu-bar-help-menu [describe]
7f315c7c
EZ
894 (list 'menu-item "Describe" menu-bar-describe-menu
895 :help "Describe commands, variables, keys"))
e5683624 896(define-key menu-bar-help-menu [manuals]
968280cc
EZ
897 (list 'menu-item "Manuals" menu-bar-manuals-menu
898 :help "Lookup commands and keys in docs, read manuals"))
e5683624
RS
899(define-key menu-bar-help-menu [sep1]
900 '("--"))
7f315c7c
EZ
901(define-key menu-bar-help-menu [report-emacs-bug]
902 '(menu-item "Send Bug Report..." report-emacs-bug
903 :help "Send e-mail to Emacs maintainers"))
ac0a4646
GM
904(define-key menu-bar-help-menu [order-emacs-manuals]
905 '(menu-item "Ordering Manuals" view-order-manuals
906 :help "How to order manuals from the Free Software Foundation"))
506c6d61 907(define-key menu-bar-help-menu [emacs-manual]
dbcee71a 908 '(menu-item "Read the Emacs Manual"
506c6d61 909 (lambda () (interactive) (info "emacs"))))
7f315c7c
EZ
910(define-key menu-bar-help-menu [emacs-problems]
911 '(menu-item "Emacs Known Problems" view-emacs-problems))
912(define-key menu-bar-help-menu [emacs-news]
913 '(menu-item "Emacs News" view-emacs-news
914 :help "New features of this version"))
915(define-key menu-bar-help-menu [emacs-faq]
916 '(menu-item "Emacs FAQ" view-emacs-FAQ))
451ec4e3
GM
917(define-key menu-bar-help-menu [emacs-tutorial-language-specific]
918 '(menu-item "Emacs Tutorial (choose language)..."
919 (lambda () (interactive) (help-with-tutorial t))
920 :help "Learn how to use Emacs (choose a language)"))
7f315c7c
EZ
921(define-key menu-bar-help-menu [emacs-tutorial]
922 '(menu-item "Emacs Tutorial" help-with-tutorial
923 :help "Learn how to use Emacs"))
889560ed 924
db774a16 925(defun kill-this-buffer () ; for the menubar
506c6d61 926 "Kill the current buffer."
db774a16
RS
927 (interactive)
928 (kill-buffer (current-buffer)))
929
2f1139a4
RS
930(defun kill-this-buffer-enabled-p ()
931 (let ((count 0)
932 (buffers (buffer-list)))
933 (while buffers
934 (or (string-match "^ " (buffer-name (car buffers)))
935 (setq count (1+ count)))
936 (setq buffers (cdr buffers)))
a6f8cbf1 937 (and (not (window-minibuffer-p (frame-selected-window menu-updating-frame)))
1f50590a
RS
938 (> count 1))))
939
1f50590a 940(put 'dired 'menu-enable
a6f8cbf1 941 '(not (window-minibuffer-p (frame-selected-window menu-updating-frame))))
1f50590a 942
a0213a97 943;; Permit deleting frame if it would leave a visible or iconified frame.
82a74107
KH
944(defun delete-frame-enabled-p ()
945 "Return non-nil if `delete-frame' should be enabled in the menu bar."
946 (let ((frames (frame-list))
27aa8132
RS
947 (count 0))
948 (while frames
949 (if (frame-visible-p (car frames))
950 (setq count (1+ count)))
951 (setq frames (cdr frames)))
952 (> count 1)))
2f1139a4 953
30e19aee
RS
954(defcustom yank-menu-length 20
955 "*Maximum length to display in the yank-menu."
956 :type 'integer
957 :group 'mouse)
3dd92899
KH
958
959(defun menu-bar-update-yank-menu (string old)
960 (let ((front (car (cdr yank-menu)))
961 (menu-string (if (<= (length string) yank-menu-length)
962 string
c3e1d435
RS
963 (concat
964 (substring string 0 (/ yank-menu-length 2))
965 "..."
966 (substring string (- (/ yank-menu-length 2)))))))
7c70a955
RS
967 ;; Don't let the menu string be all dashes
968 ;; because that has a special meaning in a menu.
969 (if (string-match "\\`-+\\'" menu-string)
970 (setq menu-string (concat menu-string " ")))
3dd92899
KH
971 ;; If we're supposed to be extending an existing string, and that
972 ;; string really is at the front of the menu, then update it in place.
973 (if (and old (or (eq old (car front))
974 (string= old (car front))))
dfabc98f 975 (progn
3dd92899
KH
976 (setcar front string)
977 (setcar (cdr front) menu-string))
978 (setcdr yank-menu
979 (cons
980 (cons string (cons menu-string 'menu-bar-select-yank))
981 (cdr yank-menu)))))
982 (if (> (length (cdr yank-menu)) kill-ring-max)
983 (setcdr (nthcdr kill-ring-max yank-menu) nil)))
984
4cca6fbd 985(put 'menu-bar-select-yank 'apropos-inhibit t)
3dd92899
KH
986(defun menu-bar-select-yank ()
987 (interactive "*")
988 (push-mark (point))
989 (insert last-command-event))
40954111 990\f
d0690d12
RS
991(defvar list-buffers-directory nil)
992
08e8171f
RS
993(defvar menu-bar-update-buffers-maxbuf)
994
09642d97
RS
995(defun menu-bar-select-buffer ()
996 (interactive)
997 (switch-to-buffer last-command-event))
998
999(defun menu-bar-select-frame ()
1000 (interactive)
dfe5e27f
DL
1001 (let (frame)
1002 (dolist (f (frame-list))
1003 (when (equal last-command-event (frame-parameter f 'name))
1004 (setq frame f)))
1005 (make-frame-visible frame)
1006 (raise-frame frame)
1007 (select-frame frame)))
09642d97 1008
c171b42f
RS
1009(defun menu-bar-update-buffers-1 (elt)
1010 (cons (format
08e8171f 1011 (format "%%%ds %%s%%s %%s" menu-bar-update-buffers-maxbuf)
c171b42f
RS
1012 (cdr elt)
1013 (if (buffer-modified-p (car elt))
1014 "*" " ")
1015 (save-excursion
1016 (set-buffer (car elt))
1017 (if buffer-read-only "%" " "))
1018 (let ((file
1019 (or (buffer-file-name (car elt))
1020 (save-excursion
1021 (set-buffer (car elt))
1022 list-buffers-directory)
1023 "")))
1024 (setq file (or (file-name-directory file)
1025 ""))
1026 (if (> (length file) 20)
1027 (setq file (concat "..." (substring file -17))))
1028 file))
1029 (car elt)))
1030
06ff7539
RS
1031(defvar menu-bar-buffers-menu-list-buffers-entry nil)
1032
ee1dbceb 1033(defun menu-bar-update-buffers (&optional force)
29397c58 1034 ;; If user discards the Buffers item, play along.
4d587a6c 1035 (and (lookup-key (current-global-map) [menu-bar buffer])
ee1dbceb 1036 (or force (frame-or-buffer-changed-p))
29397c58
RS
1037 (let ((buffers (buffer-list))
1038 (frames (frame-list))
b3398af1 1039 (maxlen 0)
29397c58
RS
1040 buffers-menu frames-menu)
1041 ;; If requested, list only the N most recently selected buffers.
1042 (if (and (integerp buffers-menu-max-size)
1043 (> buffers-menu-max-size 1))
1044 (if (> (length buffers) buffers-menu-max-size)
1045 (setcdr (nthcdr buffers-menu-max-size buffers) nil)))
1046
1047 ;; Make the menu of buffers proper.
1048 (setq buffers-menu
1049 (cons "Select Buffer"
c171b42f
RS
1050 (let* ((buffer-list
1051 (mapcar 'list buffers))
1052 tail
08e8171f 1053 (menu-bar-update-buffers-maxbuf 0)
c171b42f
RS
1054 alist
1055 head)
1056 ;; Put into each element of buffer-list
1057 ;; the name for actual display,
1058 ;; perhaps truncated in the middle.
1059 (setq tail buffer-list)
1060 (while tail
1061 (let ((name (buffer-name (car (car tail)))))
1062 (setcdr (car tail)
1063 (if (> (length name) 27)
1064 (concat (substring name 0 12)
1065 "..."
1066 (substring name -12))
1067 name)))
1068 (setq tail (cdr tail)))
1069 ;; Compute the maximum length of any name.
1070 (setq tail buffer-list)
29397c58 1071 (while tail
c171b42f 1072 (or (eq ?\ (aref (cdr (car tail)) 0))
08e8171f
RS
1073 (setq menu-bar-update-buffers-maxbuf
1074 (max menu-bar-update-buffers-maxbuf
c171b42f 1075 (length (cdr (car tail))))))
29397c58 1076 (setq tail (cdr tail)))
c171b42f
RS
1077 ;; Set ALIST to an alist of the form
1078 ;; ITEM-STRING . BUFFER
1079 (setq tail buffer-list)
29397c58
RS
1080 (while tail
1081 (let ((elt (car tail)))
c171b42f 1082 (or (eq ?\ (aref (cdr elt) 0))
29397c58 1083 (setq alist (cons
c171b42f 1084 (menu-bar-update-buffers-1 elt)
29397c58
RS
1085 alist)))
1086 (and alist (> (length (car (car alist))) maxlen)
1087 (setq maxlen (length (car (car alist))))))
1088 (setq tail (cdr tail)))
1089 (setq alist (nreverse alist))
06ff7539
RS
1090 ;; Make the menu item for list-buffers
1091 ;; or reuse the one we already have.
1092 ;; The advantage in reusing one
1093 ;; is that it already has the keyboard equivalent
1094 ;; cached, so we save the time to look that up again.
1095 (or menu-bar-buffers-menu-list-buffers-entry
1096 (setq menu-bar-buffers-menu-list-buffers-entry
1097 (cons
1098 'list-buffers
1099 (cons
1100 ""
1101 'list-buffers))))
1102 ;; Update the item string for menu's new width.
1103 (setcar (cdr menu-bar-buffers-menu-list-buffers-entry)
1104 (concat (make-string (max (- (/ maxlen 2) 8) 0)
1105 ?\ )
1106 "List All Buffers"))
1107 ;; Now make the actual list of items,
1108 ;; ending with the list-buffers item.
f2116cf9 1109 (nconc (mapcar (lambda (pair)
10013d74
DL
1110 ;; This is somewhat risque, to use
1111 ;; the buffer name itself as the event
1112 ;; type to define, but it works.
1113 ;; It would not work to use the buffer
1114 ;; since a buffer as an event has its
1115 ;; own meaning.
1116 (nconc (list (buffer-name (cdr pair))
1117 (car pair)
1118 (cons nil nil))
1119 'menu-bar-select-buffer))
29397c58 1120 alist)
06ff7539 1121 (list menu-bar-buffers-menu-list-buffers-entry)))))
29397c58
RS
1122
1123
1124 ;; Make a Frames menu if we have more than one frame.
1125 (if (cdr frames)
b3398af1
RS
1126 (let ((name (concat (make-string (max (- (/ maxlen 2) 3) 0)
1127 ?\ )
1128 "Frames"))
1129 (frames-menu
1130 (cons 'keymap
1131 (cons "Select Frame"
10013d74
DL
1132 (mapcar
1133 (lambda (frame)
1134 (nconc
dfe5e27f 1135 (list (frame-parameter frame 'name)
ce9561ac 1136 (frame-parameter frame 'name)
10013d74
DL
1137 (cons nil nil))
1138 'menu-bar-select-frame))
b3398af1
RS
1139 frames)))))
1140 ;; Put it underneath the Buffers menu.
1141 (setq buffers-menu (cons (cons 'frames (cons name frames-menu))
1142 buffers-menu))))
29397c58
RS
1143 (if buffers-menu
1144 (setq buffers-menu (cons 'keymap buffers-menu)))
4d587a6c 1145 (define-key (current-global-map) [menu-bar buffer]
b3398af1 1146 (cons "Buffers" buffers-menu)))))
09642d97
RS
1147
1148(add-hook 'menu-bar-update-hook 'menu-bar-update-buffers)
2f1139a4 1149
3f557298
RS
1150(menu-bar-update-buffers)
1151
40954111
RS
1152;; this version is too slow
1153;;;(defun format-buffers-menu-line (buffer)
1154;;; "Returns a string to represent the given buffer in the Buffer menu.
1155;;;nil means the buffer shouldn't be listed. You can redefine this."
1156;;; (if (string-match "\\` " (buffer-name buffer))
1157;;; nil
1158;;; (save-excursion
1159;;; (set-buffer buffer)
1160;;; (let ((size (buffer-size)))
1161;;; (format "%s%s %-19s %6s %-15s %s"
1162;;; (if (buffer-modified-p) "*" " ")
1163;;; (if buffer-read-only "%" " ")
1164;;; (buffer-name)
1165;;; size
1166;;; mode-name
1167;;; (or (buffer-file-name) ""))))))
1168\f
25b048ee
RS
1169;;; Set up a menu bar menu for the minibuffer.
1170
d918e2dc
SM
1171(dolist (map (list minibuffer-local-ns-map
1172 minibuffer-local-must-match-map
1173 minibuffer-local-isearch-map
1174 minibuffer-local-map
1175 minibuffer-local-completion-map))
1176 (define-key map [menu-bar minibuf]
1177 (cons "Minibuf" (make-sparse-keymap "Minibuf"))))
1178
1179(dolist (map (list minibuffer-local-must-match-map
1180 minibuffer-local-completion-map))
1181 (define-key map [menu-bar minibuf ?\?]
1182 (list 'menu-item "List Completions" 'minibuffer-completion-help
1183 :help "Display all possible completions"))
1184 (define-key map [menu-bar minibuf space]
1185 (list 'menu-item "Complete Word" 'minibuffer-complete-word
1186 :help "Complete at most one word"))
1187 (define-key map [menu-bar minibuf tab]
1188 (list 'menu-item "Complete" 'minibuffer-complete
1189 :help "Complete as far as possible")))
1190
1191(dolist (map (list minibuffer-local-ns-map
1192 minibuffer-local-must-match-map
1193 minibuffer-local-isearch-map
1194 minibuffer-local-map
1195 minibuffer-local-completion-map))
1196 (define-key map [menu-bar minibuf quit]
1197 (list 'menu-item "Quit" 'keyboard-escape-quit
1198 :help "Abort input and exit minibuffer"))
1199 (define-key map [menu-bar minibuf return]
1200 (list 'menu-item "Enter" 'exit-minibuffer
1201 :help "Terminate input and exit minibuffer")))
25b048ee 1202\f
88a26eb4
DL
1203(defcustom menu-bar-mode nil
1204 "Toggle display of a menu bar on each frame.
1205Setting this variable directly does not take effect;
1206use either \\[customize] or the function `menu-bar-mode'."
1207 :set (lambda (symbol value)
1208 (menu-bar-mode (or value 0)))
1209 :initialize 'custom-initialize-default
1210 :type 'boolean
1211 :group 'frames)
7b7d6615 1212
057d49d1 1213(defun menu-bar-mode (flag)
dfd29450 1214 "Toggle display of a menu bar on each frame.
057d49d1
RS
1215This command applies to all frames that exist and frames to be
1216created in the future.
e1d18ad8
RS
1217With a numeric argument, if the argument is positive,
1218turn on menu bars; otherwise, turn off menu bars."
dad8e392 1219 (interactive "P")
dad8e392 1220
7b7d6615
RS
1221 ;; Make menu-bar-mode and default-frame-alist consistent.
1222 (let ((default (assq 'menu-bar-lines default-frame-alist)))
1223 (if default
1224 (setq menu-bar-mode (not (eq (cdr default) 0)))
1225 (setq default-frame-alist
1226 (cons (cons 'menu-bar-lines (if menu-bar-mode 1 0))
1227 default-frame-alist))))
1228
1229 ;; Toggle or set the mode, according to FLAG.
1230 (setq menu-bar-mode (if (null flag) (not menu-bar-mode)
1231 (> (prefix-numeric-value flag) 0)))
1232
1233 ;; Apply it to default-frame-alist.
1234 (let ((parameter (assq 'menu-bar-lines default-frame-alist)))
1235 (if (consp parameter)
1236 (setcdr parameter (if menu-bar-mode 1 0))
1237 (setq default-frame-alist
1238 (cons (cons 'menu-bar-lines (if menu-bar-mode 1 0))
1239 default-frame-alist))))
1240
1241 ;; Apply it to existing frames.
1242 (let ((frames (frame-list)))
1243 (while frames
1244 (let ((height (cdr (assq 'height (frame-parameters (car frames))))))
1245 (modify-frame-parameters (car frames)
1246 (list (cons 'menu-bar-lines
1247 (if menu-bar-mode 1 0))))
1248 (modify-frame-parameters (car frames)
1249 (list (cons 'height height))))
1250 (setq frames (cdr frames)))))
1db87953 1251
bffa5d4d
RS
1252(provide 'menu-bar)
1253
235aa29b 1254;;; menu-bar.el ends here