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 X-Spam-Level: X-Spam-Status: No, score=-5.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, NICE_REPLY_A,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1F13AC433ED for ; Wed, 7 Apr 2021 15:19:38 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id CF30C610CB for ; Wed, 7 Apr 2021 15:19:37 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org CF30C610CB Authentication-Results: mail.kernel.org; dmarc=pass (p=none dis=none) header.from=xenproject.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from list by lists.xenproject.org with outflank-mailman.106758.204134 (Exim 4.92) (envelope-from ) id 1lU9xl-0004de-US; Wed, 07 Apr 2021 15:19:25 +0000 X-Outflank-Mailman: Message body and most headers restored to incoming version Received: by outflank-mailman (output) from mailman id 106758.204134; Wed, 07 Apr 2021 15:19:25 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1lU9xl-0004dW-Qv; Wed, 07 Apr 2021 15:19:25 +0000 Received: by outflank-mailman (input) for mailman id 106758; Wed, 07 Apr 2021 15:19:24 +0000 Received: from mail.xenproject.org ([104.130.215.37]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1lU9xk-0004bs-GS for xen-devel@lists.xenproject.org; Wed, 07 Apr 2021 15:19:24 +0000 Received: from xenbits.xenproject.org ([104.239.192.120]) by mail.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1lU9xk-0007uo-Ea for xen-devel@lists.xenproject.org; Wed, 07 Apr 2021 15:19:24 +0000 Received: from iwj (helo=mariner.uk.xensource.com) by xenbits.xenproject.org with local-bsmtp (Exim 4.92) (envelope-from ) id 1lU9xk-000672-Cq for xen-devel@lists.xenproject.org; Wed, 07 Apr 2021 15:19:24 +0000 Received: from iwj by mariner.uk.xensource.com with local (Exim 4.89) (envelope-from ) id 1lU9xf-00052w-GE; Wed, 07 Apr 2021 16:19:19 +0100 X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=xenproject.org; s=20200302mail; h=References:In-Reply-To:Subject:Cc:To:Date :Message-ID:Content-Transfer-Encoding:Content-Type:MIME-Version:From; bh=GvpGue6hK6WrmBsnSv9fYunLo++JeTdS38KgxlgCwQg=; b=46+vTlPvBDg6DfU+G4/s5qbdfk lNqznKpe3erOISxB7GnNkKt0qlIjmIRdVD7OKm53mgK895BSRKyGnY9JATF/Xw3PTEjKVLdy1bECK zZ1fyJ30HFlez6g5In5lTdG6ayxpW4AWKrjcmp3/R6jZXDgPGGUqahKmyGQ1s8hDrEtk=; From: Ian Jackson MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Message-ID: <24685.52599.234444.705703@mariner.uk.xensource.com> Date: Wed, 7 Apr 2021 16:19:19 +0100 To: Luca Fancellu Cc: Julien Grall , xen-devel@lists.xenproject.org, Bertrand Marquis , wei.chen@arm.com, Andrew Cooper , George Dunlap , Jan Beulich , Stefano Stabellini , Wei Liu Subject: Re: [PATCH 3/3] docs/doxygen: doxygen documentation for grant_table.h In-Reply-To: <0F20064C-418C-4A4F-9883-4452A726B038@arm.com> References: <20210406103603.8530-1-luca.fancellu@arm.com> <20210406103603.8530-4-luca.fancellu@arm.com> <7f143615-acdf-5a97-5e07-57cab49031d6@xen.org> <0F20064C-418C-4A4F-9883-4452A726B038@arm.com> X-Mailer: VM 8.2.0b under 24.5.1 (i686-pc-linux-gnu) Luca Fancellu writes ("Re: [PATCH 3/3] docs/doxygen: doxygen documentation for grant_table.h"): > The problem is that Doxygen can’t generate proper documentation for anonymous union/structure, it ends up with warning and/or producing wrong documentation like > changing names or giving field description to the wrong field. This does not seem like it would be an impossibly hard feature to add to doxygen. Ian.