From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 98043C433FE for ; Sat, 19 Nov 2022 04:10:22 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id AB9546B0072; Fri, 18 Nov 2022 23:10:21 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id A69746B0073; Fri, 18 Nov 2022 23:10:21 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 9315B6B0074; Fri, 18 Nov 2022 23:10:21 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 7F8616B0072 for ; Fri, 18 Nov 2022 23:10:21 -0500 (EST) Received: from smtpin18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay10.hostedemail.com (Postfix) with ESMTP id 45735C073F for ; Sat, 19 Nov 2022 04:10:21 +0000 (UTC) X-FDA: 80148864642.18.AA8566F Received: from mail-pj1-f48.google.com (mail-pj1-f48.google.com [209.85.216.48]) by imf30.hostedemail.com (Postfix) with ESMTP id DE28180008 for ; Sat, 19 Nov 2022 04:10:20 +0000 (UTC) Received: by mail-pj1-f48.google.com with SMTP id m14so6146694pji.0 for ; Fri, 18 Nov 2022 20:10:20 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-disposition:mime-version:message-id:subject:cc:to:from:date :from:to:cc:subject:date:message-id:reply-to; bh=PYpcDOJfodrsXL7K8gUKnRBne0m8YjW/xpNBqmi9ICU=; b=SdWLDvPlCE/d1s5i2o//GpCZPHL1Muamna4Kmmqen1aocsjGNasTkJcEx5l1X96bcQ LBp4JyqEpbxx3xAWTq4YEI+CtccUeSxmKYbFExPswOypNBGdf+jv0Qrgkl6RkCHCR0pl bGbJbC+qe+gOJlbGLC5YwuvQJh52JQh7T9OTQOH/TqmWj389T8KTzsF/aAj+5piFOJSd MD28hMx3yBgTkS7FQOeEEio8KG/TKbr6LAnRuLZu/c/IgzDYbaVYsGovxEk2ehMkGZvv 3uPIiZTNrZxmqrCET3ioE3L8R1+3nd58xjTBP56j3v9G19bk+eOHeK5GwbCvUpombQ9z 1nbA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-disposition:mime-version:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=PYpcDOJfodrsXL7K8gUKnRBne0m8YjW/xpNBqmi9ICU=; b=0OsxEqNkZmXPA3/aV//Dm0A9azmWg4grw5OCGkXH7kcehDJsdB823ldsWw0kWb+PPU 5B5MXt6/7uXGMi+9OV6wUvWZ17oGm4z0uPn7LLp0NGBJ/PI8Bpy2OKqZl4mrMxqyLi0F ioIQlzPPh2IKDYL3NGCP+b5vl5ktLCv4Yi/aLsyy/Gabfz0FWI6au9H/co2drgABDVly iI387kWCyxWqasafYUGXE6VLJhbrx+U1FgHUU9tCMRkJL66xi48PySnhcSlnERqXtTJj z8AOluHdxvIln+nqER3y/fhx6MsyoTxNEH4rpJqAgcs+cUYoNI5M/ItpIGCIvKu4xqI1 NMTQ== X-Gm-Message-State: ANoB5plpDxmSaaU4k90JdAO/EWCNYK6zZuipHMnAXtPOfmLb5de0Du59 j9ysu+ZyAaJI+QJGkykLeyo= X-Google-Smtp-Source: AA0mqf7xmMLhyAVAojMS8sA21zZByg8HH4uipalwhW611N4r57jb2M4QTY6aianvHVUIaRqMlRXJqg== X-Received: by 2002:a17:902:bc43:b0:189:1e5:8424 with SMTP id t3-20020a170902bc4300b0018901e58424mr2358884plz.156.1668831019524; Fri, 18 Nov 2022 20:10:19 -0800 (PST) Received: from debian.me (subs32-116-206-28-33.three.co.id. [116.206.28.33]) by smtp.gmail.com with ESMTPSA id t20-20020a17090a951400b001fb1de10a4dsm3136996pjo.33.2022.11.18.20.10.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 18 Nov 2022 20:10:18 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 9B2F810131E; Sat, 19 Nov 2022 11:10:15 +0700 (WIB) Date: Sat, 19 Nov 2022 11:10:15 +0700 From: Bagas Sanjaya To: Linux Documentation , Linux Memory Management List , LKML , Linus Torvalds Cc: Andrew Morton , "Matthew Wilcox (Oracle)" , Vlastimil Babka , David Hildenbrand , Hugh Dickins , "Liam R. Howlett" , Peter Xu , Yu Zhao , Colin Cross , Arnd Bergmann , Pasha Tatashin Subject: Cannot parse struct or union error on mm-everything Message-ID: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="PYM4qzxBlogO0qIF" Content-Disposition: inline ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1668831020; a=rsa-sha256; cv=none; b=1UXAkesv4a5Vw0NhrmmK4XQKdZycOPWiyhtl0Gl6jZN1+kgskrQneMt1PUmQ3NWx/1rZyJ 10ZBp7MHn5o7hEXRSTc6477zs+mAQywjSm9NKqlC1sjz0+1tuptVi4DciYwV12A7hThdfp ndMJv706dMDpLh5+pJCkeOOCWS4PI4s= ARC-Authentication-Results: i=1; imf30.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=SdWLDvPl; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf30.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.48 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1668831020; h=from:from:sender: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:in-reply-to: references:dkim-signature; bh=PYpcDOJfodrsXL7K8gUKnRBne0m8YjW/xpNBqmi9ICU=; b=mfQvvmBJfnX9oH7HK4WbXrPpMaQOsWerdDenNkHaZLldwSV0Wv90NDut/RfsIQBQ3RTXZg IwefG8rHiwBcdPkbvL/Mk9heRT8f9iU231UQmmQ89EE5xnRdNAlp40/uPJ+g43/h0PrbHm ddjUMmzkt1Bs78n74vHRk8NJOeLJ7ro= X-Stat-Signature: uwcddfs96str6if3r7gsp4osrzirzf4y X-Rspamd-Queue-Id: DE28180008 X-Rspam-User: Authentication-Results: imf30.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=SdWLDvPl; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf30.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.48 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com X-Rspamd-Server: rspam09 X-HE-Tag: 1668831020-858245 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: --PYM4qzxBlogO0qIF Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Greetings, I found a new htmldocs warning on mm-everything: WARNING: kernel-doc './scripts/kernel-doc -rst -enable-lineno -sphinx-versi= on 2.4.4 -internal ./include/linux/mm_types.h' failed with return code 1 Checking the header with './scripts/kernel-doc -v -none=20 =2E/include/linux/mm_types.h', I got the full error: include/linux/mm_types.h:255: info: Scanning doc for struct encoded_page include/linux/mm_types.h:268: error: Cannot parse struct or union! include/linux/mm_types.h:287: info: Scanning doc for struct folio include/linux/mm_types.h:917: info: Scanning doc for typedef vm_fault_t include/linux/mm_types.h:924: info: Scanning doc for enum vm_fault_reason include/linux/mm_types.h:1028: info: Scanning doc for enum fault_flag 1 errors The culprit is encoded_page struct, which is null struct (nonexistent type) with kernel-doc comments: /** * struct encoded_page - a nonexistent type marking this pointer * * An 'encoded_page' pointer is a pointer to a regular 'struct page', but * with the low bits of the pointer indicating extra context-dependent * information. Not super-common, but happens in mmu_gather and mlock * handling, and this acts as a type system check on that use. * * We only really have two guaranteed bits in general, although you could * play with 'struct page' alignment (see CONFIG_HAVE_ALIGNED_STRUCT_PAGE) * for more. * * Use the supplied helper functions to endcode/decode the pointer and bits. */ struct encoded_page; The struct is introduced by d57ab372568585 ("mm: introduce 'encoded' page pointers with embedded extra bits"). Thanks. --=20 An old man doll... just what I always wanted! - Clara --PYM4qzxBlogO0qIF Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEABYIAB0WIQSSYQ6Cy7oyFNCHrUH2uYlJVVFOowUCY3hXIgAKCRD2uYlJVVFO oy9GAQD3dc8vDZO0faWCSOEfGMQxg+GSElZME4FKGFeSY/aM3AD/XhEPWkai/23w f2c8afnHyGooLCnMQc86vQeg4WM13gY= =da30 -----END PGP SIGNATURE----- --PYM4qzxBlogO0qIF--