sphinx/index.rst

   1 ***********************************************
   2  Welcome to the Debian Neuroscience Repository
   3 ***********************************************
   4
   5 This repository provides mostly neuroscience-related packages to be
   6 used on Debian systems (or a Debian-derivates like Ubuntu). It
   7 contains both unofficial or prospective packages which are not
   8 available from the main Debian archive, as well backported or simply
   9 rebuilt packages also available elsewhere.
  10
  11 This service is provided "as is". There is no guarantee that a package
  12 works as expected, so use them at your own risk. They might kill your
  13 system (although that is rather unlikely). You've been warned!
  14
  15 The repository contains both neuroscience-related packages as well as
  16 general purpose software which is necessary to resolved dependencies, or
  17 is simply useful in the neuroscience context. The featured neuroscience
  18 software can be browsed via the repository :ref:`genindex` or through the
  19 :ref:`maintainer view <bymaintainer>`.
  20
  21 All other packages are available through the search engine or from the
  22 :ref:`full package list <full_pkg_list>`.
  23
  24
  25 News
  26 ====
  27
  28 Due to scheduled maintenance work on the electrical grid the repository hosted
  29 at `apsy.gse.uni.magdeburg.de/debian` will be down on May 16 (and possibly
  30 May 17).
  31
  32
  33 .. _repository_howto:
  34
  35 How to use this repository
  36 ==========================
  37
  38 The easiest way to use this repository is to download an APT-configuration
  39 file. Simply click on the name of your target distribution/release and save the
  40 downloaded file in the `/etc/apt/sources.list.d/` directory on your system
  41 (depending on the browser, you might have to right-click and choose 'save as').
  42 Saving files in this directory will require superuser privileges, therefore you
  43 should probably download the file into a temporary directory and subsequently
  44 move it into `/etc/apt/sources.list.d/`. APT-configurations are available for
  45 the following releases:
  46
  47 .. include:: sources_lists
  48
  49 Once this is done, you have to update the package index. Use your favorite
  50 package manager, e.g. synaptic, adept, or whatever you like. In the terminal
  51 you can use :command:`aptitude` to achieve the same::
  52
  53   sudo aptitude update
  54
  55 Now, you can proceed to install packages, e.g.::
  56
  57   sudo aptitude install lipsia
  58
  59 .. note::
  60   Not every package is available for all distributions/releases. For information
  61   about which package version is available for which release and architecture,
  62   please have a look at the corresponding package pages.
  63
  64
  65 Package authentication
  66 ----------------------
  67
  68 When you start using this repository, you might get warning messages
  69 like this::
  70
  71   The following signatures couldn't be verified because
  72   the public key is not available.`
  73
  74 Or you will be asked questions like this over and over::
  75
  76   WARNING: The following packages cannot be authenticated!
  77   ...
  78   Install these packages without verification [y/N]?
  79
  80 This is because your APT installation initially does not know the GPG
  81 key that is used to sign the release files of this repository. Making
  82 APT happy again is easy:
  83
  84 1. Get the key. Either download the `repository key from here
  85    <http://apsy.gse.uni-magdeburg.de/debian/apsy.gse.uni-magdeburg.de.asc>`_
  86    or fetch it from *subkeys.pgp.net*.
  87
  88 2. Now feed the key into APT by invoking::
  89
  90      apt-key add #file#
  91
  92    Where `#file#` has to be replaced with the location of the key file you just
  93    downloaded. You need to have superuser-privileges to do this (either do it
  94    as root or use sudo).