Or have essentially the papis --help message but in manpage form with additional linkages to other pages?

There'a already a Command-line Interface section that's essentially just papis --help slightly reformatted. Is that not enough? Or?

I think adding a SEE ALSO section at the bottom just like that would be great, with also the papis(5) (config page) mentioned there.

I'm definitely in favor of that! Using .. only:: man should make it rather painless.

If there are many pages that could go into section 7, should they be combined into one?

It's also easier to just have separate files for each one 😁 I would prefer that + a nice SEE ALSO section (this would also nicely match the online docs, which are separate).

EDIT: Was looking at man git and that SYNOPSIS section looks pretty nifty. No idea how to get it though..

Oops sorry for wiping the message, I was about to move the todos around. I edited all of them back 😄

It's like papis-default does have all the correct info in it, but in a bit of an awkward order for the manpage and this:

Looks so much worse than this:

Agree on the SYNOPSIS, could start with just substituting this for it:

papis [OPTIONS] COMMAND [ARGS]...

if getting it just like that is too hard to achieve

Looks so much worse than this:

Yeah, it kind of does :( I've never played with Sphinx manpage generation though, so I'm not sure how much of that can be styled differently. If you make any progress, that would be amazing! 😁

EDIT: The styling might also come from sphinx-click.

Yeah it will take some experimentation

I was also thinking should we link to the subcommands' pages similar to this:

Which would only make sense for a manpage, so a large section would have to be written separately for docs/manpage 🤔

Always happy to see work on the docs ❤️! More than happy to help with this!

Which would only make sense for a manpage, so a large section would have to be written separately for docs/manpage 🤔

What do you mean by this? That we'd have to write a page detailing how to find all the subcommand specific pages? That doesn't seem so bad to me...

What do you mean by this? That we'd have to write a page detailing how to find all the subcommand specific pages? That doesn't seem so bad to me...

Yeah, agreed, that doesn't seem too bad.. it would just be a one time thing. Maybe we can even automate it somehow using a special directive + some magic in papis/sphinx_ext.py.

Yep I was just saying if we want the list of commands to double as refs to their manpages:

• papis-add(1)

Only makes sense in the manpage version

But that was just inspiration from the git manpage, those refs can be on a separate list also

But yeah it's just that one word/representation that has to vary that's true

But this is thinking a bit too far ahead 😄

That we'd have to write a page detailing how to find all the subcommand specific pages?

With this approach, they could just be generated into the SEE ALSO part or have like one SEE ALSO for all subcommands pages, and another for the misc pages

Or a general note saying "The subcommands man pages are in papis-<command>(1)"