[FarGroup/FarManager] master: Add paging to 'set' and 'far::about' outputs (802b49f6c)

[farg...@farmanager.com]

Repository : https://github.com/FarGroup/FarManager
On branch : master
Link : https://github.com/FarGroup/FarManager/commit/802b49f6ccfcc33cc53004ba5046b604c2a65b5f

>---------------------------------------------------------------

commit 802b49f6ccfcc33cc53004ba5046b604c2a65b5f
Author: Alex Alabuzhev <alab...@gmail.com>
Date: Thu Mar 26 20:31:21 2026 +0000

Add paging to 'set' and 'far::about' outputs


>---------------------------------------------------------------

802b49f6ccfcc33cc53004ba5046b604c2a65b5f
far/cmdline.cpp | 153 +++++++++++++++++++++++++++++++++++++++++---------------
1 file changed, 113 insertions(+), 40 deletions(-)

diff --git a/far/cmdline.cpp b/far/cmdline.cpp
index 38241f0b4..49a286cd2 100644
--- a/far/cmdline.cpp
+++ b/far/cmdline.cpp
@@ -70,6 +70,7 @@ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#include "components.hpp"
#include "desktop.hpp"
#include "keybar.hpp"
+#include "keyboard.hpp"
#include "string_utils.hpp"
#include "farversion.hpp"
#include "global.hpp"
@@ -931,78 +932,150 @@ void CommandLine::SetPromptSize(int NewSize)
PromptSize = NewSize? std::clamp(NewSize, 5, 95) : DEFAULT_CMDLINE_WIDTH;
}

-static bool ProcessFarCommands(string_view Command, function_ref<void(bool NoWait)> const Activator)
+static void pager(function_ref<void(function_ref<void(string_view)>)> const Handler)
{
- const auto ConsoleActivator = [&Activator](bool const NoWait = false)
+ try
{
- Activator(NoWait);
- };
+ const auto Height = ScrY + 1;
+ const auto EpilogueSize = Global->Opt->ShowKeyBar? 2 : 1;

- inplace::trim(Command);
+ auto
+ LinesAvailable = Height - 1,
+ LinesUsed = EpilogueSize;

- if (constexpr auto Prefix = L"far:"sv; Command.starts_with(Prefix))
- Command.remove_prefix(Prefix.size());
- else
- return false;
+ const auto Pause = [&]
+ {
+ std::wcout.flush();

- if (equal_icase(Command, L"config"sv))
- {
- ConsoleActivator(true);
- Global->Opt->AdvancedConfig();
- return true;
+ switch (WaitKey())
+ {
+ case KEY_ESC:
+ case KEY_BREAK:
+ case KEY_CTRLC:
+ case KEY_RCTRLC:
+ cancel_operation();
+
+ case KEY_SPACE:
+ case KEY_PGDN:
+ LinesUsed = EpilogueSize;
+ break;
+
+ case KEY_END:
+ LinesAvailable = std::numeric_limits<decltype(LinesAvailable)>::max();
+ break;
+
+ default:
+ --LinesUsed;
+ }
+ };
+
+ const auto PrintLine = [&](string_view const Str)
+ {
+ const auto Length = visual_string_length(Str);
+ const auto Width = ScrX + 1z;
+ const auto LinesNeeded = std::max(1, static_cast<int>((Length + Width - 1) / Width));
+
+ if (LinesUsed + LinesNeeded > LinesAvailable)
+ Pause();
+
+ std::wcout << Str << L'\n';
+ LinesUsed += LinesNeeded;
+ };
+
+ Handler(PrintLine);
+ std::wcout.flush();
}
+ catch (operation_cancelled const&){}
+}

- if (equal_icase(Command, L"about"sv))
+static void about()
+{
+ pager([](function_ref<void(string_view)> const PrintLine)
{
- ConsoleActivator();
-
- std::wcout << L'\n' << build::version_string() << L'\n' << build::copyright() << L'\n';
+ PrintLine({});
+ PrintLine(build::version_string());
+ PrintLine(build::copyright());

if (const auto Revision = build::scm_revision(); !Revision.empty())
{
- std::wcout << L"\nSCM revision:\n"sv << Revision << L'\n';
+ PrintLine({});
+ PrintLine(L"SCM revision:"sv);
+ PrintLine(Revision);
}

- std::wcout << L"\nCompiler:\n"sv << build::compiler() << L'\n';
- std::wcout << L"\nStandard library:\n"sv << build::library() << L'\n';
+ PrintLine({});
+ PrintLine(L"Compiler:"sv);
+ PrintLine(build::compiler());
+
+ PrintLine({});
+ PrintLine(L"Standard library:"sv);
+ PrintLine(build::library());

if (const auto& ComponentsInfo = components::GetComponentsInfo(); !ComponentsInfo.empty())
{
- std::wcout << L"\nThird party libraries:\n"sv;
+ PrintLine({});
+ PrintLine(L"Third party libraries:"sv);

for (const auto& [Name, Version]: ComponentsInfo)
{
- std::wcout << Name;
- if (!Version.empty())
- {
- std::wcout << L", version "sv << Version;
- }
- std::wcout << L'\n';
+ Version.empty()?
+ PrintLine(Name) :
+ PrintLine(far::format(L"{}, version {}"sv, Name, Version));
}
}

if (const auto& Factories = Global->CtrlObject->Plugins->Factories(); std::ranges::any_of(Factories, [](const auto& i) { return i->IsExternal(); }))
{
- std::wcout << L"\nPlugin adapters:\n"sv;
+ PrintLine({});
+ PrintLine(L"Plugin adapters:"sv);
+
for (const auto& i: Factories)
{
- if (i->IsExternal())
- std::wcout << i->Title() << L", version "sv << version_to_string(i->version()) << L'\n';
+ if (!i->IsExternal())
+ continue;
+
+ PrintLine(far::format(L"{}, version {}"sv, i->Title(), version_to_string(i->version())));
}
}

if (Global->CtrlObject->Plugins->size())
{
- std::wcout << L"\nPlugins:\n"sv;
+ PrintLine({});
+ PrintLine(L"Plugins:"sv);

for (const auto& i: *Global->CtrlObject->Plugins)
{
- std::wcout << i->Title() << L", version "sv << version_to_string(i->version()) << L'\n';
+ PrintLine(far::format(L"{}, version {}"sv, i->Title(), version_to_string(i->version())));
}
}
+ });
+}
+
+static bool ProcessFarCommands(string_view Command, function_ref<void(bool NoWait)> const Activator)
+{
+ const auto ConsoleActivator = [&Activator](bool const NoWait = false)
+ {
+ Activator(NoWait);
+ };
+
+ inplace::trim(Command);
+
+ if (constexpr auto Prefix = L"far:"sv; Command.starts_with(Prefix))
+ Command.remove_prefix(Prefix.size());
+ else
+ return false;

- std::wcout << std::flush;
+ if (equal_icase(Command, L"config"sv))
+ {
+ ConsoleActivator(true);
+ Global->Opt->AdvancedConfig();
+ return true;
+ }

+ if (equal_icase(Command, L"about"sv))
+ {
+ ConsoleActivator();
+ about();
return true;
}

@@ -1239,15 +1312,15 @@ bool CommandLine::ProcessOSCommands(string_view const CmdLine, function_ref<void

ConsoleActivator();

- const os::env::provider::strings EnvStrings;
- for (const auto& i: enum_substrings(EnvStrings.data()))
+ pager([&](function_ref<void(string_view)> const PrintLine)
{
- if (starts_with_icase(i, SetParams))
+ os::env::provider::strings const EnvStrings;
+ for (const auto& i: enum_substrings(EnvStrings.data()))
{
- std::wcout << i << L'\n';
+ if (starts_with_icase(i, SetParams))
+ PrintLine(i);
}
- }
- std::wcout << std::flush;
+ });

return true;
}