Re: man 9 intro - improvements [and learning for me]?

2023-09-18 Thread Jason McIntyre
On Mon, Sep 18, 2023 at 12:21:48PM +, Christoff Humphries wrote: > Greetings all. > > I went searching for documentation about the kernel internals and was > used to the intro(9) man page from NetBSD > https://man.netbsd.org/intro.9 that had a lot more details. Would it > be a worthwhile

Re: msyscall.2: Use .Fn instead of .Nm in DESCRIPTION

2023-09-14 Thread Jason McIntyre
On Thu, Sep 14, 2023 at 12:00:03PM -0400, Josiah Frentsos wrote: > Index: msyscall.2 > === > RCS file: /cvs/src/lib/libc/sys/msyscall.2,v > retrieving revision 1.2 > diff -u -p -r1.2 msyscall.2 > --- msyscall.227 Nov 2019

Re: recv.2: Remove an extra space in the formatted output

2023-08-16 Thread Jason McIntyre
On Wed, Aug 16, 2023 at 06:44:34PM -0400, Josiah Frentsos wrote: > Index: lib/libc/sys/recv.2 > === > RCS file: /cvs/src/lib/libc/sys/recv.2,v > retrieving revision 1.50 > diff -u -p -r1.50 recv.2 > --- lib/libc/sys/recv.2 9 Sep

Re: cksum.1: use imperative tense

2023-08-16 Thread Jason McIntyre
On Wed, Aug 16, 2023 at 08:29:23PM -0700, patrick keshishian wrote: > On Wed, Aug 16, 2023 at 7:02???PM Klemens Nanni wrote: > > > > Consistent with other options and our manuals in general. > > > > Index: cksum.1 > > === > > RCS

Re: httpd server "default" is not what I expected

2023-08-13 Thread Jason McIntyre
On Sun, Aug 13, 2023 at 11:21:39AM +0100, Stuart Henderson wrote: > On 2023/08/13 11:13, Omar Polo wrote: > > @@ -179,7 +179,8 @@ section starts with a declaration of the server > > Each > > .Ic server > > section starts with a declaration of the server > > -.Ar name : > > +.Ar name . > > +If

Re: httpd server "default" is not what I expected

