Errors in man pages of bzip2

[Mark Wielaard]

Hi Helge,

On Wed, Apr 20, 2022 at 04:44:27PM +0200, Helge Kreutzmann wrote:
> On Tue, Apr 19, 2022 at 11:36:50PM +0200, Mark Wielaard wrote:
> > On Sat, Feb 05, 2022 at 11:35:40AM +0100, Helge Kreutzmann wrote:
> > If you could file future issues in bugzilla:
> > https://sourceware.org/bugzilla/enter_bug.cgi?product=bzip2
> > Then there is an archive. But sending reports to this list is also
> > fine.
> 
> I can do this; however in February I was told by Micah Snyder to use
> https://gitlab.com/groups/bzip2/-/issues
> 
> Is the sourcware bugzilla now preferred?

I guess the coordination between the projects isn't ideal.  But yes,
for stable bzip2 1.0.x, which is what distros ship, sourceware is
preferred. The gitlab project is working on an experimental 1.1
version and rust translation.

> > > Man page: bzdiff.1
> > > Issue: missing markup (B< >)
> > > 
> > > "cmp(1), diff(1), bzmore(1), bzless(1), bzgrep(1), bzip2(1)"
> > 
> > I don't understand what is wrong here.
> 
> The entries in SEE ALSO are marked in bold, which usually is indicated
> in our format with B<>, so it should be B<cmp>(1) instead of cmp(1)
> and similarly for the others. If you use *roff, it could look like
> .BR \%cmp (1),
> .BR \%diff (1),

Aha, ok that makes sense given that we are referring to commands.

> > > --
> > > Man page: bzgrep.1
> > > Issue: missing markup (B< >)
> > > 
> > > "grep(1), egrep(1), fgrep(1), bzdiff(1), bzmore(1), bzless(1), bzip2(1)"
> > 
> > Again, I don't understand the issue here.
> 
> Same as above, missing bold markup.
> 
> > > --
> > > Man page: bzmore.1
> > > Issue: missing markup (B< >)
> > > 
> > > "more(1), less(1), bzip2(1), bzdiff(1), bzgrep(1)"
> > 
> > This is like above, I don't really understand what is wrong with the
> > way we use SEE ALSO in the manpages.
> 
> Same as above, missing bold markup.

I pushed to attached commit to markup the commands in the SEE ALSO
sections as bold.

Thanks,

Mark
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-Mark-SEE-ALSO-commands-with-.BR-in-bzdiff.1-bzgrep.1.patch
Type: text/x-diff
Size: 1645 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/bzip2-devel/attachments/20220421/57d10d96/attachment.bin>