Re: Dumb doc question...

2006-08-22 Thread Agent Zhang

On 8/21/06, Agent Zhang [EMAIL PROTECTED] wrote:


http://svn.berlios.de/svnroot/repos/unisimu/Perl/Syn/



This position is no longer maintained. Please see

 http://feather.perl6.nl/~agentzh/syn/

instead. The .html pages there are updated every *one* hour by the
cron program on feather. So they're guaranteed to be up-to-date.

Cheers,
Agent


Re: Dumb doc question...

2006-08-21 Thread Agent Zhang

On 8/17/06, Thom Boyer [EMAIL PROTECTED] wrote:

On 8/16/06, Agent Zhang [EMAIL PROTECTED] wrote:
 On 8/17/06, Mark J. Reed [EMAIL PROTECTED] wrote:
  Where can I find a pod2html that groks the p6 version of POD?   I want
  to format my fresh-from-svn copies of the doc...
 
 And there're also an online HTML version of the Perl 6 Spec:

 http://dev.perl.org/perl6/doc/synopsis.html

 This version automatically updates from the SVN repository every few
hours.



With my recent work on util/smartlinks.pl in Pugs' repos, you can
always browse the HTML version of Synopses with embedded code snippets
from the Pugs test suite from the following location:

   http://svn.berlios.de/svnroot/repos/unisimu/Perl/Syn/

The HTML pages are not updated automatically like dev.perl.org, but
should be updated by hand every day or two.

Of course, if you have a pugs source tree, then you can generate the
latest HTML version of Synopses yourselves at any time:

   $ util/smartlinks.pl --out-dir=tmp t/*/*.t t/*/*/*.t



Unfortunately, S29 is not available there -- it only provides a  pointer to
http://svn.openfoundry.org/pugs/docs/Perl6/Spec/Functions.pod
and the pod file just isn't as pretty as the nicely formatted HTML available
for all the other synopses.


Hey, the S29 living in the Pugs repos is also used by smartlinks.pl by
default! Yay!

Cheers,
Agent


Re: Dumb doc question...

2006-08-17 Thread Thom Boyer

On 8/16/06, Agent Zhang [EMAIL PROTECTED] wrote:


On 8/17/06, Mark J. Reed [EMAIL PROTECTED] wrote:
 Where can I find a pod2html that groks the p6 version of POD?   I want
 to format my fresh-from-svn copies of the doc...




...

And there're also an online HTML version of the Perl 6 Spec:


http://dev.perl.org/perl6/doc/synopsis.html

This version automatically updates from the SVN repository every few
hours.



Unfortunately, S29 is not available there -- it only provides a  pointer to

http://svn.openfoundry.org/pugs/docs/Perl6/Spec/Functions.pod

and the pod file just isn't as pretty as the nicely formatted HTML available
for all the other synopses.
=thom
Adults are always asking kids what they want to be when they grow up
because they are looking for ideas. --Paula Poundstone


Dumb doc question...

2006-08-16 Thread Mark J. Reed

...which I would have thought was a faq; maybe I just haven't found
the right faq list...

Where can I find a pod2html that groks the p6 version of POD?   I want
to format my fresh-from-svn copies of the doc...

--
Mark J. Reed [EMAIL PROTECTED]


Re: Dumb doc question...

2006-08-16 Thread Agent Zhang

On 8/17/06, Mark J. Reed [EMAIL PROTECTED] wrote:

Where can I find a pod2html that groks the p6 version of POD?   I want
to format my fresh-from-svn copies of the doc...



If you mean the POD files of perl 6 synopses, then pod2html only lacks
the support for the =encoding directive.

On my (Win32) machine, there's a build.bat to generate HTML from all
the synopses. It looks like this:

   call podhtm -s Active.css *.pod
   grep -P text/html; charset=gb2312 *.html | subs gb2312 UTF-8
   del *.tmp

where podhtm is a wrapper around a pod2html and subs is a text
substitution utility written by myself.

And there're also an online HTML version of the Perl 6 Spec:

   http://dev.perl.org/perl6/doc/synopsis.html

This version automatically updates from the SVN repository every few hours.

Hope these help.

Agent