Home¶
Generate formatted console help reference texts. Primarily used by Fish programs.
Features¶
- Modern view: The layout doesn't follow any of the legacy traditions
- Colored text: Each pixel is taken special care of
- Minuscule details: You will notice that the color of
:and the underlines is slightly lighter than the main text. The pointers are dimmed to avoid unnecesary attention. - Section division: Each section is a DRY division by categories
- Adaptive spacing and column lengths: Each of the columns are dynamically spaced and underlined depending on the lengths of the text input
- Multiple sorts of positional arguments supported: Programs that take fixed or variable number of arguments — or even a mix of both — are all supported
- Automatically formatted description substrings: The Positional Arguments mentioned are in descriptions are automatically italicized, while punchuation is slightly dimmed
- Clean syntax: It uses a very easy and readable syntax, and avoids it by using native data structures where possible
- Native Fish data structures: Use of syntax and manual parsing is minimized with the use of Fish native data-structures
Discoverability¶
Make your program visible by allowing users to discover it with the topic: fish-helpText.
It might be used as a demonstration in the Readme if at least one of the 2 conditions are met: - It showcases a feature / usage that is not already demonstrated - It showcases a feature better / stands-out more than an existing demonstration