From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp1.linuxfoundation.org (smtp1.linux-foundation.org [172.17.192.35]) by mail.linuxfoundation.org (Postfix) with ESMTPS id 6B6E28EB for ; Tue, 4 Aug 2015 13:50:56 +0000 (UTC) Received: from userp1040.oracle.com (userp1040.oracle.com [156.151.31.81]) by smtp1.linuxfoundation.org (Postfix) with ESMTPS id EAEBC1AD for ; Tue, 4 Aug 2015 13:50:55 +0000 (UTC) Date: Tue, 4 Aug 2015 16:50:44 +0300 From: Dan Carpenter To: Laurent Pinchart Message-ID: <20150804135044.GB5180@mwanda> References: <20150801164142.653012af@lwn.net> <1893963.CjFnBCekyb@vostro.rjw.lan> <20150803083311.5abd23f6@lwn.net> <6756795.jjv2YY7pQg@avalon> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <6756795.jjv2YY7pQg@avalon> Cc: ksummit-discuss@lists.linuxfoundation.org Subject: Re: [Ksummit-discuss] [CORE TOPIC] Documentation List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , If you write your documentation in docbook, I can promise you that I have never read it. I have all the tools to read it. I remember this because it requires 700MB of dependencies. I was downloading it to read the kdbus documentation. I remember this. I don't think I read the kdbus documentation in the end. I certainly don't know, without googling, how to use build the docbook output. Presumably, someone has a webpage with all the docs pre-built. I looked for your drm.pdf file on google. The first link was http://kernelnewbies.org/Documents/Kernel-Docbooks which has some pre-built docs but they are out of date. The next link was: http://billauer.co.il/blog/2014/02/docbook-html-pdf-rtf/ where the guy also can't figure out how to build his documention. It's like he actually wanted to read it (which is so rare) but he wasn't able to figure it out. regards, dan carpenter