diff --git a/reference_manual/audio_for_animation.rst b/reference_manual/audio_for_animation.rst
index 3229f2de4..f678334ea 100644
--- a/reference_manual/audio_for_animation.rst
+++ b/reference_manual/audio_for_animation.rst
@@ -1,67 +1,67 @@
 .. meta::
    :description:
         The audio playback with animation in Krita.
 
 .. metadata-placeholder
 
    :authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
              - Scott Petrovic
              - Marcidy
    :license: GNU free documentation license 1.3 or later.
 
 .. index:: Animation, Audio, Sound, Timeline
 .. _audio_animation:
 
 ===================
 Audio for Animation
 ===================
 
 .. caution::
 
     Audio for animation is an unfinished feature. It has multiple bugs and may not work on your system.
 
 You can add audio files to your animation to help sync lips or music. This functionality is available in the timeline docker.
 
 Importing Audio Files
 ---------------------
 
 Krita supports MP3, OGM, and WAV audio files. When you open up your timeline docker, there will be a speaker button in the top left area.
 
 If you press the speaker button, you will get the available audio options for the animation.
 
 * Open
 * Mute
 * Remove audio
 * Volume slider
 
 Krita saves the location of your audio file. If you move the audio file or rename it, Krita will not be able to find it. Krita will tell you the file was moved or deleted the next time you try to open the Krita file up.
 Using Audio
 
 After you import the audio, you can scrub through the timeline and it will play the audio chunk at the time spot. When you press the Play button, the entire the audio file will playback as it will in the final version. There is no visual display of the audio file on the screen, so you will need to use your ears and the scrubbing functionality to position frames.
 
 
 Exporting with Audio
 --------------------
 
 To get the audio file included when you are exporting, you need to include it in the Render Animation options. In the :menuselection:`File --> Render Animation` options there is a checkbox :guilabel:`Include Audio`. Make sure that is checked before you export and you should be good to go.
 
 Packages needed for Audio on Linux
 ----------------------------------
 
-The following packages are necessary for havng the audio support on Linux:
+The following packages are necessary for having the audio support on Linux:
 
 
 For people who build Krita on Linux:
 
 * libasound2-dev
 * libgstreamer1.0-dev gstreamer1.0-pulseaudio
 * libgstreamer-plugins-base1.0-dev
 * libgstreamer-plugins-good1.0-dev
 * libgstreamer-plugins-bad1.0-dev
 
 For people who use Krita on Linux:
 
 * libqt5multimedia5-plugins
 * libgstreamer-plugins-base1.0
 * libgstreamer-plugins-good1.0
 * libgstreamer-plugins-bad1.0
diff --git a/reference_manual/brushes/brush_engines/dyna_brush_engine.rst b/reference_manual/brushes/brush_engines/dyna_brush_engine.rst
index e649199ca..d82c02168 100644
--- a/reference_manual/brushes/brush_engines/dyna_brush_engine.rst
+++ b/reference_manual/brushes/brush_engines/dyna_brush_engine.rst
@@ -1,68 +1,68 @@
 .. meta::
    :description:
         The Dyna Brush Engine manual page.
 
 .. metadata-placeholder
 
    :authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
              - Scott Petrovic
    :license: GNU free documentation license 1.3 or later.
 
 .. _dyna_brush_engine:
 
 =================
 Dyna Brush Engine
 =================
 
 .. image:: /images/icons/dynabrush.svg
 
-Dyna brush uses dynamic setting like mass and drag to draw strokes. The results are fun and random spinning strokes.To experiment more with this brush you can play with values in 'dynamic settings' section of the brush editor under Dyna Brush.
+Dyna brush uses dynamic setting like mass and drag to draw strokes. The results are fun and random spinning strokes. To experiment more with this brush you can play with values in 'dynamic settings' section of the brush editor under Dyna Brush.
 
 .. deprecated:: 4.0
     
     This brush engine has been removed in 4.0. This engine mostly had smoothing results that the dyna brush tool has in the toolbox. The stabilizer settings can also give you further smoothing options from the tool options.
 
 Options
 -------
 
 * :ref:`option_size_dyna`
 * :ref:`blending_modes`
 * :ref:`option_opacity_n_flow`
 * :ref:`option_airbrush`
 
 .. _option_size_dyna:
 
 Brush Size (Dyna)
 -----------------
 
 Dynamics Settings
 ~~~~~~~~~~~~~~~~~
 
 Initial Width
     Initial size of the dab.
 Mass
     How much energy there is in the satellite like movement.
 Drag
     How close the dabs follow the position of the brush-cursor.
 Width Range
     How much the dab expands with speed.
 
 Shape
 ~~~~~
 
 Diameter
     Size of the shape.
 Angle
     Angle of the shape. Requires Fixed Angle active to work.
 Circle
     Make a circular dab appear.
 Two
     Draws an extra circle between other circles.
 Line
     Connecting lines are drawn next to each other. The number boxes on the right allows you to set the spacing between the lines and how many are drawn.
 Polygon
     Draws a black polygon as dab.
 Wire
     Draws the wireframe of the polygon.
 Paint Connection
     Draws the connection line.
diff --git a/reference_manual/dr_minw_debugger.rst b/reference_manual/dr_minw_debugger.rst
index ecce0ef0d..160ee4bb8 100644
--- a/reference_manual/dr_minw_debugger.rst
+++ b/reference_manual/dr_minw_debugger.rst
@@ -1,79 +1,79 @@
 .. meta::
    :description:
         How to get a backtrace in Krita using the dr. MinW debugger.
 
 .. metadata-placeholder
 
    :authors: - Scott Petrovic
              - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
              - Raghavendra Kamath <raghavendr.raghu@gmail.com>
              - Alvin Wong
    :license: GNU free documentation license 1.3 or later.
 
 .. index:: Backtrace, Debug
 .. _dr_minw:
 
 =================
 Dr. MinW Debugger
 =================
 
 .. note::
 
     The information on this page applies only to the Windows release of Krita 3.1 Beta 3 (3.0.92) and later.
 
 
 Getting a Backtrace
 -------------------
 
 There are some additions to Krita which makes getting a backtrace much easier on Windows.
 
 #.
         
     When there is a crash, Krita might appear to be unresponsive for a short time, ranging from a few seconds to a few minutes, before the crash dialog appears.
     
     .. figure:: /images/en/Mingw-crash-screen.png
     
         An example of the crash dialog
         
     * If Krita keeps on being unresponsive for more than a few minutes, it might actually be locked up, which may not give a backtrace. In that situation, you have to close Krita manually. Continue to follow the following instructions to check whether it was a crash or not.<div style="clear: both"></div>
 
-#. Open Windows Explorer and type ``%LocalAppData%`` (without quotes) on the address bar and press Enter.
+#. Open Windows Explorer and type ``%LocalAppData%`` (without quotes) on the address bar and press :kbd:`Enter`.
 
     .. image:: /images/en/Mingw-explorer-path.png
     
 #. Find the file ``kritacrash.log`` (it might appear as simply ``kritacrash`` depending on your settings.) 
 #. Open the file with Notepad and scroll to the bottom, then scroll up to the first occurrence of “Error occurred on <time>” or the dashes.
 
     .. figure:: /images/en/Mingw-crash-log-start.png
     
         Start of backtrace
 
     Check the time and make sure it matches the time of the crash. 
     
     .. figure:: /images/en/Mingw-crash-log-end.png
         
         End of backtrace
             
     The text starting from this line to the end of the file is the most recent backtrace.
     
     * If ``kritacrash.log`` does not exist, or a backtrace with a matching time does not exist, then you don’t have a backtrace. This means Krita was very likely locked up, and a crash didn’t actually happen. In this case, make a bug report too.
     * If the backtrace looks truncated, or there is nothing after the time, it means there was a crash and the crash handler was creating the stack trace before being closed manually. In this case, try to re-trigger the crash and wait longer until the crash dialog appears.
 
 .. note::
 
     Starting from Krita 3.1 Beta 3 (3.0.92), the external DrMingw JIT debugger is not needed for getting the backtrace.
 
 Using the Debug Package
 -----------------------
 
 Starting from 3.1 Beta 3, the debug package contains only the debug symbols separated from the executables, so you have to download the portable package separately too (though usually you already have it in the first place.)
 
 * Links to the debug packages should be available on the release announcement news item on https://krita.org/, along with the release packages. You can find debug packages for any release either in https://download.kde.org/stable/krita for stable releases or in https://download.kde.org/unstable/krita for unstable releases. Portable zip and debug zip are found next to each other.
 * Make sure you’ve downloaded the same version of debug package for the portable package you intend to debug / get a better (sort of) backtrace.
 * Extract the files inside the Krita install directory, where the sub-directories `bin`, `lib` and `share` is located, like in the figures below:
 
     .. image:: /images/en/Mingw-dbg7zip.png
     
     .. image:: /images/en/Mingw-dbg7zip-dir.png
 
 * After extracting the files, check the ``bin`` dir and make sure you see the ``.debug`` dir inside. If you don't see it, you probably extracted to the wrong place.
