[mgp-users 00799] English corrections for MagicPoint 1.0.9a

["Eric S. Raymond" <esr@thyrsus.com>]

I recently found MagicPoint useful for a presentation I did at LinuxWorld.
As a way of expressing my gratitude, I have gone through the source
code and fixed the English in it.

You can see the presentation at <http://www.tuxedo.org/~esr/writings/dragnet/>.

--- FAQ	2002/02/05 03:26:29	1.1
+++ FAQ	2002/02/05 03:30:31
@@ -10,26 +10,25 @@
    "ghostscript" dies with "WARN: cannot generate pnmraw+ file from
    test.eps".
 
-A: Install more recent version of "ghostscript", which supports
+A: Install a more recent version of "ghostscript", which supports
    "pnmraw" output driver.
 
-A: Give the -X option to "mgp", with name of "ghostscript" output
+A: Give the -X option to "mgp", with the name of the "ghostscript" output
    driver which is configured into your "ghostscript".
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-Q: Background image will not be reflected to postscript output from
-   "mgp2ps".
+Q: Background image is npt reflected in postscript output from "mgp2ps".
 
 A: This is a feature (or known bug).
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-Q: I'm using European language for presentations and line-breaks are
+Q: I'm using European language for presentations, and line-breaks are
    not correct.
 
-Q: I'm using European language for presentations and accented
+Q: I'm using European language for presentations, and accented
    characters will not be generated on postscript output.
 
 A: See README.lang for detail.
@@ -44,26 +43,26 @@
 
 Q: I'm trouble finding scalable fonts.
 
-Q: Presentations using X11 font looks awful.
+Q: Presentations using X11 fonts look awful.
 
 A: See README.fonts for detail.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 Q: I have special Adobe type 1 font installed to my X11 configuration,
-   and I cannot use that font with postscript output.
+   but I cannot use that font with postscript output.
 
-A: (1) Modify print.c to include the font into fontname mapping table,
-   (2) Regenerate postscript file,
+A: (1) Modify print.c to include the font into the fontname mapping table,
+   (2) Regenerate your postscript file,
    (3) Download your font to your printer,
    (4) Try printing the file.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-Q: Compilation with png library fails.
+Q: Compilation with the PNG library fails.
 
-A: Check the version number of your png library.  in most cases, the
-   library you are using is too old.  note that, some of Linux rpms
+A: Check the version number of your PNG library.  Usually this means the
+   library you are using is too old.  Note that some Linux RPMs
    uses different version numbering scheme from the original png
    library.
 
@@ -71,11 +70,11 @@
 
 Q: %system or %xsystem does not work.
 
-Q: If i use %system or %xsystem, X server (or window manager) dies.
+Q: When I use %system or %xsystem, X server (or window manager) dies.
 
-A: The behavior of %system/xsystem command heavily depends on the
+A: The behavior of %system/xsystem command depends heavily on the
    behavior of your window manager, and they may not work right for
-   some of those.  as there are so many window managers, we have
+   some of those.  As there are so many window managers, we have
    trouble supporting them.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -88,15 +87,14 @@
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-Q: Can I convert my animation gif files into mng format?
+Q: Can I convert my animation GIF files into MNG format?
 
-A: Yes. I would like to recommand you to use the convert command in
-   ImageMagick. See http://www.simplesystems.org/ImageMagick/ for more
-   information.
+A: Yes, just use the convert command in the ImageMagick suite. 
+   See http://www.simplesystems.org/ImageMagick/ for more information.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-Q: Can I write Magicpoint presentation with an XML based language?
+Q: Can I write Magicpoint presentations with an XML based language?
 
 A: The sdoc2mgp.xsl can convert an XML based language into mgp syntax.
    See
--- README	2002/02/05 03:43:26	1.1
+++ README	2002/02/05 03:44:58
@@ -14,10 +14,10 @@
 
 This is one of the alpha releases of MagicPoint.  We're planing to add
 a version control mechanism of .mgp file for forward compatibly.  But
-currently, such a mechanism is missing. Please use this package at
+currently, such a mechanism is missing.  You use this package at
 your own risk.
 
-MagicPoint is completely free but absolutely no warranty. For more
+MagicPoint is completely free but has absolutely no warranty. For more
 information, please refer to COPYRIGHT or COPYRIGHT.jp.  Please note
 that some of the source codes is derived from other people's works,
 and may have different distribution policies.  Be sure to check the
@@ -30,16 +30,16 @@
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-Since MagicPoint extensively uses fonts in various sizes, we recommend
+Since MagicPoint uses fonts in various sizes extensively, we recommend
 you to install good font rendering systems in your system.  
 
