Config.in: wrap to column width 72

Many lines are not correctly wrapped to 72 column width, so rewrap them. In addition, standardize all instances of ". " to ". ". Signed-off-by: Martin Kelly <martin@surround.io> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2025-07-28 13:46:32 +00:00 · 2016-05-31 09:57:22 -07:00 · 2016-05-31 09:57:22 -07:00 · 65f9b9375f
commit 65f9b9375f
parent 9d119288ea
1 changed files with 156 additions and 151 deletions
--- a/Config.in
+++ b/Config.in
@ -120,9 +120,9 @@ config BR2_ZCAT
 	string "zcat command"
 	default "gzip -d -c"
 	help
-	  Command to be used to extract a gzip'ed file to stdout.
+	  Command to be used to extract a gzip'ed file to stdout. zcat
-	  zcat is identical to gunzip -c except that the former may
+	  is identical to gunzip -c except that the former may not be
-	  not be available on your system.
+	  available on your system.
 	  Default is "gzip -d -c"
 	  Other possible values include "gunzip -c" or "zcat".
@ -162,8 +162,8 @@ config BR2_DEFCONFIG
 	default BR2_DEFCONFIG_FROM_ENV if BR2_DEFCONFIG_FROM_ENV != ""
 	default "$(CONFIG_DIR)/defconfig"
 	help
-	  When running 'make savedefconfig', the defconfig file will be saved
+	  When running 'make savedefconfig', the defconfig file will be
-	  in this location.
+	  saved in this location.
 config BR2_DL_DIR
 	string "Download dir"
@ -171,7 +171,8 @@ config BR2_DL_DIR
 	help
 	  Directory to store all the source files that we need to fetch.
 	  If the Linux shell environment has defined the BR2_DL_DIR
-	  environment variable, then this overrides this configuration item.
+	  environment variable, then this overrides this configuration
 	  item.
 	  The default is $(TOPDIR)/dl
@ -179,9 +180,9 @@ config BR2_HOST_DIR
 	string "Host dir"
 	default "$(BASE_DIR)/host"
 	help
-	  Directory to store all the binary files that are built for the host.
+	  Directory to store all the binary files that are built for the
-	  This includes the cross compilation toolchain when building the
+	  host. This includes the cross compilation toolchain when
-	  internal buildroot toolchain.
+	  building the internal buildroot toolchain.
 	  The default is $(BASE_DIR)/host
@ -191,9 +192,9 @@ config BR2_PRIMARY_SITE
 	string "Primary download site"
 	default ""
 	help
-	  Primary site to download from. If this option is set then buildroot
+	  Primary site to download from. If this option is set then
-	  will try to download package source first from this site and try the
+	  buildroot will try to download package source first from this
-	  default if the file is not found.
+	  site and try the default if the file is not found.
 	  Valid URIs are:
 	    - URIs recognized by $(WGET)
 	    - local URIs of the form file://absolutepath
@ -206,11 +207,11 @@ config BR2_PRIMARY_SITE_ONLY
 	  If this option is enabled, downloads will only be attempted
 	  from the primary download site. Other locations, like the
 	  package's official download location or the backup download
-	  site, will not be considered. Therefore, if the package is
+	  site, will not be considered. Therefore, if the package is not
-	  not present on the primary site, the download fails.
+	  present on the primary site, the download fails.
-	  This is useful for project developers who want to ensure
+	  This is useful for project developers who want to ensure that
-	  that the project can be built even if the upstream tarball
+	  the project can be built even if the upstream tarball
 	  locations disappear.
 if !BR2_PRIMARY_SITE_ONLY
@ -219,21 +220,21 @@ config BR2_BACKUP_SITE
 	string "Backup download site"
 	default "http://sources.buildroot.net"
 	help
-	  Backup site to download from. If this option is set then buildroot
+	  Backup site to download from. If this option is set then
-	  will fall back to download package sources from here if the
+	  buildroot will fall back to download package sources from here
-	  normal location fails.
+	  if the normal location fails.
 config BR2_KERNEL_MIRROR
 	string "Kernel.org mirror"
 	default "https://cdn.kernel.org/pub"
 	help
 	  kernel.org is mirrored on a number of servers around the
