aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/tips.texi (follow)
Commit message (Collapse)AuthorAgeFilesLines
* ; Add 2026 to copyright years.Sean Whitton2026-01-011-2/+2
|
* Merge from origin/emacs-30Eli Zaretskii2025-10-111-0/+9
|\ | | | | | | | | | | | | | | 1895ba3ba3b ; Document %i format 85db0ac0d6e ; * doc/lispref/nonascii.texi (Explicit Encoding): Fix a ... c119a3600ed ; * doc/lispref/tips.texi (Documentation Tips): Document ... Also fix trailing whitespace in test files.
| * ; * doc/lispref/tips.texi (Documentation Tips): Document \\+`foo'.Eli Zaretskii2025-10-081-0/+9
| |
* | Merge from origin/emacs-30Eli Zaretskii2025-05-101-4/+4
|\ \ | |/ | | | | | | | | | | | | | | | | 0d493864cee Fix indentation of XML comments 1a2c29b5317 Improve Tramp's make-process handling for Solaris a7dffc2ea38 Document 'time-stamp-time-zone' in Emacs Manual 0b4eb525b69 Make treesit--simple-indent-eval more permissive (bug#78065) ed7b55f6bf1 Adapt Tramp tests b172a1478c1 ; * doc/lispref/tips.texi (Library Headers): Fix wording ... 81629b2b2ba ; * lisp/gnus/mail-source.el (mail-sources): Fix a typo (...
| * ; * doc/lispref/tips.texi (Library Headers): Fix wording (bug#78253).Eli Zaretskii2025-05-051-4/+4
| |
* | Merge from origin/emacs-30Eli Zaretskii2025-04-121-12/+7
|\ \ | |/ | | | | | | | | | | | | | | | | | | d3c39fb522d Fix display of keys in 'help-form' buffers (bug#77118) 6509cc20a9e Improve documentation of 'user-emacs-directory' 3f060597306 Update remarks on name prefixes in coding conventions e966ff9759a ; * doc/emacs/files.texi (Image Mode): Fix a typo (bug#77... 378bea99b1a ; Fix doc strings of a few Dired commands 30fb2ac07a7 ; * CONTRIBUTE: Clarify single-line commit should end wit... 417d14a95ee ; * admin/MAINTAINERS: Complete the handover of VC bb756b195a7 ; Fix typo in Tramp
| * Update remarks on name prefixes in coding conventionsSean Whitton2025-04-121-12/+7
| | | | | | | | | | | | | | * doc/lispref/tips.texi (Coding Conventions): Say that it's okay to put the name prefix later for defining constructs, rather than explicitly instructing the reader to do so. Condense the recommendation to err on the side of prepending the name prefix.
| * Fix copyright years by handStefan Kangas2025-01-021-1/+1
| | | | | | | | These are dates that admin/update-copyright did not update.
| * Update copyright year to 2025Stefan Kangas2025-01-021-1/+1
| | | | | | | | Run "TZ=UTC0 admin/update-copyright".
* | * doc/lispref: new node "Finding Definitions"Stephen Gildea2025-01-221-1/+1
| | | | | | | | | | | | | | | | | | How to use variable 'find-function-regexp-alist', properties 'definition-name' and 'find-function-type-alist', and function 'find-function-update-type-alist' to help Emacs locate the definition of objects defined by macros. This material is moved from node "Standard Properties" and expanded.
* | Property definition-type becomes find-function-type-alistStephen Gildea2025-01-161-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | lisp/emacs-lisp/find-func.el (find-function-search-for-symbol): Use symbol property 'find-function-type-alist' instead of 'definition-type' (find-function-update-type-alist): New convenience function. * doc/lispref/symbols.texi (Standard Properties): Update example to use 'find-function-type-alist' and 'find-function-update-type-alist' * doc/lispref/functions.texi (Defining Functions): * doc/lispref/tips.texi (Coding Conventions): * doc/misc/ert.texi (How to Write Tests): * etc/NEWS: Change reference to 'definition-type' to name 'find-function-type-alist' instead
* | New symbol property 'definition-type' used by 'find-function'.Stephen Gildea2025-01-121-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/emacs-lisp/find-func.el (find-function-search-for-symbol): Look for new property 'definition-type' on the symbol. * doc/lispref/symbols.texi (Standard Properties): Add 'Definition-type'. * doc/lispref/functions.texi (Defining Functions): * doc/lispref/tips.texi (Coding Conventions): * doc/misc/ert.texi (How to Write Tests): Add cross reference to new property 'definition-type'. * etc/NEWS: Announce new symbol property 'definition-type'. Thanks to Eli Zaretskii for reviewing this change.
* | Fix copyright years by handPaul Eggert2025-01-011-1/+1
| | | | | | | | These are dates that admin/update-copyright did not update.
* | Update copyright year to 2025Paul Eggert2025-01-011-1/+1
| | | | | | | | Run "TZ=UTC0 admin/update-copyright".
* | Deprecate 'Homepage' header in favor of 'URL'Stefan Kangas2024-09-261-2/+2
|/ | | | | * doc/lispref/tips.texi (Library Headers): Document the 'Homepage' header as deprecated in favor of 'URL'.
* Fix copyright years by hand (Bug#72809)Stefan Kangas2024-08-261-1/+1
| | | | These are dates that admin/update-copyright did not update.
* Document GNU ELPA copyright in tips.texiStefan Kangas2024-07-201-5/+5
| | | | | * doc/lispref/tips.texi (Library Headers): Document that GNU ELPA packages should have their copyright assigned to the FSF.
* More updates of documentation for Emacs 30Eli Zaretskii2024-06-301-1/+1
| | | | | | | | | | | | | | | * etc/NEWS: Improve wording and move/mark entries. * doc/lispref/positions.texi (List Motion): Document 'forward-sentence-function'. * doc/lispref/functions.texi (What Is a Function): Document 'primitive-function-p' and 'cl-functionp'. * doc/emacs/misc.texi (Saving Emacs Sessions): Improve wording and indexing. * doc/lispref/tips.texi (Documentation Tips): Adapt to the new value of 'emacs-lisp-docstring-fill-column'. * doc/emacs/fixit.texi (Spelling): Document 'flyspell-check-changes'.
* Merge from origin/emacs-29Eli Zaretskii2024-04-061-5/+7
|\ | | | | | | | | | | | | 3d87d74a23d ; * etc/PROBLEMS: Entry about slow mouse-wheel with GTK3 ... c6899603b9c ; * doc/lispref/tips.texi (Documentation Tips): Improve (... bd2c4d825db ; Update admin/make-tarball.txt f107dc26e37 ; * etc/PROBLEMS: Add an entry about WebKitGTK (bug#66068).
| * ; * doc/lispref/tips.texi (Documentation Tips): Improve (bug#70163).Eli Zaretskii2024-04-041-5/+7
| |
* | Merge from savannah/emacs-29Po Lu2024-01-021-1/+1
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | dc4e6b13296 ; Update copyright years in more files 64b37776318 ; Run set-copyright from admin.el 8e1c56ae467 ; Add 2024 to copyright years # Conflicts: # doc/misc/modus-themes.org # doc/misc/texinfo.tex # etc/NEWS # etc/refcards/ru-refcard.tex # etc/themes/modus-operandi-theme.el # etc/themes/modus-themes.el # etc/themes/modus-vivendi-theme.el # lib/alloca.in.h # lib/binary-io.h # lib/c-ctype.h # lib/c-strcasecmp.c # lib/c-strncasecmp.c # lib/careadlinkat.c # lib/cloexec.c # lib/close-stream.c # lib/diffseq.h # lib/dup2.c # lib/filemode.h # lib/fpending.c # lib/fpending.h # lib/fsusage.c # lib/getgroups.c # lib/getloadavg.c # lib/gettext.h # lib/gettime.c # lib/gettimeofday.c # lib/group-member.c # lib/malloc.c # lib/md5-stream.c # lib/md5.c # lib/md5.h # lib/memmem.c # lib/memrchr.c # lib/nanosleep.c # lib/save-cwd.h # lib/sha1.c # lib/sig2str.c # lib/stdlib.in.h # lib/strtoimax.c # lib/strtol.c # lib/strtoll.c # lib/time_r.c # lib/xalloc-oversized.h # lisp/auth-source-pass.el # lisp/emacs-lisp/lisp-mnt.el # lisp/emacs-lisp/timer.el # lisp/info-look.el # lisp/jit-lock.el # lisp/loadhist.el # lisp/mail/rmail.el # lisp/net/ntlm.el # lisp/net/webjump.el # lisp/progmodes/asm-mode.el # lisp/progmodes/project.el # lisp/progmodes/sh-script.el # lisp/textmodes/flyspell.el # lisp/textmodes/reftex-toc.el # lisp/textmodes/reftex.el # lisp/textmodes/tex-mode.el # lisp/url/url-gw.el # m4/alloca.m4 # m4/clock_time.m4 # m4/d-type.m4 # m4/dirent_h.m4 # m4/dup2.m4 # m4/euidaccess.m4 # m4/fchmodat.m4 # m4/filemode.m4 # m4/fsusage.m4 # m4/getgroups.m4 # m4/getloadavg.m4 # m4/getrandom.m4 # m4/gettime.m4 # m4/gettimeofday.m4 # m4/gnulib-common.m4 # m4/group-member.m4 # m4/inttypes.m4 # m4/malloc.m4 # m4/manywarnings.m4 # m4/mempcpy.m4 # m4/memrchr.m4 # m4/mkostemp.m4 # m4/mktime.m4 # m4/nproc.m4 # m4/nstrftime.m4 # m4/pathmax.m4 # m4/pipe2.m4 # m4/pselect.m4 # m4/pthread_sigmask.m4 # m4/readlink.m4 # m4/realloc.m4 # m4/sig2str.m4 # m4/ssize_t.m4 # m4/stat-time.m4 # m4/stddef_h.m4 # m4/stdint.m4 # m4/stdio_h.m4 # m4/stdlib_h.m4 # m4/stpcpy.m4 # m4/strnlen.m4 # m4/strtoimax.m4 # m4/strtoll.m4 # m4/time_h.m4 # m4/timegm.m4 # m4/timer_time.m4 # m4/timespec.m4 # m4/unistd_h.m4 # m4/warnings.m4 # nt/configure.bat # nt/preprep.c # test/lisp/register-tests.el
| * ; Add 2024 to copyright yearsPo Lu2024-01-021-1/+1
| |
* | Merge from savannah/emacs-29Po Lu2023-11-241-1/+6
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | 1978b603bc3 Make python-ts-mode's syntax-highlighting more standardized 99658346d1e ; Improve documentation of desktop.el in user manual f7dc0202127 Fix "Text is read-only" on backspacing initial Calc input 662d54775d5 Add a doc string to simple.el (bug#67355) 5a5e36d2aad ; Improve function documentation tips 86016d8ecdb Mention "visual line" in user manual 4bb65ed77a8 ; * doc/lispref/minibuf.texi (Programmed Completion): Imp... dfb3dcb404c Allow listing Emoji from a read-only buffer # Conflicts: # lisp/calc/calc.el # lisp/international/emoji.el
| * ; Improve function documentation tipsEli Zaretskii2023-11-231-1/+6
| | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Clarify the good style of descriptions in doc strings.
* | Merge from origin/emacs-29Eli Zaretskii2023-11-181-5/+14
|\ \ | |/ | | | | | | | | | | | | | | | | | | 232a57a3e32 ; * doc/lispref/debugging.texi (Debugging): Add cross-ref... c65ddf26a33 ; doc/lispref/debugging.texi: Add reference to Profiler d... 6f884d3aed9 Add 5 docstrings to abbrev.el (bug#67153) b4d990bd637 ; Clarify wording about arguments in doc strings c20ae7a30fb ; Improve cross-references in description of 'pcase' 42181b65df1 ; * src/editfns.c (Fline_beginning_position): Doc fix. 5f3309f6b0f ; Improve indexing in ELisp manual 4e406bb4208 Fix CBZ file detection in doc-view-mode
| * ; Clarify wording about arguments in doc stringsEli Zaretskii2023-11-171-5/+5
| | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Clarify "important arguments". (Bug#67217)
| * ; Improve indexing in ELisp manualEli Zaretskii2023-11-161-0/+9
| | | | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips, Coding Conventions) (Key Binding Conventions, Programming Tips, Compilation Tips) (Warning Tips, Comment Tips, Library Headers): Improve indexing.
* | Merge from origin/emacs-29Eli Zaretskii2023-11-041-0/+15
|\ \ | |/ | | | | | | | | | | 196def4fa64 Fix description of 'Package-Requires' library header c1778432790 ; * doc/misc/tramp.texi (FUSE setup): Fix typo. a64336cbb9c * lisp/emacs-lisp/cl-lib.el (cl--defalias): Improve&fix d... da8b85b577d Add two docstrings in cl-lib.el
| * Fix description of 'Package-Requires' library headerEli Zaretskii2023-11-041-0/+15
| | | | | | | | | | * doc/lispref/tips.texi (Library Headers): Update the description of the 'Package-Requires' header. (Bug#66677)
* | Elaborate Elisp dialect selection in manualMattias Engdegård2023-10-231-1/+1
|/ | | | | | | | * doc/lispref/variables.texi (Using Lexical Binding): Rename to... (Selecting Lisp Dialect): ...this. All references updated. Add concrete examples of -*- lines. Move text about special variables from here... (Dynamic Binding): ...to here.
* ; Add 2023 to copyright years.Eli Zaretskii2023-01-011-1/+1
|
* ; * doc/lispref/tips.texi (Documentation Tips): Add indexing.Eli Zaretskii2022-12-311-0/+4
|
* ; Fix typosStefan Kangas2022-12-261-1/+1
| | | | (cherry picked from commit a5d39e11443fa30c8e8bc58254a1a59550dcd99e)
* Merge from origin/emacs-28Stefan Kangas2022-07-301-1/+1
|\ | | | | | | | | e0f54c62ec CC Mode: fontify variables/functions after line comments e... 2c6a94c5b8 ; Correct the meaning of "cf." in tips.texi
| * ; Correct the meaning of "cf." in tips.texiŠtěpán Němec2022-07-291-1/+1
| | | | | | | | | | | | | | Cf. e.g. https://en.wiktionary.org/wiki/cf. * doc/lispref/tips.texi (Documentation Tips): Correct the meaning of "cf.".
| * Revert the `...' documentation back to actual usageLars Ingebrigtsen2022-07-281-16/+10
| | | | | | | | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Document how `...' is really used now (bug#55780). ‘...’ is not really used in the Emacs sources. (cherry picked from commit 1ed9c1c7f9fe32ff5123091033350beb1ccae4ca)
* | Merge from origin/emacs-28Stefan Kangas2022-07-281-2/+2
|\ \ | |/ | | | | | | | | | | | | | | 23112f89f9 ; Improve documentation of 'file-name-with-extension' 4be938169d Release the desktop lock in 'kill-emacs-hook' 4ea1f6c7f8 ; * doc/lispref/tips.texi (Documentation Tips): Fix typos.... # Conflicts: # doc/lispref/tips.texi
| * ; * doc/lispref/tips.texi (Documentation Tips): Fix typos. (Bug#56802)Arash Esbati2022-07-271-2/+2
| |
* | Note guideline for doc string expressionsPaul Eggert2022-07-251-0/+12
| | | | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Mention \\=' and \\=` and say that expressions like (NAME TYPE RANGE) should not be quoted.
* | 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).
* | 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.
* | Merge from origin/emacs-28Eli Zaretskii2022-01-011-1/+1
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 836be7a112 ; * etc/refcards/ru-refcard.tex: Update Copyright year. 86cbc6ee4a * lisp/net/tramp-sh.el: Adapt copyright year ebe8772f65 ; Minor fixes related to copyright years 23c1ee6989 ; * test/manual/etags/ETAGS.good_N: Adjust to copyright ye... 8d3fc7ec89 * src/xfaces.c (face_for_font): Make 'hash' be uintptr_t. 19dcb237b5 ; Add 2022 to copyright years. # Conflicts: # etc/NEWS # etc/refcards/ru-refcard.tex # lib/cdefs.h # lisp/erc/erc-dcc.el # lisp/erc/erc-imenu.el # lisp/erc/erc-replace.el # lisp/image-dired.el # lisp/progmodes/xref.el # m4/alloca.m4 # m4/byteswap.m4 # m4/errno_h.m4 # m4/getopt.m4 # m4/gnulib-common.m4 # m4/inttypes.m4 # m4/stddef_h.m4 # m4/stdint.m4 # m4/sys_socket_h.m4
| * ; Add 2022 to copyright years.Eli Zaretskii2022-01-011-1/+1
| |
* | * doc/lispref/tips.texi (Coding Conventions): Mention GNU "path" conventionStefan Monnier2021-11-071-0/+7
|/ | | | Suggested by Ihor Radchenko <yantar92@gmail.com>.
* ; * doc/lispref/tips.texi (Programming Tips): Fix markup.Stefan Kangas2021-09-281-3/+3
|
* Improve coding conventions for error messagesStefan Kangas2021-09-281-1/+7
| | | | | | * doc/lispref/tips.texi (Programming Tips): Clarify coding conventions for error messages to say that an error message can start with a Lisp symbol. (Bug#50658)
* ; Improve recently added documentationEli Zaretskii2021-09-251-1/+7
| | | | | | * etc/NEWS: * doc/lispref/tips.texi (Documentation Tips): Improve and clarify recently-added documentation of man page references.
* Add support for man page hyperlinks in doc stringsStefan Kangas2021-09-251-0/+8
| | | | | | | | * lisp/help-mode.el (help-man): New button type. (help-xref-man-regexp): New const. (help-make-xrefs): Use them to allow making man page buttons. * doc/lispref/tips.texi (Documentation Tips): Document the new hyperlink type. (Bug#39215)
* Prefer "website" to "homepage"Stefan Kangas2021-09-161-4/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | These days, a "home page" is understood to be only "the main web page of a website" or "landing page", whereas a "website" is "a collection of web pages and related content" (Wikipedia). * doc/emacs/emacs.texi (Top): * doc/emacs/package.texi (Package Menu): * doc/lispintro/emacs-lisp-intro.texi (Top): * doc/lispref/elisp.texi (Top): * doc/lispref/tips.texi (Documentation Tips): * doc/misc/ede.texi (ede-project): * doc/misc/efaq-w32.texi (More information): * doc/misc/gnus-faq.texi (FAQ 5-7): * doc/misc/gnus.texi (About mairix): * doc/misc/mairix-el.texi (About): * doc/misc/reftex.texi (AUCTeX, Imprint): * lisp/cedet/ede/base.el (ede-project): * lisp/cedet/ede/system.el (ede-web-browse-home): * lisp/emacs-lisp/package.el (package-menu-mode-menu) (package-browse-url): * lisp/erc/erc-button.el (erc-emacswiki-url): * lisp/filesets.el (filesets-goto-homepage): * lisp/net/mairix.el: * lisp/net/webjump.el (webjump-sample-sites): * lisp/obsolete/vc-arch.el: * lisp/progmodes/idlw-shell.el (idlwave-shell-mode): * lisp/progmodes/idlwave.el (idlwave, idlwave-mode): * lisp/textmodes/reftex-vars.el (reftex): Prefer "website" to "home page". * doc/lispref/tips.texi (Documentation Tips): Sort the "URL" header comment before "Homepage". * lisp/emacs-lisp/lisp-mnt.el (lm-website): Rename from 'lm-homepage'. (lm-homepage): Make into alias for 'lm-website'.
* Doc fix for y-or-n-p; trailing space is no longer neededStefan Kangas2021-09-161-1/+1
| | | | | | | | | | * doc/lispref/minibuf.texi (Yes-or-No Queries): * doc/lispref/os.texi (Suspending Emacs): * doc/lispref/tips.texi (Programming Tips): * doc/misc/gnus-faq.texi (FAQ 5-9): * lisp/subr.el (y-or-n-p): * src/fns.c (Fyes_or_no_p): Doc fix to reflect that a trailing space is no longer needed; one is added or removed automatically.