From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f181.google.com (mail-pf1-f181.google.com [209.85.210.181]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 618AA3314A9 for ; Mon, 15 Dec 2025 09:12:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.181 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765789977; cv=none; b=iUGqWbmVPPvASnHyAz0gOJ4/+tJuENByM18ynIe0lvrO4RuyoUO+4iL9J9d37cCvy18RUM7glYs77ymmwR59jbwfxMJsSV2n3sqJQeBehVODXrcrcUeKET+usGZir+j7O5iKKSLa+aU/coHJXCcC7610ctjKTHYx5/DZQhUeunE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765789977; c=relaxed/simple; bh=z6JBVVpYTLKQYsp6P49h+E3D5NtloPxytMIPj3+CkBU=; h=Date:From:To:Cc:Subject:Message-ID:MIME-Version:Content-Type: Content-Disposition; b=lppEqNFUBrnWKUO5KVwJH2BictXu8/xkjsqRpetD3U4gHiWRBLlrkB4imDubqoBHeaSp4pJAzhZATSfudu7CNPyAAaBMhbw58r++x9z9TrCt5hdLKwvOJIPvXGa/JTYJfTd2VugqPv4XYLS8DiGOlbucbZhyBmpWls51md3R2Vc= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=b7M9KKBg; arc=none smtp.client-ip=209.85.210.181 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="b7M9KKBg" Received: by mail-pf1-f181.google.com with SMTP id d2e1a72fcca58-7f121c00dedso3967057b3a.0 for ; Mon, 15 Dec 2025 01:12:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1765789976; x=1766394776; darn=vger.kernel.org; h=content-disposition:mime-version:message-id:subject:cc:to:from:date :from:to:cc:subject:date:message-id:reply-to; bh=aR0q5gZgzi5K6sLzSLf9sKZOIrpuIZwxmRjvvPcUdsg=; b=b7M9KKBgGPToQJYsAJamNY5Tg3zjoWQP+14nRP0nZfoT3EYQsrCOJB5K17hHrKTq8J 8MtbNxxB/eJESOHdH2FGml10uLlaNhVzP6EDwC9PF5boNwehHq7x76/sczxjqVOJpT6M MuUwXR81gkD+WATSUqrZvxw9F98rB6i3w+Sz5Vo5AmL8CA4hxNTOwCGrklwLhGLgIcQp +M4JWHr1XWAdyVCB9U4kliRWF/H0QrYfw2p9SW6Z+DmyEbguk5vBGoHdCtz/Mw43BU7t NalA0SX1snXBmr+pVkYZ6695TxQgVJJEoVBYUBzzlItBw+yW+UUI09m0ccw18K66Al4o FpqA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765789976; x=1766394776; h=content-disposition:mime-version:message-id:subject:cc:to:from:date :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=aR0q5gZgzi5K6sLzSLf9sKZOIrpuIZwxmRjvvPcUdsg=; b=g++fAQjVbLnkKnCrHaOVD326UExeqvgaNyD9HN1xynCG1s8OatVr8R5rbBwkX8u/LP h+rASThdYg2aIxEVBNnwaOuMwjHVlTiJB7eUQQtKl2LCwrQreDNuQfX5wiyfTTzDdhYF Dmjimnha8+IGPzKSTtxLVA+6xpSa3tOAaGichmUnCVHBtTCnjuQW4wuymmvN9Q+vZ54v E8Un6xicxeV+HK6KcI2uc4LjBUXXWS8H375gBtunJGX2Lui2kkcTua0gK+qR1YIovOLW wgJowBF76z+TzwU5y7kodCF4GVaKZ2DcLkwBxSCSfO6JJL7w7guOODLU57pfJRe+tUfy dcSA== X-Gm-Message-State: AOJu0Yxwt9DJG4Jq2d3fxWktWx5z2O4+ammJA+V4BGCyyJI7BXXgYHAf RZuIxLSTuhFnr+vM9DwoWWfDfz/QY+FsVVgKvu+qwZ2dEMnKKrXgIXuZtPBVMzHyRk0= X-Gm-Gg: AY/fxX7vcUeHvx93ICcSTRJs3jGKmfw5Uu76SzsUW+XDT0WlPpM8rbhXkm3sTyEmZMZ genh+0pc1QFAtyUJtNlxpe7vLxsbx3+uNGsnp7GXMnQtr/gGKQqqbfuMJ9DpzRFhExddL8mkmpR 9yce/ZZnz4a+fYHXhoKkR4yL8O84nHaZx01yYP8QQ3lrZN95Xp3zzHHz6BZdPadCcyekYH4+26a 8akRLT6xInO+ucpo0coG6vf6gKuQhYonzGz0WdcZ0d2Nfhc2Vtdmf5f5c1qR1IJNSMgvoQHUgAt IT2m03BVWNcgTSbRyPe9lydp6XG7cHza2Q5pnb6xpb2gD9XrSd33mQb5eJjMbvi/O2IHIMKIiqM 1BIbHs8b7K68/hEwDbKqXbM3JEEN92w5PGQMq8z7s0EVALSxbybZW5pSlV68r7ulwZbGQcaFDCL Y17DMOSbxweAo= X-Google-Smtp-Source: AGHT+IEo9HFyRxBh3H58peELrcoKXuQEto6liK2jEeLWBCANq6VtutrYLACJVBWT8TeJY4kzXM3I9g== X-Received: by 2002:a05:6a00:339b:b0:7ac:1444:6777 with SMTP id d2e1a72fcca58-7f66744724emr11597719b3a.12.1765789975604; Mon, 15 Dec 2025 01:12:55 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7f4bf7be436sm11997902b3a.0.2025.12.15.01.12.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Dec 2025 01:12:54 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 9F95D41902F7; Mon, 15 Dec 2025 16:12:44 +0700 (WIB) Date: Mon, 15 Dec 2025 16:12:44 +0700 From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Crypto , Linux Documentation Cc: Randy Dunlap , Herbert Xu , "David S. Miller" , Jonathan Corbet Subject: kernel-doc comment with anonymous variable in anonymous union? Message-ID: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="qEoMnYBTe+dXSVaM" Content-Disposition: inline --qEoMnYBTe+dXSVaM Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi, kernel-doc reports warning on include/crypto/skcipher.h: WARNING: ./include/crypto/skcipher.h:166 struct member 'SKCIPHER_ALG_COMMON= ' not described in 'skcipher_alg' skciper_alg struct is defined as: struct skcipher_alg { int (*setkey)(struct crypto_skcipher *tfm, const u8 *key, unsigned int keylen); int (*encrypt)(struct skcipher_request *req); int (*decrypt)(struct skcipher_request *req); int (*export)(struct skcipher_request *req, void *out); int (*import)(struct skcipher_request *req, const void *in); int (*init)(struct crypto_skcipher *tfm); void (*exit)(struct crypto_skcipher *tfm); unsigned int walksize; union { struct SKCIPHER_ALG_COMMON; struct skcipher_alg_common co; }; }; Note the first member in the union, which is an anonymous (i.e. unnamed) va= riable. What can I do on it? Should the offending member be deleted? Thanks. --=20 An old man doll... just what I always wanted! - Clara --qEoMnYBTe+dXSVaM Content-Type: application/pgp-signature; name=signature.asc -----BEGIN PGP SIGNATURE----- iHUEABYKAB0WIQSSYQ6Cy7oyFNCHrUH2uYlJVVFOowUCaT/RDAAKCRD2uYlJVVFO o09iAQCiZd1XPtjXzmtyrrBrzCiDsiuOIlgzXMzu6/NeoJKQdAEAqhyJNLilw7Bb BgN14Sa2taVF0vxRRwQ4frrJyKVVeg4= =ly+T -----END PGP SIGNATURE----- --qEoMnYBTe+dXSVaM--