-
-
Notifications
You must be signed in to change notification settings - Fork 233
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 man page #151
Add man page #151
Conversation
562d0d1
to
6d62021
Compare
Awesome. Thank you very much for working on this. I would prefer the pandoc Markdown => man page way because I am familiar with this from other projects. And I don't know AsciiDoc. |
20131fd
to
292455f
Compare
@sharkdp OK. Added the conversion process from Pandoc's Markdown in the CI. Also, I wrote the conversion method in the README. |
doc/hexyl.1.md
Outdated
Sets the block size to 1024 bytes: | ||
: $ **hexyl \--block-size=1024** | ||
|
||
Sets the block size to 4 kilobytes: | ||
: $ **hexyl \--block-size=4kB** |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Setting block size alone is not really that interesting. It's only relevant if you use it in one of the other command-line options. As in:
hexyl --block-size=1024 --length=5block …
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fixed.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you! I added one minor comment.
doc/hexyl.1.md
Outdated
: $ **hexyl \--block-size=1024 \--length=5block** | ||
|
||
Sets the block size to 4 kilobytes: | ||
: $ **hexyl \--block-size=4kB \--length=20blocks** |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sorry. One more thing. blocks doesn't work, unfortunately. We should either make that work (I'd think it would be relatively easy) or change the man page here once more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you!
This is written in
AsciiDoc orPandoc’s Markdown.These can be converted by:
asciidoctor -b manpage doc/hexyl.1.adoc
pandoc -s -f markdown -t man -o doc/hexyl.1 doc/hexyl.1.md
I will fix to add a conversion process to the CI, add a troff file as well, keep only it, or other. Which one is better?