Skip to contentSkip to conversation

Two patches to help new users

PATCH In review Joshua Lock 2 participants 5 messages Nov 26, 2010 – Dec 3, 2010

lore
Share & tools
lore
#0 lore raw

cover Two patches to help new users

Here are a couple of patches to help new users out.

The first documents some extra variables to set in local.conf when changing GLIBC_GENERATE_LOCALES.

The second helps users ensure they have an appropriate terminal configured for use in patch failure resolution.

Pull URL: git://git.pokylinux.org/poky-contrib.git
Branch: josh/conf
Browse: http://git.pokylinux.org/cgit.cgi/poky-contrib/log/?h=josh/conf

Thanks,
Joshua Lock <[email protected]>
---

Joshua Lock (2):
local.conf.sample: Note extra variables required when disabling en_US
locale
sanity.bbclass: Warn people when TERMCMD is set to a non-installed
program

 meta/classes/sanity.bbclass |    6 ++++++
 meta/conf/local.conf.sample |   14 +++++++++++++-
 2 files changed, 19 insertions(+), 1 deletions(-)
Signature · 1 line
1.7.3.2
#1 lore raw

PATCH 1/2 local.conf.sample: Note extra variables required when disabling en_US locale

When changing which locales are generated for libc it may also be neccessary to change IMAGE_LINGUAS and LIMIT_BUILT_LOCALES

---
 meta/conf/local.conf.sample |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)
meta/conf/local.conf.sample +6 -1
index fae949c..4ba250d 100644
@@ -158,8 +158,13 @@ ENABLE_BINARY_LOCALE_GENERATION = "1"
 
 # Set GLIBC_GENERATE_LOCALES to the locales you wish to generate should you not
 # wish to perform the time-consuming step of generating all LIBC locales.
+# NOTE: If removing en_US.UTF-8 you will also need to uncomment, and set
+# appropriate values for IMAGE_LINGUAS and LIMIT_BUILT_LOCALES
 # WARNING: this may break localisation!
-#GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 en_US.UTF-8"
+#GLIBC_GENERATE_LOCALES = "en_GB.UTF-8"
+# See message above as to whether setting these is required
+#IMAGE_LINGUAS ?= "en-gb"
+#LIMIT_BUILT_LOCALES ?= "POSIX en_GB"
 
 # Default to not build 32 bit libs on 64 bit systems, comment this
 # out if that is desired
Signature · 1 line
1.7.3.2
#2 lore raw

Re: [PATCH 1/2] local.conf.sample: Note extra variables required when disabling en_US locale

Quoted 15 lines · Joshua Lock

When changing which locales are generated for libc it may also be neccessary to change IMAGE_LINGUAS and LIMIT_BUILT_LOCALES

---
  meta/conf/local.conf.sample |    7 ++++++-
  1 files changed, 6 insertions(+), 1 deletions(-)
meta/conf/local.conf.sample +0 -0
index fae949c..4ba250d 100644
@@ -158,8 +158,13 @@ ENABLE_BINARY_LOCALE_GENERATION = "1"
 
  # Set GLIBC_GENERATE_LOCALES to the locales you wish to generate should you not

meta/conf/local.conf.sample ENABLE_BINARY_LOCALE_GENERATION = "1" · line 168

Quoted 10 lines
meta/conf/local.conf.sample +6 -1
  # wish to perform the time-consuming step of generating all LIBC locales.
+# NOTE: If removing en_US.UTF-8 you will also need to uncomment, and set
+# appropriate values for IMAGE_LINGUAS and LIMIT_BUILT_LOCALES
  # WARNING: this may break localisation!
-#GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 en_US.UTF-8"
+#GLIBC_GENERATE_LOCALES = "en_GB.UTF-8"
+# See message above as to whether setting these is required
+#IMAGE_LINGUAS ?= "en-gb"
+#LIMIT_BUILT_LOCALES ?= "POSIX en_GB"
 

Should these LOCALES be en_US, en_GB or BOTH? I know we have had discussion on this in the past.

Let's be consistent on this please.

Sau!

Quoted 2 lines
meta/conf/local.conf.sample +0 -0
  # Default to not build 32 bit libs on 64 bit systems, comment this
  # out if that is desired
#3 lore raw

Re: [PATCH 1/2] local.conf.sample: Note extra variables required when disabling en_US locale

Quoted 29 lines · Saul Wold
Quoted 15 lines · Joshua Lock

When changing which locales are generated for libc it may also be neccessary to change IMAGE_LINGUAS and LIMIT_BUILT_LOCALES

---
  meta/conf/local.conf.sample |    7 ++++++-
  1 files changed, 6 insertions(+), 1 deletions(-)
meta/conf/local.conf.sample +0 -0
index fae949c..4ba250d 100644
@@ -158,8 +158,13 @@ ENABLE_BINARY_LOCALE_GENERATION = "1"
 
  # Set GLIBC_GENERATE_LOCALES to the locales you wish to generate should you not

meta/conf/local.conf.sample ENABLE_BINARY_LOCALE_GENERATION = "1" · line 168

