haskell / haskell/cabal

Document new verbosity modifiers

Open
#4,519 1 comment 0 reactions 0 assignees View on GitHub
attention: pr-welcome documentation type: enhancement
Dominant language
Haskell
Stars
1.7k
Forks
750
Avg merge
4d 3h
Merged PRs (30d)
28

Description

While implementing #4518 I didn't find any mention of the new verbosity symbolic names and modifiers
as understood by `parseVerbosity` in the cabal manual (I would have expected them near e.g. http://cabal.readthedocs.io/en/latest/nix-local-build.html#cfg-flag---verbose)

For reference, these are currently

- `silent`
- `normal`
- `verbose`
- `debug`
- `deafening`

and

- `+callsite`
- `+callstack`
- `+nowrap`
- `+markoutput`
- `+timestamp`

Contributor guide

Open the contributing guide

Research direction

Start with the Cabal manual's nix-local-build section near the --verbose flag documentation, then compare it with the verbosity names understood by parseVerbosity. Document the five symbolic names and five modifiers there; done when the manual explains every listed value and modifier.

Written by the indexing model from the issue text.

Assessment

Domain
cli, documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.