Mercurial > vim

comparison runtime/doc/change.txt @ 23737:34b4eb3a8458

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update runtime files. Commit: https://github.com/vim/vim/commit/e0e3917554327f2524066f89fbbef9c83c1535da Author: Bram Moolenaar <Bram@vim.org> Date: Mon Jan 25 21:14:57 2021 +0100 Update runtime files.
author Bram Moolenaar <Bram@vim.org>
date Mon, 25 Jan 2021 21:30:05 +0100
parents e7c125224b1a
children 788e10cec9bd
comparison
equal deleted inserted replaced
23736:e5035ccad5a8 23737:34b4eb3a8458
1 *change.txt* For Vim version 8.2. Last change: 2020 Nov 21 1 *change.txt* For Vim version 8.2. Last change: 2021 Jan 21
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
1629 'formatoptions' is a string that can contain any of the letters below. The 1629 'formatoptions' is a string that can contain any of the letters below. The
1630 default setting is "tcq". You can separate the option letters with commas for 1630 default setting is "tcq". You can separate the option letters with commas for
1631 readability. 1631 readability.
1632 1632
1633 letter meaning when present in 'formatoptions' ~ 1633 letter meaning when present in 'formatoptions' ~
1634 1634 *fo-t*
1635 t Auto-wrap text using textwidth 1635 t Auto-wrap text using textwidth
1636 *fo-c*
1636 c Auto-wrap comments using textwidth, inserting the current comment 1637 c Auto-wrap comments using textwidth, inserting the current comment
1637 leader automatically. 1638 leader automatically.
1639 *fo-r*
1638 r Automatically insert the current comment leader after hitting 1640 r Automatically insert the current comment leader after hitting
1639 <Enter> in Insert mode. 1641 <Enter> in Insert mode.
1642 *fo-o*
1640 o Automatically insert the current comment leader after hitting 'o' or 1643 o Automatically insert the current comment leader after hitting 'o' or
1641 'O' in Normal mode. 1644 'O' in Normal mode.
1645 *fo-q*
1642 q Allow formatting of comments with "gq". 1646 q Allow formatting of comments with "gq".
1643 Note that formatting will not change blank lines or lines containing 1647 Note that formatting will not change blank lines or lines containing
1644 only the comment leader. A new paragraph starts after such a line, 1648 only the comment leader. A new paragraph starts after such a line,
1645 or when the comment leader changes. 1649 or when the comment leader changes.
1650 *fo-w*
1646 w Trailing white space indicates a paragraph continues in the next line. 1651 w Trailing white space indicates a paragraph continues in the next line.
1647 A line that ends in a non-white character ends a paragraph. 1652 A line that ends in a non-white character ends a paragraph.
1653 *fo-a*
1648 a Automatic formatting of paragraphs. Every time text is inserted or 1654 a Automatic formatting of paragraphs. Every time text is inserted or
1649 deleted the paragraph will be reformatted. See |auto-format|. 1655 deleted the paragraph will be reformatted. See |auto-format|.
1650 When the 'c' flag is present this only happens for recognized 1656 When the 'c' flag is present this only happens for recognized
1651 comments. 1657 comments.
1658 *fo-n*
1652 n When formatting text, recognize numbered lists. This actually uses 1659 n When formatting text, recognize numbered lists. This actually uses
1653 the 'formatlistpat' option, thus any kind of list can be used. The 1660 the 'formatlistpat' option, thus any kind of list can be used. The
1654 indent of the text after the number is used for the next line. The 1661 indent of the text after the number is used for the next line. The
1655 default is to find a number, optionally followed by '.', ':', ')', 1662 default is to find a number, optionally followed by '.', ':', ')',
1656 ']' or '}'. Note that 'autoindent' must be set too. Doesn't work 1663 ']' or '}'. Note that 'autoindent' must be set too. Doesn't work
1657 well together with "2". 1664 well together with "2".
1658 Example: > 1665 Example: >
1659 1. the first item 1666 1. the first item
1660 wraps 1667 wraps
1661 2. the second item 1668 2. the second item
1669 < *fo-2*
1662 2 When formatting text, use the indent of the second line of a paragraph 1670 2 When formatting text, use the indent of the second line of a paragraph
1663 for the rest of the paragraph, instead of the indent of the first 1671 for the rest of the paragraph, instead of the indent of the first
1664 line. This supports paragraphs in which the first line has a 1672 line. This supports paragraphs in which the first line has a
1665 different indent than the rest. Note that 'autoindent' must be set 1673 different indent than the rest. Note that 'autoindent' must be set
1666 too. Example: > 1674 too. Example: >
1667 first line of a paragraph 1675 first line of a paragraph
1668 second line of the same paragraph 1676 second line of the same paragraph
1669 third line. 1677 third line.
1670 < This also works inside comments, ignoring the comment leader. 1678 < This also works inside comments, ignoring the comment leader.
1679 *fo-v*
1671 v Vi-compatible auto-wrapping in insert mode: Only break a line at a 1680 v Vi-compatible auto-wrapping in insert mode: Only break a line at a
1672 blank that you have entered during the current insert command. (Note: 1681 blank that you have entered during the current insert command. (Note:
1673 this is not 100% Vi compatible. Vi has some "unexpected features" or 1682 this is not 100% Vi compatible. Vi has some "unexpected features" or
1674 bugs in this area. It uses the screen column instead of the line 1683 bugs in this area. It uses the screen column instead of the line
1675 column.) 1684 column.)
1685 *fo-b*
1676 b Like 'v', but only auto-wrap if you enter a blank at or before 1686 b Like 'v', but only auto-wrap if you enter a blank at or before
1677 the wrap margin. If the line was longer than 'textwidth' when you 1687 the wrap margin. If the line was longer than 'textwidth' when you
1678 started the insert, or you do not enter a blank in the insert before 1688 started the insert, or you do not enter a blank in the insert before
1679 reaching 'textwidth', Vim does not perform auto-wrapping. 1689 reaching 'textwidth', Vim does not perform auto-wrapping.
1690 *fo-l*
1680 l Long lines are not broken in insert mode: When a line was longer than 1691 l Long lines are not broken in insert mode: When a line was longer than
1681 'textwidth' when the insert command started, Vim does not 1692 'textwidth' when the insert command started, Vim does not
1682 automatically format it. 1693 automatically format it.
1694 *fo-m*
1683 m Also break at a multibyte character above 255. This is useful for 1695 m Also break at a multibyte character above 255. This is useful for
1684 Asian text where every character is a word on its own. 1696 Asian text where every character is a word on its own.
1697 *fo-M*
1685 M When joining lines, don't insert a space before or after a multibyte 1698 M When joining lines, don't insert a space before or after a multibyte
1686 character. Overrules the 'B' flag. 1699 character. Overrules the 'B' flag.
1700 *fo-B*
1687 B When joining lines, don't insert a space between two multibyte 1701 B When joining lines, don't insert a space between two multibyte
1688 characters. Overruled by the 'M' flag. 1702 characters. Overruled by the 'M' flag.
1703 *fo-1*
1689 1 Don't break a line after a one-letter word. It's broken before it 1704 1 Don't break a line after a one-letter word. It's broken before it
1690 instead (if possible). 1705 instead (if possible).
1706 *fo-]*
1691 ] Respect textwidth rigorously. With this flag set, no line can be 1707 ] Respect textwidth rigorously. With this flag set, no line can be
1692 longer than textwidth, unless line-break-prohibition rules make this 1708 longer than textwidth, unless line-break-prohibition rules make this
1693 impossible. Mainly for CJK scripts and works only if 'encoding' is 1709 impossible. Mainly for CJK scripts and works only if 'encoding' is
1694 "utf-8". 1710 "utf-8".
1711 *fo-j*
1695 j Where it makes sense, remove a comment leader when joining lines. For 1712 j Where it makes sense, remove a comment leader when joining lines. For
1696 example, joining: 1713 example, joining:
1697 int i; // the index ~ 1714 int i; // the index ~
1698 // in the list ~ 1715 // in the list ~
1699 Becomes: 1716 Becomes:
1700 int i; // the index in the list ~ 1717 int i; // the index in the list ~
1718 *fo-p*
1701 p Don't break lines at single spaces that follow periods. This is 1719 p Don't break lines at single spaces that follow periods. This is
1702 intended to complement 'joinspaces' and |cpo-J|, for prose with 1720 intended to complement 'joinspaces' and |cpo-J|, for prose with
1703 sentences separated by two spaces. For example, with 'textwidth' set 1721 sentences separated by two spaces. For example, with 'textwidth' set
1704 to 28: > 1722 to 28: >
1705 Surely you're joking, Mr. Feynman! 1723 Surely you're joking, Mr. Feynman!