problem-solving icon indicating copy to clipboard operation
problem-solving copied to clipboard

raku --doc should get a pager

Open JJ opened this issue 4 years ago • 7 comments

Carried over from Raku/old-issue-tracker#2522, a request for a pager for raku --doc output. Right now it simply prints everything to the console.

JJ avatar May 07 '20 17:05 JJ

Yes. This is not a thing to discuss, but a thing to implement & test.

Altai-man avatar May 07 '20 17:05 Altai-man

Yes.

AlexDaniel avatar May 07 '20 17:05 AlexDaniel

All for it, too!

JJ avatar May 07 '20 17:05 JJ

But wait. Why did you move it to this repo?

JJ avatar May 07 '20 18:05 JJ

I'm not so sure. Sounds kinda right, but to my view it's rather something an external utility like p6doc must do. Basically, the only two formats asking for a pager are text and man. HTML, Latex, Markdown? There could a --pager option for that purpose. But --doc itself must only render.

BTW, there is Pod::To::Pager out there.

vrurg avatar May 07 '20 18:05 vrurg

raku --doc is purely Rakudo; it can call other things like Pod::To::HTML, but in that case rakudo can't do a thing about it. So I would say either it stays in problem-solving or goes to Rakudo (and others)

JJ avatar May 07 '20 18:05 JJ

Oh! My mistake then.

AlexDaniel avatar May 07 '20 18:05 AlexDaniel