diff --git a/reference_manual/linux_command_line.rst b/reference_manual/linux_command_line.rst
index d6884cf0f..26693490d 100644
--- a/reference_manual/linux_command_line.rst
+++ b/reference_manual/linux_command_line.rst
@@ -1,128 +1,128 @@
 .. meta::
    :description:
         Overview of Krita's command line options.
 
 .. metadata-placeholder
 
    :authors: - Scott Petrovic
              - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
    :license: GNU free documentation license 1.3 or later.
 
 .. index:: Command Line
 .. _linux_cmd:
 
 ==================
 Linux Command Line
 ==================
 
 
 
 As a native Linux program, Krita allows you to do operations on images without opening the program when using the Terminal. This option was disabled on Windows and OSX, but with 3.3 it is enabled for them!
 
 This is primarily used in bash or shell scripts, for example, to mass convert kra files into pngs.
 
 Export
 ------
 
 This allows you to quickly convert files via the terminal:
 
 ``krita importfilename --export --export-filename exportfilename``
 
 .. program:: krita
 
 importfilename
     Replace this with the filename of the file you want to manipulate.
 
 .. option:: --export
    
    Export a file selects the export option.
 
 .. option:: --exportfilename
    
    Exportfilename says that the following word is the filename it should be exported to.
 
    Replace this with the name of the output file. Use a different extension to change the fileformat.
 
 Example:
 
-``krita final.png --export --export-filename final.jpg``
+``krita file.png --export --export-filename final.jpg``
 
-This piece of code takes the file ``file.png`` and saves it as ``file.jpg``.
+This piece of code takes the file ``file.png`` and saves it as ``final.jpg``.
 
 PDF export
 ----------
 
 Pdf export looks a bit different, using the ``--export-pdf`` option.
 
-``krita final.png --export-pdf --export-filename final.pdf``
+``krita file.png --export-pdf --export-filename final.pdf``
 
 export-pdf exports the file ``file.png`` as a pdf file.
 
 .. warning::
     
     This has been removed from 3.1 because the results were incorrect.
 
 Open with Custom Screen DPI
 ---------------------------
 
 Open Krita with specified Screen DPI.
 
 .. program:: krita
 
 .. option:: --dpi <dpiX,dpiY>
    
    Open Krita with specified Screen DPI.
 
    For example:
 
    ``krita --dpi <72,72>``
 
 Open template
 -------------
 
 Open krita and automatically open the given template(s). This allows you to, for example, create a shortcut to Krita that opens a given template, so you can get to work immediately!
 
 ``krita --template templatename.desktop``
 
 .. program:: krita
 
 .. option:: --template templatename.desktop
 
    Selects the template option
 
-   All templates are saved with the .desktop extension. You can find templates in the .kde/share/apps/krita/template or in the install folder of Krita.
+   All templates are saved with the .desktop extension. You can find templates in the .local/share/krita/template or in the install folder of Krita.
 
    ``krita --template BD-EuroTemplate.desktop``
 
    This opens the European BD comic template with Krita.
 
    ``krita --template BD-EuroTemplate.desktop BD-EuroTemplate.desktop``
 
    This opens the European BD template twice, in separate documents.
 
 Start up
 --------
 
 .. versionadded:: 3.3
 
     .. program:: krita
     
     .. option:: --nosplash
     
        starts krita without showing the splash screen.
     
     .. option:: --canvasonly
     
        starts krita in canvasonly mode.
     
     .. option:: --fullscreen
     
        starts krita in fullscreen mode.
     
     .. option:: --workspace Workspace
     
        starts krita with the given workspace. So for example...
     
         `` krita --workspace Animation``
         
         Starts Krita in the Animation workspace.
diff --git a/reference_manual/preferences/general_settings.rst b/reference_manual/preferences/general_settings.rst
index 7f713919e..b1f6cdbfa 100644
--- a/reference_manual/preferences/general_settings.rst
+++ b/reference_manual/preferences/general_settings.rst
@@ -1,214 +1,214 @@
 .. meta::
    :description:
         General Preferences in Krita.
 
 .. metadata-placeholder
 
    :authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
              - Scott Petrovic
              - Greig
    :license: GNU free documentation license 1.3 or later.
 
 .. index:: Preferences, Settings, Cursor, Autosave, Tabbed Documents, Subwindow Documents, Pop up palette, File Dialog, Maximum Brush Size, Kinetic Scrolling, Sessions
 .. _general_settings:
 
 ================
 General Settings
 ================
 
 You can access the General Category of the preferences by first going to  :menuselection:`Settings --> Configure Krita`.
 
     .. image:: /images/en/Krita_Preferences_General.png
 
 Cursor Settings
 ---------------
 
 Customize the drawing cursor here:
 
 Cursor Shape
 ~~~~~~~~~~~~
 
 Select a cursor shape to use while the brush tools are used. This cursor will always be visible on the canvas. It is usually set to a type exactly where your pen nib is at. The available cursor types are shown below.
 
 Tool Icon
