From 68e13ba04b5329676dd28673129b5d5d6b1d1940 Mon Sep 17 00:00:00 2001
From: Sam Liddicott <sam@mojojojo.(none)>
Date: Sat, 19 Sep 2009 11:04:12 +0100
Subject: [PATCH] Improve introduction

---
 newfangle.lyx | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 62 insertions(+), 3 deletions(-)

diff --git a/newfangle.lyx b/newfangle.lyx
index b0a5697..0689c8a 100644
--- a/newfangle.lyx
+++ b/newfangle.lyx
@@ -85,14 +85,73 @@ Introduction
 \end_layout
 
 \begin_layout Standard
-Newfangle is an awk replacement for notangle, adding some important features,
- like better integration with LyX and LaTeX, multiple output format conversions,
- and fixing notangle bugs like -L and indenting.
+Newfangle is a tool for newfangled literate programming.
+ Newfangled is defined as 
+\emph on
+New and often needlessly novel
+\emph default
+ by 
+\noun on
+TheFreeDictionary.com
+\noun default
+.
+\end_layout
+
+\begin_layout Standard
+
+\noun on
+Literate Programming
+\noun default
+ has a long history featuring such distinctive figures as the great 
+\noun on
+Donald Knuth
+\noun default
+ whose literate programming tools seem to make use of as many escaped abbreviati
+ons for semantic markup as TeX itself.
+\end_layout
+
+\begin_layout Standard
+
+\noun on
+Norman Ramsey
+\noun default
+ wrote the notangle set of tools which fortunately reduced the amount of
+ magic characters to one, an eminently manageable quanity, and in doing
+ so inadvertantly brought the wonders of literate programming within my
+ reach.
+\end_layout
+
+\begin_layout Standard
+Using LyX for LaTeX editing, I had various troubles with the no-tangle tools,
+ some of which were my fault, some of which were notangles fault (or noweave)
+ and some of which were LyX's fault.
+\end_layout
+
+\begin_layout Standard
+Notangle generally brought literate programming to the masses through removing
+ some of the complexity of the original literate programming, but this would
+ be of no advantage to me if the LyX --- LaTeX combination brings more complicat
+ions in their place.
+\end_layout
+
+\begin_layout Standard
+Newfangle was thus born --- as an awk replacement for notangle, adding some
+ important features, like better integration with LyX and LaTeX, multiple
+ output format conversions, and fixing notangle bugs like -L and indenting.
+\end_layout
+
+\begin_layout Standard
+Significantly, newfangle has one program which replaces various programs
+ in notangle.
+ Specifically noweave is done away with and implemented directly as LaTeX
+ macros.
 \end_layout
 
 \begin_layout Standard
 Newfangle is written in awk for portability reasons, awk being available
  for most platforms.
+ A python conversion will probably be attempted for the benefit of LyX.
+ (Hasn't anyone implemented awk in python yet?)
 \end_layout
 
 \begin_layout Standard
-- 
2.11.4.GIT