[avrdude-dev] To all committers: some stylistic things

[Joerg Wunsch]

Thanks to everybody for improving the AVRDUDE code base.  I see
there were a number of commits within the past months.

I'm not very religious about stylistic issues.  After all, I basically
"inherited" the maintenance of that project from Brian Dean, and a lot
of the code present in AVRDUDE today has been contributed by a large
number of people in the past, so the overall style is not very
uniform.  Just a few things I'm asking for.

. For new files, please take care to have at least the svn:eol-style
  set to "native", and svn:keywords to (at least) "Id".  Add $Id$
  lines to each file so the file's version can be tracked "in the
  field".  Preferrably, do also set svn:mime-type (usually to
  text/plain).  The easiest way to do this is to activate the line

enable-auto-props = yes

  in your ~/.subversion/config file (or wherever this file lives in
  your environment), and add suitable auto-props patterns.  For
  reference, I'm appending the patterns I've been collecting in my SVN
  era so far below.

. If possible, avoid non-ASCII characters (there have been a few UTF-8
  long dashes in some file, where simple ASCII dashes would do fine).

. When using hard TABs, the remainder of the AVRDUDE code uses them
  with a tab stop each 8 columns, as is the historical DEC VTxx (and
  Unix) standard.  If you don't like this, then better don't use TABs
  but simple spaces everywhere.

. Try avoiding trailing white space behind the printable characters of
  each line (even though the historic AVRDUDE code suffers a lot from
  that still, and I hesitate to force commits for code that has
  otherwise not been touched sometimes for years).

Thanks again for all your contributions!

[auto-props]
Makefile* = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author 
Id Date"
*.1 = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.a = svn:mime-type=application/octet-stream
*.am = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.aps = svn:mime-type=text/plain;svn:eol-style=CRLF;svn:keywords="Author Id 
Date"
*.asm = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.bat = svn:mime-type=text/plain;svn:eol-style=CRLF;svn:keywords="Author Id 
Date"
*.bpl = svn:mime-type=application/octet-stream
*.c = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.cdr = svn:mime-type=application/octet-stream
*.cfg = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.cmake = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.cpp = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.css = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.csv = svn:mime-type=text/csv;svn:eol-style=native
*.cvsignore = 
svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id Date"
*.ddp = svn:mime-type=application/octet-stream
*.de = svn:mime-type=application/octet-stream
*.dep = svn:mime-type=application/xml
*.dfm = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.diff = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.dll = svn:mime-type=application/octet-stream
*.doc = svn:mime-type=application/msword
*.dot = svn:mime-type=application/msword
*.dox = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.gif = svn:mime-type=image/gif
*.eps = 
svn:mime-type=application/postscript;svn:eol-style=native;svn:keywords="Author 
Id Date"
*.ewd = svn:mime-type=application/xml
*.ewp = svn:mime-type=application/xml
*.eww = svn:mime-type=application/xml
*.exe = svn:mime-type=application/octet-stream
*.gz = svn:mime-type=application/octet-stream
*.h = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.hex = svn:mime-type=text/plain;svn:eol-style=CRLF
*.html = svn:mime-type=text/html;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.i = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.in = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.inc = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.info = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.jpg = svn:mime-type=image/jpeg
*.js = svn:mime-type=text/javascript;svn:eol-style=native;svn:keywords="Author 
Id Date"
*.kdevelop = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords="Author 
Id Date"
*.l = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.local = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.mk = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.mpp = svn:mime-type=application/vnd.ms-project
*.odg = svn:mime-type=application/octet-stream
*.odp = svn:mime-type=application/octet-stream
*.patch = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.pdf = svn:mime-type=application/pdf
*.pl = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.png = svn:mime-type=image/png
*.ppt = svn:mime-type=application/vnd.ms-powerpoint
*.py = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.s = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.scons = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.sh = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date";svn:executable
*.sty = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.sxc = svn:mime-type=application/octet-stream
*.sxw = svn:mime-type=application/octet-stream
*.tc = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.tex = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.ts = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.txt = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.ui = svn:mime-type=application/xml
*.vdx = svn:mime-type=application/xml
*.vsd = svn:mime-type=application/visio
*.vsx = svn:mime-type=application/xml
*.wmf = svn:mime-type=application/octet-stream
*.wxg = svn:mime-type=application/xml
*.xcl = svn:mime-type=text/plain;svn:eol-style=CRLF;svn:keywords="Author Id 
Date"
*.xls = svn:mime-type=application/vnd.ms-excel
*.xml = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.xsd = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.xsl = svn:mime-type=text/xml;svn:eol-style=native;svn:keywords="Author Id 
Date"
*.y = svn:mime-type=text/plain;svn:eol-style=native;svn:keywords="Author Id 
Date"

-- 
cheers, J"org               .-.-.   --... ...--   -.. .  DL8DTL

http://www.sax.de/~joerg/                        NIC: JW11-RIPE
Never trust an operating system you don't have sources for. ;-)