All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH 0/3] utils for touchscreen calibration
@ 2011-07-26 12:30 edwin.zhai
  2011-07-26 12:30 ` [PATCH 1/3] xinput: Add 1.5.3 as new recipes edwin.zhai
                   ` (2 more replies)
  0 siblings, 3 replies; 11+ messages in thread
From: edwin.zhai @ 2011-07-26 12:30 UTC (permalink / raw)
  To: openembedded-core

From: Zhai Edwin <edwin.zhai@intel.com>

These are some debug and calibration utils for touchscreen. Xinput and evtest
can also be used for other input device. I'm not sure about where they should
go under meta. Any comments?

Thanks,
Edwin

The following changes since commit e0fc42b51a8209dac1163ae8126f8c687b6bfddf:

  distro_tracking_fields.inc: update RECIPE_MANUAL_CHECK_DATE for screen and tcf-agent (2011-06-29 15:04:59 +0100)

are available in the git repository at:
  git://git.pokylinux.org/poky-contrib gzhai/master
  http://git.pokylinux.org/cgit.cgi/poky-contrib/log/?h=gzhai/master

Zhai Edwin (3):
  xinput: Add 1.5.3 as new recipes
  xinput-calibrator: Add 0.7.5 as new recipe
  evtest: Add 1.25 as new recipe

 meta/recipes-graphics/evtest/evtest_1.25.bb        |   16 +++++++++++++
 .../xinput-calibrator/xinput-calibrator_0.7.5.bb   |   24 ++++++++++++++++++++
 meta/recipes-graphics/xorg-app/xinput_1.5.3.bb     |    9 +++++++
 3 files changed, 49 insertions(+), 0 deletions(-)
 create mode 100644 meta/recipes-graphics/evtest/evtest_1.25.bb
 create mode 100644 meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
 create mode 100644 meta/recipes-graphics/xorg-app/xinput_1.5.3.bb




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

* [PATCH 1/3] xinput: Add 1.5.3 as new recipes
  2011-07-26 12:30 [PATCH 0/3] utils for touchscreen calibration edwin.zhai
