[17641] | 1 | .TH JOSM 1 "March 22, 2021"
|
---|
[7494] | 2 | .\" Please adjust this date whenever revising the manpage.
|
---|
| 3 | .SH NAME
|
---|
| 4 | josm \- Java OpenStreetMap Editor
|
---|
| 5 | .SH SYNOPSIS
|
---|
| 6 | .B josm
|
---|
| 7 | .SH DESCRIPTION
|
---|
| 8 | .B JOSM
|
---|
[10580] | 9 | is an editor for OpenStreetMap written in Java 8.
|
---|
[7494] | 10 | .PP
|
---|
| 11 | .B OpenStreetMap
|
---|
| 12 | is a project aimed squarely at creating and providing free geographic data such as street maps to anyone
|
---|
| 13 | who wants them. It allows you to view, edit and use geographical data in a collaborative way from
|
---|
| 14 | anywhere on earth.
|
---|
| 15 | The project was started because most maps you think of as free actually have legal or technical
|
---|
| 16 | restrictions on their use, holding back people from using them in creative, productive or unexpected
|
---|
| 17 | ways.
|
---|
| 18 | .SH OPTIONS
|
---|
| 19 | .TP
|
---|
| 20 | .B \-h, \-?, \-\-help
|
---|
| 21 | Show help
|
---|
| 22 | .TP
|
---|
| 23 | .B \-\-geometry=<width>x<height>(+|-)x(+|-)y
|
---|
| 24 | Standard X geometry argument
|
---|
| 25 | .TP
|
---|
| 26 | .B [\-\-download=]minlat,minlon,maxlat,maxlon
|
---|
| 27 | Download the bounding box
|
---|
| 28 | .TP
|
---|
| 29 | .B [\-\-download=]<url>
|
---|
| 30 | Download the location at the url (with lat=x&lon=y&zoom=z)
|
---|
| 31 | .TP
|
---|
| 32 | .B [\-\-download=]<filename>
|
---|
| 33 | Open file (any file type that can be opened with File/Open)
|
---|
| 34 | .TP
|
---|
| 35 | .B \-\-downloadgps=minlat,minlon,maxlat,maxlon
|
---|
| 36 | Download the bounding box as raw gps
|
---|
| 37 | .TP
|
---|
| 38 | .B \-\-selection=<searchstring>
|
---|
| 39 | Select with the given search
|
---|
| 40 | .TP
|
---|
| 41 | .B \-\-[no\-]maximize
|
---|
| 42 | Do [not] launch in maximized mode
|
---|
| 43 | .TP
|
---|
| 44 | .B \-\-reset\-preferences
|
---|
| 45 | Reset the preferences to the default
|
---|
| 46 | .TP
|
---|
| 47 | .B \-\-load\-preferences=<url\-to\-xml>
|
---|
| 48 | Change preferences according to the XML file
|
---|
| 49 | .TP
|
---|
| 50 | .B \-\-set=<key>=<value>
|
---|
| 51 | Set preference key to value
|
---|
| 52 | .TP
|
---|
| 53 | .B \-\-language=<language>
|
---|
| 54 | Set the language
|
---|
| 55 | .TP
|
---|
| 56 | .B \-\-version
|
---|
| 57 | Display the JOSM version
|
---|
| 58 | .TP
|
---|
[17638] | 59 | .B \-\-status-report
|
---|
| 60 | Show status report with useful information that can be attached to bugs
|
---|
| 61 | .TP
|
---|
[7494] | 62 | .B \-\-debug
|
---|
| 63 | Print debugging messages to console
|
---|
| 64 | .TP
|
---|
[16446] | 65 | .B \-\-offline=<OSM_API|JOSM_WEBSITE|CACHE_UPDATES|CERTIFICATES|ALL>
|
---|
[7494] | 66 | Disable access to the given resource(s), separated by comma
|
---|
[11254] | 67 | .SH FILES
|
---|
| 68 | JOSM files are saved according to the XDG Base Directory Specification:
|
---|
| 69 | .TP
|
---|
| 70 | .B $HOME/.config/JOSM
|
---|
| 71 | Preferences
|
---|
| 72 | .TP
|
---|
| 73 | .B $HOME/.local/share/JOSM
|
---|
| 74 | User data
|
---|
| 75 | .TP
|
---|
| 76 | .B $HOME/.cache/JOSM
|
---|
| 77 | Cache
|
---|
| 78 | .TP
|
---|
| 79 | If the directory $HOME/.josm exists, all files are stored there.
|
---|
[7843] | 80 | .SH JAVA PROPERTIES
|
---|
| 81 | The following options can be set by using Java system properties (i.e. \-Dkey=value
|
---|
| 82 | passed to java, or specified inside JAVA_OPTS).
|
---|
| 83 | .TP
|
---|
| 84 | .B josm.pref=<path>
|
---|
| 85 | Set the JOSM preferences directory.
|
---|
| 86 | .TP
|
---|
| 87 | .B josm.userdata=<path>
|
---|
| 88 | Set the JOSM user data directory.
|
---|
| 89 | .TP
|
---|
| 90 | .B josm.cache=<path>
|
---|
| 91 | Set the JOSM cache directory.
|
---|
| 92 | .TP
|
---|
| 93 | .B josm.home=<homedir>
|
---|
[11254] | 94 | Relocate all 3 directories to homedir. Cache directory will be in <homedir>/cache.
|
---|
| 95 | .TP
|
---|
[17345] | 96 | .B josm.dir.name=<JOSM>
|
---|
[11254] | 97 | Change the JOSM directory name.
|
---|
[7494] | 98 | .SH ENVIRONMENT
|
---|
| 99 | .IP JAVA_HOME
|
---|
| 100 | Specify an alternate Java environment.
|
---|
| 101 | .IP JAVA_OPTS
|
---|
| 102 | Specify Java options.
|
---|
| 103 | For example, to use a HTTP proxy server with this program, set this environment variable
|
---|
| 104 | to something like
|
---|
| 105 | .I JAVA_OPTS="-Dhttp.proxyHost=yourProxyURL"
|
---|
| 106 | before starting josm.
|
---|
| 107 | .SH AUTHOR
|
---|
| 108 | JOSM was originally designed and coded by Immanuel Scholz,
|
---|
| 109 | and is now maintained by the OpenStreetMap community.
|
---|
| 110 | .PP
|
---|
| 111 | The current JOSM maintainer is Dirk Stöcker.
|
---|
| 112 | A lot of administration work is done by Paul Hartmann and Vincent Privat.
|
---|
| 113 | .PP
|
---|
| 114 | Major code contributions from (in alphabetical order):
|
---|
| 115 | .PP
|
---|
| 116 | Stefan Breunig
|
---|
| 117 | David Earl
|
---|
| 118 | Gabriel Ebner
|
---|
| 119 | Dave Hansen
|
---|
| 120 | Paul Hartmann
|
---|
| 121 | Karl Guggisberg
|
---|
| 122 | Matthias Julius
|
---|
| 123 | Alexei Kasatkin
|
---|
| 124 | Jiri Klement
|
---|
| 125 | Ulf Lamping
|
---|
| 126 | Simon Legner
|
---|
| 127 | Raphael Mack
|
---|
| 128 | Upliner Mikhalych
|
---|
| 129 | Vincent Privat
|
---|
| 130 | Frederik Ramm
|
---|
| 131 | Dirk Stöcker
|
---|
| 132 | .PP
|
---|
| 133 | Many minor contributions and patches by others; see SVN history
|
---|
[13454] | 134 | at https://josm.openstreetmap.de/svn/ for details. Use
|
---|
[7494] | 135 | "josm-dev AT openstreetmap.org" to contact still active authors.
|
---|
[7843] | 136 | The logo has been designed by Ilya Palikov.
|
---|
[7494] | 137 | .PP
|
---|
| 138 | This manual page was initially written by Andreas Putzo <andreas@putzo.net>,
|
---|
| 139 | for the Debian project (but may be used by others).
|
---|