nixpkgs-suyu/nixos/doc/manual/release-notes/rl-1909.xml

<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-19.09">
 <title>Release 19.09 (“Loris”, 2019/09/??)</title>

 <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-19.09-highlights">
  <title>Highlights</title>

  <para>
   In addition to numerous new and upgraded packages, this release has the
   following highlights:
  </para>

  <itemizedlist>
   <listitem>
    <para />
   </listitem>
  </itemizedlist>
 </section>

 <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-19.09-new-services">
  <title>New Services</title>

  <para>
   The following new services were added since the last release:
  </para>

  <itemizedlist>
   <listitem>
    <para>
       Besides the existing <option>services.prometheus</option> module which
       targets Prometheus-1 a new <option>services.prometheus2</option> module
       has been added which targets Prometheus-2.
    </para>
    <para>
       Both modules can be enabled at the same time. In fact
       <link xlink:href="https://prometheus.io/docs/prometheus/latest/migration/#storage">
       this is needed for upgrading existing Prometheus-1 data to Prometheus-2
       </link>.
    </para>
   </listitem>
  </itemizedlist>
 </section>

 <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-19.09-incompatibilities">
  <title>Backward Incompatibilities</title>

  <para>
   When upgrading from a previous release, please be aware of the following
   incompatible changes:
  </para>

  <itemizedlist>
   <listitem>
    <para>
      The option <option>services.prometheus.dataDir</option> has been
      removed. The directory where Prometheus will store its metric data will
      now always be set to <literal>/var/lib/prometheus</literal> and to
      <literal>/var/lib/prometheus2</literal> when using
      <option>services.prometheus2</option>.
    </para>
   </listitem>
  </itemizedlist>
 </section>

 <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-19.09-notable-changes">
  <title>Other Notable Changes</title>

  <itemizedlist>
   <listitem>
    <para>
     The <option>documentation</option> module gained an option named
     <option>documentation.nixos.includeAllModules</option> which makes the generated
     <citerefentry><refentrytitle>configuration.nix</refentrytitle>
     <manvolnum>5</manvolnum></citerefentry> manual page include all options from all NixOS modules
     included in a given <literal>configuration.nix</literal> configuration file. Currently, it is
     set to <literal>false</literal> by default as enabling it frequently prevents evaluation. But
     the plan is to eventually have it set to <literal>true</literal> by default. Please set it to
     <literal>true</literal> now in your <literal>configuration.nix</literal> and fix all the bugs
     it uncovers.
    </para>
   </listitem>
  </itemizedlist>
 </section>
</section>