-THIS DOCUMENT ASSUMES THAT YOU WILL USE MAGICPOINT WITH **TRUETYPE**
+THIS DOCUMENT ASSUMES THAT YOU ARE USING MAGICPOINT WITH **TRUETYPE**
 FONTS. YOU SHOULD INSTALL *FREETYPE* BEFORE YOU INSTALL MAGICPOINT.
 
 To install "libttf.a", see:
 	http://www.freetype.org/
 
- If you want to use other rendering systems, read "README.fonts" or
+If you want to use other rendering systems, read "README.fonts" or
 "README.fonts.jp".
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -81,17 +81,17 @@
 information, see "sample/README" or "sample/README.jp", which
 describes how to install TrueType fonts.
 
-To visualize the sample{,-jp}.mgp file, type:
+To display the sample{,-jp}.mgp file, type:
 
 	% ./mgp sample/sample.mgp
 	% ./mgp sample/sample-jp.mgp
 
-To visualize the tutorial{,-jp}.mgp file, type:
+To display the tutorial{,-jp}.mgp file, type:
 
 	% ./mgp sample/tutorial.mgp
 	% ./mgp sample/tutorial-jp.mgp
 
-WE STRONGLY RECOMMEND TO BUY TRUETYPE FONTS IF YOU WANT TO GIVE YOUR
+WE STRONGLY RECOMMEND BUYING TRUETYPE FONTS IF YOU WANT TO GIVE YOUR
 PRESENTATION WITH BEAUTIFUL FONTS.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
--- README.fonts	2002/02/05 03:45:30	1.1
+++ README.fonts	2002/02/05 03:46:27
@@ -79,10 +79,10 @@
 
 	./configure --disable-vflib
 
-English fonts will become scalable as well, however, this method is
-not very suitable for western readers since this approach usually uses
+English fonts will become scalable as well,  However, this method is
+not very suitable for Western readers since this approach usually uses
 Japanese font files.  The Japanese font files include several thousand
-of letters and will occupies several megabytes on your disk.
+glyphs and will occupy several megabytes on your disk.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
--- README.lang	2002/02/05 03:46:43	1.1
+++ README.lang	2002/02/05 03:46:57
@@ -6,7 +6,7 @@
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-MagicPoint has no idea about what kind of character set you are using
+MagicPoint has no idea what kind of character set you are using
 with your presentation file, or what kind of language you are using.
 For example, if you use Latin-1 (iso-8859-1) you MUST tell that explicitly
 to MagicPoint.
@@ -20,7 +20,7 @@
 "iso2022-jp", or "euc-jp"
 
 
