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

Bug#572716: LinuxThreads manual pages



(Removing Bug#460637 from CC, since that bug doesn’t depend on this one.)

Nikolaus Schulz wrote:
> On Sun, Mar 07, 2010 at 11:36:37PM -0600, Jonathan Nieder wrote:

>> retitle -1 Please remove outdated LinuxThreads manpages
>> forcemerge 572716 -1
>> severity -1 minor
>> block -1 by 519781
>> thanks
> [snip]
>>  - The pages in man-pages are usable and maintained, and I think we should
>>    ship them.  This requires coordination between the two packages.
>>    Actually, manpages-dev should be changed first (with Replaces: glibc-doc,
>>    this requires no action by the glibc maintainers).
>
> Note that in order to avoid file conflicts, my patch for #519781 just
> adds pages to manpages-dev that are long removed from glibc-doc.

Good catch.  Here’s the more complete (but more dangerous) patch.

Thoughts?
>From 14ee79f0d36e7dd2a33b86197bd1fbbb691698c3 Mon Sep 17 00:00:00 2001
From: Jonathan Nieder <jrnieder@gmail.com>
Date: Fri, 26 Mar 2010 00:00:00 -0500
Subject: [PATCH] manpages-dev: Take over pthread_* namespace from glibc-doc

The LinuxThreads manpages included in glibc-doc are starting to show
their age, and the pages on pthreads in man-pages are usable and
maintained.  I think we should start shipping the latter.  This
requires coordination between the two packages.  Actually,
manpages-dev gets the first move (with Replaces: glibc-doc, this
requires no action by the glibc maintainers).

An unversioned Replaces relation is very convenient, because it means we
can take our time removing relevant files from glibc-doc without
coordinating revisions to synchronize with this change.

The Replaces relation can be changed to a versioned Replaces as soon as
that work is complete.  Even without such a change, as long as the
pages are removed from glibc-doc before squeeze is released, the
Replaces can be completely removed from manpages-dev for squeeze+1.

Note!  If afterwards glibc-doc takes over some filenames from this
version of manpages-dev (before squeeze+1 is released), then glibc-doc
would have to use Conflicts rather than Replaces+Breaks to signal
that, making for a less pleasant upgrade.  I have no reason to believe
this would happen, but it’s worth keeping in mind.

Thanks to Nikolaus Schulz <microschulz@web.de> for an initial patch.
---
 debian/changelog |   28 ++++++++++++++++++++++++++++
 debian/control   |    2 +-
 debian/inst      |   12 +-----------
 3 files changed, 30 insertions(+), 12 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 71b9947..320dc18 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,31 @@
+manpages (3.24-1.1) experimental; urgency=low
+
+  * Added an unversioned Replaces entry against glibc-doc due to
+    old pthreads manpages shipped with glibc-doc.
+  * Distribute pthreads manpages that were removed in glibc-doc 2.9-1:
+    . pthread_attr_*(3)
+    . pthread_cleanup_*(3)
+    . pthread_create(3)
+    . pthread_detach(3)
+    . pthread_equal(3)
+    . pthread_exit(3)
+    . pthread_join(3)
+    . pthread_getschedparam(3)
+    . pthread_setschedparam(3)
+    . pthread_self(3)
+    . pthread_setcancelstate(3)
+    . pthread_setcanceltype(3)
+    . pthread_testcancel(3)
+    . pthread_cancel(3)
+  * Distribute more pthreads manpages to replace the ancient pages in
+    glibc-doc:
+    . pthread_kill(3)
+    . pthread_kill_other_threads_np(3)
+    . pthread_sigmask(3)
+    . sigwait(3)
+
+ -- Jonathan Nieder <jrnieder@gmail.com>  Thu, 25 Mar 2010 23:22:13 -0500
+
 manpages (3.24-1) unstable; urgency=low
 
   * New upstream version
diff --git a/debian/control b/debian/control
index 6e6fd60..48a71ae 100644
--- a/debian/control
+++ b/debian/control
@@ -27,7 +27,7 @@ Package: manpages-dev
 Architecture: all
 Depends: manpages
 Suggests: man-browser
-Replaces: glibc-doc (<< 2.3.6-8)
+Replaces: glibc-doc
 Priority: optional
 Description: Manual pages about using GNU/Linux for development
  These man pages describe the Linux programming interface, including
diff --git a/debian/inst b/debian/inst
index de035bc..62e6ca8 100644
--- a/debian/inst
+++ b/debian/inst
@@ -65,17 +65,7 @@ for i in man[23]; do
 		getxattr.2|lgetxattr.2|listxattr.2|llistxattr.2|lremovexattr.2|\
 		get_kernel_syms.2|create_module.2|delete_module.2|\
 		init_module.2|query_module.2|set_mempolicy.2|\
-		pthread_attr_destroy.3|pthread_attr_getdetachstate.3|pthread_cleanup_pop.3|\
-		pthread_attr_getscope.3|pthread_attr_init.3|pthread_attr_setdetachstate.3|\
-		pthread_attr_setscope.3|pthread_create.3|pthread_detach.3|pthread_equal.3|\
-		pthread_exit.3|pthread_join.3|pthread_self.3|pthread_attr_setschedpolicy.3|\
-		pthread_setschedparam.3|pthread_attr_setschedparam.3|pthread_attr_getschedparam.3|\
-		pthread_getschedparam.3|pthread_attr_getschedpolicy.3|pthread_cleanup_push.3|\
-		pthread_testcancel.3|pthread_setcancelstate.3|pthread_attr_getinheritsched.3|\
-		pthread_attr_setinheritsched.3|pthread_setcanceltype.3|pthread_cancel.3|\
-		pthread_cleanup_push_defer_np.3|pthread_cleanup_pop_restore_np.3|\
-		pthread_kill_other_threads_np.3|pthread_sigmask.3|pthread_kill.3|\
-		lsetxattr.2|removexattr.2|setxattr.2|sigwait.3)
+		lsetxattr.2|removexattr.2|setxattr.2)
 			echo -n "(skipped)"
 			;; 
 		*)
-- 
1.7.0.3


Reply to: