uutils/coreutils

Markdown is not converted to ROFF for man pages

Open

#5,095 opened on Jul 17, 2023

View on GitHub
 (8 comments) (0 reactions) (0 assignees)Rust (1,852 forks)batch import
I - Documentationgood first issue

Repository metrics

Stars
 (23,246 stars)
PR merge metrics
 (Avg merge 5d 23h) (239 merged PRs in 30d)

Description

see https://manpages.debian.org/unstable/rust-coreutils/rust-test.1.en.html

to reproduce, with https://github.com/uutils/coreutils/pull/5092


make manpages
man target/debug/man/test.1

Contributor guide

Research direction
Investigate how markdown is converted to ROFF during man page generation, specifically in the `make manpages` target, and ensure that the conversion handles markdown syntax properly.
Tech stack
rust
Domain
documentationbuild system
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
RustGit
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
65