Add a project-related INSTALL file

git-svn-id: svn://svn.savannah.nongnu.org/avrdude/trunk/avrdude@1521 81a1dc3b-b13d-400b-aceb-764788c761c2

Author: dl8dtl

INSTALL

@@ -0,0 +1,57 @@
+Installation Instructions
+*************************
+
+Use `./configure; make all; sudo make install' for Unix-like systems.
+
+Depending on your requirements, the following prerequisites are
+needed:
+
+* libelf including header files (for directly reading ELF files)
+* libusb 0.1 or 1.0 (or compatible), including header files
+* libftdi or libftdi1 (for direct access to FTDI devices)
+* libhidapi or libhid (for access to recent Atmel/Microchip dongles)
+
+If the header and/or library files for one of those are found in
+non-default locations, you can add them to configure, e.g.
+
+`./configure CPPFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib'
+
+as an example for MacOS using Macports.  MacOS Brew requires
+
+`./configure CPPFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/Cellar'
+
+instead. (LDFLAGS and CPPFLAGS can also be supplied as environment
+variables to configure.)
+
+At the end of the configure script, a configuration summary is issued,
+like this:
+
+Configuration summary:
+----------------------
+DO HAVE    libelf
+DO HAVE    libusb
+DO HAVE    libusb_1_0
+DO HAVE    libftdi1
+DON'T HAVE libftdi
+DON'T HAVE libhid
+DO HAVE    libhidapi
+DO HAVE    pthread
+DISABLED   doc
+DISABLED   parport
+DISABLED   linuxgpio
+DISABLED   linuxspi
+
+Make sure all the features you are interested in have been found.
+
+For BSD-like systems, using GNU make (gmake) is not mandatory but
+appears to cause less troubles with the quite complex dependency graph
+that might be produced by autoconf/automake.
+
+For Windows, right now, a toolset like MinGW is required to compile
+AVRDUDE.
+
+Obviously, a working C compiler is needed. Tested compilers so far
+include GCC (in various versions) and Clang. The compiler needs to
+support (at least) C99 language level. For MacOS, either Xcode or the
+(smaller) Xcode Command Line tools are needed, for Windows, some port
+of GCC that supports generating native Windows executables.

NEWS

@@ -83,6 +83,7 @@ Current:
     bug #55462: wrong programmer id check in jtag3_getsync() and jtag3_close()
     bug #58994: VPP PWM still enabled at the end of programming process
     bug #57338: if safemode has to change fuses avrdude should exit with non-zero exit code
+    bug #60575: Permission denied on macOS Big Sur
 
   * Patches:
     patch #9482: Add support for UPDI and AVR8X