[librsvg: 7/8] Update the man page for rsvg-convert for the new sizing logic




commit 2cf46310ed5a04fd8d7317e5e41e275461765c53
Author: Federico Mena Quintero <federico gnome org>
Date:   Fri Oct 1 13:43:31 2021 -0500

    Update the man page for rsvg-convert for the new sizing logic
    
    Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/595>

 rsvg-convert.1 | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)
---
diff --git a/rsvg-convert.1 b/rsvg-convert.1
index b4b13ecd..61bb29e6 100644
--- a/rsvg-convert.1
+++ b/rsvg-convert.1
@@ -342,7 +342,8 @@ and
 .B --dpi-y
 options).  For PDF/PS/EPS output, the width/height in physical units define the size of the PDF
 unless you specify options for the page size; see
-.B "PAGE SIZE" below.
+.B "SPECIFYING A PAGE SIZE"
+above.
 .IP \(bu 2
 .B SVG with viewBox only:
 .B <svg viewBox="0 0 20 30">
@@ -351,20 +352,16 @@ The size of the
 attribute gets used for the pixel size of the image as in the first case above.
 .IP \(bu 2
 .B SVG with width and height in percentages:
-If the
-.B width
+.B <svg width="100%" height="100%" viewBox="0 0 20 30">
+Percentages are meaningless unless you specify a viewport size with the
+.B --width
 and
-.B height
-attributes of the toplevel
-.B <svg>
-element are in percentage units, for example
-.BR width="100%" ,
-then they will be multiplied by the size of the
+.B --height
+options.  In their absence,
+.B rsvg-convert
+will just use the size of the
 .B viewBox
-attribute.  For example,
-.B <svg width="50%" height="100" viewBox="0 0 20 30">
-will be rendered as a 10*30\ pixel PNG.
-.B Note that this behavior may change in the future.
+for the pixel size, as described above.
 .IP \(bu 2
 .B SVG with no width, height, or viewBox:
 .B rsvg-convert


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]