Received: by 10.223.176.5 with SMTP id f5csp679127wra; Fri, 9 Feb 2018 05:34:51 -0800 (PST) X-Google-Smtp-Source: AH8x227kSoKUwKYAJaEFIwkkwvm3xsUJqpOPwLfBIjMH6DWLtvpJ0D7C/qnAUCzwfIJazp1hIDqm X-Received: by 10.101.100.132 with SMTP id e4mr2334096pgv.398.1518183291784; Fri, 09 Feb 2018 05:34:51 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518183291; cv=none; d=google.com; s=arc-20160816; b=sOr5tyDOhBMiXdPWlBBpDrQJdK02absc+1wl/+8dK8BvPUCR1DEchcaPmeGiBE5rRx xd8RlEAjNjyFDqxBRXdAdYQqx7Ati3htwNoN6SqsdHlSk4X7xbY2ncjFfDt6lNZCCpIf Vf6h4XKa+5bhFmjMOZEd1UHjP/NEwUL9clgoHZyReIUIdH2pBvAby1IRAUXzNORaq/hs LZcFzPVciDfz5M+3042uWhI9CzlriL6Zdx6f5iTiqQ54G71NUs7yQ/kKTeCY8Hwri0Wv d4R7/+CI2PUcLHizaQbPEPzaFrbnpV9GruKPJQ3mO34qkeBJF44MYQDLkpa5O2/QLd4x +Law== 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=ptAGd1P4v749fGQ1jboNfyhlbn3juku/FGWzIM75bmU=; b=vm4RhWBTioK3kL+9SL5bF+1dB4I15kUJFig18MxZaRxgGGO5El1hVzyqrEO6XLPMoL pSMObIoiY2mG55ulhF0NuDLyLZ4UFCfBsWoBBVSvSjMTCcGHCXbBw58FO+hb2kD+DPzP o7raOJs1zX1TInrPa3JF7yi5kuDIcZdsmQJtGq6GIavVR15MxLWRN9XLMWTgzI97vT8h DQY74TrwouXmhRUDQQdV2T4GPzzV4qL2EX88kgBPDVU7wD+rDYf0BChwsk6BBg31n+dU UxDMSh77I1wjc2JWCBNb/ycQw5dYJWqvaSl5TCmEaz7BPPE2REcZ6178ngoJ/+FUV5XB FOYA== 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 187si477539pgh.536.2018.02.09.05.34.37; Fri, 09 Feb 2018 05:34:51 -0800 (PST) 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 S1751276AbeBINcg (ORCPT + 99 others); Fri, 9 Feb 2018 08:32:36 -0500 Received: from ms.lwn.net ([45.79.88.28]:59756 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750924AbeBINce (ORCPT ); Fri, 9 Feb 2018 08:32:34 -0500 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 9AAE12E7; Fri, 9 Feb 2018 13:32:33 +0000 (UTC) Date: Fri, 9 Feb 2018 06:32:31 -0700 From: Jonathan Corbet To: Jani Nikula Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, mchehab@kernel.org, me@tobin.cc Subject: Re: [PATCH 1/8] docs: kernel-doc: Get rid of xml_escape() and friends Message-ID: <20180209063231.349ad487@lwn.net> In-Reply-To: <87inb6a5rs.fsf@intel.com> References: <20180207172624.24555-1-corbet@lwn.net> <20180207172624.24555-2-corbet@lwn.net> <87inb6a5rs.fsf@intel.com> 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 Fri, 09 Feb 2018 11:09:27 +0200 Jani Nikula wrote: > On Wed, 07 Feb 2018, Jonathan Corbet wrote: > > XML escaping is a worry that came with DocBook, which we no longer have any > > dealings with. So get rid of the useless xml_escape()/xml_unescape() > > functions. No change to the generated output. > > I think this will break at least the -docbook output option, perhaps > also -html and -html5 options. If you think it's okay to break them, > would it not be better to just axe those off first? > > I guess this boils down to, is kernel-doc the script a general purpose > tool, or just a very specific part of the kernel documentation build > process? > > FWIW I think the latter, and why don't you throw docbook/html support > out already! See commit b05142675310 :) Thanks, jon