[open-ils-commits] [GIT] Evergreen ILS branch rel_2_2 updated. 4e093729f14085270072ee71d4c0d09b86cfcb52

[Evergreen Git]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Evergreen ILS".

The branch, rel_2_2 has been updated
       via  4e093729f14085270072ee71d4c0d09b86cfcb52 (commit)
      from  0ad1554bbe7883f39e4a764355ba32a180eb5aea (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 4e093729f14085270072ee71d4c0d09b86cfcb52
Author: Bradley M. Kuhn <bkuhn at ebb.org>
Date:   Sat Apr 28 09:39:12 2012 -0400

    Consensus was reached to remove editor-specific globs from .gitignore.
    
    In a highly overengineered discussion out of scope with the actual breadth
    of this very minor issue, everyone has come to the conclusion that
    editor-specific globs don't really belong in the project's .gitignore,
    given that git permits a global-level ignore file for users.
    
    Instead, a HACKING file is herein added, with its first entry to explain
    how developers can set the own global gitignore.
    
    Signed-off-by: Bradley M. Kuhn <bkuhn at ebb.org>
    Signed-off-by: Dan Scott <dan at coffeecode.net>

diff --git a/.gitignore b/.gitignore
index a530800..d9e24bf 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,3 @@
-# Hide temp files
-*.swp
-
 # Hide built objects
 *.[oa]
 *.la
@@ -328,3 +325,4 @@ Open-ILS/xul/staff_client/evergreen_staff_client.tar.bz2
 Open-ILS/xul/staff_client/xulrunner-3.6.25.en-US.linux-i686.tar.bz2
 Open-ILS/xul/staff_client/xulrunner/
 README.html
+HACKING.html
diff --git a/HACKING b/HACKING
new file mode 100644
index 0000000..f270c58
--- /dev/null
+++ b/HACKING
@@ -0,0 +1,67 @@
+HACKING File for Evergreen
+==========================
+:toc:
+:numbered:
+
+Contributing
+------------
+A
+http://evergreen-ils.org/dokuwiki/doku.php?id=contributing[tutorial for contributing to Evergreen is on the Evergreen Wiki].
+
+Git
+---
+
+The
+http://evergreen-ils.org/dokuwiki/doku.php?id=dev:git[Git workflow used by the project is documented on the Evergreen Wiki].
+
+Git Ignores
+~~~~~~~~~~~
+
+The +.gitignore+ file for the project level should only have files that
+are generated by the build or install processes of Evergreen itself.
+
+Often, users of various text editors may want to ignore the backup or
+autosave files.  Evergreen recommends putting this not in the project's
+.gitignore, but into the global ignore files for their git configuration.
+Below is how to do this for various editors.
+
+Creating A Global Git ignore file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+A useful tutorial on this issue can be found
+http://programblings.com/2008/10/22/git-global-ignores/[in this blog
+post].  The basic, command, however, is as follows:
+
+[source,bash]
+------------------------------------------------------------------------------
+git config --global core.excludesfile /path/to/my/global/gitignore
+------------------------------------------------------------------------------
+
+Many people like to use +~/.gitignore+ for +/path/to/my/global/gitignore+.
+
+Git Ignore Emacs Autosave/backup files
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+To ignore Emacs autosave/backup files, put the following lines in your
++/path/to/my/global/gitignore+ file.
+
+------------------------------------------------------------------------------
+*~
+\#*#
+------------------------------------------------------------------------------
+
+Note the need of a backslash before the pound sign above, which is needed
+since pound usually is a comment in a +gitignore+ file.
+
+Git Ignore Vim Autosave/backup files
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To ignore vim autosave files, put the following lines in your
++/path/to/my/global/gitignore+ file.
+------------------------------------------------------------------------------
+*.swp
+------------------------------------------------------------------------------
+
+Note that vim sometimes creates more files of similar names, so you may want this:
+
+------------------------------------------------------------------------------
+*.s[vw][a-z]
+------------------------------------------------------------------------------

-----------------------------------------------------------------------

Summary of changes:
 .gitignore |    4 +--
 HACKING    |   67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 68 insertions(+), 3 deletions(-)
 create mode 100644 HACKING


hooks/post-receive
-- 
Evergreen ILS