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 FILES
|
---|
65 | JOSM files are saved according to the XDG Base Directory Specification:
|
---|
66 | .TP
|
---|
67 | .B $HOME/.config/JOSM-latest
|
---|
68 | Preferences
|
---|
69 | .TP
|
---|
70 | .B $HOME/.local/share/JOSM-latest
|
---|
71 | User data
|
---|
72 | .TP
|
---|
73 | .B $HOME/.cache/JOSM-latest
|
---|
74 | Cache
|
---|
75 | .TP
|
---|
76 | If the directory $HOME/.josm-latest exists, all files are stored there.
|
---|
77 | .SH JAVA PROPERTIES
|
---|
78 | The following options can be set by using Java system properties (i.e. \-Dkey=value
|
---|
79 | passed to java, or specified inside JAVA_OPTS).
|
---|
80 | .TP
|
---|
81 | .B josm.pref=<path>
|
---|
82 | Set the JOSM preferences directory.
|
---|
83 | .TP
|
---|
84 | .B josm.userdata=<path>
|
---|
85 | Set the JOSM user data directory.
|
---|
86 | .TP
|
---|
87 | .B josm.cache=<path>
|
---|
88 | Set the JOSM cache directory.
|
---|
89 | .TP
|
---|
90 | .B josm.home=<homedir>
|
---|
91 | Relocate all 3 directories to homedir. Cache directory will be in <homedir>/cache.
|
---|
92 | .TP
|
---|
93 | .B josm.name=<JOSM-latest>
|
---|
94 | Change the JOSM directory name.
|
---|
95 | .SH ENVIRONMENT
|
---|
96 | .IP JAVA_HOME
|
---|
97 | Specify an alternate Java environment.
|
---|
98 | .IP JAVA_OPTS
|
---|
99 | Specify Java options.
|
---|
100 | For example, to use a HTTP proxy server with this program, set this environment variable
|
---|
101 | to something like
|
---|
102 | .I JAVA_OPTS="-Dhttp.proxyHost=yourProxyURL"
|
---|
103 | before starting josm.
|
---|
104 | .SH AUTHOR
|
---|
105 | JOSM was originally designed and coded by Immanuel Scholz,
|
---|
106 | and is now maintained by the OpenStreetMap community.
|
---|
107 | .PP
|
---|
108 | The current JOSM maintainer is Dirk Stöcker.
|
---|
109 | A lot of administration work is done by Paul Hartmann and Vincent Privat.
|
---|
110 | .PP
|
---|
111 | Major code contributions from (in alphabetical order):
|
---|
112 | .PP
|
---|
113 | Stefan Breunig
|
---|
114 | David Earl
|
---|
115 | Gabriel Ebner
|
---|
116 | Dave Hansen
|
---|
117 | Paul Hartmann
|
---|
118 | Karl Guggisberg
|
---|
119 | Matthias Julius
|
---|
120 | Alexei Kasatkin
|
---|
121 | Jiri Klement
|
---|
122 | Ulf Lamping
|
---|
123 | Simon Legner
|
---|
124 | Raphael Mack
|
---|
125 | Upliner Mikhalych
|
---|
126 | Vincent Privat
|
---|
127 | Frederik Ramm
|
---|
128 | Dirk Stöcker
|
---|
129 | .PP
|
---|
130 | Many minor contributions and patches by others; see SVN history
|
---|
131 | at https://josm.openstreetmap.de/svn/ for details. Use
|
---|
132 | "josm-dev AT openstreetmap.org" to contact still active authors.
|
---|
133 | The logo has been designed by Ilya Palikov.
|
---|
134 | .PP
|
---|
135 | This manual page was initially written by Andreas Putzo <andreas@putzo.net>,
|
---|
136 | for the Debian project (but may be used by others).
|
---|