Ticket #1054 (new bug)

Opened 5 years ago

Last modified 3 years ago

Some documents at docs.parrot.org are missing data.

Reported by: shockwave Owned by:
Priority: normal Milestone:
Component: website Version: 1.6.0
Severity: low Keywords:
Cc: Language:
Patch status: Platform:

Description

This page has a line at the bottom directing the user to a "table" of information:  http://docs.parrot.org/parrot/latest/html/docs/book/pir/ch07_objects.pod.html

The page doesn't have the table, but the pod documentation does. The script that's extracting that info might not be working correctly.

Change History

  Changed 5 years ago by jkeenan

  • component changed from none to website

follow-up: ↓ 3   Changed 5 years ago by coke

  • owner set to coke

in reply to: ↑ 2   Changed 4 years ago by jkeenan

Replying to coke:

Coke, can you provide any update on this ticket?

Thank you very much.

kid51

  Changed 4 years ago by coke

Nope.

  Changed 4 years ago by coke

  • owner coke deleted

  Changed 3 years ago by jkeenan

This problem occurs in several files:

docs/book/pir/ch04_variables.pod:300:=begin table String Escapes
docs/book/pir/ch04_variables.pod:594:=begin table Format characters
docs/book/pir/ch04_variables.pod:708:=begin table Format flags
docs/book/pir/ch04_variables.pod:762:=begin table Size flags
docs/book/pir/ch06_subroutines.pod:1165:=begin table Function signature letters
docs/book/pir/ch07_objects.pod:421:=begin table Class Introspection

None of the 6 tables is generated in the html.

The problem probably originates in an inability on the part of whatever generates docs.parrot.org to understand the custom POD formatting used in these files for tables. Example:

=begin table Function signature letters

Z<CHP-6-TABLE-1>

=headrow

=row

=cell Character

=cell Register

...

=row

=cell C<Z>

=cell C<P>

=cell the argument for C<Y>

=end table
Note: See TracTickets for help on using tickets.