search

Raku / old-issue-tracker

Tickets from RT
https://github.com/Raku/old-issue-tracker/issues
2 stars 1 forks source link

need pod-to-man translator #5441

Open p6rt opened 8 years ago

p6rt commented 8 years ago

Migrated from rt.perl.org#128587 (status was 'new')

Searchable as RT128587$

p6rt commented 8 years ago

From @tbrowder

Need a pod2man translator.

p6rt commented 8 years ago

From @coke

On Sat Jul 09 13​:51​:07 2016, tbrowder wrote​:

Need a pod2man translator.

Does this need to be shipped with the rakudo compiler? -- Will "Coke" Coleda

p6rt commented 8 years ago

From @coke

On Sat Jul 09 13​:51​:07 2016, tbrowder wrote​:

Need a pod2man translator.

Does this need to be shipped with the rakudo compiler? -- Will "Coke" Coleda

p6rt commented 8 years ago

From @tbrowder

On Monday, July 11, 2016, Will Coleda via RT \<bugs-comment@​bugs6.perl.org \javascript&#8203;:\_e\(%7B%7D,'cvml','bugs\-comment@&#8203;bugs6\.perl\.org'\);> wrote​:

On Sat Jul 09 13​:51​:07 2016, tbrowder wrote​:

Need a pod2man translator. Does this need to be shipped with the rakudo compiler?

Since the perl6 program --help once mentioned the perl6 man page, maybe it should.

-Tom

p6rt commented 8 years ago

From @pmichaud

I think any pod2man translator program should be separate from Rakudo itself.

If --help mentions a man page, it's probably sufficient to ship Rakudo with an already-translated man page, rather than shipping the translator.

Pm

On Tue, Jul 12, 2016 at 04​:34​:00AM -0500, Tom Browder wrote​:

On Monday, July 11, 2016, Will Coleda via RT \\[1\]bugs\-comment@&#8203;bugs6\.perl\.org wrote​:

 On Sat Jul 09 13&#8203;:51&#8203;:07 2016, tbrowder wrote&#8203;:
 > Need a pod2man translator\.
 Does this need to be shipped with the rakudo compiler?

Since the perl6 program --help once mentioned the perl6 man page, maybe it should.

-Tom

References

1. javascript​:_e({},'cvml','bugs-comment@​bugs6.perl.org');

p6rt commented 8 years ago

From @tbrowder

On Tuesday, July 12, 2016, Patrick R. Michaud \pmichaud@&#8203;pobox\.com wrote​:

I think any pod2man translator program should be separate from Rakudo itself.

If --help mentions a man page, it's probably sufficient to ship Rakudo with an already-translated man page, rather than shipping the translator.

Very true--the voice of reason!

But shouldn't all the pod6-to-X translators live together and share lots of common code (such as ShimmerFairy's planned pod6 grammar)?

-Tom

p6rt commented 8 years ago

From @pmichaud

On Tue, Jul 12, 2016 at 08​:48​:59AM -0500, Tom Browder wrote​:

If --help mentions a man page, it's probably sufficient to ship Rakudo with an already-translated man page, rather than shipping the translator.

Very true--the voice of reason!

But shouldn't all the pod6-to-X translators live together and share lots of common code (such as ShimmerFairy's planned pod6 grammar)?

Sure, it's reasonable for pod6-to-X translators to live together; but Rakudo (compiler) isn't the place for that. Better is to have the translators as modules, and then bundle them into a distribution like a Rakudo Star or the like.

Pm