Mercurial > vim
view runtime/doc/ft_context.txt @ 34074:1629cc65d78d v9.1.0006
patch 9.1.0006: is*() and to*() function may be unsafe
Commit: https://github.com/vim/vim/commit/184f71cc6868a240dc872ed2852542bbc1d43e28
Author: Keith Thompson <Keith.S.Thompson@gmail.com>
Date: Thu Jan 4 21:19:04 2024 +0100
patch 9.1.0006: is*() and to*() function may be unsafe
Problem: is*() and to*() function may be unsafe
Solution: Add SAFE_* macros and start using those instead
(Keith Thompson)
Use SAFE_() macros for is*() and to*() functions
The standard is*() and to*() functions declared in <ctype.h> have
undefined behavior for negative arguments other than EOF. If plain char
is signed, passing an unchecked value from argv for from user input
to one of these functions has undefined behavior.
Solution: Add SAFE_*() macros that cast the argument to unsigned char.
Most implementations behave sanely for negative arguments, and most
character values in practice are non-negative, but it's still best
to avoid undefined behavior.
The change from #13347 has been omitted, as this has already been
separately fixed in commit ac709e2fc0db6d31abb7da96f743c40956b60c3a
(v9.0.2054)
fixes: #13332
closes: #13347
Signed-off-by: Keith Thompson <Keith.S.Thompson@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Thu, 04 Jan 2024 21:30:04 +0100 |
parents | 4635e43f2c6f |
children |
line wrap: on
line source
*ft_context.txt* For Vim version 9.1. Last change: 2024 Jan 01 This is the documentation for the ConTeXt filetype plugin. NOTE: the plugin requires +vim9script. ============================================================================== CONTENTS *context.vim* *ft-context* 1. Introduction |ft-context-intro| 2. Commands |ft-context-commands| 3. Settings |ft-context-settings| 4. Mappings |ft-context-mappings| ============================================================================== *ft-context-intro* Introduction ~ ConTeXt, similarly to LaTeX, is a macro-based typesetting system built on TeX: > https://wiki.contextgarden.net https://wiki.contextgarden.net/Vim < The ConTeXt plugin provides syntax highlighting, completion and support for typesetting ConTeXt documents. The recommended way to typeset a document is to use |:ConTeXt|. This will invoke the `mtxrun` script that is found in `$PATH`. For more fine grained control over the command and its environment, `context.Typeset()` can be used directly (or `context#Typeset()` from legacy Vim script). For instance, if a version of ConTeXt is installed in `~/context`, you may define a function to use it similar to the following: > import autoload 'context.vim' def MyConTeXt() const env = {'PATH': printf("%s/context/tex/texmf-<os>-<arch>/bin:%s", $HOME, $PATH)} context.Typeset("%", env) enddef This code may go in `~/.vim/after/ftplugin/context.vim`. A mapping can then be defined to invoke the custom command: > nnoremap <silent><buffer><leader>t <scriptcmd>MyConTeXt()<cr> < `context.Typeset()` accepts a third optional argument to specify a custom typesetting command. That must be a function that takes a path and returns the command as a List. For example: > def ConTeXtCustomCommand(path: string): list<string> return ['mtxrun', '--script', 'context', '--nonstopmode', path] enddef context.ConTeXtTypeset("%", v:none, ConTeXtCustomCommand) < Large projects are often organized as a root document and various chapter files. When editing a chapter file, it is convenient to invoke |:ConTeXt| directly on it, rather than having to switch to the root file. A "magic line" can be added at the beginning of each chapter file, which specifies the relative path to the root file. For instance: > % !TEX root = ../MyRoot.tex < Vim searches for the magic line in the first ten lines of the current buffer: if it is found, the document specified by that line is typeset rather than the one in the current buffer. The root document does not have to be opened in Vim. To extend completion and syntax highlighting, you may generate supporting files using ConTeXt and add them to your configuration. If you configuration resides in `~/.vim`, you may use these commands: > mkdir -p ~/.vim/syntax/shared cd ~/.vim/syntax/shared mtxrun --script interface --vim < The last command will create the following syntax files: - `context-data-context.vim`; - `context-data-interfaces.vim`; - `context-data-metafun.vim`; - `context-data-tex.vim`. The same command can be used to update those syntax files. *ft-context-commands* Commands ~ *:ConTeXt* Start a background |job| to typeset the document in the current buffer. The command accepts an optional buffer's name, if you want to typeset a document that is in a different buffer. *:ConTeXtLog* Edit the log file corresponding to the source in the current buffer. *:ConTeXtJobsStatus* Echo the number of jobs currently running in the background. *:ConTeXtStopJobs* Stop all the ConTeXt jobs currently running in the background. *ft-context-settings* Settings ~ *'b:context_ignore_makefile'* *'g:context_ignore_makefile'* |:make| can be used to (synchronously) typeset a document. If a Makefile exists and this option is not set, standard `make` is used. If this option is set, `mtxrun` is invoked instead, even if a Makefile exists. > g:context_ignore_makefile = 0 < NOTE: before using |:make|, set the working directory of the buffer to the directory of the file to be typeset. *'g:context_extra_options'* A list of additional options to pass to `mtxrun`. > g:context_extra_options = [] < *'b:context_include'* *'g:context_include'* Dictionary of filetype/GROUP pairs for which syntax highlighting should be activated between \startGROUP and \stopGROUP. The default is to highlight XML between `\startXML` and `\stopXML`. > g:context_include = {'xml': 'XML'} NOTE: Lua and MetaPost are always highlighted within the respective blocks. *'g:no_context_maps'* When set, do not define any mappings. > g:no_context_maps = 0 < *ft-context-mappings* Mappings ~ tp "reflow TeX paragraph". i$ "inside inline math block". a$ "around inline math block". ]] [count] start of sections forward. [[ [count] start of sections backward. ][ [count] end sections forward. [] [count] end of sections backward. ]} [count] end of blocks (\stop..., \setup..., \define...) forward. [{ [count] begin of blocks (\start..., \setup..., \define...) backward. vim:tw=78:sw=4:ts=8:noet:ft=help:norl: