Changes between Version 23 and Version 24 of Help/Preferences


Ignore:
Timestamp:
2017-12-14T04:02:16+01:00 (6 years ago)
Author:
Mxdanger
Comment:

Grammar and updated MacOS information.

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences

    v23 v24  
    33Our 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.
    44
    5 You can get a similar raw view by viewing this file, but this [Help/Preferences/Advanced 'Advanced' preferences panel] is intended to provide a easier alternative.
     5You can get a similar raw view by viewing this file, but this [Help/Preferences/Advanced 'Advanced' preferences panel] is intended to provide an easier alternative.
    66
    77= Menus =
    … …  
    1919JOSM stores 3 kinds of files in different directories:
    2020 Preferences:: Configuration data and settings, such as authentication for the OSM server, list of last opened files, selection of expandable dialogs on the right, etc.
    21  User data:: User specific data files, for example autosave data, plugins and ignored validator errors
     21 User data:: User-specific data files, for example, autosave data, plugins and ignored validator errors
    2222 Cache:: Files downloaded from the internet and stored for a limited time to avoid repeated downloads and allow faster access. For example imagery tiles and startup news.
    2323
    … …  
    3030%APPDATA%\JOSM
    3131}}}
    32 To locate this folder, try opening Explorer window and paste following text in location, then hit enter: `%APPDATA%\JOSM`, On Windows Vista and later, it should be something like `C:\Users\<YourName>\AppData\Roaming\JOSM`. Note, that the directory `C:\Users\<YourName>\AppData` can be hidden by default.
     32To locate this folder, try opening Explorer window and paste the following text in location, then hit enter: `%APPDATA%\JOSM`, On Windows Vista and later, it should be something like `C:\Users\<YourName>\AppData\Roaming\JOSM`. Note, that the directory `C:\Users\<YourName>\AppData` can be hidden by default.
    3333
    3434The '''cache''' is located in
    … …  
    4242On Windows XP and earlier, the cache is in `%APPDATA%\JOSM\cache`.
    4343
    44 == Mac OS X ==
     44== MacOS==
    4545
    46 On Mac OS X, the default locations are as follows:
    47  Preferences:: `$HOME/Library/Preferences/JOSM`
    48  User data:: `$HOME/Library/JOSM`
    49  Cache:: `$HOME/Library/Caches/JOSM`
     46On MacOS, the default locations are as follows:
     47 Preferences:: `Users/<YourName>/Library/Preferences/JOSM`
     48 User data:: `Users/<YourName>/Library/JOSM`
     49 Cache:: `Users/<YourName>/Library/Caches/JOSM`
    5050
    5151== Linux ==
    … …  
    5656 Cache:: `$HOME/.cache/JOSM`
    5757
    58 JOSM respects the `$XDG_CONFIG_HOME`, `$XDG_DATA_HOME` and `$XDG_CACHE_HOME` environment variables to chance these locations.
     58JOSM respects the `$XDG_CONFIG_HOME`, `$XDG_DATA_HOME` and `$XDG_CACHE_HOME` environment variables to change these locations.
    5959
    6060Prior to r11162, the locations were
    … …  
    6363 Cache:: `$HOME/.josm/cache`
    6464
    65 JOSM will continue to use the old locations, if the directory `$HOME/.josm` exists. If you have a fresh installation, but prefer the old scheme, you can create the `$HOME/.josm` directory by hand.
     65JOSM will continue to use the old locations if the directory `$HOME/.josm` exists. If you have a fresh installation but prefer the old scheme, you can create the `$HOME/.josm` directory by hand.
    6666
    67 Note on hidden files: File names beginning with a dot are hidden on Linux. To show the contents of the hidden folder, use the file manager and enter "~/.josm" in the address line (if no address line is visible just try to enter a letter and hopefully a popup to enter the address will open). Alternatively it is possible to "show hidden" files and folders in the file manager, using the keyboard shortcut Ctrl+H.
     67Note on hidden files: File names beginning with a dot are hidden on Linux. To show the contents of the hidden folder, use the file manager and enter "~/.josm" in the address line (if no address line is visible just try to enter a letter and hopefully a popup to enter the address will open). Alternatively, it is possible to "show hidden" files and folders in the file manager, using the keyboard shortcut Ctrl+H.
    6868
    6969== Customization (all operating systems) ==
    7070
    7171=== Setting all 3 locations ===
     72
    7273The locations can be set using system properties specified from the [[Help/CommandLineOptions|commandline]]:
    7374 Preferences:: `-Djosm.pref=...`
    … …  
    7576 Cache:: `-Djosm.cache=...`
    7677
    77 For example to store the cache in `D:\cache\JOSM`, you would need to run a command like this:
     78For example to store the cache located in `D:\cache\JOSM`, you would need to run a command like this:
    7879{{{
    7980java -Djosm.cache=D:\cache\JOSM -jar josm.jar
    … …  
    9495=== Changing the directory base name ===
    9596
    96 Instead of specifying the full path for the JOSM directories, you can use the system property `-Djosm.dir.name=` to modify just the name of the last directory component, which is `JOSM` by default. This is especially useful in order to keep multiple ''profiles'' on one computer, which should not interfere. For example to have one profile for productive work with the stable tested version and one for the experimental development version, you would start the development version like this:
     97Instead of specifying the full path for the JOSM directories, you can use the system property `-Djosm.dir.name=` to modify just the name of the last directory component, which is `JOSM` by default. This is especially useful in order to keep multiple ''profiles'' on one computer, which should not interfere. For example, to have one profile for productive work with the stable tested version and one for the experimental development version, you would start the development version like this:
    9798{{{
    9899java -Djosm.dir.name=JOSM-dev -jar josm-latest.jar
    … …  
    103104 Cache:: `$HOME/.cache/JOSM-dev`
    104105
    105 (For locations in the style prior to r11162, the lower-case version with prepended dot will be used, e.g. `$HOME/.josm-dev`.)
     106(For locations in the style prior to r11162, the lower-case version with the prepended dot will be used, e.g. `$HOME/.josm-dev`.)
    106107
    107108== preferences.xml Schema ==
     109
    108110http://josm.openstreetmap.de/preferences-1.0
    109111
    110112Some descriptions can be found in [[Help/Preferences/ImportExport]] (stub)
    111 
    112113
    113114== Auto save subfolder ==