@ 2011-07-26 12:30 ` edwin.zhai
  2011-07-26 12:30 ` [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe edwin.zhai
  2011-07-26 12:30 ` [PATCH 3/3] evtest: Add 1.25 " edwin.zhai
  2 siblings, 0 replies; 11+ messages in thread
From: edwin.zhai @ 2011-07-26 12:30 UTC (permalink / raw)
  To: openembedded-core

From: Zhai Edwin <edwin.zhai@intel.com>

Signed-off-by: Zhai Edwin <edwin.zhai@intel.com>
---
 meta/recipes-graphics/xorg-app/xinput_1.5.3.bb |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)
 create mode 100644 meta/recipes-graphics/xorg-app/xinput_1.5.3.bb

diff --git a/meta/recipes-graphics/xorg-app/xinput_1.5.3.bb b/meta/recipes-graphics/xorg-app/xinput_1.5.3.bb
new file mode 100644
index 0000000..cc71857
--- /dev/null
+++ b/meta/recipes-graphics/xorg-app/xinput_1.5.3.bb
@@ -0,0 +1,9 @@
+require xorg-app-common.inc
+DESCRIPTION = "a utility to configure and test XInput devices"
+DEPENDS += " libxi"
+PR = "r0"
+
+LIC_FILES_CHKSUM = "file://COPYING;md5=22c34ea36136407a77702a8b784f9bd0"
+
+SRC_URI[md5sum] = "1e2f0ad4f3fa833b65c568907f171d28"
+SRC_URI[sha256sum] = "6aade131cecddaeefc39ddce1dd5e8473f6039c2e4efbfd9fbb5ee2a75885c76"
-- 
1.7.1




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

* [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe
  2011-07-26 12:30 [PATCH 0/3] utils for touchscreen calibration edwin.zhai
  2011-07-26 12:30 ` [PATCH 1/3] xinput: Add 1.5.3 as new recipes edwin.zhai
@ 2011-07-26 12:30 ` edwin.zhai
  2011-07-26 12:53   ` Koen Kooi
  2011-07-26 12:30 ` [PATCH 3/3] evtest: Add 1.25 " edwin.zhai
  2 siblings, 1 reply; 11+ messages in thread
From: edwin.zhai @ 2011-07-26 12:30 UTC (permalink / raw)
  To: openembedded-core

From: Zhai Edwin <edwin.zhai@intel.com>

Signed-off-by: Zhai Edwin <edwin.zhai@intel.com>
---
 .../xinput-calibrator/xinput-calibrator_0.7.5.bb   |   24 ++++++++++++++++++++
 1 files changed, 24 insertions(+), 0 deletions(-)
 create mode 100644 meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb

diff --git a/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb b/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
new file mode 100644
index 0000000..5a868f7
--- /dev/null
+++ b/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
@@ -0,0 +1,24 @@
+DESCRIPTION = "A generic touchscreen calibration program for X.Org"
+HOMEPAGE = "http://www.freedesktop.org/wiki/Software/xinput_calibrator"
+
+LICENSE = "MIT/X11"
+LIC_FILES_CHKSUM = "file://COPYING;md5=d9a6926aaad6b8f38bb4f995fe088466\
+                    file://src/calibrator.cpp;endline=22;md5=998e238a7638a7446eaeb02398f691fc"
+
+DEPENDS = "virtual/libx11 libxi"
+
+inherit autotools
+
+RDEPENDS_${PN} = "xinput"
+
+SRC_URI = "http://github.com/downloads/tias/xinput_calibrator/xinput_calibrator-${PV}.tar.gz"
+SRC_URI[md5sum] = "20da0a2055a5a75962add8c6b44f60fa"
+SRC_URI[sha256sum] = "baa4ddca49ec94c27ba4c715bfa26692fec1132103e927213c3169e475d3d971"
+
+S = "${WORKDIR}/xinput_calibrator-${PV}"
+
+do_install_append() {
+        install -d ${D}${bindir}
+        install -m 0755 scripts/xinput_calibrator_pointercal.sh ${D}${bindir}/xinput_calibrator_once.sh
+        install -m 0755 scripts/xinput_calibrator_get_hal_calibration.sh ${D}${bindir}/xinput_calibrator_get_hal_calibration.sh
+}
-- 
1.7.1




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

* [PATCH 3/3] evtest: Add 1.25 as new recipe
  2011-07-26 12:30 [PATCH 0/3] utils for touchscreen calibration edwin.zhai
  2011-07-26 12:30 ` [PATCH 1/3] xinput: Add 1.5.3 as new recipes edwin.zhai
  2011-07-26 12:30 ` [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe edwin.zhai
@ 2011-07-26 12:30 ` edwin.zhai
  2 siblings, 0 replies; 11+ messages in thread
From: edwin.zhai @ 2011-07-26 12:30 UTC (permalink / raw)
  To: openembedded-core

From: Zhai Edwin <edwin.zhai@intel.com>

Signed-off-by: Zhai Edwin <edwin.zhai@intel.com>
---
 meta/recipes-graphics/evtest/evtest_1.25.bb |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)
 create mode 100644 meta/recipes-graphics/evtest/evtest_1.25.bb

diff --git a/meta/recipes-graphics/evtest/evtest_1.25.bb b/meta/recipes-graphics/evtest/evtest_1.25.bb
new file mode 100644
index 0000000..ddd451b
--- /dev/null
+++ b/meta/recipes-graphics/evtest/evtest_1.25.bb
@@ -0,0 +1,16 @@
+DESCRIPTION = "Simple tool for input event debugging."
+HOMEPAGE = "http://people.freedesktop.org/~whot/evtest/"
+SECTION = "console/utils"
+
+LICENSE = "GPLv2"
+LIC_FILES_CHKSUM = "file://COPYING;md5=751419260aa954499f7abaabaa882bbe"
+
+PR = "r0"
+
+DEPENDS = "libxml2"
+
+SRC_URI = "http://cgit.freedesktop.org/~whot/evtest/snapshot/evtest-${PV}.tar.bz2"
+SRC_URI[md5sum] = "770d6af03affe976bdbe3ad1a922c973"
+SRC_URI[sha256sum] = "3d34123c68014dae6f7c19144ef79ea2915fa7a2f89ea35ca375a9cf9e191473"
+
+inherit autotools
-- 
1.7.1




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

