From 8a5bcb3fe51dbd9e146354cab2ce018d6781df83 Mon Sep 17 00:00:00 2001 From: Bill Kendrick Date: Mon, 27 Jul 2020 22:33:38 -0700 Subject: [PATCH] README.html - Mend some HTML syntax issues Wrap attributes in quotes, don't store lists within

...

, etc. --- docs/en/README.txt | 4 + docs/en/html/README.html | 632 +++++++++++++++++++-------------------- 2 files changed, 320 insertions(+), 316 deletions(-) diff --git a/docs/en/README.txt b/docs/en/README.txt index bdcb23aad..1e7ada4eb 100644 --- a/docs/en/README.txt +++ b/docs/en/README.txt @@ -367,6 +367,7 @@ Available Tools not include all characters for all languages, so sometimes you'll need to change fonts to see the characters you're trying to type. + * Japanese — Romanized Hiragana and Romanized Katakana — right [Alt] * Korean — Hangul 2-Bul — right [Alt] or @@ -842,6 +843,7 @@ Doing it Manually Calculating the height of Tux Paint's canvas requires multiple steps: + 1. Take the height of the window (e.g, 480, 600 or 768 pixels) and subtract 144 2. Take the result of Step 1 and divide it by 48 @@ -851,6 +853,7 @@ Doing it Manually 5. Finally, take the result of Step 4 and add 40 Example: Tux Paint running at fullscreen on a 1440x900 display. + * The canvas width is simply 1440 - 192, or 1248. * The canvas height is calculated as: 1. 900 - 144, or 756 @@ -858,6 +861,7 @@ Doing it Manually 3. 15.75 rounded down, or 15 4. 15 * 48, or 720 5. 720 + 40, or 760 + So the canvas within a 1440x900 Tux Paint window is 1248x760. ---------------------------------------------------------------------- diff --git a/docs/en/html/README.html b/docs/en/html/README.html index a0fc0ed38..27a211cb2 100644 --- a/docs/en/html/README.html +++ b/docs/en/html/README.html @@ -7,7 +7,7 @@ alink="#FF00FF">
-

Tux Paint
version @@ -22,13 +22,13 @@ version

June 14, 2002 - - July 27, 2020

+ July 27, 2020

-
+
- +
Table of Contents
    @@ -41,7 +41,7 @@ version
-
+

About

@@ -109,7 +109,7 @@ version
-
+

Using Tux Paint

@@ -133,15 +133,15 @@ version (to "stderr").

-
+

Windows Users

-
- [Icon]
- Tux Paint +
+ [Icon]
+ Tux Paint

If you installed Tux Paint on your computer using the @@ -165,26 +165,26 @@ version

If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you put it when you unzipped the ZIP file.

-
+
-
+

macOS Users

- Simply double-click the "Tux Paint" icon.

+

Simply double-click the "Tux Paint" icon.

-
+

Title Screen

When Tux Paint first loads, a title/credits screen will appear.

-

[Title Screenshot]

Once loading is complete, press a key or click on the mouse to continue. @@ -192,7 +192,7 @@ version automatically.)

-
+

Main Screen

@@ -205,7 +205,7 @@ version

The toolbar contains the drawing and editing controls.

-

[Tools: Paint, Stamp, Lines, Shapes, Text, Magic, Label, Undo, Redo, Eraser, New, Open, Save, Print, Quit]

@@ -215,7 +215,7 @@ version

The largest part of the screen, in the center, is the drawing canvas. This is, obviously, where you draw!

-

[(Canvas)]

Note: The size of the drawing canvas depends on the size @@ -233,7 +233,7 @@ version the various brushes available. When the Rubber Stamp tool is selected, it shows the different shapes you can use.

-

[Selectors - Brushes, Letters, Shapes, Stamps]

@@ -243,7 +243,7 @@ version

A palette of available colors are shown near the bottom of the screen.

-

[Colors - Black, White, Red, Pink, Orange, Yellow, Green, Cyan, Blue, Purple, Brown, Grey]

@@ -264,7 +264,7 @@ version

At the very bottom of the screen, Tux, the Linux Penguin, provides tips and other information while you draw.

-

(For example: 'Pick a shape. Click to pick the center, drag, then let go when it is the size you want. Move around to rotate it, and click to draw it.)

@@ -272,7 +272,7 @@ version -
+

Available Tools

@@ -282,9 +282,9 @@ version
Paint (Brush)
- + -

The Paint Brush tool lets you draw freehand, using various +

The Paint Brush tool lets you draw freehand, using various brushes (chosen in the Selector on the right) and colors (chosen in the Color palette towards the bottom).

@@ -294,43 +294,43 @@ version

As you draw, a sound is played. The bigger the brush, the lower the pitch.

-
+
-

-
+
Stamp (Rubber Stamp)
- +

The Stamp tool is like a set of rubber stamps or stickers. - It lets you paste pre-drawn or photographic images (like a picture - of a horse, or a tree, or the moon) in your picture.

+ It lets you paste pre-drawn or photographic images (like a picture + of a horse, or a tree, or the moon) in your picture.

As you move the mouse around the canvas, an outline follows the mouse, showing where the stamp will be placed, and how big it will - be.

+ be.

-

- -

There can be numerous categories of stamps (e.g., animals, - plants, outer space, vehicles, people, etc.). Use the - Left and Right arrows to cycle through the collections.

+ +

There can be numerous categories of stamps (e.g., animals, + plants, outer space, vehicles, people, etc.). Use the + Left and Right arrows to cycle through the collections.

-

Prior to 'stamping' an image onto your drawing, various +

Prior to 'stamping' an image onto your drawing, various effects can sometimes be applied (depending on the stamp):

  • Some stamps can be colored or tinted. If the color palette below the canvas is activated, you can click the colors to change - the tint or color of the stamp before placing it in the picture.
    • -
  • Stamps can be shrunk and expanded, by clicking within the + the tint or color of the stamp before placing it in the picture.
    • +
  • Stamps can be shrunk and expanded, by clicking within the triangular-shaped series of bars at the bottom right; the larger the bar, the larger the stamp will appear in your picture.
    • @@ -338,29 +338,29 @@ version mirror-image, using the control buttons at the bottom right.
-

- -

+

+ +

- +

Different stamps can have different sound effects and/or - descriptive (spoken) sounds. Buttons at the lower left - (near Tux, the Linux penguin) allow you to re-play the sound effects - and descriptive sounds for the currently-selected stamp.

+ descriptive (spoken) sounds. Buttons at the lower left + (near Tux, the Linux penguin) allow you to re-play the sound effects + and descriptive sounds for the currently-selected stamp.

-

(NOTE: If the "nostampcontrols" option is set, - Tux Paint won't display the Mirror, Flip, Shrink and Grow - controls for stamps. - See the "Options" - documentation.)

+

(NOTE: If the "nostampcontrols" option is set, + Tux Paint won't display the Mirror, Flip, Shrink and Grow + controls for stamps. + See the "Options" + documentation.)

-
+
Lines
- +

This tool lets you draw straight lines using the various brushes and colors you normally use with the Paint Brush.

@@ -372,68 +372,68 @@ version

Let go of the mouse to complete the line. A "sproing!" sound will play.

-
+
-

-
+
Shapes
- +

This tool lets you draw some simple filled, and un-filled shapes.

-

Select a shape from the selector on the right (circle, square, - oval, etc.).

+

Select a shape from the selector on the right (circle, square, + oval, etc.).

-

In the canvas, click the mouse and hold it to stretch the shape - out from where you clicked. Some shapes can change proportion - (e.g., rectangle and oval), others cannot (e.g., square and circle).

+

In the canvas, click the mouse and hold it to stretch the shape + out from where you clicked. Some shapes can change proportion + (e.g., rectangle and oval), others cannot (e.g., square and circle).

-

Let go of the mouse when you're done stretching.

+

Let go of the mouse when you're done stretching.

-
Normal Mode
+
Normal Mode

Now you can move the mouse around the canvas to rotate the - shape.

+ shape.

-

Click the mouse button again and the shape will be drawn in the - current color.

-
+

Click the mouse button again and the shape will be drawn in the + current color.

+
Simple Shapes Mode
-
+
If simple shapes are enabled (e.g., with the "--simpleshapes" option), the shape will be drawn on the canvas when you let go of the mouse button. (There's no rotation step.) -
-
+ + -
+
-

-
+
Text and Label
- +

Choose a font (from the 'Letters' available on the right) and a color - (from the color palette near the bottom). Click on the screen and a - cursor will appear. Type text and it will show up on the screen.

- -

Press [Enter] or [Return] and the text will be drawn + (from the color palette near the bottom). Click on the screen and a + cursor will appear. Type text and it will show up on the screen.

+ +

Press [Enter] or [Return] and the text will be drawn onto the picture and the cursor will move down one line.

Alternatively, press [Tab] and the text will be drawn onto @@ -441,12 +441,12 @@ version rather than down a line, and to the left. (This can be useful to create a line of text with mixed colors, fonts, styles and sizes: Like this.)

- -

Clicking elsewhere in the picture while the text entry is still + +

Clicking elsewhere in the picture while the text entry is still active causes the current line of text to move to that location (where you can continue editing it).

-

@@ -490,45 +490,45 @@ version Note: Many fonts do not include all characters for all languages, so sometimes you'll need to change fonts to see the characters you're trying to type. +

  • Japanese — Romanized Hiragana and Romanized Katakana — right [Alt] -
    • +
  • Korean — Hangul 2-Bul — right [Alt] or left [Alt] -
    • +
  • Traditional Chinese — right [Alt] or left [Alt] -
    • +
  • Thai — right [Alt] -
    • +
-

-
+
Fill
- + -

The 'Fill' tool 'flood-fills' a contiguous area of your drawing - with a solid color of your choice.

+

The 'Fill' tool 'flood-fills' a contiguous area of your drawing + with a solid color of your choice.

-

Note: Prior to Tux Paint 0.9.24, this was a "Magic" tool (see below).

+

Note: Prior to Tux Paint 0.9.24, this was a "Magic" tool (see below).

-
+
Magic (Special Effects)
- +

The 'Magic' tool is actually a set of special tools. Select one of - the "magic" effects from the selector on the right. Then, depending + the "magic" effects from the selector on the right. Then, depending on the tool, you can either click and drag around the picture, and/or simply click the picture once, to apply the effect.

@@ -538,25 +538,25 @@ version picture at once, an 'entire picture' button will be available on the right.

-
+

See the instructions for each Magic tool (in the 'magic-docs' folder).

-
+
- - + +
Eraser
- +

This tool is similar to the Paint Brush. Wherever you click (or click and drag), the picture will be erased. (This may be white, some other color, or to a background picture, depending on the picture.)

-

A number of eraser sizes are available, both round and square..

+

A number of eraser sizes are available, both round and square..

As you move the mouse around, a square outline follows the pointer, showing what part of the picture will be erased to @@ -564,12 +564,12 @@ version

As you erase, a "squeaky clean" eraser/wiping sound is played.

-
+
-
+

Other Controls

@@ -577,104 +577,104 @@ version
Undo
- +

Clicking this tool will undo the last drawing action. You can even undo more than once!

- -

Note: You can also press [Control]-[Z] on the keyboard to - undo.

- -
+ +

Note: You can also press [Control]-[Z] on the keyboard to + undo.

+ +
-
+
Redo
- +

Clicking this tool will redo the drawing action you just "undid" - with the 'Undo' button.

+ with the 'Undo' button.

As long as you don't draw again, you can redo as many times as you had "undone!"

- -

Note: You can also press [Control]-[R] on the keyboard to - redo.

- -
+ +

Note: You can also press [Control]-[R] on the keyboard to + redo.

+ +
-
+
New
- +

Clicking the "New" button will start a new drawing. A dialog will appear where you may choose to start a new picture using a solid background color, or using a 'Starter' image (see below). You will first be asked whether you really want to do this.

-

Note: You can also press [Control]-[N] on the keyboard to +

Note: You can also press [Control]-[N] on the keyboard to start a new drawing.

- + 'Starter' Images -
-

'Starters' can be like a page from a coloring book (a - black-and-white outline of a picture, which you can then - color in), or like a 3D photograph, where you draw the bits - in between.

+
+

'Starters' can be like a page from a coloring book (a + black-and-white outline of a picture, which you can then + color in), or like a 3D photograph, where you draw the bits + in between.

-

When you load a 'Starter,' draw on it, and then click 'Save,' +

When you load a 'Starter,' draw on it, and then click 'Save,' it creates a new picture file (it doesn't overwrite the original 'Starter,' so you can use it again later).

-
+
-
+
-
+
Open
- +

This shows you a list of all of the pictures you've saved. - If there are more than can fit on the screen, use the "Up" - and "Down" arrows at the top and bottom of the list to scroll - through the list of pictures.

+ If there are more than can fit on the screen, use the "Up" + and "Down" arrows at the top and bottom of the list to scroll + through the list of pictures.

-
+
-

-

Click a picture to select it, then...

+

Click a picture to select it, then...

  • - +

    Click the green "Open" button at the lower left of the list to - load the selected picture.

    + load the selected picture.

    -

    (Alternatively, you can double-click a picture's icon to load +

    (Alternatively, you can double-click a picture's icon to load it.)

    -
    +
    • -
  • - +
  • +

    Click the brown "Erase" (trash can) button at the lower right of the list to erase the selected picture. (You will be asked to @@ -683,212 +683,212 @@ version

    Note: As of version 0.9.22, the picture will be placed in your desktop's trash can, on Linux only.

    -
    +
  • - +

    Click the blue "Slides" (slide projector) button at the lower left to go to slideshow mode. See "Slides", below, for details.

    -
    +
    • -
  • - +
  • +

    Or click the red "Back" arrow button at the lower right of the - list to cancel and return to the picture you were drawing.

    + list to cancel and return to the picture you were drawing.

    -
    +
-

If choose to open a picture, and your current drawing hasn't been - saved, you will be prompted as to whether you want to save it or not. - (See "Save," below.)

- -

Note: You can also press [Control]-[O] on the keyboard to get +

If choose to open a picture, and your current drawing hasn't been + saved, you will be prompted as to whether you want to save it or not. + (See "Save," below.)

+ +

Note: You can also press [Control]-[O] on the keyboard to get the 'Open' dialog.

- -
+ +
-
+
Save
- +

This saves your current picture.

- -

If you haven't saved it before, it will create a new entry in - the list of saved images. (i.e., it will create a new file)

+ +

If you haven't saved it before, it will create a new entry in + the list of saved images. (i.e., it will create a new file)

-

Note: It won't ask you anything (e.g., for a filename). - It will simply save the picture, and play a "camera shutter" sound - effect.

+

Note: It won't ask you anything (e.g., for a filename). + It will simply save the picture, and play a "camera shutter" sound + effect.

-

If you HAVE saved the picture before, or this is a picture you - just loaded using the "Open" command, you will first be asked - whether you want to save over the old version, or create a new - entry (a new file).

+

If you HAVE saved the picture before, or this is a picture you + just loaded using the "Open" command, you will first be asked + whether you want to save over the old version, or create a new + entry (a new file).

-

-

(NOTE: If either the "saveover" or +

(NOTE: If either the "saveover" or "saveovernew" options are set, it won't ask before saving over. - See the "Options" - documentation.)

- -

Note: You can also press [Control]-[S] on the keyboard to - save.

- -
+ See the "Options" + documentation.)

+ +

Note: You can also press [Control]-[S] on the keyboard to + save.

+ +
-
+
Print
- +

Click this button and your picture will be printed!

- -

On most platforms, you can also hold the [Alt] key + +

On most platforms, you can also hold the [Alt] key (called [Option] on Macs) while clicking the 'Print' button to get a printer dialog. Note that this may not work if you're - running Tux Paint in fullscreen mode. See below.

+ running Tux Paint in fullscreen mode. See below.

-
Disabling Printing
-
-

If the "noprint" option was set (either with +

Disabling Printing
+
+

If the "noprint" option was set (either with "noprint=yes" in Tux Paint's configuration file, or using "--noprint" on the - command-line), the "Print" button will be disabled.

+ command-line), the "Print" button will be disabled.

-

See the "Options" - documentation.)

-
- +

See the "Options" + documentation.)

+
+ -
Restricting Printing
-
-

If the "printdelay" option was used (either with - "printdelay=SECONDS" in the configuration file, +

Restricting Printing
+
+

If the "printdelay" option was used (either with + "printdelay=SECONDS" in the configuration file, or using "--printdelay=SECONDS" on the command-line), you can only print once every SECONDS seconds.

-

For example, with "printdelay=60", you can print only +

For example, with "printdelay=60", you can print only once a minute.

-

See the "Options" - documentation.)

-
+

See the "Options" + documentation.)

+ - -
Printing Commands
-
-

(Linux and Unix only)

+ +
Printing Commands
+
+

(Linux and Unix only)

-

Tux Paint prints by generating a PostScript - representation of the drawing and sending it to an external - program. By default, the program is:

+

Tux Paint prints by generating a PostScript + representation of the drawing and sending it to an external + program. By default, the program is:

- lpr -
+ lpr + -

This command can be changed by setting the "printcommand" value - in Tux Paint's configuration file.

+

This command can be changed by setting the "printcommand" value + in Tux Paint's configuration file.

-

If the [Alt] key on the keyboard is being pushed - while clicking the 'Print' button, as long as you're not in - fullscreen mode, an alternative program is run. By default, - the program is KDE's graphical print dialog:

+

If the [Alt] key on the keyboard is being pushed + while clicking the 'Print' button, as long as you're not in + fullscreen mode, an alternative program is run. By default, + the program is KDE's graphical print dialog:

- kprinter -
+ kprinter + -

This command can be changed by setting the "altprintcommand" value - in Tux Paint's configuration file.

+

This command can be changed by setting the "altprintcommand" value + in Tux Paint's configuration file.

-

For information on how to change the printing commands, - see the "Options" - documentation.

-
+

For information on how to change the printing commands, + see the "Options" + documentation.

+ -
Printer Settings
-
-

(Windows and macOS)

+
Printer Settings
+
+

(Windows and macOS)

-

By default, Tux Paint simply prints to the default - printer with default settings when the 'Print' button is - pushed.

+

By default, Tux Paint simply prints to the default + printer with default settings when the 'Print' button is + pushed.

-

However, if you hold the [Alt] (or [Option]) key +

However, if you hold the [Alt] (or [Option]) key on the keyboard while pushing the button, as long as you're not in fullscreen mode, your operating system's printer dialog will appear, where you can change the settings.

-

You can have the printer configuration changes stored - by using the "printcfg" option, either by using - "--printcfg" on the command-line, or - "printcfg=yes" in Tux Paint's own configuration - file ("tuxpaint.cfg").

+

You can have the printer configuration changes stored + by using the "printcfg" option, either by using + "--printcfg" on the command-line, or + "printcfg=yes" in Tux Paint's own configuration + file ("tuxpaint.cfg").

-

If the "printcfg" option is used, printer settings will - be loaded from the file "print.cfg" in your - personal folder (see below). - Any changes will be saved there as well.

- -

See the "Options" - documentation.)

-
+

If the "printcfg" option is used, printer settings will + be loaded from the file "print.cfg" in your + personal folder (see below). + Any changes will be saved there as well.

+ +

See the "Options" + documentation.)

+ -
Printer Dialog Options
-
-

By default, Tux Paint only shows the printer dialog - (or, on Linux/Unix, runs the "altprintcommand", e.g., - "kprinter" instead of "lpr") if the [Alt] +

Printer Dialog Options
+
+

By default, Tux Paint only shows the printer dialog + (or, on Linux/Unix, runs the "altprintcommand", e.g., + "kprinter" instead of "lpr") if the [Alt] (or [Option]) key is held while clicking the 'Print' button.

-

However, this behavior can be changed. You can have the - printer dialog always appear by using - "--altprintalways" on the command-line, or - "altprint=always" in Tux Paint's configuration - file. Or, you can prevent the [Alt]/[Option] +

However, this behavior can be changed. You can have the + printer dialog always appear by using + "--altprintalways" on the command-line, or + "altprint=always" in Tux Paint's configuration + file. Or, you can prevent the [Alt]/[Option] key from having any effect by using "--altprintnever", or - "altprint=never".

- -

See the "Options" - documentation.)

-
- -
-
+ "altprint=never".

+ +

See the "Options" + documentation.)

+ + + +
-
+
Slides (under "Open")
- +

The "Slides" button is available in the "Open" dialog. It displays a list of your saved files, just like the "Open" dialog.

@@ -926,64 +926,64 @@ version

Click "Back" in the slideshow image selection screen to return to the "Open" dialog.

-
+
Quit
- +

Clicking the "Quit" button, closing the Tux Paint window, or pushing the [Escape] key will quit Tux Paint.

- +

You will first be prompted as to whether you really want to quit.

If you choose to quit, and you haven't saved the current picture, - you will first be asked if wish to save it. If it's not a new image, - you will then be asked if you want to save over the old version, - or create a new entry. (See "Save" above.)

+ you will first be asked if wish to save it. If it's not a new image, + you will then be asked if you want to save over the old version, + or create a new entry. (See "Save" above.)

-

NOTE: If the image is saved, it will be reloaded automatically - the next time you run Tux Paint!

+

NOTE: If the image is saved, it will be reloaded automatically + the next time you run Tux Paint!

-

NOTE: The "Quit" button and [Escape] key can be - disabled (e.g., by selecting "Disable 'Quit' Button" in - Tux Paint Config. or running Tux Paint - with the "--noquit" command-line option).

- -

In that case, the "window close" button on - Tux Paint's title bar (if not in fullscreen mode) or - the [Alt] + [F4] key sequence may be used - to quit.

+

NOTE: The "Quit" button and [Escape] key can be + disabled (e.g., by selecting "Disable 'Quit' Button" in + Tux Paint Config. or running Tux Paint + with the "--noquit" command-line option).

+ +

In that case, the "window close" button on + Tux Paint's title bar (if not in fullscreen mode) or + the [Alt] + [F4] key sequence may be used + to quit.

-

If neither of those are possible, the key sequence of - [Shift] + [Control] + [Escape] - may be used to quit. (See the - "Options" documentation.)

- -
+

If neither of those are possible, the key sequence of + [Shift] + [Control] + [Escape] + may be used to quit. (See the + "Options" documentation.)

+ +
Sound Muting

There is no on-screen control button at this time, but - by pressing [Alt] + [S], sound effects - can be disabled and re-enabled (muted and unmuted) while the - program is running.

+ by pressing [Alt] + [S], sound effects + can be disabled and re-enabled (muted and unmuted) while the + program is running.

-

Note that if sounds are completely disabled - (e.g., by unselecting "Enable Sound Effects" in - Tux Paint Config or running Tux Paint - with the "--nosound" command-line option), - the [Alt] + [S] key sequence has no - effect. (i.e., it cannot be used to turn on sounds when the - parent/teacher wants them disabled.)

+

Note that if sounds are completely disabled + (e.g., by unselecting "Enable Sound Effects" in + Tux Paint Config or running Tux Paint + with the "--nosound" command-line option), + the [Alt] + [S] key sequence has no + effect. (i.e., it cannot be used to turn on sounds when the + parent/teacher wants them disabled.)

-
+

Loading Other Pictures into Tux Paint

@@ -1110,7 +1110,7 @@ version window (e.g., 640, 800 or 1024 pixels), minus 192.

Calculating the height of Tux Paint's canvas requires multiple - steps: + steps:

  1. Take the height of the window (e.g, 480, 600 or 768 pixels) and subtract 144
    2. @@ -1119,28 +1119,28 @@ version simply 9)
  2. Take the result of Step 3 and multiply it by 48
  3. Finally, take the result of Step 4 and add 40
    4. -

+

Example: Tux Paint running at fullscreen on a 1440x900 - display. + display.

  • The canvas width is simply 1440 - 192, or 1248.
  • The canvas height is calculated as:
      -
    1. 900 - 144, or 756 -
    2. 756 / 48, or 15.75 -
    3. 15.75 rounded down, or 15 -
    4. 15 * 48, or 720 -
    5. 720 + 40, or 760 +
    6. 900 - 144, or 756
      7. +
    7. 756 / 48, or 15.75
      8. +
    8. 15.75 rounded down, or 15
      9. +
    9. 15 * 48, or 720
      10. +
    10. 720 + 40, or 760
- So the canvas within a 1440x900 Tux Paint window is 1248x760.

+

So the canvas within a 1440x900 Tux Paint window is 1248x760.

-
+

Further Reading

@@ -1195,7 +1195,7 @@ version -
+

How to Get Help