<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      xmlns:if="http://projectmallard.org/if/1.0/"
      type="guide" style="task" version="1.0 if/1.0"
      id="bluetooth-send-file">

  <info>
    <link type="guide" xref="bluetooth"/>
    <link type="guide" xref="sharing"/>
    <link type="seealso" xref="files-share"/>

    <revision pkgversion="3.8.2" version="0.2" date="2013-05-16" status="review"/>
    <revision pkgversion="3.10" version="0.3" date="2013-11-09" status="review"/>

    <desc>Share files to Bluetooth devices such as your phone.</desc>

    <credit type="author">
      <name>Jim Campbell</name>
      <email its:translate="no">jwcampbell@gmail.com</email>
    </credit>
    <credit type="author">
      <name>Paul W. Frields</name>
      <email its:translate="no">stickster@gmail.com</email>
    </credit>
    <credit type="editor">
      <name>Michael Hill</name>
      <email its:translate="no">mdhillca@gmail.com</email>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

  <title>Send files to a Bluetooth device</title>

<if:choose>
  <if:when test="platform:unity">
    <p>You can send files to connected Bluetooth devices, such as some mobile
    phones or other computers. Some types of devices don't allow the transfer
    of files, or specific types of files. You can send files in one of three
    ways: using the Bluetooth icon in the menu bar, from the Bluetooth settings
    window, or directly from the file manager.</p>
  </if:when>
  <p>You can send files to connected Bluetooth devices, such as some mobile
  phones or other computers. Some types of devices don't allow the transfer
  of files, or specific types of files. You can send files using the Bluetooth
  icon on the top bar, or from the Bluetooth settings window.</p>
</if:choose>

<comment>
<cite date="2013-05-11" href="mailto:mdhillca@gmail.com">mdhill</cite>
  <p>The functionality in the following line was temporarily removed in 3.8</p>
  <p>To send files directly from the file manager, see <link xref="files-share"/>.</p>
</comment>

  <note style="important">
    <p>Before you begin, make sure Bluetooth is enabled on your computer.
    See <link xref="bluetooth-turn-on-off"/>.</p>
  </note>

  <steps>
    <item>
      <if:choose>
        <if:when test="platform:unity">
      <p>Click the Bluetooth icon in the menu bar and select <gui>Send Files to
      Device</gui>.</p>
        </if:when>
      <p>Open the <gui xref="shell-terminology">Activities</gui> overview and
      start typing <gui>Bluetooth</gui>.</p>
    </if:choose>
    </item>
    <item>
    <if:choose>
      <if:when test="platform:gnome-shell">
      <p>Click on <gui>Bluetooth</gui> to open the panel.</p>
      </if:when>
    </if:choose>
    </item>
    <item>
      <p>In the <gui>Devices</gui> list, select the device to which to send the
      files to and click <gui>Send Files...</gui>.</p>
      <p>If the desired device is not shown in the list, you need to
      <link xref="bluetooth-connect-device">connect</link> to it.</p>
    </item>
    <item>
      <p>Choose the file you want to send and click <gui>Select</gui>.</p>
      <p>To send more than one file in a folder, hold down <key>Ctrl</key> as
      you select each file.</p>
    </item>
    <item>
      <p>The owner of the receiving device usually has to press a button to
      accept the file. Once the owner accepts or declines, the result of the
      file transfer will be shown on your screen.</p>
    </item>
  </steps>

</page>