-Making MagicPoint presentations in European languages
+Making MagicPoint presentations in European languages:
 - Use "/configure  --enable-locale" before compilation.
   In some operating systems you may need -lxpg4 with this.
 	(so that ctype functions, such as isprint(), works with 
--- RELNOTES	2002/02/05 03:47:22	1.1
+++ RELNOTES	2002/02/05 03:47:41
@@ -15,7 +15,7 @@
 
 Bugs fixed:
 	- Security fix:
-		fix a seculity hole inherited from xloadimage.
+		fix a security hole inherited from xloadimage.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 <<<1.08a>>>
@@ -36,7 +36,7 @@
 
 New features:
 	- PNG support
-	- Adding a dither algorithm to the gradation mechanism
+	- Adding a dither algorithm to the gradation mechanism.
 	- Pre-drawing
 		(Pages which contain text only is cached before
 		displayed.)
--- SYNTAX	2002/02/05 04:04:29	1.1
+++ SYNTAX	2002/02/05 04:08:42
@@ -1,6 +1,6 @@
 $Id: SYNTAX,v 1.1 2002/02/05 04:04:29 esr Exp esr $
 
-placement restriction for directives:
+Placement restriction for directives:
 		.mgprc		preamble	main pages
 		---		---		---
 %vfcap		okay		x		okay
@@ -50,7 +50,7 @@
 	Left justify.
 
 %leftfill
-	Left justify, with folding long line.
+	Left justify, folding long lines.
 
 %center
 	Centering.
@@ -71,7 +71,7 @@
 	Draw without line break.
 
 %nodefault
-	Disable effect of default directive.
+	Disable effect of default directives.
 
 %xfont "font"
 %xfont "font" "registry"
@@ -115,7 +115,7 @@
 		iso8859-2
 		iso8859-3
 		iso8859-4
-	It would be nice if we can support "adobe-specific" for symbols,
+	It would be nice if we could support "adobe-specific" for symbols,
 	however, we have no escape sequence to designate the it...
 
 %vfont "font"
@@ -193,15 +193,15 @@
 	tab-indented line.
 
 %prefix <percentage>
-	specify prefix spacing by <percentage> of the drawing area width.
+	Specify prefix spacing by <percentage> of the drawing area width.
 
 	The effect of %prefix command in %tab command is local to
 	tab-indented line.
 
 %icon <arc|box|delta1|delta2|delta3|delta4|dia> <color> <size>
 %icon <imagefile> <color> <size>
-	add an icon for itemizing lines.
-	for example,
+	Add an icon for itemizing lines.
+	For example,
 		%tab 1 size 5, icon box green 50
 	gives you an green box on the leftmost column of line.
 	size is the percentage against the current character size.
@@ -214,7 +214,7 @@
 			display, zoomrate is calculated automagically.
 
 %default <linenum> <list-of-directives>
-	Unless nodefault directive is specified, the directives in the
+	Unless the nodefault directive is specified, the directives in the
 	argument is prepended to the directives of the linenum'th line
 	in every page. The syntax of <list-of-directives> is a comma
 	separated directives.
@@ -245,21 +245,21 @@
 	because fonts are proportional (horizontal size varies by code point).
 
 %pause
-	Stop drawing until forward key or button is pressed
+	Stop drawing until a forward key or button is pressed
 
 %mark
 	Mark the current position on the screen, so that we can come back
 	later by %again.
-	NOTE: mark is local to a page.  mark will be cleared at the page
+	NOTE: mark is local to a page.  The mark will be cleared at the page
 	boundary.
 
 %again
 	Move current position to the location marked by %mark.
 
 %system "command"
-	Fork&exec the specified program.
+	Fork and exec the specified program.
 	NOTE: the program will be invoked every time the page is redrawn.
-	It sometimes annoy you.  it needs some rework.
+	This may sometimes annoy you.  It needs some work.
 
 	Special translation for presentation-window-relative geometry:
 		Argument that starts with "%" will be translated as if
@@ -274,7 +274,7 @@
 	Process will be killed when you leave the page.
 
 %system "command" <page>
-	Almost same as above.
+	Almost the same as above.
 	Process will be killed when you leave the specified <page>.
 	If you set <page> to -1, the process will be killed when MagicPoint
 	is terminated. (of course, you can terminate the child process alone
@@ -283,7 +283,7 @@
 %filter "command"
 TEXT
 %endfilter
-	Fork&exec the specified program, feed TEXT into that process
+	Fork and exec the specified program, feed TEXT into that process
 	from standard input.  use the standard output from the process
 	as presentation input.
 	Do not forget to place %endfilter.
@@ -292,7 +292,7 @@
 	Do not use commas.
 
 %vfcap "filename"
-	Specifies VFlib configuration filename.
+	Specifies the VFlib configuration filename.
 	(allowed in ~/.mgprc, without "%" sign)
 
 %tfdir "dir"
@@ -306,7 +306,7 @@
 	For example, you may want to define a typewriter-like font as:
 		%deffont "typewriter" xfont "courier", tfont "cour.ttf"
 	By using the above definition, you can make your presentation file
-	less dependent to the configuration of magicpoint binary.
+	less dependent on the configuration of magicpoint binary.
 	If the configuration allows the use of TrueType "cour.ttf" font,
 	"tfont" directive will be effective.  If there's no TrueType font
 	available, or FreeType library is not compiled into the magicpoint
@@ -350,8 +350,8 @@
 
 %area <width> <height> [<xoffset> <yoffset>]
 	Specify the drawing area within the window.  All parameters are
-	translated as relative value of the window.  If offset is not
-	specified, the drawing area will be put center.
-	Note that all relative size specified in other directive after
+	translated as relative coordinates within of the window.  If an 
+	offset is not specified, the drawing area will be put at the center.
+	Note that all relative sizes specified in other directive after
 	"%area" will be affected, i.e. it will be relative to the
 	width/height of the drawing area instead of the window.
--- USAGE	2002/02/05 04:09:38	1.1
+++ USAGE	2002/02/05 04:11:44
@@ -85,7 +85,7 @@
 	%tab 2 size 4, vgap 40, prefix "      ", icon arc yellow 50
 	%tab 3 size 3, vgap 40, prefix "            ", icon delta3 white 40
 
-When there is a singular tab at the head of the line, the values of
+When there is a single tab at the head of the line, the values of
 %tab override the current values and become valid. When there are two
 tabs at the head of the line, %tab 2 becomes valid, when there are
 three tabs at the head of the line %tab 3 becomes valid and so on.
@@ -96,7 +96,7 @@
 3 tabs mean text size 3% and the line starts with spaces and white delta icon.
 
 
-By using this, it's easy to itemize. Let's take a look at an example:
+Using this feature, it's easy to itemize. Let's take a look at an example:
 
 	%page
 
@@ -280,19 +280,19 @@
 Client side (Browser) needs to be configured as follows:
 Define "helper application" for extention ".mgp" as,
 	mgp -g 400x300 -S <filename>
-You can specify any screeen size as you want.  Here, -S is REALLY
-important for security, since MagicPoint presentation can include
-arbitrary shell command.  -S option disables invocation of any
+You can specify any screen size as you want.  Here, -S is REALLY
+important for security, since MagicPoint presentations can include
+arbitrary shell commands.  -S option disables invocation of any
 external process from MagicPoint.  If you need to configure
 content-type for ".mgp", use "application/x-magicpoint".  I believe
 "text/plain" would be a last resort.
 
 (2) If you cannot asuume that there's no MagicPoint at the client's
-    site, you'll need to convert presentation into a html file.  Use
+    site, you'll need to convert the presentation into an HTML file.  Use
     the -D option for this.
 
 (3) You may convert your presentation as postscript file, after
-    processing it with "mgp2ps".  It would be nice if you would like
-    nobody to reuse your work at ease.
+    processing it with "mgp2ps".  This is useful if you do not
+    want others to be able to easily re-use your work.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
--- mgp.man	2002/02/05 03:32:29	1.1
+++ mgp.man	2002/02/05 03:42:36
@@ -57,24 +57,23 @@
 .Nm
 is an X11 based presentation tool.
 It is designed to make
-simple presentations easy while to make complicated presentations
+simple presentations easy and complicated presentations
 possible.
-Its presentation file
-.Pq whose suffix is typically Li .mgp
-is
-just text so that you can create presentation files quickly with your
+MagicPoint presentation files
+.Pq which typically use a suffix of Li .mgp
+are just plain text, so you can create presentation files quickly with your
 favorite editor (such as Emacs).
 .Pp
-The 
+An
 .Li .mgp
 file consists of text and
 control commands (such as pagebreak, centering, and/or inline image).
-Control commands are specified on the beginning of lines started with
+Control commands are specified by lines begun with
 one
 .Li %
 sign.
-You can include numerous kinds of image format files
-onto the presentation file.
+You can include many kinds of image format files
+in the presentation.
 .Pp
 .Nm
 uses Japanese/English fonts in various sizes.
@@ -94,7 +93,7 @@
 Specify a VFlib configuration file.
 .It Fl d
 Demonstration mode.
-Browse all page quickly and terminate.
+Browse all pages quickly and terminate.
 .It Fl f Ar vfont
 Specify the font name to be used by VFlib.
 (The default value is minsl)
@@ -109,7 +108,7 @@
 .It Fl h
 Display the usage and exit without performing a presentation.
 .It Fl l
-There are two kind of fonts available by VFlib;
+There are two kind of fonts available through VFlib;
 They are outline font and bitmap font.
 By specifying
 .Fl l ,
@@ -133,28 +132,29 @@
 .It Fl q
 Do not beep on errors.
 .It Fl t Ar timeslot
-Specify the timeslot assigned to the presentation in minute.
+Specify the timeslot assigned to the presentation in minutes.
 The timer is invoked when the second page is displayed and the remaining
 presentation time is indicated by the length of bar shown at the bottom of
 the display.
-The timebar is updated when some X11 event is raised,
-for instance some keypress.
-Timebar will be green if you have more than 50% of the timeslot,
-yellow while you have more than 30% of the timeslot,
+The timebar is updated when any X11 event is raised,
+(for instance a keypress).
+The timebar will be green if you have more than 50% of the timeslot left,
+yellow while you have more than 30% of the timeslot left,
 and red for the other cases.
-When the assigned timeslot is expired, exceeding time is also shown as 
+When the assigned timeslot has expired, exceeding time is also shown as 
 a timebar growing from left to right.
-Current page is indicated by the position of a small vertical bar; the vertical
+The current page is indicated by the position of a small vertical bar;
+the vertical
 bar is drawn at the leftend when the first page is displayed while the
 bar is drawn at the rightend when the last page is displayed.
 .It Fl v
 Display the MagicPoint version and exit without performing a presentation.
 .It Fl w Ar wdir
-specifies the working directory used for store embedded images if any.
+specifies the working directory used to store embedded images if any.
 To generate an embedded MGP file, use 
 .Xr mgpembed 1 .
 .It Fl x Ar engine
-Do not use rendering engine, specified by
+Do not use the rendering engine specified by
 .Ar engine .
 .Ar engine
 can be
@@ -221,7 +221,7 @@
 displayed to assist the presentation.
 Page guide can be turned on and off by keyboard too.
 .It Fl O
-Obey to the window manager, but with less decoration around the window.
+Obey the window manager, but with less decoration around the window.
 The behavior of this option is affected by how the window manager
 is implemented; this option may have no effect on some of the window managers.
 .It Fl Q Ar quality
@@ -236,8 +236,8 @@
 .It Fl S
 Be secure.
 Skip directives that fork/exec the child process.
-It is suggested to use this option if you got some presentation file
-from others.
+It is suggested to use this option if you recieved a presentation file
+from someone else.
 .It Fl T Ar timestampfile
 If the option is specified,
 .Nm
@@ -276,7 +276,7 @@
 
 .El
 .\"
-.Sh KEY OPERATION
+.Sh KEYBOARD OPERATION
 The keyboard/mouse commands are:
 .Bl -tag -width -diag indent
 .It mouse button 1 (leftmost button)
@@ -306,7 +306,7 @@
 for details.
 .It x
 Enable/disable rakugaki (jotting) mode.
-You can make an annotation (by mouse) on the presentation.
+You can make an annotation (with the mouse) on the presentation.
 Mouse button 2 (middle) has the same effect.
 .It X
 Change the pen color for rakugaki (jotting) mode.
@@ -326,11 +326,11 @@
 "q" key also has the same effect.
 .El
 .Pp
-During the presentation, you can see the page list at the bottom of the
-window when you press a Control Key.
-Choosing a page with the mouse and clicking it with the leftmost mouse button,
-you can go to corresponding page directly.
-Releasing the Control Key, the page list disappears and you can continue
+During the presentation you can see the page list at the bottom of the
+window by pressing a Control Key.
+By choosing a page with the mouse and clicking it with the leftmost mouse
+button, you can go to corresponding page directly.
+When you release the Control Key, the page list disappears and you can continue
 with the current page.
 This function is useful during the Q-and-A period after your presentation
 completes.
@@ -341,10 +341,10 @@
 .Pa ~/.mgprc
 in your home directory.
 The content of the file must be a limited set of magicpoint directives,
-one directive per line, without 
+one directive per line, without a leading
 .Li %
 sign.
-Lines start with
+Lines starting with
 .Li # ,
 or empty lines, will be silently ignored.
 See
@@ -364,17 +364,16 @@
 is searched.
 .\"
 .Sh SECURITY ISSUES
-The presentation file can include directives to call the external process,
-just like shell process.
-Therefore, the presentation file should be treated just like shell script
-or perl script.
-This is STRONGLY recommended to review the content
+The presentation file can include directives to call external processes.
+Therefore, the presentation file should be treated just like a shell script
+or Perl script.
+It is STRONGLY recommended that you review the content
 of the presentation file before invoking
 .Nm mgp ,
-if you got the file from others.
-By adding the
+if you got the file from someone else.
+If you add the
 .Fl S
-option to the command line argument, directives that call external processes
+option to the command line arguments, directives that call external processes
 will be skipped.
 .\"
 .Sh SEE ALSO
@@ -394,7 +393,7 @@
 .\"
 .Sh HISTORY
 .Nm
-was created shortly after the autumn camp of WIDE Project in 1997,
-which was originally called
+was created shortly after the Autumn camp of WIDE Project in 1997,
+and was originally called
 .Nm tp
 .Pq TinyPoint .
--- mgp2ps.man	2002/02/05 03:31:32	1.1
+++ mgp2ps.man	2002/02/05 03:31:36
@@ -114,5 +114,5 @@
 .Nm mgp2ps
 was created so that Kazu Yamamoto could
 submit his tutorial document to the committee of
-Intenret Week '97.
+Internet Week '97.
 
--- mgpembed.man	2002/02/05 03:31:58	1.1
+++ mgpembed.man	2002/02/05 03:32:04
@@ -42,7 +42,7 @@
 .Ar mgpfile
 to a embedded MagicPoint file.
 A embedded MagicPoint file is suitable to give a presentation file to
-other guys via Email or via Web because external references (except
+other people via Email or via Web because external references (except
 shell commands) are resolved.
 .Fl o
 option specifies that the output will be saved to
--- sample/README	2002/02/05 03:53:34	1.1
+++ sample/README	2002/02/05 03:54:00
@@ -5,7 +5,7 @@
 	mgprc-sample		A sample file of .mgprc
 
 	sample.mgp		Short demonstration of MagicPoint features
-	tutorial.mgp		Operation guide of MagicPoint
+	tutorial.mgp		Operation guide for MagicPoint
 	gradation.mgp		Samples of gradation
 
 	v6.mgp			A sample of presentation material
@@ -14,7 +14,7 @@
 
 	embed.mgp		A sample of mgpembed
 
-Visualize these samples beautifully, TrueType fonts are necessary.
+To display these samples beautifully, TrueType fonts are necessary.
 
 	(1) Create "~/.mgprc" whose contents are:
 		tfdir "/path/to/truetype/fonts"
--- sample/default.mgp	2002/02/05 03:47:57	1.1
+++ sample/default.mgp	2002/02/05 03:48:25
@@ -4,11 +4,11 @@
 %% First, you should create "~/.mgprc" whose contents are:
 %%	tfdir "/path/to/truetype/fonts"
 %%
-%% To visualize English, install "standard.ttf", "thick.ttf", and 
+%% To display English, install "standard.ttf", "thick.ttf", and 
 %% "typewriter.ttf" into the "tfdir" directory above:
 %%	ftp://ftp.mew.org/pub/mgp/ttf-us.tar.gz
 %%
-%% To visualize Japanese, install "kochi-mincho.ttf" and "goth.ttf"
+%% To display Japanese, install "kochi-mincho.ttf" and "goth.ttf"
 %% into the "tfdir" directory above:
 %%	ftp://ftp.mew.org/pub/mgp/ttf-jp.tar.gz
 %%
@@ -17,7 +17,7 @@
 %deffont "typewriter" tfont "typewriter.ttf", tmfont "goth.ttf"
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%
-%% Default settings per each line numbers.
+%% Default settings for each line number.
 %%
 %default 1 area 90 90, leftfill, size 2, fore "white", back "black", font "thick"
 %default 2 size 7, vgap 10, prefix " "
@@ -25,7 +25,7 @@
 %default 4 size 5, fore "white", vgap 30, prefix " ", font "standard"
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%
-%% Default settings that are applied to TAB-indented lines.
+%% Default settings to be applied to TAB-indented lines.
 %%
 %tab 1 size 5, vgap 40, prefix "  ", icon box "green" 50
 %tab 2 size 4, vgap 40, prefix "      ", icon arc "yellow" 50
--- sample/gradation.mgp	2002/02/05 03:49:05	1.1
+++ sample/gradation.mgp	2002/02/05 03:52:06
@@ -35,15 +35,15 @@
 %page
 %bgrad 0 0 128 90 1 "black" "blue"
 
-Principles of drawing gradation background
+Principles of drawing gradation background:
 
-Gradation drawing is 2-phase process:
-		generate raw material of gradaton image
-		superimpose to screen image
-
-The first five arguments to "bgrad" can be separate as follows:
-		Args. for image generation
-		Args. for superimpose method
+Gradation drawing is a 2-phase process:
+		Generate raw material of the gradation image
+		Superimpose on the screen image
+
+The first five arguments to "bgrad" can be distinguished as follows:
+		Arguments for image generation
+		Arguments for superimposition method
 
 Following the above, the list of color name (to be used for gradation) \
 may be specified.
@@ -53,16 +53,16 @@
 %page
 %bgrad 50 50
 
-Args. for image generation 
+Arguments for image generation:
 
-Args. to specify the size of genarated images 
+Arguments to specify the size of genarated images:
 	1st arg:
-		Relative size against X axis (percentage)
+		Relative size on X axis (percentage)
 
 	2nd arg:
-		Relative size against Y axis (percentage)
+		Relative size on Y axis (percentage)
 
-Args. to specify the property of genarated images 
+Arguments to specify the properties of genarated images :
 	3rd arg:
 		# of colors
 
@@ -74,9 +74,9 @@
 %page
 %bgrad 50 50
 
-Args. for superimpose method
+Arguments for superimposition method:
 
-Args. to specify how image should be enlarged to fit to the screen.
+Arguments to specify how the image should be enlarged to fit the screen:
 
 	5th arg:
 		Zooming flag:
@@ -87,18 +87,18 @@
 %page
 %bgrad
 
-Syntax of bgrad (conclusion)
+Syntax of bgrad (conclusion):
 
-	1st arg: Relative size against X direction
+	1st arg: Relative size in X direction
 		Range: 1 to 100 (0 means 100%)/default: 100%
-	2nd arg: Relative size against Y direction
+	2nd arg: Relative size in Y direction
 		Range: 1 to 100 (0 means 100%)/default: 100%
-	3rd arg: # of colors
+	3rd arg: number of colors
 		default: 128 colors
 	4th arg: Rotation Angle
 		Range: -360 to 360/default: 0
 	5th arg: Zooming flag
-		1:Zoom, 0:Repeat to the edges of screen
+		1:Zoom, 0:Repeat to the edges of the screen
 		Default: 1
 	Rests are colors
 		Defualt: blue,black
@@ -107,7 +107,7 @@
 %page
 %bgrad
 
-Background gallary (Basic technics)
+Background gallary (Basic technics):
 
 Here are basic examples:
 
--- sample/mgprc-sample	2002/02/05 03:52:22	1.1
+++ sample/mgprc-sample	2002/02/05 03:52:39
@@ -2,13 +2,13 @@
 # this is a sample for ~/.mgprc.
 #
 
-# setting up font directories.
+# Setting up font directories:
 # "vfcap" is commented out because it will be guessed by "configure"
 # in most cases.
 #vfcap "/usr/local/libdata/vflib/vfontcap"
 tfdir "/usr/local/share/fonts/ttf"
 
-# last resort font for TrueType renderer (FreeType).
-# this must be specified in full pathname so that it can be used even if
+# Last resort font for TrueType renderer (FreeType).
+# This must be specified in full pathname so that it can be used even if
 # "tfdir" is changed in presentation file.
 tfont0 "/usr/local/share/fonts/ttf/arial.ttf"
--- sample/multilingual.mgp	2002/02/05 03:52:59	1.1
+++ sample/multilingual.mgp	2002/02/05 03:53:20
@@ -4,12 +4,12 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %page
 
-MagicPoint for asian multilingual presentation!
+MagicPoint for Asian multilingual presentation!
 
 It may be slow...
 
 	Japanese ($BF|K\8l(B)
-		0208-1978 $@$3$s$K$A$O?92*30(B
+		0208-1978 $B$3$s$K$A$O?92*30(B
 		0208-1983 $B$3$s$K$A$O?92*30(B
 		0213-2000 $(O$3$s$K$A$O?92*30(B
 	Chinese ($AVPND(B,$AFUM(;0(B,$A::So(B)
@@ -18,4 +18,4 @@
 		$(C>H3gGO<<?d(B, $(C>H3gGO=J4O1n(B
 
 %size 3
-(The text was grabbed from mule distribution)
+(This text was grabbed from the Mule distribution)
--- sample/sample.mgp	2002/02/05 03:54:22	1.1
+++ sample/sample.mgp	2002/02/05 04:01:34
@@ -4,11 +4,11 @@
 %% First, you should create "~/.mgprc" whose contents are:
 %%	tfdir "/path/to/truetype/fonts"
 %%
-%% To visualize English, install "times.ttf", "arial.ttf", and "cour.ttf"
+%% To display English, install "times.ttf", "arial.ttf", and "cour.ttf"
 %% into the "tfdir" directory above:
 %%	http://microsoft.com/typography/fontpack/default.htm
 %%
-%% To visualize Japanese, install "MSMINCHO.ttf" and 
+%% To display Japanese, install "MSMINCHO.ttf" and 
 %% "watanabenabe-mincho.ttf" into the "tfdir" directory above:
 %%	http://www.mew.org/mgp/xtt-fonts_0.19981020-3.tar.gz
 %%
@@ -58,28 +58,28 @@
 %page
 %bgrad 0 0 256 0 0 "white" "blue"
 
-How to Use 
+How to Use:
 
 
-	forward page -> press mouse1 button 
-	backward page -> press mouse3 button 
-	quit -> press q key 
+	To page forward, press the left mouse button.
+	To page back, press the right mouse button.
+	To quit, press the `q' key.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %page
 %bgrad 0 0 256 90 0 "red" "white"
 
-Command Line Option 
+Command Line Options:
 
 
 %prefix "    -h:"
-display usage.
+Display usage.
 %prefix "    -g:"
-geometry. Set the size of window, and placement.
+Geometry. Set the size of the MagicPoint window and its placement.
 %prefix "    -o:"
-Do not override window manager.
+Do not override the window manager's window placement.
 %prefix "    -b:"
-bgcolor. Set background color to bgcolor. (default: black)
+Set background color to bgcolor. (The default is black)
 %prefix ""
      
 
@@ -88,7 +88,7 @@
 %page
 %bgrad 0 0 256 0 0 "green" "white"
 
-Place text whereever you like!
+Place text wherever you like!
 
 
 %area 40 80 5 20
@@ -108,7 +108,7 @@
 %PAGE
 %bgrad 25 25 256 45 1 "gray" "gray" "white" "white" "white" "white" "gray" "gray"
 
-Use any font size as you like!
+Use any font size you like!
 
 
 
@@ -131,7 +131,7 @@
 %page
 %bgrad 25 25 256 45 1 "gray" "gray" "white" "white" "white" "white" "gray" "gray"
 
-Fonts are selectable
+Fonts are selectable.
 
 
 %size 5, fore "red", center
@@ -148,7 +148,7 @@
 %page
 %bgrad 25 25 256 45 1 "gray" "gray" "white" "white" "white" "white" "gray" "gray"
 
-Control can be mixed
+Control can be mixed:
 
 
 
@@ -163,18 +163,18 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %page
 
-Automatic folding of long line!
+Automatic folding of long lines!
 
 
-	Hello, this is MagicPoint. I can properly handle the folding opeation of very long line, of course english word-wise.  The source code of this line is made up by a single line.
-		This is the next line. Even if the indentation changes, I can handle this!  Yey!
+	Hello, this is MagicPoint. I can properly handle the folding operation of very long lines in English.  The source code of this line is a single physical line.
+		This is the next line. Even if the indentation changes, I can handle it!
 
-	You can also connect the line using backslash.  \
+	You can also connect the lines using backslash continuation.  \
 				Yes, UNIX tradition.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %PAGE
 
-Visualize inline images!
+Display inline images!
 
 
 %CENTER
@@ -199,10 +199,10 @@
 %PAGE
 %bgrad 0 0 256 0 0 "white" "blue"
 
-Pause
+Pause:
 
 
-	Type SPC key (twice) to proceed.
+	Type the space key twice to proceed.
 
 %center, fore "red", hgap 20
 Happy hacking!
@@ -214,7 +214,7 @@
 %PAGE
 %bgrad 0 0 256 0 0 "white" "blue"
 
-Grab command output into foils
+Grab command output into foils:
 
 
 	ls -l /kernel /bsd
@@ -233,14 +233,14 @@
 %PAGE
 %bgrad 0 0 256 0 0 "white" "blue"
 
-Subprocess (multimedia!)
+Subprocess (multimedia!):
 
 
 %system "xeyes -geometry %50x20+25+60"
 
 	Invoke xanim/mpegplay for multimedia presentation! :-)
 
-	No duplicated subprocess for one declaration.
+	No duplicated subprocesses for one declaration.
 	Geometry can be presentation-screen relative.
 	xeyes will vanish if you switch the page.
 
@@ -249,12 +249,12 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %PAGE
 
-Embed Subprocess
+Embed Subprocesses:
 
 
 	You can embed X applications in MagicPoint!
 
-	An example
+	An example:
 %center
 %xsystem "xclock -geometry %30x30+25+60 -update 1 -bg white -fg blue -hands green"
 
@@ -281,7 +281,7 @@
 
 
 	You can specify 'special effect' for the forward page cache.
-		tap space bar to see the 'special effect'. 
+		tap the space bar to see the 'special effect'. 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %PAGE
 %bgrad 0 0 256 0 0 "skyblue" "white"
--- sample/tutorial.mgp	2002/02/05 04:01:57	1.1
+++ sample/tutorial.mgp	2002/02/05 04:04:06
@@ -9,7 +9,7 @@
 
 %image "mgp-old1.jpg" 800x600
 
-for good boys and girls
+for all good boys and girls
 
 %fore "yellow", size 5
 To go to the next page,
@@ -116,24 +116,24 @@
 
 Jotting
 
-To draw arrow/underline/etc onto the foil,
+To draw arrows/underlines/etc onto the foil,
 	Type x to display a pen
 	Press the left button to draw
 
-One more typing x bring you back to the normal mode.
+Typing x again disables the pen.
 
-To erase your masterpiece
+To erase your masterpiece:
 	Type l (el not one)
 
 %fore "yellow"
-After practice of jotting, please go to the next page.
+After practicing jotting, please go to the next page.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %page
 
-Good night
+Good night!
 
-It is the time for good boys and girls to go to bed
+It is time for all good boys and girls to go to bed.
 
 
 

-- 
		<a href="http://www.tuxedo.org/~esr/";>Eric S. Raymond</a>

..every Man has a Property in his own Person. This no Body has any
Right to but himself.  The Labour of his Body, and the Work of his
Hands, we may say, are properly his. .... The great and chief end
therefore, of Mens uniting into Commonwealths, and putting themselves
under Government, is the Preservation of their Property.
	-- John Locke, "A Treatise Concerning Civil Government"