Which language docs? Larry's and Damian's Apocalypses and Exegeses, or the compiler docs? The former should be on the web (perl.org, maybe) already. As for the latter, I can't think of a good way to make them web-presentable at the moment; at least, nothing better than cvsweb, which isn't all that good. If people let me know what docs they would most like to see on the web, I'll see what I can do.
/s | [reply] [Watch: Dir/Any] |
Well, you mentioned "there should be enough to get you started in languages/perl6/overview.pod" in the post, so I was thinking of that one. That is, let us read it without downloading/installing the whole thing.
If Perl6 stuff is already on perl.org or here in the documentation section, how about a link to it? The implication was that this leading-edge stuff would superceed any of that, since you mentioned mailing lists for discussion but no documents other than overview.pod.
| [reply] [Watch: Dir/Any] [d/l] |
Heh. "Started" in this case means "started hacking on the compiler". overview.pod is a roadmap of the compiler code, not a document about what is and is not implemented, how to use it, etc. In the past, the "user volume" has been small enough that "read the code" or "look at the examples" has been the "documentation" for what is and isn't implemented. There should probably be a list of what does and does not work somewhere. As for the language itself, here are links to the
apocalypses and exegeses, which reflect almost all knowledge of Perl 6 outside Damian's and Larry's heads. If you try to run many of the programs and snippets therein, they will break, hopefully with an informative error message (like "parse error in the following statement"), informing you that those parts of the language are not yet implemented.
/s
| [reply] [Watch: Dir/Any] [d/l] |
The Parrot docs can be found, converted from POD to HTML, on the Parrot website. In particular, overview.pod can be found here. I believe that they are regularly and automatically updated from the Parrot CVS repository.
| [reply] [Watch: Dir/Any] |
If you don't mind pod, I put it on my perlmonk.org account here. | [reply] [Watch: Dir/Any] |
Thanks. I'll give it a look.
I'm very interested in Perl6, but don't have time to dive in right now. I just moved, and my home computer room is not set up yet. And I've been doing projects like fixing physical things instead of software sigh.
I do hope to make a contribution, perhaps in the form of documentation (creation and editing). That will be less critical if I have to fade out for periods.
—John
| [reply] [Watch: Dir/Any] |