-
Notifications
You must be signed in to change notification settings - Fork 74
v0.2.50..v0.2.51 changeset changeset derive.asciidoc
Garret Voltz edited this page Jan 15, 2020
·
1 revision
diff --git a/docs/commands/changeset-derive.asciidoc b/docs/commands/changeset-derive.asciidoc
index a0398d8..50bb679 100644
--- a/docs/commands/changeset-derive.asciidoc
+++ b/docs/commands/changeset-derive.asciidoc
@@ -14,10 +14,10 @@ dataset and the second should be the newer dataset.
* +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.
+* +output+ - Output location; must be a changeset .osc or .osc.sql file.
+* +osmApiDatabaseUrl+ - Target OSM API database the derived changeset is to be applied, used to maintain element ID continuity. Required only
+ if the changeset output format is .osc.sql.
+ Used to maintain element ID continuity with the database target for a derived changeset.
* +--stats+ - Stats flag, when turned on a table of create, modify, delete for each of the types
node, way, relation (only valid for .osc output files)
* +--write-bounds+ - If the `convert.bounding.box` configuration option is specified, optionally outputs a file containing the input bounds.
@@ -49,9 +49,12 @@ Changeset deriviation supports inline conversion operations with the `convert.op
=== 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