Mercurial > emacs
comparison man/frames.texi @ 65947:97a58f78b188
* frames.texi (Speedbar): Add information on keybindings,
dismissing the speedbar, and buffer display mode. Link to
speedbar manual.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Sun, 09 Oct 2005 15:44:34 +0000 |
parents | a9c074731be2 |
children | 982867e0921a |
comparison
equal
deleted
inserted
replaced
65946:083803e6c371 | 65947:97a58f78b188 |
---|---|
546 | 546 |
547 @node Speedbar | 547 @node Speedbar |
548 @section Making and Using a Speedbar Frame | 548 @section Making and Using a Speedbar Frame |
549 @cindex speedbar | 549 @cindex speedbar |
550 | 550 |
551 An Emacs frame can have a @dfn{speedbar}, which is a vertical window | 551 The @dfn{Speedbar} is a special frame that is used to summarize |
552 that serves as a scrollable menu of files you could visit and tags | 552 information related to other buffers. Normally, it displays a menu of |
553 within those files. To create a speedbar, type @kbd{M-x speedbar}; this | 553 files you could visit and tags within those files. Type @kbd{M-x |
554 creates a speedbar window for the selected frame. From then on, you can | 554 speedbar} to enable the speedbar and associate it with the current |
555 click on a file name in the speedbar to visit that file in the | 555 frame (which is called the speedbar's @dfn{attached frame}). |
556 corresponding Emacs frame, or click on a tag name to jump to that tag in | 556 |
557 the Emacs frame. | 557 Currently, only one speedbar is supported at a time. To dismiss the |
558 | 558 speedbar, select it and type @kbd{q} or @kbd{M-x speedbar}, or delete |
559 Initially the speedbar lists the immediate contents of the current | 559 the frame or window normally. You can then attach the speedbar to a |
560 directory, one file per line. Each line also has a box, @samp{[+]} or | 560 different frame by calling @kbd{M-x speedbar} from that frame. |
561 @samp{<+>}, that you can click on with @kbd{Mouse-2} to ``open up'' the | 561 |
562 contents of that item. If the line names a directory, opening it adds | 562 When you initially launch the speedbar, it starts in @dfn{File |
563 Display Mode}, showing the current directory of the selected window of | |
564 the attached frame, one file per line. Clicking on a file name visits | |
565 that file in the attached frame, and clicking on a directory name | |
566 shows that directory in the speedbar (@pxref{Mouse References}). Each | |
567 line also has a box, @samp{[+]} or @samp{<+>}, that you can click on | |
568 to @dfn{expand} the contents of that item. Expanding a directory adds | |
563 the contents of that directory to the speedbar display, underneath the | 569 the contents of that directory to the speedbar display, underneath the |
564 directory's own line. If the line lists an ordinary file, opening it up | 570 directory's own line. Expanding an ordinary file adds a list of the |
565 adds a list of the tags in that file to the speedbar display. When a | 571 tags in that file to the speedbar display; you can click on a tag name |
566 file is opened up, the @samp{[+]} changes to @samp{[-]}; you can click | 572 to jump to that tag in the attached frame. When a file or directory |
567 on that box to ``close up'' that file (hide its contents). | 573 is expanded, the @samp{[+]} changes to @samp{[-]}; you can click on |
574 that box to @dfn{contract} the item, hiding its contents. | |
575 | |
576 You can also use the keyboard to navigate the speedbar. Typing | |
577 @kbd{RET} is equivalent to clicking the item on the current line, and | |
578 @kbd{SPC} expands or contracts the item. @kbd{U} displays the parent | |
579 directory of the current directory. To copy, delete, or rename the | |
580 file on the current line, type @kbd{C}, @kbd{D}, and @kbd{R} | |
581 respectively. To create a new directory, type @kbd{M}. | |
582 | |
583 The speedbar is not limited to showing files. Type @kbd{b} to enter | |
584 @dfn{Buffer Display Mode}, in which the speedbar displays a list of | |
585 Emacs buffers. To return to File Display Mode, type @kbd{f}. You can | |
586 also change the display mode by clicking @kbd{mouse-3} anywhere in the | |
587 speedbar window (or @kbd{mouse-1} on the mode-line) and selecting | |
588 @samp{Displays} in the pop-up menu. | |
568 | 589 |
569 Some major modes, including Rmail mode, Info, and GUD, have | 590 Some major modes, including Rmail mode, Info, and GUD, have |
570 specialized ways of putting useful items into the speedbar for you to | 591 specialized ways of putting useful items into the speedbar for you to |
571 select. For example, in Rmail mode, the speedbar shows a list of Rmail | 592 select. For example, in Rmail mode, the speedbar shows a list of Rmail |
572 files, and lets you move the current message to another Rmail file by | 593 files, and lets you move the current message to another Rmail file by |
573 clicking on its @samp{<M>} box. | 594 clicking on its @samp{<M>} box. |
574 | 595 |
575 A speedbar belongs to one Emacs frame, and always operates on that | 596 For more details on using and programming the speedbar, @xref{Top, |
576 frame. If you use multiple frames, you can make a speedbar for some or | 597 Speedbar,,speedbar, Speedbar Manual}. |
577 all of the frames; type @kbd{M-x speedbar} in any given frame to make a | |
578 speedbar for it. | |
579 | 598 |
580 @node Multiple Displays | 599 @node Multiple Displays |
581 @section Multiple Displays | 600 @section Multiple Displays |
582 @cindex multiple displays | 601 @cindex multiple displays |
583 | 602 |