diff options
Diffstat (limited to 'nixos/doc/manual/release-notes/rl-1809.xml')
| -rw-r--r-- | nixos/doc/manual/release-notes/rl-1809.xml | 201 |
1 files changed, 110 insertions, 91 deletions
diff --git a/nixos/doc/manual/release-notes/rl-1809.xml b/nixos/doc/manual/release-notes/rl-1809.xml index 0743a05ba38c..ec7b2f107e8e 100644 --- a/nixos/doc/manual/release-notes/rl-1809.xml +++ b/nixos/doc/manual/release-notes/rl-1809.xml @@ -3,153 +3,172 @@ xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="sec-release-18.09"> + <title>Release 18.09 (“Jellyfish”, 2018/09/??)</title> -<title>Release 18.09 (“Jellyfish”, 2018/09/??)</title> - -<section xmlns="http://docbook.org/ns/docbook" + <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="sec-release-18.09-highlights"> + <title>Highlights</title> -<title>Highlights</title> - -<para>In addition to numerous new and upgraded packages, this release -has the following highlights: </para> + <para> + In addition to numerous new and upgraded packages, this release has the + following highlights: + </para> -<itemizedlist> - <listitem> + <itemizedlist> + <listitem> + <para> + User channels are now in the default <literal>NIX_PATH</literal>, allowing + users to use their personal <command>nix-channel</command> defined + channels in <command>nix-build</command> and <command>nix-shell</command> + commands, as well as in imports like <code>import + <mychannel></code>. + </para> <para> - User channels are now in the default <literal>NIX_PATH</literal>, - allowing users to use their personal <command>nix-channel</command> - defined channels in <command>nix-build</command> and - <command>nix-shell</command> commands, as well as in imports like - <code>import <mychannel></code>. + For example </para> - <para>For example</para> - <programlisting> +<programlisting> $ nix-channel --add https://nixos.org/channels/nixpkgs-unstable nixpkgsunstable $ nix-channel --update $ nix-build '<nixpkgsunstable>' -A gitFull $ nix run -f '<nixpkgsunstable>' gitFull $ nix-instantiate -E '(import <nixpkgsunstable> {}).gitFull' </programlisting> - </listitem> -</itemizedlist> + </listitem> + </itemizedlist> + </section> -</section> -<section xmlns="http://docbook.org/ns/docbook" + <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="sec-release-18.09-new-services"> + <title>New Services</title> -<title>New Services</title> - -<para>The following new services were added since the last release:</para> + <para> + The following new services were added since the last release: + </para> -<itemizedlist> - <listitem> + <itemizedlist> + <listitem> <para></para> - </listitem> -</itemizedlist> + </listitem> + </itemizedlist> + </section> -</section> -<section xmlns="http://docbook.org/ns/docbook" + <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="sec-release-18.09-incompatibilities"> + <title>Backward Incompatibilities</title> -<title>Backward Incompatibilities</title> + <para> + When upgrading from a previous release, please be aware of the following + incompatible changes: + </para> -<para>When upgrading from a previous release, please be aware of the -following incompatible changes:</para> - -<itemizedlist> - <listitem> + <itemizedlist> + <listitem> + <para> + <literal>lib.strict</literal> is removed. Use + <literal>builtins.seq</literal> instead. + </para> + </listitem> + <listitem> <para> - <literal>lib.strict</literal> is removed. Use <literal>builtins.seq</literal> instead. + The <literal>clementine</literal> package points now to the free + derivation. <literal>clementineFree</literal> is removed now and + <literal>clementineUnfree</literal> points to the package which is bundled + with the unfree <literal>libspotify</literal> package. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - The <literal>clementine</literal> package points now to the free derivation. - <literal>clementineFree</literal> is removed now and <literal>clementineUnfree</literal> - points to the package which is bundled with the unfree <literal>libspotify</literal> package. + The <literal>netcat</literal> package is now taken directly from OpenBSD's + <literal>libressl</literal>, instead of relying on Debian's fork. The new + version should be very close to the old version, but there are some minor + differences. Importantly, flags like -b, -q, -C, and -Z are no longer + accepted by the nc command. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - The <literal>netcat</literal> package is now taken directly from OpenBSD's - <literal>libressl</literal>, instead of relying on Debian's fork. The new - version should be very close to the old version, but there are some minor - differences. Importantly, flags like -b, -q, -C, and -Z are no longer - accepted by the nc command. + The <varname>services.docker-registry.extraConfig</varname> object doesn't contain + environment variables anymore. Instead it needs to provide an object structure + that can be mapped onto the YAML configuration defined in <link xlink:href="https://github.com/docker/distribution/blob/v2.6.2/docs/configuration.md">the <varname>docker/distribution</varname> docs</link>. </para> - </listitem> -</itemizedlist> + </listitem> + </itemizedlist> + </section> -</section> -<section xmlns="http://docbook.org/ns/docbook" + <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="sec-release-18.09-notable-changes"> + <title>Other Notable Changes</title> -<title>Other Notable Changes</title> - -<itemizedlist> - <listitem> + <itemizedlist> + <listitem> <para> - <literal>lib.attrNamesToStr</literal> has been deprecated. Use - more specific concatenation (<literal>lib.concat(Map)StringsSep</literal>) - instead. + <literal>dockerTools.pullImage</literal> relies on image digest + instead of image tag to download the image. The + <literal>sha256</literal> of a pulled image has to be updated. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - <literal>lib.addErrorContextToAttrs</literal> has been deprecated. Use - <literal>builtins.addErrorContext</literal> directly. + <literal>lib.attrNamesToStr</literal> has been deprecated. Use more + specific concatenation (<literal>lib.concat(Map)StringsSep</literal>) + instead. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - <literal>lib.showVal</literal> has been deprecated. Use - <literal>lib.traceSeqN</literal> instead. + <literal>lib.addErrorContextToAttrs</literal> has been deprecated. Use + <literal>builtins.addErrorContext</literal> directly. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - <literal>lib.traceXMLVal</literal> has been deprecated. Use - <literal>lib.traceValFn builtins.toXml</literal> instead. + <literal>lib.showVal</literal> has been deprecated. Use + <literal>lib.traceSeqN</literal> instead. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - <literal>lib.traceXMLValMarked</literal> has been deprecated. Use - <literal>lib.traceValFn (x: str + builtins.toXML x)</literal> instead. + <literal>lib.traceXMLVal</literal> has been deprecated. Use + <literal>lib.traceValFn builtins.toXml</literal> instead. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - <literal>lib.traceValIfNot</literal> has been deprecated. Use - <literal>if/then/else</literal> and <literal>lib.traceValSeq</literal> - instead. + <literal>lib.traceXMLValMarked</literal> has been deprecated. Use + <literal>lib.traceValFn (x: str + builtins.toXML x)</literal> instead. </para> - </listitem> - <listitem> + </listitem> + <listitem> <para> - <literal>lib.traceCallXml</literal> has been deprecated. Please complain - if you use the function regularly. + <literal>lib.traceValIfNot</literal> has been deprecated. Use + <literal>if/then/else</literal> and <literal>lib.traceValSeq</literal> + instead. </para> + </listitem> + <listitem> <para> - The attribute <literal>lib.nixpkgsVersion</literal> has been deprecated in favor of - <literal>lib.version</literal>. Please refer to the discussion in - <link xlink:href="https://github.com/NixOS/nixpkgs/pull/39416#discussion_r183845745">NixOS/nixpkgs#39416</link> for further reference. + <literal>lib.traceCallXml</literal> has been deprecated. Please complain + if you use the function regularly. </para> - </listitem> -</itemizedlist> - -</section> + <para> + The attribute <literal>lib.nixpkgsVersion</literal> has been deprecated in + favor of <literal>lib.version</literal>. Please refer to the discussion in + <link xlink:href="https://github.com/NixOS/nixpkgs/pull/39416#discussion_r183845745">NixOS/nixpkgs#39416</link> + for further reference. + </para> + </listitem> + </itemizedlist> + </section> </section> |