new file to explain how the code examples should be extracted from the

Tue Jun 23 12:12:19 BST 1998  Tony Gale  <gale@gtk.org>

        * examples/README.1ST: new file to explain how the
          code examples should be extracted from the tutorial.

8 files changed, 76 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index 7716519f74..751d04b609 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Tue Jun 23 12:12:19 BST 1998  Tony Gale  <gale@gtk.org>
+
+	* examples/README.1ST: new file to explain how the
+	  code examples should be extracted from the tutorial.
+
 Mon Jun 22 18:43:11 1998  Lars Hamann  <lars@gtk.org>
 
 	* gtk/gtkctree.c (draw_row): added new "line style"
diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0
index 7716519f74..751d04b609 100644
--- a/ChangeLog.pre-2-0
+++ b/ChangeLog.pre-2-0
@@ -1,3 +1,8 @@
+Tue Jun 23 12:12:19 BST 1998  Tony Gale  <gale@gtk.org>
+
+	* examples/README.1ST: new file to explain how the
+	  code examples should be extracted from the tutorial.
+
 Mon Jun 22 18:43:11 1998  Lars Hamann  <lars@gtk.org>
 
 	* gtk/gtkctree.c (draw_row): added new "line style"
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 7716519f74..751d04b609 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,8 @@
+Tue Jun 23 12:12:19 BST 1998  Tony Gale  <gale@gtk.org>
+
+	* examples/README.1ST: new file to explain how the
+	  code examples should be extracted from the tutorial.
+
 Mon Jun 22 18:43:11 1998  Lars Hamann  <lars@gtk.org>
 
 	* gtk/gtkctree.c (draw_row): added new "line style"
diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2
index 7716519f74..751d04b609 100644
--- a/ChangeLog.pre-2-2
+++ b/ChangeLog.pre-2-2
@@ -1,3 +1,8 @@
+Tue Jun 23 12:12:19 BST 1998  Tony Gale  <gale@gtk.org>
+
+	* examples/README.1ST: new file to explain how the
+	  code examples should be extracted from the tutorial.
+
 Mon Jun 22 18:43:11 1998  Lars Hamann  <lars@gtk.org>
 
 	* gtk/gtkctree.c (draw_row): added new "line style"
diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index 7716519f74..751d04b609 100644
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,8 @@
+Tue Jun 23 12:12:19 BST 1998  Tony Gale  <gale@gtk.org>
+
+	* examples/README.1ST: new file to explain how the
+	  code examples should be extracted from the tutorial.
+
 Mon Jun 22 18:43:11 1998  Lars Hamann  <lars@gtk.org>
 
 	* gtk/gtkctree.c (draw_row): added new "line style"
diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index 7716519f74..751d04b609 100644
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,8 @@
+Tue Jun 23 12:12:19 BST 1998  Tony Gale  <gale@gtk.org>
+
+	* examples/README.1ST: new file to explain how the
+	  code examples should be extracted from the tutorial.
+
 Mon Jun 22 18:43:11 1998  Lars Hamann  <lars@gtk.org>
 
 	* gtk/gtkctree.c (draw_row): added new "line style"
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 7716519f74..751d04b609 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,8 @@
+Tue Jun 23 12:12:19 BST 1998  Tony Gale  <gale@gtk.org>
+
+	* examples/README.1ST: new file to explain how the
+	  code examples should be extracted from the tutorial.
+
 Mon Jun 22 18:43:11 1998  Lars Hamann  <lars@gtk.org>
 
 	* gtk/gtkctree.c (draw_row): added new "line style"
diff --git a/examples/README.1ST b/examples/README.1ST
new file mode 100644
index 0000000000..f66a60ab08
--- /dev/null
+++ b/examples/README.1ST
@@ -0,0 +1,41 @@
+GTK Example Code - Tony Gale <gale@gtk.org> 980623
+--------------------------------------------------
+
+I have written an awk script to automatically extract the code
+examples from the GTK Tutorial (in sgml), so they only have to be
+changed in one place.
+
+It's called 'extract.awk', and there is a shell wrapper to invoke
+it called 'extract.sh'
+
+It takes the following switches:
+ -c : Just do checking rather than output files
+ -f <filename> : Extract a specific file
+ -d : Extract file(s) to current directory
+
+Without the -d switch, the code will be placed in the appropriate
+sub-directory. Those sub-directories will be created if they do not
+exist.
+
+Without the -f switch, all code examples will be extracted.
+
+The shell wrapper assumes that the GTK Tutorial is in the 
+file "../docs/gtk_tut.sgml"
+
+It works by looking for sections of text in the tutorial surrounded
+by, for example:
+
+/* example-start helloworld helloworld.c */
+
+and
+
+/* example-end */
+
+Where "helloworld" is the directory into which the file will be
+placed (which can also be a directory spec like hello/hello1), and
+"helloworld.c" is the file name for the code.
+
+So, the code between these lines would be extracted to the file
+helloworld/helloworld.c
+
+It also handles replacing the sgml tag '&amp;' with '&'