-    Shows the currently selected tool icon,even for the freehand brush. 
+    Shows the currently selected tool icon, even for the freehand brush. 
     
     .. image:: /images/en/Settings_cursor_tool_icon.png
 
 Arrow
     Shows a generic cursor.
     
     .. image:: /images/en/Settings_cursor_arrow.png
 
 Crosshair
     Shows a precision reticule.
 
     .. image:: /images/en/Settings_cursor_crosshair.png
 
 Small circle
 
     Shows a small white dot with a black outline.
 
     .. image:: /images/en/Settings_cursor_small_circle.png
 
 No Cursor
     Show no cursor, useful for tablet-monitors.
 
     .. image:: /images/en/Settings_cursor_no_cursor.png
 
 Triangle Right-Handed.
 
     Gives a small white triangle with a black border.
 
     .. image:: /images/en/Settings_cursor_triangle_righthanded.png
 
 Triangle Left-Handed.
     Same as above but mirrored.
 
     .. image:: /images/en/Settings_cursor_triangle_lefthanded.png
 
 Black Pixel
     Gives a single black pixel.
 
     .. image:: /images/en/Settings_cursor_black_pixel.png
 
 White Pixel
     Gives a single white pixel.
 
     .. image:: /images/en/Settings_cursor_white_pixel.png
 
 
 Outline Shape
 ~~~~~~~~~~~~~
 
 Select an outline shape to use while the brush tools are used. This cursor shape will optionally show in the middle of a painting stroke as well. The available outline shape types are shown below.(pictures will come soon)
 
 No Outline
     No outline.
 Circle Outline
     Gives a circular outline approximating the brush size.
 Preview Outline
     Gives an outline based on the actual shape of the brush.
 Tilt Outline
     Gives a circular outline with a tilt-indicator.
 
 
 
 While Painting...
 ~~~~~~~~~~~~~~~~~
 
 Show Outline
     This option when selected will show the brush outline while a stroke is being made. If unchecked the brush outline will not appear during stroke making, it will show up only after the brush stroke is finished. This option works only when Brush Outline is selected as the Cursor Shape.
 
     .. versionchanged:: 4.1
 
         Used to be called "Show Outline When Painting"
 
 Use effective outline size
 
     .. versionadded:: 4.1
 
     This makes sure that the outline size will always be the maximum possible brush diameter, and not the current one as affected by sensors such as pressure. This makes the cursor a little less noisy to use.
 
 
 .. _window_settings:
 
 Window Settings
 
 Multiple Document Mode
     This can be either tabbed like :program:`GIMP` or :program:`Painttool Sai`, or subwindows, like :program:`Photoshop`.
 Background image
     Allows you to set a picture background for subwindow mode.
 Window Background
     Set the colour of the subwindow canvas area.
 Don't show contents when moving sub-windows
     This gives an outline when moving windows to work around ugly glitches with certain graphics-cards.
 Show on-canvas popup messages
     Whether or not you want to see the on-canvas pop-up messages that tell you whether you are in tabbed mode, rotating the canvas, or mirroring it.
 Enable Hi-DPI support
     Attempt to use the Hi-DPI support. It is an option because we are still experiencing bugs on windows.
 Allow only one instance of Krita
     An instance is a single entry in your system's task manager. Turning this option makes sure that Krita will check if there's an instance of Krita open already when you instruct it to open new documents, and then have your documents opened in that single instance. There's some obscure uses to allowing multiple instances, but if you can't think of any, just keep this option on.
 
 Tool options
 ------------
 
 In docker (default)
     Gives you the tool options in a docker.
 In toolbar
     Gives you the tool options in the toolbar, next to the brush settings. You can open it with :kbd:`\\`.
 
 Switch Control/Alt Selection Modifiers
     This switches the function of the :kbd:`Ctrl` and :kbd:`Alt` buttons when modifying selections. Useful for those used to Gimp instead of Photoshop, or Lefties without a right-::kbd:`Alt` key on their keyboard.
 
 Enable Touchpainting
     This allows finger painting with capacitive screens. Some devices have both capacitive touch and a stylus, and then this can interfere. In that case, just toggle this.
 
 Kinetic Scrolling (Needs Restart)
     This enables kinetic scrolling for scrollable areas.
 
     .. figure:: /images/en/Krita_4_0_kinetic_scrolling.gif
        :align: center
 
        Kinetic scrolling on the brush chooser drop-down with activation mode set to `guilabel:`On Click Drag`, with this disabled all of these clicks would lead to a brush being selected regardless of drag motion.
 
     Activation
         How it is activated.
 
         Disabled
             Will never activated.
         On Touch Drag
             Will activate if it can recognise a touch event. May not always work.
         On Click Drag
             Will activate when it can recognise a click event, will always work.
 
     Sensitivity
         How quickly the feature activates, this effective determines the length of the drag.
     Show Scrollbar
         Whether to show scrollbars when doing this.
 
 .. _misc_settings:
 
 Miscellaneous
 -------------
 
-When Krita Starts
+When Krita starts
     This is the option for handling user sessions. It has the following options:
 
     Open Default Window
         This opens the regular empty window with the last used workspace.
     Load Previous Session
         Load the last opened session. If you have :guilabel:`Save session when Krita closes` toggled, this becomes the last files you had open and the like.
     Show Session Manager
         Show the session manager directly so you can pick a session.
 
     .. versionadded:: 4.1
 Save session when Krita closes
     Save the current open windows, documents and the like into the current session when closing Krita so you can resume where you left off.
 
     .. versionadded:: 4.1
 Autosave Every
     Here the user can specify how often Krita should autosave the file, you can tick the checkbox to turn it off. For Windows these files are saved in the %TEMP% directory. If you are on Linux it is stored in /home/'username'.
 Compress \*.kra files more.
     This increases the zip compression on the saved Krita files, which makes them lighter on disk, but this takes longer to load.
 Upon importing Images as Layers, convert to the image color space.
     This makes sure that layers are the same color space as the image, necessary for saving to PSD.
 Undo Stack Size
     This is the number of undo commands Krita remembers. You can set the value to 0 for unlimited undos.
 Favorite Presets
     This determines the amount of presets that can be used in the pop-up palette.
 Create Backup File
     When selected Krita will try to save a backup file in case of a crash.
 Hide splash screen on startup.
     This'll hide the splash screen automatically once Krita is fully loaded.
 Enable Native File Dialog
     This allows you to use the system file dialog. By default turned off because we cannot seem to get native file dialogues 100% bugfree.
 Maximum brush size
     This allows you to set the maximum brush size to a size of up to 10.000 pixels. Do be careful with using this, as a 10.000 size pixel can very quickly be a full gigabyte of data being manipulated, per dab. In other words, this might be slow.
 Recalculate animation cache in background.
     Krita will recalculate the cache when you're not doing anything.
 
     .. versionchanged:: 4.1
 
         This is now in the :ref:`performance_settings` under :guilabel:`Animation Cache`.
 
diff --git a/reference_manual/tools/shape_edit.rst b/reference_manual/tools/shape_edit.rst
index 9ef52c06c..b316dc4aa 100644
--- a/reference_manual/tools/shape_edit.rst
+++ b/reference_manual/tools/shape_edit.rst
@@ -1,171 +1,171 @@
 .. meta::
    :description:
         Krita's shape edit tool reference.
 
 .. metadata-placeholder
 
    :authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
              - Scott Petrovic
    :license: GNU free documentation license 1.3 or later.
 
 .. index:: Tools, Vector, Shape Edit
 .. _shape_edit_tool:
 
 ===============
 Shape Edit Tool
 ===============
 
 |toolshapeedit|
 
 The shape editing tool is for editing vector shapes. In Krita versions before 4.0 it would only show up in the docker when you had a vector shape selected. In Krita 4.0, this tool is always visible and has the Shape Properties docker as a part of it.
 
 .. image:: /images/en/Shape-editing-tool-example.png
 
 You can access the Edit Shapes tool by clicking on the icon in the toolbox, but you can also access it by pressing :kbd:`Enter` when in the Shape Selection tool and having a shape selected that can be most efficiently edited with the edit shapes tool (right now, that's all shapes but text).
 
 On Canvas Editing of Shapes
 ---------------------------
 
 As detailed further in the Tool Options, there's a difference between path shapes and specialised vector shapes that make it easy to have perfect ellipses, rectangles and more.
 
 Path Shapes
 ~~~~~~~~~~~
 
 Path shapes can be recognised by the different nodes they have.
 
 Paths in Krita are mostly bezier curves, and are made up of nodes. For straight lines, the nodes are connected by a line-segment and that's it. For curved lines, each node has a side handle to allow curving of that segment using the `cubic bezier curve algorithm <https://en.wikipedia.org/wiki/B%C3%A9zier_curve#/media/File:B%C3%A9zier_3_big.gif>`_ .
 
 **What that means, in short, is that moving the side handles into a given direction will make the segment curve in that direction, and the longer the line of the node to the side handle, the stronger the curving.**
 
 Selecting Nodes for Editing
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 You can select a single node with |mouseleft|, they will turn bright green if selected.
 
 |mouseleft| + :kbd:`Shift` on unselected nodes will add them to a selection.
 
 |mouseleft| + drag will make a selection rectangle. All nodes whose handles are touched by the rectangle will be selected. This combines with |mouseleft| + :kbd:`Shift` above.
 
 Selected Nodes
 ^^^^^^^^^^^^^^
 
 You can add and remove side handles from a selected node with |mouseleft| + :kbd:`Shift`.
 
 Krita has several node-types that allow you control the side handles more efficiently. These are the corner, smooth and symmetric modes.
 
  Corner
      Represented by a circle, the corner type allows you to have handles that can point in different directions and have different lengths.
  Smooth
      Represented by a square, the smooth type will ensure a smooth transition by always pointing the handles into opposite directions, but they can still have different lengths.
  Symmetric
      Represented by a diamond, the symmetric node will force handles to always point in opposite directions and have the same length.
 
 |mouseleft| + :kbd:`Ctrl` on a selected node will cycle between the node-types.
 
 :kbd:`Del` will remove the selected node.
 
 Selected Segments
 ^^^^^^^^^^^^^^^^^
 
 Segments are the lines between nodes. Hovering over a segment will show a dotted line, indicating it can be selected.
 
 You can |mouseleft| and drag on a segment to curve it to the mouse point. Clicking on different parts of the segment and dragging will curve it differently.
 
 Double |mouseleft| on a segment will add a node on the segment under the mouse cursor. The new node will be selected.
 
 Other Shapes
 ~~~~~~~~~~~~
 
 Shapes that aren't path shapes only have a single type of node: A small diamond like, that changes the specific parameters of that shape on-canvas. For example, you can change the corner radius on rectangles by dragging the nodes, or make the ellipse into a pie-segment.
 
 Tool Options
 ------------
 
 .. image:: /images/en/Shape-editing-tool-tool-options.png
 
 Path shapes have options. The top left options are for converting to different anchor point types. The bottom left options are for adding or removing points. The top right options are for converting the line to different types. The bottom right options are for breaking and joining line segments.
 
 The tool options of the Edit Shapes Tool change depending on the type of shape you have selected. With the exception of the path shape, all shapes have a :guilabel:`Convert to Path` action, which converts said shape to a path shape.
 
 Path Shapes
 ~~~~~~~~~~~
 
 |toolbeziercurve|, |toolline|, |toolpolyline|, |toolpolygon|, |toolfreehandpath|
 
 Path shapes are the most common shape and can be made with the following tools 
 
 * :ref:`path_tool`
 * :ref:`line_tool`
 * :ref:`polygon_tool`
 * :ref:`polyline_tool`
 * :ref:`freehand_path_tool`
 
 Node Editing
     Edit the nodes.
 
     Corner Point
         Make the selected node a corner or cusp. This means that the side handles can point in different directions and be different lengths.
     Smooth Point
         Make the selected node smooth. The two side handles will always point in opposite directions, but their length can be different.
     Symmetric Point
         Make the selected node smooth. The two side handles will always point in opposite directions, and their length will stay the same.
     Insert Point
         Insert a new node into the middle of the selected segment.
     Remove Point
         Remove the selected node.
 
 Line Segment Editing
     Edit line segments between nodes.
 
     Segment To Line
         Make the current segment a straight line.
     Segment To Curve
