From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: passt.top; dmarc=pass (p=quarantine dis=none) header.from=redhat.com Authentication-Results: passt.top; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=THQup6Fq; dkim-atps=neutral Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by passt.top (Postfix) with ESMTPS id AF4C65A027E for ; Fri, 16 May 2025 22:52:22 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1747428741; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=vI1a4tFaFKPUhlYng9QwkFVp7vlQnQt6yc/C8CVsOhg=; b=THQup6FqrKUyrVCWF+sQcYoxKPXuR369jzeYy2u1i70Xt3x3vlGHUkU/+fGWcxhGllnsHU uyAYNSMuMYCiRN6mnf9he8VBDywBJc8QfLOFlv5fisdVv7dh2ZLQB/Wyp4IyeW1w/ReztQ ugsLVK+Xpz7hJqV5IJn9UIyF9Ac9UxA= Received: from mail-wm1-f71.google.com (mail-wm1-f71.google.com [209.85.128.71]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-439-3bSdmyY-OVSBA47iV0sTcw-1; Fri, 16 May 2025 16:52:20 -0400 X-MC-Unique: 3bSdmyY-OVSBA47iV0sTcw-1 X-Mimecast-MFC-AGG-ID: 3bSdmyY-OVSBA47iV0sTcw_1747428738 Received: by mail-wm1-f71.google.com with SMTP id 5b1f17b1804b1-43f251dc364so16078475e9.2 for ; Fri, 16 May 2025 13:52:18 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1747428738; x=1748033538; h=content-transfer-encoding:mime-version:organization:references :in-reply-to:message-id:subject:cc:to:from:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=vI1a4tFaFKPUhlYng9QwkFVp7vlQnQt6yc/C8CVsOhg=; b=Hjjr81cwUtNiEWPqYbLmRp17dgzpgQQgyg5+j4ht/CvCPkYN/2mH+xcTLae80ocAH6 dVViCKtHqnopvqp0dEH2x1Cn/WLk6K7isV1JhxS9QkDAlzZXIjcWNJvv9gWeDTB8gUJx 7fN9+kNjY8ZSqUcMWglaHg6HE4E6Bm7saf9/qcnbg5MecXcDPdOFLxXKuBshrluo0Twv PgbzfTLVf3POeLsVNB2ajcpW7tPW+oy8PnqcB7KKeOXJ+Y1daPVVPdy28YELU7XZI4tT gnJSzg+q5E/h2krxL+rzCmO9kscijgXacd6dOZA3WauzisxiBZJmsGptCazkp/Rwa3mr YvGg== X-Gm-Message-State: AOJu0Yy1kfD7IUob1natyuIHY3a5aVOfXkDlamNgAbL0I7Idxqmgd482 N5NnE2hgzplnbTAmPGlVhJae8zRNZ8xEh6+1yKqyhwbZFc8V9gXq3YxnFXrJdEH+kFjkX6LSTdy 5b9gFFfhGkU/VPCT8Mt1OOzgbrSbUJaYXpopxhgkvzN5NBjjc7aeKSazwOPWNI6vgormV2or0KR zUFURbJkEBsDYnbF4hnshzrc9XrSV2560GTQSM X-Gm-Gg: ASbGncsbPih7KcgJAqP1qreuGPWZ4iGuay7BfiQK4GX4XljpWj9gdmSoNNNCfapUdgH o3Kf2hA42QgpM7/pUQqwyTzN/zHaOSEMn2meaRC1e+4w2lwsiLzqkkceUuwIULE0f5KEdq0LooL 7svyz+xR2BTSGdpd7WP8u43GWnRX5yM8bUK+s4qBE4BNK12NhEQMr6/mvxKHwKyZ9WvVp0f7q+o PkK7yYxKaf0Dx3qpzPMQcXFQJ9+qCZ5KjgaHD7Uk0yB+pUzLf0M/6796ohzWovIMwCszj1eJmQ3 Bt0/iSxQR4d74thKtNdzCcc= X-Received: by 2002:a05:600c:a012:b0:43c:e70d:44f0 with SMTP id 5b1f17b1804b1-442fd63bfa4mr47763185e9.19.1747428737705; Fri, 16 May 2025 13:52:17 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGMJu3pDRLHKrmjbE3XwYTE4ml/TkOIE2VOBr/2HeeYEZN0BHsNdmB1midUPMs0wMEeXTMcUQ== X-Received: by 2002:a05:600c:a012:b0:43c:e70d:44f0 with SMTP id 5b1f17b1804b1-442fd63bfa4mr47763005e9.19.1747428737267; Fri, 16 May 2025 13:52:17 -0700 (PDT) Received: from maya.myfinge.rs (ifcgrfdd.trafficplex.cloud. [2a10:fc81:a806:d6a9::1]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3a35ca8cb2dsm3911597f8f.84.2025.05.16.13.52.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 16 May 2025 13:52:16 -0700 (PDT) Date: Fri, 16 May 2025 22:52:15 +0200 From: Stefano Brivio To: Laurent Vivier Subject: Re: [PATCH 0/3] Standardize and correct function comment headers Message-ID: <20250516225215.018eb765@elisabeth> In-Reply-To: <20250516124228.2383036-1-lvivier@redhat.com> References: <20250516124228.2383036-1-lvivier@redhat.com> Organization: Red Hat X-Mailer: Claws Mail 4.2.0 (GTK 3.24.49; x86_64-pc-linux-gnu) MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: Qt8KE1RC8m0Jpjo2RtTnaGmPt6dij3VlLOnrbJfnZz8_1747428738 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Message-ID-Hash: TK6KRJWHRLJUA6WOMBMSULJT5WZNT4XA X-Message-ID-Hash: TK6KRJWHRLJUA6WOMBMSULJT5WZNT4XA X-MailFrom: sbrivio@redhat.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: passt-dev@passt.top X-Mailman-Version: 3.3.8 Precedence: list List-Id: Development discussion and patches for passt Archived-At: Archived-At: List-Archive: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: On Fri, 16 May 2025 14:42:25 +0200 Laurent Vivier wrote: > This series cleans up function comment headers in iov, virtio, > and vhost_user modules for improved consistency and accuracy. > > The following changes are included: > > iov: > Standardize function comment headers (Ensures /** and func_name() > syntax for uniformity) > virtio: > Correct and align comment headers (Addresses format, typos, tags, > param names in .c/.h) > vhost_user: > Correct and align function comment headers (Corrects params, > func names in comments, & docs in .c) > > Full details can be found in the individual patch descriptions. > > Laurent Vivier (3): > vhost_user: Correct and align function comment headers > virtio: Correct and align comment headers > iov: Standardize function comment headers Applied. -- Stefano