[PATCH 1/5] xserver: .gitignore: use common defaults with custom section #24239

[Gaetan Nadon]

I noticed the .gitignore files require frequent maintenance and are hard
to

read. The main cause is the long list of generated files that developers
shouldn't really have to get involved with. I scanned, merged and filtered
all.gitignore files and realized there was a common set of exclusion patterns.
I cross-referenced them with GNU tools docs to validate and complete the list.

The concept of the replacement .gitignore is a template with a default section
and a custom section.  The default section is all of the obscure generated
stuff about Autotools, compiler, linker, etc...  This section is not to be
edited by component developers. The custom section is where one can add files
to ignore that are component specific and known to the developers. One can also
override the default section in rare cases where a name clashing occur, a file
type is misused or a generated file is checked-in.

The template also applies by default to all subdirectories. Additional
.gitignore files can be created in subdirectories for the same add and override
operations. This leaves the top level file cleaner, not having to list stuff
for the subdirectories which is commonly done now. Out of 268 components, 145
are happy with just the template and no customization. The rest have a 1 to 3
lines of custom patterns. The xserver top level file has 4 lines in the custom
section and only 27 .gitignore files in subdirectories with an average of 3
lines.


For xserver, there would be less merge conflict on the top
level .gitignore. Areas that could have been missed are those areas that
aren't built as part of the normal build process (manually invoked build
if any).

The patch is too big for the mailing list. The default section can be
seen at http://cgit.freedesktop.org/xorg/util/macros/tree/.gitignore.

 .gitignore                         |  206
++++++++++++------------------------
 dix/.gitignore                     |    3 +
 doc/.gitignore                     |    4 +-
 hw/dmx/.gitignore                  |    4 +-
 hw/dmx/config/.gitignore           |   13 ++-
 hw/dmx/doc/.gitignore              |    2 +
 hw/dmx/examples/.gitignore         |   17 +++
 hw/kdrive/ephyr/.gitignore         |    2 +
 hw/kdrive/fake/.gitignore          |    2 +
 hw/kdrive/fbdev/.gitignore         |    2 +
 hw/kdrive/sdl/.gitignore           |    2 +
 hw/vfb/.gitignore                  |    5 +-
 hw/xfree86/.gitignore              |    7 ++
 hw/xfree86/common/.gitignore       |    3 +
 hw/xfree86/doc/man/.gitignore      |    8 +-
 hw/xfree86/exa/.gitignore          |    2 +
 hw/xfree86/fbdevhw/.gitignore      |    4 +-
 hw/xfree86/loader/.gitignore       |    3 +
 hw/xfree86/os-support/.gitignore   |    2 +
 hw/xfree86/ramdac/.gitignore       |    2 +
 hw/xfree86/utils/cvt/.gitignore    |    3 +
 hw/xfree86/utils/gtf/.gitignore    |    5 +-
 hw/xfree86/xaa/.gitignore          |    4 +
 hw/xnest/.gitignore                |    5 +-
 hw/xquartz/mach-startup/.gitignore |    8 ++
 hw/xwin/.gitignore                 |    5 +
 include/.gitignore                 |    5 +
 os/.gitignore                      |    2 +
 test/.gitignore                    |    2 +
 29 files changed, 170 insertions(+), 162 deletions(-)
 create mode 100644 dix/.gitignore
 create mode 100644 hw/dmx/doc/.gitignore
 create mode 100644 hw/dmx/examples/.gitignore
 create mode 100644 hw/kdrive/ephyr/.gitignore
 create mode 100644 hw/kdrive/fake/.gitignore
 create mode 100644 hw/kdrive/fbdev/.gitignore
 create mode 100644 hw/kdrive/sdl/.gitignore
 create mode 100644 hw/xfree86/.gitignore
 create mode 100644 hw/xfree86/common/.gitignore
 create mode 100644 hw/xfree86/exa/.gitignore
 create mode 100644 hw/xfree86/loader/.gitignore
 create mode 100644 hw/xfree86/os-support/.gitignore
 create mode 100644 hw/xfree86/ramdac/.gitignore
 create mode 100644 hw/xfree86/utils/cvt/.gitignore
 create mode 100644 hw/xfree86/xaa/.gitignore
 create mode 100644 hw/xquartz/mach-startup/.gitignore
 create mode 100644 hw/xwin/.gitignore
 create mode 100644 include/.gitignore
 create mode 100644 os/.gitignore
 create mode 100644 test/.gitignore


-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.x.org/archives/xorg-devel/attachments/20091110/93075f3f/attachment.htm