<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugs.freebsd.org/bugzilla/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4.1"
          urlbase="https://bugs.freebsd.org/bugzilla/"
          
          maintainer="bugmeister@FreeBSD.org"
>

    <bug>
          <bug_id>39858</bug_id>
          
          <creation_ts>2002-06-25 23:40:03 +0000</creation_ts>
          <short_desc>handbook/cutting-edge/chapter.sgml: various fixes</short_desc>
          <delta_ts>2002-07-16 02:32:28 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>Documentation</product>
          <component>Books &amp; Articles</component>
          <version>Latest</version>
          <rep_platform>Any</rep_platform>
          <op_sys>Any</op_sys>
          <bug_status>Closed</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Normal</priority>
          <bug_severity>Affects Only Me</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Chris Pepper">pepper</reporter>
          <assigned_to name="Giorgos Keramidas">keramida</assigned_to>
          
          

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>127299</commentid>
    <comment_count>0</comment_count>
    <who name="Chris Pepper">pepper</who>
    <bug_when>2002-06-25 23:40:03 +0000</bug_when>
    <thetext>	Removed some inline tabs and trailing whitespace.
	The docs suggest dropping to single-user before doing anything, but point out this can be deferred until the actual installation phase. Inserted a reminder on when to go single, if deferring.
	Clarified when &quot;adjkerntz -i&quot; is required -- it seemed to cause some trouble once when I ran it unnecessarily.
	Removed suggestion re: &quot;make -j 4&quot; on single-CPU systems. This has been confirmed on -questions to cause a slowdown, rather than faster building.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>127303</commentid>
    <comment_count>1</comment_count>
    <who name="Martin Heinen">martin</who>
    <bug_when>2002-06-26 08:24:42 +0000</bug_when>
    <thetext>On Tue, Jun 25, 2002 at 06:34:40PM -0400, Chris Pepper wrote:
&gt; 
&gt; &gt;Number:         39858
&gt; &gt;Category:       docs
&gt; &gt;Synopsis:       handbook/cutting-edge/chapter.sgml: various fixes

&gt;  	      &lt;listitem&gt;
&gt;  		&lt;para&gt;Pass the &lt;option&gt;-j&amp;lt;n&amp;gt;&lt;/option&gt; option to &amp;man.make.1; to
&gt; -		  run multiple processes in parallel.  This usually helps 
&gt; -		  regardless of whether you have a single or a multi processor
&gt; -		  machine.&lt;/para&gt;
&gt; +		  run multiple processes in parallel.&lt;/para&gt;
&gt;  	      &lt;/listitem&gt;

While we&apos;re here, we should replace &amp;lt;/&amp;gt; with &lt;replaceable&gt;.

-- 
Marxpitn</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>127300</commentid>
    <comment_count>2</comment_count>
    <who name="Giorgos Keramidas">keramida</who>
    <bug_when>2002-07-15 04:22:12 +0000</bug_when>
    <thetext>State Changed
From-To: open-&gt;patched

I&apos;ve extracted parts of the diff in this PR and committed them. 
Thanks for submitting this :) 


</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>127301</commentid>
    <comment_count>3</comment_count>
    <who name="Giorgos Keramidas">keramida</who>
    <bug_when>2002-07-15 04:22:12 +0000</bug_when>
    <thetext>Responsible Changed
From-To: freebsd-doc-&gt;keramida</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>127302</commentid>
    <comment_count>4</comment_count>
    <who name="Tom Rhodes">trhodes</who>
    <bug_when>2002-07-16 02:31:11 +0000</bug_when>
    <thetext>State Changed
From-To: patched-&gt;closed

I rewrote the only part of this patch which was not applied.  My patch 
adds a note about the use of chflags(1) and installkernel.  Thanks for the 
submission!</thetext>
  </long_desc>
      
          <attachment
              isobsolete="0"
              ispatch="1"
              isprivate="0"
          >
            <attachid>23108</attachid>
            <date>2002-06-25 23:40:03 +0000</date>
            <delta_ts>2002-06-25 23:40:03 +0000</delta_ts>
            <desc>chapter.sgml.diff</desc>
            <filename>chapter.sgml.diff</filename>
            <type>text/plain</type>
            <size>5175</size>
            <attacher name="Chris Pepper">pepper</attacher>
            
              <data encoding="base64">SW5kZXg6IGNoYXB0ZXIuc2dtbAo9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09ClJDUyBmaWxlOiAvaG9tZS9uY3ZzL2RvYy9l