-        Make the current segment a curve: It'll add side nodes for this segment to the nodes attached to it.
+        Make the current segment a curve: It'll add side handles for this segment to the nodes attached to it.
     Make Line Point
         Turn the selected node into a sharp corner: This will remove the side handles.
     Make Curve Point
         Turn the selected node into one that can curve: This will add side handles to the node.
     Break at Point
         Break the path at this point.
     Break Segment
         Break the path at the selected segment.
     Join with Segment
         Join two nodes that are only attached on one side with a segment.
     Merge Points
         Merge two nodes into one, if the nodes are adjacent or if both nodes are only attached on one side with a segment.
 
 Rectangle Shapes
 ~~~~~~~~~~~~~~~~
 
 |toolrectangle|
 
 Rectangle shapes are the ones made with the :ref:`rectangle_tool`. It has extra options to make rounded corners easy.
 
 Corner radius x
     The radius of the y-axis of the corner curve.
 Corner radius y
     The radius of the y-axis of the corner curve.
 
 Ellipse Shapes
 ~~~~~~~~~~~~~~
 
 |toolellipse|
 
 Ellipse shapes are the ones made with the :ref:`ellipse_tool`.
 
 Type
     The type of ellipse shape it is.
 
     Arc
         An arc shape will keep the path open when it isn't fully circular.
     Pie
         A pie shape will add two extra lines to the center when the shape isn't fully circular, like how one cuts out a piece from a pie.
     Cord
         A cord shape will add a straight line between the two ends if the path isn't fully circular, as if a cord is being strung between the two points. 
 
 Start Angle
     The angle at which the shape starts.
 End Angle
     The angle at which the shape ends.
 Close Ellipse
     An action to quickly make the ellipse fully circular.
diff --git a/tutorials/krita-brush-tips/fur.rst b/tutorials/krita-brush-tips/fur.rst
index 7a8b20fbf..77e29b4d8 100644
--- a/tutorials/krita-brush-tips/fur.rst
+++ b/tutorials/krita-brush-tips/fur.rst
@@ -1,55 +1,55 @@
 .. meta::
    :description lang=en:
         A tutorial about creating fur in Krita
 
 .. metadata-placeholder
    :authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
    :license: GNU free documentation license 1.3 or later.
 
 .. _Fur:
 
 ==============
 Brush-tips:Fur
 ==============
 
 Question
 --------
 
 What brushes are best for fur textures?
 
 .. image:: /images/en/brush-tips/Krita-brushtips-fur_01.png
     :alt: Some example of furs and hair
 
 So typically, you see the same logic applied on fur as on regular :ref:`hair`.
 
 `However, you can make a brush a little easier by using the Gradient, Mix and HSV options in the pixel and color smudge brushes <https://docs.krita.org/Pixel>`_. Basically, what we want to do is have a stroke start dark and then become lighter as we draw with it, to simulate how hair-tips catch more light and look lighter due to being thinner at the ends, while at the base they are frequently more dark.
 
 .. image:: /images/en/brush-tips/Krita-brushtips-fur_02.png
     :alt: brush setting dialog for fur brush
 
-Take the ink_brush_25 and choose under Brush-tip->predefined “A-2 dirty brush”. Set the spacing to ‘auto’ and right-click the spacing bar to type in a value between 0.25 and 0.8. Also turn on the ‘enable pen-settings’ on flow. Replicate the pressure curve above on the size option. We don’t want the hairs to collapse to a point, hence why the curve starts so high.
+Take the ink_brush_25 and choose under Brush-tip->predefined “A-2 dirty brush”. Set the spacing to ‘auto’ and right-click the spacing bar to type in a value between 0.25 and 0.8. Also turn on the :guilabel:`Enable Pen Settings` on flow. Replicate the pressure curve above on the size option. We don’t want the hairs to collapse to a point, hence why the curve starts so high.
 
 .. image:: /images/en/brush-tips/Krita-brushtips-fur_03.png
     :alt: brush setting dialog for fur
 
 Then activate value and reproduce this curve with the ‘distance’ or ‘fade’ sensor. Like how the pressure sensor changes a value (like size) with the amount of pressure you put on the stylus, the distance sensor measures how many pixels your stroke is, and can change an option depending on that. For the HSV sensors: If the curve goes beneath the middle, it’ll become remove from that adjustment, and above the vertical middle it’ll add to that adjustment. So in this case, for the first 100px the brush dab will go from a darkened version of the active paint color, to the active paint color, and then for 100px+ it’ll go from the active color to a lightened version. The curve is an inverse S-curve, because we want to give a lot of room to the mid-tones.
 
 .. image:: /images/en/brush-tips/Krita-brushtips-fur_04.png
     :alt: brush setting dialog showing color gradation
 
 We do the same thing for saturation, so that the darkened color is also slightly desaturated. Notice how the curve is close to the middle: This means it’s effect is much less strong than the value adjustment. The result should look somewhat like the fifth one from the left on the first row of this:
 
 .. image:: /images/en/brush-tips/Krita-brushtips-fur_05.png
     :alt: result of the brush that we made
 
 The others are done with the smudge brush engine, but   a similar setup, though using color rate on distance instead. Do note that it’s very hard to shade realistic fur, so keep a good eye on your form shadow. You can also use this with grass, feathers and other vegetation:
 
 .. image:: /images/en/brush-tips/Krita-brushtips-fur_06.png
     :alt: using the fur brush to make grass and hair
 
 For example, if you use the mix option in the pxiel brush, it’ll mix between the fore and background color. You can even attach a gradient to the color smudge brush and the pixel brush. for color smudge this is just the ‘gradient’ option, and it’ll use the active gradient. For the pixel brush, set the color-source to ‘gradient’ and use the mix option.
 
 .. image:: /images/en/brush-tips/Krita-brushtips-fur_07.png
     :alt: fur brush with the color source to gradient and mix option
 
 On tumblr it was suggested this could be used to do `this tutorial <https://vimeo.com/78183651>`_. Basically, you can also combine this with the lighter color blending mode and wraparound mode to make making grass-textures really easy!
