/[gentoo-x86]/Gentoo-HOWTO
Gentoo

Contents of /Gentoo-HOWTO

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (hide annotations) (download)
Wed Feb 21 20:34:24 2001 UTC (18 years, 9 months ago) by pete
Branch: MAIN
added Gentoo-HOWTO

1 pete 1.1 Gentoo-HOWTO
2     Written by Peter Gavin <pete@gentoo.org> and other members of the
3     Gentoo Team
4    
5     ------------------------------------------------------------------------
6    
7     Contents
8    
9     I. Introduction
10     II. The Portage Tree
11     A. What (Not) to Put in the Portage Tree
12     B. Categories
13     C. The files Directory
14     III. .ebuild Files
15     A. Naming .ebuild Files
16     B. Contents of an .ebuild File
17     C. Rules for Writing an .ebuild File
18     IV. Filesystem Locations
19     A. Introduction to the FHS
20     B. How to Fit Your Packages into the Filesystem
21    
22     ------------------------------------------------------------------------
23    
24     I. Introduction
25    
26     blah, blah, blah... (I'll fill this in later)
27    
28     II. The Portage Tree
29    
30     The portage tree is a heirarchy, in which the first level is
31     the category, and the second is the name of the package.
32    
33     A. What (Not) to Put in the Portage Tree
34    
35     The portage tree should only include ebuild files, and other
36     files in the 'files' directory for each package. No binary
37     files should be placed in the portage tree. No files that can
38     be downloaded from other sources (such as patches written by
39     other people) should be put here. No patches you write
40     yourself should be compressed.
41    
42     B. Categories
43    
44     The categories are defined as follows:
45    
46     app-admin - non-critical system administration utilities
47    
48     app-arch - non-critical archival/compression utilities
49    
50     app-cdr - CD recording utilities
51    
52     app-doc - application documentation
53    
54     app-editors - non-critical text editors
55    
56     app-emulation - packages for emulating other systems/OSes
57    
58     app-misc - applications that don't fit anywhere else
59    
60     app-office - office-type (word processing, spreadsheet, etc.)
61     packages
62    
63     app-shells - non-critical shells and command interpreters
64    
65     app-text - text processing, spell checkers, and document
66     formatting packages
67    
68     dev-db - database libraries
69    
70     dev-java - java classes/packages/etc.
71    
72     dev-lang - compilers and interpreters for different languages
73    
74     dev-libs - miscellaneous developer's libraries
75    
76     dev-perl - perl modules
77    
78     dev-python - python modules
79    
80     dev-ruby - ruby modules
81    
82     dev-util - various developers utilities
83    
84     gnome-apps - applications for gnome
85    
86     gnome-base - base gnome packages
87    
88     gnome-libs - non-essential gnome libraries
89    
90     gnome-office - office packages for gnome
91    
92     kde-apps - applications for kde
93    
94     kde-base - base kde packages
95    
96     kde-i18n - kde internationalization packages
97    
98     media-gfx - graphics related programs
99    
100     media-libs - libraries for manipulating different media,
101     including accessing multimedia peripherals of your
102     computer (sound card, video card, etc.)
103    
104     media-sound - programs related to sound, including cd-audio
105     and sound encoding
106    
107     media-video - programs related to video, including video
108     codecs and players
109    
110     net-analyzer - network usage statistics monitors/analyzers
111    
112     net-dialup - network dialup clients and servers such as pppd
113    
114     net-fs - network filesystems
115    
116     net-ftp - ftp servers and clients
117    
118     net-irc - irc servers and clients
119    
120     net-libs - networking related libraries
121    
122     net-mail - mtas and muas
123    
124     net-misc - miscellaneous servers, clients, firewalls, etc.
125    
126     net-nds - NIS/NIS+ and other name services
127    
128     net-print - print servers and clients
129    
130     net-www - http/www servers and clients
131    
132     sys-apps - system-critical applications and utilities
133    
134     sys-build - stuff thats in the build tarball; you don't
135     normally need any of these packages unless you are
136     building your entire system from scratch.
137    
138     sys-devel - base development packages, such as gcc and make
139    
140     sys-kernel - linux kernels
141    
142     sys-libs - system-critical libraries such as glibc
143    
144     x11-base - xfree86 and xfree86 drivers for various video cards
145    
146     x11-libs - widget sets and other x11 specific libraries
147    
148     x11-terms - x11 terminal emulators
149    
150     x11-wm - x11 window managers
151    
152     Note: the sys-* categories, other than sys-build, will be
153     removed soon.
154    
155     C. The files Directory
156    
157     Under each package subdirectory is a 'files' directory. You
158     should place any patches, configuration files, and other
159     auxillary files your package might require in this
160     directory. Patches you create yourself just to get your
161     package to build should be called '${PF}-gentoo.diff'. You
162     should not compress these diffs, since 1) they should not be big
163     enough to require compressing, and 2) cvs does not play well
164     with binary files.

  ViewVC Help
Powered by ViewVC 1.1.20