[librsvg: 1/2] Document the multi-page features

[Marge Bot <marge-bot src gnome org>]

commit 8533c0852d2b6f86d4172ff0900181f89bd5db73
Author: Michael Howell <michael notriddle com>
Date:   Tue Oct 12 13:48:38 2021 -0700

    Document the multi-page features
    
    Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/603>

 rsvg-convert.1 | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)
---
diff --git a/rsvg-convert.1 b/rsvg-convert.1
index 61bb29e6..605a87d9 100644
--- a/rsvg-convert.1
+++ b/rsvg-convert.1
@@ -160,7 +160,7 @@ This will scale an SVG document to fit in an A4 page and convert it to PDF:
 .P
 
 .SS SPECIFYING A PAGE SIZE
-By default the size of the output comes from the rendered size specified with the
+By default the size of the output comes from the rendered size, which can be specified with the
 .B --width
 and
 .B --height
@@ -233,6 +233,30 @@ and
 options instead of
 .BR --zoom.
 
+.SS CREATING A MULTI-PAGE DOCUMENT
+The "pdf", "ps", and "eps" output formats support multiple pages. These can be created by
+combining multiple input SVG files. For example, this PDF file will have three pages:
+.P
+.RS
+.B rsvg-convert
+.BI --format= pdf
+.I pg1.svg
+.I pg2.svg
+.I pg3.svg
+.B >
+.I out.pdf
+.RE
+.P
+The size of each page will be computed, separately, as described in the
+.B "DEFAULT OUTPUT SIZE"
+section. This may result in a PDF being produced with differently-sized pages.
+If you need to produce a PDF with all pages set to exactly the same size,
+use the
+.B --page-width
+and
+.B --page-height
+options.
+
 .SS CONVERSION OF PIXELS BASED ON THE DOTS-PER-INCH
 .B rsvg-convert
 uses the