Man-pages in snaps

[Jamie Strandboge]

On Wed, 2016-06-08 at 06:21 -0300, Gustavo Niemeyer wrote:
> Yeah, that's indeed not great.
> 
> We need to teach snapd to prepare a directory for mans and play with
> /etc/manpath.config.
> 

Once man is in the os snap, this would be comfortable for users indeed.

I do think it worth noting that this would allow untrusted input (the man page)
to be fed into an unconfined process ('/usr/bin/man' from the user's shell), but
I think this design idea is fine if the review tools verify the man page (just
like we do with desktop files). If there is a bug for this, please add a review
tools task and I'll add a check.

> On Wed, Jun 8, 2016 at 5:59 AM, Oliver Grawert <ogra at ubuntu.com> wrote:
> 
> > 
> > hi,
> > Am Mittwoch, den 08.06.2016, 09:12 +0200 schrieb Didier Roche:
> > > 
> > > Le 07/06/2016 14:49, Sujeevan (svij) Vijayakumaran a écrit :
> > > > 
> > > > Hello,
> > > > 
> > > > I started creating a snap for the CLI task manager taskwarrior
> > > > (https://taskwarrior.org/). This project has really good man pages.
> > > > Anyway there is currently no support to access man-pages from snaps:
> > > > https://bugs.launchpad.net/snappy/+bug/1575593
> > > > 
> > > > Since it doesn't make much sense to publish an CLI app without the good
> > > > man pages: Is there any other ways to make it possible that the user
> > can
> > > 
> > > > 
> > > > access the man pages of a snap? The tools "task help" command doesnt
> > > > help here since is doesn’t show everything.
> > > Hey Sujeevan,
> > > 
> > > The desktop team indeed opened this bug, and I'm sure the snappy team
> > > will respond to it quickly.
> > > For now, you can't really workaround that (well, telling people to man
> > > /snaps/snap_name/current/… isn't an option ;))
> > > 
> > > However, thinking about this, you may be able to add a "man" command in
> > > between (so that autocompletion show it) in your snapcraft.yaml, which
> > > is executing "man /snaps/snap_name/current/…" as a workaround.
> > > That way you will have (if your snap_name matches your command name):
> > > 
> > > $ taskwarrior
> > > $ taskwarrior.man
> > > 
> > > Does this fit the bill until we get proper manpage support in snapd?
> > there is no man command installed in in the core snap.
> > you'd rather ship the man binary (and it's deps) inside your snap as
> > well and make your taskwarrior.man command use it.
> > 
> > ciao
> >         oli
> > 
> > --
> > Snapcraft mailing list
> > Snapcraft at lists.ubuntu.com
> > Modify settings or unsubscribe at:
> > https://lists.ubuntu.com/mailman/listinfo/snapcraft
> > 
> > 
> 
> -- 
> Snapcraft mailing list
> Snapcraft at lists.ubuntu.com
> Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/s
> napcraft
-- 
Jamie Strandboge             | http://www.canonical.com

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/snapcraft/attachments/20160608/e6f70b8d/attachment.sig>