From nobody@FreeBSD.org  Thu Aug 12 08:49:32 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id A85BD106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 12 Aug 2010 08:37:10 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 97C878FC14
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 12 Aug 2010 08:37:10 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o7C8bAqq006173
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 12 Aug 2010 08:37:10 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o7C8bAcL006172;
	Thu, 12 Aug 2010 08:37:10 GMT
	(envelope-from nobody)
Message-Id: <201008120837.o7C8bAcL006172@www.freebsd.org>
Date: Thu, 12 Aug 2010 08:37:10 GMT
From: pluknet <pluknet@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] MLINK choosethread.9 to runqueue.9
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         149549
>Category:       docs
>Synopsis:       [patch] MLINK choosethread.9 to runqueue.9
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    brueffer
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Aug 12 09:02:58 UTC 2010
>Closed-Date:    Sun Jun 24 20:39:00 CEST 2012
>Last-Modified:  Sun Jun 24 20:39:00 CEST 2012
>Originator:     pluknet
>Release:        9-CURRENT as of August '10
>Organization:
>Environment:
>Description:
The runqueue(9) manpage references and describes choosethread() as part of itself.
So, FreeBSD Kernel Developer's Manual should (m)link choosethread(9) to runqueue(9).

Btw, it already links (non-existent) chooseproc(9) to runqueue(9).
The chooseproc(9) routine is replaced with choosethread(9) circa 2001.
The chooseproc mlink should probably be de-attached as well.
>How-To-Repeat:
Try to `man choosethread`.
No manual entry for choosethread
>Fix:


Patch attached with submission follows:

Index: share/man/man9/Makefile
===================================================================
--- share/man/man9/Makefile	(revision 209664)
+++ share/man/man9/Makefile	(working copy)
@@ -988,7 +988,7 @@
 	rtalloc.9 rtalloc_ign.9 \
 	rtalloc.9 RTFREE.9 \
 	rtalloc.9 rtfree.9
-MLINKS+=runqueue.9 chooseproc.9 \
+MLINKS+=runqueue.9 choosethread.9 \
 	runqueue.9 procrunnable.9 \
 	runqueue.9 remrunqueue.9 \
 	runqueue.9 setrunqueue.9


>Release-Note:
>Audit-Trail:

