WordPress.org

Making WordPress.org

Opened 9 months ago

Closed 7 months ago

#3212 closed defect (fixed)

@link in fetch_feed() isn't generated correctly

Reported by: birgire Owned by: coffee2code
Milestone: Priority: normal
Component: Developer Hub Keywords:
Cc:

Description

This doc part [src] for the fetch_feed() function:

* @param mixed $url URL of feed to retrieve. If an array of URLs, the feeds are merged
* using SimplePie's multifeed feature.
* See also {@link ​http://simplepie.org/wiki/faq/typical_multifeed_gotchas}

generates encoded HTML link

See also <a href="https://developer.wordpress.org/reference/functions/%e2%80%8bhttpsimplepie-orgwikifaqtypical_multifeed_gotchas">​&lt;a href="http://simplepie.org/wiki/faq/typical_multifeed_gotchas"&gt;http://simplepie.org/wiki/faq/typical_multifeed_gotchas&lt;/a&gt;</a>

here:

https://developer.wordpress.org/reference/functions/fetch_feed/

It looks like it treated as @see instead.

I wonder if the See part, in the same line as @link, is confusing the parsing here:

https://meta.svn.wordpress.org/sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/formatting.php

Change History (2)

#1 @coffee2code
7 months ago

  • Owner set to coffee2code
  • Status changed from new to accepted

#2 @coffee2code
7 months ago

  • Resolution set to fixed
  • Status changed from accepted to closed

Thanks for the report @birgire!

This issue has been fixed in the Code Reference. It actually stems from a bug I just reported to WP core. A zero width character precedes the URL in the @link for the parameter description, which interferes with how the link was being handled. I removed the character locally for DevHub, and will make a note to manually do so for each future parsing until my patch for core is applied.

Note: See TracTickets for help on using tickets.