xmlns:its="http://www.w3.org/2005/11/its"

      type="topic" style="task" version="1.0 if/1.0"

      id="sharing-desktop">

  <info>

    <link type="guide" xref="sharing"/>

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

    <revision pkgversion="3.14" date="2015-01-25" status="candidate"/>

    <revision pkgversion="3.18" date="2015-09-28" status="review"/>

    <credit type="author">

      <name>Ekaterina Gerasimova</name>

      <email>kittykat3756@gmail.com</email>

    </credit>

    <credit type="editor">

      <name>Michael Hill</name>

      <email>mdhillca@gmail.com</email>

    </credit>

    <credit type="author">

      <name>Jim Campbell</name>

      <email>jcampbell@gnome.org</email>

    </credit>

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

    <desc>Let other people view and interact with your desktop using VNC.</desc>

  </info>

  <title>Share your desktop</title>

  <comment>

    David King

    
The controls for sharing with specific networks, under the Networks

    section needs to be explained, perhaps as a separate page.

  </comment>

  <comment>

    Michael Hill

    
Networks section added without explanatory details.

  </comment>

  
You can let other people view and control your desktop from another

  computer with a desktop viewing application. Configure <gui>Screen

  Sharing</gui> to allow others to access your desktop and set the security

  preferences.

  <note style="info package">

    
You must have the <app>Vino</app> package installed for

     <gui>Screen Sharing</gui> to be visible.

    <if:choose xmlns:if="http://projectmallard.org/if/1.0/">

      <if:when test="action:install">

        
<link action="install:vino" style="button">Install Vino</link>

      </if:when>

    </if:choose>

  </note>

  <steps>

    <item>

      
Open the <gui xref="shell-introduction#activities">Activities</gui> overview and

      start typing <gui>Sharing</gui>.

    </item>

    <item>

      
Click on <gui>Sharing</gui> to open the panel.

    </item>

    <item>

      
If <gui>Sharing</gui> is <gui>OFF</gui>, switch it to

      <gui>ON</gui>.

      <note style="info">
If the text below <gui>Computer Name</gui> allows

      you to edit it, you can <link xref="sharing-displayname">change</link>

      the name your computer displays on the network.
</note>

    </item>

    <item>

      
Select <gui>Screen Sharing</gui>.

    </item>

    <item>

      
To let others view your desktop, switch <gui>Screen Sharing</gui> to

      <gui>ON</gui>. This means that other people will be able to attempt to

      connect to your computer and view what’s on your screen.

    </item>

    <item>

      
To let others interact with your desktop, switch

      <gui>Allow Remote Control</gui> to <gui>ON</gui>. This may allow the

      other person to move your mouse, run applications, and browse files on

      your computer, depending on the security settings which you are currently

      using.

      <note style="tip">

        
This option is enabled by default when <gui>Screen Sharing</gui> is

        <gui>ON</gui>.

      </note>

    </item>

  </steps>

  <section id="security">

  <title>Security</title>

  
It is important that you consider the full extent of what each security

  option means before changing it.

  <terms>

    <item>

      <title>New connections must ask for access</title>

      
If you want to be able to choose whether to allow someone to access

      your desktop, enable <gui>New connections must ask for access</gui>.  If

      you disable this option, you will not be asked whether you want to allow

      someone to connect to your computer.

      <note style="tip">

        
This option is enabled by default.

      </note>

    </item>

    <item>

      <title>Require a Password</title>

      
To require other people to use a password when connecting to your

      desktop, enable <gui>Require a Password</gui>. If you do not use this

      option, anyone can attempt to view your desktop.

      <note style="tip">

        
This option is disabled by default, but you should enable it and set

        a secure password.

      </note>

    </item>

    <item>

      <title>Allow access to your desktop over the Internet</title>

      
If your router supports UPnP Internet Gateway Device Protocol and it

      is enabled, you can allow other people who are not on your local network

      to view your desktop. To allow this, select <gui>Automatically configure

      UPnP router to open and forward ports</gui>. Alternatively, you can

      configure your router manually.

      <note style="tip">

        
This option is disabled by default.

      </note>

    </item>

-->

  </terms>

  </section>

  <section id="networks">

  <title>Networks</title>

  
The <gui>Networks</gui> section lists the networks to which you are

  currently connected. Use the <gui>ON | OFF</gui> switch next to each to

  choose where your desktop can be shared.

  </section>

  <section id="notification-icon">

  <title>Stop sharing your desktop</title>

  
You can disconnect someone who is viewing your desktop using the

  <gui>notification icon</gui> in the message Tray. To do so:

    <steps>

      <item>
Open the message tray by pressing

      <keyseq><key>Super</key><key>M</key></keyseq>, or by moving your mouse

      pointer to the very bottom of your screen.
</item>

      <item>
Click on the <gui>Desktop</gui> icon in the

      <gui>Message Tray</gui>. This will open the <app>Sharing</app> panel.

      </item>

      <item>
Select <gui>Screen Sharing</gui>.
</item>

      <item>
Toggle the <gui>Screen Sharing</gui> slider to <gui>Off</gui>.

      
</item>

    </steps>

  </section>

</page>