Juju doesn't have a manual entry (man juju)

[Pedro Leão da Cruz]

Juju doesn't have a manual entry.

A new version of the list of commands should be automatically published when new version of Juju is released. Current Discourse solution is not satisfactory.

[Pen Gale (pengale)]

`juju --help` will list available commands.

There is work on roadmap to clean that up.

I'm not sure how man interacts with snaps. There doesn't seem to be a link between man pages in /snap and the pages in /usr/share/man.

[John A Meinel (jameinel)]

It would be possible to use our existing help structure to build man pages from the help text, though someone would need to implement that support.

It is certainly plausible to do, and I thought at one point we had done that in the past. Maybe we stopped because 'snap install juju' was no longer populating man pages for 'man juju' to work?

Looking here:
https://bugs.launchpad.net/snapd/+bug/1575593

It seems that it may or may not be working. The bug is still not 'Fixed' but the last comment on the page seems to think that content in /snap/man should end up in man pages (sometime in bionic).

It is mostly a question of effort.

Note that none of the snaps that I have installed (that I can find) have man pages that work.

man snap works, but that is /usr/bin/snap

man snapd, man charm, man charmcraft, man go, man juju, man lxd, man microk8s, man ripgrep, man snapcraft, man snapd

None of them have man pages, which leads me to believe that bug #1575593 is fixed.

[Heitor (heitorpbittencourt)]

Any news on this? Is Juju getting man pages soon? :)

[Canonical Juju QA Bot (juju-qa-bot)]

This Medium-priority bug has not been updated in 60 days, so we're marking it Low importance. If you believe this is incorrect, please update the importance.