tp-magic-config man moved to (1)

Magic tool documentation now split into separate files, and referenced
(as a directory) from README, so that users can find docs to any additional
tools (ones not included by default with Tux Paint) that are installed.
Added new --datadir option, to separate path to brushes/stamps/etc. from that of saved files.
Improved docs on where savedir default is.
Made sure --help, man tuxpaint, and OPTIONS docs all covered all command-line options.
Noted SDL_Pango makes locale-specific fonts unnecessary.
Added "--plugindocprefix" option to tp-magic-config, for where docs should go.
Improved plugin API documentation.
Improved layout of man pages a little.

magic/magic-docs/Makefile

@@ -0,0 +1,120 @@
+# Makefile for Tux Paint Magic Tool Plugin API docs
+# 
+# Uses "links" to convert docs from HTML to plain text.
+# (Normally only ran by the developers after updating the HTML, prior to
+# release.)
+#
+# Bill Kendrick
+# bill@newbreedsoftware.com
+# 
+# August 2, 2007 - August 2, 2007
+# $Id$
+
+LINKS=links -dump -no-numbering -no-references
+
+TXT_FILES= \
+	blocks.txt \
+	blur.txt \
+	bricks.txt \
+	cartoon.txt \
+	chalk.txt \
+	darken.txt \
+	drip.txt \
+	emboss.txt \
+	fade.txt \
+	fill.txt \
+	flip.txt \
+	flower.txt \
+	foam.txt \
+	glasstile.txt \
+	grass.txt \
+	kalidescope.txt \
+	metalpaint.txt \
+	mirror.txt \
+	negative.txt \
+	rainbow.txt \
+	ripples.txt \
+	smudge.txt \
+	sparkles.txt \
+	tint.txt \
+	waves.txt
+
+all:	$(TXT_FILES)
+
+clean:
+	@-rm $(TXT_FILES)
+
+blocks.txt: html/blocks.html
+	@$(LINKS) $< > $@
+
+blur.txt: html/blur.html
+	@$(LINKS) $< > $@
+
+bricks.txt: html/bricks.html
+	@$(LINKS) $< > $@
+
+cartoon.txt: html/cartoon.html
+	@$(LINKS) $< > $@
+
+chalk.txt: html/chalk.html
+	@$(LINKS) $< > $@
+
+darken.txt: html/darken.html
+	@$(LINKS) $< > $@
+
+drip.txt: html/drip.html
+	@$(LINKS) $< > $@
+
+emboss.txt: html/emboss.html
+	@$(LINKS) $< > $@
+
+fade.txt: html/fade.html
+	@$(LINKS) $< > $@
+
+fill.txt: html/fill.html
+	@$(LINKS) $< > $@
+
+flip.txt: html/flip.html
+	@$(LINKS) $< > $@
+
+flower.txt: html/flower.html
+	@$(LINKS) $< > $@
+
+foam.txt: html/foam.html
+	@$(LINKS) $< > $@
+
+glasstile.txt: html/glasstile.html
+	@$(LINKS) $< > $@
+
+grass.txt: html/grass.html
+	@$(LINKS) $< > $@
+
+kalidescope.txt: html/kalidescope.html
+	@$(LINKS) $< > $@
+
+metalpaint.txt: html/metalpaint.html
+	@$(LINKS) $< > $@
+
+mirror.txt: html/mirror.html
+	@$(LINKS) $< > $@
+
+negative.txt: html/negative.html
+	@$(LINKS) $< > $@
+
+rainbow.txt: html/rainbow.html
+	@$(LINKS) $< > $@
+
+ripples.txt: html/ripples.html
+	@$(LINKS) $< > $@
+
+smudge.txt: html/smudge.html
+	@$(LINKS) $< > $@
+
+sparkles.txt: html/sparkles.html
+	@$(LINKS) $< > $@
+
+tint.txt: html/tint.html
+	@$(LINKS) $< > $@
+
+waves.txt: html/waves.html
+	@$(LINKS) $< > $@

magic/magic-docs/blocks.txt

@@ -0,0 +1,4 @@
+                         Tux Paint "Magic" Tool: Blocks
+
+   This makes the picture blocky looking ("pixelated") wherever you drag the
+   mouse.

magic/magic-docs/blur.txt

@@ -0,0 +1,5 @@
+                          Tux Paint "Magic" Tool: Blur
+
+   This makes the picture fuzzy wherever you drag the mouse.
+
+   See also: Smudge.

magic/magic-docs/bricks.txt

@@ -0,0 +1,5 @@
+                         Tux Paint "Magic" Tool: Bricks
+
+   These two tools intelligently paint large and small brick patterns on the
+   canvas. The bricks can be tinted various redish hues by selecting
+   different colors in the color palette.

magic/magic-docs/cartoon.txt

@@ -0,0 +1,4 @@
+                        Tux Paint "Magic" Tool: Cartoon
+
+   This makes the picture look like a cartoon -- with thick outlines and
+   bright, solid colors -- wherever you move the mouse.

magic/magic-docs/chalk.txt

@@ -0,0 +1,4 @@
+                         Tux Paint "Magic" Tool: Chalk
+
+   This makes parts of the picture (where you move the mouse) look like a
+   chalk drawing.

magic/magic-docs/darken.txt

@@ -0,0 +1,6 @@
+                         Tux Paint "Magic" Tool: Darken
+
+   This dakrens the colors wherever you drag the mouse. (Do it to the same
+   spot many times, and it will eventually become black.)
+
+   See also: Darken and Tint.

magic/magic-docs/drip.txt

@@ -0,0 +1,3 @@
+                          Tux Paint "Magic" Tool: Drip
+
+   This makes the paint "drip" wherever you move the mouse.

magic/magic-docs/emboss.txt

@@ -0,0 +1,5 @@
+                         Tux Paint "Magic" Tool: Emboss
+
+   This makes parts of your picture look "embossed." Wherever there are sharp
+   edges in your picture, the picture will look raised like it was stamped in
+   metal.

magic/magic-docs/fade.txt

@@ -0,0 +1,6 @@
+                          Tux Paint "Magic" Tool: Fade
+
+   This fades the colors wherever you drag the mouse. (Do it to the same spot
+   many times, and it will eventually become white.)
+
+   See also: Darken and Tint.

magic/magic-docs/fill.txt

@@ -0,0 +1,4 @@
+                          Tux Paint "Magic" Tool: Fill
+
+   This floods the picture with a color. It lets you quickly fill parts of
+   the picture, as if it were a coloring book.

magic/magic-docs/flip.txt

@@ -0,0 +1,6 @@
+                          Tux Paint "Magic" Tool: Flip
+
+   Similar to "Mirror." Click and the entire image will be turned
+   upside-down.
+
+   See also: Mirror.

magic/magic-docs/flower.txt

@@ -0,0 +1,9 @@
+                         Tux Paint "Magic" Tool: Flower
+
+   This tool draws small flowers, with leafy bases and stalks. Click to set
+   the base, then drag the mouse upwards to drawe the stalk, and finally
+   release the mouse button to finish the flower. It will be drawn in the
+   currently-selected color. The shape and length of the stalk depends on how
+   you move the mouse while you drag.
+
+   See also: Grass.

magic/magic-docs/foam.txt

@@ -0,0 +1,5 @@
+                          Tux Paint "Magic" Tool: Foam
+
+   Click and drag the mouse to draw foamy bubbles. The more you drag the
+   mouse in a particular spot, the more likely small bubbles will combine to
+   form bigger bubbles.

magic/magic-docs/glasstile.txt

@@ -0,0 +1,4 @@
+                       Tux Paint "Magic" Tool: Glass Tile
+
+   Click and drag over your picture to make it look like it's being seen
+   through glass tiles.

magic/magic-docs/grass.txt

@@ -0,0 +1,7 @@
+                         Tux Paint "Magic" Tool: Grass
+
+   This paints grass on the image. The higher up the canvas, the smaller the
+   grass is drawn, giving an illusion of perspective. The grass can be tinted
+   various greenish hues by selecting different colors in the color palette.
+
+   See also: Flower.

magic/magic-docs/html/blocks.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Blocks
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Blocks
+
+</h1>
+
+<p>
+          This makes the picture blocky looking ("pixelated") wherever
+          you drag the mouse.
+</p>
+
+</body></html>
+

magic/magic-docs/html/blur.html

@@ -0,0 +1,26 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Blur
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Blur
+
+</h1>
+
+<p>
+          This makes the picture fuzzy wherever you drag the mouse.
+</p>
+
+<p><b>See also:</b> <a href="smudge.html">Smudge</a>.</p>
+
+</body></html>
+

magic/magic-docs/html/bricks.html

@@ -0,0 +1,26 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Bricks
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Bricks
+
+</h1>
+
+<p>
+          These two tools intelligently paint large and small brick
+          patterns on the canvas.  The bricks can be tinted various redish
+          hues by selecting different colors in the color palette.
+</p>
+
+</body></html>
+

magic/magic-docs/html/cartoon.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Cartoon
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Cartoon
+
+</h1>
+
+<p>
+          This makes the picture look like a cartoon &mdash; with thick
+          outlines and bright, solid colors &mdash; wherever you move the mouse.
+</p>
+
+</body></html>
+

