![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
diff --git a/inkscape.pod b/inkscape.pod
index 66da34d4c626b5f682a2d3ea32b5641180394b7f..5870d99cd5690e6a9d4e1599ce6a6fe9ecb24b87 100644 (file)
--- a/inkscape.pod
+++ b/inkscape.pod
-Y, --query-y
-W, --query-width
-H, --query-height
+ -S, --query-all
-x, --extension-directory
=item B<-C>, B<--export-area-canvas>
-In PNG export, exported area is the entire canvas (page). Usually this is the default, so you
+In PNG and PDF export, exported area is the entire canvas (page). Usually this is the default, so you
don't need to specify this unless you are using --export-id to export a specific object.
=item B<-D>, B<--export-area-drawing>
-In PNG export, exported area is the entire drawing (not canvas), i.e. the bounding box
+In PNG and PDF export, exported area is the entire drawing (not canvas), i.e. the bounding box
of all objects of the document. With this option, the exported image will
-display just the visible objects of the document without margins or cropping. Can be
+display just the visible objects of the document without margins or cropping. For PNG, can be
used in combination wtih --export-use-hints.
=item B<--export-area-snap>
-Snap the export area outwards to the nearest integer SVG user unit (px) values. If you are using the
+For PNG export, snap the export area outwards to the nearest integer SVG user unit (px) values. If you are using the
default export resolution of 90dpi and your graphics are pixel-snapped to minimize antialiasing, this switch
allows you to preserve this alignment even if you are exporting some object's bounding
box (with --export-id or --export-area-drawing) which is itself not pixel-aligned.
=item B<-d> I<DPI>, B<--export-dpi>=I<DPI>
-The resolution used for bitmap export.
+The resolution used for PNG export.
The default is 90, which corresponds to 1 SVG user unit
(px, also called "user unit") exporting to 1 bitmap pixel.
This value overrides the DPI hint if used with --export-use-hints.
@@ -157,14 +158,16 @@ This value overrides the --export-dpi setting (or the DPI hint if used with --ex
=item B<-i> I<ID>, B<--export-id>=I<ID>
-The id attribute value of the object that you want to export from the document. By
+For PNG and PDF export, the id attribute value of the object that you want
+to export from the document. By
default the exported area is the bounding box of the object; you can override this using
--export-area, --export-area-canvas, or --export-area-drawing.
=item B<-j>, B<--export-id-only>
-Only export the object whose id is given in --export-id. All other objects are hidden and won't
-show in export even if they overlay the exported object. Without --export-id, this option is ignored.
+Only export to PNG the object whose id is given in --export-id. All other objects are hidden and won't
+show in export even if they overlay the exported object.
+Without --export-id, this option is ignored. For PDF export, this is the default, so this option has no effect.
=item B<-l>, B<--export-plain-svg>=I<FILENAME>
@@ -247,7 +250,17 @@ Export document(s) to Encapsulated PostScript format. Note that PostScript does
=item B<-A> I<FILENAME>, B<--export-pdf>=I<FILENAME>
-Export document(s) to PDF 1.4 format. This format preserves the transparency in the original SVG (though not all PDF viewers can display it yet). This option can be used together with --export-text-to-path (currently this is required, because exporting text as text is not yet supported).
+Export document(s) to PDF 1.4 format. This format preserves the
+transparency in the original SVG (though not all PDF viewers
+can display it yet). This option can be used together with
+--export-text-to-path (currently this is required, because
+exporting text as text is not yet supported).
+
+By default, the entire document
+is exported and the page size of the PDF is that of the SVG document. You can
+specify --export-id to export a single object (with PDF page the size
+of that object's bounding box) and --export-area-drawing to make the
+exported PDF page show the entire drawing (by default the SVG page).
=item B<-T>, B<--export-text-to-path>
@@ -282,6 +295,11 @@ Query the width of of the drawing or, if specified, of the object with --query-i
Query the height of of the drawing or, if specified, of the object with --query-id. The returned value is in px (SVG user units).
+=item B<-S>, B<--query-all>
+
+Prints a comma delimited listing of all objects in the SVG document with
+IDs defined, along with their x, y, width, and height values.
+
=item B<--vacuum-defs>
Remove all unused items from the <lt>defs<gt> section of the SVG file. If this
Harrington, MenTaLguY, Nathan Hurst, and Ted Gould, wanting to take a
different direction with the codebase in terms of focus on
SVG compliance, interface look-and-feel, and a desire to open
-development opportunities to more participants.
+development opportunities to more participants. The project progressed
+rapidly, gaining a number of very active contributors and features.
+
+Much work in the early days of the project focused on code stablization
+and internationalization. The original renderer inherited from Sodipodi
+was laced with a number of mathematical corner cases which led to
+unexpected crashes when the program was pushed beyond routine uses; this
+renderer was replaced with Livarot which, while not perfect either, was
+significantly less error prone. The project also adopted a practice of
+committing code frequently, and encouraging users to run developmental
+snapshots of the program; this helped identify new bugs swiftly, and
+ensure it was easy for users to verify the fixes. As a result, Inkscape
+releases have generally earned a reputation for being robust and
+reliable.
+
+Similarly, efforts were taken to internationalize and localize the
+interface, which has helped the program gain contributors worldwide.
+
+Inkscape has had a beneficial impact on the visual attractiveness of
+Open Source in general, by providing a tool for creating and sharing
+icons, splash screens, website art, and so on. In a way, despite being
+"just an drawing program", Inkscape has played an important role in
+making Open Source more visually stimulating to larger audiences.
=head1 COPYRIGHT AND LICENSE