[wp-meta] [Making WordPress.org] #7963: Code reference source blocks

[Making WordPress.org]

#7963: Code reference source blocks
---------------------------+---------------------
 Reporter:  skithund       |       Owner:  (none)
     Type:  defect (bug)   |      Status:  new
 Priority:  normal         |   Milestone:
Component:  Developer Hub  |  Resolution:
 Keywords:                 |
---------------------------+---------------------

Comment (by dd32):

 As noted in #7964 the 6.8 update appears to have been broken somehow,
 resulting in incomplete data.

 After I've imported the 6.8 updates to devhub in #7964, I've now re-run
 the code caching process which has populated a bunch of functions, but not
 all of the ones mentioned here.

 For others, I ran this after using `wp parser import` above.
 {{{
 wp @developer shell
 > update_option( 'wp_parser_root_import_dir', '/tmp/wp-6.8/src' );
 > DevHub_Parser::cache_source_code();
 > delete_option( 'wp_parser_root_import_dir' );
 }}}

 It appears that some files aren't being parsed.

 In the devhub parse, several files have no data extracted, such as `wp-
 includes/media.php` and `wp-includes\l10n.php`.

 As noted in https://github.com/WordPress/phpdoc-parser/issues/246 some
 files are hitting a fatal error in the parser we're using, so I'm guessing
 that's these files.

 > The line number references seem to match the offsets for WP 6.6,

 We don't automatically delete file/function/class references on
 developer.w.org, which is a bug in of itself, but this has caused the
 functions to become stale as the 6.7+6.8 imports haven't updated their
 line numbers.

 https://developer.wordpress.org/reference/functions/load_theme_textdomain/
 https://developer.wordpress.org/reference/functions/image_get_intermediate_size/

 To resolve this; we'll need to figure out how to get the PHPDoc parser to
 be able to parse those files.  I'll put some notes in
 https://github.com/WordPress/phpdoc-parser/issues/246

-- 
Ticket URL: <https://meta.trac.wordpress.org/ticket/7963#comment:3>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org