From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-io1-f47.google.com (mail-io1-f47.google.com [209.85.166.47]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id 9f0ff2d8 for ; Fri, 14 Jun 2019 03:16:30 -0500 (EST) Received: by mail-io1-f47.google.com with SMTP id k13so3917042iop.5 for ; Fri, 14 Jun 2019 01:16:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=xVkfg/aX+H73Lm1rDE2WsjrcQ/S8EA3SblDfcxkefb8=; b=ab2XCJenr5KxiJNsZ+poIdNRvribC/ZC4sRjMKVMgxeKhaPKiTc4QDXGCfqUFIPBXr c5v2bKeLsZIdt9GZeoeM0499NBW2JyXUFCL08I5AVZ2BCrkLdQ/Rr/Z/uG1w5CWH7spj WsY1Rgqt4Ro/0wto3bvHM+0Mwl4s0cC9R28JdsklSCid+jjJH1/a2fvL1LQ/JVUDc7VS a8EgjwTlhBCekrcNgpUUxVYQd/In3D3Q2QLvMFbHG4vAgAaMGP48idHxWJ2Esox8opCL er9kHbZyUxSbVVTR/hDkR+Ro2HuUzxnZG4lbdxFEoba7h5xh+yC892isKP4eYEJ/FFyw BJkw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=xVkfg/aX+H73Lm1rDE2WsjrcQ/S8EA3SblDfcxkefb8=; b=qInqlC/lApIql3Sz0wttqkeH8ArenLgqdE2TnJ655p+VVdu8G4hfKR3daaIJyyljF1 OVSzLUdF536YPq2cqnMcrLUQ8ysOg374NbRfTOLucl6sMx2R+U6sPLS4qQRtPR6Lsvil oBSGF27HFFYMdgwabc7gvPJB0GY9rS9Er6HQ3VHmHa/0P89kjXXyZDTkZTiZUEcmfybg a8d5/wd6WRGEYE+QAclNQnoHLI4slmAEHg3VWZR4Utjifiwn4XBvo1XxNCgedAYNa23h 7OkBFDQNfJH72KfM3kvOm5QpReCQM2UkUL39ZPv5Fe/iO/rjLeNkEtBmaeMtOwDzftSE YVpw== X-Gm-Message-State: APjAAAWFqWDleSPztcZsNUk0hLB7DjLUhO7JZ/CB38R0D+NDJfgl6aRn 2uuT6ilShqDFJQIJmlKHgJQ5F2zntNxkofkR6w8mP8Kc X-Google-Smtp-Source: APXvYqzNEl6g5kBi+ihHRsvNhFK9PdNGyHMF+vBOwSZQBXBDFiJGB1qywUGJMhM7HZKAtPmADLJ53uDbNGwHpRRn9t8= X-Received: by 2002:a5d:9d42:: with SMTP id k2mr35019428iok.45.1560500188742; Fri, 14 Jun 2019 01:16:28 -0700 (PDT) X-Mailinglist: mandoc-discuss Reply-To: discuss@mandoc.bsd.lv MIME-Version: 1.0 From: Matthew Singletary Date: Fri, 14 Jun 2019 04:16:17 -0400 Message-ID: Subject: Mandoc for oil To: discuss@mandoc.bsd.lv Content-Type: multipart/alternative; boundary="0000000000006c0c64058b4443e2" --0000000000006c0c64058b4443e2 Content-Type: text/plain; charset="UTF-8" After seeing mandoc mentioned in the past, I thought I would look into writing a man page for the Oil shell (http://www.oilshell.org/). I've never written a man page before but thought I'd try to use some decent tools to start with. I'm a little confused about distribution/workflow for distributing man pages (in general). If osh.1 is an mdoc flavored file, would that be used (with mandoc -T man) to output a man page that could then be setup when Osh is installed? Then how do you distinguish those? Oil uses autoconf for some things, would that get tied into generating/installing the man pages on the manpath? Sorry if these are dumb questions, but I'm not even sure what kind of documentation I need to look through yet. Thanks, Matt --0000000000006c0c64058b4443e2 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
After seeing mandoc mentioned in the past, I thought = I would look into writing a man page for the Oil shell (http://www.oilshell.org/). I've never written a m= an page before but thought I'd try to use some decent tools to start wi= th.

I'm a little confused about distributi= on/workflow for distributing man pages (in general). If osh.1 is an mdoc fl= avored file, would that be used (with mandoc -T man) to output a man page t= hat could then be setup when Osh is installed? Then how do you distinguish = those? Oil uses autoconf for some things, would that get tied into generati= ng/installing the man pages on the manpath?

Sorry = if these are dumb questions, but I'm not even sure what kind of documen= tation I need to look through yet.

Thanks,
Matt
--0000000000006c0c64058b4443e2-- -- To unsubscribe send an email to discuss+unsubscribe@mandoc.bsd.lv