-	  world.  The following allows you to select your preferred
+	  world. The following allows you to select your preferred
 	  mirror. By default, a CDN is used, which automatically
 	  redirects to a mirror geographically close to you.
-	  Have a look on the kernel.org site for a list of mirrors, then enter
+	  Have a look on the kernel.org site for a list of mirrors, then
-	  the URL to the base directory.  Examples:
+	  enter the URL to the base directory. Examples:
 	     http://www.XX.kernel.org/pub (XX = country code)
 	     http://mirror.aarnet.edu.au/pub/ftp.kernel.org
@ -243,12 +244,12 @@ config BR2_GNU_MIRROR
 	default "http://ftpmirror.gnu.org"
 	help
 	  GNU has multiple software mirrors scattered around the
-	  world.  The following allows you to select your preferred
+	  world. The following allows you to select your preferred
 	  mirror. By default, a generic address is used, which
 	  automatically selects an up-to-date and local mirror.
-	  Have a look on the gnu.org site for a list of mirrors, then enter
+	  Have a look on the gnu.org site for a list of mirrors, then
-	  the URL to the base directory.  Examples:
+	  enter the URL to the base directory. Examples:
 	     http://ftp.gnu.org/pub/gnu
 	     http://mirror.aarnet.edu.au/pub/gnu
@ -265,8 +266,8 @@ config BR2_CPAN_MIRROR
 	string "CPAN mirror (Perl packages)"
 	default "http://cpan.metacpan.org"
 	help
-	  CPAN (Comprehensive Perl Archive Network) is a repository
+	  CPAN (Comprehensive Perl Archive Network) is a repository of
-	  of Perl packages. It has multiple software mirrors scattered
+	  Perl packages. It has multiple software mirrors scattered
 	  around the world. This option allows you to select a mirror.
 	  The list of mirrors is available at:
@ -280,24 +281,22 @@ config BR2_JLEVEL
 	int "Number of jobs to run simultaneously (0 for auto)"
 	default "0"
 	help
-	  Number of jobs to run simultaneously.  If 0, determine
+	  Number of jobs to run simultaneously. If 0, determine
-	  automatically according to number of CPUs on the host
+	  automatically according to number of CPUs on the host system.
 	  system.
 config BR2_CCACHE
 	bool "Enable compiler cache"
 	help
-	  This option will enable the use of ccache, a compiler
+	  This option will enable the use of ccache, a compiler cache.
-	  cache. It will cache the result of previous builds to speed
+	  It will cache the result of previous builds to speed up future
-	  up future builds. By default, the cache is stored in
+	  builds. By default, the cache is stored in
 	  $HOME/.buildroot-ccache.
 	  Note that Buildroot does not try to invalidate the cache
-	  contents when the compiler changes in an incompatible
+	  contents when the compiler changes in an incompatible way.
-	  way. Therefore, if you make a change to the compiler version
+	  Therefore, if you make a change to the compiler version and/or
-	  and/or configuration, you are responsible for purging the
+	  configuration, you are responsible for purging the ccache
-	  ccache cache by removing the $HOME/.buildroot-ccache
+	  cache by removing the $HOME/.buildroot-ccache directory.
 	  directory.
 if BR2_CCACHE
@ -310,16 +309,19 @@ config BR2_CCACHE_DIR
 config BR2_CCACHE_INITIAL_SETUP
 	string "Compiler cache initial setup"
 	help
-	  Initial ccache settings to apply, such as --max-files or --max-size.
+	  Initial ccache settings to apply, such as --max-files or
 	  --max-size.
-	  For example, if your project is known to require more space than the
+	  For example, if your project is known to require more space
-	  default max cache size, then you might want to increase the cache size
+	  than the default max cache size, then you might want to
-	  to a suitable amount using the -M (--max-size) option.
+	  increase the cache size to a suitable amount using the -M
 	  (--max-size) option.
-	  The string you specify here is passed verbatim to ccache.  Refer to
+	  The string you specify here is passed verbatim to ccache.
-	  ccache documentation for more details.
+	  Refer to ccache documentation for more details.
-	  These initial settings are applied after ccache has been compiled.
+	  These initial settings are applied after ccache has been
 	  compiled.
 config BR2_CCACHE_USE_BASEDIR
 	bool "Use relative paths"
@ -328,25 +330,25 @@ config BR2_CCACHE_USE_BASEDIR
 	  Allow ccache to convert absolute paths within the output
 	  directory into relative paths.
-	  During the build, many -I include directives are given with
+	  During the build, many -I include directives are given with an
-	  an absolute path. These absolute paths end up in the hashes
+	  absolute path. These absolute paths end up in the hashes that
-	  that are computed by ccache. Therefore, when you build from a
+	  are computed by ccache. Therefore, when you build from a
-	  different directory, the hash will be different and the
+	  different directory, the hash will be different and the cached
-	  cached object will not be used.
+	  object will not be used.
 	  To improve cache performance, set this option to y. This
 	  allows ccache to rewrite absolute paths within the output
-	  directory into relative paths. Note that only paths within
+	  directory into relative paths. Note that only paths within the
-	  the output directory will be rewritten; therefore, if you
+	  output directory will be rewritten; therefore, if you change
-	  change BR2_HOST_DIR to point outside the output directory and
+	  BR2_HOST_DIR to point outside the output directory and
 	  subsequently move it to a different location, this will lead
 	  to cache misses.
 	  This option has as a result that the debug information in the
 	  object files also has only relative paths. Therefore, make
 	  sure you cd to the build directory before starting gdb. See
-	  the section "COMPILING IN DIFFERENT DIRECTORIES" in the
+	  the section "COMPILING IN DIFFERENT DIRECTORIES" in the ccache
-	  ccache manual for more information.
+	  manual for more information.
 endif
@ -400,11 +402,11 @@ choice
 config BR2_DEBUG_1
 	bool "debug level 1"
 	help
-	  Debug level 1 produces minimal information, enough
+	  Debug level 1 produces minimal information, enough for making
-	  for making backtraces in parts of the program that
+	  backtraces in parts of the program that you don't plan to
-	  you don't plan to debug. This includes descriptions
+	  debug. This includes descriptions of functions and external
-	  of functions and external variables, but no information
+	  variables, but no information about local variables and no
-	  about local variables and no line numbers.
+	  line numbers.
 config BR2_DEBUG_2
 	bool "debug level 2"
@ -414,9 +416,9 @@ config BR2_DEBUG_2
 config BR2_DEBUG_3
 	bool "debug level 3"
 	help
-	  Level 3 includes extra information, such as all the
+	  Level 3 includes extra information, such as all the macro
-	  macro definitions present in the program. Some debuggers
+	  definitions present in the program. Some debuggers support
-	  support macro expansion when you use -g3.
+	  macro expansion when you use -g3.
 endchoice
 endif
@ -429,16 +431,15 @@ config BR2_STRIP_strip
 	depends on !BR2_PACKAGE_HOST_ELF2FLT
 	help
 	  Binaries and libraries in the target filesystem will be
-	  stripped using the normal 'strip' command. This allows to
+	  stripped using the normal 'strip' command. This allows to save
-	  save space, mainly by removing debugging symbols. Debugging
+	  space, mainly by removing debugging symbols. Debugging symbols
-	  symbols on the target are needed for native debugging, but
+	  on the target are needed for native debugging, but not when
-	  not when remote debugging is used.
+	  remote debugging is used.
 config BR2_STRIP_none
 	bool "none"
 	help
-	  Do not strip binaries and libraries in the target
+	  Do not strip binaries and libraries in the target filesystem.
 	  filesystem.
 endchoice
 config BR2_STRIP_EXCLUDE_FILES
@ -446,19 +447,19 @@ config BR2_STRIP_EXCLUDE_FILES
 	depends on !BR2_STRIP_none
 	default ""
 	help