2023-08-13 Thread Jason McIntyre
On Sun, Aug 13, 2023 at 11:13:28AM +0200, Omar Polo wrote: > [moving to tech@, there's a diff for the manpage below] > hi. comments inline: > > diff /usr/src > commit - a7b17fe845fceeb2940fa5924ec5843681aa2c64 > path + /usr/src > blob - 16b086a9ee00cd6d8e796a890e9774968556f147 > file +

Re: add extract example to tar(1) man page

2023-08-03 Thread Jason McIntyre
ok! jmc On 3 August 2023 17:16:44 BST, aisha wrote: >On 23/08/03 04:26PM, Jason McIntyre wrote: >> On Thu, Aug 03, 2023 at 11:05:16AM -0400, aisha wrote: >> > On 23/08/03 10:51AM, aisha wrote: >> > > On 23/08/03 09:45AM, Stuart Henderson wrote: >> > > &

Re: add extract example to tar(1) man page

2023-08-03 Thread Jason McIntyre
On Thu, Aug 03, 2023 at 11:05:16AM -0400, aisha wrote: > On 23/08/03 10:51AM, aisha wrote: > > On 23/08/03 09:45AM, Stuart Henderson wrote: > > > On 2023/08/03 07:23, Jason McIntyre wrote: > > > > On Wed, Aug 02, 2023 at 05:52:02PM -0400, aisha wrote: > > &

Re: add extract example to tar(1) man page

2023-08-03 Thread Jason McIntyre
On Wed, Aug 02, 2023 at 05:52:02PM -0400, aisha wrote: > Hi, > Someone - https://www.youtube.com/watch?v=NQ5uD5x8vzg - mentioned that our > man page for tar(1) doesn't have an extract example, so I thought it would be > good to add a simple one which highlights a common use case. > > OK? >

Re: ualarm.3: cleanup, rewrites

2023-07-30 Thread Jason McIntyre
On Sun, Jul 30, 2023 at 08:20:31PM -0500, Scott Cheloha wrote: > This patch drags ualarm.3 over to where alarm.3 is. I think it reads > better and the wording is truer to what the function actually does. > In particular, ualarm(3) does not block or "wait": the alarm is > scheduled for

Re: refcnt_init(9): Add missing word

2023-07-12 Thread Jason McIntyre
On Wed, Jul 12, 2023 at 12:19:40PM +0200, thib4711 wrote: > diff --git a/share/man/man9/refcnt_init.9 b/share/man/man9/refcnt_init.9 > index 96fa94e7e64..142c1e57d8d 100644 > --- a/share/man/man9/refcnt_init.9 > +++ b/share/man/man9/refcnt_init.9 > @@ -71,7 +71,7 @@ is used to release an existing

Re: pf(4) should mention DIOCXEND

2023-07-05 Thread Jason McIntyre
On Wed, Jul 05, 2023 at 11:10:11AM +0200, Alexandr Nedvedicky wrote: > diff --git a/share/man/man4/pf.4 b/share/man/man4/pf.4 > index 92eeb45f657..7346c7e3194 100644 > --- a/share/man/man4/pf.4 > +++ b/share/man/man4/pf.4 > @@ -48,12 +48,25 @@ and retrieve statistics. > The most commonly used

Re: pf(4) should mention DIOCXEND

2023-07-04 Thread Jason McIntyre
On Tue, Jul 04, 2023 at 04:35:23PM +0200, Alexandr Nedvedicky wrote: > Hello, > > diff below updates pf(4) manpage to reflect changes [1] which > were committed earlier today. > > does update to pf(4) read OK? > > thanks and > regards > sashan > > [1]

Re: wsmouse(4): multi-touch buttons again

2023-06-27 Thread Jason McIntyre
On Wed, Jun 28, 2023 at 12:03:41AM +0200, Ulf Brosziewski wrote: > This version of the diff adds a wsconsctl field, named "mouse.tp. > mtbuttons", and an update to the wsmouse.4 page. Apart from that, it > contains only stylistic changes. > > The new wsconsctl field is just a boolean, I don't

Re: posix_spawn(3): explain that handling NULL envp is an extension

2023-06-26 Thread Jason McIntyre
On Sun, Jun 25, 2023 at 07:07:33PM -0300, Lucas de Sena wrote: > The manual already describes how posix_spawn(3) behaves when passing it > a NULL envp, but does not make it clear that it is an OpenBSD extension: > > > If envp is NULL, the environment is passed unchanged from the parent > >

Re: lpd(8): document correct control character for DVI

2023-06-17 Thread Jason McIntyre
On Tue, Jun 13, 2023 at 06:02:01PM +, Lennart Jablonka wrote: > r is for FORTRAN output, not for DVI. > fixed, thanks. jmc > Index: lpd.8 > === > RCS file: /cvs/src/usr.sbin/lpr/lpd/lpd.8,v > retrieving revision 1.32 > diff -u

Re: fix markup in glob(7)

2023-05-29 Thread Jason McIntyre
On Tue, May 30, 2023 at 12:06:37AM -0400, aisha wrote: > Hi, > > Was teaching glob(7) syntax to my brother and noticed that the markup for > [...] character classes was broken in HTML format from mandoc. Attached patch > renders the correct HTML. > > Sidenote, mdoc(7) says 'Li' is deprecated

Re: calendar.usholiday: add Juneteenth

2023-05-15 Thread Jason McIntyre
ok. jmc On 15 May 2023 09:58:29 BST, "Anthony J. Bentley" wrote: >A federal holiday since 2021. > >ok? > >Index: usr.bin/calendar/calendars/calendar.usholiday >=== >RCS file: /cvs/src/usr.bin/calendar/calendars/calendar.usholiday,v

Re: Updated virtio.4 man page with viogpu device

2023-04-26 Thread Jason McIntyre
On Wed, Apr 26, 2023 at 07:32:07PM +, Eichert, Diana wrote: > Based on this commit, https://marc.info/?l=openbsd-cvs=168201887006175=2 > , add viogpu, a VirtIO GPU driver > > Updated virtio.4 man page with viogpu device > > diff -c virtio.4.orig virtio.4 > > fixed, thanks. jmc > ***

Re: mg.1: mark up commands

2023-04-25 Thread Jason McIntyre
On Tue, Apr 25, 2023 at 03:58:08PM +0200, Omar Polo wrote: > The commands are sometimes typed as-is, sometimes in single quotes > 'like-this' and sometime inside Dq. I'd prefer to consistently use Ic > for commands (which I believe is the appropriate mandoc macro). As a > by-product, this allows

Re: chilepeso in units(1)

2023-04-12 Thread Jason McIntyre
On Wed, Apr 12, 2023 at 12:33:52PM +0200, Jan Stary wrote: > An apparent typo was introduced in > http://cvsweb.openbsd.org/cgi-bin/cvsweb/src/usr.bin/units/units.lib.diff?r1=1.144=1.145=h > > Does nobody use units(1) on their Chilean vacation anymore? > > Jan > oops, that's one of mine.

Re: route.8: markup route flags to get tags

2023-04-05 Thread Jason McIntyre
On Wed, Apr 05, 2023 at 10:20:40PM +0200, Ingo Schwarze wrote: > Hi Klemens and Jason, > hi. > Jason McIntyre wrote on Wed, Apr 05, 2023 at 07:12:05PM +0100: > > On Wed, Apr 05, 2023 at 01:07:18PM +, Klemens Nanni wrote: > > >> To find out what a particular le

Re: route.8: markup route flags to get tags

2023-04-05 Thread Jason McIntyre
On Wed, Apr 05, 2023 at 01:07:18PM +, Klemens Nanni wrote: > To find out what a particular letter means, you must arrive at this list > why generic means because the first column has no markup. > > As mdoc(7) 'constant symbol' the lookup is much quicker, e.g. > man -Otag=h route > makes

Re: tc_init.9: misc. cleanup

2023-03-29 Thread Jason McIntyre
On Tue, Mar 28, 2023 at 07:26:56PM -0500, Scott Cheloha wrote: > I would like to spruce up this manpage. > > - Try to describe what kern_tc.c does more completely and a bit > more plainly. > > - Mention *all* the requirements. Try to describe the rollover > margin in plainer language. > >

Re: route.8: add back command tags

2023-03-07 Thread Jason McIntyre
my fault. please fix as needed. thanks, jmc On 7 March 2023 09:22:31 GMT, Klemens Nanni wrote: >http://man.openbsd.org/OpenBSD-7.2./route.8#add jumps to `add's definition, >http://man.openbsd.org/OpenBSD-current/route.8#add does not. > >Probably lost in the recent reshuffle. >Restore ":t add",

Re: aucat -> sndiod in intro(3) manual page

2023-02-20 Thread Jason McIntyre
On Mon, Feb 20, 2023 at 02:36:10PM +0100, David Demelier wrote: > Hi, > > Just fix sndiod reference rather than aucat to sio_open in intro(3). > fixed, thanks. jmc > Index: share/man/man3/intro.3 > === > RCS file:

Re: pinsyscall.2: Add a missing period

2023-02-18 Thread Jason McIntyre
On Sat, Feb 18, 2023 at 08:25:48AM -0500, Josiah Frentsos wrote: > Index: pinsyscall.2 > === > RCS file: /cvs/src/lib/libc/sys/pinsyscall.2,v > retrieving revision 1.1 > diff -u -p -r1.1 pinsyscall.2 > --- pinsyscall.2 16 Feb

Re: sem_*.3: Use Xr where appropriate

2023-02-11 Thread Jason McIntyre
On Sat, Feb 11, 2023 at 10:00:15AM -0500, Josiah Frentsos wrote: > Index: sem_destroy.3 > === committed these, thanks. jmc > RCS file: /cvs/src/lib/libpthread/man/sem_destroy.3,v > retrieving revision 1.6 > diff -u -p -r1.6

Re: rdsetroot.8: sync synopsis with usage, improve wording

2023-01-20 Thread Jason McIntyre
ok by me. jmc On 20 January 2023 17:00:37 GMT, Klemens Nanni wrote: >Alright, sorry for the noise. > >Is this minimal sync plus stdout mention fine? > >Index: rdsetroot.8 >=== >RCS file: /cvs/src/usr.sbin/rdsetroot/rdsetroot.8,v

Re: rdsetroot.8: sync synopsis with usage, improve wording

2023-01-20 Thread Jason McIntyre
On Fri, Jan 20, 2023 at 12:35:05PM +, Klemens Nanni wrote: > 19.01.2023 19:11, Jason McIntyre ??: > > On Thu, Jan 19, 2023 at 06:50:14PM +, Klemens Nanni wrote: > >>$ man -h rdsetroot > >>rdsetroot [-dx] kernel [disk.fs] > >> vs. > >

Re: rdsetroot.8: sync synopsis with usage, improve wording

2023-01-19 Thread Jason McIntyre
On Thu, Jan 19, 2023 at 06:50:14PM +, Klemens Nanni wrote: > $ man -h rdsetroot > rdsetroot [-dx] kernel [disk.fs] > vs. > $ rdsetroot > usage: rdsetroot [-dx] bsd [fs] > i have to say i think the man page has better argument names, but i've nothing against your

Re: make: arguments can have multiple variable assignments

2023-01-17 Thread Jason McIntyre
yep, ok by me. jmc On 17 January 2023 12:03:58 GMT, Klemens Nanni wrote: >17.01.2023 06:44, Jason McIntyre пишет: >> seems correct. posix spec shows "..." too. > >Right, I didn't dig that up yet. > >In that case: OK? >

Re: remove elansc(4)

2023-01-16 Thread Jason McIntyre
On Tue, Jan 17, 2023 at 04:12:10PM +1100, Jonathan Gray wrote: > AMD Elan SC520 (found on soekris net45xx) has a 486 class processor > We require at least a 586/pentium class processor > if you do, there's a little cleanup: /usr/src/share/man/man4/gpio.4:.Cd "gpio* at elansc?" Pq i386

Re: make: arguments can have multiple variable assignments

2023-01-16 Thread Jason McIntyre
On Mon, Jan 16, 2023 at 10:03:03PM +, Klemens Nanni wrote: > SYNOPSIS and usage say [NAME=value] while multiple assigments are fine: > > $ make -p FOO=1 BAR=2 | grep -e^FOO -e^BAR > BAR = 2 > FOO = 1 > > I'm sure ports(7) wouldn't work if only one

Re: Suggested change to ports.7 man page

2023-01-04 Thread Jason McIntyre
quent invocations of make" in the >section showing how to work with flavours. >-- thanks, stuart. i won;t pursue this any further. jmc > Sent from a phone, apologies for poor formatting. > On 4 January 2023 07:28:39 Jason McIntyre wrote: > >On Mon, Jan 0

Re: grep.1: Use Fl for -print0

2023-01-03 Thread Jason McIntyre
On Tue, Jan 03, 2023 at 11:55:34AM -0500, Josiah Frentsos wrote: > Index: grep.1 > === > RCS file: /cvs/src/usr.bin/grep/grep.1,v > retrieving revision 1.51 > diff -u -p -r1.51 grep.1 > --- grep.126 Jun 2022 10:57:36 -

Re: [PATCH v3 3/3] script(1): fix exit status wording

2023-01-03 Thread Jason McIntyre
On Tue, Jan 03, 2023 at 03:57:20PM +0100, ?? wrote: > --- > Resend after a year; clean rebase. Keep me in CC. > > Failure-of-script status unchanged at 1 after complaints for v2. > > usr.bin/script/script.1 | 6 ++ > 1 file changed, 2 insertions(+), 4 deletions(-) > > diff --git

Re: Suggested change to ports.7 man page

2023-01-03 Thread Jason McIntyre
On Mon, Jan 02, 2023 at 07:00:27AM -0500, Jon Fineman wrote: > I was trying to make clean a port I was updating and it wasn't clear > to me that I should be adding the FLAVOR variable to the make line to > clean the correct build. > > My suggested change below might help other people. > > Jon

Re: df.1: document that -P disables BLOCKSIZE

2022-12-31 Thread Jason McIntyre
On Sat, Dec 31, 2022 at 02:32:30PM -0700, Todd C. Miller wrote: > Updated version. I kept "The BLOCKSIZE environment variable" in > the -P description since it is the first time the man page metions > BLOCKSIZE. > > - todd > certainly ok by me. jmc > Index: bin/df/df.1 >

Re: [v3] timeout.9: document missing interfaces, miscellaneous rewrites

2022-12-31 Thread Jason McIntyre
On Sat, Dec 31, 2022 at 11:22:22AM -0500, Scott Cheloha wrote: > mvs@ is nudging me to realign the timeout.9 page with the state of the > kernel. > > Here is my rewrite (again). > i'm losing track of what i'm reviewing! maybe just put it in and we can adjust it as needed, if needed. ok jmc

Re: df.1: document that -P disables BLOCKSIZE

2022-12-31 Thread Jason McIntyre
On Sat, Dec 31, 2022 at 10:54:27AM -0700, Todd C. Miller wrote: > In POSIX mode, df(1) does not honor the BLOCKSIZE environment > variable. > > Any comments on the wording? > > - todd > hi > Index: bin/df/df.1 > === > RCS file:

Re: [patch(es)] fix a few typos in /src

2022-12-28 Thread Jason McIntyre
On Fri, Dec 23, 2022 at 10:33:43AM -0500, Paul Tagliamonte wrote: i've finished with this diff. the usr.sbin parts i didn;t take are listed below, along with any explanation. jmc Index: usr.sbin/smtpd/crypto.c === RCS file:

Re: [patch(es)] fix a few typos in /src

2022-12-27 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 10:49:06PM -0500, Paul Tagliamonte wrote: > > Updated patch attached with your feedback, thank you Crystal > i've committed the bits of this that i though correct. i'll note below anything rejected from the /lib parts. i've finished with this diff now. jmc > Index:

Re: [patch(es)] fix a few typos in /src

2022-12-27 Thread Jason McIntyre
On Fri, Dec 23, 2022 at 10:33:43AM -0500, Paul Tagliamonte wrote: > On Fri, Dec 23, 2022 at 03:03:15PM +, Stuart Henderson wrote: > > > A bunch of the files in your diff come from external upstream sources > > which are still synced from upstream (or at least should be); patching > > in the

Re: [patch(es)] fix a few typos in /src

2022-12-26 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 10:49:06PM -0500, Paul Tagliamonte wrote: > Index: include/tib.h > === > RCS file: /cvs/src/include/tib.h,v > retrieving revision 1.8 > diff -u -p -r1.8 tib.h > --- include/tib.h 14 Jul 2020 16:48:13 -

Re: [patch(es)] fix a few typos in /src

2022-12-26 Thread Jason McIntyre
On Fri, Dec 23, 2022 at 10:33:43AM -0500, Paul Tagliamonte wrote: > Index: usr.bin/mg/search.c > === > RCS file: /cvs/src/usr.bin/mg/search.c,v > retrieving revision 1.48 > diff -u -p -r1.48 search.c > --- usr.bin/mg/search.c 20

Re: [patch(es)] fix a few typos in /src

2022-12-26 Thread Jason McIntyre
On Fri, Dec 23, 2022 at 10:33:43AM -0500, Paul Tagliamonte wrote: > Index: usr.bin/make/arch.c > === > RCS file: /cvs/src/usr.bin/make/arch.c,v > retrieving revision 1.91 > diff -u -p -r1.91 arch.c > --- usr.bin/make/arch.c 13

Re: [patch(es)] fix a few typos in /src

2022-12-26 Thread Jason McIntyre
On Fri, Dec 23, 2022 at 10:33:43AM -0500, Paul Tagliamonte wrote: > Index: usr.bin/find/function.c > === > RCS file: /cvs/src/usr.bin/find/function.c,v > retrieving revision 1.50 > diff -u -p -r1.50 function.c > ---

Re: [patch(es)] fix a few typos in /src

2022-12-26 Thread Jason McIntyre
On Fri, Dec 23, 2022 at 10:33:43AM -0500, Paul Tagliamonte wrote: > On Fri, Dec 23, 2022 at 03:03:15PM +, Stuart Henderson wrote: > > > -struct itype *void_it; /* no type is emited > > > for void */ > > > +struct itype *void_it; /* no type

Re: ksh.1: Add a missing Ns

2022-12-26 Thread Jason McIntyre
On Mon, Dec 26, 2022 at 12:11:20PM -0500, Josiah Frentsos wrote: > Index: ksh.1 > === fixed, thanks. jmc > RCS file: /cvs/src/bin/ksh/ksh.1,v > retrieving revision 1.217 > diff -u -p -r1.217 ksh.1 > --- ksh.1 13 Sep 2022

Re: [patch(es)] fix a few typos in /src

2022-12-25 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 10:49:06PM -0500, Paul Tagliamonte wrote: > > Updated patch attached with your feedback, thank you Crystal > hi. i'm rejecting these parts of this diff: Index: lib/libcurses/term.5 Index: lib/libcurses/tinfo/comp_hash.c Index: lib/libcurses/tty/hashmap.c Index:

Re: [patch(es)] fix a few typos in /src

2022-12-25 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 10:49:06PM -0500, Paul Tagliamonte wrote: hi. i've committed the parts of this diff relating to libssl. jmc > Index: lib/libssl/d1_both.c > === > Index: lib/libssl/ssl.h >

Re: [patch(es)] fix a few typos in /src

2022-12-25 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 10:49:06PM -0500, Paul Tagliamonte wrote: > > Updated patch attached with your feedback, thank you Crystal > hi. i know by now you have the message that diffs need to be manageable ;) i'll try and work through your changes as best i can. so this is a heads up that i

Re: ksh.1: Add a missing Ns

2022-12-25 Thread Jason McIntyre
On Sat, Dec 24, 2022 at 12:25:15PM -0500, Josiah Frentsos wrote: > Index: ksh.1 > === > RCS file: /cvs/src/bin/ksh/ksh.1,v > retrieving revision 1.217 > diff -u -p -r1.217 ksh.1 > --- ksh.1 13 Sep 2022 20:26:26 - 1.217 >

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 07:31:26PM +, Jason McIntyre wrote: > > anyway, how about this text for ipcomp/ipsec? > jmc > for completeness sake, here's the full diff. jmc Index: sbin/ifconfig/ifconfig.8 === RCS file: /

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 11:49:09AM -0800, Philip Guenther wrote: > On Thu, Dec 22, 2022 at 11:33 AM Jason McIntyre wrote: > ... > > > i have to say, i'm getting nowhere with this SYNOPSIS: > > > > netstat -r [-AFu] [-f address_family] [-M core] [-N syste

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 06:35:41PM +, Stuart Henderson wrote: > On 2022/12/22 17:58, Jason McIntyre wrote: > > > > flag. > > > > Just like for IPsec, using the > > > > -.Fl r > > > > -flag, > > > > -.Xr netstat 1 > >

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 06:21:08PM +0100, Claudio Jeker wrote: > On Thu, Dec 22, 2022 at 05:08:15PM +0000, Jason McIntyre wrote: > > On Thu, Dec 22, 2022 at 07:32:18AM +0000, Jason McIntyre wrote: > > > > > > next step is to examine Xr. will get round to that when

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 07:32:18AM +, Jason McIntyre wrote: > > next step is to examine Xr. will get round to that when i can. > so i looked at where we are using netstat. a lot of the references still make sense. diff below is for ones i think we can change. claudio kindly hel

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Jason McIntyre
On Wed, Dec 21, 2022 at 05:15:35PM -0500, Paul Tagliamonte wrote: > Good news, I've got my MUA sorted. Hopefully this fixes the issues with > the CVS diffs in my reply body. > > On Wed, Dec 21, 2022 at 10:09:24PM +, Jason McIntyre wrote: > > i like the choice of "d

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Jason McIntyre
On Wed, Dec 21, 2022 at 12:41:42PM -0500, Paul R. Tagliamonte wrote: > > So I think route.8 is where we should try to have complete documentation, > > and once that is done we should change Xr's and other documentation to > > point at route.8 instead of netstat.8 > > In an effort to have my

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Jason McIntyre
On Wed, Dec 21, 2022 at 10:43:18AM -0500, Paul R. Tagliamonte wrote: > On Tue, Dec 20, 2022 at 8:27 PM Paul R. Tagliamonte wrote: > > > > Heyya tech@, > > > > Please keep me on cc, I'm not subscribed > > Please keep me on cc. The last message wasn't sent to me, so my In-Reply-To > is going to be

Re: args vs arg ... in manuals

2022-12-20 Thread Jason McIntyre
On Wed, Dec 21, 2022 at 07:40:01AM +, Klemens Nanni wrote: > On Tue, Dec 20, 2022 at 08:24:29PM +0000, Jason McIntyre wrote: > > On Tue, Dec 20, 2022 at 06:24:45PM +, Klemens Nanni wrote: > > > > > > Feedback? OK? > > > > > > > ok, in gen

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-20 Thread Jason McIntyre
On Tue, Dec 20, 2022 at 08:27:14PM -0500, Paul R. Tagliamonte wrote: > Heyya tech@, > > Please keep me on cc, I'm not subscribed > > I've been working on porting some of my linux specific software to > work on OpenBSD. While working with some routing-specific code, > I needed to pull up show.c

Re: args vs arg ... in manuals

2022-12-20 Thread Jason McIntyre
On Tue, Dec 20, 2022 at 01:53:18PM -0700, Theo de Raadt wrote: > This went from solving one thing, which was largely agreed. > > Now it is trying to introduce other changes as well. Almost always that > process stinks, unless it goes over the top at saying it is trying to solve > other problems

Re: args vs arg ... in manuals

2022-12-20 Thread Jason McIntyre
On Tue, Dec 20, 2022 at 06:24:45PM +, Klemens Nanni wrote: > > Feedback? OK? > ok, in general i'm fine with this. i do have some concerns though: > > Index: share/man/man4/ddb.4 > === > RCS file:

Re: args vs arg ... in manuals

2022-12-20 Thread Jason McIntyre
On Tue, Dec 20, 2022 at 09:36:39AM +, Klemens Nanni wrote: > Both styles are used, but I argue that the former fails to distinguish > between > $ program 'args in one shell word' > and > $ program one arg per shell word > > It's a minor thing, imho, but perhaps we can decide for

Re: [Patch] Probable error in sh.1

2022-12-18 Thread Jason McIntyre
On Sun, Dec 18, 2022 at 12:56:59PM +, Klemens Nanni wrote: > 12/18/22 15:53, Stefan Hagen ??: > > Ross L Richardson wrote (2022-12-18 10:55 CET): > >> The word "array" occurs only once in sh.1. Therefore, either it deserves > >> more explanation, or removal with something like the

Re: hostname.if(5): lladdr tweaks

2022-12-14 Thread Jason McIntyre
On Thu, Dec 15, 2022 at 05:19:14AM +, Klemens Nanni wrote: > On Wed, Dec 14, 2022 at 04:27:37PM -0800, Andrew Hewus Fresh wrote: > > On Mon, Dec 12, 2022 at 06:48:36AM +0000, Jason McIntyre wrote: > > > On Fri, Dec 09, 2022 at 09:32:13PM +0000, Jason McIntyre

Re: sigpause.3: Make the Xr bold

2022-12-12 Thread Jason McIntyre
On Mon, Dec 12, 2022 at 06:19:17PM -0500, Josiah Frentsos wrote: > Index: sigpause.3 > === > RCS file: /cvs/src/lib/libc/compat-43/sigpause.3,v > retrieving revision 1.14 > diff -u -p -r1.14 sigpause.3 > --- sigpause.317 Jul

Re: hostname.if(5): lladdr tweaks

2022-12-11 Thread Jason McIntyre
On Fri, Dec 09, 2022 at 09:32:13PM +, Jason McIntyre wrote: > hi. > > two points about the recent ability to use lladdr: > > - the example of "bridge0" made sense when bridge was regarded as a > separate entity and not integrated with ifconfig. plus a list of o

hostname.if(5): lladdr tweaks

2022-12-09 Thread Jason McIntyre
hi. two points about the recent ability to use lladdr: - the example of "bridge0" made sense when bridge was regarded as a separate entity and not integrated with ifconfig. plus a list of one example looks rubbish. now that we have a second example (lladdr) and bridge is not flagged as a

Re: dlfcn(3) spacing tweak

2022-12-04 Thread Jason McIntyre
On Mon, Dec 05, 2022 at 01:47:50AM -0500, Brad Smith wrote: > On Mon, Dec 05, 2022 at 06:42:00AM +0000, Jason McIntyre wrote: > > On Sun, Dec 04, 2022 at 08:29:26PM -0500, Brad Smith wrote: > > > After the RTLD_NOLOAD addition to the page the spacing looks kind of > > >

Re: dlfcn(3) spacing tweak

2022-12-04 Thread Jason McIntyre
On Sun, Dec 04, 2022 at 08:29:26PM -0500, Brad Smith wrote: > After the RTLD_NOLOAD addition to the page the spacing looks kind of > odd. Make the spacing look like RTLD_NOW / RTLD_LAZY above that. > > > Index: dlfcn.3 > === > RCS

Re: tmux.1: Sort options

2022-11-10 Thread Jason McIntyre
On Thu, Nov 10, 2022 at 03:10:32PM -0500, Josiah Frentsos wrote: > Index: tmux.1 > === > RCS file: /cvs/src/usr.bin/tmux/tmux.1,v > retrieving revision 1.905 > diff -u -p -r1.905 tmux.1 > --- tmux.13 Nov 2022 08:33:57 -

Re: qcpmic.4, qcpmicgpio.4, etc.: Sort SEE ALSO

2022-11-10 Thread Jason McIntyre
On Thu, Nov 10, 2022 at 05:13:40PM +, Patrick Wildt wrote: > There are other drivers with intro after others. Are we sorting those > alphabetically or by relevancy? > alphabetically, and in section order. i am kinda busy at the mo, if anyone wants to fix these... jmc > Von meinem iPhone

Re: pause.3: Use Fn

2022-11-09 Thread Jason McIntyre
On Tue, Nov 08, 2022 at 04:35:33PM -0500, Josiah Frentsos wrote: > Index: pause.3 > === > RCS file: /cvs/src/lib/libc/gen/pause.3,v > retrieving revision 1.15 > diff -u -p -r1.15 pause.3 > --- pause.3 2 Aug 2022 01:23:23 -

Re: netstart: trim DESCRIPTION

2022-10-25 Thread Jason McIntyre
i'm ok with this. however it is really *a* command script, rather than *the* command script. jmc On 25 October 2022 10:47:21 BST, Klemens Nanni wrote: >- just call it (a sh(1)) script, in line with MAKEDEV(8) and rc.d(8) >- use only .Nm thereafter instead of .Nm/the .Nm script/... >- zap the

Re: netstart: improve DESCRIPTION

2022-10-24 Thread Jason McIntyre
On Mon, Oct 24, 2022 at 06:35:17PM +, Klemens Nanni wrote: > On Fri, Oct 21, 2022 at 06:58:52PM +, Klemens Nanni wrote: > > On Fri, Oct 21, 2022 at 06:39:59PM +0100, Jason McIntyre wrote: > > > i was going to incliude this in my answer, but eventually thought it > >

Re: kqueue.2: Add a comma

2022-10-22 Thread Jason McIntyre
On Fri, Oct 21, 2022 at 07:05:03PM -0400, Josiah Frentsos wrote: > Index: kqueue.2 > === > RCS file: /cvs/src/lib/libc/sys/kqueue.2,v > retrieving revision 1.46 > diff -u -p -r1.46 kqueue.2 > --- kqueue.2 31 Mar 2022 17:27:16 -

Re: netstart: fix synopsis

2022-10-22 Thread Jason McIntyre
On Fri, Oct 21, 2022 at 06:58:52PM +, Klemens Nanni wrote: > On Fri, Oct 21, 2022 at 06:39:59PM +0100, Jason McIntyre wrote: > > i was going to incliude this in my answer, but eventually thought it > > looks like a seperate diff: > > > > the text currently read

Re: ZZZ and extra mountpoints

2022-10-21 Thread Jason McIntyre
On Fri, Oct 21, 2022 at 10:34:23AM -0600, Theo de Raadt wrote: > Sol??ne Rapenne wrote: > > > I agree my sentence isn't good enough or is too much, but I think ZZZ > > explanations isn't enough in its current form > > Maybe it is lacking. But your previous diff didn't help anyone. > > > from

Re: netstart: fix synopsis

2022-10-21 Thread Jason McIntyre
On Fri, Oct 21, 2022 at 12:55:49PM +0100, Jason McIntyre wrote: > On Fri, Oct 21, 2022 at 09:30:08AM +, Klemens Nanni wrote: > > Using -n does not require an interface: > > > > # sh /etc/netstart -n ; echo $? > > ifconfig lo0 inet 127.0.0.1/8 > &

Re: netstart: fix synopsis

2022-10-21 Thread Jason McIntyre
On Fri, Oct 21, 2022 at 09:30:08AM +, Klemens Nanni wrote: > Using -n does not require an interface: > > # sh /etc/netstart -n ; echo $? > ifconfig lo0 inet 127.0.0.1/8 > route -qn add -inet6 fe80:: -prefixlen 10 ::1 -reject > ... > 0 > > OK? > ok. jmc >

Re: aucat.1: Improve description

2022-10-14 Thread Jason McIntyre
On Thu, Oct 13, 2022 at 02:22:56PM +0100, Jason McIntyre wrote: > On Wed, Oct 12, 2022 at 08:51:10PM -0400, Josiah Frentsos wrote: > > Index: aucat.1 > > === > > RCS file: /cvs/src/usr.bin/aucat/aucat.1,v > >

Re: vm.conf.5: Use the proper macros

2022-10-14 Thread Jason McIntyre
On Sat, Sep 24, 2022 at 10:09:43AM -0400, Josiah Frentsos wrote: > --- vm.conf.5 > +++ vm.conf.5 hi. i reread this and agree it's better. now committed. thanks for the diff, and sorry for the wait. jmc > @@ -117,8 +117,11 @@ a random prefix from the > .Dq unique local > network range

Re: aucat.1: Improve description

2022-10-13 Thread Jason McIntyre
On Wed, Oct 12, 2022 at 08:51:10PM -0400, Josiah Frentsos wrote: > Index: aucat.1 > === > RCS file: /cvs/src/usr.bin/aucat/aucat.1,v > retrieving revision 1.117 > diff -u -p -r1.117 aucat.1 > --- aucat.1 7 Mar 2022 09:04:45 -

Re: ps.1: control terminal -> controlling terminal

2022-10-13 Thread Jason McIntyre
On Tue, Oct 11, 2022 at 07:23:45PM -0400, Josiah Frentsos wrote: > Index: ps.1 > === > RCS file: /cvs/src/bin/ps/ps.1,v > retrieving revision 1.128 > diff -u -p -r1.128 ps.1 > --- ps.1 3 Sep 2022 15:59:04 - 1.128 > +++

Re: List SIMCom SIM8262E-M2 as supported for umb(4)

2022-10-08 Thread Jason McIntyre
On Sat, Oct 08, 2022 at 10:40:10PM +0800, Kevin Lo wrote: > The diff below adds SIMCom SIM8262E-M2 to umb man page. > > Tested: > umb0 at uhub0 port 18 "SIMCOM SDXLEMUR-LITE-MTP _SN:59A7F2D2" rev 3.20/5.04 > addr 7 > > Using 'AT+CUSBCFG=usbid,1e0e,9003' AT command to switch to MBIM mode. > ok?

Re: tftp: sort commands, add help to manual

2022-10-02 Thread Jason McIntyre
On Sun, Oct 02, 2022 at 06:05:44PM +, Klemens Nanni wrote: > Searching for a command in help output is much simpler when sorted. > The strings can be inlined into the struct while staying under 80 chars. > > Now manual and help output are in the same order, except help folded > into ? in the

Re: rarpd: clarify synopsis

2022-10-02 Thread Jason McIntyre
On Sun, Oct 02, 2022 at 01:07:04PM +, Klemens Nanni wrote: > rarpd(8) either "Listen[s] on all the Ethernets attached to the system" > or requires an explicit list, not both: > > $ rarpd -a em0 > usage: rarpd [-adflt] if0 [... ifN] > $ ./obj/rarpd -a em0 > usage: rarpd

Re: swab.3: Use Fn consistently

2022-09-28 Thread Jason McIntyre
On Tue, Sep 27, 2022 at 06:13:20PM -0400, Josiah Frentsos wrote: > Index: swab.3 > === fixed, thanks. also just to add: i have taken note of your second vm.conf.5 diff. however since i've come to dislike both macros (and how one

Re: vm.conf.5: Use the proper macros

2022-09-24 Thread Jason McIntyre
On Sat, Sep 24, 2022 at 10:09:06AM -0400, Josiah Frentsos wrote: > --- vm.conf.5 > +++ vm.conf.5 > @@ -25,8 +25,7 @@ > .Nm > is the configuration file to configure the virtual machine monitor > (VMM) subsystem. > -A VMM manages virtual machines (VMs) on a > -.Ar host . > +A VMM manages virtual

Re: execve.2: Use the proper macros for the #! line

2022-09-24 Thread Jason McIntyre
On Fri, Sep 23, 2022 at 10:04:45AM -0400, Josiah Frentsos wrote: > Index: execve.2 > === > RCS file: /cvs/src/lib/libc/sys/execve.2,v > retrieving revision 1.56 > diff -u -p -r1.56 execve.2 > --- execve.2 31 Mar 2022 17:27:16 -

Re: vm.conf.5: Use the proper macros

2022-09-24 Thread Jason McIntyre
On Fri, Sep 23, 2022 at 05:41:41PM -0400, Josiah Frentsos wrote: > Index: vm.conf.5 > === hi. some comments, inline: > RCS file: /cvs/src/usr.sbin/vmd/vm.conf.5,v > retrieving revision 1.59 > diff -u -p -r1.59 vm.conf.5 > ---

Re: cp.1: zap redundant info

2022-09-20 Thread Jason McIntyre
On Tue, Sep 20, 2022 at 08:37:27AM -0300, Crystal Kolipe wrote: > On Tue, Sep 20, 2022 at 10:54:10AM +, Klemens Nanni wrote: > > Does this negation of the main sentence add anything I don't get? > > Yes. The wording you are proposing to remove makes it clear that > setting -R sets the

Re: iostat.8 wording

2022-09-17 Thread Jason McIntyre
On Thu, Sep 15, 2022 at 04:43:19PM +0100, Jason McIntyre wrote: > On Thu, Sep 15, 2022 at 04:41:57PM +0200, Jan Stary wrote: > > I believe this reads a little bit better. > > > > Jan > > > > i agree, but i'd leave those commas in. > jmc > i went ahe

Re: iostat.8 wording

2022-09-15 Thread Jason McIntyre
On Thu, Sep 15, 2022 at 04:41:57PM +0200, Jan Stary wrote: > I believe this reads a little bit better. > > Jan > i agree, but i'd leave those commas in. jmc > Index: iostat.8 > === > RCS file:

Re: man sed(1): instructions wrt whitespace in functions

2022-09-15 Thread Jason McIntyre
On Wed, Sep 14, 2022 at 11:51:41AM +0200, Luka Krmpoti?? wrote: > section "DESCRIPTION" of sed man(1) page, says > >The form of a sed command is as follows: > >[address[,address]]function[arguments] > >Whitespace may be inserted before the first address and the function > >portions of the

Re: man sed(1), fix comment about two addresses

2022-09-14 Thread Jason McIntyre
On Wed, Sep 14, 2022 at 07:00:52AM +, Klemens Nanni wrote: > On Wed, Sep 14, 2022 at 06:48:48AM +0100, Jason McIntyre wrote: > > On Wed, Sep 14, 2022 at 12:40:55AM +0200, Luka Krmpoti?? wrote: > > > sed's man(1) page, section "sed addresses", has a note: > > &

  1   2   3   4   5   6   7   8   9   10   >