From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753254AbcBKNqI (ORCPT ); Thu, 11 Feb 2016 08:46:08 -0500 Received: from mga02.intel.com ([134.134.136.20]:38860 "EHLO mga02.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752252AbcBKNqD (ORCPT ); Thu, 11 Feb 2016 08:46:03 -0500 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.22,431,1449561600"; d="scan'208";a="913082092" From: Jani Nikula To: Keith Packard , Jonathan Corbet Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Daniel Vetter Subject: Re: [RFC] A first shot at asciidoc-based formatted docs In-Reply-To: <861t8k2mro.fsf@hiro.keithp.com> Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: <1453764522-29030-1-git-send-email-corbet@lwn.net> <20160209170938.3a4b9fb1@lwn.net> <861t8k2mro.fsf@hiro.keithp.com> User-Agent: Notmuch/0.21+34~g7dd0d52 (http://notmuchmail.org) Emacs/24.4.1 (x86_64-pc-linux-gnu) Date: Thu, 11 Feb 2016 15:44:36 +0200 Message-ID: <87r3gjz7i3.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, 11 Feb 2016, Keith Packard wrote: > I think it should be pretty easy to hack asciidoc to add diversions to > hold TOC contents while generating the rest of the doc and then replay > the diversion into the final document. One of the chief complaints with the current pipeline (and some of the proposals) has been the need to install lots of tools with lots of dependencies. I would like to avoid the need to install bleeding edge tools and stick to what's already widely available in distros. Thus I would like to avoid hacking asciidoc for our needs. Also, I'd really like to not have to decide between asciidoc and asciidoctor, and only use features supported by both. Let the users pick which one suits them better. BR, Jani. -- Jani Nikula, Intel Open Source Technology Center