summary refs log tree commit diff
path: root/doc/builders/fetchers.xml
diff options
context:
space:
mode:
authorFrederik Rietdijk <fridh@fridh.nl>2019-10-30 11:03:55 +0100
committerFrederik Rietdijk <fridh@fridh.nl>2019-10-30 11:17:14 +0100
commitaad81ec8cd158a9e11f4d35fc6022d1300fcb4c6 (patch)
treeb947a433a8365601ef7758d13029d638a83fd5fb /doc/builders/fetchers.xml
parentacfc517a80ba4e53508fc38a09dd293aeb487cd2 (diff)
downloadnixpkgs-aad81ec8cd158a9e11f4d35fc6022d1300fcb4c6.tar
nixpkgs-aad81ec8cd158a9e11f4d35fc6022d1300fcb4c6.tar.gz
nixpkgs-aad81ec8cd158a9e11f4d35fc6022d1300fcb4c6.tar.bz2
nixpkgs-aad81ec8cd158a9e11f4d35fc6022d1300fcb4c6.tar.lz
nixpkgs-aad81ec8cd158a9e11f4d35fc6022d1300fcb4c6.tar.xz
nixpkgs-aad81ec8cd158a9e11f4d35fc6022d1300fcb4c6.tar.zst
nixpkgs-aad81ec8cd158a9e11f4d35fc6022d1300fcb4c6.zip
nixpkgs manual: fix white space and indentation
Diffstat (limited to 'doc/builders/fetchers.xml')
-rw-r--r--doc/builders/fetchers.xml9
1 files changed, 0 insertions, 9 deletions
diff --git a/doc/builders/fetchers.xml b/doc/builders/fetchers.xml
index 6f8990e8d16..ff398833491 100644
--- a/doc/builders/fetchers.xml
+++ b/doc/builders/fetchers.xml
@@ -3,15 +3,12 @@
          xmlns:xi="http://www.w3.org/2001/XInclude"
          xml:id="chap-pkgs-fetchers">
  <title>Fetchers</title>
-
  <para>
   When using Nix, you will frequently need to download source code and other files from the internet. Nixpkgs comes with a few helper functions that allow you to fetch fixed-output derivations in a structured way.
  </para>
-
  <para>
   The two fetcher primitives are <function>fetchurl</function> and <function>fetchzip</function>. Both of these have two required arguments, a URL and a hash. The hash is typically <literal>sha256</literal>, although many more hash algorithms are supported. Nixpkgs contributors are currently recommended to use <literal>sha256</literal>. This hash will be used by Nix to identify your source. A typical usage of fetchurl is provided below.
  </para>
-
 <programlisting><![CDATA[
 { stdenv, fetchurl }:
 
@@ -23,19 +20,15 @@ stdenv.mkDerivation {
   };
 }
 ]]></programlisting>
-
  <para>
   The main difference between <function>fetchurl</function> and <function>fetchzip</function> is in how they store the contents. <function>fetchurl</function> will store the unaltered contents of the URL within the Nix store. <function>fetchzip</function> on the other hand will decompress the archive for you, making files and directories directly accessible in the future. <function>fetchzip</function> can only be used with archives. Despite the name, <function>fetchzip</function> is not limited to .zip files and can also be used with any tarball.
  </para>
-
  <para>
   <function>fetchpatch</function> works very similarly to <function>fetchurl</function> with the same arguments expected. It expects patch files as a source and and performs normalization on them before computing the checksum. For example it will remove comments or other unstable parts that are sometimes added by version control systems and can change over time.
  </para>
-
  <para>
   Other fetcher functions allow you to add source code directly from a VCS such as subversion or git. These are mostly straightforward names based on the name of the command used with the VCS system. Because they give you a working repository, they act most like <function>fetchzip</function>.
  </para>
-
  <variablelist>
   <varlistentry>
    <term>
@@ -88,11 +81,9 @@ stdenv.mkDerivation {
    </listitem>
   </varlistentry>
  </variablelist>
-
  <para>
   A number of fetcher functions wrap part of <function>fetchurl</function> and <function>fetchzip</function>. They are mainly convenience functions intended for commonly used destinations of source code in Nixpkgs. These wrapper fetchers are listed below.
  </para>
-
  <variablelist>
   <varlistentry>
    <term>