-	  You may specify a space-separated list of binaries and libraries
+	  You may specify a space-separated list of binaries and
-	  here that should not be stripped on the target.
+	  libraries here that should not be stripped on the target.
 config BR2_STRIP_EXCLUDE_DIRS
 	string "directories that should be skipped when stripping"
 	depends on !BR2_STRIP_none
 	default ""
 	help
-	  You may specify a space-separated list of directories that should
+	  You may specify a space-separated list of directories that
-	  be skipped when stripping. Binaries and libraries in these
+	  should be skipped when stripping. Binaries and libraries in
-	  directories will not be touched.
+	  these directories will not be touched. The directories should
-	  The directories should be specified relative to the target directory,
+	  be specified relative to the target directory, without leading
-	  without leading slash.
+	  slash.
 choice
 	prompt "gcc optimization level"
@ -474,64 +475,67 @@ config BR2_OPTIMIZE_0
 config BR2_OPTIMIZE_1
 	bool "optimization level 1"
 	help
-	  Optimize. Optimizing compilation takes somewhat more time,
+	  Optimize. Optimizing compilation takes somewhat more time, and
-	  and a lot more memory for a large function. With -O, the
+	  a lot more memory for a large function. With -O, the compiler
-	  compiler tries to reduce code size and execution time,
+	  tries to reduce code size and execution time, without
-	  without performing any optimizations that take a great deal
+	  performing any optimizations that take a great deal of
-	  of compilation time. -O turns on the following optimization
+	  compilation time. -O turns on the following optimization
 	  flags: -fdefer-pop -fdelayed-branch -fguess-branch-probability
 	  -fcprop-registers -floop-optimize -fif-conversion
 	  -fif-conversion2 -ftree-ccp -ftree-dce -ftree-dominator-opts
 	  -ftree-dse -ftree-ter -ftree-lrs -ftree-sra -ftree-copyrename
-	  -ftree-fre -ftree-ch -funit-at-a-time -fmerge-constants
+	  -ftree-fre -ftree-ch -funit-at-a-time -fmerge-constants. -O
-	  -O also turns on -fomit-frame-pointer on machines where doing
+	  also turns on -fomit-frame-pointer on machines where doing so
-	  so does not interfere with debugging.
+	  does not interfere with debugging.
 config BR2_OPTIMIZE_2
 	bool "optimization level 2"
 	help
-	  Optimize even more. GCC performs nearly all supported optimizations
+	  Optimize even more. GCC performs nearly all supported
-	  that do not involve a space-speed tradeoff. The compiler does not
+	  optimizations that do not involve a space-speed tradeoff. The
-	  perform loop unrolling or function inlining when you specify -O2.
+	  compiler does not perform loop unrolling or function inlining
-	  As compared to -O, this option increases both compilation time and
+	  when you specify -O2. As compared to -O, this option increases
-	  the performance of the generated code. -O2 turns on all optimization
+	  both compilation time and the performance of the generated
-	  flags specified by -O. It also turns on the following optimization
+	  code. -O2 turns on all optimization flags specified by -O. It
-	  flags: -fthread-jumps -fcrossjumping -foptimize-sibling-calls
+	  also turns on the following optimization flags:
 	  -fthread-jumps -fcrossjumping -foptimize-sibling-calls
 	  -fcse-follow-jumps -fcse-skip-blocks -fgcse  -fgcse-lm
-	  -fexpensive-optimizations -fstrength-reduce -frerun-cse-after-loop
+	  -fexpensive-optimizations -fstrength-reduce
-	  -frerun-loop-opt -fcaller-saves -fpeephole2 -fschedule-insns
+	  -frerun-cse-after-loop -frerun-loop-opt -fcaller-saves
-	  -fschedule-insns2 -fsched-interblock -fsched-spec -fregmove
+	  -fpeephole2 -fschedule-insns -fschedule-insns2
-	  -fstrict-aliasing -fdelete-null-pointer-checks -freorder-blocks
+	  -fsched-interblock -fsched-spec -fregmove -fstrict-aliasing
-	  -freorder-functions -falign-functions -falign-jumps -falign-loops
+	  -fdelete-null-pointer-checks -freorder-blocks
-	  -falign-labels -ftree-vrp -ftree-pre
+	  -freorder-functions -falign-functions -falign-jumps
-	  Please note the warning under -fgcse about invoking -O2 on programs
+	  -falign-loops -falign-labels -ftree-vrp -ftree-pre. Please
 	  note the warning under -fgcse about invoking -O2 on programs
 	  that use computed gotos.
 config BR2_OPTIMIZE_3
 	bool "optimization level 3"
 	help
