[librsvg: 1/35] rsvg-convert.1: Put a few examples in synopsis

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

commit 60da5806b0149130b484c5f70a0d2219bf8090ba
Author: Federico Mena Quintero <federico gnome org>
Date:   Fri Jun 11 11:16:14 2021 -0500

    rsvg-convert.1: Put a few examples in synopsis
    
    Part-of: <https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/547>

 rsvg-convert.1 | 55 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 52 insertions(+), 3 deletions(-)
---
diff --git a/rsvg-convert.1 b/rsvg-convert.1
index a90d520e..f84644a0 100644
--- a/rsvg-convert.1
+++ b/rsvg-convert.1
@@ -1,11 +1,60 @@
 .\" -*- fill-column:100 -*-
 .TH rsvg-convert 1
 .SH NAME
-rsvg-convert \- turn SVG files into raster images.
+rsvg-convert \- Render SVG documents to PNG images, or convert them to PDF or PS.
 .SH SYNOPSIS
+Convert an SVG to PNG at its "natural size" and write it to standard output:
+.P
+.RS
 .B rsvg-convert
-[options] in.svg > out.png
-.I ""
+.I input.svg
+.B >
+.I output.png
+.RE
+.P
+Read an SVG from standard input and write a PNG to standard output:
+.P
+.RS
+.B cat
+.I input.svg
+.B |
+.B rsvg-convert
+.B >
+.I output.png
+.RE
+.P
+Specify an output filename; the input filename must be the last argument:
+.P
+.RS
+.B rsvg-convert
+.BI --output= output.png
+.I input.svg
+.RE
+.P
+Configure dots-per-inch (DPI), default is 96:
+.P
+.RS
+.B rsvg-convert
+.BI --dpi-x= 300
+.BI --dpi-y= 300
+.I input.svg
+.B >
+.I output.png
+.RE
+.P
+Render an SVG at a specific pixel size, scaled proportionally:
+.P
+.RS
+.B rsvg-convert
+.BI --width= 1024
+.BI --height= 768
+.B --keep-aspect-ratio
+.I input.svg
+.B >
+.I output.png
+.RE
+.P
+
 .SH DESCRIPTION
 Converts SVG images into PNG raster images, PDF, PS, or SVG vector images, or dumps of Cairo XML or
 recording surfaces.