Quoted 10 lines
meta/conf/local.conf.sample +6 -1
  # wish to perform the time-consuming step of generating all LIBC locales.
+# NOTE: If removing en_US.UTF-8 you will also need to uncomment, and set
+# appropriate values for IMAGE_LINGUAS and LIMIT_BUILT_LOCALES
  # WARNING: this may break localisation!
-#GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 en_US.UTF-8"
+#GLIBC_GENERATE_LOCALES = "en_GB.UTF-8"
+# See message above as to whether setting these is required
+#IMAGE_LINGUAS ?= "en-gb"
+#LIMIT_BUILT_LOCALES ?= "POSIX en_GB"
 

Should these LOCALES be en_US, en_GB or BOTH? I know we have had discussion on this in the past.

Quoted 1 line

Let's be consistent on this please.

Good catch. I think the GLIBC_GENERATE_LOCALES should be both as it was before but as the IMAGE_LINGUAS and LIMIT_BUILT_LOCALES only need changing if en_US.UTF-8 is removed they should not include en_US

Updated patch follows and branch fixed:

From 6d532f464a897f28da4c7dcb72ddcad0bcc65f6c Mon Sep 17 00:00:00 2001 Message-Id:
<6d532f464a897f28da4c7dcb72ddcad0bcc65f6c.1291382830.git.josh@linux.intel.com>
In-Reply-To: <[email protected]>
References: <[email protected]>
From: Joshua Lock <[email protected]>
Date: Fri, 26 Nov 2010 14:23:16 +0000
Subject: [PATCH 1/2] local.conf.sample: Note extra variables required when disabling en_US locale

When changing which locales are generated for libc it may also be neccessary to
change IMAGE_LINGUAS and LIMIT_BUILT_LOCALES

---
 meta/conf/local.conf.sample |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
meta/conf/local.conf.sample +0 -0
index fae949c..9bff292 100644
@@ -158,8 +158,13 @@ ENABLE_BINARY_LOCALE_GENERATION = "1"
 
 # Set GLIBC_GENERATE_LOCALES to the locales you wish to generate should

you not

 # wish to perform the time-consuming step of generating all LIBC
locales.
+# NOTE: If removing en_US.UTF-8 you will also need to uncomment, and
set
+# appropriate values for IMAGE_LINGUAS and LIMIT_BUILT_LOCALES
 # WARNING: this may break localisation!
 #GLIBC_GENERATE_LOCALES = "en_GB.UTF-8 en_US.UTF-8"
+# See message above as to whether setting these is required
+#IMAGE_LINGUAS ?= "en-gb"
+#LIMIT_BUILT_LOCALES ?= "POSIX en_GB"

# Default to not build 32 bit libs on 64 bit systems, comment this

 # out if that is desired
Signature · 1 line
1.7.3.2
#4 lore raw

PATCH 2/2 sanity.bbclass: Warn people when TERMCMD is set to a non-installed program

In reply to Joshua Lock

We default to gnome-terminal for TERMCMD (and TERMRUNCMD) so should check that this program actually exists during sanity checking.

As a corollary document how to change these variables in the local.conf

---
 meta/classes/sanity.bbclass |    6 ++++++
 meta/conf/local.conf.sample |    7 +++++++
 2 files changed, 13 insertions(+), 0 deletions(-)
meta/classes/sanity.bbclass +6 -0
index 7f1f800..e98ca89 100644
@@ -139,6 +139,12 @@ def check_sanity(e):
 		missing = missing.rstrip(',')
 		messages = messages + "Please install following missing utilities: %s\n" % missing
 
+	# Ensure we have the binary for TERMCMD, as when patch application fails the error is fairly intimidating
+	termcmd = data.getVar("TERMCMD", e.data, True)
+	term = termcmd.split()[0]
+	if not check_app_exists(term, e.data):
+	   messages = messages + "The console for use in patch error resolution is not available, please install %s or set TERMCMD and TERMCMDRUN (as documented in local.conf).\n" % term
+
 	if os.path.basename(os.readlink('/bin/sh')) == 'dash':
 		messages = messages + "Using dash as /bin/sh causes various subtle build problems, please use bash instead (e.g. 'dpkg-reconfigure dash' on an Ubuntu system.\n"
 
meta/conf/local.conf.sample +7 -0
index 4ba250d..f1421ec 100644
@@ -170,3 +170,10 @@ ENABLE_BINARY_LOCALE_GENERATION = "1"
 # out if that is desired
 NO32LIBS = "1"
 
+# If you do not use (or have installed) gnome-terminal you will need to
+# uncomment these variables and set them to the terminal you wish to use
+# when resolving patches which cannot be applied
+# Supported shell prefixes for *_TERMCMD and *_TERMCMDRUN ARE:
+# GNOME, SCREEN, XTERM and KONSOLE
+#TERMCMD = "${KONSOLE_TERMCMD}"
+#TERMCMDRUN = "${KONSOLE_TERMCMDRUN}"
Signature · 1 line
1.7.3.2