1. 25 Mar, 2019 6 commits
    • Sean Christopherson's avatar
      checkpatch: Warn on improper usage of Co-developed-by · 6c5d24ee
      Sean Christopherson authored
      The purpose of Co-developed-by: is to give attribution to authors who
      aren't already attributed by the From: tag, i.e. who aren't the nominal
      patch author.  Because Co-developed-by: is essentially a variation of
      From:, it must be accompanied by a Signed-off-by: of the associated
      co-author.  To ease the burden of determining whether or not co-authors
      have signed off, Co-developed-by and Signed-off-by: must be explicitly
      paired, i.e. on consecutive lines for a given co-author.
      Suggested-by: default avatarJoe Perches <joe@perches.com>
      Signed-off-by: default avatarSean Christopherson <sean.j.christopherson@intel.com>
      Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
      6c5d24ee
    • Joel Stanley's avatar
      Documentation: rtc: Correct location of rtctest.c · c5576080
      Joel Stanley authored
      The useful little rtctest program moved location a while back.
      
      Fixes: a12ab9e1 ("selftests: move RTC tests to rtc subfolder")
      Signed-off-by: default avatarJoel Stanley <joel@jms.id.au>
      Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
      c5576080
    • Sean Christopherson's avatar
      docs: Clarify the usage and sign-off requirements for Co-developed-by · 24a2bb90
      Sean Christopherson authored
      The documentation for Co-developed-by is a bit light on details, e.g. it
      doesn't explicitly state that:
      
        - Multiple Co-developed-by tags are perfectly acceptable
        - Co-developed-by and Signed-off-by must be paired together
        - SOB ordering should still follow standard sign-off procedure
      
      Lack of explicit direction has resulted in developers taking a variety
      of approaches, often lacking any intent whatsoever, e.g. scattering SOBs
      willy-nilly, collecting them all at the end or the beginning, etc...
      Tweak the wording to make it clear that multiple co-authors are allowed,
      and document the expectation that standard sign-off procedures are to
      be followed.
      
      The use of "original author" has also led to confusion as many patches
      don't have just one "original" author, e.g. when multiple developers
      are involved from the genesis of the patch.  Remove all usage of
      "original" and instead call out that Co-developed-by is simply a way to
      provide attribution in addition to the From tag, i.e. neither tag is
      intended to imply anything with regard to who did what.
      
      Provide examples to (hopefully) eliminate any ambiguity.
      
      Cc: Tobin C. Harding <me@tobin.cc>
      Cc: Thomas Gleixner <tglx@linutronix.de>
      Cc: Jani Nikula <jani.nikula@linux.intel.com>
      Cc: Jorge Ramirez-Ortiz <jorge.ramirez-ortiz@linaro.org>
      Cc: Jonathan Cameron <jic23@kernel.org>
      Cc: Joe Perches <joe@perches.com>
      Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
      Cc: Niklas Cassel <niklas.cassel@linaro.org>
      Cc: Jonathan Corbet <corbet@lwn.net>
      Signed-off-by: default avatarSean Christopherson <sean.j.christopherson@intel.com>
      Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
      24a2bb90
    • Federico Vaga's avatar
      doc: minor fixes to translation's disclaimer · 224b1e86
      Federico Vaga authored
      - move TOC on top because that's the most interesting part
      - a couple of minor fixes
      Signed-off-by: default avatarFederico Vaga <federico.vaga@vaga.pv.it>
      Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
      224b1e86
    • Tom Levy's avatar
      docs: remove spaces from shell variable assignment · 4318f9bb
      Tom Levy authored
      The instructions for generating patches are given as shell commands
      with variables as placeholders. They use the syntax "SRCTREE= linux",
      which is wrong for the Bourne shell family (it runs the command
      "linux" with the variable "SRCTREE" set to the empty string).
      
      Remove the spaces to avoid confusion. This breaks the pretty alignment
      but helps new contributors who try to run the commands as written.
      Signed-off-by: default avatarTom Levy <tomlevy93@gmail.com>
      Cc: Jonathan Corbet <corbet@lwn.net>
      Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
      4318f9bb
    • Jakub Wilk's avatar
      Documentation: fix core_pattern max length · cc809ed8
      Jakub Wilk authored
      The buffer size for core_pattern is 128, but one character is used for
      terminating null byte, so the actual limit is 127:
      
          # printf '%0999d' > /proc/sys/kernel/core_pattern
          # tr -d '\n' < /proc/sys/kernel/core_pattern | wc -c
          127
      Signed-off-by: default avatarJakub Wilk <jwilk@jwilk.net>
      Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
      cc809ed8
  2. 18 Mar, 2019 34 commits