Changes between Version 8 and Version 44 of Help/Dialog/ChangesetManager


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Help/Dialog/ChangesetManager

    v8 v44  
    1 [[TranslatedPages]]
     1[[TranslatedPages(outdated=Tabs "Tags" and "Content" and "Discussion" need some more explanation)]]
     2
    23= Changeset Manager =
    3 {{{
    4 #!html
    5 <p style="background-color:rgb(253,255,221);padding: 10pt; border-color:rgb(128,128,128);border-style: solid; border-width: 1px;">
    6 <strong>Work in progress! </strong><br/>
    7 The features described here are not yet available in either <tt>latest</tt> or <tt>tested</tt>.
    8 </p>
    9 }}}
    104
    11 [[TOC(inline)]]
     5[[JOSMImage(dialogs/changeset/changesetmanager,48,middle,link=,margin-right=20)]] ''Keyboard shortcut:'' **`Ctrl+Alt+C`** — one of the [wikitr:/Help/Menu/Windows JOSM Dialogs] **([wikitr:/Help/ExpertMode expert mode] only)**
    126
    13 == Launching Changeset Manager ==
     7[[PageOutline(2-10,Table of Contents)]]
     8
     9== Launching Changeset Manager ==#Launch
    1410There are several ways to launch the Changeset Manager:
    1511
    16  1. Select the menu item [[Image(source:/trunk/images/dialogs/changeset/changesetmanager.png)]]''View->Changeset Manager''
    17  2. Press {{{Ctrl-Alt-C}}}
    18  3. Select one or more changesets in the [wiki:/Help/Dialog/ChangesetListDialog Changeset List Dialog] and click there on [[Image(source:/trunk/images/dialogs/changeset/changesetmanager.png)]]
     121. Select the menu item ''Windows-> [[JOSMImage(dialogs/changeset/changesetmanager,24,middle,link=)]] Changeset Manager''
     131. Press **`Ctrl+Alt+C`**
     141. Select one or more changesets in the [wikitr:/Help/Dialog/ChangesetList Changeset List Dialog] and click there on [[JOSMImage(dialogs/changeset/changesetmanager,24,middle,link=)]].
    1915
    2016== The Changeset Manager window ==
    … …  
    2319
    2420== Querying changesets ==
    25 There are several ways to query and download changesets. The most common query and download operations can be invoked directly from the Changset Manager. Other more advanced features are provided by the [wiki:/Help/Dialog/ChangesetQueryDialog Changeset Query Dialog].
     21There are several ways to query and download changesets. The most common query and download operations can be invoked directly from the Changeset Manager. Other more advanced features are provided by the [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog].
    2622
    2723=== Query and download a changeset by its unique ID ===
    … …  
    3026[[Image(query-single-changeset.png)]]
    3127
    32  1. Enter the changeset ID in the input field in the toolbar section of the Changeset Manager
    33  2. Press {{{ENTER}}} or click on [[Image(source:/trunk/images/dialogs/changeset/downloadchangeset.png)]]
     281. Enter the changeset ID or a changeset URL in the input field in the toolbar section of the Changeset Manager
     291. Press **`ENTER`** or click on [[JOSMImage(dialogs/changeset/downloadchangeset,24,middle)]].
    3430
    3531If you download a single changeset JOSM downloads both the changeset properties (for instance its id or the date it was created) and the changeset content (i.e. the list of objects created, updated, or deleted with this changeset).
    3632
    3733=== Query and download your open changesets ===
    38 Changesets can be [wiki:/Help/Concepts/Changeset#Properties open or closed]. A mapper can always upload additional objects to an open changeset he or she owns.
     34Changesets can be [wikitr:/Help/Concepts/Changeset#Properties open or closed]. A mapper can always upload additional objects to an open changeset he or she owns.
    3935
    4036If you want to download the list of open changesets you own
    41  1. Click on [[Image(source:/trunk/images/dialogs/changeset/downloadchangeset.png)]]'''My open changesets''' in the toolbar section of the Changeset Manager
     371. Click on [[JOSMImage(dialogs/changeset/downloadchangeset,24,middle)]] **My open changesets** in the toolbar section of the Changeset Manager.
    4238
    43 Note that this download only the changeset properties without the changeset content. For downloading the content of changesets see below.
     39Note that this download only the changeset properties without the changeset content. For downloading the content of changesets see [#UpdateContentMulti below].
    4440
    4541=== Advanced queries ===
    4642Advanced queries like
    47  * querying the changesets owned by another mapper
    48  * querying the most recent changesets open or closed on the OSM server
    49  * querying changesets which modified object in a specific area (called a "bounding box") 
    50 can be run using the [wiki:/Help/Dialog/ChangesetQueryDialog Changeset Query Dialog].
     43* querying the changesets owned by another mapper
     44* querying the most recent changesets open or closed on the OSM server
     45* querying changesets which modified object in a specific area (called a "bounding box")
     46can be run using the [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog].
    5147
    52 To launch the [wiki:/Help/Dialog/ChangesetQueryDialog Changeset Query Dialog]:
     48To launch the [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog]:
    5349
    54  1. Click on [[Image(source:/trunk/images/dialogs/search.png)]]'''Query''' in the toolbar section of the Changeset Manager
     501. Click on [[JOSMImage(dialogs/search,middle)]] **Query** in the toolbar section of the Changeset Manager.
    5551
    5652== Managing the cache of downloaded changesets ==
    57 JOSM locally maintains a cache of the changesets downloaded from the OSM server. The content of this cache is displayed in the upper half of the Changeset Manager.
     53JOSM locally maintains a cache of the changesets downloaded from the OSM server. The content of this cache is displayed in the upper half of the Changeset Manager.
     54
     55To sort the table of the changesets click on the table column header.
    5856
    5957=== Removing changesets from the cache ===
    60 Changesets can be removed from the local cache. Removing a changeset from the cache is purely local operation. The changeset isn't deleted on the OSM server. In fact, it is ''not possible'' to delete a changeset on the server.
     58Changesets can be removed from the local cache. Removing a changeset from the cache doesn't affect the OSM server. The changeset isn't deleted on the server. In fact, it is ''not possible'' to delete a changeset on the server.
    6159
    62 Removing changesets from the local cache can be useful because the local changeset cache consumes memory. You can remove changesets you don't need from the cache in order to free it up.
     60Removing changesets from the local cache can be useful because the local changeset cache consumes memory, though. You can remove changesets you don't need from the cache in order to free up the memory.
    6361
    6462To remove one or more changesets from the local cache
    65   1. Select the changesets in the Changeset Manager
    66   2. Click on [[Image(source:/trunk/images/dialogs/delete.png)]] or press {{{DEL}}}. Alternatively you may select  [[Image(source:/trunk/images/dialogs/delete.png)]]'''Remove from cache''' from the popup menu.
     631. Select the changesets in the Changeset Manager
     641. Click on [[JOSMImage(dialogs/delete,24,middle,link=)]] or press **`DEL`**. Alternatively you may select  [[JOSMImage(dialogs/delete,24,middle,link=)]] **Remove from cache** from the popup menu.
    6765
    6866=== Updating the properties of changesets in the cache ===
    69 Properties of changesets can cache over time. For instance, an open changeset can become closed or the tags of an open changeset can change because it is assigned a new set of tags in another upload.
     67Properties of changesets can change over time. For instance, an open changeset can become closed or the tags of an open changeset can change because it is assigned a new set of tags in another upload.
    7068
    7169In order to update the properties of one or more changesets
    72  1. Select the changesets in the Changeset Manager
    73  2.  Click on [[Image(source:/trunk/images/dialogs/changeset/updatechangeset.png)]]. Alternatively you may select  [[Image(source:/trunk/images/dialogs/changeset/updatechangeset.png)]]'''Update changeset''' from the popup menu.
     701. Select the changesets in the Changeset Manager
     711. Click on [[JOSMImage(dialogs/changeset/updatechangeset,24,middle,link=)]]. Alternatively you may select  [[JOSMImage(dialogs/changeset/updatechangeset,24,middle,link=)]] **Update changeset** from the popup menu.
    7472
    75 Note that this will update the changeset properties only. For updating the changeset content, see [wiki:/Help/Dialog/ChangesetManager#UpdateContentMulti below].
     73Note that this will update the changeset properties only. For updating the changeset content, see [#UpdateContentMulti below].
    7674
    7775=== Downloading/Updating the content of changesets in the cache === #UpdateContentMulti
    7876A changeset includes a collection of object which have been created, updateded, or  deleted by the changeset. These objects are called the ''changeset content''.
    79 The size of a changeset content varies, but in general it can become very large. Changesets can grow up to 50'000 objects. Changeset content is therefore not automatically downloaded from the OSM server.
     77The size of a changeset content varies, but in general it can become very large. Changesets can grow up to 50,000 objects. Changeset content is therefore not automatically downloaded from the OSM server.
    8078
    8179In order to download the changeset content of one or more changesets
    82  1. Select the changesets in the Changeset Manager
    83  2.  Click on [[Image(source:/trunk/images/dialogs/changeset/downloadchangesetcontent.png)]]. Alternatively you may select  [[Image(source:/trunk/images/dialogs/changeset/downloadchangesetcontent.png)]]'''Download changeset content''' from the popup menu.
     801. Select the changesets in the Changeset Manager
     811. Click on [[JOSMImage(dialogs/changeset/downloadchangesetcontent)]]. Alternatively you may select  [[JOSMImage(dialogs/changeset/downloadchangesetcontent)]] **Download changeset content** from the popup menu.
    8482
    85 In additiol, the content of a changeset may change over time provided the changeset is still open. The same steps will always retrieve the most recent content for a given changeset. If the local cache already includes the content of a changeset, this operation will update it with the latest content.
     83The content of a changeset may change over time too, provided the changeset is still open. The same steps will always retrieve the latest content for a given changeset. If the local cache already includes the content of a changeset, this operation will refresh it.
     84
     85=== Copying a list of changesets to clipboard ===
     86Select several changeset (`Ctrl+Clic` to select several non-consecutive changesets or `Shift+Click` to select consecutive changesets) then the OS-specific keyboard shortcut (e.g. `Ctrl+C` with Windows) to paste them to the clipboard.
     87
    8688
    8789== Managing a single changeset ==
    8890=== Browsing properties, tags, and content ===
     91The detail view in the lower half of the Changeset Manager consists of four tabs:
     92* **Properties** - displays the basic properties of the currently selected changeset, i.e. its ID or whether the changeset is open or closed
     93* **Tags** - displays the tags assigned to the currently selected changeset
     94* **Content** - displays the changeset content
     95* **Discussion** - displays the changeset discussion, if available
     96
     97Click on either of these tabs to browse the respective information.
     98
     99=== External Changeset viewers ===
     100Click on [[JOSMImage(help/internet)]] on the left in the Properties tab to get a list of external changeset viewers. Clicking on one of them will open the selected changeset at the website of the chosen service. External changeset viewers provide different visual illustrations of the contents of a changeset.
     101
    89102=== Remove a changeset from the local cache ===
     103
     1041. Click on [[JOSMImage(dialogs/delete,24,middle,link=)]] to remove the currently selected changeset from the cache.
     105
     106=== Editing changeset content  ===
     107This is not possible in JOSM.
     108
    90109=== Updating/Downloading changeset content  ===
     110There are two commands available to either update the basic properties of the changeset or to update/download the changeset content:
     111
     112In order to update the changeset properties
     1131. Click on [[JOSMImage(dialogs/changeset/updatechangeset,24,middle,link=)]]
     114
     115In order to update/download the changeset content
     1161. Click on [[JOSMImage(dialogs/changeset/updatechangesetcontent,24,middle,link=)]] or  [[JOSMImage(dialogs/changeset/downloadchangesetcontent,24,middle,link=)]] respectively. Depending on whether the changeset content has already been downloaded either of these two actions is available.
     117
     118=== Download the current version of objects in the changeset content ===
     119Objects included in the changeset may be downloaded to the active data layer. If no data layer exists a new one is created.
     120
     1211. Click on the tab **Content**.
     1221. Make sure the changeset content is downloaded. If not, download it first.
     1231. Select some objects in the changeset content.
     1241. Click on [[JOSMImage(downloadprimitive)]]. Alternatively, you may select [[JOSMImage(downloadprimitive)]] **Download Objects** from the popup menu.
     125
     126**Note**: To download all objects of a changeset it is often faster to use the plugin [[Image(source:/osm/applications/editors/josm/plugins/reverter/images/revert-changeset.svg,link=,middle)]] [osmwiki:JOSM/Plugins/Reverter Reverter] and undo the last action.
     127
     128=== Download and display the history of objects in the changeset content ===
     129For an object included in the content of a changeset, you may retrieve and display its history.
     130
     1311. Click on the tab **Content**.
     1321. Make sure the changeset content is downloaded. If not, download it first.
     1331. Select some objects in the changeset content.
     1341. Click on [[JOSMImage(dialogs/history)]]. Alternatively, you may select [[JOSMImage(dialogs/history)]] **Show history** from the popup menu.
     135
    91136=== Selecting objects in the changeset content in the Map View ===
    92 If the [wiki:/Help/MapView Map View] includes an active data layer you can select all objects in this layer which are also part of the current changeset in the Changeset Manager.
     137If the [wikitr:/Help/MapView Map View] includes an active data layer you can select all objects in this layer which are also part of the current changeset in the Changeset Manager.
    93138
    94  1. Click on [[Image(source:/trunk/images/dialogs/select.png)]] in the detail view of the Changeset Manager
     1391. Click on [[JOSMImage(dialogs/select)]] in the detail view of the Changeset Manager
    95140
    96 You can also select
     141You can also
    97142
    98  1. Select the tab '''Content''' in the detail view
    99  2. Select one or more objects in the content
    100  3. Click on [[Image(source:/trunk/images/dialogs/select.png)]]. Alternatively, you may select [[Image(source:/trunk/images/dialogs/select.png)]] '''Select in layer''' in the popup menu.
     1431. Select the tab **Content** in the detail view
     1441. Select one or more objects in the content
     1451. Click on [[JOSMImage(dialogs/select)]]. Alternatively, you may select [[JOSMImage(dialogs/select)]] **Select in layer** in the popup menu.
    101146
    102147=== Zooming to objects in the changeset content  ===
     148If the [wikitr:/Help/MapView Map View] includes an active data layer you can "zoom to the changeset". Actually, neither the changeset nor the entire changeset content is ever included in a data layer. With "zoom to the changeset" we mean that JOSM zooms to the largest subset of objects in the data layer which is also a subset in the changeset content.
    103149
     150In order to zoom to "zoom to the changeset"
     1511. Click on [[JOSMImage(dialogs/autoscale/selection)]] in the detail view of the Changeset Manager.
    104152
    105 === Download and display the history of objects in the changeset content ===
     153Alternatively, you may zoom to a subset of the changeset content". In order to do so
    106154
    107 == See also ==
     1551. Click on the tab **Content**.
     1561. Make sure the changeset content is downloaded. If not, download it first.
     1571. Select some objects in the changeset content.
     1581. Click on [[JOSMImage(dialogs/autoscale/selection)]]. Alternatively, you may select [[JOSMImage(dialogs/autoscale/selection)]] **Zoom to layer** from the popup menu.
    108159
     160== See also ==
     161* [wikitr:/Help/Concepts/Changeset Concept of changesets]
     162* [[JOSMImage(closechangeset,bottom,link=,24)]] [wikitr:/Help/Action/CloseChangeset Close changesets]
     163* [[JOSMImage(dialogs/changesetdialog,24,middle,link=)]] [wikitr:/Help/Dialog/ChangesetList Changeset List panel]
     164* [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog]
    109165
     166----
     167Back to [wikitr:/Help/Menu/Windows Menu Windows] \\
     168Back to [wikitr:/Help Main Help]