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

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

 



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@xxxxxxxxxxxxxxxx
URL: https://www.profitbricks.de

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

Attachment: signature.asc
Description: This is a digitally signed message part


[Index of Archives]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Photo]     [Yosemite News]     [Yosemite Photos]     [Linux Kernel]     [Linux SCSI]     [XFree86]
  Powered by Linux