Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

make Error Encountered When Building Docs #2562

Closed
Xliff opened this issue Jan 13, 2019 · 6 comments
Closed

make Error Encountered When Building Docs #2562

Xliff opened this issue Jan 13, 2019 · 6 comments
Labels
bug Error of some kind, from a typo to errors in the examples. external Depends on another ticket (likely in another repo)

Comments

@Xliff
Copy link
Collaborator

Xliff commented Jan 13, 2019

The problem

I am getting an error when attempting to build the docs. It occurs with both 'make' and 'make html' and does not seem to be related to #2424.

$ make
perl6 util/manage-page-order.p6 update --manage=True
Normal end.
See new target files in dir 'build/Language'
pod2onepage --html -v --source-path=./build --exclude=404.pod6 > html/perl6.html
processed ./build/HomePage.pod6 
processed ./build/Language/001-GroupA.pod6 
processed ./build/Language/002-intro.pod6 
Type check failed for return value; expected Bool:D but got Junction (any(Bool::False, Bool...)
  in sub rewrite-link at /home/cbwood/Projects/rakudobrew/moar-master/install/share/perl6/site/sources/DC8EC64E0BFD084FC507D28748AFA3BCE2F34406 (Pod::To::BigPage) line 546
  in sub handle at /home/cbwood/Projects/rakudobrew/moar-master/install/share/perl6/site/sources/DC8EC64E0BFD084FC507D28748AFA3BCE2F34406 (Pod::To::BigPage) line 409
  in sub handle at /home/cbwood/Projects/rakudobrew/moar-master/install/share/perl6/site/sources/DC8EC64E0BFD084FC507D28748AFA3BCE2F34406 (Pod::To::BigPage) line 349
  in sub handle at /home/cbwood/Projects/rakudobrew/moar-master/install/share/perl6/site/sources/DC8EC64E0BFD084FC507D28748AFA3BCE2F34406 (Pod::To::BigPage) line 318
  in sub parse-pod-file at /home/cbwood/Projects/rakudobrew/moar-master/install/share/perl6/site/resources/55DE996E689E57BB0A2F458BDFDD37A70F71F3B1 line 86
  in block  at /home/cbwood/Projects/rakudobrew/moar-master/install/share/perl6/site/resources/55DE996E689E57BB0A2F458BDFDD37A70F71F3B1 line 48
  in sub MAIN at /home/cbwood/Projects/rakudobrew/moar-master/install/share/perl6/site/resources/55DE996E689E57BB0A2F458BDFDD37A70F71F3B1 line 47
  in block <unit> at /home/cbwood/Projects/rakudobrew/moar-master/install/share/perl6/site/resources/55DE996E689E57BB0A2F458BDFDD37A70F71F3B1 line 100
  in sub MAIN at /home/cbwood/Projects/rakudobrew/bin/../moar-master/install/share/perl6/site/bin/pod2onepage line 2
  in block <unit> at /home/cbwood/Projects/rakudobrew/bin/../moar-master/install/share/perl6/site/bin/pod2onepage line 2

Rakudo version is:

This is Rakudo version 2018.12-194-ge46351892 built on MoarVM version 2018.12-13-g473324ee3
implementing Perl 6.d.
@JJ
Copy link
Contributor

JJ commented Jan 13, 2019

I'll check it out. Thanks.

@JJ
Copy link
Contributor

JJ commented Jan 13, 2019

Right. It's failing also with v2018.12.207.g.0.d.9.e.9.f.34.c. It's a problem in pod2onebigpage. I'll open an issue there.

@JJ JJ added external Depends on another ticket (likely in another repo) bug Error of some kind, from a typo to errors in the examples. ⚠ Blocker ⚠ labels Jan 13, 2019
@AlexDaniel
Copy link
Member

Wait, so it's a regression in rakudo? Please file a ticket for https://github.com/rakudo/rakudo/ then.

@JJ
Copy link
Contributor

JJ commented Jan 13, 2019

This is also due to the Great Link Rewrite: it's gone down to a particular /type/Array link in the indicated file. It's here: https://github.com/perl6/doc/blob/master/doc/Language/101-basics.pod6#L145 and it was made in d8c2b04 by @finanalyst
Once again, the link looks perfectly fine. The change has made a Pod2OneBigPage surface.

@JJ
Copy link
Contributor

JJ commented Jan 13, 2019

@AlexDaniel no it's not. It's an error in Pod-to-OneBigPage which wasn't shown before because there were no links of that type before the big rewrite.

@JJ
Copy link
Contributor

JJ commented Jan 13, 2019

For some reason, thos kind of links became an array when processed. As always, working with the HTML generation routines is a veritable Pandora box of surprises. Patched now, fix coming soon.

JJ added a commit to JJ/perl6-pod-to-bigpage that referenced this issue Jan 13, 2019
JJ added a commit to JJ/perl6-pod-to-bigpage that referenced this issue Jan 13, 2019
Which I don't really understand, but that's the way it is. Fixes perl6#34.

Also WIP for Raku/doc#2562, will have to be tested.

Adds a ChangeLog for registering changes in every new version. Writes
tests also for new feature.
@JJ JJ closed this as completed in 8c23b6d Jan 13, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Error of some kind, from a typo to errors in the examples. external Depends on another ticket (likely in another repo)
Projects
None yet
Development

No branches or pull requests

3 participants