/[gentoo]/xml/htdocs/doc/en/handbook/hb-working-portage.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-working-portage.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.13 Revision 1.15
1<!-- The content of this document is licensed under the CC-BY-SA license --> 1<!-- The content of this document is licensed under the CC-BY-SA license -->
2<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 2<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
3 3
4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.13 2003/12/04 22:26:19 swift Exp $ --> 4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.15 2004/01/06 15:28:05 swift Exp $ -->
5 5
6<sections> 6<sections>
7<section> 7<section>
8<title>Obtaining Package Information</title> 8<title>Obtaining Package Information</title>
9<subsection> 9<subsection>
224 224
225<p> 225<p>
226You see something new? Yes, <e>downloaded files</e>. When you tell Portage to 226You see something new? Yes, <e>downloaded files</e>. When you tell Portage to
227install a package, it of course needs to have the necessary sources (or 227install a package, it of course needs to have the necessary sources (or
228precompiled packages) available. It therefore checks the contents of 228precompiled packages) available. It therefore checks the contents of
229<path>/usr/portage/distfiles</path> (for sourcecode) or 229<path>/usr/portage/distfiles</path> (for source code) or
230<path>/usr/portage/packages/All</path> (for precompiled packages) to see if the 230<path>/usr/portage/packages/All</path> (for precompiled packages) to see if the
231necessary files are already available. If not, it downloads the necessary files 231necessary files are already available. If not, it downloads the necessary files
232and places them in those directories. 232and places them in those directories.
233</p> 233</p>
234 234
235<!--
235<note> 236<note>
236Searching the Portage Tree, especially when using <c>--searchdesc</c>, is very 237Searching the Portage Tree, especially when using <c>- -searchdesc</c>, is very
237time consuming. There are other, more performant tools available. We will 238time consuming. There are other, more performant tools available. We will
238describe those in the chapter on <uri link="?part=2&amp;chap=7">Gentoolkit and 239describe those in the chapter on <uri link="?part=2&amp;chap=7">Gentoolkit and
239Other Tools</uri>. 240Other Tools</uri>.
240</note> 241</note>
242-->
241 243
242</body> 244</body>
243</subsection> 245</subsection>
244<subsection> 246<subsection>
245<title>Viewing the ChangeLog</title> 247<title>Viewing the ChangeLog</title>
298# <i>emerge --usepkg mirrorselect</i> 300# <i>emerge --usepkg mirrorselect</i>
299</pre> 301</pre>
300 302
301<p> 303<p>
302Now run <c>mirrorselect</c> to automatically select mirrors for you (it will 304Now run <c>mirrorselect</c> to automatically select mirrors for you (it will
303also setup Portage to use a mirror for the sourcecode): 305also setup Portage to use a mirror for the source code):
304</p> 306</p>
305 307
306<pre caption="Running mirrorselect"> 308<pre caption="Running mirrorselect">
307# <i>mirrorselect -a -s3</i> 309# <i>mirrorselect -a -s3</i>
308</pre> 310</pre>
341<title>Building or Prebuilt?</title> 343<title>Building or Prebuilt?</title>
342<body> 344<body>
343 345
344<p> 346<p>
345Gentoo provides ebuilds, the Gentoo packages if you like. But when you want to 347Gentoo provides ebuilds, the Gentoo packages if you like. But when you want to
346install such an ebuild, you can choose between <e>building</e> the package, or 348install such an ebuild, you can choose between <e>building</e> the package and
347using a <e>prebuilt</e> package. But what are the advantages/disadvantages of 349using a <e>prebuilt</e> package. But what are the advantages/disadvantages of
348both approaches, and can they be used next to each other? 350both approaches, and can they be used next to each other?
349</p> 351</p>
350 352
351<p> 353<p>
364<c>CFLAGS</c> &amp; <c>CXXFLAGS</c> variables. 366<c>CFLAGS</c> &amp; <c>CXXFLAGS</c> variables.
365</p> 367</p>
366 368
367<p> 369<p>
368As previously stated, prebuilt packages are stored in the 370As previously stated, prebuilt packages are stored in the
369<path>/usr/portage/packages/All</path> directory, while the sourcecode of the 371<path>/usr/portage/packages/All</path> directory, while the source code of the
370packages are placed in <path>/usr/portage/distfiles</path>. If you have finished 372packages is placed in <path>/usr/portage/distfiles</path>. If you have finished
371installing a package you can remove the package or sourcecode from the 373installing a package you can remove the package or source code from the
372respective directory. However, you might want to keep the package/sourcecode of 374respective directory. However, you might want to keep the package/source code of
373the latest version, just in case you want to reinstall the package (so you don't 375the latest version, just in case you want to reinstall the package (so you don't
374have to redownload it). 376have to redownload it).
375</p> 377</p>
376 378
377</body> 379</body>
391<pre caption="Building gnumeric"> 393<pre caption="Building gnumeric">
392# <i>emerge gnumeric</i> 394# <i>emerge gnumeric</i>
393</pre> 395</pre>
394 396
395<p> 397<p>
396This will download the sourcecode for you and unpacks, compiles and installs the 398This will download the source code for you and unpacks, compiles and installs
397package on your system. It will also do the same for all the dependencies. If 399the package on your system. It will also do the same for all the dependencies.
398you want to see what dependencies will be installed with it, use the 400If you want to see what dependencies will be installed with it, use the
399<c>--pretend</c> option (<c>-p</c> in short): 401<c>--pretend</c> option (<c>-p</c> in short):
400</p> 402</p>
401 403
402<pre caption="Pretending to build gnumeric"> 404<pre caption="Pretending to build gnumeric">
403# <i>emerge --pretend gnumeric</i> 405# <i>emerge --pretend gnumeric</i>
404</pre> 406</pre>
405 407
406<p> 408<p>
407If you want to download the sourcecode of the package and its dependencies, 409If you want to download the source code of the package and its dependencies,
408but don't want to build the package, use the <c>--fetchonly</c> option 410but don't want to build the package, use the <c>--fetchonly</c> option
409(<c>-f</c> in short): 411(<c>-f</c> in short):
410</p> 412</p>
411 413
412<pre caption="Fetching sources for gnumeric"> 414<pre caption="Fetching sources for gnumeric">
551<pre caption="Installing gnumeric without taking care of the dependencies"> 553<pre caption="Installing gnumeric without taking care of the dependencies">
552# <i>emerge --nodeps gnumeric</i> 554# <i>emerge --nodeps gnumeric</i>
553</pre> 555</pre>
554 556
555<p> 557<p>
556To opposite of <c>--nodeps</c> is <c>--onlydeps</c>, which will have Portage 558The opposite of <c>--nodeps</c> is <c>--onlydeps</c>, which will have Portage
557install all dependencies of a given package, but not the package itself: 559install all dependencies of a given package, but not the package itself:
558</p> 560</p>
559 561
560<pre caption="Installing the dependencies of gnumeric"> 562<pre caption="Installing the dependencies of gnumeric">
561# <i>emerge --onlydeps gnumeric</i> 563# <i>emerge --onlydeps gnumeric</i>
630 </li> 632 </li>
631 <li> 633 <li>
632 <e>R</e> (reemerge) The package isn't new, but needs to be reemerged 634 <e>R</e> (reemerge) The package isn't new, but needs to be reemerged
633 </li> 635 </li>
634 <li> 636 <li>
635 <e>F</e> (fetch) The package requires that you download the sourcecode 637 <e>F</e> (fetch) The package requires that you download the source code
636 manually (for instance due to licencing issues) 638 manually (for instance due to licencing issues)
637 </li> 639 </li>
638 <li> 640 <li>
639 <e>U</e> (update) The package already exists on your system but will be 641 <e>U</e> (update) The package already exists on your system but will be
640 upgraded 642 upgraded

Legend:
Removed from v.1.13  
changed lines
  Added in v.1.15

  ViewVC Help
Powered by ViewVC 1.1.20