source: josm/trunk/linux/latest/usr/share/man/man1/josm-latest.1 @ 11254

Last change on this file since 11254 was 11254, checked in by bastiK, 3 years ago

see #13913 - update man page

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