Getting Started - Synopsis

I've read copies of the Synopsis documents that I've found on the web somewh
ere.  How do I synchronize with the life copies, and hack on them?

--John

On 30 Mar 2008 10:32:03 -0000, John M. Dlugosz <dhcgnd702@sneakemail.com> wrote:
> I've read copies of the Synopsis documents that I've found on the web some
where.  How do I synchronize with the life copies, and hack on them?
>

Most of the Synopses are in the "official svn repos",
http://svn.perl.org/perl6/doc/trunk/design/syn/ . This repos is
"hackable" by only a very small group of people ;)

S29 is currently in Pugs's repos IIRC which can be tweaked as long as
you have a Pugs commit bit which is trivial to obtain. The latest S26
(draft) is in Damian's Perl6::Perldoc on CPAN which also has a copy in
the Pugs repos AFAIK.

The latest HTML version of all the Synopses can be found at
http://perlcabal.org/syn/ , which is automatically updated from both
SVN repositories every one hour by a cron job running on feather.

Cheers,
-agentzh

On Sun, Mar 30, 2008 at 07:28:46PM +0800, Agent Zhang wrote:
> The latest HTML version of all the Synopses can be found at
> http://perlcabal.org/syn/ , which is automatically updated from both
> SVN repositories every one hour by a cron job running on feather.

Actually, that cron job hasn't been working for a long time...

-ryan

On Mon, Mar 31, 2008 at 09:54:58AM +0800, Agent Zhang wrote:
> On Sun, Mar 30, 2008 at 9:23 PM, Ryan Richter
> <ryan@tau.solarneutrino.net> wrote: 
>
> I've just checked the cronjob mails and it seems to me that the
> update-syn script is working fine. So the Synopses are still fresh :)

Sorry, it's actually the html stuff from pugs that's not making it onto
feather, e.g. syn_index.html.

> I think you meant the auto-smoke script, which indeed has been failing
> due to a build error while linking pugs (after make veryclean):

Are you building it with GHC 6.6.1?  I think that version doesn't work
anymore.  Maybe someone who's succeeded in building pugs lately can
elaborate...

-ryan

On Mon, Mar 31, 2008 at 8:59 PM, Ryan Richter
<ryan@tau.solarneutrino.net> wrote:
>  Sorry, it's actually the html stuff from pugs that's not making it onto
>  feather, e.g. syn_index.html.
>

Ah...Thanks for the catch :)

The index page was formerly a symbolic link to the syn_index.html in
audreyt's pugs tree which is updated by the good old evalbot and
evalbot has been abandoned for months. I've pointed it to my own pugs
tree on feather now, which should be updated in the same pace of the
update_syn script, i.e., every one hour.

I've noticed the newly-added links to the POD version of the Synopses
on the index page. Very !

>
>  Are you building it with GHC 6.6.1?  I think that version doesn't work
>  anymore.  Maybe someone who's succeeded in building pugs lately can
>  elaborate...
>

It seems that I've been using GHC 6.8.2 on feather:

agentzh@feather:~$ ghc -v
Glasgow Haskell Compiler, Version 6.8.2, for Haskell 98, stage 2
booted by GHC version 6.6.1

I'll look into this later :)

Thanks!
-agentzh