From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-1.1 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 7859 invoked from network); 1 Sep 2020 06:38:18 -0000 Received: from alyss.skarnet.org (95.142.172.232) by inbox.vuxu.org with ESMTPUTF8; 1 Sep 2020 06:38:18 -0000 Received: (qmail 9613 invoked by uid 89); 1 Sep 2020 06:38:33 -0000 Mailing-List: contact supervision-help@list.skarnet.org; run by ezmlm Sender: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Received: (qmail 9606 invoked from network); 1 Sep 2020 06:38:33 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:date:to:subject:message-id:mail-followup-to:references :mime-version:content-disposition:in-reply-to; bh=x1xi+ZdNFd8PWBJtWauE8VbzxNA+oGI04BDVEvUYChI=; b=penqxf3GGv0PiqWQHwN9t4h7v9jpr++DK7nE8alri3tdPIapR7FUSCnsxeECwAJWmK Rhwt2VJv7ld6EdvTy8tKLMxBRjlhw8+oz2YlTaUMCFxJPKkxrIGTLIs9q/p3fZl6H/C3 gyTD4qpP9TGN5X//MNX6717CWJVhkIydTIIrx6M7prhtZO8tVxtiAIym+LtyAqouyj53 E43udtatMclQttGhgYMA1HBIjDjo77lzPD3doe9LHa0ozJHRBXZZql5WZowrP3srPu8F 7aAh5gqtadpJ1htDBKHBumP76JvdJsME9GY9vUUKtyS5rY7b5JFnqNjd8xyo2QhjgyAr ipQA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:date:to:subject:message-id:mail-followup-to :references:mime-version:content-disposition:in-reply-to; bh=x1xi+ZdNFd8PWBJtWauE8VbzxNA+oGI04BDVEvUYChI=; b=Guz2xJbb3T60BpmsJFGvtK8Xl6I86hEbFxAk9gfP3MWpPqueYT/jTJr93W0WFXrUXp HO7kWLvIsVh+XhoTuYx4BmoC29FlhZMD3k+5gYlsrnsX9ryC8w4lPVQkeoBh55asx2m8 1Okx1CpDDTwongn6oC2zPP9zzMEmyXvtRV785C2Xd3luiPwVzAmCJpcV/rUuACt9GAev VNeR4gbq08syMY+cPmpxUZxVJzdx4jt5R/2uDWAxNzVzfTlhddok/R3tlrg6ssjTfi9X kwiO6XpAMughize+E11G++QEkg0J/+AX/AQpgIA15fn9/nI+H9IvjneEFe14ZFz4g+8f StKQ== X-Gm-Message-State: AOAM531QONCz+oqzzQpA1dlLu4p8ep1JVZ5o+RXHtiFomhRR9ABeUCTe qlkppFrUo87Cr/MP0OPnV2GYKgpPYgI= X-Google-Smtp-Source: ABdhPJz0/m8i7UKug6MBpKDRUJwy5XUjcph4exhCfYtYInA8zAiMwLrRS1NHauDK9uVRbn7DIHY1nQ== X-Received: by 2002:adf:e407:: with SMTP id g7mr99179wrm.349.1598942285967; Mon, 31 Aug 2020 23:38:05 -0700 (PDT) From: "Casper Ti. Vector" X-Google-Original-From: "Casper Ti. Vector" Date: Tue, 1 Sep 2020 14:38:01 +0800 To: supervision@list.skarnet.org Subject: Re: [request for review] Port of s6 documentation to mdoc(7) Message-ID: <20200901063801.GA2158@CasperVector> Mail-Followup-To: supervision@list.skarnet.org References: <877dtgtu1z.fsf@ada> <20200831160811.6zqdbyjyzk4bembt@mail.imca-cat.org> <20200831191433.wbjh6wltyqhdv5hl@mail.imca-cat.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: On Mon, Aug 31, 2020 at 08:51:34PM +0000, Laurent Bercot wrote: > - Unless, of course, someone comes up with the perfect solution (adding > a DocBook dependency is not a perfect solution, and neither is > generating HTML from mandoc), in which case, obviously, they would have > the time and willingness to do all the necessary work themself, and in > doing so, actually meaningfully contribute to the community instead of > only adding their drop to the useless sea of It's Easy You Just Have To > Do This, Just Saying In Case You Had Not Considered. Sorry if this adds to your boredom in this subject, but I wonder whether you find the following acceptable: * We negotiate a HTML schema your documentation can be written in, which is based on current documentation; existing HTML documentation will be converted to the schema, with minimised changes. (The structuredness of HTML helps; now you also see why knowing some Lisp is beneficial :) * I provide a Python script that validates the schema (and also helps to convert existing documentation) of your HTML documentation, and transforms it into an IR suitable for downstream conversion. I am quite comfortable with writing code transformations, but it may take some time -- about 1 months in this case, since I have my daily job. * Those who are fluent in roff-related formats (I *do* like manpages, but I cannot write them, at least for now) write a program that transforms the IR into one pre-chosen format (we do not like multiple standards differing from each other subtlely, right?). This way, the changes to the current documentation will be minimised; the downside is a soft dependency on Python, which is only necessary when the amount of modification to the HTML is so big that you cannot manually compute corresponding modification to the manpages. -- My current OpenPGP key: RSA4096/0x227E8CAAB7AA186C (expires: 2022.09.20) 7077 7781 B859 5166 AE07 0286 227E 8CAA B7AA 186C