README 1.3 KB

1234567891011121314151617181920212223242526
  1. This is the 'contrib' directory of the GNU Automake distribution.
  2. Here you'll find additions to the Automake base distribution, in form of
  3. makefile fragments, m4 macros, scripts, documentation, et cetera. Such
  4. addition that might be useful for a significant percentage of its general
  5. audience, but (for one reason or another) are not deemed appropriate for
  6. inclusion into the Automake core.
  7. There are several reasons for which a feature can be kept in contrib:
  8. 1. The long-term usefulness of the feature is debatable and uncertain;
  9. on-field and real-word testing are necessary to prove or disprove
  10. its usefulness, before the feature can be committed into the Automake
  11. core (as doing so too early would later force us to continue the
  12. support for backward-compatibility, even if the features proves
  13. flawed or fails to attract widespread use).
  14. 2. The APIs or overall design of the feature are still unstable, and
  15. need on-field testing to iron warts and usability bugs, or uncover
  16. potential flaws.
  17. 3. The feature was an historical one, mostly obsoleted but still used
  18. "here and there" in the wild; so we want to to deprecate it and
  19. remove it from the Automake core, but cannot remove it altogether,
  20. for the sake of those still-existing usage. So it gets moved in
  21. contrib.