-	  Optimize yet more. -O3 turns on all optimizations specified by -O2
+	  Optimize yet more. -O3 turns on all optimizations specified by
-	  and also turns on the -finline-functions, -funswitch-loops and
+	  -O2 and also turns on the -finline-functions, -funswitch-loops
-	  -fgcse-after-reload options.
+	  and -fgcse-after-reload options.
 config BR2_OPTIMIZE_G
 	bool "optimize for debugging"
 	depends on BR2_TOOLCHAIN_GCC_AT_LEAST_4_8
 	help
 	  Optimize for debugging. This enables optimizations that do not
-	  interfere with debugging. It should be the optimization level of
+	  interfere with debugging. It should be the optimization level
-	  choice for the standard edit-compile-debug cycle, offering a
+	  of choice for the standard edit-compile-debug cycle, offering
-	  reasonable level of optimization while maintaining fast compilation
+	  a reasonable level of optimization while maintaining fast
-	  and a good debugging experience.
+	  compilation and a good debugging experience.
 config BR2_OPTIMIZE_S
 	bool "optimize for size"
 	help
-	  Optimize for size. -Os enables all -O2 optimizations that do not
+	  Optimize for size. -Os enables all -O2 optimizations that do
-	  typically increase code size. It also performs further optimizations
+	  not typically increase code size. It also performs further
-	  designed to reduce code size. -Os disables the following optimization
+	  optimizations designed to reduce code size. -Os disables the
-	  flags: -falign-functions -falign-jumps -falign-loops -falign-labels
+	  following optimization flags: -falign-functions -falign-jumps
-	  -freorder-blocks -freorder-blocks-and-partition -fprefetch-loop-arrays
+	  -falign-loops -falign-labels -freorder-blocks
 	  -freorder-blocks-and-partition -fprefetch-loop-arrays
 	  -ftree-vect-loop-version
 endchoice
@ -543,13 +547,13 @@ config BR2_GOOGLE_BREAKPAD_ENABLE
 	depends on BR2_TOOLCHAIN_USES_GLIBC
 	depends on BR2_PACKAGE_GOOGLE_BREAKPAD_ARCH_SUPPORTS
 	help
-	  This option will enable the use of google breakpad, a
+	  This option will enable the use of google breakpad, a library
-	  library and tool suite that allows you to distribute an
+	  and tool suite that allows you to distribute an application to
-	  application to users with compiler-provided debugging
+	  users with compiler-provided debugging information removed,
-	  information removed, record crashes in compact "minidump"
+	  record crashes in compact "minidump" files, send them back to
-	  files, send them back to your server and produce C and C++
+	  your server and produce C and C++ stack traces from these
-	  stack traces from these minidumps.  Breakpad can also write
+	  minidumps. Breakpad can also write minidumps on request for
-	  minidumps on request for programs that have not crashed.
+	  programs that have not crashed.
 if BR2_GOOGLE_BREAKPAD_ENABLE
@ -577,12 +581,13 @@ choice
 	  Enable stack smashing protection support using GCC's
 	  -fstack-protector option family.
-	  See http://www.linuxfromscratch.org/hints/downloads/files/ssp.txt
+	  See
 	  http://www.linuxfromscratch.org/hints/downloads/files/ssp.txt
 	  for details.
-	  Note that this requires the toolchain to have SSP
+	  Note that this requires the toolchain to have SSP support.
-	  support. This is always the case for glibc and eglibc
+	  This is always the case for glibc and eglibc toolchain, but is
-	  toolchain, but is optional in uClibc toolchains.
+	  optional in uClibc toolchains.
 config BR2_SSP_NONE
 	bool "None"
