<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" style="task" version="1.0 if/1.0"
      id="sharing-personal">

  <info>
    <link type="guide" xref="sharing"/>
    <link type="guide" xref="prefs-sharing"/>

    <revision pkgversion="3.10" version="0.1" date="2013-09-23" status="review"/>
    <revision pkgversion="3.12" date="2014-03-23" status="candidate"/>
    <revision pkgversion="3.14" date="2014-10-13" status="candidate"/>
    <revision pkgversion="3.18" date="2015-09-28" status="review"/>
    <revision pkgversion="3.33.3" date="2019-07-21" status="review"/>

    <credit type="author">
      <name>Michael Hill</name>
      <email>mdhillca@gmail.com</email>
    </credit>

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

    <desc>Let other people access files in your <file>Public</file>
    folder.</desc>
  </info>

  <title>Share your personal files</title>

  <comment>
    <cite date="2013-09-23" href="mailto:mdhillca@gmail.com">Michael Hill</cite>
    <p>Rewrite Step 1 everywhere. Add section for accessing the Public folder
    from another computer. Add an info note about the two technologies
    involved: WebDAV and mDNS (?).</p>
  </comment>
  <comment>
    <cite date="2014-09-22">David King</cite>
    <p>The controls for sharing with specific networks, under the Networks
    section needs to be explained, perhaps as a separate page.</p>
  </comment>
  <comment>
    <cite date="2014-10-13">Michael Hill</cite>
    <p>Networks section added without explanatory details.</p>
  </comment>

  <p>You can allow access to the <file>Public</file> folder in your
  <file>Home</file> folder from another computer on the network. Configure
  <gui>Personal File Sharing</gui> to allow others to access the contents of
  the folder.</p>

  <note style="info package">
    <p>You must have the <app>gnome-user-share</app> package installed for
     <gui>Personal File Sharing</gui> to be visible.</p>

    <if:choose xmlns:if="http://projectmallard.org/if/1.0/">
      <if:when test="action:install">
        <p>
<link href="apt:gnome-user-share" style="button">Install gnome-user-share</link>
        </p>
      </if:when>
    </if:choose>
  </note>

  <steps>
    <item>
      <p>Open the <gui xref="shell-introduction#activities">Activities</gui> overview and
      start typing <gui>Sharing</gui>.</p>
    </item>
    <item>
      <p>Click on <gui>Sharing</gui> to open the panel.</p>
    </item>
    <item>
      <note style="info"><p>If the text below <gui>Device Name</gui> allows
      you to edit it, you can <link xref="about-hostname">change</link>
      the name your computer displays on the network.</p></note>
    </item>
    <item>
      <p>Select <gui>File Sharing</gui>.</p>
    </item>
    <item>
      <p>Switch the <gui>File Sharing</gui> switch to on. This means
      that other people on your current network will be able to attempt to
      connect to your computer and access files in your <file>Public</file>
      folder.</p>
      <comment>
        <cite date="2013-09-23" href="mailto:ak-47@gmx.net">Andre Klapper</cite>
        <p>No URI is displayed in GNOME 46 - TODO</p>
      </comment>
      <note style="info">
        <p>A <em>URI</em> is displayed by which your <file>Public</file> folder
        can be accessed from other computers on the network.</p>
      </note>
    </item>
  </steps>

  <section id="security">
  <title>Security</title>

  <terms>
    <item>
      <title>Require Password</title>
      <p>To require other people to use a password when accessing your
      <file>Public</file> folder, switch the <gui>Require Password</gui>
      switch to on. If you do not use this option, anyone can attempt to view
      your <file>Public</file> folder.</p>
      <note style="tip">
        <p>This option is disabled by default, but you should enable it and set
        a secure password.</p>
      </note>
    </item>
  </terms>
  </section>

  <section id="networks">
  <title>Networks</title>

  <p>The <gui>Networks</gui> section lists the networks to which you are
  currently connected. Use the switch next to each to choose where your
  personal files can be shared.</p>

  </section>

</page>
