Raku / user-experience

Identifying issues in and improving the Raku user experience
Artistic License 2.0
25 stars 5 forks source link

Perl6 man page #9

Open 4d47 opened 8 years ago

4d47 commented 8 years ago
$ perl6 --version
This is Rakudo version 2016.01.1 built on MoarVM version 2016.01
implementing Perl 6.c.
$ man perl6
No manual entry for perl6

Is it just me who is missing the man pages ?

zoffixznet commented 8 years ago

I don't have any either, but I think that's because none actually exist. :smile_cat:

Skarsnik commented 8 years ago

No Pod::To::Roff probably? :)

2016-02-05 15:14 GMT+01:00 Zoffix Znet notifications@github.com:

I don't have any either, but I think that's because none actually exist. [image: :smile_cat:]

— Reply to this email directly or view it on GitHub https://github.com/perl6/user-experience/issues/9#issuecomment-180374813 .

Sylvain "Skarsnik" Colinet

Victory was near but the power of the ring couldn't be undone

pmichaud commented 8 years ago

On Fri, Feb 05, 2016 at 05:58:48AM -0800, Mathieu Gagnon wrote:

$ perl6 --version This is Rakudo version 2016.01.1 built on MoarVM version 2016.01 implementing Perl 6.c. $ man perl6 No manual entry for perl6

Is it just me who is missing the man pages ?

This sounds good, as long as the command "man perl6" returns something that says "RAKUDO(1)" (e.g., via /etc/alternatives) and not "PERL6(1)". Unless you want to have separate man pages for "man perl6" (the language) and "man rakudo" (the implementation).

Pm

ghost commented 8 years ago

rakudo.git/docs/running.pod is a pretty complete manpage, but the makefile doesn't do anything with it.

grondilu commented 8 years ago

Regarding the difference between the language and its implementation, there is, at least in Debian, a system for dealing with this : /etc/alternatives. I'm not too familiar with it, but it's worth investigating imho.

https://wiki.debian.org/DebianAlternatives

More generally I do agree that Perl 6's documentation needs more man pages;. Perl 5's manual pages are absolutely excellent and I wish Perl 6 had something similar.