Bug#556173: Bug#564874: Bug#556173: libc-bin: introduces custom manual pages / manpages package

2013-07-14 Thread Simon Paillard
Hi,

Do you have a position regarding this ?

TL;DR: better manpages may be provided by manpages pkg:
http://people.debian.org/~spaillard/libc-or-manpages/

On Thu, May 23, 2013 at 11:48:51PM +0200, Simon Paillard wrote:
 On Sat, Nov 14, 2009 at 12:34:55AM +0100, Petr Baudis wrote:
  Package: libc-bin
  Version: 2.10.1-5
  Severity: wishlist
  
  The Debian glibc package introduces a number of custom manual pages
  which are not in any kind of upstream and thus cannot be shared with
  the rest of Linux community, which is quite unfortunate, since it
  reduces usability of other Linux distributions but also reduces quality
  of the documentation since less people see it and work on it.
  
  While upstream glibc does not maintain any manual pages, the
  linux-man-pages projects collects all kind of Linux-related manual
  pages, including glibc-specific manual pages not only on the API, but
  also on tools (like ldd). It would be great if the Debian-specific
  manual pages could be submitted there for review and inclusion.
  
  For some manual pages that _are_ upstream, e.g. ldd.1, the upstream
  version is more up-to-date than the version currently included; this
  should also demonstrate the value of taking these manpages from
  upstream. :)
  
 On this subject, manpages-linux provides some manpages which are installed by
 manpages packages today:
 libc-bin: ldd.1|ldconfig.8|ld.so.8|gai.conf.5
 
 You can find libc-bin and manpages copy of these manpages at:
 http://people.debian.org/~spaillard/libc-or-manpages/
 
 Except ldconfig.8 which are better in libc-bin IMO, all other
 could be installed by manpages.
 
 Some per-page bugs were reported earlier:
 
   #564874 ld.so.8  an old request arrived too late for Wheezy, and ld.so 
 by 
   manpages-linux provides way more details.
 
   #665303 getent.1 has been fixed some month ago
 
 If you agree with this, the next manpages{,dev} upload will replace libc-bin
 with appropriate version, then you can drop them.

-- 
Simon Paillard


-- 
To UNSUBSCRIBE, email to debian-glibc-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/20130714193222.gk19...@mraw.org



Bug#556173: libc-bin: introduces custom manual pages / manpages package

2013-07-14 Thread Jonathan Nieder
Simon Paillard wrote:

 Do you have a position regarding this ?
[...]
 On Thu, May 23, 2013 at 11:48:51PM +0200, Simon Paillard wrote:


 If you agree with this, the next manpages{,dev} upload will replace libc-bin
 with appropriate version, then you can drop them.

Please go ahead.  (I'm not an eglibc maintainer, but it seems so
obviously the right thing to do that I don't mind saying that
anyway.)

If you'd like, I think it even makes sense to replace the ldconfig.8
manpage, just taking the content from the eglibc package for now.
That would avoid having to keep juggling which package has which
manpage in the future.

Thanks,
Jonathan


-- 
To UNSUBSCRIBE, email to debian-glibc-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/20130714202706.gd8...@google.com



Bug#556173: libc-bin: introduces custom manual pages / manpages package

2013-07-14 Thread Adam Conrad
On Sun, Jul 14, 2013 at 01:27:06PM -0700, Jonathan Nieder wrote:
 
  If you agree with this, the next manpages{,dev} upload will replace 
  libc-bin
  with appropriate version, then you can drop them.
 
 Please go ahead.  (I'm not an eglibc maintainer, but it seems so
 obviously the right thing to do that I don't mind saying that
 anyway.)

Except that since he'll want to do a versioned Replaces, we can't
tell him to just go ahead until we've committed to a version where
we intend to drop them.

I'll look at this for either the next 2.17 upload or the 2.18 that
I need to start staging in experimental soon, but please don't go
uploading manpages with the replaces until we have a solid idea of
the version that needs to be replacing. :P

... Adam


-- 
To UNSUBSCRIBE, email to debian-glibc-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/20130714204544.gm11...@0c3.net



Bug#556173: libc-bin: introduces custom manual pages / manpages package

2013-05-23 Thread Simon Paillard
Hi,

On Sat, Nov 14, 2009 at 12:34:55AM +0100, Petr Baudis wrote:
 Package: libc-bin
 Version: 2.10.1-5
 Severity: wishlist
 
 The Debian glibc package introduces a number of custom manual pages
 which are not in any kind of upstream and thus cannot be shared with
 the rest of Linux community, which is quite unfortunate, since it
 reduces usability of other Linux distributions but also reduces quality
 of the documentation since less people see it and work on it.
 
 While upstream glibc does not maintain any manual pages, the
 linux-man-pages projects collects all kind of Linux-related manual
 pages, including glibc-specific manual pages not only on the API, but
 also on tools (like ldd). It would be great if the Debian-specific
 manual pages could be submitted there for review and inclusion.
 
 For some manual pages that _are_ upstream, e.g. ldd.1, the upstream
 version is more up-to-date than the version currently included; this
 should also demonstrate the value of taking these manpages from
 upstream. :)
 
On this subject, manpages-linux provides some manpages which are installed by
manpages packages today:
libc-bin: ldd.1|ldconfig.8|ld.so.8|gai.conf.5

You can find libc-bin and manpages copy of these manpages at:
http://people.debian.org/~spaillard/libc-or-manpages/

Except ldconfig.8 which are better in libc-bin IMO, all other
could be installed by manpages.

Some per-page bugs were reported earlier:

#564874 ld.so.8  an old request arrived too late for Wheezy, and ld.so 
by 
manpages-linux provides way more details.

#665303 getent.1 has been fixed some month ago

If you agree with this, the next manpages{,dev} upload will replace libc-bin
with appropriate version, then you can drop them.


-- 
Simon Paillard


-- 
To UNSUBSCRIBE, email to debian-glibc-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/20130523214851.ga7...@glenfiddich.mraw.org