|author||Joel Sherrill <joel.sherrill@OARcorp.com>||1999-05-14 15:15:57 +0000|
|committer||Joel Sherrill <joel.sherrill@OARcorp.com>||1999-05-14 15:15:57 +0000|
Diffstat (limited to 'doc')
1 files changed, 47 insertions, 0 deletions
diff --git a/doc/FAQ/tools.t b/doc/FAQ/tools.t
new file mode 100644
@@ -0,0 +1,47 @@
+@c COPYRIGHT (c) 1988-1998.
+@c On-Line Applications Research Corporation (OAR).
+@c All rights reserved.
+@chapter General Development Tool Hints
+The questions in this category are related to the GNU development tools
+in a non-language specific way.
+@section How do I generate a patch?
+The RTEMS patches to the development tools are generated using a
+command like this
+diff -N -P -r -c TOOL-original-image TOOL-with-changes >PATCHFILE
+where the options are:
+@item -N and -P take care of adding and removing files (be careful not to
+>include junk files like file.mybackup)
+@item -r tells diff to recurse through subdirectories
+@item -c is a context diff (easy to read for humans)
+Please look at the generated PATCHFILE and make sure it does not
+contain anything you did not intend to send to the maintainers.
+It is easy to accidentally leave a backup file in the modified
+source tree or have a spurious change that should not be
+in the PATCHFILE.
+If you end up with the entire contents of a file in the patch
+and can't figure out why, you may have different CR/LF scheme
+in the two source files. The GNU open-source packages usually have
+UNIX style CR/LF. If you edit on a Windows platform, the line
+terminators may have been transformed by the editor into Windows