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 49091C63797 for ; Thu, 22 Jul 2021 17:10:15 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 319CB6101E for ; Thu, 22 Jul 2021 17:10:15 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233312AbhGVQ3j (ORCPT ); Thu, 22 Jul 2021 12:29:39 -0400 Received: from mail.netfilter.org ([217.70.188.207]:55484 "EHLO mail.netfilter.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231929AbhGVQ3i (ORCPT ); Thu, 22 Jul 2021 12:29:38 -0400 Received: from netfilter.org (unknown [78.30.10.20]) by mail.netfilter.org (Postfix) with ESMTPSA id A3E4D6429B; Thu, 22 Jul 2021 19:09:46 +0200 (CEST) Date: Thu, 22 Jul 2021 19:10:15 +0200 From: Pablo Neira Ayuso To: Duncan Roe Cc: netfilter-devel@vger.kernel.org Subject: Re: [PATCH RFC libnetfilter_queue 1/1] src: doc: supply missing SYNOPSIS in pktbuff man pages Message-ID: <20210722171015.GA12639@salvia> References: <20210629093837.GA23185@salvia> <20210717025350.24040-2-duncan_roe@optusnet.com.au> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20210717025350.24040-2-duncan_roe@optusnet.com.au> User-Agent: Mutt/1.10.1 (2018-07-13) Precedence: bulk List-ID: X-Mailing-List: netfilter-devel@vger.kernel.org On Sat, Jul 17, 2021 at 12:53:50PM +1000, Duncan Roe wrote: > Synopsis only has required headers, since doxygen already output the function > summary. HTML only has 2 small changes for better man page readability: > the Synopsis lines are manonly (had to do that to get SYNOPSIS over to cc 1). It's fine to add more specific "manonly" information. The existing autogenerated manpages are still a bit distant to usual Linux Programmer's Manual manpages at quick glance. Go ahead.