From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.sysutils.supervision.general/2756 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: "J. Lewis Muir" Newsgroups: gmane.comp.sysutils.supervision.general Subject: Re: runit patches to fix compiler warnings on RHEL 7 Date: Wed, 4 Dec 2019 15:32:03 -0600 Message-ID: <20191204213203.4sb5onelaoa6geu3@mink.imca.aps.anl.gov> References: <20191125214342.y7lx5mixrljr6s27@gromit.local> <20191127203307.ohaameqfgncm52h5@gromit.local> <20191129140901.klifpegc74iv4zul@klumpi.ignorelist.com> <80ab8f49-e61f-e236-395b-c3cb017391a9@ntlworld.com> <20191204164014.dnp7zmgfdt42ats4@mink.imca.aps.anl.gov> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="38630"; mail-complaints-to="usenet@blaine.gmane.org" Cc: "supervision@list.skarnet.org" To: Laurent Bercot Original-X-From: supervision-return-2345-gcsg-supervision=m.gmane.org@list.skarnet.org Wed Dec 04 22:32:09 2019 Return-path: Envelope-to: gcsg-supervision@m.gmane.org Original-Received: from alyss.skarnet.org ([95.142.172.232]) by blaine.gmane.org with smtp (Exim 4.89) (envelope-from ) id 1iccFk-0009oj-Ir for gcsg-supervision@m.gmane.org; Wed, 04 Dec 2019 22:32:08 +0100 Original-Received: (qmail 18577 invoked by uid 89); 4 Dec 2019 21:32:33 -0000 Mailing-List: contact supervision-help@list.skarnet.org; run by ezmlm Original-Sender: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Original-Received: (qmail 18570 invoked from network); 4 Dec 2019 21:32:32 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=imca-cat-org.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=1wmteN+hW034pOqmhTflncpCBjWc4QKIqgfDuo/uDPs=; b=gam0UNQn5fS139oG6f2YGLVLparextQvBB0r69CweuZ+YcT76CAsWjFpt6KuTdg1un 7/x2gr7TWC9U5ouDC8cefUUoad/9BVTxqEmtAnGe/xnFHZ3rgLDxDrcZM5J6v0dn5Lv6 IYeRjay9Ko0awsAZZLwRP1Or9Ea1qA6Gu8SfAhYLj55hXkRreNkwxYfswFp/bgoyiAMe KTW3LXiagLlPSu4XZBtMObdl/T4lXrea1fZz9bcglhJJM+mierfMlOyeWksNC9rVIswr /0fzdC7Asa01TmUCKXkO8aVBjPJquUz5fvAz6iFPb0mcEKQUsX1be1WBH1iFYXxybvub jOxA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=1wmteN+hW034pOqmhTflncpCBjWc4QKIqgfDuo/uDPs=; b=s+DKGhszYl63vdFg6sSPkclbqi0CUKAVLcHu0rTwRFld5IaG4aM0O1hDnzd1HgDm20 hnAvmFg9ldbkG1P9GPnJEjo83YTwCNmOksP8UoP6quZE7rtSiS9kk/j8Dt1sjoh9qokD UVrYIKm00yqj4OWu0DcIsO6K1Dk02Xv0XExMa507/UJgofFWW7fbqGYdvI5LjgvhIHwy 4IVv5RzkNkGVdn+BzRb9zt83cDjmK9A7Y88bGGENl37nLXFvUWYeliZfL5X0k+6bpI+j PbcpiY7PyuBPYsiDuxbDnY9YhfHBgSf5Efy0hx19knvE5y+TB5vZ4Fs0XJ45hSkj5O09 4x8A== X-Gm-Message-State: APjAAAWtAhfXZTSypCL9UYJdY6qX+olKKDVW1rOkhCI+7Qqt5tOQbNzV hWnJreehHgQXJjns7JLaycnNBA== X-Google-Smtp-Source: APXvYqw6IpvAM+kWdrjemVGIS60WOHVLPVSzOkfpzNm7Cn0eSQpWXmWZCez+87i768HCak90nchz3w== X-Received: by 2002:a25:4e0b:: with SMTP id c11mr3769071ybb.56.1575495125203; Wed, 04 Dec 2019 13:32:05 -0800 (PST) Content-Disposition: inline In-Reply-To: Xref: news.gmane.org gmane.comp.sysutils.supervision.general:2756 Archived-At: On 12/04, Laurent Bercot wrote: > > What about mandoc? > > The colour of this bikeshed is not up for debate. > > If you want man pages for skaware, provide me with: > 1. a reasonable source format (e.g. not roff, so mandoc is right out) > 2. a tool that can be built using *only* a C compiler (so as to keep > bootstrapping skaware easy), that converts the source format into man > pages *and* into HTML > 3. the actual contents of the man pages you want, in that source format. > > (https://git.sr.ht/~sircmpwn/scdoc fits 1. and 2., but its author wasn't > motivated enough to do 3.) Interesting, I hadn't heard of scdoc before. I don't see where it says it can convert the source format into HTML, though. Did I miss that? > Until then, any further discussion of documentation formats is pure > noise, I've heard it all before - several times - and it has the potential > to piss me off VERY quickly. Certainly don't want to cause trouble, and not intending to bikeshed, but I searched for "halibut" in the archive for this list as well as the skaware list and did not find that it had been mentioned, so I'll just mention that another system I've used in the past is Halibut which is lightweight and written in ANSI C: https://www.chiark.greenend.org.uk/~sgtatham/halibut/ It can generate ASCII, HTML, PDF, PostScript, man, and info. So, I think it would satisfy #1 and #2, but certainly not #3. Still, if someone wanted to do the work to provide #3 at some point, then Halibut may be a reasonable tool to consider. Lewis