Received: by 10.192.165.148 with SMTP id m20csp1137335imm; Thu, 10 May 2018 06:16:56 -0700 (PDT) X-Google-Smtp-Source: AB8JxZoPq6nBCZeBciQdReoHtcc2H/0puN/fYFIm7w+AL649CyIFeqKZMMYbxNML3WVaBnB0/qo5 X-Received: by 2002:a63:6d82:: with SMTP id i124-v6mr1139513pgc.249.1525958215981; Thu, 10 May 2018 06:16:55 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1525958215; cv=none; d=google.com; s=arc-20160816; b=MFLLmIeEFKUHN+zsevgL2yKIwHmvumZ0lUxIeFMFRoTHksO+gvLA9W6lc8zSsXS3Jr HloSMtVtZNfGHWN9+n0eH6/VMFtQ0sHdroc2g98Wrxa68N3W4aOm6gZphNn7604MiC8C x39jnfukj4ogXXXc3Z5RKjHSxdzjLfiJy0tTColZtzDk+Vp9MZTDgexUNpbbTIk0AJ5A 9v8uRTvbfFkEFJfmMrIxzMh4c6Gi4GnxwmlxcDseXndoJiPWs8NfVRDVoS9+s/Jal5Cp J7/mkKueUZZsceX7ZoaMCkF7MKjKXpWazyIUanZMFj6UE5PmTK+ogFs9fVNUgaH3lgs/ /pNQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date:arc-authentication-results; bh=5O6JY8sQZQaxkplHrmbrPS5f49/k1kh3CI2p8k2laJU=; b=ujx8Al++Pg+U5P5vlcczXeD7FbJxnwOD2mqNBXx9clnbfBmCipvJIVnxLtNrLr4xq7 oAB7MZW1QnhUWdISAI2fIOy/GCPUHtnIELx9ej7BGmtv9ugEedSdAaL2aM1R1V0ku1PE 9yfskAIn++NL7wwUUj1uoP0zAP6q7m4yuNIM8cf6nfIB/IYsIjcSxSoYKabNp3DHtK9Y Kbh/Fo6+No4gJVQOTjZ7ubWfFyrLy46sPwNgR8oU4Tn9FVAhuo7o5MnCdRdWVCD49w9n iYEf9g/PH2SbqQHEPRWLi3ec+Xqq9BQ1Y6ZW5Iry4ST5IyuM5xUskDhVjtukFSoVzXpf HfhA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id a92-v6si769189pla.291.2018.05.10.06.16.41; Thu, 10 May 2018 06:16:55 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757307AbeEJNQF (ORCPT + 99 others); Thu, 10 May 2018 09:16:05 -0400 Received: from ms.lwn.net ([45.79.88.28]:56862 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757063AbeEJNQE (ORCPT ); Thu, 10 May 2018 09:16:04 -0400 Received: from localhost.localdomain (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 29FC9318; Thu, 10 May 2018 13:16:03 +0000 (UTC) Date: Thu, 10 May 2018 07:15:59 -0600 From: Jonathan Corbet To: Andrea Parri Cc: Peter Zijlstra , Mauro Carvalho Chehab , Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Ingo Molnar Subject: Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings Message-ID: <20180510071559.59dcc8cc@lwn.net> In-Reply-To: <20180510122335.GA7704@andrea> References: <6b9b3184cbfabab1ad89c974ddf1c61631e8f1bf.1525684985.git.mchehab+samsung@kernel.org> <20180509084120.GF12217@hirez.programming.kicks-ass.net> <20180509084518.247650e2@lwn.net> <20180510122335.GA7704@andrea> Organization: LWN.net X-Mailer: Claws Mail 3.15.1-dirty (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, 10 May 2018 14:23:35 +0200 Andrea Parri wrote: > only > remember that other people (including some developers running into the > "disadventure" of opening an RST doc. from their preferred text editor > and being brought to conclude: "WTH! I need to open a web browser, I > guess...") _use_ such doc. and _do care_ about it, and that what might > be an improvement for some people might look as "vandalizing" to others. If you have an example of a place where use of a web browser has been made mandatory, please point it out. Avoiding that was at the top of the list of explicit requirements. Surely an extra colon is not going to force you to run screaming to the protective embrace of Firefox...? Thanks, jon