From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.8 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham autolearn_force=no version=3.4.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id A021D7DE79 for ; Thu, 10 May 2018 13:16:05 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757258AbeEJNQE (ORCPT ); Thu, 10 May 2018 09:16:04 -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-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@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 -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html