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

  <info>
    <link type="seealso" xref="keyring-update-password"/>
    <link type="guide" xref="index#passwords" group="#first"/>

    <revision pkgversion="3.14" date="2014-10-26" status="candidate"/>
    <revision version="3.32.0" date="2019-03-19" status="review"/>

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

    <credit type="author copyright">
      <name>Aruna Sankaranarayanan</name>
      <email its:translate="no">aruna.evam@gmail.com</email>
      <years>2013</years>
    </credit>
    <credit type="editor">
      <name>Ekaterina Gerasimova</name>
      <email its:translate="no">kittykat3756@gmail.com</email>
      <years>2013</years>
    </credit>
    <credit type="editor">
      <name>Jim Campbell</name>
      <email its:translate="no">jcampbell@gnome.org</email>
      <years>2014</years>
    </credit>

    <desc>Use password keyrings to group stored passwords.</desc>
  </info>

  <title>Create a new keyring</title>

  <p>Use <link xref="keyring">keyrings</link> to group related passwords.
  You can choose to protect your keyring with a password.</p>

  <steps>
    <title>Create a new password keyring:</title>
    <item>
      <p>Press the <gui style="button">+</gui> button in the top-left corner of the window.</p>
    </item>
    <item>
      <p>Select <gui style="menuitem">Password Keyring</gui> from the list.</p>
    </item>
    <item>
      <!-- TODO: https://gitlab.gnome.org/GNOME/seahorse/issues/221 -->
      <p>Choose a name for your new keyring, then press
      <gui style="button">OK</gui> to continue.</p>
    </item>
    <item>
      <!-- TODO: make shorter -->
      <p>To password protect your keyring, choose a password, and retype it to
      confirm your choice. Leave both the fields blank if you want your keyring
      to remain unlocked at all times.</p>
      <!--If you want your keyring to be protected with a password, chose one
      now. If you do not with to use a password, leave these fields blank. This
      is the password which you will need to use to unlock the keyring.</p>-->
    </item>
    <item>
      <p>Press <gui style="button">Continue</gui> to finish creating the
      keyring. If you have not protected your keyring with a password, you will
      need to confirm that this is how you want to proceed.</p>
    </item>
  </steps>

  <p>Your new keyring will now be listed under <gui>Passwords</gui>.</p>

</page>
