diff options
author | Ciaran McCreesh <ciaran.mccreesh@googlemail.com> | 2009-04-11 20:48:43 +0100 |
---|---|---|
committer | Ciaran McCreesh <ciaran.mccreesh@googlemail.com> | 2009-04-23 23:56:39 +0100 |
commit | ef961a6f9b91fc0e4ff41da84a3f92888c13d116 (patch) | |
tree | e6e038a62f21526db08fd65a4dd92f0b1e0ac170 /tree-layout.tex | |
parent | Move EAPI definitions into its own chapter. (diff) | |
download | pms-ef961a6f9b91fc0e4ff41da84a3f92888c13d116.tar.gz pms-ef961a6f9b91fc0e4ff41da84a3f92888c13d116.tar.bz2 pms-ef961a6f9b91fc0e4ff41da84a3f92888c13d116.zip |
Move metadata cache into its own chapter.
Also clarify that the cache can contain bogus entries or be incomplete.
Diffstat (limited to 'tree-layout.tex')
-rw-r--r-- | tree-layout.tex | 40 |
1 files changed, 2 insertions, 38 deletions
diff --git a/tree-layout.tex b/tree-layout.tex index 7c1059f..e49a931 100644 --- a/tree-layout.tex +++ b/tree-layout.tex @@ -244,44 +244,8 @@ various XML files used in the repository, and repository timestamps. \subsection{The metadata cache} -The \t{metadata/cache} directory contains a cached form of all important ebuild metadata variables. -The cache directory, if it exists, contains directories whose names are the same as categories in -the repository---not all categories and packages must be contained in it. Each subdirectory may -optionally contain one file per package version in that category, named \t{<package>-<version>}, -in the following format: - -Each cache file contains the textual values of various metadata keys, one per line, in the following -order. Other lines may be present following these; their meanings are not defined here. - -\begin{compactenum} -\item Build-time dependencies (\t{DEPEND}) -\item Run-time dependencies (\t{RDEPEND}) -\item Slot (\t{SLOT}) -\item Source tarball URIs (\t{SRC\_URI}) -\item \t{RESTRICT} -\item Package homepage (\t{HOMEPAGE}) -\item Package license (\t{LICENSE}) -\item Package description (\t{DESCRIPTION}) -\item Package keywords (\t{KEYWORDS}) -\item Inherited eclasses (\t{INHERITED}) -\item Use flags that this package respects (\t{IUSE}) -\item No longer used; this line is to be ignored. -\item Post dependencies (\t{PDEPEND}) -\item Old-style virtuals provided by this package (\t{PROVIDE}) -\item The ebuild API version to which this package conforms (\t{EAPI}) -\item Properties (\t{PROPERTIES}). In some EAPIs, may optionally be blank, regardless of ebuild - metadata; see table~\ref{tab:properties-table}. -\item Defined phases (\t{DEFINED\_PHASES}). In some EAPIs, may optionally be blank, regardless of - ebuild metadata; see table~\ref{tab:defined-phases-table}. -\item Blank lines to pad the file to 22 lines long -\end{compactenum} - -Future EAPIs may define new variables, remove existing variables, change the line number or -format used for a particular variable, add or reduce the total length of the file and so on. -Any future EAPI that uses this cache format will continue to place the EAPI value on -line 15 if such a concept makes sense for that EAPI, and will place a value that is clearly -not a supported EAPI on line 15 if it does not. - +The \t{metadata/cache} directory may contain a cached form of all important ebuild metadata +variables. The contents of this directory are described in section~\ref{metadata-cache}. % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en : %%% Local Variables: |