1===============================
2Boot Volume Directory Structure
3===============================
4This is the directory layout of the boot volume::
5
6  home/config
7  	<like system, but without haiku_loader, kernel_<arch>, and runtime_loader>
8
9  system
10  	add-ons
11  	apps
12  	bin
13  	boot
14  	cache*
15  	data
16  	demos
17  	develop
18  	documentation
19  	lib
20  	non-packaged*
21  	packages*
22  	preferences
23  	servers
24  	settings*
25  	var*
26
27  	haiku_loader
28  	kernel_<arch>
29  	runtime_loader
30
31  trash
32
33The structure mostly equals the pre-package management directory structure with
34the following changes:
35
36- ``common`` has been removed, or more correctly it has been merged into
37  ``system``. All system-wide software is now installed (only) in ``system``.
38- The ``develop`` directory has been removed and its contents has been moved to
39  the ``system/develop`` directory.
40- The ``include`` directory has been removed. Its contents lives in
41  ``develop/headers`` now.
42- ``optional`` has been removed. Optional features can just be installed via the
43  package manager.
44- ``share`` and ``etc`` (in ``common``) have been removed. Their contents goes
45  to ``data``, ``documentation``, or ``settings`` (in ``system`` or, for
46  packages installed there, in ``home``) as appropriate. There's
47  ``settings/etc`` which is where ported Unix software will usually store their
48  global settings.
49- ``apps`` and ``preferences`` have been moved to ``system`` for consistency.
50- ``system`` and ``home/config`` each sport a ``packages`` directory, which
51  contains the activated packages.
52- ``system`` and ``home/config`` themselves are mount points for two instances
53  of the packagefs, i.e. each contains the virtually extracted contents of the
54  activated packages in the respective ``packages`` subdirectory. The
55  directories marked with ``*`` are "shine-through" directories. They are not
56  provided by the packagefs, but are the underlying directories of the boot
57  volume. Unlike the other directories they are writable.
58- ``system`` and ``home/config`` each contain a directory ``non-packaged``
59  which has the same structure as their parent directory minus the shine-through
60  directories. In the ``non-packaged`` directories software can be installed the
61  traditional -- non-packaged -- way.
62