aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/frames.texi (unfollow)
Commit message (Collapse)AuthorFilesLines
2020-07-04Minor improvement in ELisp manualEli Zaretskii1-6/+7
* doc/lispref/frames.texi (Position Parameters): Clarify the description of the 'above' frame parameter. (Bug#42154)
2020-06-17Fix some Texinfo markupBasil L. Contovounesios1-1/+1
* doc/misc/gnus-faq.texi (FAQ 3-11): * doc/emacs/frames.texi (Tab Bars): Consistently use @var with lower-case metasyntactic variables and @minus instead of a dash. (Text-Only Mouse): * doc/emacs/files.texi (Auto Revert): * doc/emacs/misc.texi (emacsclient Options) (Embedded WebKit Widgets): * doc/lispref/control.texi (pcase Macro): * doc/lispref/debugging.texi (Backtraces): * doc/lispref/files.texi (Truenames): * doc/lispref/frames.texi (Management Parameters): * doc/lispref/os.texi (Time Calculations): * doc/lispref/text.texi (Parsing JSON): * doc/misc/efaq-w32.texi (Other versions of Emacs, Debugging) (Swap Caps NT, Printing, Bash, Developing with Emacs): * doc/misc/efaq.texi (New in Emacs 25): * doc/misc/emacs-gnutls.texi (Help For Users): * doc/misc/message.texi (Using S/MIME, Passphrase caching): * test/manual/etags/tex-src/gzip.texi (Overview): Use @. when a sentence in the middle of a paragraph ends with an upper-case letter as per "(texinfo) Ending a Sentence".
2020-06-07Use 65535 as color-values scale value in the NS backendMattias Engdegård1-3/+3
* src/nsfns.m (Fxw_color_values): Scale with 65535 instead of 65280, for uniformity with other backends. * lisp/faces.el (color-values): Update doc string. * doc/lispref/frames.texi (Color Names): Update examples.
2020-05-06Consult browse-url-{default-,}handlers in drag&drop.Tassilo Horn1-4/+6
* lisp/dnd.el (dnd-handle-one-url): Consult `browse-url-handlers' and `browse-url-default-handlers' for a matching handler. Adapt docstring. * doc/lispref/frames.texi (Drag and Drop): Remove the docs for the deprecated alist choice of `browse-url-browser-function' and mention `browse-url-handlers' and `browse-url-default-handlers'.
2020-02-28; bug#39779: Fix some typos in documentation.Štěpán Němec1-1/+1
2020-02-07Minor fixes of the last commitEli Zaretskii1-2/+2
* src/xdisp.c (get_window_cursor_type): Fix indentation and line-filling. * doc/lispref/frames.texi (Cursor Parameters): * doc/emacs/display.texi (Cursor Display): * etc/NEWS: Fix wording and capitalization of the last change.
2020-02-07Support for (box . SIZE) 'cursor-type'Zajcev Evgeny1-0/+3
This allows control of the minimum size of a masked image under which the box cursor becomes hollow. * buffer.c (cursor-type): Add commentary about (box . SIZE) 'cursor-type'. * xdisp.c (get_specified_cursor_type): Check for 'cursor-type' of the form (box . SIZE). (get_window_cursor_type): Check masked image size for (box . SIZE) 'cursor-type'. * doc/emacs/display.texi (Cursor Display): * doc/emacs/display.texi (Cursor Parameters): Add description of (box . SIZE) 'cursor-type'. * etc/NEWS: Mention the new (box . SIZE) 'cursor-type'.
2020-01-21Correct statement about ftcr and recommend HarfBuzzRobert Pluim1-11/+11
* doc/lispref/frames.texi (Font and Color Parameters): Correct statement about availability of ftcr in the presence of HarfBuzz. Recommend HarfBuzz.
2020-01-20Improve explanation of available font backends under XRobert Pluim1-8/+11
* frames.texi (Font and Color Parameters): Clarify that you can't have HarfBuzz and non-HarfBuzz at the same time for xft and cairo font backends.
2020-01-07Fix NS frame parameters (bug#39000)Alan Third1-4/+5
* src/frame.c (make_frame): Use new system default setting. * src/frame.h (enum ns_appearance_type): Add new system default setting. * src/nsfns.m (Fx_create_frame): Correctly handle Qunbound and support system default appearance. (syms_of_nsfns): Add Qlight. * src/nsterm.h: New method definition. * src/nsterm.m (ns_set_appearance): Correctly handle Qlight and use new setAppearance method. ([EmacsView initFrameFromEmacs:]): Use new setAppearance method. ([EmacsWindow setAppearance]): New method. * doc/lispref/frames.texi (Management Parameters): Document 'light'.
2020-01-01Update copyright year to 2020Paul Eggert1-1/+1
Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
2019-12-23Fix documentation of implied frame resizing (Bug#38684)Martin Rudalics1-26/+33
* src/frame.c (frame_inhibit_implied_resize): Fix doc-string. * doc/lispref/frames.texi (Implied Frame Resizing): Update and rewrite section.
2019-09-28Improve indexing of ELisp manualEli Zaretskii1-0/+1
* doc/lispref/frames.texi (Font and Color Parameters): Add index entry for the 'mouse' face.
2019-09-23Update some URLsPaul Eggert1-1/+1
This mostly changes http: to https: in URLs. It also updates some URLs that have moved, removes some URLs that no longer work, recommends against using procmail (procmail.org no longer works), and removes some mentions of the no-longer-existing Gmane, LPF and VTW. It doesn't update all URLs, just the ones I had time for. * GNUmakefile (help): * admin/admin.el (manual-doctype-string): * admin/charsets/Makefile.in (${charsetdir}/ALTERNATIVNYJ.map): * admin/charsets/mapconv: * lisp/net/soap-client.el (soap-create-envelope): * lisp/org/org.el (org-doi-server-url): * lisp/textmodes/bibtex.el (bibtex-generate-url-list): Prefer https: to http: un URLs.
2019-08-18Allow set-frame-height/set-frame-width to be used interactivelyLars Ingebrigtsen1-0/+8
* doc/lispref/frames.texi (Frame Size): Document it. * src/frame.c (Fset_frame_height): (Fset_frame_width): Make into commands that use the numeric prefix to set height/width (bug#9970).
2019-06-08Support X core font driver on cairo (Bug#28236)YAMAMOTO Mitsuharu1-5/+5
* configure.ac (HAVE_X_WINDOWS): Add xfont.o to FONT_OBJ if HAVE_CAIRO. * doc/lispref/frames.texi (Font and Color Parameters): Mention X core font driver with Cairo drawing. * src/font.c (syms_of_font) [HAVE_X_WINDOWS && USE_CAIRO]: Call syms_of_xfont. * src/xfns.c (x_create_tip_frame) [USE_CAIRO]: Register xfont_driver. * src/xterm.c (x_cr_gc_clip) [USE_CAIRO]: New function extracted from x_begin_cr_clip. (x_begin_cr_clip) [USE_CAIRO]: Use it. (xlib_surface_key, saved_drawable_key) [USE_CAIRO]: New variables. (x_cr_destroy_xlib_surface, x_try_cr_xlib_drawable) (x_end_cr_xlib_drawable) [USE_CAIRO]: New functions. (x_draw_composite_glyph_string_foreground) (x_draw_glyph_string_foreground) [USE_CAIRO]: Get Xlib surface when drawing text with X core fonts into bitmap surfaces. Add fallback code for drawing into outline surfaces.
2019-05-31Add HarfBuzz font backend for MS-WindowsEli Zaretskii1-12/+15
* src/w32uniscribe.c [HAVE_HARFBUZZ]: Include math.h and hb.h. (bswap_32): Define for GCC 4.3.0 and later; else include <byteswap.h> from Gnulib. (struct uniscribe_font_info): Extend for HarfBuzz; 'cache' is now a 'void *' (all users changed). [HAVE_HARFBUZZ]: Define typedefs for HarfBuzz functions to be loaded dynamically from the HarfBuzz DLL. Define macros to call those functions via function pointers. (uniscribe_open) [HAVE_HARFBUZZ]: Use the HarfBuzz font driver if the type of the font entity is 'harfbuzz'. (uniscribe_close) [HAVE_HARFBUZZ]: For fonts using the HarfBuzz backend, call hb_font_destroy to free memory used for the cached hb_font data. (uniscribe_shape): Fix assignment of character codepoints to glyphs from a single cluster. (w32hb_list, w32hb_match, free_cb, w32hb_get_font_table) (w32hb_get_font, w32hb_encode_char, w32hb_begin_font) (w32uni_combining, w32uni_general, w32uni_mirroring) (get_hb_unicode_funcs, w32hb_shape) (w32hb_combining_capability, load_harfbuzz_funcs) [HAVE_HARFBUZZ]: New functions. (syms_of_w32uniscribe_for_pdumper) [HAVE_HARFBUZZ]: Load the HarfBuzz DLL and register the HarfBuzz backend with its functions. * src/w32font.c (syms_of_w32font) <Qharfbuzz>: New DEFSYM. * src/w32fns.c (Fx_create_frame, w32_create_tip_frame) [HAVE_HARFBUZZ]: Register the harfbuzz font backend. * src/lisp.h (get_unicode_property): Declare prototype. * src/font.h (harfbuzz_font_driver) [HAVE_NTGUI]: Declare. * src/chartab.c (get_unicode_property): New function, body taken from get-unicode-property-internal. (Fget_unicode_property_internal): Call get_unicode_property after validating input. * doc/lispref/frames.texi (Font and Color Parameters): * doc/emacs/msdos.texi (Windows Fonts): Document support for HarfBuzz text shaping on MS-Windows. * configure.ac (HAVE_HARFBUZZ): Move out of the X-specific part, and consider HarfBuzz also for HAVE_W32 systems. Require HarfBuzz v1.2.3 for w32.
2019-05-11Document font backends for Cairo and/or HarfBuzzYAMAMOTO Mitsuharu1-6/+11
* doc/lispref/frames.texi (Font and Color Parameters): Mention xfthb, ftcr, and ftcrhb font backends.
2019-03-05Fix handling of minibuffer-only child frames (Bug#33498)Martin Rudalics1-3/+17
* doc/lispref/frames.texi (Buffer Parameters): Describe how to make a minibuffer-only child frame. (Child Frames): Describe how minbuffer child frames are deleted. * src/frame.c (delete_frame): Handle deletion of minibuffer child frames (Bug#33498). In the course, fix reassigning of 'default-minibuffer-frame' with minibuffer-only frames. * lisp/frame.el (frame-notice-user-settings): Handle creation of initial minibuffer-only child frame. (make-frame): Handle creation of frame with a minibuffer-only child frame.
2019-02-27* doc/emacs/frames.texi (Multiple Displays): Add make-frame-on-monitor.Juri Linkov1-0/+11
* doc/lispref/frames.texi (Multiple Terminals): Add make-frame-on-monitor. (Bug#34516)
2019-01-01Update copyright year to 2019Paul Eggert1-1/+1
Run 'TZ=UTC0 admin/update-copyright $(git ls-files)'.
2018-11-28Minor markup fix in frames.texiEli Zaretskii1-1/+1
* doc/lispref/frames.texi (Frame Layout): Fix markup of @table entries. (Bug#33531)
2018-11-04Rewrite documentation of buffer displayMartin Rudalics1-5/+5
* doc/emacs/windows.texi (Window Choice): Rewrite, replacing references to older buffer display options with references to and examples of buffer display actions. (Temporary Displays): Rewrite display of *Completions* example. * doc/lispref/elisp.texi (Top): New Windows section 'Displaying Buffers'. * doc/lispref/frames.texi (Child Frames): Adjust cross reference. * doc/lispref/windows.texi (Windows): New section 'Displaying Buffers'. Move sections 'Choosing Window', 'Display Action Functions' and 'Choosing Window Options' there and adjust namings. Preferably write 'Buffer Display Action' instead of 'Display Action'. More consistently use @w{} to make key binding specifications unsplittable. (Displaying Buffers): New section. (Choosing Window): Make it a subsection of 'Displaying Buffers'. More explicitly describe how 'display-buffer' compiles its list of action functions and the action alist. (Buffer Display Action Functions): Rename from 'Display Action Functions', make it a subsection of 'Displaying Buffers' and rewrite it. Elide more detailed descriptions of action alist entries; these are now in the new section 'Buffer Display Action Functions'. Remove example. (Buffer Display Action Alists): New subsection of 'Displaying Buffers' giving a comprehensive description of recognized action alist entries with appropriate indexing. Contents were partially moved here from the old 'Display Action Functions' section. (Choosing Window Options): Make it a subsection of 'Displaying Buffers'. Add examples of how to rewrite old buffer display options with the help of buffer display actions. (Precedence of Action Functions): New subsection of 'Displaying Buffers' explaining the execution order of action functions with the help of a detailed example. (The Zen of Buffer Display): New subsection of 'Displaying Buffers' supplying guidelines on how to write and use buffer display actions with examples. (Side Windows, Displaying Buffers in Side Windows) (Frame Layouts with Side Windows, Atomic Windows): Update references to the 'Displaying Buffers' subsections.
2018-07-28Update the list of special forms in the ELisp manualEli Zaretskii1-5/+5
* doc/lispref/eval.texi (Special Forms): * doc/lispref/frames.texi (Mouse Tracking): 'track-mouse' is nowadays a macro. (Bug#32284)
2018-06-16Improve documentation of several recent changesEli Zaretskii1-2/+6
* src/xfaces.c (merge_face_ref): Fix a typo in the commentary. (evaluate_face_filter, filter_face_ref): Minor copyedits in the commentary. * doc/lispref/display.texi (Face Remapping): * doc/lispref/text.texi (Special Properties): Document the ':filter' face specs and their effects. Document 'face-filters-always-match'. * doc/emacs/files.texi (Visiting): Document the new possibility to visit large files literally in response to question asked by Emacs. * etc/NEWS: Mention the new possibility to visit large files literally. * lisp/files.el (files--ask-user-about-large-file): Use "literally" instead of "raw", for consistency with find-file-literally. * doc/lispref/frames.texi (Input Focus): Tell explicitly that focus-change events are sometimes supported on TTY frames.
2018-06-11Add after-delete-frame-functionsDaniel Colascione1-1/+4
Instead of working around the behavior delete-frame-functions, just add an after-delete-frame-functions hook. * doc/lispref/frames.texi (Deleting Frames): Document `after-delete-frame-functions'. * etc/NEWS: Mention `after-delete-frame-functions'. * lisp/frame.el (blink-cursor--should-blink): (blink-cursor--rescan-frames, blink-frame-mode): Get rid of the ugly ignored-frame parameter and switch from `delete-frame-functions' to `after-delete-frame-functions'. * src/frame.c (syms_of_frame): New variable `after-delete-frame-functions'. (delete_frame): Use it.
2018-06-11New focus management interfaceDaniel Colascione1-26/+76
focus-in-hook and focus-out-hook don't accurately reflect actual user-visible focus states. Add a new focus interface and mark the old one obsolete. * doc/lispref/frames.texi (Input Focus): Document new focus functions. Remove references to the now-obsolete focus hooks. * lisp/frame.el (frame-focus-state): New function. (after-focus-change-function): New variable. (focus-in-hook, focus-out-hook): Move to lisp from C; mark obsolete. * lisp/term/xterm.el (xterm-translate-focus-in) (xterm-translate-focus-out): Track tty focus in `tty-focus-state' terminal parameter; call `after-focus-change-function'. (xterm--suspend-tty-function): New function. * src/frame.c (Fhandle_switch_frame): Update docstring; don't call focus hooks. (focus-in-hook, focus-out-hook): Remove: moved to lisp. (syms_of_frame): Remove unread_switch_frame; add Vunread_switch_frame. * src/keyboard.c: (Finternal_handle_focus_in): New function. (make_lispy_event): Always report focus events to lisp; don't translate them to switch events sometimes. Lisp can take care of creating synthetic switch-frame events via `internal-handle-focus-in'. * src/w32term.c (x_focus_changed): Remove switch-avoidance logic: just directly report focus changes to lisp. * src/xterm.c (x_focus_changed): Remove switch-avoidance logic: just directly report focus changes to lisp.
2018-03-10Improve support for desktop restoration in daemon modeEli Zaretskii1-0/+6
* lisp/server.el (server-after-make-frame-hook): New hook. (server-execute): Call it after creating a new frame or before switching to a buffer shown in a client frame. (Bug#30421) * doc/emacs/misc.texi (Saving Emacs Sessions): Adjust advice for restoring desktop in daemon mode to the new hook. * doc/lispref/frames.texi (Creating Frames, Standard Hooks): Document server-after-make-frame-hook. * etc/NEWS: Mention server-after-make-frame-hook.
2018-02-23Minor doc fixes, mostly for timestamp issuesPaul Eggert1-1/+1
2018-02-23Fix @findex and @vindex entries in manualsMichael Albinus1-84/+84
* doc/emacs/building.texi: * doc/emacs/calendar.texi: * doc/emacs/cmdargs.texi: * doc/emacs/mini.texi: * doc/emacs/misc.texi: * doc/emacs/trouble.texi: * doc/emacs/windows.texi: * doc/lispintro/emacs-lisp-intro.texi: * doc/lispref/edebug.texi: * doc/lispref/frames.texi: * doc/lispref/os.texi: * doc/lispref/windows.texi: * doc/misc/cc-mode.texi: * doc/misc/dired-x.texi: * doc/misc/ediff.texi: * doc/misc/mh-e.texi: * doc/misc/pcl-cvs.texi: * doc/misc/reftex.texi: * doc/misc/sc.texi: * doc/misc/vhdl-mode.texi: * doc/misc/viper.texi: Fix @findex and @vindex entries.
2018-01-28Fix some issues in the emacs/lispref manualsMartin Rudalics1-8/+7
* doc/emacs/basic.texi (Continuation Lines): * doc/emacs/building.texi (GDB User Interface Layout): * doc/emacs/dired.texi (Misc Dired Features): * doc/emacs/maintaining.texi (Identifier Search): * doc/emacs/mark.texi (Using Region): * doc/emacs/misc.texi (Document View, DocView Conversion): * doc/emacs/modes.texi (Major Modes): * doc/emacs/mule.texi (Input Methods, Unibyte Mode): * doc/emacs/sending.texi (Mail Methods): Replace @code by @kbd. * doc/emacs/frames.texi (Text-Only Mouse): * doc/lispref/maps.texi (Standard Keymaps): Replace @kbd by @key. * doc/lispref/compile.texi (Compiler Errors): Write non-@code{nil} instead of non-nil. * doc/lispref/debugging.texi (Internals of Debugger): 'backtrace' is not a command. 'debugger-stack-frame-as-list' is an option. * doc/lispref/display.texi (Size of Displayed Text): 'window-lines-pixel-dimensions' has a last argument 'left'. * doc/lispref/display.texi (Attribute Functions): 'set-face-underline' and 'set-face-inverse-video' are commands. (Tooltips): 'tooltip-frame-parameters' is an option. (Bidirectional Display): 'bidi-paragraph-direction' is an option. * doc/lispref/frames.texi (Cursor Parameters): 'cursor-type' is an option. (Input Focus): Argument FRAME of 'x-focus-frame' is not optional. (Child Frames): Both arguments of 'frame-ancestor-p' are non-optional. 'iconify-child-frame' is an option. * doc/lispref/os.texi (Killing Emacs): 'kill-emacs-query-functions' is an option. * doc/lispref/windows.texi (Mouse Window Auto-selection): 'mouse-autoselect-window' is an option.
2018-01-01Update copyright year to 2018Paul Eggert1-1/+1
Run admin/update-copyright.
2017-12-22Avoid some overfull lines in PDF lisprefGlenn Morris1-1/+2
* doc/lispref/commands.texi (Reading One Event): * doc/lispref/display.texi (SVG Images): * doc/lispref/frames.texi (Size Parameters): * doc/lispref/syntax.texi (Categories): * doc/lispref/windows.texi (Frame Layouts with Side Windows): Avoid overfull lines.
2017-12-22; lispref nil/t markup fixesGlenn Morris1-3/+3
2017-12-10Remove sentence from child frames section in Elisp manualMartin Rudalics1-2/+1
* doc/lispref/frames.texi (Child Frames): Remove one sentence. Suggested by Bob Weiner <rsw@gnu.org>.
2017-11-02In frame parameters documentation mention desktop saving/restoringMartin Rudalics1-0/+7
* doc/lispref/frames.texi (Frame Parameters): Mention that applications have to care about which parameters they want to get saved and restored by the desktop library.
2017-10-29Fix minibuffer window related docs and strings (Bug#28978)Martin Rudalics1-2/+9
* src/frame.c (Vdefault_minibuffer_frame): Fix doc-string. * src/window.c (Fminibuffer_selected_window): Fix doc-string. * doc/lispref/frames.texi (Buffer Parameters): Rewrite description of `minibuffer' parameter. * doc/lispref/minibuf.texi (Minibuffer Windows): Reorder entries and partly rewrite section. (Minibuffer Misc): Clarify description of `minibuffer-selected-window'. * etc/NEWS: Mention new semantics of 'minibuffer' frame parameter.
2017-10-14Fix wording in Elisp manual's child frames section (Bug#28819)Martin Rudalics1-1/+1
* doc/lispref/frames.texi (Child Frames): Fix wording (Bug#28819).
2017-09-25Fix documentation of `make-frame' and related variables and hooksMartin Rudalics1-24/+34
* lisp/frame.el (before-make-frame-hook) (after-make-frame-functions, frame-inherited-parameters) (make-frame): Fix doc-strings. * doc/lispref/frames.texi (Creating Frames): Fix description of `make-frame' and related variables and hooks.
2017-08-23Add ability to change macOS WM theme (bug#27973)Alan Third1-0/+14
* src/frame.c (make_frame, frame_parms, syms_of_frame) [NS_IMPL_COCOA]: Add ns-appearance and ns-transparent-titlebar options. * src/frame.h (ns_appearance_type) [NS_IMPL_COCOA]: Add enum to represent NSAppearance options. (struct frame) [NS_IMPL_COCOA]: Add ns_appearance and ns_transparent_titlebar frame parameters. * src/nsfns.m (ns_frame_parm_handlers) [NS_IMPL_COCOA]: Add ns_set_appearance and ns_set_transparent_titlebar handlers. (Sx_create_frame): Handle ns-appearance and ns-transparent-titlebar frame parameters. (Qdark): Add new symbol for use with ns-appearance. * src/nsterm.h (ns_set_appearance, ns_set_transparent_titlebar) [NS_IMPL_COCOA]: Add prototypes. * src/nsterm.m (ns_set_appearance, ns_set_transparent_titlebar) [NS_IMPL_COCOA]: New functions. (initFrameFromEmacs) [NS_IMPL_COCOA]: Handle ns-appearance and ns-transparent-titlebar frame parameters. * doc/lispref/frames.texi (Window Management Parameters): Document ns-apperance and ns-transparent-titlebar.
2017-10-01Improve handling of iconification of child frames (Bug#28611)Martin Rudalics1-5/+25
* src/frame.c (Ficonify_frame): Handle `iconify-child-frame' option. (syms_of_frame): New symbols Qiconify_top_level and Qmake_invisible. (iconify_child_frame): New option. * lisp/cus-start.el (iconify-child-frame): Add customization properties. * doc/lispref/frames.texi (Child Frames): Describe new option `iconify-child-frame'. Don't index "top-level frame" twice.
2017-06-25Provide additional support for child framesMartin Rudalics1-113/+397
Provide mouse dragging and resizing of frames. Allow resizing frames proportionally. Provide additional functionality for child frames. Minor bug fixes. * lisp/frame.el (frame-border-width, frame-pixel-width) (frame-pixel-height): Alias to `frame-internal-border-width', `frame-native-width' and `frame-native-height'. (frame-inner-width, frame-inner-height, frame-outer-width) (frame-outer-height): New functions. * lisp/minibuffer.el (completion-auto-help): Fix typo. * lisp/mouse.el (mouse-drag-line, mouse-drag-mode-line) (mouse-drag-header-line): Allow moving a frame by dragging the mode line of its bottommost window (on a minibuffer-less frame) or the header line of its topmost window. (mouse-drag-vertical-line): Mention argument in doc-string. (mouse-resize-frame, mouse-drag-frame, mouse-drag-left-edge) (mouse-drag-top-left-corner, mouse-drag-top-edge) (mouse-drag-top-right-corner, mouse-drag-right-edge) (mouse-drag-bottom-right-corner, mouse-drag-bottom-edge) (mouse-drag-bottom-left-corner): New functions for resizing a frame by dragging its internal border together with corresponding key bindings. * lisp/tooltip.el (tooltip-frame-parameters): Add 'no-special-glyphs' to default parameters and update version tag. * lisp/window.el (frame-auto-hide-function): Add choice to make frame invisible and update version tag. (window--delete): Handle 'auto-hide-function' frame parameter. (window--maybe-raise-frame): Respect 'no-focus-on-map' and 'no-accept-focus' frame parameters. (display-buffer--action-function-custom-type): Add `display-buffer-in-child-frame'. (display-buffer): Mention `display-buffer-in-child-frame' in doc-string. (display-buffer-in-child-frame): New action function for `display-buffer'. (window--sanitize-margin): Return zero when MARGIN cannot be sanitized. (fit-frame-to-buffer): Major rewrite to handle child frames and 'fit-frame-to-buffer-sizes' and 'fit-frame-to-buffer-margins' frame parameters. (window-largest-empty-rectangle--maximums-1) (window-largest-empty-rectangle--maximums) (window-largest-empty-rectangle--disjoint-maximums) (window-largest-empty-rectangle): New functions. * src/dispextern.h (WINDOW_WANTS_MODELINE_P) (WINDOW_WANTS_HEADER_LINE_P): Remove. Functionality is now provided by corresponding functions window_wants_modeline and window_wants_header_line in window.c. Adjust users. * src/dispnew.c (adjust_glyph_matrix) (buffer_posn_from_coords): Use window_wants_modeline and window_wants_header_line instead of WINDOW_WANTS_MODELINE_P and WINDOW_WANTS_HEADER_LINE_P. * src/frame.c (keep_ratio): New function. (adjust_frame_size): Call keep_ratio for each of F's child frames. (make_frame): Initialize no_special_glyphs slot. (frame_internal_border_part): New function. (Fframe_pixel_width, Fframe_pixel_height, Fborder_width): Rename to Fframe_native_width, Fframe_native_height mand Fframe_internal_border_width. (frame_parm_table): Add Qno_special_glyphs entry. (frame_float_type): New enumeration type. (frame_float): New function to handle frame size and position ratios. (x_set_frame_parameters): Handle size and position ratios. (x_set_no_special_glyphs): New function (x_figure_window_size): Handle size and position ratios. (syms_of_frame): Add Qdisplay_monitor_attributes_list, Qno_special_glyphs, Qframe_edges, Qkeep_ratio, Qwidth_only, Qheight_only, Qleft_only and Qtop_only. * src/frame.h (internal_border_part): New enumeration type. (struct frame): New slot no_special_glyphs. (FRAME_NO_SPECIAL_GLYPHS): New macro. * src/gtkutil.c (xg_frame_restack): Return immediately for GTK versions before 2.18.0. * src/keyboard.c (internal_border_parts): New array constant. (make_lispy_position): For frames with border dragging enabled return internal border part. (syms_of_keyboard): New symbols Qdrag_internal_border, Qleft_edge, Qtop_left_corner, Qtop_edge, Qtop_right_corner, Qright_edge, Qbottom_right_corner, Qbottom_edge and Qbottom_left_corner. * src/minibuf.c (read_minibuf_unwind): When exiting the minibuffer deal with frames that have the 'minibuffer-exit' parameter set. (syms_of_minibuf): New symbol Qminibuffer_exit. * src/nsfns.m (frame_parm_handler): Add entry for x_set_no_special_glyphs. (Fx_create_frame): Handle 'no-special-glyphs' parameter. Intitialize new cursor types for dragging frame borders. * src/nsterm.h (struct ns_output): Add new cursor types for dragging frame borders. * src/w32fns.c (w32_frame_parm_handlers): Add entry for x_set_no_special_glyphs. (Fx_create_frame): Handle 'no-special-glyphs' parameter. Intitialize new cursor types for dragging frame borders. * src/w32term.h (struct w32_output): Add new cursor types for dragging frame borders. * src/window.c (coordinates_in_window) (Fwindow_line_height, window_internal_height): Use window_wants_modeline and window_wants_header_line instead of WINDOW_WANTS_MODELINE_P and WINDOW_WANTS_HEADER_LINE_P. (Fwindow_lines_pixel_dimensions): New function. (window_parameter): New function. (Fwindow_parameter): Call window_parameter. (window_wants_mode_line, window_wants_header_line): New functions replacing the macros WINDOW_WANTS_MODELINE_P and WINDOW_WANTS_HEADER_LINE_P from dispextern.h. (syms_of_window): New symbols Qmode_line_format and Qheader_line_format. * src/window.h: Reorganize and re-comment macros. Use window_wants_modeline and window_wants_header_line instead of WINDOW_WANTS_MODELINE_P and WINDOW_WANTS_HEADER_LINE_P. (MINI_NON_ONLY_WINDOW_P, MINI_ONLY_WINDOW_P): Minor rewrite. (WINDOW_BUFFER): New macro. (WINDOW_BOX_LEFT_EDGE_COL, WINDOW_BOX_RIGHT_EDGE_COL): Remove. * src/xdisp.c (window_text_bottom_y, window_box_height) (window_box, start_display) (compute_window_start_on_continuation_line) (try_cursor_movement, redisplay_window) (try_window_reusing_current_matrix, try_window_id) (display_line, expose_window): Use window_wants_modeline and window_wants_header_line instead of WINDOW_WANTS_MODELINE_P and WINDOW_WANTS_HEADER_LINE_P. (pos_visible_p, display_mode_lines): Respect W's 'mode-line-format' and 'header-line-format' window parameters. (init_iterator): Use window_wants_modeline and window_wants_header_line instead of WINDOW_WANTS_MODELINE_P and WINDOW_WANTS_HEADER_LINE_P. For tip frames respect no_special_glyphs value. (note_mouse_highlight): Set frame border cursors when on internal border. (x_draw_right_divider, x_draw_bottom_divider): Try to improve drawing of window dividers. * src/xfns.c (mouse_cursor): Add entries for border parts. (mouse_cursor_types): Add entries for cursor types to drag frame borders. (INSTALL_CURSOR): Add entries for new cursor types to drag frame borders. (Fx_create_frame): Handle 'no-special-glyphs' parameter. (x_frame_parm_handlers): Add entry for x_set_no_special_glyphs. (Vx_window_left_edge_shape, Vx_window_top_left_corner_shape) (Vx_window_top_edge_shape, Vx_window_top_right_corner_shape) (Vx_window_right_edge_shape) (Vx_window_bottom_right_corner_shape) (Vx_window_bottom_edge_shape) (Vx_window_bottom_left_corner_shape): New variables. (x_frame_restack): Call xg_frame_restack only for GTK versions starting with 2.18.0. * src/xterm.c (x_free_frame_resources): Remove new cursors for dragging frame borders. * src/xterm.h (struct x_output): Add new cursor types for dragging frame borders. * doc/lispref/display.texi (Size of Displayed Text): Document `window-lines-pixel-dimensions'. * doc/lispref/elisp.texi (Top): Add entry for "Mouse Dragging Parameters". * doc/lispref/frames.texi (Frame Size): Replace frame-pixel-width/-height by frame-native-width/-height. Add frame-inner-width/-height and frame-outer-width/-height docs. (Position Parameters): Describe specifying position as ratios. Clarify remark about positions relative to bottom/ridge display edge. (Size Parameters): Describe specifying sizes as ratios. Describe 'fit-frame-to-buffer-margins' and 'fit-frame-to-buffer-sizes' parameters. (Layout Parameters): Describe 'no-special-glyphs' parameter. (Frame Interaction Parameters): Describe 'auto-hide-function', 'minibuffer-exit' and 'keep-ratio' parameters. (Mouse Dragging Parameters): New section describing 'drag-internal-border', 'drag-with-header-line', 'drag-with-mode-line', 'snap-width', 'top-visible' and 'bottom-visible' parameters. (Management Parameters): Mention that `override-redirect' has no effect on MS Windows. (Font and Color Parameters): Mention child frames for `alpha' parameter. (Child Frames): Rewrite section with description and cross references to new frame parameters added. * doc/lispref/modes.texi (Mode Line Basics): Mention 'mode-line-format' and 'header-line-format' window parameters. * doc/lispref/windows.texi (Resizing Windows): Mention effect of `fit-frame-to-buffer-margins' for child frames. (Display Action Functions): New action function `display-buffer-in-child-frame'. (Quitting Windows): Mention `make-frame-invisible' as optional value of `frame-auto-hide-function' and `auto-hide-function' frame paameter. (Coordinates and Windows): Describe new function `window-largest-empty-rectangle'. (Window Parameters): Describe new parameters 'mode-line-format' and 'header-line-format'. Index all window parameters described in this section.
2017-06-12Note how fullscreen differs on the NS portAlan Third1-0/+4
doc/lispref/frames.texi (Size Parameters): doc/emacs/frames.texi (Tool Bars): Add a description of how macOS hides the tool-bar and menu-bar in fullscreen.
2017-05-10Implement 1-based column numbering in mode linePerry E. Metzger1-1/+1
* src/xdisp.c (decode_mode_spec): Implement the %C construct. * lisp/bindings.el (column-number-indicator-zero-based): New defcustom. (mode-line-position): Use %C when column-number-indicator-zero-based is nil. * src/xdisp.c (syms_of_xdisp) <frame-title-format>: * src/buffer.c (syms_of_buffer) <mode-line-format>: * doc/lispref/modes.texi (%-Constructs): * doc/lispref/frames.texi (Frame Titles): Document the %C construct. * doc/emacs/display.texi (Optional Mode Line): Document 'column-number-indicator-zero-based'. * etc/NEWS: Mention 'column-number-indicator-zero-based' and the %C construct.
2017-04-19Note frame documentation exceptions for NS buildsAlan Third1-6/+14
* doc/lispref/frames.texi (Management Parameters, Child Frames): Note NS differences.
2017-04-14; Spelling and minor wording fixesPaul Eggert1-2/+2
2017-04-14A few additional copy-edits in documentation of framesMartin Rudalics1-7/+8
* doc/lispref/frames.texi (Frame Layout) (Implied Frame Resizing): Windows -> MS-Windows. (Deleting Frames): Fix typo.
2017-04-13Minor copyedits of recent changes in documentationEli Zaretskii1-82/+92
* doc/lispref/frames.texi (Frame Layout, Frame Position) (Frame Size, Frame Interaction Parameters, Input Focus) (Raising and Lowering, Child Frames): Improve wording and indexing. * doc/emacs/cmdargs.texi (Borders X): Improve indexing.
2017-04-13Describe recent frame and window changes in manualsMartin Rudalics1-228/+863
* doc/emacs/emacs.texi (Top): * doc/emacs/cmdargs.texi (Borders X): Clearly separate the terms "outer border" (for the X border which can be set from within Emacs) and "external border" (for the border which is added by the window manager). * doc/lispref/display.texi (Tooltips): Clarify slightly. * doc/lispref/elisp.texi (Top): Update node and section names. * doc/lispref/frames.texi (Frames): Describe difference between top-level and child frames. (Frame Layout): Describe outer border. Add more details about how Emacs obtains the outer size and position of a frame and about menu bar/tool bar wrapping. Add references to new frame parameters. (Size and Position): Remove subsection. (Frame Position): New subsection excerpted from the earlier Size and Position subsection. Clarify positioning concepts and some of their shortcomings. Describe `move-frame-functions'. (Frame Size): New subsection excerpted from the earlier Size and Position subsection. Describe how to track frame size changes and the new function `frame-size-changed-p'. (Position Parameters): Describe child frame positioning. Warn about negative offsets. Describe 'z-group' parameter. (Size Parameters): Describe 'text-pixels' specification facility and new 'min-width' and 'min-height' parameters. (Layout Parameters): Clarify description of 'tool-bar-lines' and 'menu-bar-lines' parameters. (Frame Interaction Parameters): New subsubsection describing 'parent-frame', 'delete-before', 'mouse-wheel-frame' and 'no-other-frame' parameters. (Management Parameters): Describe 'skip-taskbar', 'no-focus-on-map', 'no-accept-focus', 'undecorated' and 'override-redirect' parameters. (Deleting Frames): Describe handling of 'delete-before' parameter and child frames for `delete-frame' and `delete-other-frames'. (Finding All Frames): Describe `frame-list-z-order' and handling of 'no-other-frame' parameter by `next-frame'. (Minibuffers and Frames): Minor clarifications. (Input Focus): Document `x-focus-frame'. Clarify descriptions of `focus-in-hook', `focus-out-hook' and `focus-follows-mouse'. (Visibility of Frames): Describe mapping and how the visibility of a parent frame affects that of its child frames. (Raising and Lowering): Describe restacking of frames and z-groups. (Child Frames): New section. * doc/lispref/windows.texi (Selecting Windows): Describe additional semantics of NORECORD argument of `select-window' and how `buffer-list-update-hook' can emulate a "select window hook". (Mouse Window Auto-selection): New section.
2016-12-31Update copyright year to 2017Paul Eggert1-1/+1
Run admin/update-copyright.
generated by cgit v1.2.1 (git 2.18.0) at 2026-04-18 20:36:24 +0000