tundra icon indicating copy to clipboard operation
tundra copied to clipboard

Manpage

Open m4tx opened this issue 2 years ago • 2 comments

We could add a manpage, especially since we could potentially use something like https://crates.io/crates/clap_mangen to do that automatically.

m4tx avatar Aug 13 '22 12:08 m4tx

Hi,

I'm showing up here because this was marked as a good first issue. I work on a Linux system on daily basis, so I figured it would actually be a fun little exercise for me to create a man page.

I have a question before I can make the man page a reality though. The README.md states:

### CLI
Tundra has CLI interface as well. First, you need to authenticate:

`tundra authenticate <username> <password>`

Then, you can run Tundra as a daemon:

`tundra daemon`

This way, Tundra will periodically check for players running and scrobble any anime videos to your MAL account, just like the GUI version. 

Does this mean that the CLI only has two commands?

I look forward to hearing from you.

~Bonno

bvdbasch avatar Aug 13 '22 15:08 bvdbasch

Hey, thanks for being interested in that! Yes, at this moment there are only two subcommands available. For this reason, the manpage isn't really necessary, but as you've said, it might be fun to actually have one. This might also be a good time to try to add a bit more description to the CLI commands (or think about some additional ones as well). In the essence, we would like the manpage to have pretty much the same info as tundra --help, along with help pages for all subcommands.

Also, I would recommend trying to generate those manpages automatically (e.g. by using the library I've linked in the issue) - because they are just "nice to have", it would be nice if they wouldn't need any additional maintenance later.

m4tx avatar Aug 13 '22 15:08 m4tx