All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jeff Garzik <jgarzik@pobox.com>
To: Linus Torvalds <torvalds@osdl.org>, Andrew Morton <akpm@osdl.org>
Cc: Kernel Mailing List <linux-kernel@vger.kernel.org>
Subject: workflow (was Re: RFD: Kernel release numbering)
Date: Wed, 02 Mar 2005 19:17:57 -0500	[thread overview]
Message-ID: <422657B5.7030702@pobox.com> (raw)
In-Reply-To: <Pine.LNX.4.58.0503021340520.25732@ppc970.osdl.org>

Other ideas <thinking out loud>...

I maintain my netdev-2.6 queue by creating a ton of "subject-specific" 
repositories locally,

> 8139cp/     bonding/  ieee80211/    mips/     sis900/    typhoon/
> 8139too/    e1000/    ixgb/         misc/     skge/      viro-iomap/
> 8139too-2/  ham/      janitor/      mv643xx/  sk_mca/    viro-iomap-orinoco/
> ALL/        ibmlana/  kill-iphase/  pcnet32/  smc91x/    viro-isa-ectomy/
> atmel/      ibmtr/    mii/          s2io/     sundance/  wifi/

and I pull all of these into a master repository netdev-2.6 (locally 
'ALL').  netdev-2.6, in turn, gets pulled into -mm when Andrew makes a 
new release.  When I am ready to push something upstream, I pull one or 
more repositories into my net-drivers-2.6 queue, which is essentially my 
"push to upstream" queue.

This scheme allows me to cherry-pick fixes and features.  If a critical 
fix comes along, it doesn't have to wait for the other less-critical 309 
changesets to go.


We could have a linus-pending-2.6 queue, managed by Linus, that 
functions in a similar manner to my netdev-2.6:

a) Have a monthly or weekly official release.  Could be automated, but 
probably not.

b) snapshots of linus-pending-2.6 function as a development tree, taking 
over some of the current -mm purpose...  -mm is just too massive and 
multi-purpose at this point

c) locally [or publicly?], Linus sorts patches and 'bk pulls' into 
specific repositories, as I do with netdev-2.6.  "sata", "sata-fixes", 
"net drivers", "net drivers - janitorial", etc. could be potential pull 
queues from me to Linus.

d) When features/fixes are ready to move from linus-pending-2.6 to 
linux-2.6 repository, Linus just does a pull+push locally.  Fixes would 
likely go immediately into linux-2.6, unless it needs staging in 
linus-pending-2.6 first.  Potentially destabilizing stuff stays longer 
in linus-pending-2.6.

Thus, Linus controls the patch flow (and stability/features) simply by 
choosing when to pull stuff from the on-going dev tree that he manages.

e) Andrew continues doing what he's been doing:  merging tons of 
patches, staging big features, etc.


So what does this accomplish, besides increasing the complexity of 
Linus's work?  What's the point?

1) Creates a structure to enable linux-2.6 to be the on-going stable 
tree, by creating an official on-going dev tree.

2) Release early, release often.  The proposal that started this thread 
does the opposite: it slows things down.

3) Makes it easier to manage the flow of changesets.

4) Takes pressure off -mm to be "everything under the sun."  Users are 
far more likely to test a tree that is blessed with Holy Penguin Pee, 
and builds on all architectures.  And this in turn gives -mm more freedom.

	Jeff, trying to think outside the box




  parent reply	other threads:[~2005-03-03  0:23 UTC|newest]

Thread overview: 370+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2005-03-02 22:21 RFD: Kernel release numbering Linus Torvalds
2005-03-02 22:53 ` Jeff V. Merkey
2005-03-02 23:26   ` Randy.Dunlap
2005-03-02 23:28     ` Jeff V. Merkey
2005-03-02 23:38   ` Zwane Mwaikambo
2005-03-03  2:09     ` Jeff V. Merkey
2005-03-03  0:20   ` Wakko Warner
2005-03-03  5:11   ` Valdis.Kletnieks
2005-03-02 22:55 ` Dmitry Torokhov
2005-03-02 22:58 ` Lars Marowsky-Bree
2005-03-02 23:23   ` Greg KH
2005-03-03 14:31     ` Lars Marowsky-Bree
2005-03-02 23:44   ` Zwane Mwaikambo
2005-03-03  2:14     ` Neil Brown
2005-03-04 18:25       ` Zwane Mwaikambo
2005-03-02 23:44   ` Linus Torvalds
2005-03-03  0:32     ` Dave Jones
2005-03-03 22:22       ` Alan Cox
2005-03-02 22:58 ` Andrew Morton
2005-03-02 23:20   ` Randy.Dunlap
2005-03-02 23:04 ` Greg KH
2005-03-02 23:34   ` Willy Tarreau
2005-03-02 23:55     ` Greg KH
2005-03-02 23:04 ` Dave Jones
2005-03-02 23:06 ` Russell King
2005-03-02 23:22   ` Dave Jones
2005-03-02 23:45   ` Jeff Garzik
2005-03-03  0:00     ` Linus Torvalds
2005-03-03  0:20       ` Greg KH
2005-03-03  1:15         ` Linus Torvalds
2005-03-03  2:21           ` Gene Heskett
2005-03-03 10:29             ` Prakash Punnoor
2005-03-03 11:08               ` Paolo Ciarrocchi
2005-03-03 16:20               ` Lee Revell
2005-03-03  6:07           ` Willy Tarreau
2005-03-03  8:19           ` Greg KH
2005-03-03  8:38             ` Jeff Garzik
2005-03-03  9:01               ` Greg KH
2005-03-03  9:18                 ` Jeff Garzik
2005-03-03 10:15                   ` Andrew Morton
2005-03-03 10:26                     ` Wichert Akkerman
2005-03-03 10:45                       ` Andrew Morton
2005-03-03 10:59                     ` Jeff Garzik
2005-03-03 14:08                       ` Wichert Akkerman
2005-03-03 16:19                       ` Chris Wright
2005-03-03 19:41                       ` Krzysztof Halasa
2005-03-03 21:58                         ` Christoph Hellwig
2005-03-03 11:01                     ` Thomas Gleixner
2005-03-03 11:13                     ` Adrian Bunk
2005-03-03 17:07                     ` Bill Rugolsky Jr.
2005-03-03 19:33                       ` Dave Jones
2005-03-03 20:38                         ` Bill Rugolsky Jr.
2005-03-03 21:28                           ` Jeff Garzik
2005-03-03 22:15                             ` Adrian Bunk
2005-03-06  7:53                               ` Andres Salomon
2005-03-06  8:05                                 ` Willy Tarreau
2005-03-06 23:12                                 ` Alan Cox
2005-03-09 12:34                             ` szonyi calin
2005-03-03  0:27       ` Dave Jones
2005-03-03  3:10         ` Randy.Dunlap
2005-03-03  3:47           ` Dave Jones
2005-03-03  4:03             ` Randy.Dunlap
2005-03-03 10:26           ` Erik Hensema
2005-03-03 16:28           ` Jochen Striepe
2005-03-04 10:40           ` Russell King
2005-03-04 11:32           ` Jesper Juhl
2005-03-04 14:12             ` Jens Axboe
2005-03-04 19:41               ` Jesper Juhl
2005-03-06  0:00                 ` Christoph Hellwig
2005-03-08 12:52           ` szonyi calin
2005-03-03  4:38         ` Andrew Morton
2005-03-03  5:21           ` Dave Jones
2005-03-03  5:26             ` Randy.Dunlap
2005-03-03 16:36             ` Lee Revell
2005-03-03 20:43             ` Diego Calleja
2005-03-04 11:06               ` Russell King
2005-03-04 13:04                 ` Diego Calleja
2005-03-03 21:49             ` John Cherry
2005-03-03 21:52               ` Dave Jones
2005-03-03 22:02                 ` John Cherry
2005-03-08 23:25             ` szonyi calin
2005-03-08 23:39               ` Andrew Morton
2005-03-08 23:44               ` Lee Revell
2005-03-08 23:50               ` Lee Revell
2005-03-09 18:03                 ` Alan Cox
2005-03-04 10:52           ` Russell King
2005-03-04 11:11             ` Ian Campbell
2005-03-04 11:16               ` Russell King
2005-03-04 11:32                 ` Ian Campbell
2005-03-05 12:26                   ` David Weinehall
2005-03-04 11:26             ` Andrew Morton
2005-03-04 11:36               ` Russell King
2005-03-04 11:44                 ` Andrew Morton
2005-03-04 11:54                   ` Russell King
2005-03-04 12:40                 ` Richard Purdie
2005-03-04 13:25                   ` Russell King
2005-03-04 17:33                     ` Richard Purdie
2005-03-04 18:11                       ` Russell King
2005-03-04 18:32                         ` Jan Dittmer
2005-03-05 17:49                         ` Richard Purdie
2005-03-04 19:35                       ` David Greaves
2005-03-04 22:22                       ` Andrew Morton
2005-03-04 22:27                         ` Russell King
2005-03-04 22:48                           ` Andrew Morton
2005-03-04 23:04                             ` Russell King
2005-03-04 16:44                 ` Adrian Bunk
2005-05-06 22:58                 ` Russell King
2005-05-06 23:18                   ` Andrew Morton
2005-05-07 10:51                   ` Jan Dittmer
2005-05-07 11:26                     ` Russell King
2005-05-07 13:20                       ` Jan Dittmer
2005-05-07 14:29                         ` Adrian Bunk
2005-05-07 14:29                           ` Adrian Bunk
2005-05-07 14:41                         ` select of non-existing I2C* symbols Adrian Bunk
2005-05-07 14:41                           ` Adrian Bunk
2005-05-08 18:20                           ` [kbuild-devel] " Sam Ravnborg
2005-05-08 18:20                             ` Sam Ravnborg
2005-05-08 18:28                             ` Russell King
2005-05-08 18:28                               ` Russell King
2005-05-11 22:53                             ` Adrian Bunk
2005-05-11 22:53                               ` Adrian Bunk
2005-05-11 14:30                           ` William Lee Irwin III
2005-05-11 14:30                             ` William Lee Irwin III
2005-05-11 22:50                             ` Adrian Bunk
2005-05-11 22:50                               ` Adrian Bunk
2005-06-07  3:13                               ` William Lee Irwin III
2005-06-07  3:13                                 ` William Lee Irwin III
2005-05-07 14:45                         ` frv, v850: no defconfig's Adrian Bunk
2005-05-07 15:01                         ` [-mm patch] fix typo in arch/h8300/Kconfig.cpu Adrian Bunk
2005-03-08 15:12               ` RFD: Kernel release numbering Ralf Baechle
2005-03-03  0:44       ` Jeff Garzik
2005-03-02 23:08 ` Nigel Cunningham
2005-03-02 23:10 ` Josh Boyer
2005-03-02 23:12 ` Willy Tarreau
2005-03-03  8:59   ` Matthew Frost
2005-03-03 14:15     ` Ryan Anderson
2005-03-02 23:18 ` Mark Gross
2005-03-02 23:42 ` Jeff Garzik
2005-03-03  0:23   ` Andrew Morton
2005-03-03  0:29     ` Jeff Garzik
2005-03-03  0:58       ` David S. Miller
2005-03-03  1:11         ` Dave Jones
2005-03-03  1:20           ` Andrew Morton
2005-03-03  1:27             ` Dave Jones
2005-03-03 14:58               ` Andries Brouwer
2005-03-03 19:55                 ` Krzysztof Halasa
2005-03-03 21:09                 ` Andrew Morton
2005-03-03 21:26                   ` Dave Jones
2005-03-03 21:31                     ` Jeff Garzik
2005-03-03 23:39                     ` Bill Nottingham
2005-03-04  9:16                     ` Jaroslav Kysela
2005-03-03 22:24               ` Alan Cox
2005-03-03  1:59             ` Neil Brown
2005-03-03  3:10               ` Christoph Hellwig
2005-03-03 14:54                 ` Paul Jackson
2005-03-03 23:39                 ` Alan Cox
2005-03-06 22:43                   ` Pavel Machek
2005-03-06 22:57                     ` Alan Cox
2005-03-03  2:13           ` Chris Wright
2005-03-03  1:15         ` YOSHIFUJI Hideaki / 吉藤英明
2005-03-03  1:23         ` David Lang
2005-03-03  2:14         ` Gene Heskett
2005-03-03  3:17           ` Andrew Morton
2005-03-03  4:51             ` Gene Heskett
2005-03-04  3:23           ` Andrew James Wade
2005-03-04  8:02             ` Jan Dittmer
2005-03-03  2:21         ` Jeff Garzik
2005-03-03  3:37           ` Linus Torvalds
2005-03-03  3:40             ` Jeff Garzik
2005-03-03  4:02               ` David S. Miller
2005-03-03  4:16                 ` Jeff Garzik
2005-03-03  4:46                   ` Jeff Garzik
2005-03-03  4:58                     ` David S. Miller
2005-03-03  5:08                       ` Russell Miller
2005-03-03  5:33                         ` David S. Miller
2005-03-03  7:52                       ` Jeff Garzik
2005-03-03  8:04                         ` Greg KH
2005-03-03  8:27                           ` Jeff Garzik
2005-03-03  8:58                             ` Greg KH
2005-03-03  9:14                               ` Jeff Garzik
2005-03-03  9:17                             ` Andrew Morton
2005-03-03  9:31                               ` Jeff Garzik
2005-03-03 16:23                             ` Linus Torvalds
2005-03-03 16:43                               ` Greg KH
2005-03-03 17:00                                 ` Theodore Ts'o
2005-03-03 17:06                                   ` Greg KH
2005-03-03 17:04                                 ` Eric Gaumer
2005-03-03 17:19                                   ` Greg KH
2005-03-03 16:55                               ` Chris Friesen
2005-03-03 16:59                                 ` Greg KH
2005-03-03 23:51                                   ` Alan Cox
2005-03-04  0:19                                     ` CaT
2005-03-04  0:44                                       ` Alan Cox
2005-03-04  1:44                                         ` IDE locking (was: Re: RFD: Kernel release numbering) CaT
2005-03-04  4:33                                           ` CaT
2005-03-04 10:48                                           ` Alan Cox
2005-03-03 17:50                                 ` RFD: Kernel release numbering Linus Torvalds
2005-03-03 16:55                               ` Chris Wright
2005-03-03 17:03                                 ` Jens Axboe
2005-03-03 17:07                                   ` Greg KH
2005-03-03 17:53                                   ` Linus Torvalds
2005-03-03 18:02                                     ` Chris Wright
2005-03-03 19:35                                     ` Sean
2005-03-03 20:27                                       ` Greg KH
2005-03-03 20:41                                       ` Linus Torvalds
2005-03-03 23:34                                       ` Kyle Moffett
2005-03-03 20:26                                 ` Krzysztof Halasa
2005-03-03 16:55                               ` Thomas Gleixner
2005-03-03 17:08                               ` Adrian Bunk
2005-03-03 17:12                                 ` Greg KH
2005-03-03 18:02                                   ` Linus Torvalds
2005-03-03 19:15                                 ` Thomas Gleixner
2005-03-03 19:37                                   ` Linus Torvalds
2005-03-03 19:52                                     ` Jeff Garzik
2005-03-03 20:04                                       ` David S. Miller
2005-03-03 20:19                                         ` Jeff Garzik
2005-03-03 20:34                                       ` Thomas Gleixner
2005-03-03 21:07                                         ` Jeff Garzik
2005-03-03 23:42                                           ` Gene Heskett
2005-03-04  9:43                                             ` Krzysztof Halasa
2005-03-03 19:58                                     ` Thomas Gleixner
2005-03-04  8:44                                     ` Rene Herman
2005-03-03 19:42                                   ` Jeff Garzik
2005-03-03 20:23                                     ` Thomas Gleixner
2005-03-03 17:52                               ` Daniel Barkalow
2005-03-03 18:09                                 ` Greg KH
2005-03-03 18:04                               ` Jeff Garzik
2005-03-03 18:11                                 ` Greg KH
2005-03-03 23:17                                   ` Andrew Morton
2005-03-03 23:45                                     ` Andrea Arcangeli
2005-03-04  0:03                                       ` Andrew Morton
2005-03-04  2:57                                         ` Jochen Striepe
2005-03-04  5:30                                           ` Andrew Morton
2005-03-04  5:50                                             ` Hua Zhong
2005-03-04  7:55                                             ` Jeff Garzik
2005-03-04  8:11                                               ` Andrew Morton
2005-03-04  8:21                                             ` Thomas Gleixner
2005-03-04  8:54                                               ` Andrew Morton
2005-03-04  9:16                                                 ` Jens Axboe
2005-03-04  9:21                                                   ` Andrew Morton
2005-03-04 17:57                                                     ` Linus Torvalds
2005-03-04 18:32                                                       ` Jeff Garzik
2005-03-04 19:07                                                         ` Steven Cole
2005-03-05  0:14                                                           ` Barry K. Nathan
2005-03-04 18:35                                                       ` William Park
2005-03-04 18:42                                                       ` Jeff Garzik
2005-03-04 18:55                                                       ` Nicolas Pitre
2005-03-04 20:28                                                         ` Linus Torvalds
2005-03-04 21:27                                                           ` Nicolas Pitre
2005-03-04 18:59                                                       ` Thomas Gleixner
2005-03-04 19:20                                                       ` Rene Herman
2005-03-04 20:37                                                         ` Linus Torvalds
2005-03-04 22:29                                                           ` Gene Heskett
2005-03-04 22:31                                                           ` Adrian Bunk
2005-03-06 12:57                                                           ` Pavel Machek
2005-03-04 21:48                                                         ` David Lang
2005-03-04  9:24                                                 ` Nick Piggin
2005-03-04  9:37                                                 ` Thomas Gleixner
2005-03-04 10:45                                                 ` David Greaves
2005-03-04  4:26                                         ` Lee Revell
2005-03-04  0:01                                     ` Alan Cox
2005-03-04  2:28                                       ` Andrew Morton
2005-03-04  2:56                                         ` Jeff Garzik
2005-03-04  3:04                                           ` Andrew Morton
2005-03-04  5:34                                           ` Andrew Morton
2005-03-04 10:59                                             ` Alan Cox
2005-03-04 10:56                                         ` Alan Cox
2005-03-04 11:28                                           ` Andrew Morton
2005-03-04 12:51                                             ` Alan Cox
2005-03-04 13:05                                               ` Andrew Morton
2005-03-04 18:18                                               ` Linus Torvalds
2005-03-04 18:27                                                 ` Linus Torvalds
2005-03-04 18:38                                                   ` Greg KH
2005-03-04 18:59                                                     ` Randy.Dunlap
2005-03-04 19:14                                                       ` Greg KH
2005-03-04 20:00                                                       ` Hua Zhong
2005-03-04 19:12                                                     ` Linus Torvalds
2005-03-04 19:21                                                       ` Greg KH
2005-03-04 19:54                                                         ` Jeff Garzik
2005-03-04 18:33                                                 ` Alan Cox
2005-03-04 18:50                                                 ` Charles Cazabon
2005-03-06  7:29                                                 ` Andres Salomon
2005-03-03 18:27                                 ` Linus Torvalds
2005-03-03 21:02                                   ` Steven Rostedt
2005-03-03 21:24                                     ` David Lang
2005-03-03 21:41                                       ` Steven Rostedt
2005-03-03 21:53                                         ` David Lang
2005-03-03 22:12                                           ` Steven Rostedt
2005-03-03 21:38                                     ` Stephen Hemminger
2005-03-03 22:00                                       ` Steven Rostedt
2005-03-03 18:42                               ` Hua Zhong
2005-03-03 19:11                                 ` Linus Torvalds
2005-03-03 21:56                                   ` Hua Zhong
2005-03-03 22:10                                     ` Jeff Garzik
2005-03-03 22:13                                     ` Linus Torvalds
2005-03-04 12:43                                   ` Paulo Marques
2005-03-05  6:50                               ` James Bourne
2005-03-08 21:56                               ` Bill Davidsen
2005-03-03  8:28                           ` Jes Sorensen
2005-03-03  8:53                             ` Greg KH
2005-03-03  9:06                               ` Dave Jones
2005-03-03  9:42                         ` Barry K. Nathan
2005-03-03  9:51                           ` Arjan van de Ven
2005-03-03 10:03                             ` Barry K. Nathan
2005-03-03 10:43                       ` Neil Brown
2005-03-03 17:46                         ` David Lang
2005-03-03 15:58                     ` Chris Friesen
2005-03-03  6:21                   ` Willy Tarreau
2005-03-03  9:06                   ` Andrew Morton
2005-03-03  4:05             ` YOSHIFUJI Hideaki / 吉藤英明
2005-03-03  4:21             ` Russell Miller
2005-03-03 11:40               ` Thomas Molina
2005-03-03  6:55             ` Hua Zhong
2005-03-03  9:12             ` Barry K. Nathan
2005-03-03  9:47             ` Rene Herman
2005-03-03 10:00               ` Jeff Garzik
2005-03-03 13:23                 ` Rene Herman
2005-03-05 10:13                   ` John Alvord
2005-03-05 10:49                     ` Rene Herman
2005-03-03 10:49             ` Anton Altaparmakov
2005-03-03 11:00               ` Jeff Garzik
2005-03-03 11:48                 ` Anton Altaparmakov
2005-03-03 17:59                   ` David S. Miller
2005-03-03 11:27             ` Martin Schlemmer
2005-03-03 16:00               ` Jochen Striepe
2005-03-03 13:13             ` Ed Tomlinson
2005-03-03 16:44             ` Horst von Brand
2005-03-03 16:59               ` Linus Torvalds
2005-03-03 19:20                 ` RFD: Kernel release numbering - an orthogonal solution David Greaves
2005-03-03 20:36                 ` RFD: Kernel release numbering Horst von Brand
2005-03-03 23:28                 ` Andrew Morton
2005-03-04  1:52                   ` Lee Revell
2005-03-13 11:11                   ` Jan Rychter
2005-03-03  2:32         ` Jeff Garzik
2005-03-03  3:03           ` Ben Greear
2005-03-03  4:05           ` David S. Miller
2005-03-03 15:08             ` Thomas Graf
2005-03-03  5:01           ` Valdis.Kletnieks
2005-03-03  1:23     ` Nick Piggin
2005-03-03  1:39       ` Hua Zhong
2005-03-03  1:56       ` Russell Miller
2005-03-02 23:52 ` Matt Mackall
2005-03-03 15:00   ` David Greaves
2005-03-04 23:34   ` Tim Bird
2005-03-03  0:06 ` Richard Purdie
2005-03-03  0:11 ` RFD: " Neil Brown
2005-03-03  0:48   ` Andrew Morton
2005-03-03  1:27     ` Neil Brown
2005-03-03  2:27       ` Jeff Garzik
2005-03-03  2:41       ` Andrew Morton
2005-03-03  0:17 ` Jeff Garzik [this message]
2005-03-03  1:04 ` Massimo Cetra
2005-03-03  1:34   ` Sven-Haegar Koch
2005-03-03  1:35   ` Ben Greear
2005-03-03 13:52   ` Jochen Striepe
2005-03-03 14:19     ` Massimo Cetra
2005-03-03  2:24 ` RFD: " Paul Jackson
2005-03-03  3:46 ` Ryan Anderson
2005-03-03  4:10 ` Chris Wedgwood
2005-03-03  9:14 ` Arjan van de Ven
2005-03-03 10:38 ` Bernhard Schauer
2005-03-03 11:22 ` Helge Hafting
2005-03-03 16:01 ` Barry K. Nathan
2005-03-03 17:37 ` Paul Dickson
2005-03-03 22:15 ` Alan Cox
2005-03-03 22:32   ` Jeff Garzik
2005-03-03 23:41     ` Andrea Arcangeli
2005-03-04  8:35       ` David Lang
2005-03-04  4:36 ` Clemens Schwaighofer
2005-03-04 14:29 ` Adam

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=422657B5.7030702@pobox.com \
    --to=jgarzik@pobox.com \
    --cc=akpm@osdl.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=torvalds@osdl.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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.