Multiple index entries

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

  > >> 3 matches for "Package from Source" in buffer: *info*
  > >>    1511:* package development source:            Package from Source.
  > >>    1515:* package git source:                    Package from Source.
  > >>    1525:* package upstream source:               Package from Source.

The first two are so close that they are redundant; it is better to
have just one of them.  I think "development" is the more important of
the two.

The third one is 10 lines away.  Maybe that is far enough not to be
redundant.  It is a judgment call.

  > 3 matches for "Package from Source" in buffer: *info*
  >     800:* git source of package:                 Package from Source.
  >    1513:* package development source:            Package from Source.
  >    2083:* upstream source, for packages:         Package from Source.

Rotating the words in an index entry makes another index entry
which normally would appear far away in the index.
It can be useful to index multiple rotations of the same expression.

For instance, "development source, of package" might be useful in
addition to "package development source".  "Upstream source, of
package" might be useful in addition to "package upstream source".

Each of them is useful to have in the index if more than a few users
will look for the term that way in the index, and it isn't redundant
with other index entries that would be close by.

Back when I readied the Emacs Manual for publication in each version,
I used to check the whole concept index for various blemishes,
and redundant index entries was one of them.

-- 
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)