Changes between Version 3 and Version 4 of Ru:Help/CommandLineOptions


Ignore:
Timestamp:
2018-03-27T09:32:25+02:00 (7 years ago)
Author:
ak099
Comment:

обновление до ревизии 31

Legend:

Unmodified
Added
Removed
Modified
  • Ru:Help/CommandLineOptions

    v3 v4  
    1 [[TranslatedPages(revision=25)]]
     1[[TranslatedPages(revision=31)]]
    22
    33= Параметры командной строки =
    44{{{#!comment
    5 Нет оглавления.
     5Нет оглавления. Вместо этого первый параграф знакомит с проблемой и предлагает внутренние сслыки на заголовки.
    66}}}
    77JOSM управляется тремя группами параметров командной строки.
    8 Наиболее важны [#Programarguments аргументы программы], затем [#Javaoptions опции Java]. Только на Web Start влияют [#run-options опции запуска]. См. [#Examples примеры]
     8Наиболее важны [#Programarguments аргументы программы⤓], затем [#Javaoptions опции Java⤓].
     9Смотрите [#Examples примеры⤓] использования тех и других.
     10Только на Web Start влияют [#run-options опции запуска⤓].
     11В последней секции рассматриваются [#Otheroptions другие⤓] опции, которые используются где-то в этом справочном руководстве.
    912
    1013{{{
     
    1922=== Аргументы программы ===#Programarguments
    2023
    21 Также именуются ''аргументами после jar'' здесь или ''args'' в документации Oracle.
     24Также именуются ''аргументами после jar'' здесь или ''args'' в документации по Java.
    2225
    2326Первый аргумент воспринимается JOSM как ''команда''. Возможные команды: `runjosm` для обычного запуска (по умолчанию), `render` для генерации файла изображения и `project` для преобразования координат. Если JOSM не может распознать команду, он выполняет команду, используемую по умолчанию.
     
    6164Аргументы `--download`, `--downloadgps` и `--selection` обрабатываются именно в таком порядке, как перечислены здесь.
    6265Значение `<url-to-xml>` может указывать на локальный файл `file:relative/path/name.xml`.
     66Более подробный вывод, чем --debug, обеспечивает опция `--trace`.
    6367Элементы значения `--offline` разделяются запятыми.
    6468
     
    6670=== Опции Java ===#Javaoptions
    6771
    68 Опции Java именуются также ''опциями JOSM JVM'' здесь или ''аргументами VM'' в [wiki:/Ru:Help/Action/ShowStatusReport отчёте о состоянии]. В этом отчёте можно увидеть их, а также  аргументы программы. Они управляют виртуальной машиной Java [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)] и могут задавать [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html свойства] внутри неё. JOSM читает некоторые из них, например `josm.home` и `user.language`.
     72Опции Java именуются также ''опциями JOSM JVM'' здесь или ''аргументами VM'' в [wikitr:/Help/Action/ShowStatusReport отчёте о состоянии]. В этом отчёте можно увидеть аргументы, с которыми была запущена программа, а ниже их — аргументы VM. Они управляют виртуальной машиной Java [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)] и могут задавать [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html свойства] внутри неё. JOSM читает некоторые из них, например `josm.home` и `user.language`.
    6973{{{
    7074Опции Java:
     
    8488
    8589Опция `-Xmx...m` может быть полезна при возникновении ошибок [wiki:/Ru:Download#Outofmemory «не хватает памяти»].
    86 Если вы укажете общий каталог опцией `Djosm.home`, то JOSM создаст подкаталоги ''./autosave'', ''./cache'' и ''./validator''.
     90Если вы укажете общий каталог опцией `Djosm.home`, то JOSM создаст подкаталоги ./autosave, ./cache и ./validator.
    8791Если значение содержит пробелы, заключите их в кавычки, вот так: `"josm dev"`.
     92Если в командной строке встречаются не-ASCII символы, используйте `-Dfile.encoding=Cp850` для получения текста из Java в другой [https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html кодировке].
     93То, какая [https://msdn.microsoft.com/de-de/library/windows/desktop/dd317756%28v=vs.85%29.aspx кодировка] используется, покажет `chcp⏎` в терминале.
    8894
    89 === Опции запуска ===
    90 Опции запуска следуют за командой `javaws`. Они управляют механизмом Web Start и средой для JVM.
    91 {{{
    92   -offline                  Позволяют выполнить Web Start JOSM без доступа к Интернету
    93   -J<опции java>            Передаёт <опции java> в JVM
    94   -J-Xmx1024m               Здесь: задать максимальный размер кучи Java равным 1024 МБ
    95 }}}
    96 
    97 Опция `-J` берёт свою часть после буквы J и передаёт её в качестве опций Java.
    98 [wiki:/Ru:Help/jnlpOptions Файл .jnlp], используемый [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start], предлагает и другой способ [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html  задать опции] для JRE и непосредственно на программы JOSM.
    99 
    100 
    101 === Примеры ===
     95=== Примеры ===#Examples
     96Примеры аргументов программы и опций Java в действии:
    10297{{{
    10398#!sh
     
    111106# Задать каталог для JOSM согласно переменной окружения из операционной системы
    112107  java -Djosm.pref=$XDG_CONFIG_HOME jar josm.jar
    113 # Кавычки для значения с пробелом
    114   java -Djosm.dir.name="josm dev" -jar josm.jar
     108# Кавычки для значения с пробелом и показ интерфейса JOSM на английском языке
     109  java -Djosm.dir.name="josm dev" -jar josm.jar --language=en
    115110# Задать общий каталог в подкаталоге
    116111  java -Djosm.home=biketour2017/london -jar josm.jar
     
    118113  java -Xmx1024m -Duser.language=fr -jar josm.jar
    119114#
    120 # Журналировать всё происходящее на английском
    121   java -verbose  -jar josm-latest.jar --language=en --debug >WhatsUp.txt
     115# Не беспокоить уведомлениями и выводить отладочную информацию
     116java -verbose -jar josm-latest.jar --set=message.notifier.enabled=false --debug >WhatsUp.txt
    122117}}}
    123118
     119
     120=== Опции запуска ===#run-options
     121Опции запуска следуют за командой `javaws`. Они управляют механизмом Web Start и средой для JVM.
     122{{{
     123  -offline                  Позволяет осуществлять Web Start JOSM без доступа к интернету
     124  -J<опции java>            Передаёт <опции java> в JVM
     125  -J-Xmx1024m               Здесь: задать максимальный размер кучи Java равным 1024 МБ
     126}}}
     127
     128Опция `-J` берёт свою часть после буквы J и передаёт её в качестве опций Java.
     129[wiki:/Help/jnlpOptions Файл jnlp], используемый [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start], предлагает другой способ [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html  задать опции] для JRE и непосредственно для программы JOSM.
     130
     131=== Другие опции ===#Otheroptions
     132Команда javaws на всех системах и josm.exe в MS Windows имеют несколько дополнительных [http://launch4j.sourceforge.net/docs.html#Runtime_options опций].
     133{{{
     134#!sh
     135javaws -viewer            Показ просмотрщика кэша в панели управления Java
     136# Позволяет открывать панель управления Java из командной строки.
     137
     138javaws -clearcache        Убирает все неустановленные приложения из кэша
     139# Эквивалентно 'Delete Files and Applications', выполненному из 'Temporary File Settings'
     140# кнопкой 'Settings' во вкладке 'General' панели управления Java.
     141# javaws -Xclearcache в OpenJDK
     142
     143josm.exe --j4l-debug      Пытается записать launch4j.log в текущий каталог
     144josm.exe --j4l-dont-wait  Завершает выполнение обёртки после вызова JOSM.
     145
     146}}}
     147И опция `-clearcache`, и очистка кэша через панель управления Java, удаляют связанные с JNLP значки с рабочего стола. Значок JOSM будет удалён, если он был размещён там в результате щелчка в веб-браузере на jnlp-файле.
     148 
     149
     150
    124151=== Смотрите также ===
    125 * [wiki:Ru:Download#Troubleshooting Решение проблем с Java]
    126 * [wiki:Ru:InstallNotes Примечания по установке]
    127 * [wiki:Ru:Help/Preferences Настройки] - обзорная страница обо всех настройках
     152* [wiki:/Ru:Download#Troubleshooting Решение проблем с Java]
     153* [wikitr:/InstallNotes Примечания по установке]
     154* [wikitr:/Help/Preferences Настройки] - обзор настроек
     155* [.. Основная страница]