| 1 | <?xml version="1.0" encoding="UTF-8"?> |
1 | <?xml version="1.0" encoding="UTF-8"?> |
| 2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.14 2004/09/14 09:48:36 neysx Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.15 2004/09/21 15:47:19 neysx Exp $ --> |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | |
4 | |
| 5 | <guide link="/doc/en/gentoolkit.xml"> |
5 | <guide link="/doc/en/gentoolkit.xml"> |
| 6 | <title>Gentoolkit</title> |
6 | <title>Gentoolkit</title> |
| 7 | |
7 | |
| 8 | <author title="Author"> |
8 | <author title="Author"> |
| 9 | <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail> |
9 | <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail> |
| 10 | </author> |
10 | </author> |
| 11 | <author title="Editor"> |
11 | <author title="Editor"> |
| 12 | <!-- zhen@gentoo.org -->John P. Davis |
12 | <!-- zhen@gentoo.org -->John P. Davis |
| 13 | </author> |
13 | </author> |
| 14 | <author title="Editor"> |
14 | <author title="Editor"> |
| 15 | <mail link="erwin@gentoo.org">Erwin</mail> |
15 | <mail link="erwin@gentoo.org">Erwin</mail> |
| 16 | </author> |
16 | </author> |
| 17 | <author title="Editor"> |
17 | <author title="Editor"> |
| … | |
… | |
| 43 | discovered some of these complexities, they also wrote tools to help users and |
43 | discovered some of these complexities, they also wrote tools to help users and |
| 44 | administrators work around them. Many of these tools have been contributed to |
44 | administrators work around them. Many of these tools have been contributed to |
| 45 | the Gentoo project and are included in the package |
45 | the Gentoo project and are included in the package |
| 46 | <c>app-portage/gentoolkit</c>. |
46 | <c>app-portage/gentoolkit</c>. |
| 47 | </p> |
47 | </p> |
| 48 | |
48 | |
| 49 | <note> |
49 | <note> |
| 50 | As of now, there are two versions of gentoolkit: <c>app-portage/gentoolkit</c> |
50 | As of now, there are two versions of gentoolkit: <c>app-portage/gentoolkit</c> |
| 51 | and <c>app-portage/gentoolkit-dev</c>. While the former contains administration |
51 | and <c>app-portage/gentoolkit-dev</c>. While the former contains administration |
| 52 | scripts, the latter contains scripts specific to help development on Gentoo. |
52 | scripts, the latter contains scripts specific to help development on Gentoo. |
| 53 | This document discusses gentoolkit only. |
53 | This document discusses gentoolkit only. |
| 54 | </note> |
54 | </note> |
| 55 | |
55 | |
| 56 | <p> |
56 | <p> |
| 57 | Gentoolkit contains a whole bunch of useful tools to help manage your packages |
57 | Gentoolkit contains a whole bunch of useful tools to help manage your packages |
| 58 | and keep track of what is going on in your system. Most usersΜΆ -- particularly |
58 | and keep track of what is going on in your system. Most users -- particularly |
| 59 | those who update systems often -- will benefit from having gentoolkit |
59 | those who update systems often -- will benefit from having gentoolkit |
| 60 | installed. |
60 | installed. |
| 61 | </p> |
61 | </p> |
| 62 | |
62 | |
| 63 | </body> |
63 | </body> |
| 64 | </section> |
64 | </section> |
| 65 | <section> |
65 | <section> |
| 66 | <title>Installation</title> |
66 | <title>Installation</title> |
| 67 | <body> |
67 | <body> |
| 68 | |
68 | |
| 69 | <p> |
69 | <p> |
| 70 | Just as with any Gentoo package, installation is just a simple emerge. |
70 | Just as with any Gentoo package, installation is just a simple emerge. |
| 71 | </p> |
71 | </p> |
| 72 | |
72 | |
| 73 | <pre caption="Getting gentoolkit"> |
73 | <pre caption="Getting gentoolkit"> |
| … | |
… | |
| 434 | U I [ Found these USE variables in : net-analyzer/ethereal-0.10.6 ] |
434 | U I [ Found these USE variables in : net-analyzer/ethereal-0.10.6 ] |
| 435 | - - adns : Adds support for the adns DNS client library |
435 | - - adns : Adds support for the adns DNS client library |
| 436 | + + gtk : Adds support for x11-libs/gtk+ (The GIMP Toolkit) |
436 | + + gtk : Adds support for x11-libs/gtk+ (The GIMP Toolkit) |
| 437 | - - ipv6 : Adds support for IP version 6 |
437 | - - ipv6 : Adds support for IP version 6 |
| 438 | - - snmp : Adds support for the Simple Network Management Protocol if available |
438 | - - snmp : Adds support for the Simple Network Management Protocol if available |
| 439 | + + ssl : Adds support for Secure Socket Layer connections |
439 | + + ssl : Adds support for Secure Socket Layer connections |
| 440 | + + gtk2 : Use gtk+-2.0.0 over gtk+-1.2 in cases where a program supports both. |
440 | + + gtk2 : Use gtk+-2.0.0 over gtk+-1.2 in cases where a program supports both. |
| 441 | - - debug : Tells configure and the makefiles to build for debugging. Effects vary across packages, |
441 | - - debug : Tells configure and the makefiles to build for debugging. Effects vary across packages, |
| 442 | but generally it will at least add -g to CFLAGS. Remember to set FEATURES=nostrip too |
442 | but generally it will at least add -g to CFLAGS. Remember to set FEATURES=nostrip too |
| 443 | </pre> |
443 | </pre> |
| 444 | |
444 | |
| 445 | <p> |
445 | <p> |
| 446 | I have installed ethereal with only the gtk, ssl and gtk2 flags set, but the |
446 | I have installed ethereal with only the gtk, ssl and gtk2 flags set, but the |
| 447 | other USE flags for ethereal are adns, ipv6, snmp and debug. For more |
447 | other USE flags for ethereal are adns, ipv6, snmp and debug. For more |
| 448 | information on USE flags, please refer to the <uri |
448 | information on USE flags, please refer to the <uri |
| 449 | link="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1">USE |
449 | link="/doc/en/handbook/handbook-x86.xml?part=2&chap=1">USE Flags</uri> |
| 450 | Flags</uri> chapter of the <uri |
450 | chapter of the <uri link="/doc/en/handbook/">Gentoo Handbook</uri>. |
| 451 | link="http://www.gentoo.org/doc/en/handbook/">Gentoo Handbook</uri>. |
|
|
| 452 | </p> |
451 | </p> |
| 453 | |
452 | |
| 454 | </body> |
453 | </body> |
| 455 | </section> |
454 | </section> |
| 456 | <section> |
455 | <section> |
| 457 | <title>Where's the ebuild?</title> |
456 | <title>Where's the ebuild?</title> |
| 458 | <body> |
457 | <body> |
| 459 | |
458 | |
| 460 | <p> |
459 | <p> |
| 461 | We can also find out which ebuild is being used for a specific package using |
460 | We can also find out which ebuild is being used for a specific package using |
| 462 | <c>equery</c>. This is done my using the <c>equery which</c> command which |
461 | <c>equery</c>. This is done my using the <c>equery which</c> command which |
| 463 | displays the full path to the ebuild. |
462 | displays the full path to the ebuild. |
| 464 | </p> |
463 | </p> |
| 465 | |
464 | |
| 466 | <pre caption="Displaying the ebuild path"> |
465 | <pre caption="Displaying the ebuild path"> |
| … | |
… | |
| 506 | </p> |
505 | </p> |
| 507 | |
506 | |
| 508 | </body> |
507 | </body> |
| 509 | </section> |
508 | </section> |
| 510 | </chapter> |
509 | </chapter> |
| 511 | |
510 | |
| 512 | <chapter> |
511 | <chapter> |
| 513 | <title>euse</title> |
512 | <title>euse</title> |
| 514 | <section> |
513 | <section> |
| 515 | <title>Introduction</title> |
514 | <title>Introduction</title> |
| 516 | <body> |
515 | <body> |
| 517 | |
516 | |
| 518 | <p> |
517 | <p> |
| 519 | <c>euse</c> is a tool to see, set and unset USE flags at various places. For |
518 | <c>euse</c> is a tool to see, set and unset USE flags at various places. For |
| 520 | more information on USE flags, please refer to the <uri |
519 | more information on USE flags, please refer to the <uri |
| 521 | link="http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1">USE |
520 | link="/doc/en/handbook/handbook-x86.xml?part=2&chap=1">USE Flags</uri>. |
| 522 | Flags</uri>. <c>euse -i</c> lists all USE flags. |
521 | <c>euse -i</c> lists all USE flags. |
| 523 | </p> |
522 | </p> |
| 524 | |
523 | |
| 525 | </body> |
524 | </body> |
| 526 | </section> |
525 | </section> |
| 527 | <section> |
526 | <section> |
| 528 | <title>Reading, Setting and Unsetting USE Flags</title> |
527 | <title>Reading, Setting and Unsetting USE Flags</title> |
| 529 | <body> |
528 | <body> |
| 530 | |
529 | |
| 531 | <p> |
530 | <p> |
| 532 | The <c>euse --conf</c> command reads the current USE flags set/unset from |
531 | The <c>euse --conf</c> command reads the current USE flags set/unset from |
| 533 | make.conf. |
532 | make.conf. |
| 534 | </p> |
533 | </p> |
| 535 | |
534 | |
| 536 | <pre caption="Viewing Current flags from make.conf"> |
535 | <pre caption="Viewing Current flags from make.conf"> |
| 537 | # <i> euse --conf</i> |
536 | # <i> euse --conf</i> |
| … | |
… | |
| 664 | If you need to rebuild some packages, you may run <c>revdep-rebuild</c> without |
663 | If you need to rebuild some packages, you may run <c>revdep-rebuild</c> without |
| 665 | the <c>-p</c> flag and the listed packages will be emerged again. |
664 | the <c>-p</c> flag and the listed packages will be emerged again. |
| 666 | </p> |
665 | </p> |
| 667 | |
666 | |
| 668 | </body> |
667 | </body> |
| 669 | </section> |
668 | </section> |
| 670 | |
669 | |
| 671 | <section> |
670 | <section> |
| 672 | <title>glsa-check</title> |
671 | <title>glsa-check</title> |
| 673 | <body> |
672 | <body> |
| 674 | |
673 | |
| 675 | <p> |
674 | <p> |
| 676 | <c>glsa-check</c> is mainly a test tool that keeps track of the various GLSA's |
675 | <c>glsa-check</c> is mainly a test tool that keeps track of the various GLSA's |
| 677 | (Gentoo Linux Security Advisory) and will eventually be integrated into |
676 | (Gentoo Linux Security Advisory) and will eventually be integrated into |
| 678 | <c>emerge</c> and <c>equery</c>. For more information, please visit the <uri |
677 | <c>emerge</c> and <c>equery</c>. For more information, please visit the <uri |
| 679 | link="http://www.gentoo.org/proj/en/portage/glsa-integration.xml">Portage GLSA |
678 | link="/proj/en/portage/glsa-integration.xml">Portage GLSA Integration |
| 680 | Integration Page</uri>. |
679 | Page</uri>. |
| 681 | </p> |
680 | </p> |
| 682 | |
681 | |
| 683 | </body> |
682 | </body> |
| 684 | </section> |
683 | </section> |
| 685 | </chapter> |
684 | </chapter> |
| 686 | |
685 | |
| 687 | </guide> |
686 | </guide> |