diff --git a/user_manual/introduction_from_other_software/introduction_from_sai.rst b/user_manual/introduction_from_other_software/introduction_from_sai.rst
index 3adea9892..f5c4216eb 100644
--- a/user_manual/introduction_from_other_software/introduction_from_sai.rst
+++ b/user_manual/introduction_from_other_software/introduction_from_sai.rst
@@ -1,216 +1,216 @@
 .. meta::
    :description:
         This is a introduction to Krita for users coming from Paint Tool Sai. 
 
 .. metadata-placeholder
 
    :authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
              - AnetK
              - Boudewijn Rempt <boud@valdyas.org>
    :license: GNU free documentation license 1.3 or later.
 
 .. index:: Sai, Painttool Sai
 .. _introduction_from_sai:
 
 ================================================
 Introduction to Krita coming from Paint Tool Sai
 ================================================
 
 How do you do that in Krita?
 ----------------------------
 
 This section goes over the functionalities that Krita and Paint Tool Sai share, but shows how they slightly differ.
 
 Canvas navigation
 ~~~~~~~~~~~~~~~~~
 
 Krita, just like Sai, allows you to flip, rotate and duplicate the view. Unlike Sai, these are tied to keyboard keys.
 
 Mirror
     This is tied to :kbd:`M` to flip.
 Rotate
     There's a couple of possibilities here: either :kbd:`4` and :kbd:`6`, or :kbd:`Ctrl + [` and :kbd:`Ctrl + ]` for basic 15 degrees rotation left and right. But you can also have more sophisticated rotation with :kbd:`Shift + Space` + drag or :kbd:`Shift` + |mousemiddle| + drag. To reset the rotation, press :kbd:`5`.
 Zoom
     You can use :kbd:`+` and :kbd:`-` to zoom out and in, or use :kbd:`Ctrl` + |mousemiddle|. Use 1, 2 or 3 to reset the zoom, fit the zoom to page or fit the zoom to page width.
 
 You can use the Overview docker in :menuselection:`Settings --> Dockers` to quickly navigate over your image.
 
 You can also put these commands on the toolbar, so it'll feel a little like Sai. Go to :menuselection:`Settings --> Configure Toolbars`. There are two toolbars, but we'll add to the file toolbar.
 
 Then, you can type in something in the left column to search for it. So, for example, 'undo'. Then select the action 'undo freehand stroke' and drag it to the right. Select the action to the right, and click :menuselection:`Change text`. There, toggle :menuselection:`Hide text when toolbar shows action alongside icon` to prevent the action from showing the text. Then press :guilabel:`OK`. When done right, the :guilabel:`Undo` should now be sandwiched between the save and the gradient icon.
 
 You can do the same for :guilabel:`Redo`, :guilabel:`Deselect`, :guilabel:`Invert Selection`, :guilabel:`Zoom out`, :guilabel:`Zoom in`, :guilabel:`Reset zoom`, :guilabel:`Rotate left`, :guilabel:`Rotate right`, :guilabel:`Mirror view` and perhaps :guilabel:`Smoothing: basic` and :guilabel:`Smoothing: stabilizer` to get nearly all the functionality of Sai's top bar in Krita's top bar. (Though, on smaller screens this will cause all the things in the brushes toolbar to hide inside a drop down to the right, so you need to experiment a little).
 
 :guilabel:`Hide Selection`, :guilabel:`Reset Rotation` are currently not available via the Toolbar configuration, you'll need to use the shortcuts :kbd:`Ctrl + H` and :kbd:`5` to toggle these.
 
 .. note::
 
     Krita 3.0 currently doesn't allow changing the text in the toolbar, we're working on it.
 
 Right click color picker
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can actually set this in :menuselection:`Settings --> Configure Krita --> Canvas input settings --> Alternate invocation`. Just double-click the entry that says :kbd:`Ctrl` + |mouseleft| before :guilabel:`Pick foreground color from image` to get a window to set it to |mouseright|.
 
 .. note::
 
     Krita 3.0 actually has a Paint-tool Sai-compatible input sheet shipped by default. Combine these with the shortcut sheet for Paint tool Sai to get most of the functionality on familiar hotkeys.
 
 Stabilizer
 ~~~~~~~~~~
 
 This is in the tool options docker of the freehand brush. Use Basic Smoothing for more advanced tablets, and Stabilizer is much like Paint Tool Sai's. Just turn off :guilabel:`Delay` so that the dead-zone disappears.
 
 Transparency
 ~~~~~~~~~~~~~
 
 So one of the things that throw a lot of Paint Tool Sai users off is that Krita uses checkers to display transparency, which is actually not that uncommon. Still, if you want to have the canvas background to be white, this is possible. Just choose :guilabel:`Background: As Canvas Color` in the new image dialogue and the image background will be white. You can turn it back to transparent via :menuselection:`Image --> Change image background color`. If you export a PNG or JPG, make sure to uncheck :guilabel:`Save transparency` and to make the background color white (it's black by default).
 
 .. image:: /images/en/Krita-color-to-alpha.png
    :align: center
 
 Like Sai, you can quickly turn a black and white image to black and transparent with the :menuselection:`Color to Alpha Filter` under :menuselection:`Filters --> Colors --> Color to Alpha`
 
 Brush Settings
 ~~~~~~~~~~~~~~
 
 Another, somewhat amusing misconception is that Krita's brush engine is not very complex. After all, you can only change the Size, Flow and Opacity from the top bar.
 
 This is not quite true. It's rather that we don't have our brush settings in a docker but a drop-down on the toolbar. The easiest way to access this is with :kbd:`F5`. As you can see, it's actually quite complex. We have more than a dozen brush engines, which are a type of brush you can make. The ones you are used to from Paint Tool Sai are the Pixel Brush (ink), The Color Smudge Brush (brush) and the filter brush (dodge, burn).
 
-A simple inking brush recipe for example is to take a pixel brush, uncheck the 'enable pen-settings' on opacity and flow, and uncheck everything but size from the option list. Then, go into brush-tip, pick :ref:`auto_brush_tip` from the tabs, and set the size to 25 (right-click a blue bar if you want to input numbers), turn on anti-aliasing under the brush icon, and set fade to 0.9. Then, as a final touch, set spacing to 'auto' and the spacing number to 0.8.
+A simple inking brush recipe for example is to take a pixel brush, uncheck the :guilabel:`Enable Pen Settings` on opacity and flow, and uncheck everything but size from the option list. Then, go into brush-tip, pick :ref:`auto_brush_tip` from the tabs, and set the size to 25 (right-click a blue bar if you want to input numbers), turn on anti-aliasing under the brush icon, and set fade to 0.9. Then, as a final touch, set spacing to 'auto' and the spacing number to 0.8.
 
 You can configure the brushes in a lot of detail, and share the packs with others. Importing of packs and brushes can be done via the :menuselection:`Settings --> Manage Resources`, where you can import .bundle files or .kpp files.
 
 Erasing
 ~~~~~~~
 
 Erasing is a blending mode in Krita, much like the transparency mode of Paint Tool Sai. It's activated with :kbd:`E` or you can select it from the Blending Mode drop-down...
 
 Blending Modes
 ~~~~~~~~~~~~~~
 
 Krita has a lot of Blending modes, and thankfully all of Paint Tool Sai's are amongst them except binary. To manage the blending modes, each of them has a little check-box that you can tick to add them to the favorites.
 
 Multiple, Screen, Overlay and Normal are amongst the favorites.
 Krita's Luminosity is actually slightly different from Paint Tool Sai's and it replaces the relative brightness of color with the relative brightness of the color of the layer.
 
 Sai's Luminosity mode is actually the same as Krita's *Addition* or *linear dodge* mode. The Shade mode is the same as *Color Burn* and *Hard Mix* is the same as the lumi and shade mode.
 
 Layers
 ~~~~~~
 
 Lock Alpha
     This is the checker box icon next to every layer.
 Clipping group
     For Clipping masks in Krita you'll need to put all your images in a single layer, and then press the 'a' icon, or press :kbd:`Ctrl + Shift + G`
 Ink layer
     This is a vector layer in Krita, and also holds the text.
 Masks
     These grayscale layers that allow you to affect the transparency are called transparency masks in Krita, and like Paint Tool Sai, they can be applied to groups as well as layers. If you have a selection and make a transparency mask, it will use the selection as a base.
 Clearing a layer
     This is under :menuselection:`Edit --> Clear`, but you can also just press :kbd:`Del`.
 
 Mixing between two colors
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you liked this docker in Paint Tool Sai, Krita's Digital Color Selector docker will be able to help you. Dragging the sliders will change how much of a color is mixed in.
 
 What do you get extra when using Krita?
 ---------------------------------------
 
 More brush customization
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 You already met the brush settings editor. Sketch brushes, grid brushes, deform brushes, clone brushes, brushes that are textures, brushes that respond to tilt, rotation, speed, brushes that draw hatches and brushes that deform the colors. Krita's variety is quite big.
 
 More color selectors
 ~~~~~~~~~~~~~~~~~~~~
 
 You can have HSV sliders, RGB sliders, triangle in a hue ring. But you can also have HSI, HSL or HSY' sliders, CMYK sliders, palettes, round selectors, square selectors, tiny selectors, big selectors, color history and shade selectors. Just go into :menuselection:`Settings --> Configure Krita --> Advanced Color Selector Settings` to change the shape and type of the main big color selector.
 
 .. image:: /images/en/Krita_Color_Selector_Types.png
    :align: center
 
 You can call the color history with :kbd:`H`, common colors with :kbd:`U` and the two shade selectors with :kbd:`Shift + N` and :kbd:`Shift + M`. The big selector can be called with :kbd:`Shift + I` on canvas.
 
 Geometric Tools
 ~~~~~~~~~~~~~~~
 
 Circles, rectangles, paths, Krita allows you to draw these easily.
 
 Multibrush, Mirror Symmetry and Wrap Around
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 These tools allow you to quickly paint a mirrored image, mandala or tiled texture in no time. Useful for backgrounds and abstract vignettes.
 
 .. image:: /images/en/Krita-multibrush.png
    :align: center
 
 Assistants
 ~~~~~~~~~~
 
 The painting assistants can help you to set up a perspective, or a concentric circle and snap to them with the brush.
 
 .. figure:: /images/en/Krita_basic_assistants.png
    :alt: Krita's vanishing point assistants in action
    :width: 800
 
    Krita's vanishing point assistants in action
 
 Locking the Layer
 ~~~~~~~~~~~~~~~~~
 
 Lock the layer with the padlock so you don't draw on it.
 
 Quick Layer select
 ~~~~~~~~~~~~~~~~~~
 
 If you hold :kbd:`R` and press a spot on your drawing, Krita will select the layer underneath the cursor. Really useful when dealing with a large number of layers.
 
 Color Management
 ~~~~~~~~~~~~~~~~
 
 This allows you to prepare your work for print, or to do tricks with the LUT docker so you can diagnose your image better. For example, using the LUT docker to turn the colors grayscale in a separate view, so you can see the values instantly.
 
 .. image:: /images/en/Krita-view-dependant-lut-management.png
    :align: center
 
 Advanced Transform Tools
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 Not just rotate and scale, but also cage, wrap, liquify and non-destructive transforms with the transform tool and masks.
 
 .. image:: /images/en/Krita_transforms_recursive.png
    :align: center
 
 More Filters and non-destructive filter layers and masks
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 With filters like color balance and curves you can make easy shadow layers. In fact, with the filter layers and layer masks you can make them apply on the fly as you draw underneath.
 
 .. image:: /images/en/Krita_ghostlady_3.png
    :align: center
 
 Pop-up palette
 ~~~~~~~~~~~~~~~
 
 This is the little circular thing that is by default on the right click. You can organize your brushes in tags, and use those tags to fill up the pop-up palette. It also keeps a little color selector and color history, so you can switch brushes on the fly.
 
 .. image:: /images/en/Krita-popuppalette.png
    :align: center
 
 What does Krita lack compared to Paint Tool Sai?
 ------------------------------------------------
 
 * Variable width vector lines
 * The selection source option for layers
 * Dynamic hard-edges for strokes (the fringe effect)
 * No mix-docker.
 * No Preset-tied stabilizer.
 * No per-preset hotkeys.
 
 Conclusion
 ----------
 
 I hope this introduction got you a little more excited to use Krita, if not feel a little more at home.
diff --git a/user_manual/japanese_animation_template.rst b/user_manual/japanese_animation_template.rst
index 81b012eab..155c8b02d 100644
--- a/user_manual/japanese_animation_template.rst
+++ b/user_manual/japanese_animation_template.rst
@@ -1,95 +1,95 @@
 .. meta::
    :description:
         Detailed explanation on how to use the animation template.
 
 .. metadata-placeholder
 
    :authors: - Saisho Kazuki
              - Tokiedian
              - Scott Petrovic
    :license: GNU free documentation license 1.3 or later.
 
 .. index:: Animation, Template
 .. _japanese_animation_template:
 
 ===========================
 Japanese Animation Template
 ===========================
 
 
 This template is used to make Japanese-style animation. It is designed
 on the assumption that it was used in co-production, so please customize
 its things like layer folders according to scale and details of your
 works.
 
 Basic structure of its layers
 =============================
 
 Layers are organized so that your work will start from lower layers go
 to higher layers, except for coloring layers. 
 
 .. image:: /images/en/Layer_Organization.png
 
 Its layer contents
 ==================
 
 from the bottom
 
 Layout Paper
     These layers are a form of layout paper. Anime tap holes are prepared on separate layers in case you have to print it out and continue your drawing traditionally.
 Layout (Background)
     These layers will contain background scenery or layouts which are scanned from a traditional drawing. If you don't use them, you can remove them.
 Key drafts
     These layers are used to draw layouts digitally.
 Keys
     Where you add some details to the layouts and arrange them to draw "keys" of animation.
 Inbetweening
     Where you add inbetweens to keys for the process of coloring, and remove unnecessary details to finalize keys (To be accurate, I finish finalization of keys before beginning to add inbetweens)
 Coloring (under Inbetweening)
     Where you fill areas with colors according to specification of inbetweens.
 Time Sheet and Composition sheet
     This contains a time sheet and composition sheet. Please rotate them before using.
 Color set
     This contains colors used to draw main and auxiliary line art and fill highlight or shadows. You can add them to your palette.
 
 Basic steps to make animation
 =============================
 
 Key draft --> assign them into Time sheet (or adjust them on Timeline, then assign them into Time sheet) --> adjust them on Timeline --> add frames to draw drafts for inbetweening if you need them --> Start drawing Keys
 
 .. image:: /images/en/Keys_drafts.png
 
 You can add layers and add them to timeline.
 
 .. image:: /images/en/Add_Timeline_1.png
 
 .. image:: /images/en/Add_Timeline_2.png
 
 This is due difference between 24 drawing per second, which is used in Full Animation, and 12 drawing per second and 8 drawings per second, which are used in Limited Animation, on the Timeline docker.
 
 .. image:: /images/en/24_12_and_8_drawing_per_sec.png
 
 This is correspondence between Timeline and Time sheet. "Black" layer is to draw main line art which are used ordinary line art, "Red" layer is to draw red auxiliary linearts which are used to specify highlights, "Blue" layer is to draw blue auxiliary linearts which are used to specify shadows, and "Shadow" layer is to draw light green auxiliary line art which are used to specify darker shadows. However, probably you have to increase or decrease these layers according to your work. 
 
 .. image:: /images/en/Time_sheet_1.png
 
 Finished keys, you will begin to draw the inbetweens. If you feel Krita is becoming slow, I recommend you to merge key drafts and keys, as well as to remove any unnecessary layers.
 
 After finalizing keys and cleaning up unnecessary layers, add
 inbetweenings, using Time sheet and inbetweening drafts as reference.
 
-This is its correspondence with Time sheetL
+This is its correspondence with Time sheet.
 
 .. image:: /images/en/Inbetweening.png
 
 Once the vector functionality of Krita becomes better, I recommend you to use vector to finalize inbetweening.
 
 If you do the colors in Krita, please use Coloring group layer. If you do
 colors in other software, I recommend to export frames as .TGA files.
 
 Resolution
 ----------
 
 I made this template in 300 dpi because we have to print them to use them in traditional works which still fill an important role in Japanese Anime Studio. However, if you stick to digital, 150-120 dpi is enough to make animation. So you can decrease its resolution according to your need.
 
 Originally written by Saisho Kazuki, Japanese professional animator, and translated by Tokiedian, KDE contributor.
diff --git a/user_manual/loading_saving_brushes.rst b/user_manual/loading_saving_brushes.rst
index def3efa63..f29538db4 100644
--- a/user_manual/loading_saving_brushes.rst
+++ b/user_manual/loading_saving_brushes.rst
@@ -1,485 +1,485 @@
 .. meta::
    :description:
         Detailed guide on the brush settings dialog in Krita as well as how to make your own brushes and how to share them.
 
 .. metadata-placeholder
 
    :authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
              - Raghavendra Kamath <raghavendr.raghu@gmail.com>
              - Scott Petrovic
    :license: GNU free documentation license 1.3 or later.
 
 .. index:: Brush Settings
 .. _loading_saving_brushes:
 
 ==========================
 Loading and Saving Brushes
 ==========================
 
 In the real world, when painting or drawing, you don't just use one
 tool. You use pencils, erasers, paintbrushes, different types of paint,
 inks, crayons, etc. All these have different ways of making marks.
 
 In a digital program like Krita you have something similar. We call this
 a brush engine. And much like how cars have different engines that give
 different feels when driving, or how pencils make distinctly different
 marks than rollerball pens, different brush engines have totally
 different feels.
 
 The brush engines have a lot of different settings as well. So, you can
 save those settings into presets.
 
 Unlike Photoshop, Krita makes a difference between brush-tips and
 brush-presets. Tips are only a stamp of sorts, while the preset uses a
 tip and many other settings to create the full brush.
 
 The Brush settings dropdown
 ---------------------------
 
 To start, the Brush Settings Editor panel can be accessed in the
 toolbar, between the :guilabel:`Blending Modes` button on the right and the :guilabel:`Patterns`
 button on the left. Alternately, you can use the function key :kbd:`F5` to open
 it.
 
 When you open Brush Settings Editor panel you will see something like
 this:
 
 Tour of the brush settings dropdown
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. image:: /images/en/Krita_4_0_Brush_Settings_Layout.svg
    :width: 800
 
 The brush settings drop down is divided into six areas,
 
 Section A - General Information
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This contains the **Preset Icon**, **Live Brush Preview**, the **Preset
 Name**, the **Engine** name, and several buttons for saving, renaming,
 and reloading.
 
 Krita's brush settings are stored into the metadata of a 200x200
 png (the KPP file), where the image in the png file becomes the preset
 icon. This icon is used everywhere in Krita, and is useful for
 differentiating brushes in ways that the live preview cannot.
 
 The live preview shows a stroke of the current brush as a little s-curve
 wiggle, with the pressure being non-existent on the left, and increasing to
 full pressure as it goes to the right. It can thus show the effect of the
 Pressure, Drawing Angle, Distance, Fade and Fuzzy Dab sensors, but none of the
 others. For some brush engines it cannot show anything. For the color smudge,
 filter brush and clone tool, it shows an alternating line pattern because these
 brush engines use the pixels already on canvas to change their effect.
 
 After the preset name, there's a button for **renaming** the brush. This
 will save the brush as a new brush and blacklist the previous name.
 
 Engine
 ''''''
 
 The engine of a brush is the underlying programming that generates the
 stroke from a brush. What that means is that different brush engines
 have different options and different results. You can see this as the
 difference between using crayons, pencils and inks, but because
 computers are maths devices, most of our brush engines produce different
 things in a more mathematical way.
 
 For most artists the mathematical nature doesn't matter as much as the
 different textures and marks each brush engine, and each brush engine
 has its own distinct flavor and use, and can be further customized by
 modifying the options.
 
 Reloading
 '''''''''
 
 If you change a preset, an icon will appear behind the engine name. This
 is the :guilabel:`reload` button. You can use it to revert to the original brush
 settings.
 
 Saving a preset
 ''''''''''''''''
 
 On the right, there's :guilabel:`Save New Brush Preset` and :guilabel:`Overwrite Brush`.
 
 Overwrite Brush
     This will only enable if there are any changes. Pressing this will
     override the current preset with the new settings, keeping the name
     and the icon intact. It will always make a timestamped back up in
     the resources folder.
 Save New Brush Preset
     Will take the current preset and all its changes and save it as a
     new preset. If no change was made, you will be making a copy of the
     current preset.
 
 Save new preset will call up the following window, with a mini scratch
 pad, and all sorts of options to change the preset icon:
 
 .. image:: /images/en/Krita_4_0_Save_New_Brush_Preset_Dialog.png
 
 The image on the left is a mini scratchpad, you can draw on it with the
 current brush, allowing small modifications on the fly.
 
 Brush Name
     The Name of your brush. This is also used for the KPP file. If
     there's already a brush with that name, it will effectively
     overwrite it.
 Load Existing Thumbnail
     This will load the existing thumbnail inside the preset.
 Load scratch pad thumbnail
     This will load the dashed area from the big scratch pad (Section C)
     into the thumbnail area.
 Load Image
     With this you can choose an image from disk to load as a thumbnail.
 Load from Icon Library
     This opens up the icon library.
 Clear Thumbnail
     This will make the mini scratch pad white.
 
 The Icon Library
 ''''''''''''''''
 
 To make making presets icons faster, Krita got an icon library.
 
 .. image:: /images/en/Krita_4_0_Preset_Icon_Library_Dialog.png
 
 It allows you to select tool icons, and an optional small emblem. When
 you press :guilabel:`OK` it will load the resulting combination into the mini
 scratch pad and you can draw in the stroke.
 
 If you go to your resources folder, there's a folder there called
 "preset\_icons", and in this folder there are "tool\_icons" and
 "emblem\_icons". You can add semi-transparent pngs here and Krita will
 load those into the icon library as well so you can customize your icons
 even more!
 
 At the top right of the icon library, there are three sliders. They allow
 you to adjust the tool icon. The top two are the same Hue and Saturation
 as in HSL adjustment, and the lowest slider is a super simple levels
 filter. This is done this way because the levels filter allows
 maintaining the darkest shadows and brightest highlights on a tool icon,
 making it much better for quick adjustments.
 
 If you're done with everything, you can press :guilabel:`Save` in the :guilabel:`Save New
 Preset` dialog and Krita will save the new brush.
 
 Section B - The Preset Chooser
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The preset chooser is much the same as the preset docker and the
 preset dropdown on :kbd:`F6`. It's unique in that it allows you to filter by
 engine and this is also where you can create brushes for an engine from
 scratch.
 
 It is by default collapsed, so you will need to press the arrow at the
 top left of the brush engine to show it.
 
 The top drop down is set to “all” by default, which means it shows all
 engines. It then shows a tag section where you can select the tags, the
 preset list and the search bar.
 
 Underneath that there's a plus icon, which when pressed gives you the
 full list of Krita's engines. Selecting an engine from the list will show the brushes for
 that engine.
 
 The trashcan icon does the same as it does in the preset docker: delete, or
 rather, blacklist a preset so it won't show up in the list.
 
 Section C - The Scratch pad
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 When you tweak your brushes, you want to be able to check what each
 setting does. That's why, to the right of the settings drop down, there
 is a scratch pad.
 
 It is by default collapsed, so you will have to press the arrow at the
 top right of the brush settings to show it.
 
 When saving a new preset, you can choose to get the icon from the
 scratch pad, this will load the dash area into the mini scratch pad of
 the Save New Preset dialog.
 
 The scratch pad has five buttons underneath it. These are in order for:
 
 #. Showing the current brush image
 
 #. Adding a gradient to the scratch pad (useful for smudge brushes)
 #. Filling with the background color
 #. Clearing everything on the scratch pad.
 
 Section D - The Options List
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The options, as stated above, are different per brush engine. These
 represent the different parameters, toggles and knobs that you can turn
 to make a brush preset unique. For a couple of options, the main things
 to change are sliders and check boxes, but for a lot of them, they use
 curves instead.
 
 Some options can be toggled, as noted by the little check boxes next to
 them, but others, like flow and opacity are so fundamental to how the
 brush works, that they are always on.
 
 The little padlock icon next to the options is for locking the brush.
 This has its own page.
 
 Section E - Option Configuration Widget
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Where section D is the list of options, section E is the widget where
 you can change things.
 
 Using sensor curves
 '''''''''''''''''''
 
 One of the big important things that make art unique to the artist who
 created it is the style of the strokes. Strokes are different because
 they differ in speed, rotation, direction, and the amount of pressure
 put onto the stylus. Because these are so important, we would want to
 customize how these values are understood in detail. The best way to do
 this is to use curves.
 
 Curves show up with the size widget for example. With an inking brush,
 we want to have size mapped to pressure. Just toggling the size option
 in the option list will do that.
 
 However, different people have different wrists and thus will press
 differently on their stylus. Someone who presses softly tends to find it
 easy to make thin strokes, but very difficult to make thick strokes.
 Conversely, someone who presses hard on their stylus naturally will have
 a hard time making thin strokes, but easily makes thick ones.
 
 Such a situation can be improved by using the curves to map pressure to
 output thinner lines or thicker ones.
 
 The brush settings curves even have quick curve buttons for these at the
 top. Someone who has a hard time making small strokes should try the
 second to last concave button, while someone who has a hard time making
 thick strokes should try the third button, the S shape.
 
 Underneath the curve widget there are two more options:
 
 Share Curves across all settings
     This is for the list of sensors. Toggling this will make all the
     sensors use the same curve. Unchecked, all checked sensors will have
     separate curves.
 Curves Calculation Mode
     This indicates how the multiple values of the sensor curves are
     used. The curves always go from 0 to 1.0, so if one curve outputs
     0.5 and the other 0.7, then...
 
     Multiply
         Will multiply the two values, 0.5\*0.7 = 0.35
     Addition
         Will add the two to a maximum of 1.0, so 0.5+0.7 = 1.2,
         which is then capped at 1.0.
     Maximum
         Will compare the two and pick the largest. So in the case of 0.5
         and 0.7, the result is 0.7.
     Minimum
         Will compare the two and pick the smallest. So in the case of
         0.5 and 0.7, the result is 0.5.
     Difference
         Will subtract the smallest value from the largest, so 0.7-0.5 =
         0.2
 
 It's maybe better to see with the following example:
 
 .. image:: /images/en/Krita_4_0_brush_curve_calculation_mode.png
 
 The first two are regular, the rest with different multiplication types.
 
 #. Is a brush with size set to the distance sensor.
 #. Is a brush with the size set to the fade sensor.
 #. The size is calculated from the fade and distance sensors multiplied.
 #. The size is calculated from the fade and distance sensors added to
    each other. Notice how thick it is.
 #. The size takes the maximum value from the values of the fade and
    distance sensors.
 #. The size takes the minimum value from the values of the fade and
    distance sensors.
 #. The size is calculated by having the largest of the values subtracted
    with the smallest of the values.
 
 Section F - Miscellaneous options
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Temporarily Save Tweaks to Preset (Dirty Presets)
     This enables dirty presets. Dirty presets store the tweaks you make
-    as long as this session of Krita is active. After that, the revert
+    as long as this session of Krita is active. After that, they revert
     to default. Dirtied presets can be recognized by the icon in the
     top-left of the preset. 
 
     .. figure:: /images/en/Krita_4_0_dirty_preset_icon.png
        :figwidth: 450
 
        The icon in the top left of the first two presets indicate it is “Dirty”, meaning there are tweaks made to the preset.
 
 Eraser Switch Size
     This switches the brush to a separately stored size when using the
     :kbd:`E` key.
 Eraser Switch Opacity
     Same as above, but then with Eraser opacity.
 Instant Preview
     This allows you to toggle instant preview on the brush. The Instant
     Preview has a super-secret feature: when you press the instant
     preview label, and then right click it, it will show a threshold
     slider. This slider determines at what brush size instant preview is
     activated for the brush. This is useful because small brushes can be
     slower with instant preview, so the threshold ensures it only
     activates when necessary.
 
 The On-canvas brush settings
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 There are on-canvas brush settings. If you open up the pop-up palette,
 there should be an icon on the bottom-right. Press that to show the
 on-canvas brush settings. You will see several sliders here, to quickly
 make small changes.
 
 At the top it shows the currently active preset. Next to that is a
 settings button, click that to get a list of settings that can be shown
 and organized for the given brush engine. You can use the up and down
 arrows to order their position, and then left and right arrows to add or
 remove from the list. You can also drag and drop.
 
 Making a Brush Preset
 ---------------------
 
 Now, let's make a simple brush to test the waters with:
 
 Getting a default for the brush engine.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 First, open the settings with :kbd:`F5`.
 
 Then, press the arrow on the upper left to open the preset chooser.
 There, press the “+” icon to get a list of engines. For this brush we're
 gonna make a pixel brush.
 
 Example: Making an inking brush
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 #. Draw on the scratch pad to see what the current brush looks like. If
    done correctly, you should have a 5px wide brush that has pressure set
    to opacity.
 #. Let us turn off the opacity first. Click on the
    :ref:`opacity <option_opacity_n_flow>`
    option in the right-hand list. The settings should now be changed to
    a big curve. This is the sensor curve.
 #. Uncheck the :guilabel:`Enable Pen Settings` checkbox.
 #. Test on the scratch pad... there still seems to be something
    affecting opacity. This is due to the
    :ref:`flow <option_opacity_n_flow>`
    option.
 #. Select the Flow option from the list on the right hand. Flow is like
    Opacity, except that Flow is per dab, and opacity is per stroke.
 #. Uncheck the :guilabel:`Enable Pen Settings` checkbox here as well. Test again.
 #. Now you should be getting somewhere towards an inking brush. It is
    still too small however, and kinda grainy looking. Click :ref:`Brush Tip <option_brush_tip>` in the
    brush engine options.
 #. Here, the diameter is the size of the brush-tip. You can touch the slider
    change the size, or right-click it and type in a value. Set it to 25
    and test again. It should be much better.
 #. Now to make the brush feel a bit softer, turn down the fade parameter
    to about 0.9. This'll give the *brush mask* a softer edge.
 #. If you test again, you'll notice the fade doesn't seem to have much
    effect. This has to do with the spacing of the dabs: The closer they
    are together, the harder the line is. By default, this is 0.1, which
    is a bit low. If you set it to 10 and test, you'll see what kind of
    effect spacing has. The
    :ref:`Auto <option_spacing>`
    checkbox changes the way the spacing is calculated, and Auto Spacing
    with a value of 0.8 is the best value for inking brushes. Don't
    forget that you can use right-click to type in a value.
 #. Now, when you test, the fade seems to have a normal effect... except
    on the really small sizes, which look pixelly. To get rid of that,
    check the anti-aliasing check box. If you test again, the lines should
    be much nicer now.
 
 Saving the new Brush
 ~~~~~~~~~~~~~~~~~~~~
 
 When you're satisfied, go to the upper left and select :guilabel::`Save new
 preset`.
 
 You will get the save preset dialog. Name the brush something like “My
 Preset”. Then, select :guilabel:`Load from Icon Library` to get the icon library.
 Choose a nice tool icon and press :guilabel:`OK`.
 
 The icon will be loaded into the mini scratch pad on the left. Now
 doodle a nice stroke next to it. If you feel you messed up, just go back
 to the icon library to load a new icon.
 
 Finally press :guilabel:`Save`, and your brush should be done.
 
 You can further modify your inking brush by...
 
 Changing the amount of pressure you need to put on a brush to make it full size.
     To do this, select the :ref:`size <option_size>`
     option, and press the pressure sensor from the list next to the curve. The curve should look like a straight line. Now if you want a brush that gets big with little pressure, tick on the curve to make a point, and drag the point to the upper-left. The more the point is to the upper-left, the more extreme the effect. If you want instead a brush that you have to press really hard on to get to full size, drag the dot to the lower-right. Such a brush is useful for fine details. Don't forget to save the changes to your brush when done.
 Making the fine lines look even softer by using the flow option.
-    To do this, select the flow option, and turn back on the enable pen settings check box. Now if you test this, it is indeed a bit softer, but maybe a bit too much. Click on the curve to make a dot, and drag that dot to the top-left, half-way the horizontal of the first square of the grid. Now, if you test, the thin lines are much softer, but the hard your press, the harder the brush becomes.
+    To do this, select the flow option, and turn back on the :guilabel:`Enable Pen Settings` check box. Now if you test this, it is indeed a bit softer, but maybe a bit too much. Click on the curve to make a dot, and drag that dot to the top-left, half-way the horizontal of the first square of the grid. Now, if you test, the thin lines are much softer, but the hard your press, the harder the brush becomes.
 
 Sharing Brushes
 ---------------
 
 Okay, so you've made a new brush and want to share it. There are several
 ways to share a brush preset.
 
 The recommended way to share brushes and presets is by using the
 resource bundle system. We have detailed instructions on how to use them
 on the :ref:`resource management page <resource_management>`.
 
 However, there are various old-fashioned ways of sharing brushes that can
 be useful when importing and loading very old packs:
 
 Sharing a single preset
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 There are three types of resources a single preset can take:
 
 #. A Paintoppreset file: This is the preset proper, with the icon and
    the curves stored inside.
 #. A Brush file: This is the brush tip. When using masked brushes,
    there's two of these.
 #. A Pattern file: this is when you are using textures.
 
 So when you have a brush that uses unique predefined tips for either
 brush tip or masked brush, or unique textures you will need to share
 those resources as well with the other person.
 
 To find those resources, go to :menuselection:`Settings --> Manage Resources --> Open Resource Folder`.
 
 There, the preset file will be inside paintoppresets, the brush tips
 inside brushes and the texture inside patterns.
 
 Importing a single KPP file.
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Now, if you want to use the single preset, you should go to the preset
 chooser on :kbd:`F6` and press the folder icon there. This will give a file
 dialog. Navigate to the kpp file and open it to import it.
 
 If there are brush tips and patterns coming with the file, do the same
 with pattern via the pattern docker, and for the brush-tip go to the
 settings dropdown (:kbd:`F5`) and then go to the “brush-tip” option. There,
 select predefined brush, and then the “import” button to call up the
 file dialog.
 
 Sharing via ZIP (old-fashioned)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Sharing via ZIP should be replaced with resource bundles, but older
 brush packs are stored in zip files.
 
 Using a ZIP with the relevant files.
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 #. Go to :menuselection:`Settings --> Manage Resources --> Open Resource Folder` to open the resource folder.
 #. Then, open up the zip file.
 #. Copy the brushes, paintoppresets and patterns folders from the zip
    file to the resource folder. You should get a prompt to merge the
    folders, agree to this.
 #. Restart Krita
 #. Enjoy your brushes!