Re: [PATCH] INSTALL: note about make man with Asciidoctor backend

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Martin Ågren wrote:
> On Wed, 12 May 2021 at 10:13, Felipe Contreras
> <felipe.contreras@xxxxxxxxx> wrote:
> >
> > Junio C Hamano wrote:
> > > Bagas Sanjaya <bagasdotme@xxxxxxxxx> writes:
> > >
> > > > +   You can also do "make man" using Asciidoctor's manpage backend in
> > > > +   place of xmlto by passing USE_ASCIIDOCTOR_MANPAGE=YesPlease. Version
> > > > +   2.0 or later is highly recommended, as these version properly handle
> > > > +   apostrophes.
> > > > +
> > >
> > > Hmph, I wasn't closely following the previous discussion, but is the
> > > apostrophes the primary reason why anything below 2.0 is not usable?
> >
> > "Not usable"?
> >
> > I haven't been able to reproduce the original supposed problem, but even
> > if true, the man pages would be quite usable.
> 
> Even early 2.0.x had some issues [1].
> [1] https://lore.kernel.org/git/20190325190041.GM4047@xxxxxxxxx/

That issue affects only the docbook generation, not direct man pages.

So far nobody has mentioned any issues with USE_ASCIIDOCTOR_MANPAGE=1 in
older asciidoctor, especially not regarding apostrophes.

-- 
Felipe Contreras



[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux