Eric Lee / smarc-fsl-linux-kernel

17 Jul, 2019

3 commits

01 Jul, 2019

1 commit

  • 7282a93f4   Disable Sphinx SmartyPants in HTML output ... Browse Code »

    The handling of dashes in particular results in confusing
    documentation in a number of instances, since "--" becomes an
    en-dash. This disables SmartyPants wholesale, losing smart quotes
    along with smart dashes.

    With Sphinx 1.6 we could fine-tune the conversion, using the new
    smartquotes and smartquotes_action settings.

    Signed-off-by: Stephen Kitt
    Signed-off-by: Jonathan Corbet

    Stephen Kitt
     

27 Jun, 2019

1 commit

24 May, 2019

1 commit

  • 3bc808846   docs: Fix conf.py for Sphinx 2.0 ... Browse Code »

    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: Jonathan Corbet

    Jonathan Corbet
     

25 Oct, 2018

1 commit

  • 01aa9d518   Merge tag 'docs-4.20' of git://git.lwn.net/linux ... Browse Code »

    Pull documentation updates from Jonathan Corbet:
    "This is a fairly typical cycle for documentation. There's some welcome
    readability improvements for the formatted output, some LICENSES
    updates including the addition of the ISC license, the removal of the
    unloved and unmaintained 00-INDEX files, the deprecated APIs document
    from Kees, more MM docs from Mike Rapoport, and the usual pile of typo
    fixes and corrections"

    * tag 'docs-4.20' of git://git.lwn.net/linux: (41 commits)
    docs: Fix typos in histogram.rst
    docs: Introduce deprecated APIs list
    kernel-doc: fix declaration type determination
    doc: fix a typo in adding-syscalls.rst
    docs/admin-guide: memory-hotplug: remove table of contents
    doc: printk-formats: Remove bogus kobject references for device nodes
    Documentation: preempt-locking: Use better example
    dm flakey: Document "error_writes" feature
    docs/completion.txt: Fix a couple of punctuation nits
    LICENSES: Add ISC license text
    LICENSES: Add note to CDDL-1.0 license that it should not be used
    docs/core-api: memory-hotplug: add some details about locking internals
    docs/core-api: rename memory-hotplug-notifier to memory-hotplug
    docs: improve readability for people with poorer eyesight
    yama: clarify ptrace_scope=2 in Yama documentation
    docs/vm: split memory hotplug notifier description to Documentation/core-api
    docs: move memory hotplug description into admin-guide/mm
    doc: Fix acronym "FEKEK" in ecryptfs
    docs: fix some broken documentation references
    iommu: Fix passthrough option documentation
    ...

    Linus Torvalds
     

07 Oct, 2018

1 commit

  • 44ba0bb4f   docs: improve readability for people with poorer eyesight ... Browse Code »

    My eyesight is not in good shape, which means that I have difficulty
    reading the online Linux documentation. Specifically, body text is
    oddly small compared to list items and the contrast of various text
    elements is too low for me to be able to see easily.

    Therefore, alter the HTML theme overrides to make the text larger and
    increase the contrast for better visibility, and trust the typeface
    choices of the reader's browser.

    For the PDF output, increase the text size, use a sans-serif typeface
    for sans-serif text, and use a serif typeface for "roman" serif text.

    Signed-off-by: Darrick J. Wong
    Acked-by: Dave Chinner
    Signed-off-by: Jonathan Corbet

    Darrick J. Wong
     

06 Oct, 2018

2 commits

03 Oct, 2018

1 commit

30 Jul, 2018

1 commit

12 Dec, 2017

1 commit

09 Sep, 2017

3 commits

  • 54d6d73f5   docs-rst: don't require adjustbox anymore ... Browse Code »

    Only the media PDF book was requiring adjustbox, in order to
    scale big tables. That worked pretty good with Sphinx versions
    1.4 and 1.5, but Spinx 1.6 changed the way tables are produced,
    by introducing some weird macros before tabulary.
    That causes adjustbox to fail. So, it can't be used anymore,
    and its usage was removed from the media book.

    So, let's remove it from conf.py and sphinx-pre-install.

    Signed-off-by: Mauro Carvalho Chehab
    Signed-off-by: Jonathan Corbet

    Mauro Carvalho Chehab
     
  • 9fdcd6afd   docs-rst: conf.py: only setup notice box colors if Sphinx < 1.6 ... Browse Code »

    Sphinx 1.5 added a new way to change backward colors for note
    boxes, but kept backward compatibility with 1.4. On Sphinx 1.6,
    the old way stopped working, in favor of a new less hackish
    way.

    Unfortunately, this is currently too buggy to be used, and
    the old way doesn't work anymore. So, we have no option but
    to stick with boring notice boxes.

    One example of such bug is the notice that it is inside
    struct v4l2_plane, at the "bytesused" field.

    At least, add a notice about how to use, as maybe some day
    the bug will vanish.

    Signed-off-by: Mauro Carvalho Chehab
    Signed-off-by: Jonathan Corbet

    Mauro Carvalho Chehab
     
  • c4b326e1a   docs-rst: conf.py: remove lscape from LaTeX preamble ... Browse Code »

    Only the media book used this extension in the past, but
    it is not required anymore.

    Cleanup patch only.

    Signed-off-by: Mauro Carvalho Chehab
    Signed-off-by: Jonathan Corbet

    Mauro Carvalho Chehab
     

27 Aug, 2017

1 commit

25 Aug, 2017

