]> git.donarmstrong.com Git - neurodebian.git/blobdiff - sphinx/faq.rst
Adding the entry for upcoming talk
[neurodebian.git] / sphinx / faq.rst
index a30be4d891bdd0963abb813364619b6e526dd35a..4757ecad9b27e12ddf04a6b7c5721ab33d5238c1 100644 (file)
@@ -1,11 +1,5 @@
 .. -*- mode: rst; fill-column: 78 -*-
 .. ex: set sts=4 ts=4 sw=4 et tw=79:
 .. -*- mode: rst; fill-column: 78 -*-
 .. ex: set sts=4 ts=4 sw=4 et tw=79:
-  ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ###
-  #
-  #   See COPYING file distributed along with the PyMVPA package for the
-  #   copyright and license terms.
-  #
-  ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ###
 
 
 .. _faq:
 
 
 .. _faq:
@@ -19,12 +13,12 @@ Why NeuroDebian?
 
   In the course of our own research endeavors |we| have joined forces to
   develop `PyMVPA -- a Python framework for multivariate pattern analysis of
 
   In the course of our own research endeavors |we| have joined forces to
   develop `PyMVPA -- a Python framework for multivariate pattern analysis of
-  neural data <http://www.pymvpa.org>`_.  To conveniently deployment PyMVPA for
+  neural data <http://www.pymvpa.org>`_.  To conveniently deploy PyMVPA for
   anyone using Debian-derived distributions this package repository was created
   initially.  Besides the PyMVPA_ project |we| collaborate with the `NiPy team
   <http://neuroimaging.scipy.org>`_ on various projects, such as NiBabel_ and
   NiPype_.  Quickly NeuroDebian_ became the ultimate integrated environment for
   anyone using Debian-derived distributions this package repository was created
   initially.  Besides the PyMVPA_ project |we| collaborate with the `NiPy team
   <http://neuroimaging.scipy.org>`_ on various projects, such as NiBabel_ and
   NiPype_.  Quickly NeuroDebian_ became the ultimate integrated environment for
-  all these projects. We are now constantly working on enriching this
+  all these projects -- and we are constantly working on enriching this
   environment with as many additional relevant software as possible.
 
 
   environment with as many additional relevant software as possible.
 
 
@@ -49,7 +43,7 @@ Why is NeuroDebian not a Pure Blend?
 
   NeuroDebian aims to be a platform that provides a staging area for
   neuroscience software packages on their way into Debian. All packages are
 
   NeuroDebian aims to be a platform that provides a staging area for
   neuroscience software packages on their way into Debian. All packages are
-  properly registered with the relevant `Debian Pure Blends`_, e.g.
+  properly registered in the relevant `Debian Pure Blends`_, e.g.
   `Debian Science Cognitive Neuroscience`_ or `Debian Med Imaging`_. Inside
   Debian these efforts already provide a suitable framework for this purpose,
   and hence there is no need to establish yet another one.
   `Debian Science Cognitive Neuroscience`_ or `Debian Med Imaging`_. Inside
   Debian these efforts already provide a suitable framework for this purpose,
   and hence there is no need to establish yet another one.
@@ -59,6 +53,18 @@ Why is NeuroDebian not a Pure Blend?
 .. _Debian Med Imaging: http://debian-med.alioth.debian.org/tasks/imaging
 
 
 .. _Debian Med Imaging: http://debian-med.alioth.debian.org/tasks/imaging
 
 
+I want to help. How do I get involved?
+--------------------------------------
+
+  We always need people to help maintaining existing packages. If you need
+  some additional software packaged and you want to try it on your own, we would
+  be happy to mentor you. We also have a :ref:`list of ongoing and planned
+  projects <projects>`, each listing a number of tasks that need to be done.
+
+  If you found something you are interested in, please email the
+  neurodebian-devel_ mailing list and let us know about it. Thanks!
+
+
 When does a package migrate from NeuroDebian into Debian proper?
 ----------------------------------------------------------------
 
 When does a package migrate from NeuroDebian into Debian proper?
 ----------------------------------------------------------------
 
@@ -124,8 +130,8 @@ I have heard that some packages are non-free. Will you charge me for them?
 --------------------------------------------------------------------------
 
   No. The term :term:`non-free` refers to an archive section. NeuroDebian uses
 --------------------------------------------------------------------------
 
   No. The term :term:`non-free` refers to an archive section. NeuroDebian uses
-  exactly the same :ref:`archive sections as Debian proper
-  <http://www.debian.org/doc/debian-policy/ch-archive.html>`.  The *non-free*
+  exactly the same `archive sections as Debian proper
+  <http://www.debian.org/doc/debian-policy/ch-archive.html>`_.  The *non-free*
   section contains packages that have certain restrictions regarding **your
   freedom** to employ them for a particular purpose. In contrast, for packages
   in the *main* section your are completely free to do whatever and in whatever
   section contains packages that have certain restrictions regarding **your
   freedom** to employ them for a particular purpose. In contrast, for packages
   in the *main* section your are completely free to do whatever and in whatever
@@ -133,6 +139,51 @@ I have heard that some packages are non-free. Will you charge me for them?
   packages in NeuroDebian are provided free of charge and under the licensing
   terms of the original developers.
 
   packages in NeuroDebian are provided free of charge and under the licensing
   terms of the original developers.
 
+.. _sec_pkg_authentication:
+
+What means "The following signatures couldn't be verified..."?
+--------------------------------------------------------------
+
+When you start using this repository, you probably get warning messages
+like this::
+
+  The following signatures couldn't be verified because
+  the public key is not available.
+
+Or you will be asked questions like this over and over::
+
+  WARNING: The following packages cannot be authenticated!
+  ...
+  Install these packages without verification [y/N]?
+
+This is because your APT installation initially does not know the GPG
+key that is used to sign the release files of this repository. It is easy to
+make APT happy again. The simplest way is to install the ``neurodebian-keyring``
+package that is available from the NeuroDebian repository. Alternatively:
+
+1. Get the key. Either download the `repository key from here
+   <_static/neuro.debian.net.asc>`_
+   or fetch it from http://wwwkeys.pgp.net (2649A5A9).
+
+2. Now feed the key into APT by invoking::
+
+     apt-key add #file#
+
+   Where `#file#` has to be replaced with the location of the key file you just
+   downloaded. You need to have superuser-privileges to do this (either do it
+   as root or use sudo).
+
+
+How can I cite NeuroDebian?
+---------------------------
+
+Please cite the following paper:
+
+  Halchenko, Y. O. & Hanke, M. (2012). `Open is not enough. Let’s take the
+  next step: An integrated, community-driven computing platform for neuroscience
+  <http://www.frontiersin.org/Neuroinformatics/10.3389/fninf.2012.00022/full>`_.
+  *Frontiers in Neuroinformatics*, 6:22.
+
 
 
-.. include:: links_names.rst
-.. include:: substitutions.rst
+.. include:: link_names.txt
+.. include:: substitutions.txt