![[tokkee]](http://tokkee.org/images/avatar.png){kind=avatar}
diff --git a/inkscape.pod b/inkscape.pod
index 33c89a2b4d72c759316cfecde69795ee1905ec10..5d9c3d3f383210c6af82f8e071a1d0d37d20d883 100644 (file)
--- a/inkscape.pod
+++ b/inkscape.pod
-Y, --query-y
-W, --query-width
-H, --query-height
+ -S, --query-all
-x, --extension-directory
- --verb-list
+ --verb-list
--verb=VERB-ID
--select=OBJECT-ID
needed on the command line and are executed in order on every document that
is specified.
-The --verb command will execute a specific verb like it
+The --verb command will execute a specific verb as if it
was called from a menu or button. Dialogs will appear if that is part
-of the verb. To get a list of the verb IDs available use the --verb-list
+of the verb. To get a list of the verb IDs available, use the --verb-list
command line option.
The --select command will cause objects that have the ID
@@ -282,6 +283,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
=item B<group id="options">
The options group allows persisting various user selected options
-including I<nudgeddistance>, I<rotationstep>, I<cursortolerance>, and
+including I<nudgedistance>, I<rotationstep>, I<cursortolerance>, and
I<dragtolerance>.
=back
The program returns zero on success or non-zero on failure.
-A variety of error messages and warnings are printed to STDERR or
+A variety of error messages and warnings may be printed to STDERR or
STDOUT. If the program behaves erratically with a particular SVG file
-or crashes, it is sometimes useful to look at this output for clues.
+or crashes, it is useful to look at this output for clues.
=head1 EXAMPLES
While obviously B<Inkscape> is primarily intended as a GUI application,
it can be used for doing SVG processing on the commandline as well.
-Print an SVG file:
+Open an SVG file in the GUI:
+
+ inkscape filename.svg
+
+Print an SVG file from the command line:
inkscape filename.svg -p '| lpr'
inkscape filename.svg --query-width --query-id text1555
+Duplicate the object with id="path1555", rotate the duplicate 90 degrees, save SVG, and quit:
+
+ inkscape filename.svg --select=path1555 --verb=EditDuplicate --verb=ObjectRotate90 --verb=FileSave --verb=FileClose
+
=head1 ENVIRONMENT
B<$HOME>/.inkscape/preferences.xml - The user's preference settings.
-B<$HOME>/.inkscape/extensions.xml - The filter programs to be used in
-the application.
+B<$HOME>/.inkscape/extensions/ - Directory with user's extension effects.
+
+B<$HOME>/.inkscape/icons/ - Directory with user's icons.
+
+B<$HOME>/.inkscape/keys/ - Directory with user's keyboard maps.
+
+B<$HOME>/.inkscape/templates/ - Directory with user's new file templates.
-B<$HOME>/.inkscape/icons/{*,icons}.svg - Icons to overload for themes.
=head1 OTHER INFO
The canonical place to find B<Inkscape> info is at
-http://www.inkscape.org/. The website includes links to other relevant
-documentation, tutorials, user manual, examples, mailing list archives,
-the latest released version of the program, and more.
+http://www.inkscape.org/. The website has news, documentation,
+tutorials, examples, mailing list archives, the latest released
+version of the program, bugs and feature requests databases, forums,
+and more.
=head1 SEE ALSO
-gimp(1), autotrace, potrace, frontline, ill2svg, rsvg(1), xfig(1), sodipodi,
-karbon14, dia(1X), batik.
+potrace, cairo, rsvg(1), batik, ghostscript, pstoedit.
SVG compliance test suite: http://www.w3.org/Graphics/SVG/Test/
To learn Inkscape's GUI operation, read the tutorials in Help > Tutorials.
-Inkscape can import (File > Import) most bitmap formats (PNG, BMP, JPG, XPM, GIF etc.),
-plain text (requires Perl), and AI format (Adobe Illustrator documents, versions up to 7 only;
-requires Perl).
+Apart from SVG, Inkscape can import (File > Import) most bitmap formats
+(PNG, BMP, JPG, XPM, GIF, etc.), plain text (requires Perl), PDF,
+and AI format (AI version 9.0 or newer).
-Inkscape exports 32-bit PNG images (File > Export) as well as AI, PS, EPS, PDF (requires
-Ghostscript), DXF and several other formats via File > Save as.
+Inkscape exports 32-bit PNG images (File > Export) as well as AI, PS, EPS, PDF, DXF,
+and several other formats via File > Save as.
-Inkscape can use the pressure and tilt of a graphic tablet pen for width and angle of
-the Calligraphic tool.
+Inkscape can use the pressure and tilt of a graphic tablet pen for width, angle,
+and force of action of several tools, including the Calligraphic pen.
Inkscape includes a GUI front-end to the Potrace bitmap tracing engine
(http://potrace.sf.net) which is embedded into Inkscape.
Inkscape can use external scripts (stdin-to-stdout filters) that are represented by
commands in the Effects menu. A script can have a GUI dialog for setting various
parameters and can get the IDs of the selected objects on which to act via the command
-line. Inkscape comes with an assortment of effects written in Python, mostly for path
-manipulation.
+line. Inkscape comes with an assortment of effects written in Python.
=head1 KEYBINDINGS
-To get a complete list of keyboard and mouse shortcuts, view doc/keys.html, or use the Keys and Mouse command in Help menu from the GUI to see an SVG chart.
+To get a complete list of keyboard and mouse shortcuts, view doc/keys.html, or use the Keys and Mouse command in Help menu.
=head1 BUGS
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
-B<Copyright (C)> 1999-2005 by Authors.
+B<Copyright (C)> 1999-2007 by Authors.
B<Inkscape> is free software; you can redistribute it and/or modify it
under the terms of the GPL.