bl9VUy5JU084ODU5LTEvYm9va3MvaGFuZGJvb2svY3V0dGluZy1lZGdlL2NoYXB0ZXIuc2dtbCx2
CnJldHJpZXZpbmcgcmV2aXNpb24gMS4xMjcKZGlmZiAtdSAtcjEuMTI3IGNoYXB0ZXIuc2dtbAot
LS0gY2hhcHRlci5zZ21sCTIwMDIvMDYvMjMgMjE6MTM6NTAJMS4xMjcKKysrIGNoYXB0ZXIuc2dt
bAkyMDAyLzA2LzI1IDIxOjI4OjMwCkBAIC03NDYsNyArNzQ2LDcgQEAKIAlmcm9tIHRoZSBvYnZp
b3VzIGJlbmVmaXQgb2YgbWFraW5nIHRoaW5ncyBnbyBzbGlnaHRseSBmYXN0ZXIsCiAJcmVpbnN0
YWxsaW5nIHRoZSBzeXN0ZW0gd2lsbCB0b3VjaCBhIGxvdCBvZiBpbXBvcnRhbnQgc3lzdGVtCiAJ
ZmlsZXMsIGFsbCB0aGUgc3RhbmRhcmQgc3lzdGVtIGJpbmFyaWVzLCBsaWJyYXJpZXMsIGluY2x1
ZGUgZmlsZXMKLQlhbmQgc28gb24uICBDaGFuZ2luZyB0aGVzZSBvbiBhICBydW5uaW5nIHN5c3Rl
bSAocGFydGljdWxhcmx5IGlmCisJYW5kIHNvIG9uLiAgQ2hhbmdpbmcgdGhlc2Ugb24gYSBydW5u
aW5nIHN5c3RlbSAocGFydGljdWxhcmx5IGlmCiAJeW91IGhhdmUgYWN0aXZlIHVzZXJzIG9uIHRo
ZSBzeXN0ZW0gYXQgdGhlIHRpbWUpIGlzIGFza2luZyBmb3IKIAl0cm91YmxlLjwvcGFyYT4KIApA
QCAtNzU0LDcgKzc1NCw5IEBACiAgICAgICA8cGFyYT5Bbm90aGVyIG1ldGhvZCBpcyB0byBjb21w
aWxlIHRoZSBzeXN0ZW0gaW4gbXVsdGktdXNlciBtb2RlLCBhbmQKICAgICAgICAgdGhlbiBkcm9w
IGludG8gc2luZ2xlIHVzZXIgbW9kZSBmb3IgdGhlIGluc3RhbGxhdGlvbi4gIElmIHlvdSB3b3Vs
ZAogICAgICAgICBsaWtlIHRvIGRvIGl0IHRoaXMgd2F5LCBzaW1wbHkgaG9sZCBvZmYgb24gdGhl
IGZvbGxvd2luZyBzdGVwcyB1bnRpbAotICAgICAgICB0aGUgYnVpbGQgaGFzIGNvbXBsZXRlZC48
L3BhcmE+CisgICAgICAgIHRoZSBidWlsZHMgaGF2ZSBjb21wbGV0ZWQ7IGRyb3AgdG8gc2luZ2xl
LXVzZXIgbW9kZSBiZWZvcmUgdXNpbmcKKyAgICAgICAgPG1ha2V0YXJnZXQ+aW5zdGFsbGtlcm5l
bDwvbWFrZXRhcmdldD4gb3IKKyAgICAgICAgPG1ha2V0YXJnZXQ+aW5zdGFsbHdvcmxkPC9tYWtl
dGFyZ2V0Pi48L3BhcmE+CiAKICAgICAgIDxwYXJhPkFzIHRoZSBzdXBlcnVzZXIsIHlvdSBjYW4g
ZXhlY3V0ZTwvcGFyYT4KIApAQCAtNzc4LDcgKzc4MCw5IEBACiAKIAogICAgICAgICA8bm90ZT4K
LSAgICAgICAgICA8cGFyYT5JZiB5b3VyIENNT1MgY2xvY2sgaXMgc2V0IHRvIGxvY2FsIHRpbWUg
YW5kIG5vdCB0byBHTVQsCisgICAgICAgICAgPHBhcmE+SWYgeW91ciBDTU9TIGNsb2NrIGlzIHNl
dCB0byBsb2NhbCB0aW1lIGFuZCBub3QgdG8gR01UCisgICAgICAgICAgICAoaWYgdGhlIG91dHB1
dCBvZiB0aGUgPGNvbW1hbmQ+ZGF0ZTwvY29tbWFuZD4gZG9lc24ndCBzaG93IHRoZQorICAgICAg
ICAgICAgY29ycmVjdCB0aW1lIGFuZCB6b25lKSwKICAgICAgICAgICAgIHlvdSBtYXkgYWxzbyBu
ZWVkIHRvIHJ1biB0aGUgZm9sbG93aW5nIGNvbW1hbmQ6PC9wYXJhPgogPHNjcmVlbj4mcHJvbXB0
LnJvb3Q7IDx1c2VyaW5wdXQ+YWRqa2VybnR6IC1pPC91c2VyaW5wdXQ+PC9zY3JlZW4+CiAKQEAg
LTgzMCw5ICs4MzQsOSBAQAogCSAgd2hlbiB0aGUgcHJvY2VzcyBoYXMgZmluaXNoZWQuPC9wYXJh
PgogCiAJPHNjcmVlbj4mcHJvbXB0LnJvb3Q7IDx1c2VyaW5wdXQ+c2NyaXB0IC92YXIvdG1wL213
Lm91dDwvdXNlcmlucHV0PgotU2NyaXB0IHN0YXJ0ZWQsIG91dHB1dCBmaWxlIGlzIC92YXIvdG1w
L213Lm91dAkgCitTY3JpcHQgc3RhcnRlZCwgb3V0cHV0IGZpbGUgaXMgL3Zhci90bXAvbXcub3V0
CiAmcHJvbXB0LnJvb3Q7IDx1c2VyaW5wdXQ+bWFrZSBUQVJHRVQ8L3VzZXJpbnB1dD4KLTxlbXBo
YXNpcz4maGVsbGlwOyBjb21waWxlLCBjb21waWxlLCBjb21waWxlICZoZWxsaXA7PC9lbXBoYXNp
cz4JICAKKzxlbXBoYXNpcz4maGVsbGlwOyBjb21waWxlLCBjb21waWxlLCBjb21waWxlICZoZWxs
aXA7PC9lbXBoYXNpcz4KICZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5leGl0PC91c2VyaW5wdXQ+
CiBTY3JpcHQgZG9uZSwgJmhlbGxpcDs8L3NjcmVlbj4KIApAQCAtOTQ0LDE4ICs5NDgsOCBAQAog
IAogICAgICAgICA8cGFyYT5JdCBpcyBub3cgcG9zc2libGUgdG8gc3BlY2lmeSBhIDxvcHRpb24+
LWo8L29wdGlvbj4gb3B0aW9uIHRvCiAgICAgICAgICAgPGNvbW1hbmQ+bWFrZTwvY29tbWFuZD4g
d2hpY2ggd2lsbCBjYXVzZSBpdCB0byBzcGF3biBzZXZlcmFsCi0gICAgICAgICAgc2ltdWx0YW5l
b3VzIHByb2Nlc3Nlcy4gIFRoaXMgaXMgbW9zdCB1c2VmdWwgb24gbXVsdGktQ1BVIG1hY2hpbmVz
LgotICAgICAgICAgIEhvd2V2ZXIsIHNpbmNlIG11Y2ggb2YgdGhlIGNvbXBpbGluZyBwcm9jZXNz
IGlzIElPIGJvdW5kIHJhdGhlcgotICAgICAgICAgIHRoYW4gQ1BVIGJvdW5kIGl0IGlzIGFsc28g
dXNlZnVsIG9uIHNpbmdsZSBDUFUgbWFjaGluZXMuPC9wYXJhPgorICAgICAgICAgIHNpbXVsdGFu
ZW91cyBwcm9jZXNzZXMuICBUaGlzIGlzIG1vc3QgdXNlZnVsIG9uIG11bHRpLUNQVSBtYWNoaW5l
cy48L3BhcmE+CiAKLQk8cGFyYT5PbiBhIHR5cGljYWwgc2luZ2xlLUNQVSBtYWNoaW5lIHlvdSB3
b3VsZCBydW46PC9wYXJhPgotCSAgCi0JICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVzZXJpbnB1
dD5tYWtlIC1qNCBidWlsZHdvcmxkPC91c2VyaW5wdXQ+PC9zY3JlZW4+Ci0KLQk8cGFyYT4mbWFu
Lm1ha2UuMTsgd2lsbCB0aGVuIGhhdmUgdXAgdG8gNCBwcm9jZXNzZXMgcnVubmluZyBhdCBhbnkg
b25lCi0JICB0aW1lLiAgRW1waXJpY2FsIGV2aWRlbmNlIHBvc3RlZCB0byB0aGUgbWFpbGluZyBs
aXN0cyBzaG93cyB0aGlzCi0JICBnZW5lcmFsbHkgZ2l2ZXMgdGhlIGJlc3QgcGVyZm9ybWFuY2Ug
YmVuZWZpdC48L3BhcmE+Ci0KIAk8cGFyYT5JZiB5b3UgaGF2ZSBhIG11bHRpLUNQVSBtYWNoaW5l
IGFuZCB5b3UgYXJlIHVzaW5nIGFuIFNNUAogCSAgY29uZmlndXJlZCBrZXJuZWwgdHJ5IHZhbHVl
cyBiZXR3ZWVuIDYgYW5kIDEwIGFuZCBzZWUgaG93IHRoZXkgc3BlZWQKIAkgIHRoaW5ncyB1cC48
L3BhcmE+CkBAIC0xMDAwLDcgKzk5NCw3IEBACiAJc3lzdGVtIGJhY2sgdG8gc2luZ2xlIHVzZXIg
bW9kZS4gIFRoaXMgaXMgYSBnb29kIHRlc3QgdGhhdCB0aGUgbmV3CiAJc3lzdGVtIHdvcmtzIHBy
b3Blcmx5LiAgQWZ0ZXIgYm9vdGluZyBmcm9tCiAJPGZpbGVuYW1lPkdFTkVSSUM8L2ZpbGVuYW1l
PiBhbmQgdmVyaWZ5aW5nIHRoYXQgeW91ciBzeXN0ZW0gd29ya3MgeW91Ci0JY2FuIHRoZW4gYnVp
bGQgYSBuZXcga2VybmVsIGJhc2VkIG9uIHlvdXIgbm9ybWFsIGtlcm5lbAljb25maWd1cmF0aW9u
CisJY2FuIHRoZW4gYnVpbGQgYSBuZXcga2VybmVsIGJhc2VkIG9uIHlvdXIgbm9ybWFsIGtlcm5l
bCBjb25maWd1cmF0aW9uCiAJZmlsZS48L3BhcmE+CiAKICAgICAgIDxwYXJhPklmIHlvdSBhcmUg
dXBncmFkaW5nIHRvICZvczsgNC4wIG9yIGFib3ZlIHRoZW4gdGhlIG9sZApAQCAtMTAwOCwxMiAr
MTAwMiwyMiBAQAogCWlzIGRlcHJlY2F0ZWQuICBJbnN0ZWFkLCB5b3Ugc2hvdWxkIHJ1biB0aGVz
ZSBjb21tYW5kcwogCTxlbXBoYXNpcz5hZnRlcjwvZW1waGFzaXM+IHlvdSBoYXZlIDxsaW5rCiAg
ICAgICAgIGxpbmtlbmQ9Im1ha2UtYnVpbGR3b3JsZCI+YnVpbHQgdGhlIHdvcmxkIHdpdGgKLSAg
ICAgICAgPG1ha2V0YXJnZXQ+YnVpbGR3b3JsZDwvbWFrZXRhcmdldD48L2xpbms+LjwvcGFyYT4g
CisgICAgICAgIDxtYWtldGFyZ2V0PmJ1aWxkd29ybGQ8L21ha2V0YXJnZXQ+PC9saW5rPi48L3Bh
cmE+CiAKKyAgICAgIDxub3RlPgorCTxwYXJhPklmIHlvdSBhcmUgYnVpbGRpbmcgaW4gbXVsdGkt
dXNlciBtb2RlLCB5b3UnbGwgbmVlZCB0byBkcm9wIHRvCisJICBzaW5nbGUgdXNlciBtb2RlIGJl
Zm9yZSB1c2luZyA8Y29tbWFuZD5tYWtlCisJICBpbnN0YWxsa2VybmVsPC9jb21tYW5kPjsgZGV0
YWlscyBhcmUgaW4gPHhyZWYgbGlua2VuZD0ibWFrZXdvcmxkLXNpbmdsZXVzZXIiPi48L3BhcmE+
CisgICAgICA8L25vdGU+CisKICAgICAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0
PmNkIC91c3Ivc3JjPC91c2VyaW5wdXQ+CiAmcHJvbXB0LnJvb3Q7IDx1c2VyaW5wdXQ+bWFrZSBi
dWlsZGtlcm5lbDwvdXNlcmlucHV0PgogJnByb21wdC5yb290OyA8dXNlcmlucHV0Pm1ha2UgaW5z
dGFsbGtlcm5lbDwvdXNlcmlucHV0Pjwvc2NyZWVuPgpAQCAtMTA0NSw3ICsxMDQ5LDcgQEAKICZw
cm9tcHQucm9vdDsgPHVzZXJpbnB1dD5tYWtlIGluc3RhbGx3b3JsZDwvdXNlcmlucHV0Pjwvc2Ny
ZWVuPgogCiAgICAgICA8bm90ZT4KLQk8cGFyYT5JZiB5b3Ugc3BlY2lmaWVkIHZhcmlhYmxlcyBv
biB0aGUJICA8Y29tbWFuZD5tYWtlCisJPHBhcmE+SWYgeW91IHNwZWNpZmllZCB2YXJpYWJsZXMg
b24gdGhlIDxjb21tYW5kPm1ha2UKIAkgICAgYnVpbGR3b3JsZDwvY29tbWFuZD4gY29tbWFuZCBs
aW5lLCB5b3UgbXVzdCBzcGVjaWZ5IHRoZSBzYW1lCiAJICB2YXJpYWJsZXMgaW4gdGhlIDxjb21t
YW5kPm1ha2UgaW5zdGFsbHdvcmxkPC9jb21tYW5kPiBjb21tYW5kCiAJICBsaW5lLiAgVGhpcyBk
b2VzIG5vdCBuZWNlc3NhcmlseSBob2xkIHRydWUgZm9yIG90aGVyIG9wdGlvbnM7CkBAIC0xNjAx
LDkgKzE2MDUsNyBAQAogCSAgICAgIAogCSAgICAgIDxsaXN0aXRlbT4KIAkJPHBhcmE+UGFzcyB0
aGUgPG9wdGlvbj4taiZsdDtuJmd0Ozwvb3B0aW9uPiBvcHRpb24gdG8gJm1hbi5tYWtlLjE7IHRv
Ci0JCSAgcnVuIG11bHRpcGxlIHByb2Nlc3NlcyBpbiBwYXJhbGxlbC4gIFRoaXMgdXN1YWxseSBo
ZWxwcyAKLQkJICByZWdhcmRsZXNzIG9mIHdoZXRoZXIgeW91IGhhdmUgYSBzaW5nbGUgb3IgYSBt
dWx0aSBwcm9jZXNzb3IKLQkJICBtYWNoaW5lLjwvcGFyYT4KKwkJICBydW4gbXVsdGlwbGUgcHJv
Y2Vzc2VzIGluIHBhcmFsbGVsLjwvcGFyYT4KIAkgICAgICA8L2xpc3RpdGVtPgogCSAgICAgIAog
CSAgICAgIDxsaXN0aXRlbT48cGFyYT5UaGUgZmlsZXN5c3RlbSBob2xkaW5n
</data>

          </attachment>
      

    </bug>

</bugzilla>