1. 06 6月, 2019 2 次提交
  2. 04 6月, 2019 1 次提交
  3. 01 6月, 2019 1 次提交
  4. 31 5月, 2019 9 次提交
  5. 30 5月, 2019 12 次提交
  6. 28 5月, 2019 1 次提交
  7. 25 5月, 2019 6 次提交
  8. 24 5月, 2019 3 次提交
    • J
      drm/i915: Maintain consistent documentation subsection ordering · 551bd336
      Jonathan Corbet 提交于
      With Sphinx 2.0 (or prior versions with the deprecation warnings fixed) the
      docs build fails with:
      
        Documentation/gpu/i915.rst:403: WARNING: Title level inconsistent:
      
        Global GTT Fence Handling
        ~~~~~~~~~~~~~~~~~~~~~~~~~
      
        reST markup error:
        Documentation/gpu/i915.rst:403: (SEVERE/4) Title level inconsistent:
      
      I "fixed" it by changing the subsections in i915.rst, but that didn't seem
      like the correct change.  It turns out that a couple of i915 files create
      their own subsections in kerneldoc comments using apostrophes as the
      heading marker:
      
        Layout
        ''''''
      
      That breaks the normal subsection marker ordering, and newer Sphinx is
      rather more strict about enforcing that ordering.  So fix the offending
      comments to make Sphinx happy.
      
      (This is unfortunate, in that kerneldoc comments shouldn't need to be aware
      of where they might be included in the heading hierarchy, but I don't see
      a better way around it).
      
      Cc: stable@vger.kernel.org  # v4.14+
      Acked-by: NJani Nikula <jani.nikula@intel.com>
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      551bd336
    • M
      scripts/sphinx-pre-install: make it handle Sphinx versions · 77d09ad9
      Mauro Carvalho Chehab 提交于
      As we want to switch to a newer Sphinx version in the future,
      add some version detected logic, checking if the current
      version meets the requirement and suggesting upgrade it the
      version is supported but too old.
      Signed-off-by: NMauro Carvalho Chehab <mchehab+samsung@kernel.org>
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      77d09ad9
    • J
      docs: Fix conf.py for Sphinx 2.0 · 3bc80884
      Jonathan Corbet 提交于
      Our version check in Documentation/conf.py never envisioned a world where
      Sphinx moved beyond 1.x.  Now that the unthinkable has happened, fix our
      version check to handle higher version numbers correctly.
      
      Cc: stable@vger.kernel.org
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      3bc80884
  9. 23 5月, 2019 5 次提交
    • J
      docs: fix multiple doc build warnings in enumeration.rst · bbb30909
      Jonathan Corbet 提交于
      The conversion of acpi/enumeration.txt to RST included one markup error,
      leading to many warnings like:
      
        .../firmware-guide/acpi/enumeration.rst:430: WARNING: Unexpected indentation.
      
      Add the missing colon and create some peace.
      
      Fixes: c24bc66e ("Documentation: ACPI: move enumeration.txt to firmware-guide/acpi and convert to reST")
      Cc: Changbin Du <changbin.du@gmail.com>
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      bbb30909
    • J
      lib/list_sort: fix kerneldoc build error · f35a1abd
      Jonathan Corbet 提交于
      Commit 043b3f7b ("lib/list_sort: simplify and remove
      MAX_LIST_LENGTH_BITS") added some useful kerneldoc info, but also broke the
      docs build:
      
        ./lib/list_sort.c:128: WARNING: Definition list ends without a blank line; unexpected unindent.
        ./lib/list_sort.c:161: WARNING: Unexpected indentation.
        ./lib/list_sort.c:162: WARNING: Block quote ends without a blank line; unexpected unindent.
      
      Fix the offending literal block and make the error go away.
      
      Fixes: 043b3f7b ("lib/list_sort: simplify and remove MAX_LIST_LENGTH_BITS")
      Cc: George Spelvin <lkml@sdf.org>
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      f35a1abd
    • J
      docs: fix numaperf.rst and add it to the doc tree · 8867f610
      Jonathan Corbet 提交于
      Commit 13bac55e ("doc/mm: New documentation for memory performance")
      added numaperf.rst, but did not add it to the TOC tree.  There was also an
      incorrectly marked literal block leading to this warning sequence:
      
        numaperf.rst:24: WARNING: Unexpected indentation.
        numaperf.rst:24: WARNING: Inline substitution_reference start-string without end-string.
        numaperf.rst:25: WARNING: Block quote ends without a blank line; unexpected unindent.
      
      Fix the block and add the file to the document tree.
      
      Fixes: 13bac55e ("doc/mm: New documentation for memory performance")
      Cc: Keith Busch <keith.busch@intel.com>
      Reviewed-by: NMike Rapoport <rppt@linux.ibm.com>
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      8867f610
    • J
      doc: Cope with the deprecation of AutoReporter · 2404dad1
      Jonathan Corbet 提交于
      AutoReporter is going away; recent versions of sphinx emit a warning like:
      
        Documentation/sphinx/kerneldoc.py:125:
            RemovedInSphinx20Warning: AutodocReporter is now deprecated.
            Use sphinx.util.docutils.switch_source_input() instead.
      
      Make the switch.  But switch_source_input() only showed up in 1.7, so we
      have to do ugly version checks to keep things working in older versions.
      
      Cc: stable@vger.kernel.org
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      2404dad1
    • J
      doc: Cope with Sphinx logging deprecations · 096ea522
      Jonathan Corbet 提交于
      Recent versions of sphinx will emit messages like:
      
        Documentation/sphinx/kerneldoc.py:103:
           RemovedInSphinx20Warning: app.warning() is now deprecated.
           Use sphinx.util.logging instead.
      
      Switch to sphinx.util.logging to make this unsightly message go away.
      Alas, that interface was only added in version 1.6, so we have to add a
      version check to keep things working with older sphinxes.
      
      Cc: stable@vger.kernel.org
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      096ea522
新手
引导
客服 返回
顶部