@ -630,20 +635,19 @@ choice
 	help
 	  Select the type of libraries you want to use on the target.
-	  The default is to build dynamic libraries and use those on
+	  The default is to build dynamic libraries and use those on the
-	  the target filesystem, except when the architecture and/or
+	  target filesystem, except when the architecture and/or the
-	  the selected binary format does not support shared
+	  selected binary format does not support shared libraries.
 	  libraries.
 config BR2_STATIC_LIBS
 	bool "static only"
 	help
-	  Build and use only static libraries. No shared libraries
+	  Build and use only static libraries. No shared libraries will
-	  will be instaled on the target. This potentially increases
+	  be instaled on the target. This potentially increases your
-	  your code size and should only be used if you know what you
+	  code size and should only be used if you know what you are
-	  are doing. Note that some packages may not be available when
+	  doing. Note that some packages may not be available when this
-	  this option is enabled, due to their need for dynamic
+	  option is enabled, due to their need for dynamic library
-	  library support.
+	  support.
 config BR2_SHARED_LIBS
 	bool "shared only"
@ -669,29 +673,30 @@ config BR2_PACKAGE_OVERRIDE_FILE
 	default "$(CONFIG_DIR)/local.mk"
 	help
 	  A package override file is a short makefile that contains
-	  variable definitions of the form <pkg>_OVERRIDE_SRCDIR,
+	  variable definitions of the form <pkg>_OVERRIDE_SRCDIR, which
-	  which allows to tell Buildroot to use an existing directory
+	  allows to tell Buildroot to use an existing directory as the
-	  as the source directory for a particular package. See the
+	  source directory for a particular package. See the Buildroot
-	  Buildroot documentation for more details on this feature.
+	  documentation for more details on this feature.
 config BR2_GLOBAL_PATCH_DIR
 	string "global patch directories"
 	help
-	  You may specify a space separated list of one or more directories
+	  You may specify a space separated list of one or more
-	  containing global package patches. For a specific version
+	  directories containing global package patches. For a specific
-	  <packageversion> of a specific package <packagename>, patches are
+	  version <packageversion> of a specific package <packagename>,
-	  applied as follows:
+	  patches are applied as follows:
-	  First, the default Buildroot patch set for the package is applied
+	  First, the default Buildroot patch set for the package is
-	  from the package's directory in Buildroot.
+	  applied from the package's directory in Buildroot.
 	  Then for every directory - <global-patch-dir> - that exists in
 	  BR2_GLOBAL_PATCH_DIR, if the directory
-	  <global-patch-dir>/<packagename>/<packageversion>/ exists, then all
+	  <global-patch-dir>/<packagename>/<packageversion>/ exists,
-	  *.patch files in this directory will be applied.
+	  then all *.patch files in this directory will be applied.
-	  Otherwise, if the directory <global-patch-dir>/<packagename> exists,
+	  Otherwise, if the directory <global-patch-dir>/<packagename>
-	  then all *.patch files in the directory will be applied.
+	  exists, then all *.patch files in the directory will be
 	  applied.
 menu "Advanced"
@ -700,13 +705,13 @@ config BR2_COMPILER_PARANOID_UNSAFE_PATH
 	default y
 	help
 	  By default, when this option is disabled, when the Buildroot
-	  cross-compiler will encounter an unsafe library or header
+	  cross-compiler will encounter an unsafe library or header path
-	  path (such as /usr/include, or /usr/lib), the compiler will
+	  (such as /usr/include, or /usr/lib), the compiler will display
-	  display a warning.
+	  a warning.
-	  By enabling this option, this warning is turned into an
+	  By enabling this option, this warning is turned into an error,
-	  error, which will completely abort the build when such
+	  which will completely abort the build when such unsafe paths
-	  unsafe paths are encountered.
+	  are encountered.
 	  Note that this mechanism is available for both the internal
 	  toolchain (through gcc and binutils patches) and external