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: 2072 bytes --]

Am Mittwoch, den 27.12.2017, 14:20 +0200 schrieb Leon Romanovsky:
> On Wed, Dec 27, 2017 at 12:27:01PM +0100, Benjamin Drung wrote:
> > 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).
> 
> Thanks for the explanation.

FYI: Debian has a wiki page dedicated for upstream developers:
https://wiki.debian.org/UpstreamGuide

-- 
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 --]