<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugs.webkit.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4.1"
          urlbase="https://bugs.webkit.org/"
          
          maintainer="admin@webkit.org"
>

    <bug>
          <bug_id>247313</bug_id>
          
          <creation_ts>2022-11-01 05:08:02 -0700</creation_ts>
          <short_desc>Code style does not allow currently used member function explanation comments for vfuncs, ipc messages</short_desc>
          <delta_ts>2022-11-02 02:29:13 -0700</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebKit</product>
          <component>Tools / Tests</component>
          <version>Safari Technology Preview</version>
          <rep_platform>Unspecified</rep_platform>
          <op_sys>Unspecified</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>InRadar</keywords>
          <priority>P2</priority>
          <bug_severity>Normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Kimmo Kinnunen">kkinnunen</reporter>
          <assigned_to name="Kimmo Kinnunen">kkinnunen</assigned_to>
          <cc>cdumez</cc>
    
    <cc>rniwa</cc>
    
    <cc>webkit-bug-importer</cc>
          

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>1909528</commentid>
    <comment_count>0</comment_count>
    <who name="Kimmo Kinnunen">kkinnunen</who>
    <bug_when>2022-11-01 05:08:02 -0700</bug_when>
    <thetext>Code style does not allow currently used member function explanation comments for vfuncs, ipc messages

Current style defines that comments must be English sentences.

Currently code uses:
  class GPUProcessConnection : public RefCounted&lt;GPUProcessConnection&gt;, public IPC::Connection::Client {
  public:
      /// ...
  
      // IPC::Connection::Client
      void didClose(IPC::Connection&amp;) override;
     // ...
  };

When trying to solve this by using:
 // IPC::Connection::Client overrides.
.. then some reviewer complains.

When trying to solve this by using:
 // IPC::Connection::Client
.. then another reviewer complains.

It is not good that review results of seemingly deterministic rule-based system depends on personal preferences of who happens to review the patch.

This causes non-deterministic churn during reviews.

The code style could define this case so that there would be no need for personal preferences.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1909529</commentid>
    <comment_count>1</comment_count>
    <who name="Radar WebKit Bug Importer">webkit-bug-importer</who>
    <bug_when>2022-11-01 05:08:57 -0700</bug_when>
    <thetext>&lt;rdar://problem/101801434&gt;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1909530</commentid>
    <comment_count>2</comment_count>
    <who name="Kimmo Kinnunen">kkinnunen</who>
    <bug_when>2022-11-01 05:10:10 -0700</bug_when>
    <thetext>Pull request: https://github.com/WebKit/WebKit/pull/5996</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1909739</commentid>
    <comment_count>3</comment_count>
    <who name="EWS">ews-feeder</who>
    <bug_when>2022-11-02 02:29:10 -0700</bug_when>
    <thetext>Committed 256221@main (09420100638c): &lt;https://commits.webkit.org/256221@main&gt;

Reviewed commits have been landed. Closing PR #5996 and removing active labels.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>