Skip to content

v0.2.48..v0.2.49 changeset changeset derive.asciidoc

Garret Voltz edited this page Oct 2, 2019 · 1 revision
diff --git a/docs/commands/changeset-derive.asciidoc b/docs/commands/changeset-derive.asciidoc
index 934f0e0..a0398d8 100644
--- a/docs/commands/changeset-derive.asciidoc
+++ b/docs/commands/changeset-derive.asciidoc
@@ -11,9 +11,10 @@ the +changeset-apply+ command.
 If deriving a changeset between two inputs from different dates, the first input should be the older
 dataset and the second should be the newer dataset.
 
-* +input1+            - OSM data input 1 (e.g. .osm file).
-* +input2+            - OSM data input 2 (e.g. .osm file or empty string ("") to derive changeset from one input only).
-* +output+            - Output location (e.g. .osc or .osc.sql file.
+* +input1+            - OSM data input 1; may be any supported input format (e.g. .osm file).
+* +input2+            - OSM data input 2; may be any supported input format (e.g. .osm file or empty string ("") to derive changeset from one 
+                        input only).
+* +output+            - Output location; may be an .osc or .osc.sql file.
 * +osmApiDatabaseUrl+ - Target OSM API database the changeset is to be applied to.  Used to maintain
                         element ID continuity with a particular database instance when generating SQL
                         changesets only.  Required only if the changeset output format is .osc.sql.
@@ -44,18 +45,15 @@ hoot changeset-derive inputData.osm "" outputChangeset.osc.sql osmapidb://userna
 
 === Configuration Options
 
-Changeset deriviation supports inline conversion operations with the `convert.ops` configuration option. See the "Configuration Options" section
-of the `convert` command documentation for details.
+Changeset deriviation supports inline conversion operations with the `convert.ops` configuration option. See the https://github.com/ngageoint/hootenanny/blob/master/docs/commands/convert.asciidoc#conversion-operations[Conversion Operations] section of the `convert` command documentation for details.
 
 === Sorting
 
-Element sorting, required by changeset derivation, is performed in memory by default. This may cause problems with larger datasets.  To
-perform sorting in a non-memory bound fashion (to external disk), set the configuration option element.sorter.element.buffer.size to a value
-greater than zero.
+Element sorting, required by changeset derivation, is performed in memory by default. This may cause problems with larger datasets.  To perform sorting in a non-memory bound fashion (to external disk), set the configuration option element.sorter.element.buffer.size to a value greater than zero.
 
-Also, if inline conversion operations are specified in `convert.ops` and any of them do not support streaming (either operations that are an
-OsmMapOperation or an OsmMapConsumer), in-memory sorting will always occur.
+Also, if inline conversion operations are specified in `convert.ops` and any of them do not support streaming (either operations that are an OsmMapOperation or an OsmMapConsumer), in-memory sorting will always occur.
 
 === See Also
 
 * `changeset.*` configuration options
+* "Supported Input Formats":https://github.com/ngageoint/hootenanny/blob/master/docs/user/SupportedDataFormats.asciidoc
Clone this wiki locally