diff options
author | Richard Purdie <richard.purdie@linuxfoundation.org> | 2011-08-12 00:30:22 +0100 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2011-08-12 17:21:19 +0100 |
commit | b85957b011afc163b7e9930e83adbfb922ddfae8 (patch) | |
tree | 224b28c7c4028c7ed033a29efebdde9545501248 /meta-yocto/conf/local.conf.sample.extended | |
parent | d31d5e5b34c889809af408aed7d4f353d0133750 (diff) | |
download | poky-b85957b011afc163b7e9930e83adbfb922ddfae8.tar.gz |
local.conf.sample: Cleanup and improve
local.conf is the first thing anyone new to the project sees. Over time it
has built up a ton cruft and isn't even accurate in places.
This patch:
* Moves things to local.conf.sample.extended if a new user is unlikely
to need to immediately care about the options
* Reorders the file to be more intuitive to a new user
* Moves certain default values to default-distrovars.inc in cases where
most users wouldn't want to change the value
* Adds large blocks of text to explain what an option does. There have
been too many cases of a user not realising what some of these
settings do and how they can use them to their advantage (like DL_DIR
for example).
(From OE-Core rev: a0ccb33ac5a2231c979c3369159f763dff1e0a2e)
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'meta-yocto/conf/local.conf.sample.extended')
-rw-r--r-- | meta-yocto/conf/local.conf.sample.extended | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/meta-yocto/conf/local.conf.sample.extended b/meta-yocto/conf/local.conf.sample.extended index 277ee2a8ec..a42774cfac 100644 --- a/meta-yocto/conf/local.conf.sample.extended +++ b/meta-yocto/conf/local.conf.sample.extended | |||
@@ -1,3 +1,7 @@ | |||
1 | # BBMASK is a regular expression that can be used to tell BitBake to ignore | ||
2 | # certain recipes. | ||
3 | #BBMASK = "" | ||
4 | |||
1 | # eglibc configurability is used to reduce minimal images's size. | 5 | # eglibc configurability is used to reduce minimal images's size. |
2 | # the all supported eglibc options are listed in DISTRO_FEATURES_LIBC | 6 | # the all supported eglibc options are listed in DISTRO_FEATURES_LIBC |
3 | # and disabled by default. Uncomment and copy the DISTRO_FEATURES_LIBC | 7 | # and disabled by default. Uncomment and copy the DISTRO_FEATURES_LIBC |
@@ -10,3 +14,103 @@ | |||
10 | # libc-posix-wchar-io" | 14 | # libc-posix-wchar-io" |
11 | 15 | ||
12 | #DISTRO_FEATURES = "alsa bluetooth ext2 irda pcmcia usbgadget usbhost wifi nfs zeroconf pci ${DISTRO_FEATURES_LIBC}" | 16 | #DISTRO_FEATURES = "alsa bluetooth ext2 irda pcmcia usbgadget usbhost wifi nfs zeroconf pci ${DISTRO_FEATURES_LIBC}" |
17 | |||
18 | # ENABLE_BINARY_LOCALE_GENERATION controls the generation of binary locale | ||
19 | # packages at build time using qemu-native. Disabling it (by setting it to 0) | ||
20 | # will save some build time at the expense of breaking i18n on devices with | ||
21 | # less than 128MB RAM. | ||
22 | #ENABLE_BINARY_LOCALE_GENERATION = "1" | ||
23 | |||
24 | # Set GLIBC_GENERATE_LOCALES to the locales you wish to generate should you not | ||
25 | # wish to perform the time-consuming step of generating all LIBC locales. | ||
26 | # NOTE: If removing en_US.UTF-8 you will also need to uncomment, and set | ||
27 | # appropriate values for IMAGE_LINGUAS and LIMIT_BUILT_LOCALES | ||
28 | # WARNING: this may break localisation! | ||
29 | #GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 en_US.UTF-8" | ||
30 | # See message above as to whether setting these is required | ||
31 | #IMAGE_LINGUAS ?= "en-gb" | ||
32 | #LIMIT_BUILT_LOCALES ?= "POSIX en_GB" | ||
33 | |||
34 | # The following are used to control options related to debugging. | ||
35 | # | ||
36 | # Uncomment this to change the optimization to make debugging easer, at the | ||
37 | # possible cost of performance. | ||
38 | # DEBUG_BUILD = "1" | ||
39 | # | ||
40 | # Uncomment this to disable the stripping of the installed binaries | ||
41 | # INHIBIT_PACKAGE_STRIP = "1" | ||
42 | # | ||
43 | # Uncomment this to disable the split of the debug information into -dbg files | ||
44 | # INHIBIT_PACKAGE_DEBUG_SPLIT = "1" | ||
45 | # | ||
46 | # When splitting debug information, the following controls the results of the | ||
47 | # file splitting. | ||
48 | # | ||
49 | # .debug (default): | ||
50 | # When splitting the debug information will be placed into | ||
51 | # a .debug directory in the same dirname of the binary produced: | ||
52 | # /bin/foo -> /bin/.debug/foo | ||
53 | # | ||
54 | # debug-file-directory: | ||
55 | # When splitting the debug information will be placed into | ||
56 | # a central debug-file-directory, /usr/lib/debug: | ||
57 | # /bin/foo -> /usr/lib/debug/bin/foo.debug | ||
58 | # | ||
59 | # Any source code referenced in the debug symbols will be copied | ||
60 | # and made available within the /usr/src/debug directory | ||
61 | # | ||
62 | #PACKAGE_DEBUG_SPLIT_STYLE = '.debug' | ||
63 | # PACKAGE_DEBUG_SPLIT_STYLE = 'debug-file-directory' | ||
64 | |||
65 | # Uncomment these to build a package such that you can use gprof to profile it. | ||
66 | # NOTE: This will only work with 'linux' targets, not | ||
67 | # 'linux-uclibc', as uClibc doesn't provide the necessary | ||
68 | # object files. Also, don't build glibc itself with these | ||
69 | # flags, or it'll fail to build. | ||
70 | # | ||
71 | # PROFILE_OPTIMIZATION = "-pg" | ||
72 | # SELECTED_OPTIMIZATION = "${PROFILE_OPTIMIZATION}" | ||
73 | # LDFLAGS =+ "-pg" | ||
74 | |||
75 | # TCMODE controls the characteristics of the generated packages/images by | ||
76 | # telling poky which toolchain 'profile' to use. | ||
77 | # | ||
78 | # The default is "default" | ||
79 | # Use "external-MODE" to use the precompiled external toolchains where MODE | ||
80 | # is the type of external toolchain to use e.g. eabi. You need to ensure | ||
81 | # the toolchain you want to use is included in an an appropriate layer | ||
82 | # TCMODE = "external-eabi" | ||
83 | |||
84 | # mklibs library size optimization is more useful to smaller images, | ||
85 | # and less useful for bigger images. Also mklibs library optimization | ||
86 | # can break the ABI compatibility, so should not be applied to the | ||
87 | # images which are to be extended or upgraded later. | ||
88 | #This enabled mklibs library size optimization just for the specified image. | ||
89 | #MKLIBS_OPTIMIZED_IMAGES ?= "core-image-minimal" | ||
90 | #This enable mklibs library size optimization will be for all the images. | ||
91 | #MKLIBS_OPTIMIZED_IMAGES ?= "all" | ||
92 | |||
93 | # Uncomment this if your host distribution provides the help2man tool. | ||
94 | #ASSUME_PROVIDED += "help2man-native" | ||
95 | |||
96 | # This value is currently used by pseudo to determine if the recipe should | ||
97 | # build both the 32-bit and 64-bit wrapper libraries on a 64-bit build system. | ||
98 | # | ||
99 | # Pseudo will attempt to determine if a 32-bit wrapper is necessary, but | ||
100 | # it doesn't always guess properly. If you have 32-bit executables on | ||
101 | # your 64-bit build system, you likely want to set this to "0", | ||
102 | # otherwise you could end up with incorrect file attributes on the | ||
103 | # target filesystem. | ||
104 | # | ||
105 | # Default is to not build 32 bit libs on 64 bit systems, uncomment this | ||
106 | # if you need the 32 bits libs | ||
107 | #NO32LIBS = "0" | ||
108 | |||
109 | # Uncomment the following lines to enable multilib builds | ||
110 | #require conf/multilib.conf | ||
111 | #MULTILIBS = "multilib:lib32" | ||
112 | #DEFAULTTUNE_virtclass-multilib-lib32 = "x86" | ||
113 | |||
114 | # The network based PR service host and port | ||
115 | #PRSERV_HOST = "localhost" | ||
116 | #PRSERV_PORT = "8585" | ||