Re: Using tbl(1) for structure definitions

2022-07-29 Thread Heinz-Jürgen Oertel
Am Dienstag, 26. Juli 2022, 21:33:07 CEST schrieb Alejandro Colomar: > Hi Branden, > > I've already read all that was relevant to me from tbl(1) regarding what > I had in mind: documenting structures. > > I haven't seen any mention to tables having a leading blank line, yet I > couldn't get rid

Re: Fixes for several contrib/mom/momdoc files

2022-07-29 Thread Alexis
Peter Schaffter writes: Thanks for the doc fixes for mom. I've been meaning to get out the broom and clean them up. This is a great help. Ah good! You're welcome. :-) Alexis.

Re: Using tbl(1) for structure definitions

2022-07-29 Thread Alejandro Colomar
On 7/29/22 10:13, Heinz-Jürgen Oertel wrote:> Hi Alex, did you look at the dformat preprocessor for pic? Hi Heinz, I think tbl(1) is more suited for this. https://noxz.tech/guides/groff/papers/dformat_--_a_program_for_typesetting_data_formats__142.pdf But thanks for that. I didn't know a

BSD and GPL (was: All caps .TH page title)

2022-07-29 Thread Alejandro Colomar
Hi Ingo and Branden, On 7/27/22 18:05, Ingo Schwarze wrote: [...] Under this umbrella, the Linux kernel is effectively under the BSD license. Except that free software projects cannot copy from it - that's quite a big BUT since allowing *everybody* to copy the code for any purpose is the cent

Re: man -M tcl (was: All caps .TH page title)

2022-07-29 Thread Alejandro Colomar
Hi Ingo, On 7/27/22 17:32, Ingo Schwarze wrote: Hi Alejandro, Alejandro Colomar wrote on Sun, Jul 24, 2022 at 06:17:40PM +0200: On 7/24/22 16:57, Ingo Schwarze wrote: I even considered supporting aliases for manpath directories in man.conf(5), something like being able to say alias tcl

Re: Using tbl(1) for structure definitions

2022-07-29 Thread G. Branden Robinson
At 2022-07-27T07:41:05+0100, Ralph Corderoy wrote: > > +.TS > > +l lB lB l1 lX. Alex, I think your contributors will be happier if you limit the number of table columns to the number of syntactical items that they can perceive in the structure body: the data type, element identifier, and (an optio

Re: man -M tcl (was: All caps .TH page title)

2022-07-29 Thread Ingo Schwarze
Hi Alejandro, Alejandro Colomar wrote on Fri, Jul 29, 2022 at 02:03:51PM +0200: > BTW, I guess you also have the POSIX man pages in BSDs. Do they come > from the kernel repo that I maintain, or do you have your own separate > repos? $ less /usr/ports/books/man-pages-posix/Makefile [...] C

Re: man -M tcl (was: All caps .TH page title)

2022-07-29 Thread Alejandro Colomar
On 7/29/22 15:22, Ingo Schwarze wrote: What are your thoughts? Yes, even though /usr/local/share/doc/pkgname/man/man* is a bit long, it makes more sense than paths like /usr/local/cyrus/man/ /usr/local/heirloom-doctools/man/ /usr/local/lib/erlang21/man/ /usr/local/lib/node_modules/

Re: Using tbl(1) for structure definitions

2022-07-29 Thread G. Branden Robinson
Hi Alex, At 2022-07-27T14:23:44+0200, Alejandro Colomar (man-pages) wrote: > Yeah, it seems that everything that I used was well documented (I > could find the way to use it). I didn't notice any other issues. > > Of course, there are things that I didn't pay much attention and > didn't fully un

Re: Using tbl(1) for structure definitions

2022-07-29 Thread Alejandro Colomar
Hi Branden, On 7/29/22 15:52, G. Branden Robinson wrote: Oh, I used text blocks and .BR, in v2. In part, I like it; in part I hate it. So, text blocks are definitely better. I'm not convinced about changing the escapes by macros; it makes it quite hard for inexperienced contributors to imagin

Re: Using tbl(1) for structure definitions

2022-07-29 Thread G. Branden Robinson
Hi Alex! At 2022-07-29T17:26:10+0200, Alejandro Colomar wrote: > On 7/29/22 15:52, G. Branden Robinson wrote: > > I don't think you're abusing it but you are employing some heavy > > machinery that brings some limitations with it. The worst from my > > perspective is that using tbl(1) in man page

Re: Using tbl(1) for structure definitions

2022-07-29 Thread Alejandro Colomar
Hi Branden, On 7/29/22 23:08, G. Branden Robinson wrote: Hi Alex! At 2022-07-29T17:26:10+0200, Alejandro Colomar wrote: On 7/29/22 15:52, G. Branden Robinson wrote: I don't think you're abusing it but you are employing some heavy machinery that brings some limitations with it. The worst from

[PATCH v5 1/2] open_how.2type: ffix

2022-07-29 Thread Alejandro Colomar
Format structures with tbl(1) to improve alignment in proportional-width font text. Reported-by: "G. Branden Robinson" Cc: Heinz-Jürgen Oertel Cc: Ralph Corderoy Signed-off-by: Alejandro Colomar --- man2type/open_how.2type | 25 + 1 file changed, 21 insertions(+), 4 de

[PATCH v5 2/2] sockaddr.3type: ffix

2022-07-29 Thread Alejandro Colomar
Format structures with tbl(1) to improve alignment in proportional-width font text. I also reordered the types in the SYNOPSIS, to be consistent with C syntax. Reported-by: "G. Branden Robinson" Cc: Heinz-Jürgen Oertel Cc: Ralph Corderoy Signed-off-by: Alejandro Colomar --- This page clearly

Re: Using tbl(1) for structure definitions

2022-07-29 Thread G. Branden Robinson
Hi Alex, At 2022-07-30T00:38:13+0200, Alejandro Colomar wrote: > On 7/29/22 23:08, G. Branden Robinson wrote: > > At 2022-07-29T17:26:10+0200, Alejandro Colomar wrote: > Hmm, considering that the amount of multiline comments with 80-char > terminals is still non-negligible (not in this page, but

Re: Using tbl(1) for structure definitions

2022-07-29 Thread Alejandro Colomar
Hi Branden, On 7/30/22 01:56, G. Branden Robinson wrote: Hi Alex, At 2022-07-30T00:38:13+0200, Alejandro Colomar wrote: On 7/29/22 23:08, G. Branden Robinson wrote: At 2022-07-29T17:26:10+0200, Alejandro Colomar wrote: Hmm, considering that the amount of multiline comments with 80-char ter

Re: [PATCH v5 2/2] sockaddr.3type: ffix

2022-07-29 Thread G. Branden Robinson
[replying just to Alex and the lists] Hi Alex, At 2022-07-30T01:01:09+0200, Alejandro Colomar wrote: > Format structures with tbl(1) to improve alignment in > proportional-width font text. > > I also reordered the types in the SYNOPSIS, to be consistent with > C syntax. > > Reported-by: "G. Bra

Re: Using tbl(1) for structure definitions

2022-07-29 Thread G. Branden Robinson
Hi Alex, At 2022-07-30T02:04:39+0200, Alejandro Colomar wrote: > On 7/30/22 01:56, G. Branden Robinson wrote: > > It'll be good to have a look. > > Oh, it's already in your mailbox, isn't it? I think I just responded to it. :) > But reallistically, how many people will fix their TS in man.loca