Changes between Version 81 and Version 114 of Help/Preferences/Advanced


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Advanced

    v81 v114  
    22[[PageOutline(2-10,Table of Contents)]]
    33
    4 =  Preferences dialog > Advanced Preferences tab =
    5 
    6 [[Image(source:trunk/images/preferences/advanced.png,link=)]]
    7 
    8 The **Advanced Peferences** tab shows all raw settings and allows to manipulate them.
    9 It is visible in [wikitr:/Help/ExpertMode expert mode] only.
    10 
    11 Most settings can more easily and safely be modified via the other tabs of this dialog box.
    12 Normally you should not need to use this display.
     4=  Preferences > Advanced Preferences =
     5[[JOSMImage(preferences/advanced,link=,48,middle,margin-right=20)]] **''Setting Preference directly. Use with caution! ''**
     6
     7The **Advanced Peferences** register shows all raw settings and allows to manipulate them. It is visible in [wikitr:/Help/ExpertMode expert mode] only.
     8
     9Most settings can easily and safely be modified via the other registers of this dialog box.
     10Normally you should not need to use this register.
    1311Do so with caution.
    1412Invalid settings can cause errors and/or loss of data.
     13Some setting changes need a restart to work. Unlike the other registers there is no warning about it.
    1514You may be instructed to edit here in order to access experimental features.
    1615See more about user settings in the [wikitr:/Help/Preferences Preferences Overwiew].
    1716
    18 === Search ===
     17== Search ==
    1918Use the Search field to quickly access values and keys grouped by namespace.
    2019 
    21 === List colors ===
    22  1. [[span(style=background-color:#FFFFC8;font-weight:bold;, Bold on yellow)]] - value has changed at least once.
    23  1. [[span(style=background-color:#C8FFC8;font-weight:bold;, Bold on green)]] - value was changed in this dialog.
    24  1. [[span(style=background-color:#C8FFC8;font-weight:normal;, Normal on green)]] - value was reset to default in this dialog.
    25 After JOSM being restarted all preference settings equal to their default values loose any markings.
    26 
    27 [[Image(Help/Preferences/Advanced:AdvancedPreferencesTab.png,344,right)]]
    28 === Buttons ===
     20== List colors ==
     211. [[span(style=background-color:#FFFFC8;font-weight:bold;, Bold on yellow)]] - value has changed at least once.
     221. [[span(style=background-color:#C8FFC8;font-weight:bold;, Bold on green)]] - value was changed in this dialog.
     231. [[span(style=background-color:#C8FFC8;font-weight:normal;, Normal on green)]] - value was reset to default in this dialog.
     24After a restart of JOSM all preference settings which are equal to their default values loose any list colors.
     25
     26[[Image(PreferencesAdvancedPreferences.png​,link=,45%,right,margin-left=10)]]
     27
     28== Buttons ==#Buttons
    2929 Add:: To add keys with simple values and with a XML structure.
    3030
    31  Edit:: To edit one selected key/value pair.
    32 
    33  Reset:: Sets all selected key/value pairs to their default value.
     31 Edit:: To edit one marked key/value pair.
     32
     33 Reset:: Sets all marked key/value pairs to their default value.
    3434
    3535 Read from file:: Imports a JOSM custom configuration XML file.
    36  That can contain preferences modifications, commands to download some files or plugins, and even JavaScript code.[[br]]
     36 That can contain preferences modifications, commands to download some files or plugins and even JavaScript code. \\
    3737 After a file import is complete, you can see a detailed log and the changed preferences will be represented.
    3838 You can reject these changes by pressing **Cancel** button.
    … …  
    4343 You can use it together with the **Search** field to find all preferences you need to backup or share.
    4444
    45  More...:: launches the popup menu with additional actions:
     45 More...:: launches a popup menu with additional actions:
    4646 * **Save ... profile** - saves part of preferences related to shortcuts, colors, toolbar and imagery to a separate custom configuration XML files.
    4747 * **Load profile** - replace existing part of preferences with previously saved fragment (for example, reset all shortcuts to default and then load them from file).
    4848  User should press OK to confirm changes.
    4949 * **Reset preferences** - reset all preferences by deleting the preferences.xml file.
    50   See [Help/ResetPreferences Reset preferences] also.
    51 
    52 
    53 === Explanation ===
    54 The table below contains settings not accessible in the other tabs of the Preferences dialog:
    55 
    56 ||= Key =||\
    57 ||= Values =||= Default =||\
    58 ||= Description =||\
    59 ||
    60 || ''panel''.buttonhiding ||\
     50  See [wikitr:/Help/ResetPreferences Reset preferences] also.
     51
     52== Explanation ==
     53The table below contains settings not accessible in the other tabs of the Preferences dialog (incomplete list):
     54||= **Key** =||\
     55||= **Values** =||= **Default** =||\
     56||= **Description** =||\
     57||
     58|| **''$panel''`.buttonhiding`** ||\
    6159|| DYNAMIC, ALWAYS_HIDDEN or ALWAYS_SHOWN || DYNAMIC ||\
    6260|| See [wikitr:"/Help/JOSM interface customization" JOSM interface customization] ||\
    6361||
    64 || ''panel''.minimized ||\
     62|| **''$panel''`.minimized`** ||\
    6563|| true or false || false ||\
    6664|| See [wikitr:"/Help/JOSM interface customization" JOSM interface customization] ||\
    6765||
    68 || ''panel''.docked ||\
     66|| **''$panel''`.docked`** ||\
    6967|| true or false || true ||\
    7068|| if a window is in the side pane or floating ||\
    7169||
    72 || ''panel''.lastHeight ||\
     70|| **''$panel''`.lastHeight`** ||\
    7371|| integer || mixed ||\
    7472|| is used to store the last used height of a panel ||\
    7573||
    76 || ''panel''.preferredHeight ||\
     74|| **''$panel''`.preferredHeight`** ||\
    7775|| integer || mixed ||\
    7876|| can be used to overwrite the hard coded preferred height of a panel ||\
    7977||
    80 || ''widget''.always-visible; ||\
     78|| **''$dialogname''`.geometry`** ||\
     79|| ''`x=*,y=*,width=*,height=*`'' || || Size and position of dialog boxes ||\
     80||
     81|| **''$widget''`.always-visible`** ||\
    8182|| true or false || true ||\
    8283|| if TAB toggles this screen widget ||\
    8384||
    84 || draw.anglesnap.* and probably keys starting with color.draw.angle.snap ||\
    85 || mixed ||mixed||\
    86 || should be explained at [wikitr:/Help/Action/Draw Action/Draw] ||\
    87 ||
    88 || edit.initial-move-threshold ||\
    89 || pixels || || See [wikitr:/Help/Action/Select#Advanceddetails Action/Select] ||\
    90 ||
    91 || edit.initial-move-delay ||\
    92 || ms || || See [wikitr:/Help/Action/Select#Advanceddetails Action/Select] ||\
    93 ||
    94 || message.movedManyElements ||\
     85|| **`validator.*`** \\ **`overlapping-ways.*`** ||\
     86|| mixed || mixed ||\
     87|| See [wikitr:/Help/Preferences/Validator validator preferences] ||\
     88||
     89|| **`draw.anglesnap.*`** and probably keys starting with **`color.draw.angle.snap`** ||\
     90|| mixed || mixed ||\
     91|| should be explained at [wikitr:/Help/Action/Draw Draw] ||\
     92||
     93|| **`edit.initial-move-threshold`** ||\
     94|| pixels || || See [wikitr:/Help/Action/Select#Advanceddetails Select] ||\
     95||
     96|| **`edit.initial-move-delay`** ||\
     97|| ms || || See [wikitr:/Help/Action/Select#Advanceddetails Select] ||\
     98||
     99|| **`message.movedManyElements`** ||\
    95100|| true or false  || unset ||\
    96 || See [wikitr:/Help/Action/Select#Movemultipleobjectsatoncemessage Action/Select] ||\
    97 ||
    98 || draw.fullscreen ||\
    99 || true or false || false || See [wikitr:/Help/Action/FullscreenView Action/FullscreenView] ||\
    100 ||
    101 || zoom.undo.delay \\ zoom.undo.max ||\
    102 || || || See [wikitr:/Help/Action/ZoomToPrevious#AdvancedPreferences Action/ZoomToPrevious] ||\
    103 ||
    104 || properties.presets.visible ||\
    105 || || true || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Dialog/TagsMembership] ||\
    106 ||
    107 || properties.presets.top ||\
    108 || || true || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Dialog/TagsMembership] ||\
    109 ||
    110 || url.openstreetmap-wiki ||\
     101|| Decision of "do not ask again" message after moving many objects. ||\
     102||
     103|| **`draw.fullscreen`** ||\
     104|| true or false || false || See [wikitr:/Help/Action/FullscreenView Fullscreen view] ||\
     105||
     106|| **`navigation.always-visible`** ||\
     107|| `true` or `false` || `true` || Hide on-screen zoom control and current scale and [wikitr:/Help/ToggleDialogs Toggle Dialogs] are hidden (since r18755) ||\
     108||
     109|| **`zoom.undo.delay` \\ `zoom.undo.max`** ||\
     110|| || || See [wikitr:/Help/Action/ZoomToPrevious#AdvancedPreferences Zoom to previous] ||\
     111||
     112|| **`relation.editor.presets.visible?`** ||\
     113|| true or false || true || If set to true, displays the list of presets matching the current tags in the relation editor. ||\
     114||
     115|| **`properties.presets.visible`** ||\
     116|| true or false || true || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\
     117||
     118|| **`properties.presets.top`** ||\
     119|| true or false || true || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\
     120||
     121|| **`url.openstreetmap-wiki`** ||\
    111122|||| !https://wiki.openstreetmap.org/wiki/ ||\
    112 || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Dialog/TagsMembership] ||\
    113 ||
    114 || selectaction.cycles.multiple.matches ||\
     123|| See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\
     124||
     125|| **`selectaction.cycles.multiple.matches`** ||\
    115126|| true or false || false ||\
    116 || See [wikitr:/Help/Action/Select#Selectingsingleobjects Action/Select] ||\
    117 ||
    118 || osm.notes.daysClosed ||\
    119 || -1, 0 or positive integer || 7 || See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Dialog/Notes] ||\
    120 ||
    121 || osm.notes.downloadLimit ||\
    122 || from ... to 10000 || 1000 || See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Dialog/Notes] ||\
    123 ||
    124 || latlon.dms.decimal-format \\ latlon.dm.decimal-format \\ statusbar.decimal-format ||\
     127|| See [wikitr:/Help/Action/Select#Selectsingle] ||\
     128||
     129|| **`osm.notes.daysClosed`** ||\
     130|| -1, 0 or positive integer || 7 || See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Notes panel], available in [wikitr:/Help/Preferences/Connection OSM Server preferences] ||\
     131||
     132|| **`osm.notes.downloadLimit`** ||\
     133|| from ... to 10000 || 1000 || See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Notes panel] ||\
     134||
     135|| **`latlon.dms.decimal-format` \\ `latlon.dm.decimal-format` \\ `statusbar.decimal-format`** ||\
    125136||  ||  || See [wikitr:/Help/StatusBar#AdvancedPreferences StatusBar] ||\
    126137||
    127 || statusbar.distance-threshold ||\
     138|| **`statusbar.distance-threshold`** ||\
    128139||  ||  || See [wikitr:/Help/StatusBar#AdvancedPreferences StatusBar] ||\
    129140||
    130 || simplify-way.max-error ||\
    131 || integer, meters || 3 || See [wikitr:/Help/Action/SimplifyWay#AdvancedPreferences Action/SimplifyWay] ||\
    132 ||
    133 || message.way.split.segment-selection-dialog ||\
    134 || true or false || false || See [wikitr:/Help/Action/SplitWay#AdvancedPreferences Action/SplitWay] ||\
    135 ||
    136 || mappaint.wireframe.use-antialiasing ||\
    137 || true or false || false || See [wikitr:/Help/Action/WireframeToggle#AdvancedPreferences Action/WireframeToggle] ||\
    138 ||
    139 || curves.circlearc.angle-separation ||\
    140 || || 20 || See [wikitr:/Help/Action/CreateCircleArc#AdvancedPreferences Action/CreateCircleArc] ||\
    141 ||
    142 || merge-nodes.mode ||\
    143 || 0 or 1 or 2 || 0 || See [wikitr:/Help/Action/MergeNodes#AdvancedPreferences Action/MergeNodes] ||\
    144 ||
    145 || upload.comment.max-age ||\
    146 || integer || 4*3600*1000 || See [wikitr:/Help/Concepts/Changeset#AdvancedPreferences Changeset] ||\
    147 ||
    148 || mappaint.fillalpha, mappaint.showicons and couple others ||\
     141|| **`override.numbering.format`** ||\
     142|| true or false || `true` || disable/enable overriding of number format. So far only Arabic languages and Khmer are supported, see #18856. ''(since r16111)'' ||\
     143||
     144|| **`simplify-way.max-error`** ||\
     145|| integer, meters || `3` || See [wikitr:/Help/Action/SimplifyWay Simplify Way] ||\
     146||
     147|| **`message.way.split.segment-selection-dialog`** ||\
     148|| true or false || `false` || See [wikitr:/Help/Action/SplitWay#AdvancedPreferences Split Way] ||\
     149||
     150|| **`mappaint.wireframe.use-antialiasing`** ||\
     151|| true or false || `false` || See [wikitr:/Help/Action/WireframeToggle#AdvancedPreferences Wireframe view], available in the [[JOSMImage(layer/osmdata_small,24,link=,middle)]] [wikitr:/Help/Preferences/DrawingPreference OSM Data preferences] ||\
     152||
     153|| **`merge-nodes.mode`** ||\
     154|| 0 or 1 or 2 || `0` || See [wikitr:/Help/Action/MergeNodes#AdvancedPreferences Merge Nodes] ||\
     155||
     156|| **`upload.comment.max-age`** ||\
     157|| integer || `4*3600*1000` || See [wikitr:/Help/Concepts/Changeset#AdvancedPreferences Changeset] ||\
     158||
     159|| **`upload.show.review.request`** ||\
     160|| true or false || `true` || displays the "I want someone to review my edits." check box in the upload dialog ||\
     161||
     162|| **`upload.show.automatic.source`** ||\
     163|| true or false || `true` || displays the "Automatically obtain source from current layers" check box in the upload dialog ||\
     164||
     165|| **`mappaint.fillalpha`**, **`mappaint.showicons`** and couple others ||\
    149166||  ||  || See [wikitr:/Styles#AdvancedPreferences Styles] ||\
    150167||
    151 || *.GUI.geometry; ||\
    152 || || || Size and position of dialog boxes ||\
    153 ||
    154 || browser.windows ||\
     168|| **`browser.unix`** ||\
     169|| || ["xdg-open", \\ "#DESKTOP#", \\ "$BROWSER", \\ "gnome-open", \\ "kfmclient openURL", \\ "firefox"] || sets another external browser than the default browser to open external links on unix os ||\
     170||
     171|| **`browser.windows`** ||\
    155172|| || || sets another external browser than the default browser to open external links on windows os (use the browser executable) ||\
    156173||
    157 || browser.unix ||\
    158 || || ["xdg-open", "#DESKTOP#", "$BROWSER", "gnome-open", "kfmclient openURL", "firefox"] || sets another external browser than the default browser to open external links on unix os ||\
    159 ||
    160 || osm-primitives.showid ||\
    161 || true or false || false || displays the objects id beside the object in lists ||\
    162 ||
    163 || osm-primitives.showversion ||\
    164 || true or false || false || displays the objects version beside the object in lists ||\
    165 ||
    166 
    167 ''panel'' is short for changesetdialog, commandstack, conflict, filter, layerlist, mapstyle, notes/note_open, propertiesdialog, relationlist, selectionlist, userlist or validator \\
    168 ''widget'' is short for menu, sidetoolbar, statusbar, or toolbar \\
    169 
    170 
    171 === Details ===
     174||||
     175|| **`osm-primitives.localize-name`** ||\
     176|| true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\
     177||
     178|| **`osm-primitives.showcoor`** ||\
     179|| true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\
     180||
     181|| **`osm-primitives.showid`** ||\
     182|| true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\
     183||
     184|| **`osm-primitives.showid.new-primitives`** ||\
     185|| true or false || `false` || Instead of `id:0`, displays the internal negative id for new objects beside the object in lists ||\
     186||
     187|| **`osm-primitives.showversion`** ||\
     188|| true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\
     189||
     190||||
     191|| **`propertiesdialog.autoresizeTagsTable`** ||\
     192|| true or false || `false` || Enables automatic column width of the tags table to fit content, see #14666 ||\
     193||
     194|| **`zoom.scale-follow-native-resolution-at-load`** ||\
     195|| true or false || `true` || `true` means "Scale follows native resolution of layer" is enabled when layer is created ||\
     196||
     197|| **`properties.autocomplete-keys`** ||\
     198|| true or false || `true` || `true` means autocomplete keys by default in the add tag dialog ||\
     199||
     200|| **`properties.autocomplete-values`** ||\
     201|| true or false || `true` || `true` means autocomplete values by default in the add tag dialog ||\
     202||
     203|| **`imagery.generic.popupmenu`** ||\
     204|| true or false || `true` || `false` disables the imagery context menu in the mapview ||\
     205||
     206|| **`gui.start.animation`** ||\
     207|| true or false || `true` || `false` disables the animation while displaying the [wikitr:/StartupPage Startup page] ||\
     208||
     209|| **`jcs.cache.use_image_resource_cache`** ||\
     210|| true or false || `false` || `true` enables caching rendered SVG images using JCS ''(since r17364)'' ||\
     211||
     212||||
     213|| **`osm.download.threads`** ||\
     214|| integer || `2` || Maximum parallel download threads downloading OSM data objects ||\
     215||
     216|| **`socket.maxredirects`** ||\
     217|| integer || `5` || Maximum of allowed redirects ||\
     218||
     219|| **`socket.timeout.connect`** ||\
     220|| integer || `15` || Maximum interval to wait for a connection with server ||\
     221||
     222|| **`socket.timeout.read`** ||\
     223|| integer || `30` || Maximum interval to wait for an answer from server ||\
     224||
     225||||
     226|| **`autosave.deletedLayersBackupCount`** ||\
     227|| integer || `5` || ||\
     228||
     229|| **`autosave.enabled`** ||\
     230|| true or false || `true` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\
     231||
     232|| **`autosave.extension`** ||\
     233|| || `osm` || File extension to use for data layers when [wikitr:/Help/Action/AutoSave auto saving] ||\
     234||
     235|| **`autosave.filesPerLayer`** ||\
     236|| integer || `1` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\
     237||
     238|| **`autosave.index-limit`** ||\
     239|| integer || `1000` || ||\
     240||
     241|| **`autosave.interval`** ||\
     242|| integer || `300` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\
     243||
     244|| **`autosave.notification`** ||\
     245|| true or false || `false` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\
     246||
     247||||
     248|| **`multipoly.alltags`** ||\
     249|| true or false || `false` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\
     250||
     251|| **`multipoly.lineartagstokeep`** ||\
     252|| key list || `[barrier,fence_type,source]` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\
     253||
     254|| **`multipoly.movetags`** ||\
     255|| true or false || `true` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\
     256||
     257|| **`multipoly.show-relation-editor`** ||\
     258|| true or false || `false` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\
     259||
     260||||
     261
     262**''$dialogname''** is short for a dialog name \\
     263**''$panel''** is short for changesetdialog, commandstack, conflict, filter, layerlist, mapstyle, notes/note_open, propertiesdialog, relationlist, selectionlist, userlist or validator \\
     264**''$widget''** is short for menu, sidetoolbar, statusbar or toolbar \\
     265
     266
     267== Details ==
    172268The list of preferences is build like this:
    173269* Not all possible available keys are listed at the beginning.
    174 * Whenever JOSM internally requests the value of a particular setting, it remembers the key and the default value.
    175 * Note that a setting is not saved in the preference file, unless the value is different from the default. However JOSM will remember all keys and their default values which were previously requested.
    176 * This means, that settings related to download may not be in the list, before you did your first download. However, if you already know the key, you can still set it explicitly.
     270* Whenever JOSM internally requests a particular setting, it remembers and lists the key and the default value.
     271* A setting is only saved in the preference file if the value is different from the default.
     272* However, if you already know the key, you can still set it explicitly.
    177273
    178274
    179275----
    180276Back to [wikitr:/Help/Action/Preferences Preferences dialog] \\
     277Back to [wikitr:/Help/Menu/Edit Edit Menu] \\
     278Back to [wikitr:/Help/Menu Main Menu] \\
    181279Back to [wikitr:/Help Main Help]