Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add support for @option tag (partially close #51) #64

Merged
merged 7 commits into from
Jul 31, 2023

Conversation

landure
Copy link
Contributor

@landure landure commented Nov 9, 2022

This PR add support for @option tag for short and long options.

  • @option supports short and long options, separated by pipes. Options can have an argument specified between < and >.
  • If @option format is not recognized by the somewhat complex regex, it is processed as a "bad" option, and outputted in a unstyled list. A warning is displayed on stderr.
  • @arg without $[0-9] or $@ is processed as an @option tag, and a warning is displayed on stderr.

It also revamp description and titles processing to limit the use of "\n" in code.

@kovetskiy kovetskiy merged commit 8d28941 into reconquest:master Jul 31, 2023
@kovetskiy
Copy link
Member

Hey, thank you for your contribution and your patience. I have no idea how I missed this great work. Thanks again for your time!

landure added a commit to landure/shdoc that referenced this pull request Aug 17, 2023
…st#64)

* Add missing empty line in overview section output.

* - Add @option for short option (-o) and long options (--option).
- Revamp description and titles processing to normalize "\n" usage and remove empty lines at the start and end of description.
- Add dt and dd rendering styles.

* Add @option to README and example.

* Remove useless description  self-assignation.

* Fix readme width after adding too long @option

* Fix readme width by shorting @see example.

* Fix missing < and > escaping in outputted markdown
landure added a commit to landure/shdoc that referenced this pull request Aug 17, 2023
…st#64)

* Add missing empty line in overview section output.

* - Add @option for short option (-o) and long options (--option).
- Revamp description and titles processing to normalize "\n" usage and remove empty lines at the start and end of description.
- Add dt and dd rendering styles.

* Add @option to README and example.

* Remove useless description  self-assignation.

* Fix readme width after adding too long @option

* Fix readme width by shorting @see example.

* Fix missing < and > escaping in outputted markdown
landure added a commit to landure/shdoc that referenced this pull request Aug 17, 2023
…st#64)

* Add missing empty line in overview section output.

* - Add @option for short option (-o) and long options (--option).
- Revamp description and titles processing to normalize "\n" usage and remove empty lines at the start and end of description.
- Add dt and dd rendering styles.

* Add @option to README and example.

* Remove useless description  self-assignation.

* Fix readme width after adding too long @option

* Fix readme width by shorting @see example.

* Fix missing < and > escaping in outputted markdown
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants