Commit 4d5b3905 authored by luzpaz's avatar luzpaz Committed by Alexandre Prokoudine
Browse files

Proofreading

parent 73f26b4c
......@@ -7,14 +7,15 @@
The GIMP documentation project is mainly working with docbook xml files
to create the GIMP manual / online help. Since there are different
approaches how to create and edit such files as well as different tools
involved, there is a strong need for the xml files being well formated.
involved, there is a strong need for the xml files being well formatted.
Additionally there are a couple of technical reasons (diff, cvs) that
suggest a general styleguide for the xml files. This is a recommendation
for such a styleguide. Its mainly based on the styles that can be found
suggest a general style guide for the xml files. This is a recommendation
for such a style guide. Its mainly based on the styles that can be found
in xml files that build the current documentation, as well as on the
discussion on the gimp-doc mailing list.
2. XML styleguide by rules
2. XML style guide by rules
§1. General
§1.1. All docbook files for the documentation need to be well formed and
have to comply validation against
......@@ -42,15 +43,16 @@
§4.3. The languages encoded in the lang attributes appear in alphabetical
order of the language codes
§5. Indention
§5. Indentation
§5.1. Space or tab characters can be used for indentation, but it is higly
recommended not to mix space and tab character usage in one single xml
file.
§5.2. Indention width is two spaces (0x20). One tab (0x09) is equivalent
§5.2. Indentation width is two spaces (0x20). One tab (0x09) is equivalent
to 8 spaces (0x20).
§5.3. Indention is done for the content of all tags that start a new line
§5.3. Indentation is done for the content of all tags that start a new line
3 XML style guide by example
2 XML styleguide by example
Example for §1 General
Following the rules in §1 each xml file of the GIMP manual starts with:
......@@ -70,7 +72,7 @@
Example for §4. Element attributes
// to be done
Example for §5. Indention
Example for §5. Indentation
// to be done
Appendix I Inline elements
......
......@@ -54,7 +54,7 @@ AC_PROG_SED
# LANGUAGES will override ALL_LINGUAS
#
# Quickreference files are built for languages in
# QUICKREFERENCE_ALL_LINGUAS *and* (intersecton) ALL_LINGUAS
# QUICKREFERENCE_ALL_LINGUAS *and* (intersection) ALL_LINGUAS
if test "x$ALL_LINGUAS" = "x"; then
ALL_LINGUAS="ca da de el en en_GB es fi fr it ja ko nl nn pt_BR ro ru zh_CN"
......@@ -160,7 +160,7 @@ AC_SUBST(XML2POFLAGS)
AC_PATH_PROG(MSGFMT, msgfmt)
if test -z "$MSGFMT" && test "x$enable_i18n" = "xyes"; then
# print warning only for the main i18n toos xml2po & msgfmt
# print warning only for the main i18n tools xml2po & msgfmt
AC_MSG_WARN([cannot find msgfmt])
missing_i18n_tools=${missing_i18n_tools:+"${missing_i18n_tools} "}msgfmt
fi
......@@ -276,7 +276,7 @@ AM_CONDITIONAL(HAVE_PNGOPTIMIZERS, test -n "$PNGNQ" && test -n "$PNGCRUSH")
STYLEBASE='http://docbook.sourceforge.net/release/xsl/current'
# Allow to explicitely specify the stylesheet location
# Allow to explicitly specify the stylesheet location
# in case the XML catalog doesn't exist or is broken.
AC_ARG_WITH(xsl,
......
......@@ -128,8 +128,8 @@
<para>
As in every dialog that contains preview icons, you can control the
preview images in the tab menu. To get mor informations about that
topic read <xref linkend="gimp-concepts-docks" />.
preview images in the tab menu. To get more information about that
topic please read <xref linkend="gimp-concepts-docks" />.
</para>
</sect4>
......
......@@ -91,7 +91,7 @@ if ($Verbose > 1) {
"Mode(s) = ", join(' ', @Mode), "\n";
}
# Check for existance of directories:
# Check for existence of directories:
foreach (@Srcdirs, $Destdir) {
die "Error: no such directory: $_\n" unless -d
}
......@@ -140,7 +140,7 @@ sub get_copy_command {
}
}
# Subroutine for (re)setting coyp/link mode
# Subroutine for (re)setting copy/link mode
sub set_copy_mode {
if (defined($exec_copy_command)) {
# Fallback
......@@ -172,7 +172,7 @@ foreach my $srcdir (sort @Image_dirs) {
next unless -f $imgfile;
my $basename = (splitpath($imgfile))[2]; # (vol, dir, file)
my $destfile = catfile($dstdir, $basename); # the new file/link
# Check for existance of localized image:
# Check for existence of localized image:
if ($Localize_images) {
(my $localized_imgfile = $imgfile) =~ s|/C/|/$Language/|o;
$inc_i18n = (-e $localized_imgfile) ? 1 : 0;
......
......@@ -62,7 +62,7 @@ Special (helper) targets for build-system development:
dot Create a visualized version of the Makefile dependencies
(this may be not up-to-date!)
Make variables (can be overriden at command-line):
Make variables (can be overridden at command-line):
LINGUAS="..." Space-separated list of manual languages (e.g. "en de fr"),
restricted to ALL_LINGUAS=%ALL_LINGUAS%
LANGUAGES="..." Space-separated list of manual languages (e.g. "en de fr"),
......
......@@ -29,5 +29,5 @@ You can update the <LANG-CODE>.po files with make:
Bugs
-----
There is currently no sane way to integrate the Docbook version in the
manual. Either the seperated files will be integrated via xincludes or
manual. Either the separated files will be integrated via xincludes, or
the stylesheet needs to be adjusted to put each translation in one file.
......@@ -550,7 +550,7 @@
the category's name (Devel) to open the package list. Search down the
rightmost column to find the package name <quote>automake 1.12</quote>.
Click once on the word <quote>Skip</quote>. The text will change to
<quote>1.12.3-1</quote> which is the version number for the choosed
<quote>1.12.3-1</quote> which is the version number for the chosen
package. Do the same with the other packages in the list above. Some
packages will be marked <quote>Keep</quote> instead of <quote>Skip
</quote>. This means that these packages already are installed. Do not
......
......@@ -164,7 +164,7 @@
<listitem>
<para>
Below, a color swatch shows the color pointed by the mouse
cursor. Informations about this color and helpful hints or
cursor. Information about this color and helpful hints or
feedback messages may appear here.
</para>
</listitem>
......@@ -709,7 +709,7 @@
<caption>
<para>
Red has been chosen for left endpoint and yellow for the right
enpoint.
endpoint.
</para>
</caption>
</mediaobject>
......
......@@ -273,7 +273,7 @@
</para>
<note>
<para>
Some of the listed pop-menu entries are installation dependend
Some of the listed pop-menu entries are installation-dependent
and need the <ulink url="http://www.python.org">Python language
interpreter</ulink> to be installed. This includes at the
time of writing: <link linkend="gimp-palette-offset">Offset
......
......@@ -233,7 +233,7 @@
displayed on screen rather than by a black/white printer.
So it is often useful to apply a little anti-aliasing to
simulate ink smearing on paper. If you do want to print the
resulting image then set the antialising to 1 (ie, off).
resulting image then set the antialiasing to 1 (i.e., off).
</para>
<variablelist>
<varlistentry>
......
......@@ -13,7 +13,7 @@
2007-05-06 KoSt: added 'no'
2006-12-12 lexa: added german translation
2005-12-07 replaced <simplesect> by <sect3> by lexa
2005-10-14 ceated by julien hardelin
2005-10-14 created by julien hardelin
-->
<sect2 id="gimp-filter-displace">
<title>Displace</title>
......
......@@ -28,9 +28,9 @@
defined areas are enabled by the pointer. Obviously the most used effect
is a dynamic link to another web page when one of the sensitive areas is
clicked on. This <quote>filter</quote> allows you to design easily
sensitive areas within an image. Web site design softwares have this as a
standard function. In <acronym>GIMP</acronym> you can do this in a similar
way.
sensitive areas within an image. Applications for website design have this
as a standard function. In <acronym>GIMP</acronym>, you can do this in a
similar way.
</para>
<sect3>
......
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE glossary PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd">
<glossary id="glossary">
......@@ -469,7 +469,7 @@ https://git.gnome.org/browse/gimp-help-2/tree/docs folder-->
<para>
This is the mode used in printing. These are the colors in the ink
cartridges in your printer. It is the mode used in painting and in all
the objects around us, where light is reflected, not emmitted. Objects
the objects around us, where light is reflected, not emitted. Objects
absorb part of the light waves and we see only the reflected part.
Note that the cones in our eyes see this reflected light in RGB mode.
An object appears Red because Green and Blue have been absorbed. Since
......@@ -2545,7 +2545,7 @@ fileref="images/dialogs/examples/layer-groups-pass-through-ex6.png"/>
along with the black-and-white signal, in order to achieve backwards
compatibility with old black and white televisions without having to
increase the available transmission bandwidth. From the YUV color
model of the analog television techiques, the YCrCb color model was
model of the analog television techniques, the YCrCb color model was
developed, which is used for most kinds of digital image and video
compression. Erroneously, the YUV color model is also often spoken
about in those fields, although the YCbCr model is actually used.
......
......@@ -206,7 +206,7 @@
</para>
<para>
This option might be useful to transfer image into printing
softwares with CMY capabilities.
software with CMY capabilities.
</para>
</listitem>
</varlistentry>
......@@ -219,7 +219,7 @@
</para>
<para>
This option might be useful to transfer image into printing
softwares with CMYK capabilities.
software with CMYK capabilities.
</para>
</listitem>
</varlistentry>
......
......@@ -173,7 +173,7 @@
The pointer x/y position is permanently displayed in the top
left part of the grid. By default, this curve is straight,
because every input level corresponds to the same
ouput tone. GIMP automatically places an anchor at both
output tone. GIMP automatically places an anchor at both
ends of the curve, for black (0) and white (255).
</para>
<para>
......
......@@ -149,7 +149,7 @@
Then press <keycap>Enter</keycap> to execute the command.
</para>
<para>
You can (and should!) use the constants you find in the decription
You can (and should!) use the constants you find in the description
of the procedure's parameters, for example
<quote>RGB-IMAGE</quote> or <quote>OVERLAY-MODE</quote>. But note
that you have to replace hyphens (<quote>-</quote>) with
......
......@@ -35,7 +35,7 @@
</figure>
<para>
When you add text to an image, <acronym>GIMP</acronym> adds specific
informations. This command lets you discard these informations,
information. This command lets you discard this information,
transforming the current text layer into a normal bitmap layer. The
reason to do that is not evident.
</para>
......
......@@ -15,9 +15,8 @@
</indexterm>
<para>
This command enables and disables showing the sample points in the image
window. Sample points are used to display color informations of up to four
pixels in the <link linkend="gimp-sample-point-dialog">sample points
dialog</link>.
window. Sample points are used to display color information in the
<link linkend="gimp-sample-point-dialog">sample points dialog</link>.
</para>
<sect3>
......
......@@ -49,7 +49,7 @@
<listitem>
<para>
<emphasis>Under Linux</emphasis>:
home/YourUserName/.mypaint/brushes. Take good note it is a hidden
/home/YourUserName/.mypaint/brushes. Take good note it is a hidden
directory.
</para>
<para>
......@@ -58,20 +58,20 @@
exist yet, you have to create it, with the brushes directory inside.
</para>
<para>
Copy-paste all the unziped files from your temp folder to
Copy-paste all the unzipped files from your temp folder to
home/YourUserName/.mypaint/brushes.
</para>
</listitem>
<listitem>
<para>
<emphasis>Under Windows 10 (and gimp-2.9.5)</emphasis>:
<emphasis>Under Windows 10 (and GIMP 2.10)</emphasis>:
~\.mypaint\brushes. Click on this item to select it and click on
the icon that opens a file browser. In the root of your home folder,
create a new folder"mypaint". The Mypaint path in Preferences
create a new folder"mypaint". The MyPaint path in Preferences
becomes C:\Users\your-user-name\mypaint.
</para>
<para>
Copy-paste all the unziped files from your temp folder to
Copy-paste all the unzipped files from your temp folder to
C:\Users\your-user-name\mypaint.
</para>
</listitem>
......
......@@ -7,7 +7,7 @@
2008-02-05 j.h : updated fr to v2.4 and enhanced align modes
examples for 'en' and 'fr'
2008-01-18 ude: enhanced(?) align mode examples
2007-05-23 Rebuilt Aligment section by j.h
2007-05-23 Rebuilt Alignment section by j.h
2006-02-05 fr revised; shortcut modified in "en" by j.h
2005-12-07 replaced <simplesect> by <sect3> by lexa
2005-11-30 replaced informalfigure by figure by lexa
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment