Files
neovim/runtime/doc
Sébastien Hoffmann ca07e505f9 refactor(ruler)!: replace C implementation with 'rulerformat' expression
Problem:
The default 'ruler' is implemented in C instead of the 'statusline' DSL.

Solution:
Replace the C implementation with a default 'rulerformat' expression.
This is a continuation of #1248 and #33036.

Advantages:
- configuration is more discoverable, the default being a useful example
- users and plugins can augment the default
- code reuse and less C code to maintain
- ui2: due to the use of an item group with `minwid`, it can expand
  instead of truncating when the content gets too long, which is
  particularly useful for locales with long translations of Top/Bot/All

Implementation details:
As is the case for 'statusline', when trying to set 'rulerformat' to an
empty string, the default expression is restored instead, mimicking how
previously the default C implementation would have been activated.
Just like before, `:set rulerformat=` and `:set rulerformat&` have the
same effect, and the ruler is disabled with `:set noruler`.

The default expression uses an item group with `%=`, unlike the fallback
in the previous default statusline `%-14.(%l,%c%V%) %P`, because the
total width and how it is configured is immediately clear without
documentation, it is a more useful pattern in general that works when
both sides have flexible width, and it also works for vim, which is
useful for configuration sharing/reuse.

A truncation marker `%<` is added at the end to mimic how at small
screen widths, the scroll percentage would disappear first, so that the
cursor position can remain fully visible.

BREAKING CHANGES:
- `&rulerformat` can no longer be set to an empty string
- ui2: the default ruler is no longer of fixed width, but can expand
- at very small screen widths (< 36 columns)
  - ui2: it will no longer try to shrink white-space before truncating
  - it truncates gradually from the right, whereas previously, the
    scroll percentage would disappear all at once
- l10n can no longer add a space after the comma between line and column
  (this was only done for one language: Ukrainian)
2026-08-04 12:12:23 +02:00
..
2026-08-02 08:19:29 -04:00
2026-07-30 15:09:19 -04:00
2026-06-29 23:22:52 +02:00
2026-02-12 13:46:45 +01:00
2024-05-15 23:19:26 +02:00
2026-06-29 13:10:31 -04:00
2026-08-01 17:48:32 -04:00
2026-07-25 12:47:51 -04:00
2026-08-01 17:48:32 -04:00
2025-12-06 20:33:02 -05:00
2023-06-25 17:14:28 +02:00
2026-04-18 15:38:59 -04:00
2026-01-27 17:14:57 -05:00
2026-07-27 11:12:47 -04:00
2026-07-27 11:12:47 -04:00
2026-08-01 17:48:32 -04:00
2026-08-01 17:48:32 -04:00
2025-12-15 13:55:15 -05:00
2026-03-16 10:29:58 +01:00
2025-09-28 20:57:59 -07:00
2026-05-07 10:36:55 +02:00
2026-05-14 13:13:30 -04:00
2025-12-15 13:55:15 -05:00
2026-04-22 18:25:07 -04:00
2026-05-17 10:02:12 -04:00
2026-03-24 00:14:55 +01:00
2026-05-07 10:36:48 +02:00
2026-07-25 12:47:51 -04:00
2026-05-07 10:36:48 +02:00
2026-06-29 13:10:31 -04:00
2026-07-30 15:09:19 -04:00