Comments in wp-login.php start with an "*" too few.

[NekoJonez]

On line 98, 427, 537 the comment block starts with /* while all others start with /**.

This PR would fix trac ticket:
https://core.trac.wordpress.org/ticket/56843

This PR just adds an additional "*" at the start of the comment blocks so it's like all the other ones.

[SergeyBiryukov]

Hi there, thanks for the ticket!

I believe the current format is correct here as per the ​PHP Documentation Standards:

• /** is reserved for DocBlocks, for example:

  /**
   * Summary.
   *
   * @since x.x.x
   * @var type $var Description.
   */
  

• /* is for regular ​multi-line comments:

  /*
   * This is a comment that is long enough to warrant being stretched over
   * the span of multiple lines. You'll notice this follows basically
   * the same format as the PHPDoc wrapping and comment block style.
   */
  

[NekoJonez]

@SergeyBiryukov Am I then correct in understanding that my changes aren't needed?

Personally, I find it strange to have a difference between them. But that might be just me.

[sabernhardt]

I do not think a change is necessary.

However, the "Main part" comment is technically only one line with the multi-line formatting (probably purposely calling attention to how the section is different from the functions preceding it). Maybe the comment would be worth splitting into two lines:

 /*
  * Main part:
  * Check the request and redirect or display a form based on the current action.
  */

[SergeyBiryukov]

Replying to sabernhardt:

Maybe the comment would be worth splitting into two lines:

 /*
  * Main part:
  * Check the request and redirect or display a form based on the current action.
  */

Sounds good, thanks!

[SergeyBiryukov]

In 54848:

Docs: Split the "main part" comment in wp-login.php into two lines.

This aims to better match the multi-line comment format of the documentation standards.

Follow-up to [6643], [52945], [53313].

Props sabernhardt, NekoJonez.
Fixes #56843.

Due to the convo on Trac, this is going to be closed.