[[TranslatedPages(revision=22)]]

== Получение актуальных сведений об использовании ==
Чтобы получить актуальные на данный момент сведения об использовании параметров командной строки (информация будет переведённой на ваш язык) запустите JOSM с параметром --help:
{{{
java -jar josm-tested.jar --help
}}}

Соответствующая часть исходного кода: [source:trunk/src/org/openstreetmap/josm/gui/MainApplication.java#L130 org/openstreetmap/josm/gui/MainApplication.java#L130].

= Приведённые ниже сведения могут быть устаревшими =
== Использование ==

Использование:
{{{
#!sh
java <опции Java> <опции JOSM JVM> -jar josm-tested.jar <опции после jar> [файл]
}}}

или 

{{{
#!sh
javaws https://josm.openstreetmap.de/download/josm.jnlp
javaws [опции] [URL или путь к файлу josm.jnlp]
}}}


Документация Java 8 о javaws: https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html

=== Опции Java ===
{{{
-Xmx...m                                  Задаёт максимальный размер кучи (heap) Java в мегабайтах
}}}

При выполнении некоторых задач JOSM весьма прожорлив в отношении памяти. С одной стороны, может быть необходимо настроить размер памяти -Xmx для поддержки большего количества плагинов JOSM и дополнительных функций редактирования в JOSM. С другой стороны, на медленных компьютерах или компьютерах с меньшим количеством памяти можно достичь большей стабильности, ограничив использование памяти JOSM.  Ниже приведены примеры настройки памяти Java по порядку от компьютеров с меньшей памятью до компьютеров с большим количеством свободной памяти.
{{{
-Xmx256m
-Xmx512m
-Xmx768m
-Xmx1024m
-Xmx1536m
-Xmx2048m
}}}

=== Опции JOSM JVM ===

provided as Java system properties
{{{
-Djosm.pref=/PATH/TO/JOSM/PREF            Указывать путь к каталогу настроек
-Djosm.userdata=/PATH/TO/JOSM/USERDATA    Указывать путь к каталогу данных пользователя
-Djosm.cache=/PATH/TO/JOSM/CACHE          Указывать путь к каталогу кэша
-Djosm.home=/PATH/TO/JOSM/HOMEDIR         Перебазирует все 3 каталога в homedir.
-Djosm.home=/path/to/JOSM/folder/         Изменить каталог для всех пользовательских настроек. Каталог кэша будет в homedir/cache
}}}
**Примечание**: `-Djosm.home` имеет меньший приоритет, т.к. более специфичные настройки перекрывают более общую

=== Опции после jar ===

Эти опции необходимо вставлять после части -jar josm.jar командной строки.

{{{
--help|-h                                 Показать эту справку
--geometry=widthxheight(+|-)x(+|-)y       Стандартный параметр геометрии Unix
[--download=]minlat,minlon,maxlat,maxlon  Скачать область в пределах рамки
[--download=]<URL>                        Скачать область по URL (с lat=x&lon=y&zoom=z)
[--download=]<filename>                   Открыть файл (любой тип файла, который можно открыть через меню Файл/Открыть)
--downloadgps=minlat,minlon,maxlat,maxlon Скачать область в пределах рамки, как необработанные данные GPS
--downloadgps=<URL>                       Скачать область по URL (с lat=x&lon=y&zoom=z), как необработанные данные GPS
--selection=<searchstring>                Выбор с учетом поиска

--[no-]maximize                           Запуск с окном, развёрнутым во весь экран
--reset-preferences                       Сброс к настройкам по умолчанию
--load-preferences=<url-to-xml>           Изменить настройки, загрузив их из указанного XML-файла
--set=<key>=<value>                       Задать значение настройки key равным value
--language=<language>                     Выбрать язык
--version                                 Показать версию JOSM и выйти
--debug                                   Вывод отладочных сообщений в консоль
--skip-plugins                            Пропустить загрузку модулей
--offline=<osm_api|josm_website|all>      Отключить доступ к указанным ресурсам, разделённым запятыми
}}}

Примеры:
{{{
#!sh
java -jar josm.jar track1.gpx track2.gpx london.osm
java -jar josm.jar https://www.openstreetmap.org/#map=13/43.2/11.1
java -jar josm.jar london.osm --selection=http://www.ostertag.name/osm/OSM_errors_node-duplicate.xml
java -jar josm.jar 43.2,11.1,43.4,11.4
java -jar josm.jar --set=expert=true
java -Djosm.pref=$XDG_CONFIG_HOME -Djosm.userdata=$XDG_DATA_HOME -Djosm.cache=$XDG_CACHE_HOME -jar josm.jar
java -Djosm.home=/home/user/.josm_dev -jar josm.jar
java -Xmx1024m -jar josm.jar
}}}

Параметры `--download`, `--downloadgps` и `--selection` обрабатываются в этом порядке.
Убедитесь, что вы загрузили какие-либо данные, если используете `--selection`.

=== Смотрите также ===
* [wiki:Help/Preferences Настройки] - обзорная страница обо всех настройках
* [[Help/jnlpOptions]]