summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* ; * doc/lispref/processes.texi (Bindat Types): Fix wording. (Bug#55815)Eli Zaretskii2022-06-091-2/+2
|
* bindat: Improve str, strz documentationRichard Hansen2022-06-091-3/+33
| | | | | | * doc/lispref/processes.texi (Bindat Types): Expand the documentation for the `str' and `strz' types to clarify expectations and explain edge case behavior.
* Account for remapped faces in $COLUMNS and $LINES in EshellJim Porter2022-06-091-15/+23
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * src/window.h (window_body_unit): New enum... (window_body_width): ... use it. * src/window.c (window_body_unit_from_symbol): New function. (window_body_height, window_body_width): Make PIXELWISE a 'window_body_unit'. (window-body-height, window-body-width): Accept 'remap' for PIXELWISE. (window-lines-pixel-dimensions, window_change_record_windows) (run_window_change_functions, resize_frame_windows, grow_mini_window) (shrink_mini_window, scroll-left, scroll-right): Update calls to 'window_body_height' and 'window_body_width'. * src/indent.c (compute_motion): Update calls to 'window_body_width'. * lisp/eshell/em-ls.el (eshell-ls-find-column-widths) (eshell-ls-find-column-lengths): Use 'window-body-width'. * lisp/eshell/esh-var.el (eshell-variable-aliases-list): Use 'window-body-width' and 'window-body-height'. * test/lisp/eshell/esh-var-tests.el (esh-var-test/window-height) (esh-var-test/window-width): Rename to... (esh-var-test/lines-var, esh-var-test/columns-var): ... and update expected value. * doc/lispref/windows.texi (Window Sizes): Document new behavior of PIXELWISE argument for 'window-body-width' and 'window-body-height'. * etc/NEWS: Announce this change (bug#55696).
* Also show mouse DND tooltip contents during interprogram drag-and-dropPo Lu2022-06-091-1/+7
| | | | | | | | | | | | | | | | | | | | | | * doc/lispref/frames.texi (Drag and Drop): Document new parameter to `x-begin-drag'. * lisp/mouse.el (mouse-drag-and-drop-region): Don't hide tooltip when initiating interprogram drag-and-drop. * lisp/term/haiku-win.el (x-begin-drag): * lisp/term/ns-win.el (x-begin-drag): Add stubs for new parameter. * src/xfns.c (Fx_begin_drag): New parameter `follow-tooltip'. (Fx_show_tip, syms_of_xfns): Add records of the last dx and dy given to `x-show-tip'. * src/xterm.c (x_clear_dnd_monitors): New function. (x_dnd_begin_drag_and_drop): Save monitor attributes list if appropriate. (x_dnd_compute_tip_xy, x_dnd_update_tooltip_position): New function. (x_dnd_update_state, handle_one_xevent): Update tooltip position during DND mouse movement. (syms_of_xterm): Update staticpros. * src/xterm.h: Update prototypes.
* * doc/man/emacs.1.in: Add --init-directory.Nicholas Vollmer2022-06-081-1/+5
| | | | * doc/man/emacs.1.in: Document --init-directory (bug#55839).
* * doc/emacs/vc1-xtra.texi (Customizing VC): Remove deprecated Mtn.Juri Linkov2022-06-071-1/+1
|
* Allow posn-col-row to return data on a per-window basisLars Ingebrigtsen2022-06-071-2/+6
| | | | | * doc/lispref/commands.texi (Accessing Mouse): Document it. * lisp/subr.el (posn-col-row): Extend to use window data.
* Remove mentions of GNOME MediaKeys from dbus documentation examplesPo Lu2022-06-071-7/+1
| | | | | | * doc/misc/dbus.texi (Properties and Annotations): * lisp/net/dbus.el (dbus-get-all-managed-objects): Remove mentions of obsolete GNOME APIs from example text.
* Make the goal column work for the scrolling commands, tooLars Ingebrigtsen2022-06-051-5/+5
| | | | | | | | * doc/emacs/basic.texi (Moving Point): Document it. * lisp/simple.el (set-goal-column): Update doc string. * lisp/window.el (scroll-up-command, scroll-down-command): Make the goal column take effect for these commands, too (bug#17346).
* Add new command find-sibling-fileLars Ingebrigtsen2022-06-051-0/+39
| | | | | | | * doc/emacs/files.texi (Visiting): Document it. * lisp/files.el (file-expand-wildcards): Fix up the regexp expansion. (find-sibling-rules, find-sibling-file): New user option and command. (find-sibling-file--search): New helper function.
* Extend file-expand-wildcards to allow regexpsLars Ingebrigtsen2022-06-051-1/+7
| | | | | | | | * doc/lispref/files.texi (Contents of Directories): Document it. * lisp/files.el (file-expand-wildcards): Extend to allow regexps. * lisp/emacs-lisp/shortdoc.el (file): Expand the file-expand-wildcards example.
* Merge from origin/emacs-28Stefan Kangas2022-06-055-78/+9
|\ | | | | | | | | | | | | | | | | | | | | | | 1b8719835a Update to Org 9.5.4 92c5faafd7 Clarify documentation of 'string-to-unibyte' 2848512654 ; * lisp/files.el (find-file): Avoid too short lines in do... 672f9f787f Improve keystrokes in doc strings in some find-file functions ef5651cc77 Fix segfaults when starting on 80x26 TTY frames bfa647972f ; Fix doc string of 'delete-selection-repeat-replace-region' a95d46e00f Make it explicit that a couple of _s in lispref are unders... 5c74c25123 Remove from FAQ the MS-Windows info about BDF fonts edb48646f2 Fix Display Property manual example
| * Clarify documentation of 'string-to-unibyte'Eli Zaretskii2022-06-041-5/+6
| | | | | | | | | | | | * doc/lispref/nonascii.texi (Converting Representations): Clarify what 'string-to-unibyte' does. Reported by Richard Hansen <rhansen@rhansen.org>. (Bug#55777)
| * Make it explicit that a couple of _s in lispref are underscoresLars Ingebrigtsen2022-06-012-2/+2
| | | | | | | | | | | | * doc/lispref/strings.texi (Custom Format Strings): * doc/lispref/control.texi (pcase Macro): Make it explicit that it's an underscore (bug#55742).
| * Remove from FAQ the MS-Windows info about BDF fontsEli Zaretskii2022-05-311-70/+0
| | | | | | | | | | | | * doc/misc/efaq.texi (How to add fonts): Remove the MS-Windows specific steps, as BDF fonts are no longer supported on MS-Windows. (Bug#55740)
| * Fix Display Property manual exampleIkumi Keita2022-05-311-1/+1
| | | | | | | | | | | | | | * doc/lispref/display.texi (Display Property): Fix syntax of example (bug#55736). Copyright-paperwork-exempt: yes
* | Further notes about quotation marks in the manualLars Ingebrigtsen2022-06-041-1/+5
| | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Note that we previously recommended using single quotation marks (bug#55780).
* | Allow keyboard modifiers to control the action taken during dired DNDPo Lu2022-06-041-3/+6
| | | | | | | | | | | | | | | | | | | | | | * doc/emacs/dired.texi (Misc Dired Features): Update documentation. * lisp/dired.el (dired-mouse-drag-files): Update defcustom for new values. (dired-mouse-drag): Recognize more values of `dired-mouse-drag-files' and keyboard modifiers. (dired-mouse-drag-files-map): Add C-down-mouse-1, M-down-mouse-1 and S-down-mouse-1.
* | Improve doc of `mouse-drag-mode-line-buffer'Po Lu2022-06-041-0/+6
| | | | | | | | | | | | | | * doc/emacs/frames.texi (Mouse Commands): Document `mouse-drag-mode-line-buffer'. * etc/NEWS: Explain where that option is supported. * lisp/mouse.el (mouse-drag-mode-line-buffer): Likewise.
* | Add new user option project-vc-include-untrackedJan Synáček2022-06-041-0/+3
| | | | | | | | | | * doc/emacs/maintaining.texi (Projects): Document it. * lisp/progmodes/project.el (project--vc-list-files): Use it.
* | ; Improve documentation of new drag-and-drop APIsEli Zaretskii2022-06-031-42/+47
| | | | | | | | | | | | * lisp/dnd.el (dnd-begin-text-drag, dnd-begin-file-drag): * doc/lispref/frames.texi (Drag and Drop): Improve wording of documentation of 'dnd-begin-text-drag' and 'dnd-begin-file-drag'.
* | Allow dragging multiple files from a Dired bufferPo Lu2022-06-031-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/frames.texi (Drag and Drop): Document new function `dnd-begin-drag-files'. * lisp/dired.el (dired-mouse-drag-files): Update doc string. (dired-map-over-marks): Accept a new value of ARG `marked', meaning to not fall back to the current file if no marks were found. (dired-mouse-drag): Handle marked files in an intuitive way. * lisp/dnd.el (dnd-last-dragged-remote-file): Allow list values as well. (dnd-remove-last-dragged-remote-file): Handle list values. (dnd-begin-file-drag): Fix file name expansion. (dnd-begin-drag-files): New function. * lisp/select.el (xselect-convert-to-filename): Handle mutiple files (a vector of file names):.
* | Revert the `...' documentation back to actual usageLars Ingebrigtsen2022-06-031-16/+10
| | | | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Document how `...' is really used now (bug#55780). ‘...’ is not really used in the Emacs sources.
* | Add easier-to-use interfaces for initiating drag-and-dropPo Lu2022-06-031-0/+89
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The previous interface required that users know intricacies of the data types used to transfer data on each platform Emacs supports. * doc/lispref/frames.texi (Drag and Drop): Document new functions. * lisp/dired.el (dired-last-dragged-remote-file) (dired-remove-last-dragged-local-file): Delete functions. (dired-mouse-drag): Use `dnd-begin-file-drag'. * lisp/dnd.el (dnd-last-dragged-remote-file) (dnd-remove-last-dragged-remote-file): New variables and functions. (dnd-begin-text-drag, dnd-begin-file-drag): New functions. * src/xterm.c (x_dnd_begin_drag_and_drop): Add porting note.
* | Add a new user option battery-update-functionsLars Ingebrigtsen2022-06-031-1/+3
| | | | | | | | | | | | | | * doc/emacs/display.texi (Optional Mode Line): Document it. * lisp/battery.el (battery-update-functions): New user option (bug#55770). (battery-update): Use it.
* | Remove window-max-characters-per-lineLars Ingebrigtsen2022-06-032-23/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/windows.texi (Window Sizes): * doc/lispref/display.texi (Size of Displayed Text): Remove documentation. * lisp/fringe.el (fringe-mode): Point to the right function. * lisp/window.el (window-char-pixel-width) (window-char-pixel-height, window-max-characters-per-line): Remove functions -- this was already added as window-max-chars-per-line. * src/window.c (Fwindow_body_width): Adjust doc string.
* | delete-selection-mode: Add user option to delete temporary regions onlyVisuwesh2022-06-011-1/+12
| | | | | | | | | | | | | | | | * lisp/delsel.el (delete-selection-temporary-region): Add new user option. (delete-selection-pre-hook): Respect it. * doc/emacs/mark.texi (Using Region): Document the new user option. * etc/NEWS: Announce the new user option. (bug#55692)
* | Improve documentation of Lisp-level drag-and-drop featuresPo Lu2022-06-011-18/+44
| | | | | | | | | | | | | | * doc/lispref/frames.texi (Drag and Drop): Don't conflate X Windows specific implementation details with general drag-and-drop functionality, document what `dnd-protocol-alist' actually means, and improve documentation on DND data types.
* | Update modus-themes to their latest versionProtesilaos Stavrou2022-06-011-82/+212
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * admin/MAINTAINERS: Update link to the Git repository of the modus-themes; point to the new mailing list; include command for sending a bug report. * doc/misc/modus-themes.org (Install from the archives): Minor rewording. (Dealing with byte compilation errors): Clarify that occasional bugs are not always a fault of the themes. (Custom hl-todo colors): Add note about package.:(Full support for packages or face groups, Indirectly covered packages): Update lists of supported packages. (Note on avy hints): Remove obsolete node. (Note on git-gutter in Doom Emacs): Note problem with custom bitmaps, which is not the fault of the themes. (Note on display-fill-column-indicator-mode): Show how to use a thicker indicator.:(Why are colors mostly variants of blue, magenta, cyan?): Minor rewording. (Sources of the themes): Update official theme sources. (Issues you can help with) (Patches require copyright assignment to the FSF): Update the information on potential contributions. (Acknowledgements): Update list of contributors in the form of code or ideas/feedback. (Meta, Other notes about the project): Rename section and include more links to development-related blog posts. * etc/themes/modus-themes.el (seq): Stop requiring 'seq'. (modus-themes--version): Use internal variable for the themes' version. (modus-themes-operandi-colors, modus-themes-vivendi-colors): Make minor tweaks to the color palettes. (modus-themes-variable-pitch): Remove obsolete symbol from doc string. (modus-themes--alist-or-seq): Update function to not rely on 'seq'. (modus-themes--current-theme): Make stylistic tweaks. (modus-themes--markup): Use correct order of inheritance for faces. (modus-themes--paren, modus-themes--heading) (modus-themes--agenda-structure, modus-themes--agenda-date) (modus-themes--agenda-habit, modus-themes--mode-line-attrs) (modus-themes--mode-line-padded-box, modus-themes--button): Update to use 'modus-themes--property-lookup' instead of the previous function that depended on 'seq'. (modus-themes--diff): Make it combine as expected with the user option 'modus-themes-deuteranopia'. (modus-themes-faces): Update list of faces. (modus-themes-custom-variables): Expand support for face rotation in 'highlight-changes'. * etc/themes/modus-operandi-theme.el: * etc/themes/modus-vivendi-theme.el: Bump version number to 2.4.1. Release notes: <https://protesilaos.com/codelog/2022-06-01-modus-themes-2-4-0/>.
* | Clean up text/uri-list mess inside the Dired drag-and-drop codePo Lu2022-06-011-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/frames.texi (Window System Selections): * etc/NEWS: Document new changes to `gui-get-selection'. * lisp/dired.el (dired-mouse-drag): Specify text/uri-list value explicitly. * lisp/select.el (gui-set-selection): Update doc string. (xselect-convert-to-text-uri-list): Update to handle either a single URL (as a string) or a vector of URLs, instead of file names. (xselect-uri-list-available-p): Likewise. * src/xselect.c (x_get_local_selection): Look in tem's text properties (if it is a string) for a local value before using tem itself.
* | Speed up generation of loaddefs filesLars Ingebrigtsen2022-05-311-14/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/loading.texi (Autoload, Autoload by Prefix): Refer to loaddefs-generate instead of update-file-autoloads. * lisp/Makefile.in (LOADDEFS): Remove, because all the loaddefs files are created in one go now. (COMPILE_FIRST): Add loaddefs-gen/radix-tree, and drop autoload. ($(lisp)/loaddefs.el): Use loaddefs-gen. (MH_E_DIR, $(TRAMP_DIR)/tramp-loaddefs.el) ($(MH_E_DIR)/mh-loaddefs.el, $(CAL_DIR)/cal-loaddefs.el) ($(CAL_DIR)/diary-loaddefs.el, $(CAL_DIR)/hol-loaddefs.el): Remove. * lisp/generic-x.el: Inhibit computing prefixes, because the namespace here is all wonky. * lisp/w32-fns.el (w32-batch-update-autoloads): Removed -- unused function. * lisp/calendar/holidays.el ("holiday-loaddefs"): Renamed from hol-loaddefs to have a more regular name. * lisp/cedet/ede/proj-elisp.el (ede-emacs-cedet-autogen-compiler): Refer to loaddefs-gen instead of autoload. * lisp/emacs-lisp/autoload.el (make-autoload, autoload-rubric) (autoload-insert-section-header): Made into aliases of loaddefs-gen functions. (autoload--make-defs-autoload): Ditto. (autoload-ignored-definitions, autoload-compute-prefixes): Moved to loaddefs-gen. * lisp/emacs-lisp/lisp-mode.el (lisp-mode-autoload-regexp): New constant. (lisp-fdefs, lisp-mode-variables, lisp-outline-level): Use it to recognize all ;;;###autoload forms. * lisp/emacs-lisp/loaddefs-gen.el: New file. * lisp/emacs-lisp/package.el: Use loaddefs-generate instead of make-directory-autoloads. * test/lisp/vc/vc-bzr-tests.el (vc-bzr-test-faulty-bzr-autoloads): Use loaddefs instead of autoloads.
* | Doc fix for dst flagPaul Eggert2022-05-291-2/+2
| | | | | | | | * doc/lispref/os.texi (Time Conversion): Note Common Lisp dst differs.
* | Make `count-words' count sentences.Manuel Giraud2022-05-291-7/+7
| | | | | | | | | | | | | | | | | | | | | | | | * lisp/textmodes/paragraphs.el (count-sentences): New function. * lisp/simple.el (count-words--format): Update format for showing sentences. (count-words): Also count sentences. * lisp/simple.el (count-words): * etc/NEWS: * doc/emacs/basic.texi (Position Info): Update documentation for sentence counting.
* | Merge from origin/emacs-28Stefan Kangas2022-05-292-7/+10
|\| | | | | | | | | | | | | f9ee83bfb9 do_switch_frame: before leaving mini-window, check other (... 908e2e09d0 Fix commands used to produce on-line HTML docs fff770fb97 Fix a bad cross-reference in elisp.pdf ebea3415b0 Fix documentation of 'string-pad'
| * Fix a bad cross-reference in elisp.pdfEli Zaretskii2022-05-281-1/+4
| | | | | | | | | | * doc/lispref/control.texi (pcase Macro): Fix a conditional cross-reference (bug#55689).
| * Fix documentation of 'string-pad'Eli Zaretskii2022-05-281-6/+6
| | | | | | | | | | * doc/lispref/strings.texi (Creating Strings): Fix description of 'string-pad'. (Bug#55688)
* | Merge from origin/emacs-28Stefan Kangas2022-05-281-1/+1
|\| | | | | | | | | d3cde28b03 Fix more occurrences of renamed kmacro-keymap command bd5c95a90d Mention "unspecified-fg" and "unspecified-bg" in some doc ...
| * Fix more occurrences of renamed kmacro-keymap commandJuri Linkov2022-05-271-1/+1
| | | | | | | | | | * doc/emacs/kmacro.texi (Basic Keyboard Macro): Fix documentation after recent kmacro-redisplay command name change.
* | Improve documentation on what callers of `x-begin-drag' should doPo Lu2022-05-281-0/+4
| | | | | | | | | | | | * doc/lispref/frames.texi (Drag and Drop): * src/xfns.c (Fx_begin_drag): Improve documentation of how the chosen action should be performed.
* | Improve DND documentationPo Lu2022-05-281-1/+3
| | | | | | | | | | | | * doc/lispref/frames.texi (Drag and Drop): * src/xfns.c (Fx_begin_drag): Document that x-begin-drag may return immediately if no mouse buttons are held down.
* | Merge from origin/emacs-28Stefan Kangas2022-05-271-1/+1
|\| | | | | | | | | 9283508fb2 Fix format specifiers in tramp-adb.el a9f17ccce3 ; Fix some doc typos and minor language issues
| * ; Fix some doc typos and minor language issuesŠtěpán Němec2022-05-261-1/+1
| |
* | eval.c: New functions `defvar-1` and `defconst-1` (bug#55156)Stefan Monnier2022-05-261-4/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The bytecode interpreter can't directly call special forms, so the byte-compiler usually converts special forms into some sequence of byte codes (basically, providing a duplicate definition of the special form). There are still two exceptions to this: `defconst` and `defvar`, where the compiler instead generates a convoluted chunk of code like: (funcall '(lambda (x) (defvar <sym> x <doc>)) <value>) where the quote makes sure we keep the function non-compiled, so as to end up running the special form at run time. Get rid of this workaround by introducing `defvar-1` and `defconst-1` which provide a *functional* interface to the functionality of the corresponding special form. * src/eval.c (defvar, Fdefvar_1, Fdefconst_1): New functions, extracted from `Fdefvar` and `Fdefconst`. (Fdefvar, Fdefconst): Use them. (syms_of_eval): `defsubr` the new functions. * lisp/emacs-lisp/bytecomp.el (byte-compile-tmp-var): Delete const. (byte-compile-defvar): Simplify using the new functions. * doc/lispref/variables.texi (Defining Variables): Adjust the doc of `defvar` to reflect the actual semantics implemented.
* | Merge from origin/emacs-28Eli Zaretskii2022-05-254-27/+56
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 86b49d5865 ; * etc/NEWS: Announce changes in 'desktop-kill'. (Bug#55... d5ccf2621a ; Fix last change f1c1fd7184 Improve documentation of mail-user-agent. b05d1e9b98 ; * lisp/desktop.el: Update the commentary. (Bug#55560) 139bfa1a08 More fixes in abbrev.el doc strings d80dea6036 Add note about Tramp completion to completion-styles doc s... 9e7c0cf57d Remove mention of removed nnimap-nov-is-evil variable 90aae0bca2 Improve documentation strings and prompts in abbrev.el dfa3e6f424 Restore the Fselect_window call in gui_consider_frame_title. de35e9728f Advise against settings in the MS-Windows system registry 3ffa3d3403 ; Minor addition to make-tarball.txt 7dc026f9ea Fix kmacro-keymap binding after previous change 4f0fd54bc4 Add glossary entries for "interactively" af1c05a3c4 Fix the name of a kmacro command. # Conflicts: # etc/NEWS # lisp/abbrev.el
| * ; Fix last changeEli Zaretskii2022-05-221-1/+3
| | | | | | | | | | * doc/emacs/sending.texi (Mail Methods): Fix indexing and markup. (Bug#55569)
| * Improve documentation of mail-user-agent.Damien Cassou2022-05-221-1/+3
| | | | | | | | | | | | * doc/emacs/sending.texi (Mail Methods): * lisp/simple.el (mail-user-agent): Mention additional options of non-bundled MUA. (Bug#5569)
| * Remove mention of removed nnimap-nov-is-evil variableArash Esbati2022-05-211-4/+3
| | | | | | | | | | * doc/misc/gnus.texi (Slow/Expensive Connection): Remove mention of removed nnimap-nov-is-evil variable (bug#55556).
| * Advise against settings in the MS-Windows system registryEli Zaretskii2022-05-201-19/+35
| | | | | | | | | | * doc/emacs/cmdargs.texi (MS-Windows Registry): Advise against setting environment variables in the system registry. (Bug#16429)
| * Add glossary entries for "interactively"Lars Ingebrigtsen2022-05-171-3/+13
| | | | | | | | | | * doc/emacs/glossary.texi (Glossary): Mention "interactively" and how it relates to the "command" concept (bug#55461).
* | Make yank-transform-functions into defvarLars Ingebrigtsen2022-05-251-2/+2
| | | | | | | | | | | | * doc/lispref/text.texi (Yanking): Adjust. * lisp/simple.el (yank-transform-functions): Make into defvar because it's not that useful as a user option.