* Re: [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe
  2011-07-26 12:30 ` [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe edwin.zhai
@ 2011-07-26 12:53   ` Koen Kooi
  2011-07-26 13:26     ` Richard Purdie
  2011-07-27  0:56     ` Zhai, Edwin
  0 siblings, 2 replies; 11+ messages in thread
From: Koen Kooi @ 2011-07-26 12:53 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer

This one looks suspicously like the one in meta-oe. Apart from that, is it really needed in oe-core?

Op 26 jul. 2011, om 14:30 heeft edwin.zhai@intel.com het volgende geschreven:

> From: Zhai Edwin <edwin.zhai@intel.com>
> 
> Signed-off-by: Zhai Edwin <edwin.zhai@intel.com>
> ---
> .../xinput-calibrator/xinput-calibrator_0.7.5.bb   |   24 ++++++++++++++++++++
> 1 files changed, 24 insertions(+), 0 deletions(-)
> create mode 100644 meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
> 
> diff --git a/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb b/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
> new file mode 100644
> index 0000000..5a868f7
> --- /dev/null
> +++ b/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
> @@ -0,0 +1,24 @@
> +DESCRIPTION = "A generic touchscreen calibration program for X.Org"
> +HOMEPAGE = "http://www.freedesktop.org/wiki/Software/xinput_calibrator"
> +
> +LICENSE = "MIT/X11"
> +LIC_FILES_CHKSUM = "file://COPYING;md5=d9a6926aaad6b8f38bb4f995fe088466\
> +                    file://src/calibrator.cpp;endline=22;md5=998e238a7638a7446eaeb02398f691fc"
> +
> +DEPENDS = "virtual/libx11 libxi"
> +
> +inherit autotools
> +
> +RDEPENDS_${PN} = "xinput"
> +
> +SRC_URI = "http://github.com/downloads/tias/xinput_calibrator/xinput_calibrator-${PV}.tar.gz"
> +SRC_URI[md5sum] = "20da0a2055a5a75962add8c6b44f60fa"
> +SRC_URI[sha256sum] = "baa4ddca49ec94c27ba4c715bfa26692fec1132103e927213c3169e475d3d971"
> +
> +S = "${WORKDIR}/xinput_calibrator-${PV}"
> +
> +do_install_append() {
> +        install -d ${D}${bindir}
> +        install -m 0755 scripts/xinput_calibrator_pointercal.sh ${D}${bindir}/xinput_calibrator_once.sh
> +        install -m 0755 scripts/xinput_calibrator_get_hal_calibration.sh ${D}${bindir}/xinput_calibrator_get_hal_calibration.sh
> +}
> -- 
> 1.7.1
> 
> 
> _______________________________________________
> Openembedded-core mailing list
> Openembedded-core@lists.openembedded.org
> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-core




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

* Re: [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe
  2011-07-26 12:53   ` Koen Kooi
@ 2011-07-26 13:26     ` Richard Purdie
  2011-07-26 13:36       ` Koen Kooi
  2011-08-03  7:53       ` Zhai, Edwin
  2011-07-27  0:56     ` Zhai, Edwin
  1 sibling, 2 replies; 11+ messages in thread
From: Richard Purdie @ 2011-07-26 13:26 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer

On Tue, 2011-07-26 at 14:53 +0200, Koen Kooi wrote:
> This one looks suspicously like the one in meta-oe. Apart from that,
> is it really needed in oe-core?

Given that the xcalibrate extension has been removed from the xserver I
think we're going to either need to migrate the tools like xtscal or
adopt other tools. Certainly OE-Core should have a consistent story for
touchscreens...

Cheers,

Richard




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

* Re: [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe
  2011-07-26 13:26     ` Richard Purdie
@ 2011-07-26 13:36       ` Koen Kooi
  2011-08-03  7:53       ` Zhai, Edwin
  1 sibling, 0 replies; 11+ messages in thread
From: Koen Kooi @ 2011-07-26 13:36 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer


Op 26 jul. 2011, om 15:26 heeft Richard Purdie het volgende geschreven:

> On Tue, 2011-07-26 at 14:53 +0200, Koen Kooi wrote:
>> This one looks suspicously like the one in meta-oe. Apart from that,
>> is it really needed in oe-core?
> 
> Given that the xcalibrate extension has been removed from the xserver I
> think we're going to either need to migrate the tools like xtscal or
> adopt other tools. Certainly OE-Core should have a consistent story for
> touchscreens…

If you're going to copy over the meta-oe recipes 1:1 it makes sense to merge the remaining x differences as well. It would make meta-oe a lot smaller :)


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

* Re: [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe
  2011-07-26 12:53   ` Koen Kooi
  2011-07-26 13:26     ` Richard Purdie
@ 2011-07-27  0:56     ` Zhai, Edwin
  1 sibling, 0 replies; 11+ messages in thread
From: Zhai, Edwin @ 2011-07-27  0:56 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer

I borrowed it from meta-oe with minor modification.
xinput is very useful for debug and test of input device under X. 
xinput_calibrator is a must for touchscreen device.

Koen Kooi wrote:
>
> This one looks suspicously like the one in meta-oe. Apart from that, 
> is it really needed in oe-core?
>
> Op 26 jul. 2011, om 14:30 heeft edwin.zhai@intel.com het volgende 
> geschreven:
>
> > From: Zhai Edwin <edwin.zhai@intel.com>
> >
> > Signed-off-by: Zhai Edwin <edwin.zhai@intel.com>
> > ---
> > .../xinput-calibrator/xinput-calibrator_0.7.5.bb   |   24 
> ++++++++++++++++++++
> > 1 files changed, 24 insertions(+), 0 deletions(-)
> > create mode 100644 
> meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
> >
> > diff --git 
> a/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb 
> b/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
>
> > new file mode 100644
> > index 0000000..5a868f7
> > --- /dev/null
> > +++ 
> b/meta/recipes-graphics/xinput-calibrator/xinput-calibrator_0.7.5.bb
> > @@ -0,0 +1,24 @@
> > +DESCRIPTION = "A generic touchscreen calibration program for X.Org"
> > +HOMEPAGE = 
> "http://www.freedesktop.org/wiki/Software/xinput_calibrator"
> > +
> > +LICENSE = "MIT/X11"
> > +LIC_FILES_CHKSUM = 
> "file://COPYING;md5=d9a6926aaad6b8f38bb4f995fe088466\ 
> <file://COPYING;md5=d9a6926aaad6b8f38bb4f995fe088466%5C>
> > +                    
> file://src/calibrator.cpp;endline=22;md5=998e238a7638a7446eaeb02398f691fc" 
>
> > +
> > +DEPENDS = "virtual/libx11 libxi"
> > +
> > +inherit autotools
> > +
> > +RDEPENDS_${PN} = "xinput"
> > +
> > +SRC_URI = 
> "http://github.com/downloads/tias/xinput_calibrator/xinput_calibrator-${PV}.tar.gz" 
>
> > +SRC_URI[md5sum] = "20da0a2055a5a75962add8c6b44f60fa"
> > +SRC_URI[sha256sum] = 
> "baa4ddca49ec94c27ba4c715bfa26692fec1132103e927213c3169e475d3d971"
> > +
> > +S = "${WORKDIR}/xinput_calibrator-${PV}"
> > +
> > +do_install_append() {
> > +        install -d ${D}${bindir}
> > +        install -m 0755 scripts/xinput_calibrator_pointercal.sh 
> ${D}${bindir}/xinput_calibrator_once.sh
> > +        install -m 0755 
> scripts/xinput_calibrator_get_hal_calibration.sh 
> ${D}${bindir}/xinput_calibrator_get_hal_calibration.sh
>
> > +}
> > --
> > 1.7.1
> >
> >
> > _______________________________________________
> > Openembedded-core mailing list
> > Openembedded-core@lists.openembedded.org
> > http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-core
>
>
> _______________________________________________
> Openembedded-core mailing list
> Openembedded-core@lists.openembedded.org
> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-core
>



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

* Re: [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe
  2011-07-26 13:26     ` Richard Purdie
  2011-07-26 13:36       ` Koen Kooi
@ 2011-08-03  7:53       ` Zhai, Edwin
  2011-08-03 15:00         ` Khem Raj
  1 sibling, 1 reply; 11+ messages in thread
From: Zhai, Edwin @ 2011-08-03  7:53 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer



Richard Purdie wrote:
>
> On Tue, 2011-07-26 at 14:53 +0200, Koen Kooi wrote:
> > This one looks suspicously like the one in meta-oe. Apart from that,
> > is it really needed in oe-core?
>
> Given that the xcalibrate extension has been removed from the xserver I
> think we're going to either need to migrate the tools like xtscal or
> adopt other tools. Certainly OE-Core should have a consistent story for
> touchscreens...
>

RP,
There is another recipe pointercal-xinput that provides script for 
calibration based on xinput_calibrator's output. So moving xinput, 
xinput_calibrator and pointercal-xinput from meta-oe to oe-core make a 
consistent story?

If no objection, I'll do this...
>
> Cheers,
>
> Richard
>
>
> _______________________________________________
> Openembedded-core mailing list
> Openembedded-core@lists.openembedded.org
> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-core
>



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

* Re: [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe
  2011-08-03  7:53       ` Zhai, Edwin
@ 2011-08-03 15:00         ` Khem Raj
  2011-08-03 15:13           ` Koen Kooi
  0 siblings, 1 reply; 11+ messages in thread
From: Khem Raj @ 2011-08-03 15:00 UTC (permalink / raw)
  To: openembedded-core

On 08/03/2011 12:53 AM, Zhai, Edwin wrote:
>
>
> Richard Purdie wrote:
>>
>> On Tue, 2011-07-26 at 14:53 +0200, Koen Kooi wrote:
>> > This one looks suspicously like the one in meta-oe. Apart from that,
>> > is it really needed in oe-core?
>>
>> Given that the xcalibrate extension has been removed from the xserver I
>> think we're going to either need to migrate the tools like xtscal or
>> adopt other tools. Certainly OE-Core should have a consistent story for
>> touchscreens...
>>
>
> RP,
> There is another recipe pointercal-xinput that provides script for
> calibration based on xinput_calibrator's output. So moving xinput,
> xinput_calibrator and pointercal-xinput from meta-oe to oe-core make a
> consistent story?
>
> If no objection, I'll do this...

yes please. I have not been able to caliberate screen using 
xinput-calibrator. I would try anything that will get me going.

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




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

* Re: [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe
  2011-08-03 15:00         ` Khem Raj
@ 2011-08-03 15:13           ` Koen Kooi
  0 siblings, 0 replies; 11+ messages in thread
From: Koen Kooi @ 2011-08-03 15:13 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer


Op 3 aug. 2011, om 17:00 heeft Khem Raj het volgende geschreven:

> On 08/03/2011 12:53 AM, Zhai, Edwin wrote:
>> 
>> 
>> Richard Purdie wrote:
>>> 
>>> On Tue, 2011-07-26 at 14:53 +0200, Koen Kooi wrote:
>>> > This one looks suspicously like the one in meta-oe. Apart from that,
>>> > is it really needed in oe-core?
>>> 
>>> Given that the xcalibrate extension has been removed from the xserver I
>>> think we're going to either need to migrate the tools like xtscal or
>>> adopt other tools. Certainly OE-Core should have a consistent story for
>>> touchscreens...
>>> 
>> 
>> RP,
>> There is another recipe pointercal-xinput that provides script for
>> calibration based on xinput_calibrator's output. So moving xinput,
>> xinput_calibrator and pointercal-xinput from meta-oe to oe-core make a
>> consistent story?
>> 
>> If no objection, I'll do this...
> 
> yes please. I have not been able to caliberate screen using xinput-calibrator. I would try anything that will get me going.

I've only used it under X and if you use xf86-input-evdev it "just works". The most recent system I tried was an ipaq hx4700 with kernel 3.0.


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

end of thread, other threads:[~2011-08-03 15:17 UTC | newest]

Thread overview: 11+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2011-07-26 12:30 [PATCH 0/3] utils for touchscreen calibration edwin.zhai
2011-07-26 12:30 ` [PATCH 1/3] xinput: Add 1.5.3 as new recipes edwin.zhai
2011-07-26 12:30 ` [PATCH 2/3] xinput-calibrator: Add 0.7.5 as new recipe edwin.zhai
2011-07-26 12:53   ` Koen Kooi
2011-07-26 13:26     ` Richard Purdie
2011-07-26 13:36       ` Koen Kooi
2011-08-03  7:53       ` Zhai, Edwin
2011-08-03 15:00         ` Khem Raj
2011-08-03 15:13           ` Koen Kooi
2011-07-27  0:56     ` Zhai, Edwin
2011-07-26 12:30 ` [PATCH 3/3] evtest: Add 1.25 " edwin.zhai

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.