All of lore.kernel.org
 help / color / mirror / Atom feed
* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
       [not found] <20111219093447.C6DBE10331@opal>
@ 2011-12-19  9:54 ` Andreas Müller
  2011-12-19 15:54   ` Mark Hatle
  2011-12-19 16:28   ` Scott Garman
  2011-12-19 12:37 ` Andreas Müller
  1 sibling, 2 replies; 12+ messages in thread
From: Andreas Müller @ 2011-12-19  9:54 UTC (permalink / raw)
  To: openembedded-devel

On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org wrote:
> Module: openembedded-core.git
> Branch: master
> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
> URL:   
> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
> e091ef9da3b7fa83ea3897bd283d9e
> 
> Author: Scott Garman <scott.a.garman@intel.com>
> Date:   Sun Dec 18 15:06:57 2011 -0800
> 
> Add missing SUMMARY fields to various recipes
> 
> This adds the SUMMARY field to the following recipes which were
> missing it:
> 
> * dosfstools
> * grep
> * icu
> * libevent
> * libnfsidmap
> * qemu-helper-nativesdk
> 
> Signed-off-by: Scott Garman <scott.a.garman@intel.com>
> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
> 
> ---
> 
>  .../nfs-utils/libnfsidmap_0.24.bb                  |    3 ++-
>  .../recipes-devtools/dosfstools/dosfstools_2.11.bb |    2 +-
>  .../qemu/qemu-helper-nativesdk_1.0.bb              |    3 ++-
>  meta/recipes-extended/grep/grep_2.9.bb             |    1 +
>  meta/recipes-support/icu/icu-3.6.inc               |    1 +
>  meta/recipes-support/libevent/libevent_1.4.14b.bb  |    3 ++-
>  6 files changed, 9 insertions(+), 4 deletions(-)
> 
> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
> 101ecab..eff75ec 100644
> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
> @@ -1,4 +1,5 @@
> -DESCRIPTION = "nfs idmapping library"
> +SUMMARY = "NFS id mapping library"
> +DESCRIPTION = "NFS id mapping library"
>  HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>  SECTION = "libs"
> 
> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
> ec75ac9..eca54f1 100644
> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
> @@ -1,7 +1,7 @@
>  # dosfstools OE build file
>  # Copyright (C) 2004-2006, Advanced Micro Devices, Inc.  All Rights
> Reserved # Released under the MIT license (see packages/COPYING)
> -
> +SUMMARY = "DOS FAT Filesystem Utilities"
>  DESCRIPTION = "DOS FAT Filesystem Utilities"
> 
>  SECTION = "base"
> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
> a3dca3d..df0cae0 100644
> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
> @@ -1,4 +1,5 @@
> -DESCRIPTION = "Qemu helper scripts from Poky"
> +SUMMARY = "Qemu helper scripts"
> +DESCRIPTION = "Qemu helper scripts"
>  LICENSE = "GPLv2"
>  RDEPENDS_${PN} = "qemu-nativesdk"
>  PR = "r9"
> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed 100644
> --- a/meta/recipes-extended/grep/grep_2.9.bb
> +++ b/meta/recipes-extended/grep/grep_2.9.bb
> @@ -1,3 +1,4 @@
> +SUMMARY = "GNU grep utility"
>  DESCRIPTION = "GNU grep utility"
>  HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>  BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
> diff --git a/meta/recipes-support/icu/icu-3.6.inc
> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
> --- a/meta/recipes-support/icu/icu-3.6.inc
> +++ b/meta/recipes-support/icu/icu-3.6.inc
> @@ -1,3 +1,4 @@
> +SUMMARY = "International Component for Unicode libraries"
>  DESCRIPTION = "The International Component for Unicode (ICU) is a mature,
> portable set of C/C++ and Java libraries for Unicode support, software
> internationalization (I18N) and globalization (G11N), giving applications
> the same results on all platforms." HOMEPAGE =
> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
> 
> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index 1a369b5..36468dc
> 100644
> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
> @@ -1,4 +1,5 @@
> -DESCRIPTION = "an asynchronous event notification library"
> +SUMMARY = "An asynchronous event notification library"
> +DESCRIPTION = "An asynchronous event notification library"
>  HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>  SECTION = "libs"
> 
What is the value in creating redundancies by copying DESRCIPTION to SUMMARY?

Andreas