magic/magic-docs/html/chalk.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Chalk
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Chalk
+
+</h1>
+
+<p>
+          This makes parts of the picture (where you move the mouse)
+          look like a chalk drawing.
+</p>
+
+</body></html>
+

magic/magic-docs/html/darken.html

@@ -0,0 +1,30 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Darken
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Darken
+
+</h1>
+
+<p>
+          This dakrens the colors wherever you drag the mouse.
+          (Do it to the same spot many times, and it will eventually become
+          black.)
+</p>
+
+<p><b>See also:</b> <a href="fade.html">Darken</a>
+and <a href="tint.html">Tint</a>.</p>
+
+
+</body></html>
+

magic/magic-docs/html/drip.html

@@ -0,0 +1,24 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Drip
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Drip
+
+</h1>
+
+<p>
+          This makes the paint "drip" wherever you move the mouse.
+</p>
+
+</body></html>
+

magic/magic-docs/html/emboss.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Emboss
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Emboss
+
+</h1>
+
+<p>This makes parts of your picture look "embossed."  Wherever there are
+sharp edges in your picture, the picture will look raised like it was
+stamped in metal.
+</p>
+
+</body></html>
+

magic/magic-docs/html/fade.html

@@ -0,0 +1,30 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Fade
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Fade
+
+</h1>
+
+<p>
+          This fades the colors wherever you drag the mouse.
+          (Do it to the same spot many times, and it will eventually become
+          white.)
+</p>
+
+<p><b>See also:</b> <a href="darken.html">Darken</a>
+and <a href="tint.html">Tint</a>.</p>
+
+
+</body></html>
+

magic/magic-docs/html/fill.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Fill
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Fill
+
+</h1>
+
+<p>
+          This floods the picture with a color.  It lets you quickly
+          fill parts of the picture, as if it were a coloring book.
+</p>
+
+</body></html>
+

magic/magic-docs/html/flip.html

@@ -0,0 +1,27 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Flip
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Flip
+
+</h1>
+
+<p>
+          Similar to "Mirror."  Click and the entire image will be turned
+          upside-down.
+</p>
+
+<p><b>See also:</b> <a href="mirror.html">Mirror</a>.</p>
+
+</body></html>
+

magic/magic-docs/html/flower.html

@@ -0,0 +1,31 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Flower
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Flower
+
+</h1>
+
+<p>
+This tool draws small flowers, with leafy bases and stalks.
+Click to set the base, then drag the mouse upwards to drawe the stalk,
+and finally release the mouse button to finish the flower.  It will be drawn
+in the currently-selected color.
+The shape and length of the stalk depends on how you move the mouse
+while you drag.
+</p>
+
+<p>See also: <a href="grass.html">Grass</a>.</p>
+
+</body></html>
+

magic/magic-docs/html/foam.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Foam
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Foam
+
+</h1>
+
+<p>Click and drag the mouse to draw foamy bubbles.  The more you drag the
+mouse in a particular spot, the more likely small bubbles will combine to
+form bigger bubbles.
+</p>
+
+</body></html>
+

magic/magic-docs/html/glasstile.html

@@ -0,0 +1,24 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Glass Tile
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Glass Tile
+
+</h1>
+
+<p>Click and drag over your picture to make it look like it's being seen
+through glass tiles.
+</p>
+
+</body></html>
+

magic/magic-docs/html/grass.html

@@ -0,0 +1,29 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Grass
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Grass
+
+</h1>
+
+<p>
+          This paints grass on the image. The higher up the canvas,
+          the smaller the grass is drawn, giving an illusion of perspective.
+          The grass can be tinted various greenish hues by selecting
+          different colors in the color palette.
+</p>
+
+<p>See also: <a href="flower.html">Flower</a>.</p>
+
+</body></html>
+

magic/magic-docs/html/kalidescope.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Kaleidoscope
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Kaleidoscope
+
+</h1>
+
+<p>This paint brush draws in four places at the same time, mirroring
+symmetrically, both horizontally and vertically.  It uses the currently
+selected color.
+</p>
+
+</body></html>
+

magic/magic-docs/html/metalpaint.html

@@ -0,0 +1,24 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Metal Paint
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Metal Paint
+
+</h1>
+
+<p>
+Click and drag to draw shiny metal using the current color.
+</p>
+
+</body></html>
+

magic/magic-docs/html/mirror.html

@@ -0,0 +1,28 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Mirror
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Mirror
+
+</h1>
+
+<p>
+          When you click the mouse in your picture with the "Mirror"
+          magic effect selected, the entire image will be reversed,
+          turning it into a mirror image.
+</p>
+
+<p><b>See also:</b> <a href="flip.html">Flip</a>.</p>
+
+</body></html>
+

magic/magic-docs/html/negative.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Negative
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Negagtive
+
+</h1>
+
+<p>
+          This inverts the colors wherever you drag the mouse.
+          (e.g., white becomes black, and vice versa.)
+</p>
+
+</body></html>
+

magic/magic-docs/html/rainbow.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Rainbow
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Rainbow
+
+</h1>
+
+<p>
+          This is similar to the paint brush, but as you move the mouse
+          around, it cycles through a spectrum of bright colors.
+</p>
+
+</body></html>
+

magic/magic-docs/html/ripples.html

@@ -0,0 +1,24 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Ripples
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Ripples
+
+</h1>
+
+<p>
+Click in your picture to make water ripple distortions appear over it.
+</p>
+
+</body></html>
+

magic/magic-docs/html/smudge.html

@@ -0,0 +1,27 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Smudge
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Smudge
+
+</h1>
+
+<p>
+          This pushes the colors around under the mouse, like finger painting
+          with wet paint.
+</p>
+
+<p><b>See also:</b> <a href="blur.html">Blur</a>.</p>
+
+</body></html>
+

magic/magic-docs/html/sparkles.html

@@ -0,0 +1,25 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Sparkles
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Sparkles
+
+</h1>
+
+<p>
+          This draws glowing sparkles on the canvas, in the currently-selected
+          color.
+</p>
+
+</body></html>
+

magic/magic-docs/html/tint.html

@@ -0,0 +1,28 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Tint
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Tint
+
+</h1>
+
+<p>
+  This changes the color (or hue) of the parts of the picture to
+  the selected color.
+</p>
+
+<p><b>See also:</b> <a href="fade.html">Fade</a>
+and <a href="darken.html">Darken</a>.</p>
+
+</body></html>
+

magic/magic-docs/html/waves.html

@@ -0,0 +1,26 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<body><html><head><title>Tux Paint "Magic" Tool:
+
+Waves
+
+</title>
+<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#FF0000"
+alink="#FF00FF">
+
+<h1 align=center">Tux Paint "Magic" Tool:
+
+Waves
+
+</h1>
+
+<p>
+Click to make the entire picture wavy.  Drag the mouse up and down to
+change the height of the ripples, and left and right to change the width.
+Release the mouse button when it looks the way you like it.
+</p>
+
+</body></html>
+

magic/magic-docs/kalidescope.txt

@@ -0,0 +1,5 @@
+                      Tux Paint "Magic" Tool: Kaleidoscope
+
+   This paint brush draws in four places at the same time, mirroring
+   symmetrically, both horizontally and vertically. It uses the currently
+   selected color.

magic/magic-docs/metalpaint.txt

@@ -0,0 +1,3 @@
+                      Tux Paint "Magic" Tool: Metal Paint
+
+   Click and drag to draw shiny metal using the current color.

magic/magic-docs/mirror.txt

@@ -0,0 +1,7 @@
+                         Tux Paint "Magic" Tool: Mirror
+
+   When you click the mouse in your picture with the "Mirror" magic effect
+   selected, the entire image will be reversed, turning it into a mirror
+   image.
+
+   See also: Flip.

magic/magic-docs/negative.txt

@@ -0,0 +1,4 @@
+                       Tux Paint "Magic" Tool: Negagtive
+
+   This inverts the colors wherever you drag the mouse. (e.g., white becomes
+   black, and vice versa.)

magic/magic-docs/rainbow.txt

@@ -0,0 +1,4 @@
+                        Tux Paint "Magic" Tool: Rainbow
+
+   This is similar to the paint brush, but as you move the mouse around, it
+   cycles through a spectrum of bright colors.

magic/magic-docs/ripples.txt

@@ -0,0 +1,3 @@
+                        Tux Paint "Magic" Tool: Ripples
+
+   Click in your picture to make water ripple distortions appear over it.

magic/magic-docs/smudge.txt

@@ -0,0 +1,6 @@
+                         Tux Paint "Magic" Tool: Smudge
+
+   This pushes the colors around under the mouse, like finger painting with
+   wet paint.
+
+   See also: Blur.

magic/magic-docs/sparkles.txt

@@ -0,0 +1,4 @@
+                        Tux Paint "Magic" Tool: Sparkles
+
+   This draws glowing sparkles on the canvas, in the currently-selected
+   color.

magic/magic-docs/tint.txt

@@ -0,0 +1,6 @@
+                          Tux Paint "Magic" Tool: Tint
+
+   This changes the color (or hue) of the parts of the picture to the
+   selected color.
+
+   See also: Fade and Darken.

magic/magic-docs/waves.txt

@@ -0,0 +1,5 @@
+                         Tux Paint "Magic" Tool: Waves
+
+   Click to make the entire picture wavy. Drag the mouse up and down to
+   change the height of the ripples, and left and right to change the width.
+   Release the mouse button when it looks the way you like it.