Re: [PATCH rdma-core] Support writing man pages in MarkDown

[Benjamin Drung <benjamin.drung-EIkl63zCoXaH+58JC4qpiA@public.gmane.org>]

[-- Attachment #1: Type: text/plain, Size: 1612 bytes --]

Am Mittwoch, den 27.12.2017, 13:13 +0200 schrieb Leon Romanovsky:
> On Wed, Dec 27, 2017 at 10:53:53AM +0100, Benjamin Drung wrote:
> > > > Am Sonntag, den 24.12.2017, 14:03 +0200 schrieb Yishai Hadas:
> > > 
> > > On 12/13/2017 12:59 AM, Jason Gunthorpe wrote:
> > > > > pandoc is fairly widely available in the distros with the
> > > > > notable
> > > > 
> > > > problem that centos 6 and 7 can only get it from EPEL.
> > > > 
> > > 
> > > There might be even a worse case scenario where pandoc may not
> > > exist
> > > as
> > > a package to be installed, for example how about SLES OS ?
> > 
> > The release tarball could contain pre-built man page. So in case
> > the OS
> > does provide pandoc to regenerate the man pages, the pre-built can
> > be
> > used.
> 
> Why should OS be dependent on pandoc? IMHO all releases should
> contain
> pre-built man pages and they should be used without need to
> regenerate
> them at all.

Debian's rule is to build everything from source where the source is in
the preferred format for modification. So we will drop the pre-build
man pages and build them from source - even if that would not be
needed. This is useful in case we have to modify it (e.g. fix typos).

-- 
Benjamin Drung
System Developer
Debian & Ubuntu Developer

ProfitBricks GmbH
Greifswalder Str. 207
D - 10405 Berlin

Email: benjamin.drung-EIkl63zCoXaH+58JC4qpiA@public.gmane.org
URL: https://www.profitbricks.de

Sitz der Gesellschaft: Berlin
Registergericht: Amtsgericht Charlottenburg, HRB 125506 B
Geschäftsführer: Achim Weiss, Matthias Steinberg

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 801 bytes --]