2 commits

  • 0e4c2b758   docs: fix minimal sphinx version in conf.py ... Browse Code »

    according to what Documentation/doc-guide/sphinx.rst says::

    The ReST markups currently used by the Documentation/ files
    are meant to be built with ``Sphinx`` version 1.3 or upper.

    Signed-off-by: Markus Heiser
    Signed-off-by: Jonathan Corbet

    Markus Heiser
     
  • 5148e6ab7   docs-rst: pdf: use same vertical margin on all Sphinx versions ... Browse Code »

    Currently, on Sphinx up to version 1.4, pdf output uses a vertical
    margin of 1 inch. For upper versions, it uses a margin of 0.5 inches.

    That causes both page headers and footers to be very close to the margin
    of the sheet. Not all printers support writing like that.

    Also, there's no reason why the layout for newer versions would be
    different than for previous ones.

    So, standardize it, by always setting to 1 inch.

    Signed-off-by: Mauro Carvalho Chehab
    Signed-off-by: Jonathan Corbet

    Mauro Carvalho Chehab
     

24 Jun, 2017

2 commits

  • 633d612bd   Docs: Fix breakage with Sphinx 1.5 and upper ... Browse Code »

    Commit 85c21e5c3ee7 (docs-rst: better adjust margins and font size) added a
    \usepackage{geometry} that conflicts with another inclusion deep within the
    dependencies with newer versions of Sphinx, causing the the PDF build to fail
    with a "conflicting parameters" error.

    Detect the Sphinx version, using sphinxsetup for Sphinx versions 1.5 and
    upper.

    Fixes: 85c21e5c3ee74fb75d690c57f7066bae7e2dca55
    [jc: Tweaked logic to exclude 1.5.x for x < 3 ]
    Signed-off-by: Mauro Carvalho Chehab

    Mauro Carvalho Chehab
     
  • cc1102219   Docs: Include the Latex "ifthen" package ... Browse Code »

    Otherwise we get PDF build failures when LaTeX refused to acknowledge the
    existence of \ifthenelse

    Fixes: 41cff161fe99d1c6a773becc2250a1dc3ac035ff
    Cc: Mauro Carvalho Chehab
    Signed-off-by: Jonathan Corbet

    Jonathan Corbet
     

16 May, 2017

11 commits

04 May, 2017

1 commit

  • 16a12fa9a   Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/dtor/input ... Browse Code »

    Pull input subsystem updates from Dmitry Torokhov:

    - a big update from Mauro converting input documentation to ReST format

    - Synaptics PS/2 is now aware of SMBus companion devices, which means
    that we can now use native RMI4 protocol to handle touchpads, instead
    of relying on legacy PS/2 mode.

    - we removed support from BMA180 accelerometer from input devices as it
    is now handled properly by IIO

    - update to TSC2007 to corretcly report pressure

    - other miscellaneous driver fixes.

    * 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/dtor/input: (152 commits)
    Input: ar1021_i2c - use BIT to check for a bit
    Input: twl4030-pwrbutton - use input_set_capability() helper
    Input: twl4030-pwrbutton - use correct device for irq request
    Input: ar1021_i2c - enable touch mode during open
    Input: add uinput documentation
    dt-bindings: input: add bindings document for ar1021_i2c driver
    dt-bindings: input: rotary-encoder: fix typo
    Input: xen-kbdfront - add module parameter for setting resolution
    ARM: pxa/raumfeld: fix compile error in rotary controller resources
    Input: xpad - do not suggest writing to Dominic
    Input: xpad - don't use literal blocks inside footnotes
    Input: xpad - note that usb/devices is now at /sys/kernel/debug/
    Input: docs - freshen up introduction
    Input: docs - split input docs into kernel- and user-facing
    Input: docs - note that MT-A protocol is obsolete
    Input: docs - update joystick documentation a bit
    Input: docs - remove disclaimer/GPL notice
    Input: fix "Game console" heading level in joystick documentation
    Input: rotary-encoder - remove references to platform data from docs
    Input: move documentation for Amiga CD32
    ...

    Linus Torvalds
     

06 Apr, 2017

1 commit

31 Mar, 2017

1 commit

09 Mar, 2017

1 commit

  • db6ccf23e   docs-rst: automatically convert Graphviz and SVG images ... Browse Code »

    This patch brings scalable figure, image handling and a concept to
    embed *render* markups:

    * DOT (http://www.graphviz.org)
    * SVG

    For image handling use the 'image' replacement::

    .. kernel-image:: svg_image.svg
    :alt: simple SVG image

    For figure handling use the 'figure' replacement::

    .. kernel-figure:: svg_image.svg
    :alt: simple SVG image

    SVG image example

    Embed *render* markups (or languages) like Graphviz's **DOT** is
    provided by the *render* directive.::

    .. kernel-render:: DOT
    :alt: foobar digraph
    :caption: Embedded **DOT** (Graphviz) code.

    digraph foo {
    "bar" -> "baz";
    }

    The *render* directive is a concept to integrate *render* markups and
    languages, yet supported markups:

    * DOT: render embedded Graphviz's **DOT**
    * SVG: render embedded Scalable Vector Graphics (**SVG**)

    Cc: Jani Nikula
    Cc: Laurent Pinchart
    Tested-by: Mauro Carvalho Chehab
    Tested-by: Daniel Vetter
    Signed-off-by: Daniel Vetter (v2 - v5)
    Signed-off-by: Markus Heiser (v1, v6)
    Signed-off-by: Jonathan Corbet

    Markus Heiser
     

04 Mar, 2017

1 commit

07 Feb, 2017

1 commit

20 Nov, 2016

1 commit

17 Nov, 2016

1 commit