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,T_RP_MATCHES_RCVD autolearn=unavailable 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 6DD5E7DD32 for ; Sat, 7 Apr 2018 19:19:32 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752034AbeDGTTO (ORCPT ); Sat, 7 Apr 2018 15:19:14 -0400 Received: from s3.sipsolutions.net ([144.76.63.242]:49224 "EHLO sipsolutions.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751591AbeDGTTN (ORCPT ); Sat, 7 Apr 2018 15:19:13 -0400 Received: by sipsolutions.net with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1f4tMe-0000o4-3w; Sat, 07 Apr 2018 21:19:04 +0200 Message-ID: <1523128743.6507.5.camel@sipsolutions.net> Subject: Re: make xmldocs failed with error after 4.17 merge period From: Johannes Berg To: Markus Heiser , Heikki Krogerus Cc: Greg KH , Masanari Iida , LKML , Linux Doc Mailing List , Jonathan Corbet , linux-usb@vger.kernel.org Date: Sat, 07 Apr 2018 21:19:03 +0200 In-Reply-To: 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> <20180406105139.GA28862@kuha.fi.intel.com> Content-Type: text/plain; charset="UTF-8" X-Mailer: Evolution 3.26.6 (3.26.6-1.fc27) Mime-Version: 1.0 Content-Transfer-Encoding: 7bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Fri, 2018-04-06 at 13:38 +0200, Markus Heiser wrote: > > Sorry, not yet. Johannes started a discussion about this. Its a long > time ago and I do not have any new ideas yet :/ see: > > https://www.mail-archive.com/linux-doc@vger.kernel.org/msg07035.html I still think the tools themselves don't matter all that much, as long as there aren't totally onerous requirements. I'd argue pretty much everything available on a modern distro would be OK provided we have a reasonable fallback (e.g. to ASCII as I had even written), along with some sort of documentation of dependencies, or perhaps better, some command line option to gather the info dynamically. But then again, I've already said pretty much this a year and a half ago and most people seemed more interested in some kind of purity argument than having better documentation :-) johannes -- 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: Johannes Berg Message-Id: <1523128743.6507.5.camel@sipsolutions.net> Date: Sat, 07 Apr 2018 21:19:03 +0200 To: Markus Heiser , Heikki Krogerus Cc: Greg KH , Masanari Iida , LKML , Linux Doc Mailing List , Jonathan Corbet , linux-usb@vger.kernel.org List-ID: T24gRnJpLCAyMDE4LTA0LTA2IGF0IDEzOjM4ICswMjAwLCBNYXJrdXMgSGVpc2VyIHdyb3RlOgo+ IAo+IFNvcnJ5LCBub3QgeWV0LiBKb2hhbm5lcyBzdGFydGVkIGEgZGlzY3Vzc2lvbiBhYm91dCB0 aGlzLiBJdHMgYSBsb25nCj4gdGltZSBhZ28gYW5kIEkgZG8gbm90IGhhdmUgYW55IG5ldyBpZGVh cyB5ZXQgOi8gc2VlOgo+IAo+ICAgaHR0cHM6Ly93d3cubWFpbC1hcmNoaXZlLmNvbS9saW51eC1k b2NAdmdlci5rZXJuZWwub3JnL21zZzA3MDM1Lmh0bWwKCkkgc3RpbGwgdGhpbmsgdGhlIHRvb2xz IHRoZW1zZWx2ZXMgZG9uJ3QgbWF0dGVyIGFsbCB0aGF0IG11Y2gsIGFzIGxvbmcKYXMgdGhlcmUg YXJlbid0IHRvdGFsbHkgb25lcm91cyByZXF1aXJlbWVudHMuIEknZCBhcmd1ZSBwcmV0dHkgbXVj aApldmVyeXRoaW5nIGF2YWlsYWJsZSBvbiBhIG1vZGVybiBkaXN0cm8gd291bGQgYmUgT0sgcHJv dmlkZWQgd2UgaGF2ZSBhCnJlYXNvbmFibGUgZmFsbGJhY2sgKGUuZy4gdG8gQVNDSUkgYXMgSSBo YWQgZXZlbiB3cml0dGVuKSwgYWxvbmcgd2l0aApzb21lIHNvcnQgb2YgZG9jdW1lbnRhdGlvbiBv ZiBkZXBlbmRlbmNpZXMsIG9yIHBlcmhhcHMgYmV0dGVyLCBzb21lCmNvbW1hbmQgbGluZSBvcHRp b24gdG8gZ2F0aGVyIHRoZSBpbmZvIGR5bmFtaWNhbGx5LgoKQnV0IHRoZW4gYWdhaW4sIEkndmUg YWxyZWFkeSBzYWlkIHByZXR0eSBtdWNoIHRoaXMgYSB5ZWFyIGFuZCBhIGhhbGYgYWdvCmFuZCBt b3N0IHBlb3BsZSBzZWVtZWQgbW9yZSBpbnRlcmVzdGVkIGluIHNvbWUga2luZCBvZiBwdXJpdHkg YXJndW1lbnQKdGhhbiBoYXZpbmcgYmV0dGVyIGRvY3VtZW50YXRpb24gOi0pCgpqb2hhbm5lcwot LS0KVG8gdW5zdWJzY3JpYmUgZnJvbSB0aGlzIGxpc3Q6IHNlbmQgdGhlIGxpbmUgInVuc3Vic2Ny aWJlIGxpbnV4LXVzYiIgaW4KdGhlIGJvZHkgb2YgYSBtZXNzYWdlIHRvIG1ham9yZG9tb0B2Z2Vy Lmtlcm5lbC5vcmcKTW9yZSBtYWpvcmRvbW8gaW5mbyBhdCAgaHR0cDovL3ZnZXIua2VybmVsLm9y Zy9tYWpvcmRvbW8taW5mby5odG1sCg== From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Google-Smtp-Source: AIpwx4//mySbG1DKMDd7ufngoP6m3ONfTMtVnqJO/F0jqXYra4hcDcgsCPC1fuCqaOVyWsr5/wO1 ARC-Seal: i=1; a=rsa-sha256; t=1523128746; cv=none; d=google.com; s=arc-20160816; b=Jo4m09AKEyanRpX4MVJBSv4xCh7c8/y+iA5/wS9Kr7/b2yFHQg7/O/QZjv62C9H5dC xJR7wlN7G4U1IsLMIo767YeQvgO0NM4TlNxMHKK5Qmx4IjjDF4Qeyqu6BLXwaqZB8Dtw e8E0hTc+oc6xknqfE8of6EMHxAzATAOs13Wd6LTDHmoHQ3UfvOF3Au+iKndRlB91iB9v KVn3toK6wLSwZIsr3bL49Dasw1V207lKv/j6hBRtja0CifwnZsxiHAKFuokxTmNdakLh kiJxBrcrfKVqn0SoQRQgUC1t9Uxy72vZVikM1rHmp/OSK+Ng5jdr917dF8bMhQwDK6kb t5EA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to:date :cc:to:from:subject:message-id:arc-authentication-results; bh=WkV6CzwBODBKw2NLXPKtU3pwPRkvz0FQwJun7H5i0T0=; b=XMOSSoyf0Jw5yq2wbkJrGrZ0MGQzlyh+QtnA2LBYg5Ns3Lq725L1TaN+Hv6a8kdQWj m9LhTaz084Hf6CDA8QQz1kgT4xa+fuih05pb7BvBI4PGX1Al0HPvm9g+FvfSFGyMVcxc NIEr81oEP3K6r6xnqzuep5m7BU5c3nDHkiTD0tA18XVelc7VrkcJtGTpha73qyJljIhJ PYQtsMwTTmPnb50Lq76KOtpZUjRTuNryL3TtZc0MmP5WzlNw6OytLHvyRxcQyPQKEC1l OLgfozbBvtqtnmiMjF6IYZKyRHPLbxN3WQNKkZrsFZ0WRFss2+LPwyAN2pNDsoaIePkQ qA1w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of johannes@sipsolutions.net designates 2a01:4f8:191:72ef::2 as permitted sender) smtp.mailfrom=johannes@sipsolutions.net Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of johannes@sipsolutions.net designates 2a01:4f8:191:72ef::2 as permitted sender) smtp.mailfrom=johannes@sipsolutions.net Message-ID: <1523128743.6507.5.camel@sipsolutions.net> Subject: Re: make xmldocs failed with error after 4.17 merge period From: Johannes Berg To: Markus Heiser , Heikki Krogerus Cc: Greg KH , Masanari Iida , LKML , Linux Doc Mailing List , Jonathan Corbet , linux-usb@vger.kernel.org Date: Sat, 07 Apr 2018 21:19:03 +0200 In-Reply-To: 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> <20180406105139.GA28862@kuha.fi.intel.com> Content-Type: text/plain; charset="UTF-8" X-Mailer: Evolution 3.26.6 (3.26.6-1.fc27) Mime-Version: 1.0 Content-Transfer-Encoding: 7bit X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: =?utf-8?q?1596966487828993292?= X-GMAIL-MSGID: =?utf-8?q?1597116248784027630?= X-Mailing-List: linux-kernel@vger.kernel.org List-ID: On Fri, 2018-04-06 at 13:38 +0200, Markus Heiser wrote: > > Sorry, not yet. Johannes started a discussion about this. Its a long > time ago and I do not have any new ideas yet :/ see: > > https://www.mail-archive.com/linux-doc@vger.kernel.org/msg07035.html I still think the tools themselves don't matter all that much, as long as there aren't totally onerous requirements. I'd argue pretty much everything available on a modern distro would be OK provided we have a reasonable fallback (e.g. to ASCII as I had even written), along with some sort of documentation of dependencies, or perhaps better, some command line option to gather the info dynamically. But then again, I've already said pretty much this a year and a half ago and most people seemed more interested in some kind of purity argument than having better documentation :-) johannes