Changes between Version 71 and Version 72 of Help/Preferences/Advanced


Ignore:
Timestamp:
2018-02-27T15:15:04+01:00 (8 years ago)
Author:
Hb---
Comment:

One line per sentence

Legend:

Unmodified
Added
Removed
Modified
  • Help/Preferences/Advanced

    v71 v72  
    22[[PageOutline(2-10,Table of Contents)]]
    33
    4 =  Preferences > Advanced Preferences =
     4=  Preferences dialog > Advanced Preferences tab =
    55
    6 [[Image(source:trunk/images/preferences/advanced.png)]]
     6[[Image(source:trunk/images/preferences/advanced.png,link=)]]
    77
    8 **Advanced preferences** gives you a view of all your raw [Help/Preferences preferences data].
     8The **Advanced Peferences** tab shows all raw settings and allows to manipulate them.
     9It is visible in [wikitr:/Help/ExpertMode expert mode] only.
    910
    10 This tab is only visible in '''[wiki:Help/ExpertMode expert mode]'''.
     11Most settings can more easily and safely be modified via the other tabs of this dialog box.
     12Normally you should not need to use this display.
     13Do so with caution.
     14Invalid settings can cause errors and/or loss of data.
     15You may be instructed to edit here in order to access experimental features.
     16See more about user settings in the [wikitr:/Help/Preferences Preferences Overwiew].
    1117
    12 The majority of preference settings can be more easily and safely modified via the other preference panels. Normally you should not need to use this display to change settings. Do so with caution because there is no validation, and invalid or missing settings can cause unexpected errors and/or loss of data. You may be instructed to change or add settings here in order to access experimental or under-development features e.g. if somebody developed a plugin and provided a setting, but didn't get around to creating a more attractive interface for changing it.
     18=== Search ===
     19Use the Search field to quickly access values and keys grouped by namespace.
     20 
     21=== List colors ===
     22 1. **`Bold on yellow`** - value has changed at least once.
     23 1. **`Bold on green`** - value was changed in this dialog.
     24 1. `Normal on green` - value was reset to default in this dialog.
     25After JOSM being restarted the preferences equal to their default will loose all markings.
    1326
    14 As you can see, your preference data is composed of a set of name->value pairs. The setting names are often "namespaced" with dot ('.') separated words. Many JOSM plugins will store preferences grouped in a namespace.
    1527
    16 You can get a similar raw view by viewing this file, but this 'Advanced' preferences panel is intended to provide a easier alternative.
     28=== Buttons ===
     29 Add:: To add keys with simple values and with a XML structure.
    1730
    18 Color-coding:
    19 * yellow background - values which have changed at least once appear bold
    20 * green background - values which you just changed get a green background; when you close and reopen the preference window, they get also the yellow background
     31 Edit:: To edit one selected key/value pair.
    2132
    22 [[Image(AdvancedPreferences.png, 600px)]]
     33 Reset:: Sets all selected key/value pairs to their default value.
    2334
    24 == Explanation ==
    25 Please note that if key was utilized by menu ([[Help/Keys by menu]]), it won't be listed here. I.e. list below contains only hidden to the end user settings:
     35 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]]
     37 After file import is complete, you can see a detailed log and the changed preferences will be represented.
     38 You can reject these changes by pressing **Cancel** button.
     39 **Caution**: You can not undo reject file or plugin operations (download, delete, etc.), so be careful and do not open scripts from untrusted sources!
     40
     41 Export selected items:: Generates a custom configuration XML file automatically.
     42 When reading this file, the key-value pairs will replace existing ones or be appended to them (in case of properties containing lists or maps).
     43 You can use it together with the **Search** field to find all preferences you need to backup or share.
     44
     45 More...:: launches the popup menu with additional actions:
     46 * **Save ... profile** - saves part of preferences related to shortcuts, colors, toolbar and imagery to a separate custom configuration XML files.
     47 * **Load profile** - replace existing part of preferences with previously saved fragment (for example, reset all shortcuts to default and then load them from file).
     48  User should press OK to confirm changes.
     49 * **Reset preferences** - reset all preferences by deleting the preferences.xml file.
     50  See [Help/ResetPreferences Reset preferences] also.
     51
     52[[Image(AdvancedPreferences.png,434)]]
     53
     54=== Explanation ===
     55The table below contains settings not accessible in the GUI:
    2656
    2757||Single key or group? ||'''Key'''||'''Values'''||'''Default'''||'''Description'''||
     
    5888||single|| message.movedManyElements || true or false  || unset || [wiki:Help/Action/Select#Movemultipleobjectsatoncemessage "Move multiple objects at once message" at Select,move,rotate page] ||
    5989
    60 == Details ==
     90=== Details ===
    6191The list of preferences is build like this:
    6292* Not all possible available keys are listed at the beginning.
     
    6595* 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.
    6696
    67 
    68 == Import and export items ==
    69 
    70 * **Read from file** button can be used to open JOSM custom configuration XML file. It can contain preferences modifications, commands to download some files or plugins, and even JavaScript code.[[br]]
    71  After file import is complete, you can see a detailed log and the changed preferences will be represented. You can reject these changes by pressing **Cancel** button. **Caution**: You can not undo reject file or plugin operations (download, delete, etc.), so be careful and do not open scripts from untrusted sources!
    72 * **Export selected items** button allows to generate a custom configuration XML file automatically. When reading this file, the key-value pairs will replace existing ones or be appended to them (in case of properties containing lists or maps). You can use it together with the **Search** field to find all preferences you need to backup or share.
    73 
    74 == More ==
    75 **More** button launches the popup menu with extra actions:
    76 * **Save ... profile** - save part of preferences related to shortcuts, colors, toolbar and imagery to separate custom configuration XML files.
    77 * **Load profile** - replace existing part of preferences with previously saved fragment (for example, reset all shortcuts to default and then load them from file). User should press OK to confirm changes.
    78 * **Reset preferences** - delete all entries from preferences.xml (files are not deleted).
    79 
    80 See also [Help/ResetPreferences Reset preferences].
    81 
    82 == See also ==
    83 * [wiki:Help/Preferences]  - more information on custom configuration (preferences.xml): scripts, file format and command line parameters
    84 
    8597----
    86 Back to [wiki:Help/Action/Preferences Preferences][[Br]]
    87 Back to [wiki:/Help Main Help]
     98* Back to [wiki:Help/Action/Preferences Preferences dialog]
     99* Back to [wiki:/Help Main Help]