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=-4.8 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, RCVD_IN_DNSWL_HI,T_RP_MATCHES_RCVD 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 4D72F7DD32 for ; Fri, 6 Apr 2018 10:51:45 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751570AbeDFKvo (ORCPT ); Fri, 6 Apr 2018 06:51:44 -0400 Received: from mga04.intel.com ([192.55.52.120]:4927 "EHLO mga04.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751434AbeDFKvn (ORCPT ); Fri, 6 Apr 2018 06:51:43 -0400 X-Amp-Result: UNKNOWN X-Amp-Original-Verdict: FILE UNKNOWN X-Amp-File-Uploaded: False Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 06 Apr 2018 03:51:43 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.48,415,1517904000"; d="scan'208";a="44609424" Received: from kuha.fi.intel.com ([10.237.72.189]) by fmsmga001.fm.intel.com with SMTP; 06 Apr 2018 03:51:40 -0700 Received: by kuha.fi.intel.com (sSMTP sendmail emulation); Fri, 06 Apr 2018 13:51:39 +0300 Date: Fri, 6 Apr 2018 13:51:39 +0300 From: Heikki Krogerus To: Markus Heiser Cc: Greg KH , Masanari Iida , linux-kernel@vger.kernel.org, Linux Doc Mailing List , Jonathan Corbet , linux-usb@vger.kernel.org Subject: Re: make xmldocs failed with error after 4.17 merge period Message-ID: <20180406105139.GA28862@kuha.fi.intel.com> References: <20180406075109.GA21589@kuha.fi.intel.com> <20180406075734.GA16728@kroah.com> <20180406081555.GB21589@kuha.fi.intel.com> <20180406083010.GA20174@kroah.com> <20180406091126.GC21589@kuha.fi.intel.com> <2A917B38-AFF6-44DC-A4A9-796B2BE560E2@darmarit.de> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <2A917B38-AFF6-44DC-A4A9-796B2BE560E2@darmarit.de> User-Agent: Mutt/1.9.2 (2017-12-15) Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Hi Markus, On Fri, Apr 06, 2018 at 12:03:55PM +0200, Markus Heiser wrote: > >> There are ways to do this, look at how the v4l2 and I think the drm > >> subsystems handle ascii art such that "real" drawings end up being > >> produced. > > > > Thanks. I did not actually find anything else except use of tables and > > code-blocks in v4l documentation. Is that what you were referring? > > If it is about *figures*: we have a directive named 'kernel-figure', > which is a full replacement of the 'figure' directive from Sphinx-Doc. > In addition it supports *inline* SVG and DOT markups. Read: > > https://www.kernel.org/doc/html/latest/doc-guide/sphinx.html#figures-images Thanks for the info. I don't want to use for example dot language in kernel documentation. I want to be able to clearly see the figure also from the plain text file. That's why I prefer ascii art. Isn't there a way we could render ascii art as svg diagram? Br, -- heikki -- 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 From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: make xmldocs failed with error after 4.17 merge period From: Heikki Krogerus Message-Id: <20180406105139.GA28862@kuha.fi.intel.com> Date: Fri, 6 Apr 2018 13:51:39 +0300 To: Markus Heiser Cc: Greg KH , Masanari Iida , linux-kernel@vger.kernel.org, Linux Doc Mailing List , Jonathan Corbet , linux-usb@vger.kernel.org List-ID: SGkgTWFya3VzLAoKT24gRnJpLCBBcHIgMDYsIDIwMTggYXQgMTI6MDM6NTVQTSArMDIwMCwgTWFy a3VzIEhlaXNlciB3cm90ZToKPiA+PiBUaGVyZSBhcmUgd2F5cyB0byBkbyB0aGlzLCBsb29rIGF0 IGhvdyB0aGUgdjRsMiBhbmQgSSB0aGluayB0aGUgZHJtCj4gPj4gc3Vic3lzdGVtcyBoYW5kbGUg YXNjaWkgYXJ0IHN1Y2ggdGhhdCAicmVhbCIgZHJhd2luZ3MgZW5kIHVwIGJlaW5nCj4gPj4gcHJv ZHVjZWQuCj4gPiAKPiA+IFRoYW5rcy4gSSBkaWQgbm90IGFjdHVhbGx5IGZpbmQgYW55dGhpbmcg ZWxzZSBleGNlcHQgdXNlIG9mIHRhYmxlcyBhbmQKPiA+IGNvZGUtYmxvY2tzIGluIHY0bCBkb2N1 bWVudGF0aW9uLiBJcyB0aGF0IHdoYXQgeW91IHdlcmUgcmVmZXJyaW5nPwo+IAo+IElmIGl0IGlz IGFib3V0ICpmaWd1cmVzKjogd2UgaGF2ZSBhIGRpcmVjdGl2ZSBuYW1lZCAna2VybmVsLWZpZ3Vy ZScsCj4gd2hpY2ggaXMgYSBmdWxsIHJlcGxhY2VtZW50IG9mIHRoZSAnZmlndXJlJyBkaXJlY3Rp dmUgZnJvbSBTcGhpbngtRG9jLgo+IEluIGFkZGl0aW9uIGl0IHN1cHBvcnRzICppbmxpbmUqIFNW RyBhbmQgRE9UIG1hcmt1cHMuIFJlYWQ6Cj4gCj4gIGh0dHBzOi8vd3d3Lmtlcm5lbC5vcmcvZG9j L2h0bWwvbGF0ZXN0L2RvYy1ndWlkZS9zcGhpbnguaHRtbCNmaWd1cmVzLWltYWdlcwoKVGhhbmtz IGZvciB0aGUgaW5mby4KCkkgZG9uJ3Qgd2FudCB0byB1c2UgZm9yIGV4YW1wbGUgZG90IGxhbmd1 YWdlIGluIGtlcm5lbCBkb2N1bWVudGF0aW9uLgpJIHdhbnQgdG8gYmUgYWJsZSB0byBjbGVhcmx5 IHNlZSB0aGUgZmlndXJlIGFsc28gZnJvbSB0aGUgcGxhaW4gdGV4dApmaWxlLiBUaGF0J3Mgd2h5 IEkgcHJlZmVyIGFzY2lpIGFydC4KCklzbid0IHRoZXJlIGEgd2F5IHdlIGNvdWxkIHJlbmRlciBh c2NpaSBhcnQgYXMgc3ZnIGRpYWdyYW0/CgoKQnIsCg== From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Google-Smtp-Source: AIpwx4/y1ESAGcfwbkvS+JgMNuAtD6cKV9VFpQkDGcfVGzvRbDYGgyemxCOc1HZRv+9a+yXmgRKn ARC-Seal: i=1; a=rsa-sha256; t=1523011904; cv=none; d=google.com; s=arc-20160816; b=dtN2Mc7SKUEnmCfEWH6eXfJCehLskFrxAsWL4LLnujUHiAZkrVNwo8LeSLFHRlNQHO NIv0bpyhgYg4U5VogKUcrK84ls+is4f9Svh2EHZweUlIn1imK6luBJB4Hvzox9bqnhqR SAplchZzg8r7ZtvlFtxwM8T7RzuseRebs6X8asdUbXNd1CI6hOkGVmHKDS/r74f3y9rp skocFL3s6LTwv93FWyF9oBwl4sgfUtZh7A95iuysUrVzI2uYUxzAm13a0FH57ZaZ27NJ bBHOHzSpM+mJJ0Lmhh3r4Wn4k8CgR8sKTYjr6JbkQHI0+0ZMMocR1RuofzUhu48WkQq/ Lftg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=user-agent:in-reply-to:content-disposition:mime-version:references :message-id:subject:cc:to:from:date:arc-authentication-results; bh=Af2gk7w9j3iU8FDWqlSpx2onvO374MwRLhNLGxtCOTI=; b=AsBzBBgWdctKC0TKmRUOhwg4T/5KZz7N3WRuIHn3+8h93y5tWIzt8qUouz77zdREsM N55ycZ07SRCX2VC/SiHkuOlwpmdO9WVNSVWo21Fh7EoEADTKT+1JGlOCyklucHsw/nBH xCNYvt3NBvmTH5MD/P+zHQPBqACHTQTzuN/1WxOdATKoWMz/EjCT9UE8ZuRz1Xo+2xdN HhjhI/Ndftirj7FNQQbDrdAhphoeQNJn+Q7VednR3paJ5BBbMvYtxW7YEDIppCgBWG2/ f3LBhY+Sg1cgm+6DbqEmbu7Q8FcCfy8IBtWVHpWY/ltXBsFRPKLAcOVQKfvi4LuXmxrX eDzw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of heikki.krogerus@linux.intel.com designates 192.55.52.136 as permitted sender) smtp.mailfrom=heikki.krogerus@linux.intel.com Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of heikki.krogerus@linux.intel.com designates 192.55.52.136 as permitted sender) smtp.mailfrom=heikki.krogerus@linux.intel.com X-Amp-Result: UNKNOWN X-Amp-Original-Verdict: FILE UNKNOWN X-Amp-File-Uploaded: False X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.48,415,1517904000"; d="scan'208";a="44609424" Date: Fri, 6 Apr 2018 13:51:39 +0300 From: Heikki Krogerus To: Markus Heiser Cc: Greg KH , Masanari Iida , linux-kernel@vger.kernel.org, Linux Doc Mailing List , Jonathan Corbet , linux-usb@vger.kernel.org Subject: Re: make xmldocs failed with error after 4.17 merge period Message-ID: <20180406105139.GA28862@kuha.fi.intel.com> References: <20180406075109.GA21589@kuha.fi.intel.com> <20180406075734.GA16728@kroah.com> <20180406081555.GB21589@kuha.fi.intel.com> <20180406083010.GA20174@kroah.com> <20180406091126.GC21589@kuha.fi.intel.com> <2A917B38-AFF6-44DC-A4A9-796B2BE560E2@darmarit.de> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <2A917B38-AFF6-44DC-A4A9-796B2BE560E2@darmarit.de> User-Agent: Mutt/1.9.2 (2017-12-15) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: =?utf-8?q?1596966487828993292?= X-GMAIL-MSGID: =?utf-8?q?1596993730593532249?= X-Mailing-List: linux-kernel@vger.kernel.org List-ID: Hi Markus, On Fri, Apr 06, 2018 at 12:03:55PM +0200, Markus Heiser wrote: > >> There are ways to do this, look at how the v4l2 and I think the drm > >> subsystems handle ascii art such that "real" drawings end up being > >> produced. > > > > Thanks. I did not actually find anything else except use of tables and > > code-blocks in v4l documentation. Is that what you were referring? > > If it is about *figures*: we have a directive named 'kernel-figure', > which is a full replacement of the 'figure' directive from Sphinx-Doc. > In addition it supports *inline* SVG and DOT markups. Read: > > https://www.kernel.org/doc/html/latest/doc-guide/sphinx.html#figures-images Thanks for the info. I don't want to use for example dot language in kernel documentation. I want to be able to clearly see the figure also from the plain text file. That's why I prefer ascii art. Isn't there a way we could render ascii art as svg diagram? Br, -- heikki