Created attachment 221815 [details]
Draft of man page for rclone (unfinished, for advice)
I've began to write a man page for rclone. As it is my first man page, I would like to submit a rather incomplete version for a guideline check.
Also, rclone has a large documentation, so I was thinking of splitting it this way :
- a very large main file with all the options and the commands
- a second file containing the configuration for all the remotes.
Another option would be to have one man page for each command, like git, but I'm not sure it's justified.
The draft linked here contains
- a short description
- a short summary for each command
- some options
Thanks in advance,
Is this for the port net/rclone? If so, we will need to edit the Product/Component.
(In reply to Mark Linimon from comment #1)
Okay, I've put it in ports/individual ports and changed the summary.
Sorry, I thought a new man page should be assigned to the documentation...
Created attachment 222133 [details]
Main man page for rclone
There is actually a lot of documentation for rclone.
So I've decided to have a large main man page with all the options, commands briefly described, as well as examples.
Most of the documentation comes from rclone, but I've rewritten some parts here and there to be more concise.
I've put the main man page for review. If that's okay, i'll continue to follow the initial documentation structure so there will be 5 more man pages:
- one for each flag
- one for each command
- one for filters
- one for each backend
- one for remote controls
rclone does have man pages, but they're not included in the package. I'll take a look at changing that.