Write() refactor to use new line wrapping code

CHANGELOG.md

@@ -14,6 +14,7 @@ and [PEP 440](https://www.python.org/dev/peps/pep-0440/).
 - documentation on combining `borb` & `fpdf2`: [Creating a borb.pdf.document.Document from a FPDF instance](https://pyfpdf.github.io/fpdf2/ExistingPDFs.html)
 
 ### Changed
+- `write()` now supports soft hyphen characters, thanks to @gmischler
 - `image()` method now insert `.svg` images as PDF paths
 - log level of `_substitute_page_number()` has been lowered from `INFO` to `DEBUG`
 

docs/PageBreaks.md

@@ -1,7 +1,8 @@
 # Page breaks #
 
-By default, `fpdf2` will automatically perform page breaks whenever a cell is rendered at the bottom of a page
-with a height greater than the page bottom margin.
+By default, `fpdf2` will automatically perform page breaks whenever a cell or
+the text from a `write()` is rendered at the bottom of a page with a height
+greater than the page bottom margin.
 
 This behaviour can be controlled using the
 [`set_auto_page_break`](fpdf/fpdf.html#fpdf.fpdf.FPDF.set_auto_page_break)

docs/Tutorial.md

@@ -144,10 +144,10 @@ to 1 mm (against 0.2 by default) with
 [set_line_width](fpdf/fpdf.html#fpdf.fpdf.FPDF.set_line_width). Finally, we output the cell (the
 last parameter to true indicates that the background must be filled).
 
-The method used to print the paragraphs is [multi_cell](fpdf/fpdf.html#fpdf.fpdf.FPDF.multi_cell).
+The method used to print the paragraphs is [multi_cell](fpdf/fpdf.html#fpdf.fpdf.FPDF.multi_cell). Text is justified by default.
 Each time a line reaches the right extremity of the cell or a carriage return
 character is met, a line break is issued and a new cell automatically created
-under the current one. Text is justified by default.
+under the current one. An automatic break is performed at the location of the nearest space or soft-hyphen (\u00ad) character before the right limit. A soft-hyphen will be replaced by a normal hyphen when triggering a line break, and ignored otherwise.
 
 Two document properties are defined: the title 
 ([set_title](fpdf/fpdf.html#fpdf.fpdf.FPDF.set_title)) and the author 

fpdf/__init__.py

@@ -3,6 +3,8 @@
 
 from .fpdf import (
     FPDF,
+    X,
+    Y,
     FPDFException,
     TitleStyle,
     FPDF_FONT_DIR as _FPDF_FONT_DIR,
@@ -39,6 +41,8 @@
     "__license__",
     # Classes
     "FPDF",
+    "X",
+    "Y",
     "Template",
     "FlexTemplate",
     "TitleStyle",