From: pluknet <pluknet@gmail.com>
To: bug-followup@FreeBSD.org, pluknet@gmail.com
Cc:  
Subject: Re: kern/149549: [patch] MLINK choosethread.9 to runqueue.9
Date: Thu, 12 Aug 2010 13:18:11 +0400

 --00c09fa2180b5c3638048d9cd880
 Content-Type: text/plain; charset=ISO-8859-1
 
 The patch in PR is incomplete if decided to *replace* chooseproc with
 choosethread.
 A missing part in that case is attached.
 
 --00c09fa2180b5c3638048d9cd880
 Content-Type: text/plain; charset=US-ASCII; name="m.9.choosethread2.txt"
 Content-Disposition: attachment; filename="m.9.choosethread2.txt"
 Content-Transfer-Encoding: base64
 X-Attachment-Id: f_gcrebwcv0
 
 SW5kZXg6IE9ic29sZXRlRmlsZXMuaW5jCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0KLS0tIE9ic29sZXRlRmlsZXMuaW5j
 CShyZXZpc2lvbiAyMTEyMTQpCisrKyBPYnNvbGV0ZUZpbGVzLmluYwkod29ya2luZyBjb3B5KQpA
 QCAtMTQsNiArMTQsOCBAQAogIyBUaGUgZmlsZSBpcyBwYXJ0aXRpb25lZDogT0xEX0ZJTEVTIGZp
 cnN0LCB0aGVuIE9MRF9MSUJTIGFuZCBPTERfRElSUyBsYXN0LgogIwogCisjIDIwMTAwODEyOiBy
 ZXRpcmUgbGFzdCB0cmFjZXMgb2YgY2hvb3NlcHJvYyg5KQorT0xEX0ZJTEVTKz11c3Ivc2hhcmUv
 bWFuL21hbjkvY2hvb3NlcHJvYy45Lmd6CiAjIDIwMTAwODA2OiByZW1vdmFsIG9mIHVudXNlZCBs
 aWJjb21wYXQgcm91dGluZXMKIE9MRF9GSUxFUys9dXNyL3NoYXJlL21hbi9tYW4zL2FzY2Z0aW1l
 LjMuZ3oKIE9MRF9GSUxFUys9dXNyL3NoYXJlL21hbi9tYW4zL2NmcmVlLjMuZ3oKSW5kZXg6IHNo
 YXJlL21hbi9tYW45L3J1bnF1ZXVlLjkKPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQotLS0gc2hhcmUvbWFuL21hbjkvcnVu
 cXVldWUuOQkocmV2aXNpb24gMjA5NjY0KQorKysgc2hhcmUvbWFuL21hbjkvcnVucXVldWUuOQko
 d29ya2luZyBjb3B5KQpAQCAtMjcsNyArMjcsNyBAQAogLkR0IFJVTlFVRVVFIDkKIC5PcwogLlNo
 IE5BTUUKLS5ObSBjaG9vc2Vwcm9jICwKKy5ObSBjaG9vc2V0aHJlYWQgLAogLk5tIHByb2NydW5u
 YWJsZSAsCiAuTm0gcmVtcnVucXVldWUgLAogLk5tIHNldHJ1bnF1ZXVlCg==
 --00c09fa2180b5c3638048d9cd880--
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Thu Aug 12 16:18:39 UTC 2010 
Responsible-Changed-Why:  
Reclassify. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=149549 
State-Changed-From-To: open->patched 
State-Changed-By: brueffer 
State-Changed-When: Sun Aug 15 23:26:12 CEST 2010 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=149549 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/149549: commit references a PR
Date: Sun, 15 Aug 2010 21:26:02 +0000 (UTC)

 Author: brueffer
 Date: Sun Aug 15 21:25:52 2010
 New Revision: 211353
 URL: http://svn.freebsd.org/changeset/base/211353
 
 Log:
   Tie up some loose ends r88509 left behind:
   
   - chooseproc() is long gone, MLINK choosethread instead
   - Update NAME section for choosethread
   - Mark chooseproc.9 for removal
   
   PR:             149549
   Submitted by:   pluknet
   MFC after:	1 week
 
 Modified:
   head/ObsoleteFiles.inc
   head/share/man/man9/Makefile
   head/share/man/man9/runqueue.9
 
 Modified: head/ObsoleteFiles.inc
 ==============================================================================
 --- head/ObsoleteFiles.inc	Sun Aug 15 21:24:17 2010	(r211352)
 +++ head/ObsoleteFiles.inc	Sun Aug 15 21:25:52 2010	(r211353)
 @@ -14,6 +14,8 @@
  # The file is partitioned: OLD_FILES first, then OLD_LIBS and OLD_DIRS last.
  #
  
 +# 20100815: retired last traces of chooseproc(9)
 +OLD_FILES+=usr/share/man/man9/chooseproc.9.gz
  # 20100806: removal of unused libcompat routines
  OLD_FILES+=usr/share/man/man3/ascftime.3.gz
  OLD_FILES+=usr/share/man/man3/cfree.3.gz
 
 Modified: head/share/man/man9/Makefile
 ==============================================================================
 --- head/share/man/man9/Makefile	Sun Aug 15 21:24:17 2010	(r211352)
 +++ head/share/man/man9/Makefile	Sun Aug 15 21:25:52 2010	(r211353)
 @@ -994,7 +994,7 @@ MLINKS+=rtalloc.9 rtalloc1.9 \
  	rtalloc.9 rtalloc_ign.9 \
  	rtalloc.9 RTFREE.9 \
  	rtalloc.9 rtfree.9
 -MLINKS+=runqueue.9 chooseproc.9 \
 +MLINKS+=runqueue.9 choosethread.9 \
  	runqueue.9 procrunnable.9 \
  	runqueue.9 remrunqueue.9 \
  	runqueue.9 setrunqueue.9
 
 Modified: head/share/man/man9/runqueue.9
 ==============================================================================
 --- head/share/man/man9/runqueue.9	Sun Aug 15 21:24:17 2010	(r211352)
 +++ head/share/man/man9/runqueue.9	Sun Aug 15 21:25:52 2010	(r211353)
 @@ -23,11 +23,11 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd November 3, 2000
 +.Dd August 15, 2010
  .Dt RUNQUEUE 9
  .Os
  .Sh NAME
 -.Nm chooseproc ,
 +.Nm choosethread ,
  .Nm procrunnable ,
  .Nm remrunqueue ,
  .Nm setrunqueue
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
Responsible-Changed-From-To: freebsd-doc->brueffer 
Responsible-Changed-By: brueffer 
Responsible-Changed-When: Sun Aug 15 23:38:32 CEST 2010 
Responsible-Changed-Why:  
Take this over. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=149549 
State-Changed-From-To: patched->closed 
State-Changed-By: brueffer 
State-Changed-When: Sun Jun 24 20:38:41 CEST 2012 
State-Changed-Why:  
MFCs done. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=149549 
>Unformatted:
