Add parameter to specify documentation width in the shell

[dmitrivereshchagin]

It may be hard to read the documentation rendered over the whole width of the screen. The kernel configuration parameter is added to override this default behavior.

[github-actions]

CT Test Results

    3 files    154 suites   1h 34m 1s ⏱️
3 560 tests 3 269 ✅ 287 💤 4 ❌
4 064 runs  3 738 ✅ 322 💤 4 ❌

For more details on these failures, see this check.

Results for commit f8a6528.

♻️ This comment has been updated with latest results.

To speed up review, make sure that you have read Contributing to Erlang/OTP and that all checks pass.

See the TESTING and DEVELOPMENT HowTo guides for details about how to run test locally.

Artifacts

• Complete CT logs (Download Logs)
• HTML Documentation (Download HTML Docs)
• Windows Installer

// Erlang/OTP Github Action Bot

[garazdawi]

Hello! Thanks for the PR and I agree that this would be nice to have. However, it needs a testcase in lib/stdlib/test/shell_docs_SUITE.erl and documentation in lib/stdlib/doc/stdlib_app.md before it can be included.

[dmitrivereshchagin]

Test case and documentation are added. Parameter description is added in kernel_app.md instead of stdlib_app.md. The new parameter is added to the kernel application along with existing shell_docs_ansi.

Test case and documentation are also added for shell_docs_ansi.

@garazdawi, please take a look again.

[garazdawi]

Great! I realize now that I was very unclear in my comment. The configuration option should be moved to the stdlib application as that is where most of the shell configuration is located. We cannot move the things that are in kernel for backward compatability reasons, but we want all new options to be in stdlib.

[dmitrivereshchagin]

Got it! Moved the new parameter to stdlib. Please take a look again :)

[garazdawi]

Maybe for Erlang/OTP 28 I'll have to do something about the location of these parameters... the current status is a mess...

Your changes look good. I'll put it into testing and see if anything unexpected pops up.

[garazdawi]

Thanks!