Главная   Изменения   Спек   Патчи   Исходники   Загрузить   Gear   Bugs and FR  Repocop 

<?xml version="1.0" encoding="KOI8-R"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"                    
[
<!ENTITY DOSBox "<application>DOSBox</application>">
<!ENTITY Install "<command>dosbox-install</command>">
] >

<reference lang="ru"><title>Reference Pages</title>

<refentry id="dosbox-install">

<refmeta>
   <refentrytitle>dosbox-install</refentrytitle>
   <manvolnum>1</manvolnum>
</refmeta>

<refnamediv>
   <refdescriptor>dosbox-install</refdescriptor>
   <refname>dosbox-install</refname>
   <refpurpose>Games installer for DOSBox</refpurpose>
</refnamediv>

<refsynopsisdiv>
   <cmdsynopsis>
      <command>/usr/bin/dosbox-install</command>
      <group><arg>-h</arg><arg>--help</arg></group>
      <group><arg>-V</arg><arg>--version</arg></group>
      <arg choice="opt">--verbose</arg>
      <arg choice="opt">--executable <replaceable>EXE-filename</replaceable></arg>
      <arg choice="opt">--project <replaceable>Menu-itemname</replaceable></arg>
      <arg choice="opt">--basedir <replaceable>directory-for-C-drive</replaceable></arg>
      <arg rep="repeat"><replaceable>file-or-URL</replaceable></arg>
   </cmdsynopsis>
   <cmdsynopsis>
      <command>/usr/bin/dosbox-install</command>
      <group><arg>-u</arg><arg>--uninstall</arg><arg>--remove</arg></group>
      <arg rep="repeat">game-name</arg>
   </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
  <title>DESCRIPTION</title>

<para>&Install; performs four things:
<itemizedlist>
<listitem><para>downloads given URL using <command>wget</command>
	or <command>lftpget</command>;</para></listitem>
<listitem><para>if downloaded file is has archive suffix, extracts it
	to directory that is used for storing &DOSBox; apps;</para></listitem>
<listitem><para>lookups executable file in created directory
	(BAT, COM or EXE);</para></listitem>
<listitem><para>adds item to Main Menu of GUI environment
        for running founded executable by &DOSBox;.</para></listitem>
</itemizedlist>
</para>

<refsect2>
  <title>COMMAND LINE ARGUMENTS</title>

<para>Each command line argument is handled as following:
<itemizedlist>
<listitem><para>when this is a URL in <filename>proto://address</filename> format,
	steps 1-4 are performed;</para></listitem>
<listitem><para>when this is a filename with ZIP, RAR or ARJ extension,
	steps 2-4 are performed;</para></listitem>
<listitem><para>when this is a directory, steps 3 and 4 are performed;</para></listitem>
<listitem><para>when this is a executable with EXE/BAT/COM extension,
	step 4 is performed.</para></listitem>
</itemizedlist>
</para>

</refsect2>  <!-- arg.types -->

<refsect2>
  <title>EXAMPLES</title>

<para>
<itemizedlist>
<listitem>
<para>Download, extract, lookup executable, add icon to Main menu:</para>
<para><command>dosbox-install http://ilya-evseev.narod.ru/games/tower.zip</command></para>
</listitem>
<listitem>
<para>Extract, lookup executable, add icon to Main menu:</para>
<para><command>dosbox-install /tmp/ugh.zip</command></para>
</listitem>
<listitem>
<para>Lookup executable, add icon to Main menu:</para>
<para><command>dosbox-install /mnt/windows/Games/DefenderOfTheCrown/</command></para>
</listitem>
<listitem>
<para>Add icon of executable to Main menu:</para>
<para><command>dosbox-install /mnt/windows/Games/LR/LR.COM</command></para>
</listitem>
</itemizedlist>
</para>

</refsect2>  <!-- samples -->

<refsect2>
  <title>UNINSTALL</title>

<para>Running with <option>-u</option> switch
removes already installed application that's name is given in command line:
<itemizedlist>
<listitem><para>directory from &DOSBox; apps folder;</para></listitem>
<listitem><para>menu item from Main menu folder.</para></listitem>
</itemizedlist>
</para>

</refsect2>  <!-- uninstall -->

</refsect1>  <!-- Description -->

<refsect1>
  <title>OPTIONS</title>

<variablelist>

<varlistentry>
<term><arg choice="plain">-h</arg></term>
<term><arg choice="plain">--help</arg></term>
<listitem><para>Display short usage.</para></listitem>
</varlistentry>

<varlistentry>
<term><arg choice="plain">-V</arg></term>
<term><arg choice="plain">--version</arg></term>
<listitem><para>Display program version.</para></listitem>
</varlistentry>

<varlistentry>
<term><arg choice="plain">--verbose</arg></term>
<listitem><para>More detailed output about progress.</para></listitem>
</varlistentry>

<varlistentry>
<term><arg choice="plain">--executable <replaceable>EXE-filename</replaceable></arg></term>
<listitem><para>When a program directory contain more than once excutable,
by default &Install; creates menu link to the first founded.
This switch allows you to select main program executable explicitly.
If executable is located not in the top program directory,
then filename should contain relative path from top directory.
</para>
<para>Examples:<sbr/>
<command>dosbox-install --executable SIMFILES/SIM.EXE /mnt/windows/Games/SimCity/</command>
<command>dosbox-install --executable gpega.exe /usr/games/dosgames/GrandPrix</command>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><arg choice="plain">--basedir <replaceable>directory-mounted-as-C</replaceable></arg></term>
<listitem><para>By default drive C: is assigned to directory of selected executable.
When executable is located not at program toplevel, but in subdirectory,
this switch allows to select toplevel directory.</para>
<para>Example:<sbr/>
<command>dosbox-install --basedir /mnt/windows/Games/SimCity/ SIMFILES/SIM.EXE</command>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><arg choice="plain">--project <replaceable>Menu-itemname</replaceable></arg></term>
<listitem><para>By default, item in Main menu
has the same name as application folder.
This switch is used for assigning custom name for menu item.</para>
<para>Example:<sbr/>
<command>dosbox-install --project "Accolade GrandPrix Rally" /usr/games/dosgames/gp/gpega.exe</command>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><arg choice="plain">-u <replaceable>name</replaceable></arg></term>
<listitem><para>Removes selected subfolder from main DOS-apps folder,
and menu item from Main menu.</para>
<para>Example:<sbr/>
<command>dosbox-install --remove tower ugh para</command>
</para>
</listitem>
</varlistentry>

</variablelist>

</refsect1>  <!-- Options -->

<refsect1>
  <title>FILES</title>

<para><filename class="directory">/usr/games/dosbox</filename>
is used as base directory for extracting processed archives.</para>

<para><filename class="directory">/usr/lib/menu</filename>
contain descriptions for menu items used for building Main menu for GUI.</para>

</refsect1>  <!-- Files -->

<refsect1>
  <title>AUTHORS</title>

<para>&lt;evseev@altlinux.ru&gt;, 2003-2004.
</para>

</refsect1>  <!-- Authors -->

<refsect1>
  <title>SEE ALSO</title>

<para><citerefentry><refentrytitle>dosbox</refentrytitle>
<manvolnum>1</manvolnum></citerefentry>
<sbr/><citerefentry><refentrytitle>update-menus</refentrytitle>
<manvolnum>1</manvolnum></citerefentry>
</para>

</refsect1>  <!-- See also -->

</refentry>

</reference>