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.3 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_1 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 C883AC4338F for ; Sat, 24 Jul 2021 08:56:33 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id B192760E91 for ; Sat, 24 Jul 2021 08:56:33 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234914AbhGXIQA (ORCPT ); Sat, 24 Jul 2021 04:16:00 -0400 Received: from mail.netfilter.org ([217.70.188.207]:58370 "EHLO mail.netfilter.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234833AbhGXIQA (ORCPT ); Sat, 24 Jul 2021 04:16:00 -0400 Received: from netfilter.org (unknown [78.30.39.111]) by mail.netfilter.org (Postfix) with ESMTPSA id 109A7642A0 for ; Sat, 24 Jul 2021 10:56:03 +0200 (CEST) Date: Sat, 24 Jul 2021 10:56:33 +0200 From: Pablo Neira Ayuso To: Netfilter Development Subject: Re: [PATCH RFC libnetfilter_queue 1/1] src: doc: supply missing SYNOPSIS in pktbuff man pages Message-ID: <20210724085633.GA21304@salvia> References: <20210629093837.GA23185@salvia> <20210717025350.24040-2-duncan_roe@optusnet.com.au> <20210722171015.GA12639@salvia> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.10.1 (2018-07-13) Precedence: bulk List-ID: X-Mailing-List: netfilter-devel@vger.kernel.org On Sat, Jul 24, 2021 at 01:49:41PM +1000, Duncan Roe wrote: > On Thu, Jul 22, 2021 at 07:10:15PM +0200, Pablo Neira Ayuso wrote: > > The existing autogenerated manpages are still a bit distant to usual > > Linux Programmer's Manual manpages at quick glance. > > I guess doxygen-generated man pages will always be a little bit "distinctive". > > Looking carefully, I see a number of doxygen artefacts that can be > post-processed away. I mean: If you can achieve this via standard features available in doxygen to keep this maintainable along time, such as \manonly or such, then that's good. Otherwise, extending doxygen should be the way to keep it simple. I understand doxygen might generate a little but "distintive" output, that's OK. I'd rather not to add more dependencies on this. Thanks.