From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-io1-f66.google.com (mail-io1-f66.google.com [209.85.166.66]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 34b0f0a4 for ; Sat, 15 Jun 2019 21:40:08 -0500 (EST) Received: by mail-io1-f66.google.com with SMTP id e5so14143858iok.4 for ; Sat, 15 Jun 2019 19:40:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to; bh=g0GPjWhxm0zoGrN3qwQb3MfsUUbmYUpEqA71hQ2kG6w=; b=PS5piKxjM3q4Nmm4FoUodKPrwjxDqkmdpBqK0pGvEN3wfyA7+NnhQxHmTCIOxlSyCB EOk0KtRK1DD46ZbMyhZf+OhuIZLqof70g+yV01ZAGp9OxHba/+bXBToXb3i+OQHGbWNR me2oVe7w3GRFZDnlyaYLv+XpfquONIinNrhzWOWdd30Oeo6ZNM8nqyN9/v6RjIhEotft iV4I/LWa8EiNV8b/iTR5ZIUQKa3AtsTqIG+dUD97DhJ9WBp56P8bLfIEtGHW+DBqglLY vTS55HrG/KVvNibPegRK0l9A50IhyZL/WH7g4XpIzjQESQELtmyshMBAV+bLuKuXJ4EV 368w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to; bh=g0GPjWhxm0zoGrN3qwQb3MfsUUbmYUpEqA71hQ2kG6w=; b=ama7LttfhMY+FD6UE86iN1T48EDMgnlv1K0fh/6Zv/fjcygvzqgFGzUHDw7JnczCqh jp+6Lmp5KCfiy0cpcGLOLb5Md5LHPH+tbC57To76/5XsI7Nj6qUwd34TQQa0gV+pmB/o VA2yc23rvTRAcDQnMxlWzVRJNr6NEkXWKs7VSedqqthxSsR1+NmfoS240cYbdsdEB3xC uSlLPpGPeJkobYbyTa59nEMq0vMJT0XgcRnFa38dYTVw0EN81dfwtUeOl6/FJ77Tjsfj mmSOxZPqdje/qgrkEFDOyIY/6Rm3wBe33fmsJPCSAlYxPkZfnEJ+aD7dNJeL7buAs3O4 3F9Q== X-Gm-Message-State: APjAAAUA45A7JAcK2Db+zvEaJMOpduKSc1uEL9i8MC36JKmhjvZ+NUQT ex036IN0xhm5gmTRsRED7fZ3XCGF0c9s7OXlHN4Fvg== X-Google-Smtp-Source: APXvYqy/Q6afJNy0LQS59WHI7nm9Bwf35qNhWpREy7ZDMujKAV2zVihgn6t5jcgc9jiyj3OLo8RPKLBodNfP9RkVLcM= X-Received: by 2002:a02:710f:: with SMTP id n15mr10706322jac.119.1560652807439; Sat, 15 Jun 2019 19:40:07 -0700 (PDT) X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 References: <20190614084313.GA17405@www.stare.cz> <20190614085423.GC17405@www.stare.cz> <20190614122941.GB25099@athene.usta.de> <20190614142714.GA34987@www.stare.cz> <20190614145415.GE25099@athene.usta.de> In-Reply-To: <20190614145415.GE25099@athene.usta.de> From: Matthew Singletary Date: Sat, 15 Jun 2019 22:39:55 -0400 Message-ID: Subject: Re: Mandoc for oil To: discuss@mandoc.bsd.lv Content-Type: multipart/alternative; boundary="000000000000348c10058b67cc50" --000000000000348c10058b67cc50 Content-Type: text/plain; charset="UTF-8" All, I've got a first attempt at an updated man page for osh (the pull request is https://github.com/oilshell/oil/pull/337). Any feedback would be appreciated. But while I can start copying from the markdown notes that are being maintained by the main author, what's a normal/reasonable workflow for updating man pages? For example, are there any recommended ways to generate/keep up to date command line flags based upon source code, or is the convention to handle those by hand? Thanks, Matt On Fri, Jun 14, 2019 at 10:54 AM Ingo Schwarze wrote: > Hi Jan, > > Jan Stary wrote on Fri, Jun 14, 2019 at 04:27:14PM +0200: > > On Jun 14 14:29:41, schwarze@usta.de wrote: > > >> The following may or may not work, not sure though: > >> - SUN Solaris 10 and older > > > I can atest to Solaris 11.3 (SunOS 5.11) > > happily runing all recent releases of mandoc. > > While certainly true, that wasn't the question, though; > building and running mandoc works even on Solaris 9 (= SunOS 5.9) > and on AIX; not sure whether HP-UX was ever tested. > > The question was on which systems the native man(1) utility > might be unable to cope with manual pages in mdoc(7) format. > > According to my testing on the OpenCSW cluster, the native man(1) > does handle mdoc(7) input on Solaris 11.3, which is no surprise > because the manual page of Solaris 11.3 man(1) says: > > Source Format > Reference Manual pages are marked up with either nroff (see groff(1)) > or SGML (Standard Generalized Markup Language) tags (see sgml(5)). The > man command recognizes the type of markup and processes the file > accordingly. > > In contrast, it appears that Solaris 10 did not yet use groff by > default for manual page display. That's why is said that Solaris 10 > might still need versions of manual pages converted from mdoc(7) > to man(7). > > Yours, > Ingo > -- > To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv > > --000000000000348c10058b67cc50 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
All,
=C2=A0I've got a first attempt at = an updated man page for osh (the pull request is https://github.com/oilshell/oi= l/pull/337). Any feedback would be appreciated.
=C2=A0But whi= le I can start copying from the markdown notes that are being maintained by= the main author, what's a normal/reasonable workflow for updating man = pages?
=C2=A0For example, are there any recommended ways to = generate/keep up to date command line flags based upon source code, or is t= he convention to handle those by hand?

Thanks,
Matt
=C2=A0

On Fri, Jun 14, 2019 at 10:54 AM= Ingo Schwarze <sc= hwarze@usta.de> wrote:
Hi Jan,

Jan Stary wrote on Fri, Jun 14, 2019 at 04:27:14PM +0200:
> On Jun 14 14:29:41, schwarze@usta.de wrote:

>> The following may or may not work, not sure though:
>>=C2=A0 - SUN Solaris 10 and older

> I can atest to Solaris 11.3 (SunOS 5.11)
> happily runing all recent releases of mandoc.

While certainly true, that wasn't the question, though;
building and running mandoc works even on Solaris 9 (=3D SunOS 5.9)
and on AIX; not sure whether HP-UX was ever tested.

The question was on which systems the native man(1) utility
might be unable to cope with manual pages in mdoc(7) format.

According to my testing on the OpenCSW cluster, the native man(1)
does handle mdoc(7) input on Solaris 11.3, which is no surprise
because the manual page of Solaris 11.3 man(1) says:

=C2=A0 Source Format
=C2=A0 =C2=A0 Reference Manual pages are marked up with either nroff=C2=A0 = (see=C2=A0 groff(1))
=C2=A0 =C2=A0 or=C2=A0 SGML (Standard Generalized Markup Language) tags (se= e sgml(5)). The
=C2=A0 =C2=A0 man command recognizes the=C2=A0 type=C2=A0 of=C2=A0 markup= =C2=A0 and=C2=A0 processes=C2=A0 the=C2=A0 file
=C2=A0 =C2=A0 accordingly.

In contrast, it appears that Solaris 10 did not yet use groff by
default for manual page display.=C2=A0 That's why is said that Solaris = 10
might still need versions of manual pages converted from mdoc(7)
to man(7).

Yours,
=C2=A0 Ingo
--
=C2=A0To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv
--000000000000348c10058b67cc50-- -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv