glossary: expand and clarify some definitions, prune cross-references
authorJ. Bruce Fields <bfields@citi.umich.edu>
Sun, 13 May 2007 02:17:03 +0000 (22:17 -0400)
committerJ. Bruce Fields <bfields@citi.umich.edu>
Fri, 18 May 2007 01:03:59 +0000 (21:03 -0400)
commit343cad921780be8eb55e10933c73bb5e04d2e0f2
tree009942a0b85df88e06b378663236739cd518d92f
parenta5fc33b4937fb6f38918710be6f23ef925630a8a
glossary: expand and clarify some definitions, prune cross-references

Revise and expand some of the definitions in the glossary, based in part
on a recent thread started by a user looking for help with some of the
jargon.  I've borrowed some of the language from Linus's email on that
thread.  (I'm assuming standing permission to plagiarize Linus's
email....)

Also start making a few changes to mitigate the appearance of
"circularity" mentioned in that thread:
- feel free to use somewhat longer definitions and to explain
  some things more than once instead of relying purely on
  cross-references
- don't use cross-references when they're redundant: eliminate
  self-references and repeated references to the same entry.

Cc: Linus Torvalds <torvalds@linux-foundation.org>
Signed-off-by: "J. Bruce Fields" <bfields@citi.umich.edu>
Documentation/glossary.txt