annotate sources/README @ 1356:5198cfb8e368

Cosmetic tweak to miniconfig script.
author Rob Landley <rob@landley.net>
date Sat, 21 May 2011 23:38:59 -0500
parents 7d086d8fa348
children b74d36876c0a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
1 The following files live here:
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
2
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
3 include.sh: Common code included by every build stage. Defines many
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
4 environment variables, and sources the various *functions.sh.
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
5
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
6 functions.sh: Shell functions internal to Aboriginal Linux.
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
7
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
8 utility-functions.sh: Functions usable in contexts other than the Aboriginal
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
9 Linux build.
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
10
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
11 download-functions.sh: Functions to manage package source. (Download
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
12 tarballs, confirm checksums, extract and apply
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
13 patches, manage package cache.)
966
bd2ea96aac53 Update READMEs.
Rob Landley <rob@landley.net>
parents: 888
diff changeset
14
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
15 timeout.sh: Wrapper to run a command line with a timeout.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
16
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
17 baseconfig-linux: Common miniconfig shared by most architectures, to which
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
18 $LINUX_CONFIG from the target/$ARCH/settings is appended.
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
19
871
b274eb556b50 Merge common uclibc miniconfig stuff into baseconfig-uClibc, and add the few lines that vary per target to each target's settings file.
Rob Landley <rob@landley.net>
parents: 858
diff changeset
20 baseconfig-uClibc: Common miniconfig shared by all architectures, to which
b274eb556b50 Merge common uclibc miniconfig stuff into baseconfig-uClibc, and add the few lines that vary per target to each target's settings file.
Rob Landley <rob@landley.net>
parents: 858
diff changeset
21 $UCLIBC_CONFIG from the target/$ARCH/settings is appended.
b274eb556b50 Merge common uclibc miniconfig stuff into baseconfig-uClibc, and add the few lines that vary per target to each target's settings file.
Rob Landley <rob@landley.net>
parents: 858
diff changeset
22
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
23 The following subdirectories live here:
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
24
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
25 native: Files copied verbatim into each architecture's root-filesystem image.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
26
888
626288dd5cf3 Lots of comments.
Rob Landley <rob@landley.net>
parents: 871
diff changeset
27 toys: Various small code snippets written or maintained for this project.
858
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
28
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
29 sections: Package build scripts called more than once during build.sh.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
30 This is duplicate code factored out into a common location.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
31
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
32 patches: Patches applied to the packages listed in download.sh by "setupfor".
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
33 Each package has "$PACKAGE-*.patch" applied in alphabetical order,
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
34 or "alt-$PACKAGE-*.patch" for USE_UNSTABLE versions.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
35
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
36 targets: Configuration for each target platform, parsed by read_arch_dir()
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
37 and getconfig() in functions.sh. Each subdirectory is a
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
38 target name, and contains at least four files:
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
39
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
40 settings: Environment variables needed by the build.
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
41
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
42 miniconfig-linux: linux kernel .config compressed by toys/miniconfig.sh
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
43 (If miniconfig-alt-linux exists, USE_UNSTABLE=linux
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
44 will use that instead.)
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
45
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
46 miniconfig-uClibc: uClibc .config compressed by toys/miniconfig.sh
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
47 (If miniconfig-alt-uClibc exists, USE_UNSTABLE=uClibc
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
48 will use that instead.)
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
49
eda31d43d89f The sources directory needs a README.
Rob Landley <rob@landley.net>
parents:
diff changeset
50 description: Simple documentation about the platform
1315
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
51
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
52 root-filesystem: Files to be copied verbatim into the target filesystem.
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
53 Used by simple-root-filesystem.sh.
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
54
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
55 control-images: Scripts to generate control images, used to run automated
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
56 native builds under target system images. Used by
7d086d8fa348 Update some READMEs.
Rob Landley <rob@landley.net>
parents: 966
diff changeset
57 more/build-control-images.sh.