Re: Pod6 examples

2020-07-21 Thread Parrot Raiser
Thanks, Richard and daniel.

On 7/21/20, Richard Hainsworth  wrote:
> How about:
>
> https://github.com/Raku/doc/tree/master/doc/Language/pod.pod6
>
> which is the pod source of https://docs.raku.org/language/pod
>
> Also try the other sources under the
> https://github.com/Raku/doc/tree/master/doc directory.
>
> Richard
>
> On 21/07/2020 15:40, Parrot Raiser wrote:
>> Can anyone point me at examples of pod6 in use? I'm trying to relate
>> the syntax shown in https://docs.raku.org/language/pod to actual
>> results. Concise would be nice, tutorial even better.
>


Re: Pod6 examples

2020-07-21 Thread JJ Merelo
El mar., 21 jul. 2020 a las 17:23, Richard Hainsworth (<
rnhainswo...@gmail.com>) escribió:

> How about:
>
> https://github.com/Raku/doc/tree/master/doc/Language/pod.pod6
>
> which is the pod source of https://docs.raku.org/language/pod


This page is also intended as a tutorial. If there's something you miss
there, we'd be happy to get an issue about it (or a PR).

Cheers

JJ


Re: Pod6 examples

2020-07-21 Thread daniel
> Can anyone point me at examples of pod6 in use?… Concise would be nice,

One concise example I've found useful is the Pod::Load script, 
https://modules.raku.org/dist/Pod::Load:cpan:JMERELO/lib/Pod/Load.pm6
This short script shows pod6 used both as a more full-featured 
documentation format (the text between `=begin pod` and `=end pod`)
and for inline "docstring"-like function documentation – which is then 
available at runtime via the `WHY` method – (the comments starting with
`#|`.

> tutorial even better.

I'm not aware of any tutorials, but I wouldn't be surprised if some exist
– there have been a lot of Raku blog posts over the years.  Maybe someone
else will know of one.


Re: Pod6 examples

2020-07-21 Thread Richard Hainsworth

How about:

https://github.com/Raku/doc/tree/master/doc/Language/pod.pod6

which is the pod source of https://docs.raku.org/language/pod

Also try the other sources under the 
https://github.com/Raku/doc/tree/master/doc directory.


Richard

On 21/07/2020 15:40, Parrot Raiser wrote:

Can anyone point me at examples of pod6 in use? I'm trying to relate
the syntax shown in https://docs.raku.org/language/pod to actual
results. Concise would be nice, tutorial even better.