^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
       [not found] <20111219093447.C6DBE10331@opal>
  2011-12-19  9:54 ` [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes Andreas Müller
@ 2011-12-19 12:37 ` Andreas Müller
  2011-12-19 17:17   ` Scott Garman
  1 sibling, 1 reply; 12+ messages in thread
From: Andreas Müller @ 2011-12-19 12:37 UTC (permalink / raw)
  To: openembedded-core

On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org wrote:
> Module: openembedded-core.git
> Branch: master
> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
> URL:   
> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
> e091ef9da3b7fa83ea3897bd283d9e
> 
> Author: Scott Garman <scott.a.garman@intel.com>
> Date:   Sun Dec 18 15:06:57 2011 -0800
> 
> Add missing SUMMARY fields to various recipes
> 
> This adds the SUMMARY field to the following recipes which were
> missing it:
> 
> * dosfstools
> * grep
> * icu
> * libevent
> * libnfsidmap
> * qemu-helper-nativesdk
> 
> Signed-off-by: Scott Garman <scott.a.garman@intel.com>
> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
> 
> ---
> 
>  .../nfs-utils/libnfsidmap_0.24.bb                  |    3 ++-
>  .../recipes-devtools/dosfstools/dosfstools_2.11.bb |    2 +-
>  .../qemu/qemu-helper-nativesdk_1.0.bb              |    3 ++-
>  meta/recipes-extended/grep/grep_2.9.bb             |    1 +
>  meta/recipes-support/icu/icu-3.6.inc               |    1 +
>  meta/recipes-support/libevent/libevent_1.4.14b.bb  |    3 ++-
>  6 files changed, 9 insertions(+), 4 deletions(-)
> 
> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
> 101ecab..eff75ec 100644
> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
> @@ -1,4 +1,5 @@
> -DESCRIPTION = "nfs idmapping library"
> +SUMMARY = "NFS id mapping library"
> +DESCRIPTION = "NFS id mapping library"
>  HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>  SECTION = "libs"
> 
> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
> ec75ac9..eca54f1 100644
> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
> @@ -1,7 +1,7 @@
>  # dosfstools OE build file
>  # Copyright (C) 2004-2006, Advanced Micro Devices, Inc.  All Rights
> Reserved # Released under the MIT license (see packages/COPYING)
> -
> +SUMMARY = "DOS FAT Filesystem Utilities"
>  DESCRIPTION = "DOS FAT Filesystem Utilities"
> 
>  SECTION = "base"
> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
> a3dca3d..df0cae0 100644
> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
> @@ -1,4 +1,5 @@
> -DESCRIPTION = "Qemu helper scripts from Poky"
> +SUMMARY = "Qemu helper scripts"
> +DESCRIPTION = "Qemu helper scripts"
>  LICENSE = "GPLv2"
>  RDEPENDS_${PN} = "qemu-nativesdk"
>  PR = "r9"
> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed 100644
> --- a/meta/recipes-extended/grep/grep_2.9.bb
> +++ b/meta/recipes-extended/grep/grep_2.9.bb
> @@ -1,3 +1,4 @@
> +SUMMARY = "GNU grep utility"
>  DESCRIPTION = "GNU grep utility"
>  HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>  BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
> diff --git a/meta/recipes-support/icu/icu-3.6.inc
> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
> --- a/meta/recipes-support/icu/icu-3.6.inc
> +++ b/meta/recipes-support/icu/icu-3.6.inc
> @@ -1,3 +1,4 @@
> +SUMMARY = "International Component for Unicode libraries"
>  DESCRIPTION = "The International Component for Unicode (ICU) is a mature,
> portable set of C/C++ and Java libraries for Unicode support, software
> internationalization (I18N) and globalization (G11N), giving applications
> the same results on all platforms." HOMEPAGE =
> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
> 
> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index 1a369b5..36468dc
> 100644
> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
> @@ -1,4 +1,5 @@
> -DESCRIPTION = "an asynchronous event notification library"
> +SUMMARY = "An asynchronous event notification library"
> +DESCRIPTION = "An asynchronous event notification library"
>  HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>  SECTION = "libs"
Sorry I sent it to the wrong list so now again:

What is the value - apart HOB's sake - in creating redundancies by copying 
DESRCIPTION to SUMMARY? Why not use DESCRIPTION?

Andreas



^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19  9:54 ` [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes Andreas Müller
@ 2011-12-19 15:54   ` Mark Hatle
  2011-12-19 16:28   ` Scott Garman
  1 sibling, 0 replies; 12+ messages in thread
From: Mark Hatle @ 2011-12-19 15:54 UTC (permalink / raw)
  To: openembedded-devel

On 12/19/11 3:54 AM, Andreas Müller wrote:
>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index 1a369b5..36468dc
>> 100644
>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> @@ -1,4 +1,5 @@
>> -DESCRIPTION = "an asynchronous event notification library"
>> +SUMMARY = "An asynchronous event notification library"
>> +DESCRIPTION = "An asynchronous event notification library"
>>   HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>   SECTION = "libs"
>>
> What is the value in creating redundancies by copying DESRCIPTION to SUMMARY?

(related item, not the actual answer to your existion)

For those unfamiliar with the SUMMARY, it automatically inherits the 
DESCRIPTION.  In the original design of the SUMMARY field it was expected that a 
number of items already have "small" descriptions, so automatically inheriting 
made sense.

When I did the original pass for oe-core to add summaries, what I found is that 
many of the "DESCRIPTIONS" are really just summaries.  So (in the example 
above), I would have renamed the DESCRIPTION to summary, and put in a new, more 
detailed DESCRIPTION.

For instance (taking from Fedora):

DESCRIPTION = "The libevent API provides a mechanism to execute \
a callback function when a specific event occurs on a file \
descriptor or after a timeout has been reached. libevent is \
meant to replace the asynchronous event loop found in event \
driven network servers. An application just needs to call \
event_dispatch() and can then add or remove events dynamically \
without having to change the event loop."

So my suggestion is when the DESCRIPTION is small enough, there is no reason to 
add a duplicate SUMMARY.  However, it should be a trigger that the DESCRIPTION 
itself is likely just a summary, and a more explicit DESCRIPTION should be 
added.  (I always thing of a summary as "what is this in 74 charachters or 
less", and the DESCRIPTION is "why would I want this thing?")

--Mark

> Andreas
>
> _______________________________________________
> Openembedded-devel mailing list
> Openembedded-devel@lists.openembedded.org
> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-devel




^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19  9:54 ` [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes Andreas Müller
  2011-12-19 15:54   ` Mark Hatle
@ 2011-12-19 16:28   ` Scott Garman
  1 sibling, 0 replies; 12+ messages in thread
From: Scott Garman @ 2011-12-19 16:28 UTC (permalink / raw)
  To: openembedded-devel

On 12/19/2011 01:54 AM, Andreas Müller wrote:
> On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org wrote:
>> Module: openembedded-core.git
>> Branch: master
>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>> URL:
>> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
>> e091ef9da3b7fa83ea3897bd283d9e
>>
>> Author: Scott Garman<scott.a.garman@intel.com>
>> Date:   Sun Dec 18 15:06:57 2011 -0800
>>
>> Add missing SUMMARY fields to various recipes
>>
>> This adds the SUMMARY field to the following recipes which were
>> missing it:
>>
>> * dosfstools
>> * grep
>> * icu
>> * libevent
>> * libnfsidmap
>> * qemu-helper-nativesdk
>>
>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>
>> ---
>>
>>   .../nfs-utils/libnfsidmap_0.24.bb                  |    3 ++-
>>   .../recipes-devtools/dosfstools/dosfstools_2.11.bb |    2 +-
>>   .../qemu/qemu-helper-nativesdk_1.0.bb              |    3 ++-
>>   meta/recipes-extended/grep/grep_2.9.bb             |    1 +
>>   meta/recipes-support/icu/icu-3.6.inc               |    1 +
>>   meta/recipes-support/libevent/libevent_1.4.14b.bb  |    3 ++-
>>   6 files changed, 9 insertions(+), 4 deletions(-)
>>
>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>> 101ecab..eff75ec 100644
>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>> @@ -1,4 +1,5 @@
>> -DESCRIPTION = "nfs idmapping library"
>> +SUMMARY = "NFS id mapping library"
>> +DESCRIPTION = "NFS id mapping library"
>>   HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>   SECTION = "libs"
>>
>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>> ec75ac9..eca54f1 100644
>> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>> @@ -1,7 +1,7 @@
>>   # dosfstools OE build file
>>   # Copyright (C) 2004-2006, Advanced Micro Devices, Inc.  All Rights
>> Reserved # Released under the MIT license (see packages/COPYING)
>> -
>> +SUMMARY = "DOS FAT Filesystem Utilities"
>>   DESCRIPTION = "DOS FAT Filesystem Utilities"
>>
>>   SECTION = "base"
>> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>> a3dca3d..df0cae0 100644
>> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>> @@ -1,4 +1,5 @@
>> -DESCRIPTION = "Qemu helper scripts from Poky"
>> +SUMMARY = "Qemu helper scripts"
>> +DESCRIPTION = "Qemu helper scripts"
>>   LICENSE = "GPLv2"
>>   RDEPENDS_${PN} = "qemu-nativesdk"
>>   PR = "r9"
>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed 100644
>> --- a/meta/recipes-extended/grep/grep_2.9.bb
>> +++ b/meta/recipes-extended/grep/grep_2.9.bb
>> @@ -1,3 +1,4 @@
>> +SUMMARY = "GNU grep utility"
>>   DESCRIPTION = "GNU grep utility"
>>   HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>>   BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
>> diff --git a/meta/recipes-support/icu/icu-3.6.inc
>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
>> --- a/meta/recipes-support/icu/icu-3.6.inc
>> +++ b/meta/recipes-support/icu/icu-3.6.inc
>> @@ -1,3 +1,4 @@
>> +SUMMARY = "International Component for Unicode libraries"
>>   DESCRIPTION = "The International Component for Unicode (ICU) is a mature,
>> portable set of C/C++ and Java libraries for Unicode support, software
>> internationalization (I18N) and globalization (G11N), giving applications
>> the same results on all platforms." HOMEPAGE =
>> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>
>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index 1a369b5..36468dc
>> 100644
>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> @@ -1,4 +1,5 @@
>> -DESCRIPTION = "an asynchronous event notification library"
>> +SUMMARY = "An asynchronous event notification library"
>> +DESCRIPTION = "An asynchronous event notification library"
>>   HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>   SECTION = "libs"
>>
> What is the value in creating redundancies by copying DESRCIPTION to SUMMARY?

Hi Andreas,

I did this because SUMMARY is a required field by the HOB UI. This was 
requested by Shane Wang on the oe-core ML:

http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/014600.html

For recipes which have short descriptions, there was little sense in 
summarizing them further, so I duplicated the DESCRIPTION field. Above 
you can also see an example (in the icu recipe) were I did summarize a 
long DESCRIPTION field.

Mark Hatle replied to this thread explaining why we previously allowed 
SUMMARY to be an optional field and how it automatically inherited from 
DESCRIPTION.

Let me know if you have further questions.

Regards,

Scott




^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19 12:37 ` Andreas Müller
@ 2011-12-19 17:17   ` Scott Garman
  2011-12-19 17:21     ` Koen Kooi
  0 siblings, 1 reply; 12+ messages in thread
From: Scott Garman @ 2011-12-19 17:17 UTC (permalink / raw)
  To: openembedded-core

On 12/19/2011 04:37 AM, Andreas Müller wrote:
> On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org wrote:
>> Module: openembedded-core.git
>> Branch: master
>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>> URL:
>> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
>> e091ef9da3b7fa83ea3897bd283d9e
>>
>> Author: Scott Garman<scott.a.garman@intel.com>
>> Date:   Sun Dec 18 15:06:57 2011 -0800
>>
>> Add missing SUMMARY fields to various recipes
>>
>> This adds the SUMMARY field to the following recipes which were
>> missing it:
>>
>> * dosfstools
>> * grep
>> * icu
>> * libevent
>> * libnfsidmap
>> * qemu-helper-nativesdk
>>
>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>
>> ---
>>
>>   .../nfs-utils/libnfsidmap_0.24.bb                  |    3 ++-
>>   .../recipes-devtools/dosfstools/dosfstools_2.11.bb |    2 +-
>>   .../qemu/qemu-helper-nativesdk_1.0.bb              |    3 ++-
>>   meta/recipes-extended/grep/grep_2.9.bb             |    1 +
>>   meta/recipes-support/icu/icu-3.6.inc               |    1 +
>>   meta/recipes-support/libevent/libevent_1.4.14b.bb  |    3 ++-
>>   6 files changed, 9 insertions(+), 4 deletions(-)
>>
>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>> 101ecab..eff75ec 100644
>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>> @@ -1,4 +1,5 @@
>> -DESCRIPTION = "nfs idmapping library"
>> +SUMMARY = "NFS id mapping library"
>> +DESCRIPTION = "NFS id mapping library"
>>   HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>   SECTION = "libs"
>>
>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>> ec75ac9..eca54f1 100644
>> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>> @@ -1,7 +1,7 @@
>>   # dosfstools OE build file
>>   # Copyright (C) 2004-2006, Advanced Micro Devices, Inc.  All Rights
>> Reserved # Released under the MIT license (see packages/COPYING)
>> -
>> +SUMMARY = "DOS FAT Filesystem Utilities"
>>   DESCRIPTION = "DOS FAT Filesystem Utilities"
>>
>>   SECTION = "base"
>> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>> a3dca3d..df0cae0 100644
>> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>> @@ -1,4 +1,5 @@
>> -DESCRIPTION = "Qemu helper scripts from Poky"
>> +SUMMARY = "Qemu helper scripts"
>> +DESCRIPTION = "Qemu helper scripts"
>>   LICENSE = "GPLv2"
>>   RDEPENDS_${PN} = "qemu-nativesdk"
>>   PR = "r9"
>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed 100644
>> --- a/meta/recipes-extended/grep/grep_2.9.bb
>> +++ b/meta/recipes-extended/grep/grep_2.9.bb
>> @@ -1,3 +1,4 @@
>> +SUMMARY = "GNU grep utility"
>>   DESCRIPTION = "GNU grep utility"
>>   HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>>   BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
>> diff --git a/meta/recipes-support/icu/icu-3.6.inc
>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
>> --- a/meta/recipes-support/icu/icu-3.6.inc
>> +++ b/meta/recipes-support/icu/icu-3.6.inc
>> @@ -1,3 +1,4 @@
>> +SUMMARY = "International Component for Unicode libraries"
>>   DESCRIPTION = "The International Component for Unicode (ICU) is a mature,
>> portable set of C/C++ and Java libraries for Unicode support, software
>> internationalization (I18N) and globalization (G11N), giving applications
>> the same results on all platforms." HOMEPAGE =
>> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>
>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index 1a369b5..36468dc
>> 100644
>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>> @@ -1,4 +1,5 @@
>> -DESCRIPTION = "an asynchronous event notification library"
>> +SUMMARY = "An asynchronous event notification library"
>> +DESCRIPTION = "An asynchronous event notification library"
>>   HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>   SECTION = "libs"
> Sorry I sent it to the wrong list so now again:
>
> What is the value - apart HOB's sake - in creating redundancies by copying
> DESRCIPTION to SUMMARY? Why not use DESCRIPTION?

(this is a copy of the email I sent to the oe-devel ML):

Hi Andreas,

I did this because SUMMARY is a required field by the HOB UI. This was 
requested by Shane Wang on the oe-core ML:

http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/014600.html

For recipes which have short descriptions, there was little sense in 
summarizing them further, so I duplicated the DESCRIPTION field. Above 
you can also see an example (in the icu recipe) were I did summarize a 
long DESCRIPTION field.

Mark Hatle replied to this thread explaining why we previously allowed 
SUMMARY to be an optional field and how it automatically inherited from 
DESCRIPTION.

Let me know if you have further questions.

Regards,

Scott

-- 
Scott Garman
Embedded Linux Engineer - Yocto Project
Intel Open Source Technology Center



^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19 17:17   ` Scott Garman
@ 2011-12-19 17:21     ` Koen Kooi
  2011-12-19 17:28       ` Scott Garman
  0 siblings, 1 reply; 12+ messages in thread
From: Koen Kooi @ 2011-12-19 17:21 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer

[-- Attachment #1: Type: text/plain, Size: 5806 bytes --]


Op 19 dec. 2011, om 18:17 heeft Scott Garman het volgende geschreven:

> On 12/19/2011 04:37 AM, Andreas Müller wrote:
>> On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org wrote:
>>> Module: openembedded-core.git
>>> Branch: master
>>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>>> URL:
>>> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
>>> e091ef9da3b7fa83ea3897bd283d9e
>>> 
>>> Author: Scott Garman<scott.a.garman@intel.com>
>>> Date:   Sun Dec 18 15:06:57 2011 -0800
>>> 
>>> Add missing SUMMARY fields to various recipes
>>> 
>>> This adds the SUMMARY field to the following recipes which were
>>> missing it:
>>> 
>>> * dosfstools
>>> * grep
>>> * icu
>>> * libevent
>>> * libnfsidmap
>>> * qemu-helper-nativesdk
>>> 
>>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>> 
>>> ---
>>> 
>>>  .../nfs-utils/libnfsidmap_0.24.bb                  |    3 ++-
>>>  .../recipes-devtools/dosfstools/dosfstools_2.11.bb |    2 +-
>>>  .../qemu/qemu-helper-nativesdk_1.0.bb              |    3 ++-
>>>  meta/recipes-extended/grep/grep_2.9.bb             |    1 +
>>>  meta/recipes-support/icu/icu-3.6.inc               |    1 +
>>>  meta/recipes-support/libevent/libevent_1.4.14b.bb  |    3 ++-
>>>  6 files changed, 9 insertions(+), 4 deletions(-)
>>> 
>>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>>> 101ecab..eff75ec 100644
>>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>> @@ -1,4 +1,5 @@
>>> -DESCRIPTION = "nfs idmapping library"
>>> +SUMMARY = "NFS id mapping library"
>>> +DESCRIPTION = "NFS id mapping library"
>>>  HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>>  SECTION = "libs"
>>> 
>>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>>> ec75ac9..eca54f1 100644
>>> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>> @@ -1,7 +1,7 @@
>>>  # dosfstools OE build file
>>>  # Copyright (C) 2004-2006, Advanced Micro Devices, Inc.  All Rights
>>> Reserved # Released under the MIT license (see packages/COPYING)
>>> -
>>> +SUMMARY = "DOS FAT Filesystem Utilities"
>>>  DESCRIPTION = "DOS FAT Filesystem Utilities"
>>> 
>>>  SECTION = "base"
>>> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>>> a3dca3d..df0cae0 100644
>>> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>> @@ -1,4 +1,5 @@
>>> -DESCRIPTION = "Qemu helper scripts from Poky"
>>> +SUMMARY = "Qemu helper scripts"
>>> +DESCRIPTION = "Qemu helper scripts"
>>>  LICENSE = "GPLv2"
>>>  RDEPENDS_${PN} = "qemu-nativesdk"
>>>  PR = "r9"
>>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed 100644
>>> --- a/meta/recipes-extended/grep/grep_2.9.bb
>>> +++ b/meta/recipes-extended/grep/grep_2.9.bb
>>> @@ -1,3 +1,4 @@
>>> +SUMMARY = "GNU grep utility"
>>>  DESCRIPTION = "GNU grep utility"
>>>  HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>>>  BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
>>> diff --git a/meta/recipes-support/icu/icu-3.6.inc
>>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
>>> --- a/meta/recipes-support/icu/icu-3.6.inc
>>> +++ b/meta/recipes-support/icu/icu-3.6.inc
>>> @@ -1,3 +1,4 @@
>>> +SUMMARY = "International Component for Unicode libraries"
>>>  DESCRIPTION = "The International Component for Unicode (ICU) is a mature,
>>> portable set of C/C++ and Java libraries for Unicode support, software
>>> internationalization (I18N) and globalization (G11N), giving applications
>>> the same results on all platforms." HOMEPAGE =
>>> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>> 
>>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index 1a369b5..36468dc
>>> 100644
>>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>> @@ -1,4 +1,5 @@
>>> -DESCRIPTION = "an asynchronous event notification library"
>>> +SUMMARY = "An asynchronous event notification library"
>>> +DESCRIPTION = "An asynchronous event notification library"
>>>  HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>>  SECTION = "libs"
>> Sorry I sent it to the wrong list so now again:
>> 
>> What is the value - apart HOB's sake - in creating redundancies by copying
>> DESRCIPTION to SUMMARY? Why not use DESCRIPTION?
> 
> (this is a copy of the email I sent to the oe-devel ML):
> 
> Hi Andreas,
> 
> I did this because SUMMARY is a required field by the HOB UI. This was requested by Shane Wang on the oe-core ML:
> 
> http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/014600.html
> 
> For recipes which have short descriptions, there was little sense in summarizing them further, so I duplicated the DESCRIPTION field. Above you can also see an example (in the icu recipe) were I did summarize a long DESCRIPTION field.
> 
> Mark Hatle replied to this thread explaining why we previously allowed SUMMARY to be an optional field and how it automatically inherited from DESCRIPTION.

So if it's automatically inherited why are these patches duplicating it?

regards,

Koen

[-- Attachment #2: Message signed with OpenPGP using GPGMail --]
[-- Type: application/pgp-signature, Size: 169 bytes --]

^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19 17:21     ` Koen Kooi
@ 2011-12-19 17:28       ` Scott Garman
  2011-12-19 17:44         ` Mark Hatle
  2011-12-20 15:55         ` Wang, Shane
  0 siblings, 2 replies; 12+ messages in thread
From: Scott Garman @ 2011-12-19 17:28 UTC (permalink / raw)
  To: openembedded-core

On 12/19/2011 09:21 AM, Koen Kooi wrote:
>
> Op 19 dec. 2011, om 18:17 heeft Scott Garman het volgende geschreven:
>
>> On 12/19/2011 04:37 AM, Andreas Müller wrote:
>>> On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org wrote:
>>>> Module: openembedded-core.git
>>>> Branch: master
>>>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>>>> URL:
>>>> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
>>>> e091ef9da3b7fa83ea3897bd283d9e
>>>>
>>>> Author: Scott Garman<scott.a.garman@intel.com>
>>>> Date:   Sun Dec 18 15:06:57 2011 -0800
>>>>
>>>> Add missing SUMMARY fields to various recipes
>>>>
>>>> This adds the SUMMARY field to the following recipes which were
>>>> missing it:
>>>>
>>>> * dosfstools
>>>> * grep
>>>> * icu
>>>> * libevent
>>>> * libnfsidmap
>>>> * qemu-helper-nativesdk
>>>>
>>>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>>>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>>>
>>>> ---
>>>>
>>>>   .../nfs-utils/libnfsidmap_0.24.bb                  |    3 ++-
>>>>   .../recipes-devtools/dosfstools/dosfstools_2.11.bb |    2 +-
>>>>   .../qemu/qemu-helper-nativesdk_1.0.bb              |    3 ++-
>>>>   meta/recipes-extended/grep/grep_2.9.bb             |    1 +
>>>>   meta/recipes-support/icu/icu-3.6.inc               |    1 +
>>>>   meta/recipes-support/libevent/libevent_1.4.14b.bb  |    3 ++-
>>>>   6 files changed, 9 insertions(+), 4 deletions(-)
>>>>
>>>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>>>> 101ecab..eff75ec 100644
>>>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>> @@ -1,4 +1,5 @@
>>>> -DESCRIPTION = "nfs idmapping library"
>>>> +SUMMARY = "NFS id mapping library"
>>>> +DESCRIPTION = "NFS id mapping library"
>>>>   HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>>>   SECTION = "libs"
>>>>
>>>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>>>> ec75ac9..eca54f1 100644
>>>> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>> @@ -1,7 +1,7 @@
>>>>   # dosfstools OE build file
>>>>   # Copyright (C) 2004-2006, Advanced Micro Devices, Inc.  All Rights
>>>> Reserved # Released under the MIT license (see packages/COPYING)
>>>> -
>>>> +SUMMARY = "DOS FAT Filesystem Utilities"
>>>>   DESCRIPTION = "DOS FAT Filesystem Utilities"
>>>>
>>>>   SECTION = "base"
>>>> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>>>> a3dca3d..df0cae0 100644
>>>> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>> @@ -1,4 +1,5 @@
>>>> -DESCRIPTION = "Qemu helper scripts from Poky"
>>>> +SUMMARY = "Qemu helper scripts"
>>>> +DESCRIPTION = "Qemu helper scripts"
>>>>   LICENSE = "GPLv2"
>>>>   RDEPENDS_${PN} = "qemu-nativesdk"
>>>>   PR = "r9"
>>>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>>>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed 100644
>>>> --- a/meta/recipes-extended/grep/grep_2.9.bb
>>>> +++ b/meta/recipes-extended/grep/grep_2.9.bb
>>>> @@ -1,3 +1,4 @@
>>>> +SUMMARY = "GNU grep utility"
>>>>   DESCRIPTION = "GNU grep utility"
>>>>   HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>>>>   BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
>>>> diff --git a/meta/recipes-support/icu/icu-3.6.inc
>>>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
>>>> --- a/meta/recipes-support/icu/icu-3.6.inc
>>>> +++ b/meta/recipes-support/icu/icu-3.6.inc
>>>> @@ -1,3 +1,4 @@
>>>> +SUMMARY = "International Component for Unicode libraries"
>>>>   DESCRIPTION = "The International Component for Unicode (ICU) is a mature,
>>>> portable set of C/C++ and Java libraries for Unicode support, software
>>>> internationalization (I18N) and globalization (G11N), giving applications
>>>> the same results on all platforms." HOMEPAGE =
>>>> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>>>
>>>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index 1a369b5..36468dc
>>>> 100644
>>>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>> @@ -1,4 +1,5 @@
>>>> -DESCRIPTION = "an asynchronous event notification library"
>>>> +SUMMARY = "An asynchronous event notification library"
>>>> +DESCRIPTION = "An asynchronous event notification library"
>>>>   HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>>>   SECTION = "libs"
>>> Sorry I sent it to the wrong list so now again:
>>>
>>> What is the value - apart HOB's sake - in creating redundancies by copying
>>> DESRCIPTION to SUMMARY? Why not use DESCRIPTION?
>>
>> (this is a copy of the email I sent to the oe-devel ML):
>>
>> Hi Andreas,
>>
>> I did this because SUMMARY is a required field by the HOB UI. This was requested by Shane Wang on the oe-core ML:
>>
>> http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/014600.html
>>
>> For recipes which have short descriptions, there was little sense in summarizing them further, so I duplicated the DESCRIPTION field. Above you can also see an example (in the icu recipe) were I did summarize a long DESCRIPTION field.
>>
>> Mark Hatle replied to this thread explaining why we previously allowed SUMMARY to be an optional field and how it automatically inherited from DESCRIPTION.
>
> So if it's automatically inherited why are these patches duplicating it?

Hi Koen,

Ah, I see why this is still confusing.

Shane wrote:

"If the summary is missing, bitbake will create a default value for 
summary. That is PN plus string " version " plus its version."

So apparently the HOB UI isn't actually "inheriting" the DESCRIPTION field.

Shane and Mark: can you clarify what the intended behavior is? Why would 
the HOB UI not inherit DESCRIPTION?

Scott

-- 
Scott Garman
Embedded Linux Engineer - Yocto Project
Intel Open Source Technology Center



^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19 17:28       ` Scott Garman
@ 2011-12-19 17:44         ` Mark Hatle
  2011-12-19 18:00           ` Saul Wold
  2011-12-20 15:55         ` Wang, Shane
  1 sibling, 1 reply; 12+ messages in thread
From: Mark Hatle @ 2011-12-19 17:44 UTC (permalink / raw)
  To: Scott Garman; +Cc: openembedded-core

On 12/19/11 11:28 AM, Scott Garman wrote:
> On 12/19/2011 09:21 AM, Koen Kooi wrote:
>>
>> Op 19 dec. 2011, om 18:17 heeft Scott Garman het volgende geschreven:
>>
>>> On 12/19/2011 04:37 AM, Andreas Müller wrote:
>>>> On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org wrote:
>>>>> Module: openembedded-core.git
>>>>> Branch: master
>>>>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>>>>> URL:
>>>>> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
>>>>> e091ef9da3b7fa83ea3897bd283d9e
>>>>>
>>>>> Author: Scott Garman<scott.a.garman@intel.com>
>>>>> Date:   Sun Dec 18 15:06:57 2011 -0800
>>>>>
>>>>> Add missing SUMMARY fields to various recipes
>>>>>
>>>>> This adds the SUMMARY field to the following recipes which were
>>>>> missing it:
>>>>>
>>>>> * dosfstools
>>>>> * grep
>>>>> * icu
>>>>> * libevent
>>>>> * libnfsidmap
>>>>> * qemu-helper-nativesdk
>>>>>
>>>>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>>>>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>>>>
>>>>> ---
>>>>>
>>>>>    .../nfs-utils/libnfsidmap_0.24.bb                  |    3 ++-
>>>>>    .../recipes-devtools/dosfstools/dosfstools_2.11.bb |    2 +-
>>>>>    .../qemu/qemu-helper-nativesdk_1.0.bb              |    3 ++-
>>>>>    meta/recipes-extended/grep/grep_2.9.bb             |    1 +
>>>>>    meta/recipes-support/icu/icu-3.6.inc               |    1 +
>>>>>    meta/recipes-support/libevent/libevent_1.4.14b.bb  |    3 ++-
>>>>>    6 files changed, 9 insertions(+), 4 deletions(-)
>>>>>
>>>>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>>>>> 101ecab..eff75ec 100644
>>>>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>> @@ -1,4 +1,5 @@
>>>>> -DESCRIPTION = "nfs idmapping library"
>>>>> +SUMMARY = "NFS id mapping library"
>>>>> +DESCRIPTION = "NFS id mapping library"
>>>>>    HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>>>>    SECTION = "libs"
>>>>>
>>>>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>>>>> ec75ac9..eca54f1 100644
>>>>> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>> @@ -1,7 +1,7 @@
>>>>>    # dosfstools OE build file
>>>>>    # Copyright (C) 2004-2006, Advanced Micro Devices, Inc.  All Rights
>>>>> Reserved # Released under the MIT license (see packages/COPYING)
>>>>> -
>>>>> +SUMMARY = "DOS FAT Filesystem Utilities"
>>>>>    DESCRIPTION = "DOS FAT Filesystem Utilities"
>>>>>
>>>>>    SECTION = "base"
>>>>> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>>>>> a3dca3d..df0cae0 100644
>>>>> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>> @@ -1,4 +1,5 @@
>>>>> -DESCRIPTION = "Qemu helper scripts from Poky"
>>>>> +SUMMARY = "Qemu helper scripts"
>>>>> +DESCRIPTION = "Qemu helper scripts"
>>>>>    LICENSE = "GPLv2"
>>>>>    RDEPENDS_${PN} = "qemu-nativesdk"
>>>>>    PR = "r9"
>>>>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>>>>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed 100644
>>>>> --- a/meta/recipes-extended/grep/grep_2.9.bb
>>>>> +++ b/meta/recipes-extended/grep/grep_2.9.bb
>>>>> @@ -1,3 +1,4 @@
>>>>> +SUMMARY = "GNU grep utility"
>>>>>    DESCRIPTION = "GNU grep utility"
>>>>>    HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>>>>>    BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
>>>>> diff --git a/meta/recipes-support/icu/icu-3.6.inc
>>>>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
>>>>> --- a/meta/recipes-support/icu/icu-3.6.inc
>>>>> +++ b/meta/recipes-support/icu/icu-3.6.inc
>>>>> @@ -1,3 +1,4 @@
>>>>> +SUMMARY = "International Component for Unicode libraries"
>>>>>    DESCRIPTION = "The International Component for Unicode (ICU) is a mature,
>>>>> portable set of C/C++ and Java libraries for Unicode support, software
>>>>> internationalization (I18N) and globalization (G11N), giving applications
>>>>> the same results on all platforms." HOMEPAGE =
>>>>> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>>>>
>>>>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index 1a369b5..36468dc
>>>>> 100644
>>>>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>> @@ -1,4 +1,5 @@
>>>>> -DESCRIPTION = "an asynchronous event notification library"
>>>>> +SUMMARY = "An asynchronous event notification library"
>>>>> +DESCRIPTION = "An asynchronous event notification library"
>>>>>    HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>>>>    SECTION = "libs"
>>>> Sorry I sent it to the wrong list so now again:
>>>>
>>>> What is the value - apart HOB's sake - in creating redundancies by copying
>>>> DESRCIPTION to SUMMARY? Why not use DESCRIPTION?
>>>
>>> (this is a copy of the email I sent to the oe-devel ML):
>>>
>>> Hi Andreas,
>>>
>>> I did this because SUMMARY is a required field by the HOB UI. This was requested by Shane Wang on the oe-core ML:
>>>
>>> http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/014600.html
>>>
>>> For recipes which have short descriptions, there was little sense in summarizing them further, so I duplicated the DESCRIPTION field. Above you can also see an example (in the icu recipe) were I did summarize a long DESCRIPTION field.
>>>
>>> Mark Hatle replied to this thread explaining why we previously allowed SUMMARY to be an optional field and how it automatically inherited from DESCRIPTION.
>>
>> So if it's automatically inherited why are these patches duplicating it?
>
> Hi Koen,
>
> Ah, I see why this is still confusing.
>
> Shane wrote:
>
> "If the summary is missing, bitbake will create a default value for
> summary. That is PN plus string " version " plus its version."
>
> So apparently the HOB UI isn't actually "inheriting" the DESCRIPTION field.
>
> Shane and Mark: can you clarify what the intended behavior is? Why would
> the HOB UI not inherit DESCRIPTION?

I don't know.  Within the bitbake.conf there is:

DESCRIPTION ?= "${SUMMARY}"

So it should just work...

--Mark

> Scott
>




^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19 17:44         ` Mark Hatle
@ 2011-12-19 18:00           ` Saul Wold
  2011-12-19 18:10             ` Mark Hatle
  0 siblings, 1 reply; 12+ messages in thread
From: Saul Wold @ 2011-12-19 18:00 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer; +Cc: Scott Garman

On 12/19/2011 09:44 AM, Mark Hatle wrote:
> On 12/19/11 11:28 AM, Scott Garman wrote:
>> On 12/19/2011 09:21 AM, Koen Kooi wrote:
>>>
>>> Op 19 dec. 2011, om 18:17 heeft Scott Garman het volgende geschreven:
>>>
>>>> On 12/19/2011 04:37 AM, Andreas Müller wrote:
>>>>> On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org
>>>>> wrote:
>>>>>> Module: openembedded-core.git
>>>>>> Branch: master
>>>>>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>>>>>> URL:
>>>>>> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
>>>>>>
>>>>>> e091ef9da3b7fa83ea3897bd283d9e
>>>>>>
>>>>>> Author: Scott Garman<scott.a.garman@intel.com>
>>>>>> Date: Sun Dec 18 15:06:57 2011 -0800
>>>>>>
>>>>>> Add missing SUMMARY fields to various recipes
>>>>>>
>>>>>> This adds the SUMMARY field to the following recipes which were
>>>>>> missing it:
>>>>>>
>>>>>> * dosfstools
>>>>>> * grep
>>>>>> * icu
>>>>>> * libevent
>>>>>> * libnfsidmap
>>>>>> * qemu-helper-nativesdk
>>>>>>
>>>>>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>>>>>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>>>>>
>>>>>> ---
>>>>>>
>>>>>> .../nfs-utils/libnfsidmap_0.24.bb | 3 ++-
>>>>>> .../recipes-devtools/dosfstools/dosfstools_2.11.bb | 2 +-
>>>>>> .../qemu/qemu-helper-nativesdk_1.0.bb | 3 ++-
>>>>>> meta/recipes-extended/grep/grep_2.9.bb | 1 +
>>>>>> meta/recipes-support/icu/icu-3.6.inc | 1 +
>>>>>> meta/recipes-support/libevent/libevent_1.4.14b.bb | 3 ++-
>>>>>> 6 files changed, 9 insertions(+), 4 deletions(-)
>>>>>>
>>>>>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>>>>>> 101ecab..eff75ec 100644
>>>>>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>> @@ -1,4 +1,5 @@
>>>>>> -DESCRIPTION = "nfs idmapping library"
>>>>>> +SUMMARY = "NFS id mapping library"
>>>>>> +DESCRIPTION = "NFS id mapping library"
>>>>>> HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>>>>> SECTION = "libs"
>>>>>>
>>>>>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>>>>>> ec75ac9..eca54f1 100644
>>>>>> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>>> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>>> @@ -1,7 +1,7 @@
>>>>>> # dosfstools OE build file
>>>>>> # Copyright (C) 2004-2006, Advanced Micro Devices, Inc. All Rights
>>>>>> Reserved # Released under the MIT license (see packages/COPYING)
>>>>>> -
>>>>>> +SUMMARY = "DOS FAT Filesystem Utilities"
>>>>>> DESCRIPTION = "DOS FAT Filesystem Utilities"
>>>>>>
>>>>>> SECTION = "base"
>>>>>> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>>>>>> a3dca3d..df0cae0 100644
>>>>>> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>>> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>>> @@ -1,4 +1,5 @@
>>>>>> -DESCRIPTION = "Qemu helper scripts from Poky"
>>>>>> +SUMMARY = "Qemu helper scripts"
>>>>>> +DESCRIPTION = "Qemu helper scripts"
>>>>>> LICENSE = "GPLv2"
>>>>>> RDEPENDS_${PN} = "qemu-nativesdk"
>>>>>> PR = "r9"
>>>>>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>>>>>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed
>>>>>> 100644
>>>>>> --- a/meta/recipes-extended/grep/grep_2.9.bb
>>>>>> +++ b/meta/recipes-extended/grep/grep_2.9.bb
>>>>>> @@ -1,3 +1,4 @@
>>>>>> +SUMMARY = "GNU grep utility"
>>>>>> DESCRIPTION = "GNU grep utility"
>>>>>> HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>>>>>> BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
>>>>>> diff --git a/meta/recipes-support/icu/icu-3.6.inc
>>>>>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
>>>>>> --- a/meta/recipes-support/icu/icu-3.6.inc
>>>>>> +++ b/meta/recipes-support/icu/icu-3.6.inc
>>>>>> @@ -1,3 +1,4 @@
>>>>>> +SUMMARY = "International Component for Unicode libraries"
>>>>>> DESCRIPTION = "The International Component for Unicode (ICU) is a
>>>>>> mature,
>>>>>> portable set of C/C++ and Java libraries for Unicode support,
>>>>>> software
>>>>>> internationalization (I18N) and globalization (G11N), giving
>>>>>> applications
>>>>>> the same results on all platforms." HOMEPAGE =
>>>>>> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>>>>>
>>>>>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index
>>>>>> 1a369b5..36468dc
>>>>>> 100644
>>>>>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>> @@ -1,4 +1,5 @@
>>>>>> -DESCRIPTION = "an asynchronous event notification library"
>>>>>> +SUMMARY = "An asynchronous event notification library"
>>>>>> +DESCRIPTION = "An asynchronous event notification library"
>>>>>> HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>>>>> SECTION = "libs"
>>>>> Sorry I sent it to the wrong list so now again:
>>>>>
>>>>> What is the value - apart HOB's sake - in creating redundancies by
>>>>> copying
>>>>> DESRCIPTION to SUMMARY? Why not use DESCRIPTION?
>>>>
>>>> (this is a copy of the email I sent to the oe-devel ML):
>>>>
>>>> Hi Andreas,
>>>>
>>>> I did this because SUMMARY is a required field by the HOB UI. This
>>>> was requested by Shane Wang on the oe-core ML:
>>>>
>>>> http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/014600.html
>>>>
>>>>
>>>> For recipes which have short descriptions, there was little sense in
>>>> summarizing them further, so I duplicated the DESCRIPTION field.
>>>> Above you can also see an example (in the icu recipe) were I did
>>>> summarize a long DESCRIPTION field.
>>>>
>>>> Mark Hatle replied to this thread explaining why we previously
>>>> allowed SUMMARY to be an optional field and how it automatically
>>>> inherited from DESCRIPTION.
>>>
>>> So if it's automatically inherited why are these patches duplicating it?
>>
>> Hi Koen,
>>
>> Ah, I see why this is still confusing.
>>
>> Shane wrote:
>>
>> "If the summary is missing, bitbake will create a default value for
>> summary. That is PN plus string " version " plus its version."
>>
>> So apparently the HOB UI isn't actually "inheriting" the DESCRIPTION
>> field.
>>
>> Shane and Mark: can you clarify what the intended behavior is? Why would
>> the HOB UI not inherit DESCRIPTION?
>
> I don't know. Within the bitbake.conf there is:
>
> DESCRIPTION ?= "${SUMMARY}"
>
> So it should just work...
>
It does work just not what HOB is looking for, HOB seems to be looking 
for a SUMMARY not DESCRIPTION first.  So if there is no SUMMARY HOB gets 
the bitbake.conf default of: SUMMARY ?= "${PN} version ${PV}-${PR}"

Maybe HOB can be fixed to check if the ${SUMMARY} first word is ${PN} 
then use ${DESCRIPTION} instead of requiring all recipes have a SUMMARY?

my 2 cents

Sau!


> --Mark
>
>> Scott
>>
>
>
> _______________________________________________
> Openembedded-core mailing list
> Openembedded-core@lists.openembedded.org
> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-core
>



^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19 18:00           ` Saul Wold
@ 2011-12-19 18:10             ` Mark Hatle
  2011-12-20 15:53               ` Wang, Shane
  0 siblings, 1 reply; 12+ messages in thread
From: Mark Hatle @ 2011-12-19 18:10 UTC (permalink / raw)
  To: Saul Wold; +Cc: Scott Garman, Patches and discussions about the oe-core layer

On 12/19/11 12:00 PM, Saul Wold wrote:
> On 12/19/2011 09:44 AM, Mark Hatle wrote:
>> On 12/19/11 11:28 AM, Scott Garman wrote:
>>> On 12/19/2011 09:21 AM, Koen Kooi wrote:
>>>>
>>>> Op 19 dec. 2011, om 18:17 heeft Scott Garman het volgende geschreven:
>>>>
>>>>> On 12/19/2011 04:37 AM, Andreas Müller wrote:
>>>>>> On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org
>>>>>> wrote:
>>>>>>> Module: openembedded-core.git
>>>>>>> Branch: master
>>>>>>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>>>>>>> URL:
>>>>>>> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8c194a627
>>>>>>>
>>>>>>> e091ef9da3b7fa83ea3897bd283d9e
>>>>>>>
>>>>>>> Author: Scott Garman<scott.a.garman@intel.com>
>>>>>>> Date: Sun Dec 18 15:06:57 2011 -0800
>>>>>>>
>>>>>>> Add missing SUMMARY fields to various recipes
>>>>>>>
>>>>>>> This adds the SUMMARY field to the following recipes which were
>>>>>>> missing it:
>>>>>>>
>>>>>>> * dosfstools
>>>>>>> * grep
>>>>>>> * icu
>>>>>>> * libevent
>>>>>>> * libnfsidmap
>>>>>>> * qemu-helper-nativesdk
>>>>>>>
>>>>>>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>>>>>>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>>>>>>
>>>>>>> ---
>>>>>>>
>>>>>>> .../nfs-utils/libnfsidmap_0.24.bb | 3 ++-
>>>>>>> .../recipes-devtools/dosfstools/dosfstools_2.11.bb | 2 +-
>>>>>>> .../qemu/qemu-helper-nativesdk_1.0.bb | 3 ++-
>>>>>>> meta/recipes-extended/grep/grep_2.9.bb | 1 +
>>>>>>> meta/recipes-support/icu/icu-3.6.inc | 1 +
>>>>>>> meta/recipes-support/libevent/libevent_1.4.14b.bb | 3 ++-
>>>>>>> 6 files changed, 9 insertions(+), 4 deletions(-)
>>>>>>>
>>>>>>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>>>>>>> 101ecab..eff75ec 100644
>>>>>>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>>> @@ -1,4 +1,5 @@
>>>>>>> -DESCRIPTION = "nfs idmapping library"
>>>>>>> +SUMMARY = "NFS id mapping library"
>>>>>>> +DESCRIPTION = "NFS id mapping library"
>>>>>>> HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>>>>>> SECTION = "libs"
>>>>>>>
>>>>>>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>>>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>>>>>>> ec75ac9..eca54f1 100644
>>>>>>> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>>>> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>>>> @@ -1,7 +1,7 @@
>>>>>>> # dosfstools OE build file
>>>>>>> # Copyright (C) 2004-2006, Advanced Micro Devices, Inc. All Rights
>>>>>>> Reserved # Released under the MIT license (see packages/COPYING)
>>>>>>> -
>>>>>>> +SUMMARY = "DOS FAT Filesystem Utilities"
>>>>>>> DESCRIPTION = "DOS FAT Filesystem Utilities"
>>>>>>>
>>>>>>> SECTION = "base"
>>>>>>> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>>>>>>> a3dca3d..df0cae0 100644
>>>>>>> --- a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>>>> +++ b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>>>> @@ -1,4 +1,5 @@
>>>>>>> -DESCRIPTION = "Qemu helper scripts from Poky"
>>>>>>> +SUMMARY = "Qemu helper scripts"
>>>>>>> +DESCRIPTION = "Qemu helper scripts"
>>>>>>> LICENSE = "GPLv2"
>>>>>>> RDEPENDS_${PN} = "qemu-nativesdk"
>>>>>>> PR = "r9"
>>>>>>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>>>>>>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed
>>>>>>> 100644
>>>>>>> --- a/meta/recipes-extended/grep/grep_2.9.bb
>>>>>>> +++ b/meta/recipes-extended/grep/grep_2.9.bb
>>>>>>> @@ -1,3 +1,4 @@
>>>>>>> +SUMMARY = "GNU grep utility"
>>>>>>> DESCRIPTION = "GNU grep utility"
>>>>>>> HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>>>>>>> BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
>>>>>>> diff --git a/meta/recipes-support/icu/icu-3.6.inc
>>>>>>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
>>>>>>> --- a/meta/recipes-support/icu/icu-3.6.inc
>>>>>>> +++ b/meta/recipes-support/icu/icu-3.6.inc
>>>>>>> @@ -1,3 +1,4 @@
>>>>>>> +SUMMARY = "International Component for Unicode libraries"
>>>>>>> DESCRIPTION = "The International Component for Unicode (ICU) is a
>>>>>>> mature,
>>>>>>> portable set of C/C++ and Java libraries for Unicode support,
>>>>>>> software
>>>>>>> internationalization (I18N) and globalization (G11N), giving
>>>>>>> applications
>>>>>>> the same results on all platforms." HOMEPAGE =
>>>>>>> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>>>>>>
>>>>>>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index
>>>>>>> 1a369b5..36468dc
>>>>>>> 100644
>>>>>>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>>> @@ -1,4 +1,5 @@
>>>>>>> -DESCRIPTION = "an asynchronous event notification library"
>>>>>>> +SUMMARY = "An asynchronous event notification library"
>>>>>>> +DESCRIPTION = "An asynchronous event notification library"
>>>>>>> HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>>>>>> SECTION = "libs"
>>>>>> Sorry I sent it to the wrong list so now again:
>>>>>>
>>>>>> What is the value - apart HOB's sake - in creating redundancies by
>>>>>> copying
>>>>>> DESRCIPTION to SUMMARY? Why not use DESCRIPTION?
>>>>>
>>>>> (this is a copy of the email I sent to the oe-devel ML):
>>>>>
>>>>> Hi Andreas,
>>>>>
>>>>> I did this because SUMMARY is a required field by the HOB UI. This
>>>>> was requested by Shane Wang on the oe-core ML:
>>>>>
>>>>> http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/014600.html
>>>>>
>>>>>
>>>>> For recipes which have short descriptions, there was little sense in
>>>>> summarizing them further, so I duplicated the DESCRIPTION field.
>>>>> Above you can also see an example (in the icu recipe) were I did
>>>>> summarize a long DESCRIPTION field.
>>>>>
>>>>> Mark Hatle replied to this thread explaining why we previously
>>>>> allowed SUMMARY to be an optional field and how it automatically
>>>>> inherited from DESCRIPTION.
>>>>
>>>> So if it's automatically inherited why are these patches duplicating it?
>>>
>>> Hi Koen,
>>>
>>> Ah, I see why this is still confusing.
>>>
>>> Shane wrote:
>>>
>>> "If the summary is missing, bitbake will create a default value for
>>> summary. That is PN plus string " version " plus its version."
>>>
>>> So apparently the HOB UI isn't actually "inheriting" the DESCRIPTION
>>> field.
>>>
>>> Shane and Mark: can you clarify what the intended behavior is? Why would
>>> the HOB UI not inherit DESCRIPTION?
>>
>> I don't know. Within the bitbake.conf there is:
>>
>> DESCRIPTION ?= "${SUMMARY}"
>>
>> So it should just work...

I just realized, I had it backwards.. DESCRIPTION automatically inherits SUMMARY 
if SUMMARY is empty..  SUMMARY thought is simply the version string.

> It does work just not what HOB is looking for, HOB seems to be looking
> for a SUMMARY not DESCRIPTION first.  So if there is no SUMMARY HOB gets
> the bitbake.conf default of: SUMMARY ?= "${PN} version ${PV}-${PR}"
>
> Maybe HOB can be fixed to check if the ${SUMMARY} first word is ${PN}
> then use ${DESCRIPTION} instead of requiring all recipes have a SUMMARY?

Hmm..  I don't think that is the right solution.  If HOB wants a SUMMARY then 
SUMMARY is correct.. if it want's more descriptive info then it should go to 
DESCRIPTION.

It sounds like these packages either need the DESCRIPTION changed to SUMMARY -- 
or we need to change the way we're inheriting the variables.  It's been too long 
now since the original implementation to remember all of the permutations...

--Mark

> my 2 cents
>
> Sau!
>
>
>> --Mark
>>
>>> Scott
>>>
>>
>>
>> _______________________________________________
>> Openembedded-core mailing list
>> Openembedded-core@lists.openembedded.org
>> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-core
>>




^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19 18:10             ` Mark Hatle
@ 2011-12-20 15:53               ` Wang, Shane
  0 siblings, 0 replies; 12+ messages in thread
From: Wang, Shane @ 2011-12-20 15:53 UTC (permalink / raw)
  To: Mark Hatle, Saul Wold
  Cc: Garman, Scott A, Patches and discussions about the oe-core layer

Mark Hatle wrote on 2011-12-20:

> On 12/19/11 12:00 PM, Saul Wold wrote:
>> On 12/19/2011 09:44 AM, Mark Hatle wrote:
>>> On 12/19/11 11:28 AM, Scott Garman wrote:
>>>> On 12/19/2011 09:21 AM, Koen Kooi wrote:
>>>>> 
>>>>> Op 19 dec. 2011, om 18:17 heeft Scott Garman het volgende geschreven:
>>>>> 
>>>>>> On 12/19/2011 04:37 AM, Andreas Müller wrote:
>>>>>>> On Monday, December 19, 2011 10:34:47 AM git@git.openembedded.org
>>>>>>> wrote:
>>>>>>>> Module: openembedded-core.git
>>>>>>>> Branch: master
>>>>>>>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>>>>>>>> URL:
>>>>>>>> 
> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8
> c194a627
>>>>>>>> 
>>>>>>>> e091ef9da3b7fa83ea3897bd283d9e
>>>>>>>> 
>>>>>>>> Author: Scott Garman<scott.a.garman@intel.com>
>>>>>>>> Date: Sun Dec 18 15:06:57 2011 -0800
>>>>>>>> 
>>>>>>>> Add missing SUMMARY fields to various recipes
>>>>>>>> 
>>>>>>>> This adds the SUMMARY field to the following recipes which were
>>>>>>>> missing it:
>>>>>>>> 
>>>>>>>> * dosfstools
>>>>>>>> * grep
>>>>>>>> * icu
>>>>>>>> * libevent
>>>>>>>> * libnfsidmap
>>>>>>>> * qemu-helper-nativesdk
>>>>>>>> 
>>>>>>>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>>>>>>>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>>>>>>> 
>>>>>>>> ---
>>>>>>>> 
>>>>>>>> .../nfs-utils/libnfsidmap_0.24.bb | 3 ++-
>>>>>>>> .../recipes-devtools/dosfstools/dosfstools_2.11.bb | 2 +-
>>>>>>>> .../qemu/qemu-helper-nativesdk_1.0.bb | 3 ++-
>>>>>>>> meta/recipes-extended/grep/grep_2.9.bb | 1 +
>>>>>>>> meta/recipes-support/icu/icu-3.6.inc | 1 +
>>>>>>>> meta/recipes-support/libevent/libevent_1.4.14b.bb | 3 ++-
>>>>>>>> 6 files changed, 9 insertions(+), 4 deletions(-)
>>>>>>>> 
>>>>>>>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>>>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>>>>>>>> 101ecab..eff75ec 100644
>>>>>>>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>>>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>>>>> @@ -1,4 +1,5 @@
>>>>>>>> -DESCRIPTION = "nfs idmapping library"
>>>>>>>> +SUMMARY = "NFS id mapping library"
>>>>>>>> +DESCRIPTION = "NFS id mapping library"
>>>>>>>> HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>>>>>>> SECTION = "libs"
>>>>>>>> 
>>>>>>>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>>>>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>>>>>>>> ec75ac9..eca54f1 100644 ---
>>>>>>>> a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb +++
>>>>>>>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb @@ -1,7
>>>>>>>> +1,7 @@ # dosfstools OE build file # Copyright (C) 2004-2006,
>>>>>>>> Advanced Micro Devices, Inc. All Rights Reserved # Released under
>>>>>>>> the MIT license (see packages/COPYING) - +SUMMARY = "DOS FAT
>>>>>>>> Filesystem Utilities" DESCRIPTION = "DOS FAT Filesystem Utilities"
>>>>>>>> 
>>>>>>>> SECTION = "base" diff --git
>>>>>>>> a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>>>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>>>>>>>> a3dca3d..df0cae0 100644 ---
>>>>>>>> a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb +++
>>>>>>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb @@ -1,4
>>>>>>>> +1,5 @@ -DESCRIPTION = "Qemu helper scripts from Poky" +SUMMARY =
>>>>>>>> "Qemu helper scripts" +DESCRIPTION = "Qemu helper scripts"
>>>>>>>> LICENSE = "GPLv2" RDEPENDS_${PN} = "qemu-nativesdk" PR = "r9"
>>>>>>>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>>>>>>>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed
>>>>>>>> 100644 --- a/meta/recipes-extended/grep/grep_2.9.bb +++
>>>>>>>> b/meta/recipes-extended/grep/grep_2.9.bb @@ -1,3 +1,4 @@ +SUMMARY
>>>>>>>> = "GNU grep utility" DESCRIPTION = "GNU grep utility" HOMEPAGE =
>>>>>>>> "http://savannah.gnu.org/projects/grep/" BUGTRACKER =
>>>>>>>> "http://savannah.gnu.org/bugs/?group=grep" diff --git
>>>>>>>> a/meta/recipes-support/icu/icu-3.6.inc
>>>>>>>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2
>>>>>>>> 100644 --- a/meta/recipes-support/icu/icu-3.6.inc +++
>>>>>>>> b/meta/recipes-support/icu/icu-3.6.inc @@ -1,3 +1,4 @@ +SUMMARY =
>>>>>>>> "International Component for Unicode libraries" DESCRIPTION =
>>>>>>>> "The International Component for Unicode (ICU) is a mature,
>>>>>>>> portable set of C/C++ and Java libraries for Unicode support,
>>>>>>>> software internationalization (I18N) and globalization (G11N),
>>>>>>>> giving applications the same results on all platforms." HOMEPAGE
>>>>>>>> = "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>>>>>>> 
>>>>>>>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>>>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index
>>>>>>>> 1a369b5..36468dc
>>>>>>>> 100644
>>>>>>>> --- a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>>>> +++ b/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>>>>> @@ -1,4 +1,5 @@
>>>>>>>> -DESCRIPTION = "an asynchronous event notification library"
>>>>>>>> +SUMMARY = "An asynchronous event notification library"
>>>>>>>> +DESCRIPTION = "An asynchronous event notification library"
>>>>>>>> HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>>>>>>> SECTION = "libs"
>>>>>>> Sorry I sent it to the wrong list so now again:
>>>>>>> 
>>>>>>> What is the value - apart HOB's sake - in creating redundancies by
>>>>>>> copying
>>>>>>> DESRCIPTION to SUMMARY? Why not use DESCRIPTION?
>>>>>> 
>>>>>> (this is a copy of the email I sent to the oe-devel ML):
>>>>>> 
>>>>>> Hi Andreas,
>>>>>> 
>>>>>> I did this because SUMMARY is a required field by the HOB UI. This
>>>>>> was requested by Shane Wang on the oe-core ML:
>>>>>> 
>>>>>> 
> http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/0
> 14600.html
>>>>>> 
>>>>>> 
>>>>>> For recipes which have short descriptions, there was little sense in
>>>>>> summarizing them further, so I duplicated the DESCRIPTION field.
>>>>>> Above you can also see an example (in the icu recipe) were I did
>>>>>> summarize a long DESCRIPTION field.
>>>>>> 
>>>>>> Mark Hatle replied to this thread explaining why we previously
>>>>>> allowed SUMMARY to be an optional field and how it automatically
>>>>>> inherited from DESCRIPTION.
>>>>> 
>>>>> So if it's automatically inherited why are these patches duplicating it?
>>>> 
>>>> Hi Koen,
>>>> 
>>>> Ah, I see why this is still confusing.
>>>> 
>>>> Shane wrote:
>>>> 
>>>> "If the summary is missing, bitbake will create a default value for
>>>> summary. That is PN plus string " version " plus its version."
>>>> 
>>>> So apparently the HOB UI isn't actually "inheriting" the DESCRIPTION
>>>> field.
>>>> 
>>>> Shane and Mark: can you clarify what the intended behavior is? Why
>>>> would the HOB UI not inherit DESCRIPTION?
>>> 
>>> I don't know. Within the bitbake.conf there is:
>>> 
>>> DESCRIPTION ?= "${SUMMARY}"
>>> 
>>> So it should just work...
> 
> I just realized, I had it backwards.. DESCRIPTION automatically inherits
> SUMMARY if SUMMARY is empty..  SUMMARY thought is simply the version
> string.
> 
>> It does work just not what HOB is looking for, HOB seems to be looking
>> for a SUMMARY not DESCRIPTION first.  So if there is no SUMMARY HOB
>> gets the bitbake.conf default of: SUMMARY ?= "${PN} version ${PV}-${PR}"
>> 
>> Maybe HOB can be fixed to check if the ${SUMMARY} first word is ${PN}
>> then use ${DESCRIPTION} instead of requiring all recipes have a
> SUMMARY?
> 
> Hmm..  I don't think that is the right solution.  If HOB wants a SUMMARY
> then SUMMARY is correct.. if it want's more descriptive info then it
> should go to DESCRIPTION.
> 
> It sounds like these packages either need the DESCRIPTION changed to
> SUMMARY -- or we need to change the way we're inheriting the variables. 
> It's been too long now since the original implementation to remember all
> of the permutations...
> 
> --Mark
> 
>> my 2 cents
>> 
>> Sau!
>> 
>> 
>>> --Mark
>>> 
>>>> Scott
>>>> 

I agree with Mark at this point. Another case is what if a recipe has a summary but the summary starts with ${PN}? Extremely the summary *is* ${PN} version ${PV}-${PR}, then we get the description as the replacement, that is wrong.

HOB could get either summary or description or whatever, are both optional?

--
Shane



^ permalink raw reply	[flat|nested] 12+ messages in thread

* Re: [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes
  2011-12-19 17:28       ` Scott Garman
  2011-12-19 17:44         ` Mark Hatle
@ 2011-12-20 15:55         ` Wang, Shane
  1 sibling, 0 replies; 12+ messages in thread
From: Wang, Shane @ 2011-12-20 15:55 UTC (permalink / raw)
  To: Garman, Scott A, openembedded-core

Scott Garman wrote on 2011-12-20:

> On 12/19/2011 09:21 AM, Koen Kooi wrote:
>> 
>> Op 19 dec. 2011, om 18:17 heeft Scott Garman het volgende geschreven:
>> 
>>> On 12/19/2011 04:37 AM, Andreas Müller wrote:
>>>> On Monday, December 19, 2011 10:34:47 AM
> git@git.openembedded.org wrote:
>>>>> Module: openembedded-core.git
>>>>> Branch: master
>>>>> Commit: e8c194a627e091ef9da3b7fa83ea3897bd283d9e
>>>>> URL:
>>>>> 
> http://git.openembedded.org/?p=openembedded-core.git&a=commit;h=e8
> c194a627
>>>>> e091ef9da3b7fa83ea3897bd283d9e
>>>>> 
>>>>> Author: Scott Garman<scott.a.garman@intel.com>
>>>>> Date:   Sun Dec 18 15:06:57 2011 -0800
>>>>> 
>>>>> Add missing SUMMARY fields to various recipes
>>>>> 
>>>>> This adds the SUMMARY field to the following recipes which were
>>>>> missing it:
>>>>> 
>>>>> * dosfstools
>>>>> * grep
>>>>> * icu
>>>>> * libevent
>>>>> * libnfsidmap
>>>>> * qemu-helper-nativesdk
>>>>> 
>>>>> Signed-off-by: Scott Garman<scott.a.garman@intel.com>
>>>>> Signed-off-by: Richard Purdie<richard.purdie@linuxfoundation.org>
>>>>> 
>>>>> ---
>>>>> 
>>>>>   .../nfs-utils/libnfsidmap_0.24.bb                  |    3 ++-
>>>>>   .../recipes-devtools/dosfstools/dosfstools_2.11.bb |    2 +-
>>>>>   .../qemu/qemu-helper-nativesdk_1.0.bb              |    3 ++-
>>>>>   meta/recipes-extended/grep/grep_2.9.bb             |    1 +
>>>>>   meta/recipes-support/icu/icu-3.6.inc               |    1 +
>>>>>   meta/recipes-support/libevent/libevent_1.4.14b.bb  |    3 ++- 6
>>>>>   files changed, 9 insertions(+), 4 deletions(-)
>>>>> diff --git a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>> b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb index
>>>>> 101ecab..eff75ec 100644
>>>>> --- a/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>> +++ b/meta/recipes-connectivity/nfs-utils/libnfsidmap_0.24.bb
>>>>> @@ -1,4 +1,5 @@
>>>>> -DESCRIPTION = "nfs idmapping library"
>>>>> +SUMMARY = "NFS id mapping library"
>>>>> +DESCRIPTION = "NFS id mapping library"
>>>>>   HOMEPAGE = "http://www.citi.umich.edu/projects/nfsv4/linux/"
>>>>>   SECTION = "libs"
>>>>> diff --git a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>> b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb index
>>>>> ec75ac9..eca54f1 100644
>>>>> --- a/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>> +++ b/meta/recipes-devtools/dosfstools/dosfstools_2.11.bb
>>>>> @@ -1,7 +1,7 @@
>>>>>   # dosfstools OE build file
>>>>>   # Copyright (C) 2004-2006, Advanced Micro Devices, Inc.  All Rights
>>>>> Reserved # Released under the MIT license (see packages/COPYING)
>>>>> -
>>>>> +SUMMARY = "DOS FAT Filesystem Utilities"
>>>>>   DESCRIPTION = "DOS FAT Filesystem Utilities"
>>>>>   
>>>>>   SECTION = "base"
>>>>> diff --git a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb
>>>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb index
>>>>> a3dca3d..df0cae0 100644 ---
>>>>> a/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb +++
>>>>> b/meta/recipes-devtools/qemu/qemu-helper-nativesdk_1.0.bb @@ -1,4
>>>>> +1,5 @@ -DESCRIPTION = "Qemu helper scripts from Poky" +SUMMARY =
>>>>> "Qemu helper scripts" +DESCRIPTION = "Qemu helper scripts"
>>>>>   LICENSE = "GPLv2"
>>>>>   RDEPENDS_${PN} = "qemu-nativesdk"
>>>>>   PR = "r9"
>>>>> diff --git a/meta/recipes-extended/grep/grep_2.9.bb
>>>>> b/meta/recipes-extended/grep/grep_2.9.bb index 08ac527..9099bed
>>>>> 100644 --- a/meta/recipes-extended/grep/grep_2.9.bb +++
>>>>> b/meta/recipes-extended/grep/grep_2.9.bb @@ -1,3 +1,4 @@ +SUMMARY =
>>>>> "GNU grep utility"
>>>>>   DESCRIPTION = "GNU grep utility"
>>>>>   HOMEPAGE = "http://savannah.gnu.org/projects/grep/"
>>>>>   BUGTRACKER = "http://savannah.gnu.org/bugs/?group=grep"
>>>>> diff --git a/meta/recipes-support/icu/icu-3.6.inc
>>>>> b/meta/recipes-support/icu/icu-3.6.inc index 8fadc92..e3f9dd2 100644
>>>>> --- a/meta/recipes-support/icu/icu-3.6.inc
>>>>> +++ b/meta/recipes-support/icu/icu-3.6.inc
>>>>> @@ -1,3 +1,4 @@
>>>>> +SUMMARY = "International Component for Unicode libraries"
>>>>>   DESCRIPTION = "The International Component for Unicode (ICU) is
> a mature,
>>>>> portable set of C/C++ and Java libraries for Unicode support, software
>>>>> internationalization (I18N) and globalization (G11N), giving applications
>>>>> the same results on all platforms." HOMEPAGE =
>>>>> "http://www-01.ibm.com/software/globalization/icu/index.jsp"
>>>>> 
>>>>> diff --git a/meta/recipes-support/libevent/libevent_1.4.14b.bb
>>>>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb index
>>>>> 1a369b5..36468dc 100644 ---
>>>>> a/meta/recipes-support/libevent/libevent_1.4.14b.bb +++
>>>>> b/meta/recipes-support/libevent/libevent_1.4.14b.bb @@ -1,4 +1,5 @@
>>>>> -DESCRIPTION = "an asynchronous event notification library" +SUMMARY
>>>>> = "An asynchronous event notification library" +DESCRIPTION = "An
>>>>> asynchronous event notification library"
>>>>>   HOMEPAGE = "http://www.monkey.org/~provos/libevent/"
>>>>>   SECTION = "libs"
>>>> Sorry I sent it to the wrong list so now again:
>>>> 
>>>> What is the value - apart HOB's sake - in creating redundancies by
>>>> copying DESRCIPTION to SUMMARY? Why not use DESCRIPTION?
>>> 
>>> (this is a copy of the email I sent to the oe-devel ML):
>>> 
>>> Hi Andreas,
>>> 
>>> I did this because SUMMARY is a required field by the HOB UI. This was
>>> requested by Shane Wang on the oe-core ML:
>>> 
>>> 
> http://lists.linuxtogo.org/pipermail/openembedded-core/2011-December/0
> 14600.html
>>> 
>>> For recipes which have short descriptions, there was little sense in
> summarizing them further, so I duplicated the DESCRIPTION field. Above you
> can also see an example (in the icu recipe) were I did summarize a long
> DESCRIPTION field.
>>> 
>>> Mark Hatle replied to this thread explaining why we previously allowed
> SUMMARY to be an optional field and how it automatically inherited from
> DESCRIPTION.
>> 
>> So if it's automatically inherited why are these patches duplicating it?
> 
> Hi Koen,
> 
> Ah, I see why this is still confusing.
> 
> Shane wrote:
> 
> "If the summary is missing, bitbake will create a default value for
> summary. That is PN plus string " version " plus its version."
> 
> So apparently the HOB UI isn't actually "inheriting" the DESCRIPTION field.
> 
> Shane and Mark: can you clarify what the intended behavior is? Why would
> the HOB UI not inherit DESCRIPTION?
> 
> Scott
>

I don't why. From the HOB 1.1 code, it started to use SUMMARY instead of DESCRIPTION.
Is DESCRIPTION required for a recipe?

--
Shane



^ permalink raw reply	[flat|nested] 12+ messages in thread

end of thread, other threads:[~2011-12-20 16:04 UTC | newest]

Thread overview: 12+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
     [not found] <20111219093447.C6DBE10331@opal>
2011-12-19  9:54 ` [oe-commits] Scott Garman : Add missing SUMMARY fields to various recipes Andreas Müller
2011-12-19 15:54   ` Mark Hatle
2011-12-19 16:28   ` Scott Garman
2011-12-19 12:37 ` Andreas Müller
2011-12-19 17:17   ` Scott Garman
2011-12-19 17:21     ` Koen Kooi
2011-12-19 17:28       ` Scott Garman
2011-12-19 17:44         ` Mark Hatle
2011-12-19 18:00           ` Saul Wold
2011-12-19 18:10             ` Mark Hatle
2011-12-20 15:53               ` Wang, Shane
2011-12-20 15:55         ` Wang, Shane

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.