27 Mar, 2020

1 commit

  • Add an --order switch to control section reordering.
    Default for --order is off.

    Change the default ordering to a slightly more sensible:

    M: Person acting as a maintainer
    R: Person acting as a patch reviewer
    L: Mailing list where patches should be sent
    S: Maintenance status
    W: URI for general information
    Q: URI for patchwork tracking
    B: URI for bug tracking/submission
    C: URI for chat
    P: URI or file for subsystem specific coding styles
    T: SCM tree type and location
    F: File and directory pattern
    X: File and directory exclusion pattern
    N: File glob
    K: Keyword - patch content regex

    Signed-off-by: Joe Perches
    Signed-off-by: Linus Torvalds

    Joe Perches
     

07 Mar, 2020

1 commit


18 Nov, 2017

1 commit

  • parse-maintainers.pl is convenient, but currently hard-codes the
    filenames that are used.

    Allow user-specified filenames to simplify the use of the script.

    Link: http://lkml.kernel.org/r/48703c068b3235223ffa3b2eb268fa0a125b25e0.1502251549.git.joe@perches.com
    Signed-off-by: Joe Perches
    Signed-off-by: Andrew Morton
    Signed-off-by: Linus Torvalds

    Joe Perches
     

02 Nov, 2017

1 commit

  • Many source files in the tree are missing licensing information, which
    makes it harder for compliance tools to determine the correct license.

    By default all files without license information are under the default
    license of the kernel, which is GPL version 2.

    Update the files which contain no license information with the 'GPL-2.0'
    SPDX license identifier. The SPDX identifier is a legally binding
    shorthand, which can be used instead of the full boiler plate text.

    This patch is based on work done by Thomas Gleixner and Kate Stewart and
    Philippe Ombredanne.

    How this work was done:

    Patches were generated and checked against linux-4.14-rc6 for a subset of
    the use cases:
    - file had no licensing information it it.
    - file was a */uapi/* one with no licensing information in it,
    - file was a */uapi/* one with existing licensing information,

    Further patches will be generated in subsequent months to fix up cases
    where non-standard license headers were used, and references to license
    had to be inferred by heuristics based on keywords.

    The analysis to determine which SPDX License Identifier to be applied to
    a file was done in a spreadsheet of side by side results from of the
    output of two independent scanners (ScanCode & Windriver) producing SPDX
    tag:value files created by Philippe Ombredanne. Philippe prepared the
    base worksheet, and did an initial spot review of a few 1000 files.

    The 4.13 kernel was the starting point of the analysis with 60,537 files
    assessed. Kate Stewart did a file by file comparison of the scanner
    results in the spreadsheet to determine which SPDX license identifier(s)
    to be applied to the file. She confirmed any determination that was not
    immediately clear with lawyers working with the Linux Foundation.

    Criteria used to select files for SPDX license identifier tagging was:
    - Files considered eligible had to be source code files.
    - Make and config files were included as candidates if they contained >5
    lines of source
    - File already had some variant of a license header in it (even if
    Reviewed-by: Philippe Ombredanne
    Reviewed-by: Thomas Gleixner
    Signed-off-by: Greg Kroah-Hartman

    Greg Kroah-Hartman
     

09 Aug, 2017

3 commits

  • Allow any number of command line arguments to match either the
    section header or the section contents and create new files.

    Create MAINTAINERS.new and SECTION.new.

    This allows scripting of the movement of various sections from
    MAINTAINERS.

    Signed-off-by: Joe Perches
    Signed-off-by: Linus Torvalds

    Joe Perches
     
  • Instead of reading STDIN and writing STDOUT, use specific filenames of
    MAINTAINERS and MAINTAINERS.new.

    Use hash references instead of global hash %hash so future modifications
    can read and write specific hashes to split up MAINTAINERS into multiple
    files using a script.

    Signed-off-by: Joe Perches
    Signed-off-by: Linus Torvalds

    Joe Perches
     
  • Section [A-Z]: patterns are not currently in any required sorting order.
    Add a specific sorting sequence to MAINTAINERS entries.
    Sort F: and X: patterns in alphabetic order.

    The preferred section ordering is:

    SECTION HEADER
    M: Maintainers
    R: Reviewers
    P: Named persons without email addresses
    L: Mailing list addresses
    S: Status of this section (Supported, Maintained, Orphan, etc...)
    W: Any relevant URLs
    T: Source code control type (git, quilt, etc)
    Q: Patchwork patch acceptance queue site
    B: Bug tracking URIs
    C: Chat URIs
    F: Files with wildcard patterns (alphabetic ordered)
    X: Excluded files with wildcard patterns (alphabetic ordered)
    N: Files with regex patterns
    K: Keyword regexes in source code for maintainership identification

    Miscellaneous perl neatening:

    - Rename %map to %hash, map has a different meaning in perl
    - Avoid using \& and local variables for function indirection
    - Use return for a little c like clarity
    - Use c-like function call style instead of &function

    Signed-off-by: Joe Perches
    Signed-off-by: Linus Torvalds

    Joe Perches
     

24 Jul, 2017

1 commit

  • This adds a perl script to actually parse the MAINTAINERS file, clean up
    some whitespace in it, warn about errors in it, and then properly sort
    the end result.

    My perl-fu is atrocious, so the script has basically been created by
    randomly putting various characters in a pile, mixing them around, and
    then looking it the end result does anything interesting when used as a
    perl script.

    Signed-off-by: Linus Torvalds

    Linus Torvalds