Mercurial > vim
view runtime/doc/ft_mp.txt @ 35769:4f48d5d327ea v9.1.0609
patch 9.1.0609: outdated comments in Makefile
Commit: https://github.com/vim/vim/commit/4c3616d7a2c8c3b828e4d4ebbcd43e4a22154262
Author: Shane Harper <shane@shaneharper.net>
Date: Mon Jul 22 20:09:26 2024 +0200
patch 9.1.0609: outdated comments in Makefile
Problem: outdated comments in Makefile
Solution: update outdated comments, update rule for vimtags
(Shane Harper)
related: commit b81109192f
Here are the changes and the reasons for them:
- Delete the comment preceding the assignment to VIMPROG. Since b81109192f
there's no need for VIMPROG to be set to something else when this is executed
from src/Makefile. (The comment was wrong anyway; VIMPROG was being set to
"$$BUILD_DIR/$(VIMTARGET)".)
```
# Set to $(VIMTARGET) when executed from src/Makefile.
VIMPROG = ../../src/vim
```
- Delete "`and installed`" in the following comment; The vimtags rule doesn't
require that Vim has been installed.
```
# Use Vim to generate the tags file. Can only be used when Vim has been
# compiled and installed. Supports multiple languages.
vimtags: $(DOCS)
```
- With commit b81109192f there is no longer a need to set VIMPROG here:
```
-@BUILD_DIR="`pwd`"; cd $(HELPSOURCE); if test -z "$(CROSS_COMPILING)"; then \
$(MAKE) VIMPROG="$$BUILD_DIR/$(VIMTARGET)" vimtags; fi
```
The new code below will use the same vim executable as the old code:
```
-@cd $(HELPSOURCE); if test -z "$(CROSS_COMPILING)"; then \
$(MAKE) vimtags; fi
```
- Delete the following comment which was related to setting VIMPROG as it no longer has any value:
```
# We can assume Vim was build, but it may not have been installed,
# thus use the executable in the current directory.
```
Note: this comment used to be (unnecessarily) echoed to the terminal (because
it was indented) when making installrtbase.
closes: #15320
Signed-off-by: Shane Harper <shane@shaneharper.net>
Signed-off-by: Christian Brabandt <cb@256bit.org>
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Mon, 22 Jul 2024 20:30:07 +0200 |
parents | 4635e43f2c6f |
children |
line wrap: on
line source
*ft_mp.txt* For Vim version 9.1. Last change: 2022 Aug 12 This is the documentation for the METAFONT and MetaPost filetype plugins. Unless otherwise specified, the commands, settings and mappings defined below apply equally to both filetypes. NOTE: the plugin requires +vim9script. ============================================================================== CONTENTS *mp.vim* *ft-metapost* *mf.vim* *ft-metafont* 1. Introduction |ft-metapost-intro| 2. Commands |ft-metapost-commands| 3. Settings |ft-metapost-settings| 4. Mappings |ft-metapost-mappings| ============================================================================== *ft-metapost-intro* *ft-metafont-intro* Introduction ~ This filetype plugin provides extensive support for editing METAFONT and MetaPost documents, including syntax coloring, indentation, and completion. Defining indentation rules for METAFONT and MetaPost code is tricky and somewhat subjective, because the syntax is quite liberal. The plugin uses some heuristics that work well most of the time, but in particular cases you may want to to override the automatic rules, so that the manually defined indentation is preserved by commands like `gg=G`. This can be achieved by appending `%>`, `%<`, `%=` or `%!` to a line to explicitly control the indentation of the next line. The `<` and `>` symbols may be repeated many times: for instance, `%>>` will cause the next line to be indented twice. Of course, `%<` means that the next line should be de-indented; `%=` sets the indentation of the next line to be equal to the indentation of the current line; and `%!` means that the indentation of the next line should not change from whatever it has been manually set. For example, this is the default indentation of a simple macro: > def foo = makepen( subpath(T-n,t) of r shifted .5down --subpath(t,T) of r shifted .5up -- cycle ) withcolor black enddef < By adding the special comments, the indentation can be adjusted arbitrarily: > def foo = makepen( subpath(T-n,t) of r %> shifted .5down %> --subpath(t,T) of r shifted .5up -- cycle %<<< ) withcolor black enddef < *ft-metapost-commands* Commands ~ *:FixBeginfigs* Renumber beginfig() blocks in the current buffer so that the n-th figure has number n. MetaPost only. *ft-metapost-settings* *ft-metafont-settings* Settings ~ *'g:mf_other_macros'* Highlight some other basic macro names, e.g., from cmbase, logo, etc. This is set to 1 by default in METAFONT buffers, and it is set to 0 by default in MetaPost buffers. *'g:mf_plain_macros'* Highlight keywords defined by plain.mf. This is set to 1 by default in METAFONT buffers, and it is set to 0 by default in MetaPost buffers. *'g:mf_plain_modes'* Highlight keywords defined by modes.mf. This is set to 1 by default in METAFONT buffers, and it is set to 0 by default in MetaPost buffers. *'g:mp_close_tag'* Define additional keywords that end indented blocks. For instance, if you define: > g:mp_close_tag = ['\<endfoo\>'] < any line starting with `endfoo` will be de-indented compared to its previous line. > g:mp_close_tag = [] < *'b:mp_metafun'* *'g:mp_metafun'* If set to 1, highlight ConTeXt's MetaFun keywords. MetaPost only. > g:mp_metafun = 0 < *'g:mp_mfplain_macros'* Highlight keywords defined by mfplain.mp. MetaPost only. > g:mp_mfplain_macros = 1 < *'g:mp_open_tag'* Define additional keywords that start indented blocks. For instance, if you define: > g:mp_open_tag = ['\<beginfoo\>'] < the line following `beginfoo` will be indented. > g:mp_open_tag = [] < *'g:mp_other_macros'* Highlight keywords defined by all base macro packages (boxes, rboxes, format, graph, marith, sarith, string, TEX). This option affects only MetaPost buffers. > g:mp_other_macros = 1 < *'g:mp_plain_macros'* Highlight keywords defined by plain.mp. MetaPost only. > g:mp_plain_macros = 1 < *'g:no_mp_maps'* *'g:no_mf_maps'* When set, do not define any mapping in buffers with the corresponding filetype. > g:no_mp_maps = 0 g:no_mf_maps = 0 < *ft-metapost-mappings* *ft-metafont-mappings* Mappings ~ ]] [count] vardefs, macros or figures forward. [[ [count] vardefs, macros or figures backward. ][ [count] end of vardefs, macros or figures forward. [] [count] end of vardefs, macros or figures backward. ]} [count] end of blocks (fi, endfor, endgroup) forward. [{ [count] begin of blocks (if, for, begingroup) backward. vim:tw=78:sw=4:ts=8:noet:ft=help:norl: