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 26202 invoked from network); 2 Sep 2020 00:50:26 -0000 Received: from alyss.skarnet.org (95.142.172.232) by inbox.vuxu.org with ESMTPUTF8; 2 Sep 2020 00:50:25 -0000 Received: (qmail 32294 invoked by uid 89); 2 Sep 2020 00:50:47 -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 32287 invoked from network); 2 Sep 2020 00:50:47 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:subject:in-reply-to:date:message-id :mime-version; bh=kuE07/hlo2ngAwmubnA7q87jX+HW7D5Jx0ezpQuQm9Y=; b=QHueRLbXTukGD6rHy6gH/Fa77tAt/du5OFosy7zaIa3r5mEYiKepbwf7WWZ/nwm1D2 BRpxT4lWV0+QkEqoELjiDDSj4NV2IJyhGzhUKYNKT4EudkHL/ILze6e3iKE5hUCVsckg mpTzHGXTdnOp4JKNJaCU5LSfbreb2PsDYH1b98+4Qi72NIi7jNpsfupgxULBgqfdolrR UYNfcD7LFQvBbK+LOcDs0yrVvkA64qgRQHoKOxjic2IVLifQ3rR1S3puDbNzg8ncciCR vThadzYaiCR5CuX8p+x90N0Gw65maCGPawqYsU0zzYWZoDBmY8oN8xQjDxkd5juzxzeQ j1Bg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:subject :in-reply-to:date:message-id:mime-version; bh=kuE07/hlo2ngAwmubnA7q87jX+HW7D5Jx0ezpQuQm9Y=; b=QknF94abPkrDLuSvMD5tHmnDQ7SxrYx1eNj3c4QYASWNr2ypkHfmMMEwrfhRBJev9H fuOOX5YOOUXVkJHPoPsIrPZZ9ZrUPR8a/N/xeoGbKtfsA5atLxRJKmJua2Cg/LvjHRj/ 4odoFmjra/2BYhoYsyNvuVIMPPxFoEtXcfjsbE6kwrMbOPwQH8vWJCQAjkbESoM9KLnC jv6MGAHpnpVC2UxT+XnQC3J+rtCax+cXyC8LDq3TTJGn5mLzUWNrnCsurImoVvbV5/Ej oCNcBMXBogL5UoX87N9ArMRV8c3mtfTM1jM9gi7kW7yTbhF8Sjd6EC+wzwReWwuLhPTL rtmQ== X-Gm-Message-State: AOAM53276MupGMbU8dZ9e2gdWYY2uCWQtfWlnC2JZ3TrW5mpwKNWeeqt gKB73g9vHUOxEECQRQB8bcHcfJ4CgiM= X-Google-Smtp-Source: ABdhPJwebQVExyaoP+Z3HOlXwW/PH+HNnN4MIbfiEf+i2PjUAYSCMJaONZ3gGhllqGQk+HGr3MLZtw== X-Received: by 2002:a17:902:b715:: with SMTP id d21mr3749103pls.92.1599007819334; Tue, 01 Sep 2020 17:50:19 -0700 (PDT) References: <877dtgtu1z.fsf@ada> <20200831160811.6zqdbyjyzk4bembt@mail.imca-cat.org> <20200831191433.wbjh6wltyqhdv5hl@mail.imca-cat.org> <20200901063801.GA2158@CasperVector> <87d035yil3.fsf@ada> <20200901161327.6f215b86@mydesk.domain.cxm> User-agent: mu4e 1.4.13; emacs 27.1 From: Alexis To: supervision@list.skarnet.org Subject: Re: [request for review] Port of s6 documentation to mdoc(7) In-reply-to: <20200901161327.6f215b86@mydesk.domain.cxm> Date: Wed, 02 Sep 2020 10:50:15 +1000 Message-ID: <87v9gxvw6w.fsf@ada> MIME-Version: 1.0 Content-Type: text/plain; format=flowed Steve Litt writes: > Depends on how the HTML is written ... All I'm saying is don't > assume, > sight unseen, that the current HTML can't easily be converted to > semantic LaTeX or Docbook or whatever. This is good advice in general; but in this particular case, there's no "sight unseen" involved on my part. i have actually looked at the HTML sources of the existing s6 documentation. (For some context, i've authored HTML professionally myself.) As i indicated in the post to which you responded, as well as in my last post to this list: https://www.mail-archive.com/supervision@list.skarnet.org/msg02560.html the current HTML markup is basically not semantic, but presentationally-based. (i'm not complaining about this. i'm very grateful that Laurent has provided such comprehensive documentation for s6; many software authors provide far less, or suggest that the source is the end-user documentation. i feel s6 is a sufficiently important project that i'm happy to help out with documentation stuff, rather than putting further demands on Laurent's already-saturated bandwidth.) To be more specific regarding one of the points in my last post, here's an excerpt from s6-envuidgid.html: 
         s6-envuidgid [ -u | -g | -B ] [ -n ] [ -i | -D 
         uid:gid:gidlist ] 
         account prog...
Alexis.