mdbook 0.5's built-in Font Awesome parser sees the leading `fa` class
and defaults to type=regular, which fails to find linux/windows/apple
(they live under the `brands` family) and emits hundreds of WARN lines
per build. Keeping only `fa-brands fa-<icon>` lets the parser resolve
the icon correctly.
See https://rust-lang.github.io/mdBook/format/mdbook.html for the
mdbook Font Awesome syntax.
- Enhanced post-processing to remove .br macros that appear before empty lines
- This fixes 'WARNING: skipping paragraph macro: br before sp' from mandoc
- Also handles the common pattern of .br-empty-.br by removing both .br macros
- Added comprehensive test cases for the new patterns
- All mandoc 'br before sp' warnings are now resolved
- Fix TH header: uppercase command names and remove invalid date format
- Remove trailing whitespace from all manpage lines
- Fix redundant .br paragraph macros that cause mandoc warnings
- Post-process manpage output to ensure compliance with mandoc standards
Move the tldr.zip missing warning from runtime (uudoc.rs) to compile
time (build.rs). This ensures the warning is printed only once during
the build, instead of 100+ times when make calls uudoc separately for
each utility.
Fixes#9940
Adjust the formatting of the options and examples sections in the
uudoc output to use Markdown headers:
- Change `<h2>Options</h2>` to `## Options`
- Change `Examples` to `## Examples`
- Add regression test to prevent reverting to HTML headers