comparison man/xemacs/frame.texi @ 454:d7a9135ec789 r21-2-42

Import from CVS: tag r21-2-42
author cvs
date Mon, 13 Aug 2007 11:40:54 +0200
parents 1ccc32a20af4
children 3fc0174a5541
comparison
equal deleted inserted replaced
453:270b05afd845 454:d7a9135ec789
19 the frame. Often, the whole frame is taken up by just one window, but 19 the frame. Often, the whole frame is taken up by just one window, but
20 you can split the frame into two or more subwindows. If you are 20 you can split the frame into two or more subwindows. If you are
21 running XEmacs under the X window system, that means you can have several 21 running XEmacs under the X window system, that means you can have several
22 @dfn{XEmacs windows} inside the X window that contains the XEmacs frame. 22 @dfn{XEmacs windows} inside the X window that contains the XEmacs frame.
23 You can even have multiple frames in different X windows, each with 23 You can even have multiple frames in different X windows, each with
24 their own set of subwindows. 24 their own set of subwindows.
25 @refill 25 @refill
26 @end table 26 @end table
27 27
28 Each XEmacs frame displays a variety of information: 28 Each XEmacs frame displays a variety of information:
29 @itemize @bullet 29 @itemize @bullet
30 @item 30 @item
31 The biggest area usually displays the text you are editing. It may 31 The biggest area usually displays the text you are editing. It may
32 consist of one window or of two or more windows if you need to look at two 32 consist of one window or of two or more windows if you need to look at two
33 buffers a the same time. 33 buffers a the same time.
34 @item 34 @item
35 Below each text window's last line is a @dfn{mode line} (@pxref{Mode 35 Below each text window's last line is a @dfn{mode line} (@pxref{Mode
36 Line}), which describes what is going on in that window. The mode line 36 Line}), which describes what is going on in that window. The mode line
37 is in inverse video if the terminal supports that. If there are several 37 is in inverse video if the terminal supports that. If there are several
38 XEmacs windows in one frame, each window has its own mode line. 38 XEmacs windows in one frame, each window has its own mode line.
76 in an XEmacs buffer by editing it in one XEmacs window, the changes are 76 in an XEmacs buffer by editing it in one XEmacs window, the changes are
77 visible in all XEmacs windows containing that buffer. 77 visible in all XEmacs windows containing that buffer.
78 78
79 79
80 @menu 80 @menu
81 * Point:: The place in the text where editing commands operate. 81 * Point:: The place in the text where editing commands operate.
82 * Echo Area:: Short messages appear at the bottom of the frame. 82 * Echo Area:: Short messages appear at the bottom of the frame.
83 * Mode Line:: Interpreting the mode line. 83 * Mode Line:: Interpreting the mode line.
84 * GUI Components:: Menubar, toolbars, gutters. 84 * GUI Components:: Menubar, toolbars, gutters.
85 * XEmacs under X:: Some information on using XEmacs under the X 85 * XEmacs under X:: Some information on using XEmacs under the X
86 Window System. 86 Window System.
87 * XEmacs under MS Windows:: Some information on using XEmacs under 87 * XEmacs under MS Windows:: Some information on using XEmacs under
88 Microsoft Windows. 88 Microsoft Windows.
89 @end menu 89 @end menu
90 90
91 @node Point, Echo Area, Frame, Frame 91 @node Point, Echo Area, Frame, Frame
201 text has been changed, and how far down the buffer you are currently 201 text has been changed, and how far down the buffer you are currently
202 looking. 202 looking.
203 203
204 @var{ch} contains two stars (@samp{**}) if the text in the buffer has been 204 @var{ch} contains two stars (@samp{**}) if the text in the buffer has been
205 edited (the buffer is ``modified''), or two dashes (@samp{--}) if the 205 edited (the buffer is ``modified''), or two dashes (@samp{--}) if the
206 buffer has not been edited. Exception: for a read-only buffer, it is 206 buffer has not been edited. Exception: for a read-only buffer, it is
207 @samp{%%}. 207 @samp{%%}.
208 208
209 @var{buf} is the name of the window's chosen @dfn{buffer}. The chosen 209 @var{buf} is the name of the window's chosen @dfn{buffer}. The chosen
210 buffer in the selected window (the window that the cursor is in) is also 210 buffer in the selected window (the window that the cursor is in) is also
211 XEmacs's selected buffer, the buffer in which editing takes place. When 211 XEmacs's selected buffer, the buffer in which editing takes place. When
212 we speak of what some command does to ``the buffer'', we mean the 212 we speak of what some command does to ``the buffer'', we mean the
213 currently selected buffer. @xref{Buffers}. 213 currently selected buffer. @xref{Buffers}.
214 214
215 @var{pos} tells you whether there is additional text above the top of 215 @var{pos} tells you whether there is additional text above the top of
216 the screen or below the bottom. If your file is small and it is 216 the screen or below the bottom. If your file is small and it is
217 completely visible on the screen, @var{pos} is @samp{All}. Otherwise, 217 completely visible on the screen, @var{pos} is @samp{All}. Otherwise,
218 @var{pos} is @samp{Top} if you are looking at the beginning of the file, 218 @var{pos} is @samp{Top} if you are looking at the beginning of the file,
219 @samp{Bot} if you are looking at the end of the file, or 219 @samp{Bot} if you are looking at the end of the file, or
220 @samp{@var{nn}%}, where @var{nn} is the percentage of the file above the 220 @samp{@var{nn}%}, where @var{nn} is the percentage of the file above the
221 top of the screen.@refill 221 top of the screen.@refill
222 222
272 Customization note: the variable @code{mode-line-inverse-video} 272 Customization note: the variable @code{mode-line-inverse-video}
273 controls whether the mode line is displayed in inverse video (assuming 273 controls whether the mode line is displayed in inverse video (assuming
274 the terminal supports it); @code{nil} means no inverse video. The 274 the terminal supports it); @code{nil} means no inverse video. The
275 default is @code{t}. For X frames, simply set the foreground and 275 default is @code{t}. For X frames, simply set the foreground and
276 background colors appropriately. 276 background colors appropriately.
277 277
278 @node GUI Components, XEmacs under X, Mode Line, Frame 278 @node GUI Components, XEmacs under X, Mode Line, Frame
279 @comment node-name, next, previous, up 279 @comment node-name, next, previous, up
280 @section GUI Components 280 @section GUI Components
281 281
282 When executed in a graphical windowing environment such as the X Window 282 When executed in a graphical windowing environment such as the X Window
292 function, and on a tab in the gutter to switch buffers. 292 function, and on a tab in the gutter to switch buffers.
293 293
294 @menu 294 @menu
295 * Menubar Basics:: How XEmacs uses the menubar. 295 * Menubar Basics:: How XEmacs uses the menubar.
296 * Scrollbar Basics:: How XEmacs uses scrollbars. 296 * Scrollbar Basics:: How XEmacs uses scrollbars.
297 * Mode Line Basics:: How XEmacs uses modelines.
297 * Toolbar Basics:: How XEmacs uses toolbars. 298 * Toolbar Basics:: How XEmacs uses toolbars.
298 * Gutter Basics:: How XEmacs uses gutters. 299 * Gutter Basics:: How XEmacs uses gutters.
299 * Inhibiting:: What if you don't like GUI? 300 * Inhibiting:: What if you don't like GUI?
300 * Customizing:: Position, orientation, and appearance of GUI objects. 301 * Customizing:: Position, orientation, and appearance of GUI objects.
301 @end menu 302 @end menu
334 Other menus which are typically available are the @samp{Options}, 335 Other menus which are typically available are the @samp{Options},
335 @samp{Tools}, @samp{Buffers}, @samp{Apps}, and @samp{Mule} menus. For 336 @samp{Tools}, @samp{Buffers}, @samp{Apps}, and @samp{Mule} menus. For
336 detailed descriptions of these menus, @ref{Pull-down Menus}. (In 21.2 337 detailed descriptions of these menus, @ref{Pull-down Menus}. (In 21.2
337 XEmacsen, the @samp{Mule} menu will be moved under @samp{Options}.) 338 XEmacsen, the @samp{Mule} menu will be moved under @samp{Options}.)
338 339
339 @node Scrollbar Basics, Toolbar Basics, Menubar Basics, GUI Components 340 @node Scrollbar Basics, Mode Line Basics, Menubar Basics, GUI Components
340 @comment node-name, next, previous, up 341 @comment node-name, next, previous, up
341 @section XEmacs Scrollbars 342 @section XEmacs Scrollbars
342 343
343 XEmacs scrollbars provide the usual interface. Arrow buttons at either 344 XEmacs scrollbars provide the usual interface. Arrow buttons at either
344 end allow for line by line scrolling, including autorepeat. Clicking in 345 end allow for line by line scrolling, including autorepeat. Clicking in
353 The presence of the scrollbars is under control of the application or 354 The presence of the scrollbars is under control of the application or
354 may be customized by the user. By default a vertical scrollbar is 355 may be customized by the user. By default a vertical scrollbar is
355 present in all windows (except the minibuffer), and there is no 356 present in all windows (except the minibuffer), and there is no
356 horizontal scrollbar. 357 horizontal scrollbar.
357 358
358 @node Toolbar Basics, Gutter Basics, Scrollbar Basics, GUI Components 359 @node Mode Line Basics, Toolbar Basics, Scrollbar Basics, GUI Components
360 @comment node-name, next, previous, up
361 @section XEmacs Mode Lines
362
363 When used in a windowing system, the XEmacs modelines can be dragged
364 vertically. The effect is to resize the windows above and below the
365 modeline (this includes the minibuffer window).
366
367 Additionally, a modeline can be dragged horizontally, in which case it
368 scrolls its own text. This behavior is not enabled by default because it
369 could be considered as disturbing when dragging vertically. When this
370 behavior is enabled, the modeline's text can be dragged either in the
371 same direction as the mouse, or in the opposite sense, making the
372 modeline act as a scrollbar for its own text.
373
374 You can select the behavior you want from the @samp{Display} submenu of
375 the @samp{Options} menu.
376
377 @node Toolbar Basics, Gutter Basics, Mode Line Basics, GUI Components
359 @comment node-name, next, previous, up 378 @comment node-name, next, previous, up
360 @section XEmacs Toolbars 379 @section XEmacs Toolbars
361 380
362 XEmacs has a default toolbar which provides shortcuts for some of the 381 XEmacs has a default toolbar which provides shortcuts for some of the
363 commonly used operations (such as opening files) and applications (such 382 commonly used operations (such as opening files) and applications (such
489 508
490 @vindex default-frame-alist 509 @vindex default-frame-alist
491 You can specify a different default frame size other than the one provided. 510 You can specify a different default frame size other than the one provided.
492 Use the variable @code{default-frame-alist}, which is an alist of default 511 Use the variable @code{default-frame-alist}, which is an alist of default
493 values for frame creation other than the first one. These may be set in 512 values for frame creation other than the first one. These may be set in
494 your init file, like this: 513 your init file, like this:
495 514
496 @example 515 @example
497 (setq default-frame-alist '((width . 80) (height . 55))) 516 (setq default-frame-alist '((width . 80) (height . 55)))
498 @end example 517 @end example
499 518
507 @vindex create-frame-hook 526 @vindex create-frame-hook
508 When you create a new frame, the variable @code{create-frame-hook} 527 When you create a new frame, the variable @code{create-frame-hook}
509 is called with one argument, the frame just created. 528 is called with one argument, the frame just created.
510 529
511 If you want to close one or more of the X windows you created using 530 If you want to close one or more of the X windows you created using
512 @b{New Frame}, use the @b{Delete Frame} menu item from the @b{File} menu. 531 @b{New Frame}, use the @b{Delete Frame} menu item from the @b{File} menu.
513 532
514 @vindex frame-title-format 533 @vindex frame-title-format
515 @vindex frame-icon-title-format 534 @vindex frame-icon-title-format
516 If you are working with multiple frames, some special information 535 If you are working with multiple frames, some special information
517 applies: 536 applies:
547 most operations available under the X Window System are also available 566 most operations available under the X Window System are also available
548 with MS Windows. 567 with MS Windows.
549 568
550 Where possible, native MS Windows GUI components and capabilities are 569 Where possible, native MS Windows GUI components and capabilities are
551 used in XEmacs. 570 used in XEmacs.
552