From 4f673191c5c43665599392b00c3710d0344d65e3 Mon Sep 17 00:00:00 2001
From: Neil <nyamatongwe@gmail.com>
Date: Fri, 5 Apr 2019 11:56:10 +1100
Subject: Document adding source files.

---
 doc/AddSource.txt     | 30 ++++++++++++++++++++++++++++++
 doc/ScintillaDoc.html |  3 +++
 2 files changed, 33 insertions(+)
 create mode 100644 doc/AddSource.txt

diff --git a/doc/AddSource.txt b/doc/AddSource.txt
new file mode 100644
index 000000000..777f6f2c4
--- /dev/null
+++ b/doc/AddSource.txt
@@ -0,0 +1,30 @@
+Some of the build files adapt to adding and removing source code files but most
+must be modified by hand. Here is a list of directories and the build files that
+must be modified or possibly need to be modified.
+The Cocoa project.pbxproj file is complex and should be modified with Xcode.
+The other build files can be edited manually.
+
+src:
+	cocoa/ScintillaFramework/ScintillaFramework.xcodeproj/project.pbxproj
+	gtk/makefile
+	qt/ScintillaEdit/ScintillaEdit.pro
+	qt/ScintillaEditBase/ScintillaEditBase.pro
+	win32/makefile
+	win32/scintilla.mak
+	-- possibly:
+	test/unit/makefile
+	test/unit/test.mak
+
+cocoa:
+	cocoa/ScintillaFramework/ScintillaFramework.xcodeproj/project.pbxproj
+
+gtk:
+	gtk/makefile
+
+qt:
+	qt/ScintillaEdit/ScintillaEdit.pro
+	qt/ScintillaEditBase/ScintillaEditBase.pro
+
+win32:
+	win32/makefile
+	win32/scintilla.mak
diff --git a/doc/ScintillaDoc.html b/doc/ScintillaDoc.html
index ddebc65a9..a87294d6e 100644
--- a/doc/ScintillaDoc.html
+++ b/doc/ScintillaDoc.html
@@ -8444,6 +8444,9 @@ EM_SETTARGETDEVICE
     When both GTK+ 2 and GTK+ 3 are present, building for GTK+ 3.x requires defining GTK3
     on the command line.</p>
 
+    <p>Adding and removing source files from Scintilla may require modifying build files.
+    This is addressed in <a class="jump" href="AddSource.txt">AddSource.txt</a>.</p>
+
     <h3>Static linking</h3>
 
     <p>On Windows, Scintilla is normally used as a dynamic library as a .DLL file. If you want to
-- 
cgit v1.2.3