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=-6.8 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,SPF_HELO_NONE, SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_2 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 1123CC4363D for ; Thu, 24 Sep 2020 16:47:54 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id BA3232396D for ; Thu, 24 Sep 2020 16:47:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1600966073; bh=DXiLMHL6N2+tW6apsxPze3MC/csk7rUk3NfNeQZtNPE=; h=Date:From:To:Cc:Subject:In-Reply-To:References:List-ID:From; b=JD7Eih6t/FDsxLNozuGs1srU4WWEQRBo4oPKsPRG/+1eu62IUfS8P713FCppode3v hDHGFbse0DKO+yrcmZad6gKjWGu3hlx2x6HO6EcaVNes8wTuEpnGgwDRKsjz0xaZkt pG0RWhdjAAP3pAVBbCz8gNIUT8H7uqagOvfdMEnA= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726915AbgIXQrx (ORCPT ); Thu, 24 Sep 2020 12:47:53 -0400 Received: from mail.kernel.org ([198.145.29.99]:51556 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726477AbgIXQrw (ORCPT ); Thu, 24 Sep 2020 12:47:52 -0400 Received: from coco.lan (ip5f5ad5c4.dynamic.kabel-deutschland.de [95.90.213.196]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 1250322208; Thu, 24 Sep 2020 16:47:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1600966072; bh=DXiLMHL6N2+tW6apsxPze3MC/csk7rUk3NfNeQZtNPE=; h=Date:From:To:Cc:Subject:In-Reply-To:References:From; b=RAgcFfEYT0gCnZKyGd5uCGgauEuasZzCZnrZCKOgPKvgIPrRfINviUHxByE9nwb/R ebUoMh9a8VE3hKViRNNhZI2Be7mPT9sYg/Fooyj+pogGZy7JQQRR81X5QSXsaPI/A0 DrJqAD9tSJ8RRul1SQMvBxjTllVL4L+QX4B+kRRc= Date: Thu, 24 Sep 2020 18:47:46 +0200 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Linux Doc Mailing List , Hans Verkuil , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: Re: [PATCH v2 2/5] media: docs: make CEC documents compatible with Sphinx 3.1+ Message-ID: <20200924184746.2ee13f1e@coco.lan> In-Reply-To: <20200924102516.5793f792@lwn.net> References: <4dce88f0cb555c79f71006bf9e62e209144762bb.1600963096.git.mchehab+huawei@kernel.org> <20200924102516.5793f792@lwn.net> X-Mailer: Claws Mail 3.17.6 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Em Thu, 24 Sep 2020 10:25:16 -0600 Jonathan Corbet escreveu: > On Thu, 24 Sep 2020 18:21:46 +0200 > Mauro Carvalho Chehab wrote: > > > -:c:func:`close() ` returns 0 on success. On error, -1 is returned, and > > +:c:func:`close()` returns 0 on success. On error, -1 is returned, and > > So while you're at it, it seems like all the :c:func: markups could come > out, right? Hmm... I guess not :-) I mean, we could rely on automarkup.py in order to automatically do that. However, right now automarkup skips the systemcalls/libc functions that this patchset touches: Skipfuncs = [ 'open', 'close', 'read', 'write', 'fcntl', 'mmap', 'select', 'poll', 'fork', 'execve', 'clone', 'ioctl', 'socket' ] One day, once namespace is set properly for all subsystems, we could drop Skipfunctions from automarkup and cleanup those manual markups, but for now this is still needed. Thanks, Mauro