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 3870 invoked from network); 9 Sep 2020 13:13:09 -0000 Received: from alyss.skarnet.org (95.142.172.232) by inbox.vuxu.org with ESMTPUTF8; 9 Sep 2020 13:13:09 -0000 Received: (qmail 24077 invoked by uid 89); 9 Sep 2020 13:13:31 -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 24070 invoked from network); 9 Sep 2020 13:13:31 -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=UXPWiotHv6nSUcE03UVJywNFCHg8HbVooERGKIkbbsA=; b=Rt6qzAXFAWMNVbftw/xQUkhbJudSWooAdmiNYGIqXQ+10f41ukucVkZxoaJrdFg5de VWJtC2r/7XBwzxwjYwi1f+WSL4QhvAB8f04pZCDEGGS4TtOLlWNKlPcWTkMfDu6vpuTS xDSHzYU21YKmx5BvUnBY0jmN7tmyLr4o7qahS2LtLXiY3E07DFgRPawHaywZqJXpjB1W 6haMn5ruX0KQTGGIaV+MNvaK60pd+tsGJJTkEGSjdbJFs7FRT4szc/oJwUXMM4FVs2eI wyC5d6YbMiaemLQ5O/PqnujBmejy8n792x5bygOElt7bcy8pqNTwki9yD0PPKIR2BGbT mslg== 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=UXPWiotHv6nSUcE03UVJywNFCHg8HbVooERGKIkbbsA=; b=bdwjdkAcwbVDqU4KOoyHULgXHj6aVjH6ZzmtgJ9iarRS5Lj442QqLH56APbExfm3bn hspF36PlY20NHKcs4qr+DrZd7mMCsK5KsDfhZy49rzmueeG8BHipflJkHUTc5yo7qTEy zs6ujBEIP0nqjJdy0wG2H80SQaOocug5jSEV/pdBbN4b0bm4sEyD4H5J73MAXz7SaswR wjRmUzsLtM1dd/EgBQwLqdFWeeMega6see+Y4xiHDZBnlv4QDiRAwkdX2mqjTJp1dS2u shVbORFhK9+v4BvDcsfXrqDUEGIzSKwGefR9rrZ8aKxeDU2wroA9idDhuyYXDZf3jpoC BGTA== X-Gm-Message-State: AOAM531/Bw6DXieSqG5ZZlzKpWckmlvQ9OIsGVOEXkdJkXynWYeLEXa+ 7w3IS8mFvSeww1sobO29EWJR3mTzHm8= X-Google-Smtp-Source: ABdhPJxpYYE7PklklBd+eH9D7ttKT4oeCiMqPMTRDzN6ULQZQyXfredOXKz/b0fkqvsCTF/qtQEXmg== X-Received: by 2002:a17:90a:7ac1:: with SMTP id b1mr763355pjl.121.1599657183207; Wed, 09 Sep 2020 06:13:03 -0700 (PDT) References: <875z8nd1y5.fsf@ada> User-agent: mu4e 1.4.13; emacs 27.1 From: Alexis To: supervision@list.skarnet.org Subject: Re: s6-man-pages update In-reply-to: Date: Wed, 09 Sep 2020 23:12:59 +1000 Message-ID: <87tuw7ayas.fsf@ada> MIME-Version: 1.0 Content-Type: text/plain; format=flowed Laurent Bercot writes: > Nice work! If you feel they're ready enough, I can add a link > to them > in the s6 main page right away. Mm, thanks, but i think i'd prefer to wait until i've handled the link issue. :-) > - The skarnet.org site is accessible in https, and is > preferred. > Intra-site links have no default protocol, so they will link in > http > if the client uses http, and in https if the client uses https; > but > for absolute URLS, it would probably be best to write them as > https Sure, will do. > - You should list yourself in the AUTHORS section: I wrote the > content, > but you wrote the man pages. Okay, i'll mention myself as the porter. > I don't want to be making suggestions on work I'm not going to > do > myself and that I have no deep understanding of; but is there a > way to > have an alternative in .Xr, as in "print as a cross-ref if the > man > page exists, else print that text"? No, Xr only takes a manual name and section number as arguments. > That would be ideal for placeholders > until the documentation for other packages is ported (which may > very > well be "never"). Well, i'm willing to port the s6-networking and execline docs, unless the longer-term plan is to convert them to e.g. scdoc, since (having now looked into it) it's a very weak markup format that can't represent most of the semantic markup i'd be adding, including cross-references. No point doing work that is just going to be removed. :-) That said, for now i'll follow the footnote-style approach you suggested more generally, with numbered links to s6-networking and execline programs in the SEE ALSO section, and the appropriate number being mentioned inline. If/when the relevant man pages become available, conversion to use of Xr can be automated. > Yes, I don't think it's reasonable to expect the whole Web to > be > converted to man pages. ;) *laugh* Indeed! Alexis.