Re: SEE ALSO fails

2021-11-01 Thread Tadziu Hoffmann
> If the proposal is to remove See Also's that aren't installed, I > could not be more against that idea. That just makes the system > harder to learn. I agree. Also, some of the manual pages reference Bell Labs Technical Reports or other papers that are hardly ever installed on any system. N

SEE ALSO fails

2021-10-30 Thread Douglas McIlroy
The contents of man pages are not groff's business. If a man page must be conditioned by what's on a local system, that can likely be done with .sy. But man(1) should not enable .sy. Enjoy the catch-22. Another reason to keep the status quo in regard to referring to nonexistent man pages is that s

Re: SEE ALSO fails

2021-10-30 Thread Peter Schaffter
On Sat, Oct 30, 2021, Larry McVoy wrote: > If the proposal is to remove See Also's that aren't installed, I > could not be more against that idea. That just makes the system > harder to learn. I don't have a position on this because I've never given it a moment's thought. That said, surely a bet

Re: SEE ALSO fails

2021-10-30 Thread James K. Lowden
On Sat, 30 Oct 2021 14:48:46 -0700 Larry McVoy wrote: > If James is suggesting that dangling links are not helpful, I find > the opposite to be true. I too have benefited from pursuing hints I found in SEE ALSO, even for uninstalled software. I remember one weekend searching to for a free impl

Re: SEE ALSO fails

2021-10-30 Thread Steve Izma
On Sat, Oct 30, 2021 at 04:42:24PM -0700, Larry McVoy wrote: > Subject: Re: SEE ALSO fails > > If the proposal is to remove See Also's that aren't installed, I > could not be more against that idea. That just makes the system > harder to learn. > > If I'

Re: SEE ALSO fails

2021-10-30 Thread Larry McVoy
On Sat, Oct 30, 2021 at 07:12:37PM -0400, Steve Izma wrote: > On Sat, Oct 30, 2021 at 07:53:13PM +0200, Ingo Schwarze wrote: > > Subject: Re: SEE ALSO fails > > > > James K. Lowden wrote on Sat, Oct 30, 2021 at 12:08:03PM -0400: > > > > > A longstanding c

Re: SEE ALSO fails

2021-10-30 Thread Steve Izma
On Sat, Oct 30, 2021 at 07:53:13PM +0200, Ingo Schwarze wrote: > Subject: Re: SEE ALSO fails > > James K. Lowden wrote on Sat, Oct 30, 2021 at 12:08:03PM -0400: > > > A longstanding complaint of mine regarding Linux man pages is > > that they frequently have broken

Re: SEE ALSO fails

2021-10-30 Thread Larry McVoy
Me too. I though the OS write comparing BSD to Linux is spot on. Linux is like C, it lets you do whatever you want but be careful what you want. While it is not the prettiest to say "Whatever not found" it gives you a hint to go look for Whatever. Those hints can save your butt. If James is su

Re: SEE ALSO fails

2021-10-30 Thread T. Kurt Bond
Add my voice to those saying to never delete those references: even if the corresponding packages aren't installed, given the reference in the manual page I can finding them using different means. If they're not in the manual page, I don't have that opportunity. On Sat, Oct 30, 2021 at 12:08 PM J

Re: SEE ALSO fails

2021-10-30 Thread James K. Lowden
On Sat, 30 Oct 2021 19:53:13 +0200 Ingo Schwarze wrote: > >> .Sh SEE ALSO > >> .Xr mg 1 , > >> .Xr vi 1 , > >> .Xr editline 3edit , > >> .Xr el_wgets 3 , > >> .Xr el_wpush 3 , > >> .Xr el_wset 3 , > >> .Xr editrc 5edit > > > What, I wonder, is "mg"? > > > > $ man mg > > No manual entr

Re: SEE ALSO fails

2021-10-30 Thread Alejandro Colomar (man-pages)
On 10/30/21 19:53, Ingo Schwarze wrote: Hi James, James K. Lowden wrote on Sat, Oct 30, 2021 at 12:08:03PM -0400: A longstanding complaint of mine regarding Linux man pages is that they frequently have broken SEE ALSO references. I wonder if there's not something the groff project could do to

Re: SEE ALSO fails

2021-10-30 Thread Ingo Schwarze
Hi James, James K. Lowden wrote on Sat, Oct 30, 2021 at 12:08:03PM -0400: > A longstanding complaint of mine regarding Linux man pages is that they > frequently have broken SEE ALSO references. I wonder if there's not > something the groff project could do to encourage packaging systems to > avo

SEE ALSO fails

2021-10-30 Thread James K. Lowden
A longstanding complaint of mine regarding Linux man pages is that they frequently have broken SEE ALSO references. I wonder if there's not something the groff project could do to encourage packaging systems to avoid such errors. Today's page in question is edltline(3), the BSD complement to re