version: tweak layout, doc

This commit is contained in:
Justin M. Keyes
2017-08-17 21:23:28 +02:00
parent 6ca6a8134d
commit af046a3a81
2 changed files with 21 additions and 23 deletions

View File

@@ -6,9 +6,8 @@
Differences between Nvim and Vim *vim-differences* Differences between Nvim and Vim *vim-differences*
Throughout the help files, differences between Nvim and Vim are indicated via Nvim differs from Vim in many ways, big and small. This document is
the "{Nvim}" tag. This document is a complete and centralized list of all a complete and centralized reference of those differences.
these differences.
Type <M-]> to see the table of contents. Type <M-]> to see the table of contents.
@@ -72,12 +71,18 @@ Clipboard integration |provider-clipboard|
USER EXPERIENCE ~ USER EXPERIENCE ~
Working intuitively and consistently is a major goal of Nvim. Examples: Working intuitively and consistently is a major goal of Nvim.
- Nvim does not have `-X`, a platform-specific option "sometimes" available in *feature-compile*
Vim (with potential surprises: http://stackoverflow.com/q/14635295). Nvim - Nvim always includes ALL features, in contrast to Vim (which ships with
avoids features that cannot be provided on all platforms--instead that is various combinations of 100+ optional features). Think of it as a leaner
delegated to external plugins/extensions. version of Vim's "HUGE" build. This reduces surface area for bugs, and
removes a common source of confusion and friction for users.
- Nvim avoids features that cannot be provided on all platforms; instead that
is delegated to external plugins/extensions. E.g. the `-X` platform-specific
option is "sometimes" available in Vim (with potential surprises:
http://stackoverflow.com/q/14635295).
- Vim's internal test functions (test_autochdir(), test_settime(), etc.) are - Vim's internal test functions (test_autochdir(), test_settime(), etc.) are
not exposed (nor implemented); instead Nvim has a robust API. not exposed (nor implemented); instead Nvim has a robust API.
@@ -268,13 +273,12 @@ Lua interface (|if_lua.txt|):
- Lua has direct access to Nvim |API| via `vim.api`. - Lua has direct access to Nvim |API| via `vim.api`.
- Lua package.path and package.cpath are automatically updated according to - Lua package.path and package.cpath are automatically updated according to
'runtimepath': |lua-require|. 'runtimepath': |lua-require|.
- Currently, most legacy Vim features are missing.
|input()| and |inputdialog()| gained support for each others features (return |input()| and |inputdialog()| support for each others features (return on
on cancel and completion respectively) via dictionary argument (replaces all cancel and completion respectively) via dictionary argument (replaces all
other arguments if used). other arguments if used).
|input()| and |inputdialog()| now support user-defined cmdline highlighting. |input()| and |inputdialog()| support user-defined cmdline highlighting.
============================================================================== ==============================================================================
5. Missing legacy features *nvim-features-missing* 5. Missing legacy features *nvim-features-missing*
@@ -282,7 +286,7 @@ other arguments if used).
Some legacy Vim features are not implemented: Some legacy Vim features are not implemented:
- |if_py|: vim.bindeval() and vim.Function() are not supported - |if_py|: vim.bindeval() and vim.Function() are not supported
- |if_lua|: the `vim` object currently only supports `vim.api` - |if_lua|: the `vim` object is missing most legacy methods
- *if_perl* - *if_perl*
- *if_mzscheme* - *if_mzscheme*
- *if_tcl* - *if_tcl*
@@ -290,7 +294,7 @@ Some legacy Vim features are not implemented:
============================================================================== ==============================================================================
6. Removed features *nvim-features-removed* 6. Removed features *nvim-features-removed*
These features are in Vim, but have been intentionally removed from Nvim. These Vim features were intentionally removed from Nvim.
*'cp'* *'nocompatible'* *'nocp'* *'compatible'* *'cp'* *'nocompatible'* *'nocp'* *'compatible'*
Nvim is always "non-compatible" with Vi. Nvim is always "non-compatible" with Vi.

View File

@@ -1089,13 +1089,7 @@ static void list_features(void)
msg_putchar('\n'); msg_putchar('\n');
} }
} else { } else {
while (msg_col % width) {
int old_msg_col = msg_col;
msg_putchar(' '); msg_putchar(' ');
if (old_msg_col == msg_col) {
break; // XXX: Avoid infinite loop.
}
}
} }
} else { } else {
if (msg_col > 0) { if (msg_col > 0) {
@@ -1103,7 +1097,7 @@ static void list_features(void)
} }
} }
} }
MSG_PUTS("For differences from Vim, see :help vim-differences\n\n"); MSG_PUTS("See \":help feature-compile\"\n\n");
} }
void list_version(void) void list_version(void)
@@ -1144,7 +1138,7 @@ void list_version(void)
} }
#endif // ifdef HAVE_PATHDEF #endif // ifdef HAVE_PATHDEF
version_msg(_("\n\nOptional features included (+) or not (-): ")); version_msg(_("\n\nFeatures: "));
list_features(); list_features();