View | Details | Raw Unified | Return to bug 38880
Collapse All | Expand All

(-)chapter.sgml (-8 / +8 lines)
Lines 683-689 Link Here
683
    </sect2>
683
    </sect2>
684
684
685
    <sect2>
685
    <sect2>
686
      <title>Update the files of <filename>/etc</filename></title>
686
      <title>Update the files in <filename>/etc</filename></title>
687
687
688
      <para>The <filename>/etc</filename> directory contains a large part
688
      <para>The <filename>/etc</filename> directory contains a large part
689
	of your system's configuration information, as well as scripts
689
	of your system's configuration information, as well as scripts
Lines 1205-1211 Link Here
1205
	files, determining how they differ with your existing files.</para>
1205
	files, determining how they differ with your existing files.</para>
1206
    
1206
    
1207
      <para>Note that some of the files that will have been installed in
1207
      <para>Note that some of the files that will have been installed in
1208
	<filename>/var/tmp/root</filename> have a leading <quote/./.  At the
1208
	<filename>/var/tmp/root</filename> have a leading <quote>.</quote>.  At the
1209
	time of writing the only files like this are shell startup files in
1209
	time of writing the only files like this are shell startup files in
1210
	<filename>/var/tmp/root/</filename> and
1210
	<filename>/var/tmp/root/</filename> and
1211
	<filename>/var/tmp/root/root/</filename>, although there may be others
1211
	<filename>/var/tmp/root/root/</filename>, although there may be others
Lines 1451-1457 Link Here
1451
	    <para>At the end of the day, it is your call.  You might be happy
1451
	    <para>At the end of the day, it is your call.  You might be happy
1452
	      re-making the world every fortnight say, and let changes
1452
	      re-making the world every fortnight say, and let changes
1453
	      accumulate over that fortnight.  Or you might want to re-make
1453
	      accumulate over that fortnight.  Or you might want to re-make
1454
	      just those things that have changed, and are confident you can
1454
	      just those things that have changed, and be confident you can
1455
	      spot all the dependencies.</para>
1455
	      spot all the dependencies.</para>
1456
      
1456
      
1457
	    <para>And, of course, this all depends on how often you want to
1457
	    <para>And, of course, this all depends on how often you want to
Lines 1495-1508 Link Here
1495
      
1495
      
1496
	    <para><filename>/usr/obj</filename> contains all the object files
1496
	    <para><filename>/usr/obj</filename> contains all the object files
1497
	      that were produced during the compilation phase.  Normally, one
1497
	      that were produced during the compilation phase.  Normally, one
1498
	      of the first steps in the <quote/make world/ process is to
1498
	      of the first steps in the <quote>make world</quote> process is to
1499
	      remove this directory and start afresh.  In this case, keeping
1499
	      remove this directory and start afresh.  In this case, keeping
1500
	      <filename>/usr/obj</filename> around after you have finished
1500
	      <filename>/usr/obj</filename> around after you have finished
1501
	      makes little sense, and will free up a large chunk of disk space
1501
	      makes little sense, and will free up a large chunk of disk space
1502
	      (currently about 340MB).</para>
1502
	      (currently about 340MB).</para>
1503
      
1503
      
1504
	    <para>However, if you know what you are doing you can have
1504
	    <para>However, if you know what you are doing you can have
1505
	      <quote/make world/ skip this step.  This will make subsequent
1505
	      <quote>make world</quote> skip this step.  This will make subsequent
1506
	      builds run much faster, since most of sources will not need to
1506
	      builds run much faster, since most of sources will not need to
1507
	      be recompiled.  The flip side of this is that subtle dependency
1507
	      be recompiled.  The flip side of this is that subtle dependency
1508
	      problems can creep in, causing your build to fail in odd ways.
1508
	      problems can creep in, causing your build to fail in odd ways.
Lines 1511-1518 Link Here
1511
	      realising that it is because they have tried to cut
1511
	      realising that it is because they have tried to cut
1512
	      corners.</para>
1512
	      corners.</para>
1513
      
1513
      
1514
	    <para>If you want to live dangerously then make the world, passing
1514
	    <para>If you want to live dangerously then <command>make</command> the world, passing
1515
	      the <makevar>NOCLEAN</makevar> definition to <command>make</command>, like
1515
	      the <makevar>NOCLEAN</makevar> option to the <command>make</command>, like
1516
	      this:</para>
1516
	      this:</para>
1517
1517
1518
	    <screen>&prompt.root; <userinput>make -DNOCLEAN world</userinput></screen>
1518
	    <screen>&prompt.root; <userinput>make -DNOCLEAN world</userinput></screen>
Lines 1606-1612 Link Here
1606
	      </listitem>
1606
	      </listitem>
1607
	      
1607
	      
1608
	      <listitem>
1608
	      <listitem>
1609
		<para>Pass the <option>-j&lt;n&gt;</option> option to make to
1609
		<para>Pass the <option>-j&lt;n&gt;</option> option to &man.make.1; to
1610
		  run multiple processes in parallel.  This usually helps 
1610
		  run multiple processes in parallel.  This usually helps 
1611
		  regardless of whether you have a single or a multi processor
1611
		  regardless of whether you have a single or a multi processor
1612
		  machine.</para>
1612
		  machine.</para>

Return to bug 38880