New upstream version 2.0-0.9

man/Makefile

@@ -9,8 +9,7 @@ MANPAGES = dosemu.1 dosemu.bin.1 ru/dosemu.1 ru/dosemu.bin.1
 default all: $(MANPAGES)
 
 .NOTPARALLEL: $(MANPAGES)
-$(MANPAGES): $(top_builddir)/config.status $(wildcard $(top_srcdir)/man/*.1.in) \
-    $(wildcard $(top_srcdir)/man/ru/*.1.in)
+$(MANPAGES): $(top_builddir)/config.status $(wildcard $(top_srcdir)/man/*.1.in)
 	cd $(top_builddir) && ./config.status
 
 install: all
@@ -25,5 +24,6 @@ install: all
 
 clean realclean:
 	for i in `ls $(top_srcdir)/man/*.1.in $(top_srcdir)/man/ru/*.1.in` ; do \
-	    rm -f `echo $$i | sed -E -e 's=$(top_srcdir)/man/(.+).in$$=\1='`; \
+	    rm -f `echo $$i | sed -s -e 's/\.in$$//' \
+		    -e 's=$(top_srcdir)/man/=='`; \
 	done

man/dosemu.1.in

@@ -1,7 +1,7 @@
 .\" -*- nroff -*-  (This is for Emacs)
 .TH DOSEMU 1 "@RELEASE_DATE@" "Version @PACKAGE_VERSION@" "DOS Emulation"
 .SH NAME
-dosemu \- run DOS and DOS programs under Linux
+dosemu, xdosemu \- run DOS and DOS programs under Linux
 .SH SYNOPSIS
 .B dosemu
 [
@@ -15,19 +15,31 @@ dosemu \- run DOS and DOS programs under Linux
 .B \-s
 ]
 [
-.I env1=val1
-.I ...
+.B \-install
+.I [ bootdir ]
 ]
 [
-.I unix_path_to_dos_prog
-[
-.I --
-]
-[
-.I dos_cmd_args
-]
+.B args
 ]
 .PP
+.B xdosemu
+[
+.B \-dumb
+]
+[
+.B \-input
+.I keystroke-string
+]
+[
+.B \-s
+]
+[
+.B \-install
+.I [ bootdir ]
+]
+[
+.B args
+]
 .SH DESCRIPTION
 .B dosemu
 is the wrapper script for
@@ -35,6 +47,9 @@ is the wrapper script for
 (1)
 which invokes the Linux dos emulator, also known as
 .BR DOSEMU .
+The wrapper also takes care of (eventually) installing the private instance of
+.BR DOSEMU
+in the user's $HOME, if this doesn't exist.
 .br
 
 .SH OPTIONS
@@ -68,7 +83,17 @@ of the string look at README.txt.
 Invoke dosemu via sudo. This is necessary to get access to certain I/O ports
 and to get graphics on the Linux console. Please refer to the documentation
 (INSTALL and README.txt) to see which files need to be adjusted before
-attempting this.
+attempting this. 
+.TP
+.I -install [ bootdir ]
+launched as part of a systemwide installation, this option (re-)installs
+a DOS that is used in DOSEMU (this can be the DOSEMU distributed
+FreeDOS  or any proprietary DOS, which is bootable via fatfs).
+.I bootdir
+is the base name of a directory. The symbolic link ~/.dosemu/drives/c
+will be changed to point to this directory.
+Re-installing is only rarely necessary, since in practise the symbolic
+link(s) will automatically point to updated files.
 .TP
 .I --version
 print version of dosemu and list of available options.

man/dosemu.bin.1.in

@@ -64,7 +64,11 @@ dosemu.bin, dosdebug \- run DOS and DOS programs under Linux
 ]
 [
 .B \-i
-.I \h'-1' input_data
+.I \h'-1'[bootdir]
+]
+[
+.B \-U
+.I number of path components
 ]
 [
 .B \-E
@@ -72,20 +76,7 @@ dosemu.bin, dosdebug \- run DOS and DOS programs under Linux
 ]
 [
 .B \-K
-.I unix_path[:dos_path]
-]
-[
-.I env1=val1
-.I ...
-]
-[
-.I unix_path_to_dos_prog
-[
-.I --
-]
-[
-.I dos_cmd_args
-]
+.I unix_path
 ]
 .sp
 .B dosdebug
@@ -170,28 +161,18 @@ command.
 .TP
 .I -K unix_path[:dos_path]
 Specify unix path for the program running with \-E.
-You can omit \-E and specify the full unix path with \-K, but it is
-not recommended and may be removed in the future. You need to specify
-a directory path to \-K.
-.br
-If dos_path is specified, then it is used as a current directory when
-invoking the command. If unix_path is empty then the drive letter is
-taken from dos_path:
+You can omit \-E and specify the full unix path with \-K, but passing
+command-line arguments via \-K is not recommended and may be removed
+in the future. The following may nevertheless work:
 .nf
-dosemu -K :C:\\\\games\\\\carma -E carma.exe
+dosemu -K "/home/joeuser/dosemu/freedos/bin/xcopy.exe my_file my_dir"
 .fi
-This runs carma.exe from C:\\games\\carma
+If dos_path is specified, then it is used as a current directory when
+invoking the command.
 .TP
-.I -T[flags]
-Sets flags for -E and -K commands. "flags" is the string of the
-following chars:
-
-1: don't terminate DOSEMU after running the command specified either
+.I -T
+Don't terminate DOSEMU after running the command specified either
 with -E or -K.
-
-h: try to load the specified command into UMB (loadhigh).
-
-If -T is specified without flags, then "1h" flags string is assumed.
 .TP
 .I -q
 Quiet mode. Suppress all DOS output except that of the command specified
@@ -219,12 +200,10 @@ Bypass the default directory for bootdirectory and hdimages (DOSEMU_IMAGE_DIR)
 and use this directory instead.
 .TP
 .I -f
-Parse this config-file instead of .dosemurc. If -n is also specified, then
-this config file is parsed instead of the primary dosemu.conf.
+Parse this config-file instead of .dosemurc
 .TP
 .I -n
-Bypass (don't use) default user's config .dosemurc. The config specified
-with -f is still parsed, but in that case it replaces the main dosemu.conf.
+Bypass (don't use) user's config .dosemurc.
 .TP
 .I -L <log_string>
 Writes provided <log_string> to a log.
@@ -255,12 +234,15 @@ because it is expected to be
 .I one
 argument.
 .TP
-.I -i input_data
-Type
-.I input_data
-on the emulated keyboard. Use \\r for Enter. Various other special escapes
-are available, for example you can insert pauses with "\\p10;" where
-10 is a delay in tens of milliseconds.
+.I -i[bootdir]
+launched as part of a systemwide installation, this option (re-)installs
+a DOS that is used in DOSEMU (this can be the DOSEMU distributed
+FreeDOS  or any proprietary DOS, which is bootable via fatfs).
+.I bootdir
+is the base name of a directory. The symbolic link ~/.dosemu/drives/c
+will be changed to point to this directory.
+Re-installing is only rarely necessary, since in practise the symbolic
+link(s) will automatically point to updated files.
 .TP
 .I -D
 specify which Debugging messages to allow/suppress
@@ -309,13 +291,11 @@ DIRECT HARDWARE ACCESS TO DOS PROGRAMS MAY GIVE THESE THE ABILITY
 TO LOCK YOUR COMPUTER, OR (IN RARE CASES) EVEN DAMAGE HARDWARE.
 ONLY TRUSTED LOCAL USERS SHOULD BE GIVEN THIS TYPE OF ACCESS.
 .TP
-.I -t[de[flag]]
+.I -t[de]
 terminal mode: run using the S-Lang library by default, or, if 'd'
 is specified - use "dumb" terminal mode. If 'de' is specified,
 use stderr in dumb terminal mode, except for the output of the
-program started with -E that still goes to stdout. If 'de2' is
-specified (flag==2), then also the output of -E-started program
-goes to stderr.
+program started with -E that still goes to stdout.
 .TP
 .I -V
 use direct console video with VGA graphics and use the native graphics 

man/ru/dosemu.1.in

@@ -1,7 +1,7 @@
 .\" -*- nroff -*-  (This is for Emacs)
 .TH DOSEMU 1 "@RELEASE_DATE@" "Версия @PACKAGE_VERSION@" "Эмуляция DOS"
 .SH ИМЯ
-dosemu \- запускает DOS и приложения DOS под Linux
+dosemu, xdosemu \- запускает DOS и приложения DOS под Linux
 .SH СИНТАКСИС
 .B dosemu
 [
@@ -15,18 +15,31 @@ dosemu \- запускает DOS и приложения DOS под Linux
 .I строка_клавиш
 ]
 [
-.I env1=val1
-.I ...
+.B \-install
+.I загрузочный_каталог
 ]
 [
-.I unix_путь_к_дос_программе
-[
-.I --
-]
-[
-.I аргументы_дос_команды
+.B аргументы
 ]
 .PP
+.B xdosemu
+[
+.B \-dumb
+]
+[
+.B \-home
+]
+[
+.B \-input
+.I строка_клавиш
+]
+[
+.B \-install
+.I загрузочный_каталог
+]
+[
+.B аргументы
+]
 .SH ОПИСАНИЕ
 .B dosemu
 является оберточным скриптом для
@@ -75,6 +88,16 @@ dosemu \- запускает DOS и приложения DOS под Linux
 нажатия на клавишу F8. Так в этом случае всегда необходимо добавлять символ
 "\\r" в начало строки_клавиш. Как побочный эффект это даст проход ожидания
 "F8", и FreeDos будет загружаться быстрее ;-)
+.TP
+.I -install
+стартуя как часть общесистемной установки, такая опция устанавливает
+частный вариант отличающегося от распространяемого с DOSEMU dosemu-freedos-bin 
+DOS (возможен любой проприетарный DOS, который загружается через fatfs).
+.I загрузочный_каталог
+является базовым именем каталога, пользователи имеют возможность
+установки его внутри аналогичного каталога, где будет создан вариант
+DOSEMU. Настройки в файле conf/dosemu.conf будут перекрыты этим 
+загрузочным каталогом.
 
 .SH АВТОРЫ
 .B DOSEMU

man/ru/dosemu.bin.1.in

@@ -63,24 +63,8 @@ dosemu.bin, dosdebug \- запускает DOS и приложения DOS по
 .I опции_настройки
 ]
 [
-.B \-E
-.I dos-команда
-]
-[
-.B \-K
-.I unix_путь[:dos_путь]
-]
-[
-.I env1=val1
-.I ...
-]
-[
-.I unix_путь_к_дос_программе
-[
-.I --
-]
-[
-.I аргументы_дос_команды
+.B \-U
+.I вх_канал[:вых_канал]
 ]
 .sp
 .B dosdebug
@@ -154,31 +138,6 @@ facilities, смотрите
 монтировать путь path как дополнительный диск в DOS.
 Можно указывать более одного раза.
 .TP
-.I -E dos-команда
-Запуск команды DOS в DOSEMU.
-Путь к бинарнику можно указать с помощью опции \-K.
-Например,
-.nf
-dosemu -K /home/joeuser/dosemu/freedos/bin -E "xcopy my_file my_dir"
-.fi
-запустит /home/joeuser/dosemu/freedos/bin/xcopy.exe с 2 аргументами.
-.br
-Замечание: это только работает с дефолтным autoexec.bat, в котором
-есть вызов "system \-e".
-.TP
-.I -K unix_путь[:dos_путь]
-Указать путь unix к программе, запускаемой через \-E.
-Можно не использовать \-E, а указать полный путь через \-K, но это не
-рекомендуется, и может быть удалено в будущем. Указывать в \-K надо
-только путь к каталогу.
-.br
-Если указан dos_путь, тогда он используется в качестве директории запуска
-dos-программы. Если unix_путь не указан, то буква диска берётся из dos_пути:
-.nf
-dosemu -K :C:\\\\games\\\\carma -E carma.exe
-.fi
-Так запустится carma.exe из C:\\games\\carma
-.TP
 .I -V
 использовать VGA спефицичную оптимизацию видео
 .TP
@@ -209,14 +168,7 @@ dosemu.users) и использовать предоставленный кат
 имеет флага suid-root).
 .TP
 .I -f
-Разобрать предоставленный конфигурационный файл вместо .dosemurc. Если
-задействована опция -n, то указанный здесь конфигурационный файл будет
-использован вместо основного dosemu.conf.
-.TP
-.I -n
-Пропустить (не разбирать) пользовательский файл конфигурации .dosemurc.
-Конфигурационный файл, указанный в -f, будет разобран, но, в этом случае,
-он заменит основной конфиг dosemu.conf.
+Разобрать предоставленный настроечный файл вместо .dosemurc
 .TP
 .I -L <log_string>
 Записывает <log_string> в лог-файл.
@@ -248,14 +200,6 @@ dosemu.users) и использовать предоставленный кат
 .I один
 аргумент.
 .TP
-.I -i input_data
-Вводит
-.I input_data
-с эмулируемой клавиатуры. Можно использовать \\r в качестве Enter.
-Так же обрабатываются другие эскейп-последовательности, например
-можно вставлять задержки с помощью конструкций вида "\\p10;", где
-10 - величина задержки в десятках миллисекунд.
-.TP
 .I -D
 определяет какие отладочные сообщения позволить, а какие запретить
 .TP
@@ -297,6 +241,53 @@ DOSEMU будет затем заблокирован перед переход
 .B DOSEMU
 в режим 286.)
 .TP
+.I -U
+определяет входной и выходной каналы для асинхронного управления
+.B DOSEMU
+из других процессов. Формат такой (без пробелов между словами):
+.TP
+		вх_канал:вых_канал
+
+где `:вых_канал' может быть опущен. В последнем случае можно не ожидать
+обратной связи от 
+.B DOSEMU.
+
+По соображениям безопастности
+.B DOSEMU
+не создает именованные каналы самому себе, так пользователь отвечает за 
+установку корректных прав доступа на каналы. Заметьте, что при использовании
+этих опций, инородный процесс может контроллировать сессию
+.B DOSEMU
+(типа ввода с клавиатуры). Опция будет следоватьльно использована только
+внешними интерфейсами (типа kdos), которые вначале содадут соответствующие
+именованные каналы и затем запустят на исполнение
+.B DOSEMU.
+Специальные управляющяя команда (
+.I ack on
+) может быть использована, чтобы принудить
+.B DOSEMU
+возвратить признаки установки связи через `вых_канал' такой, чтобы внешний
+интерфейс знал когда управляющая команда началась или закончилась и была ли
+она успешна. Формат такого диалога признаков показан ниже
+.TP
+		SYN: <имя_команды>
+.TP
+		<различный вывод от команды>
+.TP
+		ACK: code=n
+
+где 
+.I n
+равно 0 в случае успеха.
+Простой управляющий терминал, который служит как пример, замещается программой
+.I dosctrl.
+Она берет только два канала как аргументы и дает возможность затем
+вводить управляющие команды, из которых `help' наиболее важна ;-)
+Заметьте, 
+.I dosctrl
+не запускает на выполнение
+.B DOSEMU,
+что необходимо сделать вручную.
 
 .PD 1
 .SH ЖЕСТКИЕ ДИСКИ