Changeset

Nodes, ways, and relations created or modified in JOSM are only available locally unless they are published on a server to make them useful for other mappers. The process of publishing data is called uploading.

Because their are hunders of mappers publishing their geo-data on the OSM server it is important to track who published what for what purpose. It would be tedious for mappers to describe for every singe node and every single way why it is published. A more convenient approach is to package a group of related object and assign the package a comment instead of the individual objects. This way, if a mapper maps his or her neighborhood, he or she can upload a package of nodes and ways and assign it a comment "mapped and reviewed some ways in foo city".

In JOSM such a package is called a changeset. A changeset is a collection of related changes (new objects, object modifications, or object deletings) applied to OSM data.

Changesets and the number of upload operations

A changeset is independent from an individual upload operation.

You can run multiple uploads with the same changeset. The changeset will then package the changes published in all uploads. A mapper can even stop JOSM, start it a day later and continue to publish to the changeset he or she has been using a day before, provided he or she didn't close the changeset.

A changeset is initially openened and it stays open until it is closed. A JOSM user can explicitly close one or more of his open changesets. If he doesn't close them, the JOSM server will close open changeset after a couple of days automatically. A changeset which isn't open is called closed.

Upload comment and other changeset tags

Similar to nodes, ways, and relations, it is possible to decorate changesets with tags. The most important tag is the so called upload comment. When you publish data in JOSM you are required to enter an upload comment with at least three characters. It's this comment which describes the published data for other mappers.

Opening a changeset

tbd

Closing a changeset

tbd

Listing the changes packaged in a changeset

tbd