| 1 | .TH JOSM 1 "July 21, 2016" |
|---|
| 2 | .\" Please adjust this date whenever revising the manpage. |
|---|
| 3 | .SH NAME |
|---|
| 4 | josm \- Java OpenStreetMap Editor |
|---|
| 5 | .SH SYNOPSIS |
|---|
| 6 | .B josm-latest |
|---|
| 7 | .SH DESCRIPTION |
|---|
| 8 | .B JOSM |
|---|
| 9 | is an editor for OpenStreetMap written in Java 8. |
|---|
| 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 |
|---|
| 59 | .B \-\-debug |
|---|
| 60 | Print debugging messages to console |
|---|
| 61 | .TP |
|---|
| 62 | .B \-\-offline=<osm_api|josm_website|all> |
|---|
| 63 | Disable access to the given resource(s), separated by comma |
|---|
| 64 | .SH JAVA PROPERTIES |
|---|
| 65 | The following options can be set by using Java system properties (i.e. \-Dkey=value |
|---|
| 66 | passed to java, or specified inside JAVA_OPTS). |
|---|
| 67 | .TP |
|---|
| 68 | .B josm.pref=<path> |
|---|
| 69 | Set the JOSM preferences directory. |
|---|
| 70 | .TP |
|---|
| 71 | .B josm.userdata=<path> |
|---|
| 72 | Set the JOSM user data directory. |
|---|
| 73 | .TP |
|---|
| 74 | .B josm.cache=<path> |
|---|
| 75 | Set the JOSM cache directory. |
|---|
| 76 | .TP |
|---|
| 77 | .B josm.home=<homedir> |
|---|
| 78 | Relocate all 3 directories to homedir. Cache directory will be in homedir/cache. |
|---|
| 79 | Default is ~/.josm/. |
|---|
| 80 | .SH ENVIRONMENT |
|---|
| 81 | .IP JAVA_HOME |
|---|
| 82 | Specify an alternate Java environment. |
|---|
| 83 | .IP JAVA_OPTS |
|---|
| 84 | Specify Java options. |
|---|
| 85 | For example, to use a HTTP proxy server with this program, set this environment variable |
|---|
| 86 | to something like |
|---|
| 87 | .I JAVA_OPTS="-Dhttp.proxyHost=yourProxyURL" |
|---|
| 88 | before starting josm. |
|---|
| 89 | .SH AUTHOR |
|---|
| 90 | JOSM was originally designed and coded by Immanuel Scholz, |
|---|
| 91 | and is now maintained by the OpenStreetMap community. |
|---|
| 92 | .PP |
|---|
| 93 | The current JOSM maintainer is Dirk Stöcker. |
|---|
| 94 | A lot of administration work is done by Paul Hartmann and Vincent Privat. |
|---|
| 95 | .PP |
|---|
| 96 | Major code contributions from (in alphabetical order): |
|---|
| 97 | .PP |
|---|
| 98 | Stefan Breunig |
|---|
| 99 | David Earl |
|---|
| 100 | Gabriel Ebner |
|---|
| 101 | Dave Hansen |
|---|
| 102 | Paul Hartmann |
|---|
| 103 | Karl Guggisberg |
|---|
| 104 | Matthias Julius |
|---|
| 105 | Alexei Kasatkin |
|---|
| 106 | Jiri Klement |
|---|
| 107 | Ulf Lamping |
|---|
| 108 | Simon Legner |
|---|
| 109 | Raphael Mack |
|---|
| 110 | Upliner Mikhalych |
|---|
| 111 | Vincent Privat |
|---|
| 112 | Frederik Ramm |
|---|
| 113 | Dirk Stöcker |
|---|
| 114 | .PP |
|---|
| 115 | Many minor contributions and patches by others; see SVN history |
|---|
| 116 | at http://josm.openstreetmap.de/svn/ for details. Use |
|---|
| 117 | "josm-dev AT openstreetmap.org" to contact still active authors. |
|---|
| 118 | The logo has been designed by Ilya Palikov. |
|---|
| 119 | .PP |
|---|
| 120 | This manual page was initially written by Andreas Putzo <andreas@putzo.net>, |
|---|
| 121 | for the Debian project (but may be used by others). |
|---|
