summaryrefslogtreecommitdiff
path: root/doc/lispref/syntax.texi
Commit message (Collapse)AuthorAgeFilesLines
* ; * doc/lispref/syntax.texi (Position Parse): Fix a typo. (Bug#55143)Arash Esbati2022-04-271-1/+1
|
* ; Add 2022 to copyright years.Eli Zaretskii2022-01-011-1/+1
|
* Improve documentation of syntax-ppss-context slightlyRobert Pluim2021-10-221-0/+1
| | | | | * doc/lispref/syntax.texi (Parser State): Document all possible return values from 'syntax-ppss-context'.
* Add a new function syntax-class-to-charLars Ingebrigtsen2021-06-151-0/+5
| | | | | * doc/lispref/syntax.texi (Syntax Table Internals): Document it. * src/syntax.c (Fsyntax_class_to_char): New function (bug#37452).
* Document that the 'syntax-propertize-function' may move point.Philipp Stephani2021-05-301-6/+8
| | | | | | | | | The functions generated by 'syntax-propertize-rules' don't use 'save-excursion', but 'syntax-propertize' does, so we might as well document that the 'syntax-propertize-function' may move point. * doc/lispref/syntax.texi (Syntax Properties): Document that the 'syntax-propertize-function' may move point.
* Merge from origin/emacs-27Glenn Morris2021-02-061-4/+5
|\ | | | | | | | | | | | | | | | | | | 8ad48a0bdd (origin/emacs-27) Improve doc string of 'text-scale-adjust' 7a25ff767d Clarify the indent-rigidly doc string 6c5ddf0e0b Fix two small tab bar issues c71e08eba9 Fix last change in syntax.texi # Conflicts: # lisp/indent.el
| * Fix last change in syntax.texiEli Zaretskii2021-02-051-4/+5
| | | | | | | | | | * doc/lispref/syntax.texi (Syntax Properties): Fix wording in last change. (Bug#46274)
| * Correct the lispref manual about flushing ppss infoLars Ingebrigtsen2021-02-051-4/+4
| | | | | | | | | | | | | | | | * doc/lispref/syntax.texi (Syntax Properties): Correct the information about flushing the state by copying the text from the doc string (bug#46274). (cherry picked from commit ff701ce2b261acce1dfcd1fe137268d87d5eab35)
| * Update copyright year to 2021Paul Eggert2021-01-011-1/+1
| | | | | | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* | Correct the lispref manual about flushing ppss infoLars Ingebrigtsen2021-02-051-4/+4
| | | | | | | | | | | | * doc/lispref/syntax.texi (Syntax Properties): Correct the information about flushing the state by copying the text from the doc string (bug#46274).
* | * doc/lispref/syntax.texi (Syntax Class Table): Clarify `@`Stefan Monnier2021-01-031-1/+1
| |
* | Update copyright year to 2021Paul Eggert2021-01-011-1/+1
|/ | | | Run "TZ=UTC0 admin/update-copyright".
* Fix a rare segfault in syntax.cEli Zaretskii2020-09-191-8/+10
| | | | | | | | | | * src/syntax.c (Fforward_comment): Prevent the loop for COUNT < 0 from going outside the valid range of character/byte positions. (Bug#43499) * doc/lispref/syntax.texi (Syntax Class Table): Mention the "comment-fence" and "string-fence" as alternative names of 2 syntax classes.
* Add doc to syntax-propertize-function saying it must do a 100% jobAlan Mackenzie2020-09-191-0/+9
| | | | | | | | | | and cannot be combined with other ways of applying syntax-table text properties. * lisp/emacs-lisp/syntax.el (syntax-propertize-function): Amend doc string. * doc/lispref/syntax.texi (Syntax Properties): Amend the description of the variable.
* Remove #' and function quoting from lambda forms in manualMattias Engdegård2020-04-191-3/+3
| | | | | | | | | | | | * doc/lispref/abbrevs.texi (Abbrev Expansion): * doc/lispref/backups.texi (Reverting): * doc/lispref/functions.texi (Mapping Functions): * doc/lispref/help.texi (Accessing Documentation): * doc/lispref/sequences.texi (Char-Tables): * doc/lispref/syntax.texi (Categories): * doc/lispref/text.texi (Sorting): Remove function quoting from lambda in examples where it still occurs, since examples should follow our best style and be consistent.
* Update copyright year to 2020Paul Eggert2020-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* Elisp manual: mention parse-partial-sexp as the source of a parser state, etcAlan Mackenzie2019-12-201-9/+10
| | | | | | | | * doc/lispref/syntax.texi (Parser State): mention parse-partial-sexp as a function returning a parser state, and the function to which one supplies a parser state as an argument for continued parsing. Refine the documentation of syntax-ppss-context, and correct the text introducing it and another function.
* Document syntax-ppss-contextLars Ingebrigtsen2019-06-241-0/+5
| | | | | | | * doc/lispref/syntax.texi (Parser State): Document it. * lisp/emacs-lisp/syntax.el (syntax-ppss-context): Add a doc string (bug#32504).
* Merge from origin/emacs-26Glenn Morris2019-02-201-2/+2
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ff9c962 ; * lisp/ldefs-boot.el: Update. b4a251c * ; ChangeLog.3 update d3104e3 * etc/AUTHORS: Update. a19bfb7 Remove .art from the default list of ImageMagick extensions 6985caa Fix input after setting x-wait-for-event-timeout nil 715388a Fix two warnings in eshell.texi d49cdd9 * lisp/minibuffer.el (completion-table-dynamic): Improve docs... 5dc4e51 * lisp/emacs-lisp/debug.el (debug-on-variable-change): Doc fi... 76ef805 Fix a typo in ELisp manual b5e66f4 Update citations of Internet RFCs 57ece2a Fix handling of manpage references divided by hyphenation 7ad0cd6 * doc/misc/eshell.texi: Fix some @ref's. 12b7940 Fix a typo in lispref/syntax.texi # Conflicts: # lisp/gnus/nnrss.el # lisp/mail/ietf-drums.el
| * Fix a typo in lispref/syntax.texiEli Zaretskii2019-02-161-2/+2
| | | | | | | | | | * doc/lispref/syntax.texi (Syntax Table Internals): Fix a typo. (Bug#34495)
* | Merge from origin/emacs-26Glenn Morris2019-02-151-6/+5
|\| | | | | | | | | | | | | | | | | | | 3f4b8e9 * src/data.c (Fmake_local_variable): Fix bug#34318 b384996 Minor fixes in ELisp manual wrt syntax-table properties 71fc6d2 * admin/notes/emba: New file. 3aaa2d2 Fix Hunspell invocation for discovering its dictionaries # Conflicts: # test/src/data-tests.el
| * Minor fixes in ELisp manual wrt syntax-table propertiesEli Zaretskii2019-02-121-6/+5
| | | | | | | | | | | | * doc/lispref/syntax.texi (Syntax Properties): Fix reference to syntax-table properties. (Bug#34455) (Control Parsing): Remove redundant @vindex entry.
* | Merge from origin/emacs-26Paul Eggert2018-12-311-1/+1
|\| | | | | | | | | | | 2fcf2df Fix copyright years by hand 26bed8b Update copyright year to 2019 2814292 Fix value of default frame height. (Bug#33921)
| * Update copyright year to 2019Paul Eggert2019-01-011-1/+1
| | | | | | | | Run 'TZ=UTC0 admin/update-copyright $(git ls-files)'.
* | Audit use of lsh and fix glitchesPaul Eggert2018-08-211-4/+4
|/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | I audited use of lsh in the Lisp source code, and fixed the glitches that I found. While I was at it, I replaced uses of lsh with ash when either will do. Replacement is OK when either argument is known to be nonnegative, or when only the low-order bits of the result matter, and is a (minor) win since ash is a bit more solid than lsh nowadays, and is a bit faster. * lisp/calc/calc-ext.el (math-check-fixnum): Prefer most-positive-fixnum to (lsh -1 -1). * lisp/vc/vc-hg.el (vc-hg-state-fast): When testing fixnum width, prefer (zerop (ash most-positive-fixnum -32)) to (zerop (lsh -1 32)) (Bug#32485#11). * lisp/emacs-lisp/bytecomp.el (byte-compile-lapcode): Tighten sanity-check for bytecode overflow, by checking that the result of (ash pc -8) is nonnegative. Formerly this check was not needed since lsh was used and the number overflowed differently. * lisp/net/dns.el (dns-write): Fix some obvious sign typos in shift counts. Evidently this part of the code has never been exercised. * lisp/progmodes/hideif.el (hif-shiftleft, hif-shiftright): * lisp/term/common-win.el (x-setup-function-keys): Simplify. * admin/unidata/unidata-gen.el, admin/unidata/uvs.el: * doc/lispref/keymaps.texi, doc/lispref/syntax.texi: * doc/misc/calc.texi, doc/misc/cl.texi, etc/NEWS.19: * lisp/arc-mode.el, lisp/calc/calc-bin.el, lisp/calc/calc-comb.el: * lisp/calc/calc-ext.el, lisp/calc/calc-math.el: * lisp/cedet/semantic/wisent/comp.el, lisp/composite.el: * lisp/disp-table.el, lisp/dos-fns.el, lisp/edmacro.el: * lisp/emacs-lisp/bindat.el, lisp/emacs-lisp/byte-opt.el: * lisp/emacs-lisp/bytecomp.el, lisp/emacs-lisp/cl-extra.el: * lisp/erc/erc-dcc.el, lisp/facemenu.el, lisp/gnus/message.el: * lisp/gnus/nndoc.el, lisp/gnus/nnmaildir.el, lisp/image.el: * lisp/international/ccl.el, lisp/international/fontset.el: * lisp/international/mule-cmds.el, lisp/international/mule.el: * lisp/json.el, lisp/mail/binhex.el, lisp/mail/rmail.el: * lisp/mail/uudecode.el, lisp/md4.el, lisp/net/dns.el: * lisp/net/ntlm.el, lisp/net/sasl.el, lisp/net/socks.el: * lisp/net/tramp.el, lisp/obsolete/levents.el: * lisp/obsolete/pgg-parse.el, lisp/org/org.el: * lisp/org/ox-publish.el, lisp/progmodes/cc-defs.el: * lisp/progmodes/ebnf2ps.el, lisp/progmodes/hideif.el: * lisp/ps-bdf.el, lisp/ps-print.el, lisp/simple.el: * lisp/tar-mode.el, lisp/term/common-win.el: * lisp/term/tty-colors.el, lisp/term/xterm.el, lisp/vc/vc-git.el: * lisp/vc/vc-hg.el, lisp/x-dnd.el, test/src/data-tests.el: Prefer ash to lsh when either will do.
* Improve documentation of comment stylesEli Zaretskii2018-06-021-5/+7
| | | | | * doc/lispref/syntax.texi (Syntax Flags): Define the "a" style. (Bug#31624)
* Complete documentation of syntax flags by adding `c'Alan Mackenzie2018-04-131-1/+1
| | | | | * doc/lispref/syntax.texi ("Syntax Table Internals"): Add entry for `c' as `(1 lsh 23)'.
* Document, in the Elisp manual, how to get a character's raw syntax descriptorAlan Mackenzie2018-02-221-0/+4
| | | | | * doc/lispref/syntax.texi (Syntax Table internals): mention the use of `aref' to get a character's raw syntax descriptor.
* Update copyright year to 2018Paul Eggert2018-01-011-1/+1
| | | | Run admin/update-copyright.
* Avoid some overfull lines in PDF lisprefGlenn Morris2017-12-221-4/+5
| | | | | | | | | * 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.
* Doc amendment for syntax-ppss.Alan Mackenzie2017-10-011-6/+7
| | | | | | * doc/elisp/syntax.texi (Position Parse): Note, twice, that syntax-ppss is equivalent to parse-partial-sexp from the beginning of THE VISIBLE PART OF the buffer. Final part of the fix for bug #22983.
* Remove inadvertent changes to syntax.texi in last commit.Alan Mackenzie2017-10-011-7/+6
| | | | * doc/lispref/syntax.texi (Position Parse): revert changes.
* Amend documentation for text-quoting-style becoming a user option.Alan Mackenzie2017-10-011-6/+7
| | | | | | | | | | | | | | * doc/lispref/control.texi (Signaling Errors): * doc/lispref/display.texi (Displaying Messages): * doc/lispref/strings.texi (Formatting Strings): Edit for brevity, farming out the details to the new Text Quoting Style node. * doc/lispref/help.texi (Text Quoting Style): New section. Move detailed discussion of text-quoting-style here. Add discussion about how to output grave accent and apostrophe in documentation and messages. Adjust xrefs to point to this section when appropriate. * etc/NEWS: text-quoting-style semantics have not changed.
* Merge from origin/emacs-25Paul Eggert2017-01-011-1/+1
|\ | | | | | | | | 2e2a806 Fix copyright years by hand 5badc81 Update copyright year to 2017
| * Update copyright year to 2017Paul Eggert2016-12-311-1/+1
| | | | | | | | Run admin/update-copyright.
* | Amend parse-partial-sexp correctly to handle two character comment delimitersAlan Mackenzie2016-03-201-14/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Do this by adding a new field to the parser state: the syntax of the last character scanned, should that be the first char of a (potential) two char construct, nil otherwise. This should make the parser state complete. Also document element 9 of the parser state. Also refactor the code a bit. * src/syntax.c (struct lisp_parse_state): Add a new field. (SYNTAX_FLAGS_COMSTARTEND_FIRST): New function. (internalize_parse_state): New function, extracted from scan_sexps_forward. (back_comment): Call internalize_parse_state. (forw_comment): Return the syntax of the last character scanned to the caller when that character might be the first of a two character construct. (Fforward_comment, scan_lists): New dummy variables, passed to forw_comment. (scan_sexps_forward): Remove a redundant state parameter. Access all `state' information via the address parameter `state'. Remove the code which converts from external to internal form of `state'. Access buffer contents only from `from' onwards. Reformulate code at the top of the main loop correctly to recognize comment openers when starting in the middle of one. Call forw_comment with extra argument (for return of syntax value of possible first char of a two char construct). (Fparse_partial_sexp): Document elements 9, 10 of the parser state in the doc string. Clarify the doc string in general. Call internalize_parse_state. Take account of the new elements when consing up the output parser state. * doc/lispref/syntax.texi: (Parser State): Document element 9 and the new element 10. Minor wording corrections (remove reference to "trivial cases"). (Low Level Parsing): Minor corrections. * etc/NEWS: Note new element 10, and documentation of element 9 of parser state.
* | Clarify the documentation of nested comments.Alan Mackenzie2016-03-101-7/+8
|/ | | | | | | * doc/lispref/syntax.texi (Syntax Flags): State that only comments of the same style are recognized inside nestable comments. (Low-Level Parsing): Clarify that parsing will stop after the start or end of UNNESTED comments.
* Update documentation for obsoleting 'syntax-begin-function'Eli Zaretskii2016-01-101-11/+0
| | | | | * doc/lispref/syntax.texi (Position Parse): Undocument 'syntax-begin-function' that is now obsolete.
* Update copyright year to 2016Paul Eggert2016-01-011-1/+1
| | | | Run admin/update-copyright.
* Allow line comments ending with escaped NL to be continued to the next line.Alan Mackenzie2015-12-281-0/+8
| | | | | | | | | | | | | | | Use this in C, C++, and Objective C Modes. Fixes bug#22246 * src/syntax.c (comment-end-can-be-escaped): New buffer local variable. (forw-comment, back-comment): On encountering an end of comment character, test whether it is escaped when `comment-end-can-be-escaped' is non-nil. * doc/lispref/syntax.texi (Control Parsing): Describe `comment-end-can-be-escaped'. * etc/NEWS (Lisp Changes): Describe `comment-end-can-be-escaped'. * lisp/progmodes/cc-langs.el: New c-lang-setvar `comment-end-can-be-escaped'.
* Quote less in manualsPaul Eggert2015-09-151-5/+5
| | | | | | | | | | The manuals often used quotes ``...'' when it is better to use @dfn or @code or capitalized words or no quoting at all. For example, there is no need for the `` and '' in “if a variable has one effect for @code{nil} values and another effect for ``non-@code{nil}'' values”. Reword the Emacs, Lisp intro, and Lisp reference manuals to eliminate unnecessary quoting like this, and to use @dfn etc. instead when called for (Bug#21472).
* Improve documentation of categoriesEli Zaretskii2015-09-101-1/+10
| | | | | * doc/lispref/syntax.texi (Categories): Clarify the example of using define-category and modify-category-entry. (Bug#21448)
* Fix indentation of an @example in ELisp manualEli Zaretskii2015-09-091-3/+3
| | | | | * doc/lispref/syntax.texi (Categories): Untabify the example. (Bug#21448)
* Minor quoting etc. fixes to lispref manualPaul Eggert2015-04-101-1/+1
| | | | | | | | | | | | | | | | | | | | | | * doc/lispref/tips.texi (Documentation Tips): Distinguish more clearly among grave accent, apostrophe, and single quote. * doc/lispref/README, doc/lispref/buffers.texi: * doc/lispref/commands.texi, doc/lispref/control.texi: * doc/lispref/customize.texi, doc/lispref/display.texi: * doc/lispref/elisp.texi, doc/lispref/files.texi: * doc/lispref/frames.texi, doc/lispref/hash.texi: * doc/lispref/help.texi, doc/lispref/internals.texi: * doc/lispref/loading.texi, doc/lispref/makefile.w32-in: * doc/lispref/markers.texi, doc/lispref/modes.texi: * doc/lispref/nonascii.texi, doc/lispref/objects.texi: * doc/lispref/os.texi, doc/lispref/positions.texi: * doc/lispref/strings.texi, doc/lispref/syntax.texi: * doc/lispref/text.texi, doc/lispref/tips.texi: * doc/lispref/two-volume-cross-refs.txt, doc/lispref/windows.texi: Use American-style double quoting in ordinary text, and quote 'like this' when single-quoting in ASCII text. Also, fix some minor spacing issues.
* Update copyright year to 2015Paul Eggert2015-01-011-1/+1
| | | | Run admin/update-copyright.
* Improve indexing on the chapter/section/subsection levels.Eli Zaretskii2014-12-231-0/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | doc/lispref/windows.texi (Recombining Windows): Index subject of sections. doc/lispref/variables.texi (Variables with Restricted Values) (Generalized Variables): Index subject of sections. doc/lispref/text.texi (Buffer Contents, Examining Properties) (Changing Properties, Property Search, Substitution): Index subject of sections. doc/lispref/syntax.texi (Motion and Syntax, Parsing Expressions) (Motion via Parsing, Position Parse, Control Parsing): Index subject of sections. doc/lispref/strings.texi (Predicates for Strings, Creating Strings) (Modifying Strings, Text Comparison): Index subject of sections. doc/lispref/searching.texi (Syntax of Regexps, Regexp Special) (Regexp Functions, Regexp Functions): Index subject of sections. doc/lispref/processes.texi (Subprocess Creation, Process Information): Index subject of sections. doc/lispref/positions.texi (Screen Lines): Index subject of sections. doc/lispref/nonascii.texi (Scanning Charsets, Specifying Coding Systems): Index subject of sections. doc/lispref/minibuf.texi (Text from Minibuffer, Object from Minibuffer) (Multiple Queries, Minibuffer Contents): Index subject of sections. doc/lispref/markers.texi (Predicates on Markers, Creating Markers) (Information from Markers, Moving Markers): Index subject of sections. doc/lispref/macros.texi (Defining Macros, Problems with Macros): Index subject of sections. doc/lispref/loading.texi (Loading Non-ASCII, Where Defined): Index subject of sections. doc/lispref/lists.texi (List-related Predicates, List Variables, Setcar) (Setcdr, Plist Access): Index subject of sections. doc/lispref/keymaps.texi (Controlling Active Maps, Scanning Keymaps) (Modifying Menus): Index subject of sections. doc/lispref/help.texi (Accessing Documentation, Help Functions): Index subject of sections. doc/lispref/hash.texi (Hash Access): Index subject of sections. doc/lispref/functions.texi (Core Advising Primitives) (Advising Named Functions, Porting old advices): Index subject of sections. doc/lispref/frames.texi (Creating Frames, Initial Parameters) (Position Parameters, Buffer Parameters, Minibuffers and Frames) (Pop-Up Menus, Drag and Drop): Index subject of sections. doc/lispref/files.texi (Visiting Functions, Kinds of Files) (Unique File Names): Index subject of sections. doc/lispref/display.texi (Refresh Screen, Echo Area Customization) (Warning Variables, Warning Options, Delayed Warnings) (Temporary Displays, Managing Overlays, Overlay Properties) (Finding Overlays, Size of Displayed Text, Defining Faces) (Attribute Functions, Displaying Faces, Face Remapping) (Basic Faces, Font Lookup, Fontsets, Replacing Specs) (Defining Images, Showing Images): Index subject of sections. doc/lispref/debugging.texi (Debugging, Explicit Debug) (Invoking the Debugger, Excess Open, Excess Close): Index subject of sections. doc/lispref/customize.texi (Defining New Types, Applying Customizations) (Custom Themes): Index subject of sections. doc/lispref/control.texi (Sequencing, Combining Conditions) (Processing of Errors, Cleanups): Index subject of sections. doc/lispref/compile.texi (Eval During Compile): Index subject of sections. doc/lispref/commands.texi (Using Interactive, Distinguish Interactive) (Command Loop Info, Classifying Events, Event Mod) (Invoking the Input Method): Index subject of sections. doc/lispref/buffers.texi (Buffer List, Buffer Gap): Index subject of sections. doc/lispref/backups.texi (Making Backups, Numbered Backups, Backup Names) (Reverting): Index subject of sections. doc/lispref/abbrevs.texi (Abbrev Tables, Defining Abbrevs, Abbrev Files) (Abbrev Expansion, Standard Abbrev Tables, Abbrev Properties) (Abbrev Table Properties): Index subject of sections. doc/lispref/os.texi (Time of Day, Time Conversion, Time Parsing) (Time Calculations, Idle Timers): Index subject of sections.
* Update copyright year to 2014 by running admin/update-copyright.Paul Eggert2014-01-011-1/+1
|
* * doc/lispref/syntax.texi (Categories): Add an index for category sets.Xue Fuqiao2013-10-051-0/+1
|
* Add an index for modify-syntax-entry.Xue Fuqiao2013-10-031-0/+1
|
* * doc/lispref/syntax.texi (Syntax Flags): Add an index for comment style.Xue Fuqiao2013-10-031-0/+1
|
generated by cgit v1.2.3 (git 2.39.1) at 2025-04-15 06:55:07 +0000