[PATCH] Updates for languages/PIR/docs/pirgrammar.pod

[Klaas-Jan Stol]

hi,

attached a patch for pirgrammar.pod and its html variant.

Fixing:

* errors, misspellings and such
* more examples
* x.y.z version number

regards,
kjs

[Chromatic]

On Wednesday 07 February 2007 08:33, Klaas-Jan Stol wrote:

> attached a patch for pirgrammar.pod and its html variant.

Keeping this HTML in the repository sucks. Is there a possibilty that we
could generate it automatically? What's preventing us from doing so?

I understand the rationale for some generated files, such as those that
require flex and bison, but this one seems different.

-- c

[Klaas-Jan Stol]

absolutely true. I'm not sure; is pod2html present on any platform where
perl is? If so, then it can be incorporated into step.pm, (that makes
the Makefiles), so it can done when running make.

(likewise, make test could run podchecker on the pod files)

kjs

[Chromatic]

On Wednesday 07 February 2007 12:25, Klaas-Jan Stol wrote:

> absolutely true. I'm not sure; is pod2html present on any platform where
> perl is? If so, then it can be incorporated into step.pm, (that makes
> the Makefiles), so it can done when running make.

> (likewise, make test could run podchecker on the pod files)

Both pod2html and podchecker have been in the core for a while; certainly
since 5.8.0.

-- c

[Jerry Gay]

and there's a 'html' target in the root makefile. copying this to the
languages/PIR/ makefile would be a good start.
~jerry