git-stripspace(1) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| OPTIONS \| EXAMPLES \| GIT \| COLOPHON

GIT-STRIPSPACE(1)              Git Manual              GIT-STRIPSPACE(1)

NAME top

       git-stripspace - Remove unnecessary whitespace

SYNOPSIS top

       git stripspace [-s | --strip-comments]
       git stripspace [-c | --comment-lines]

DESCRIPTION top

       Read text, such as commit messages, notes, tags and branch
       descriptions, from the standard input and clean it in the manner
       used by Git.

       With no arguments, this will:

       •   remove trailing whitespace from all lines

       •   collapse multiple consecutive empty lines into one empty line

       •   remove empty lines from the beginning and end of the input

       •   add a missing \n to the last line if necessary.

       In the case where the input consists entirely of whitespace
       characters, no output will be produced.

       NOTE: This is intended for cleaning metadata. Prefer the
       --whitespace=fix mode of git-apply(1) for correcting whitespace
       of patches or files in the repository.

OPTIONS top

       -s, --strip-comments
           Skip and remove all lines starting with a comment character
           (default #).

       -c, --comment-lines
           Prepend the comment character and a blank space to each line.
           Lines will automatically be terminated with a newline. On
           empty lines, only the comment character will be prepended.

EXAMPLES top

       Given the following noisy input with $ indicating the end of a
       line:

           |A brief introduction   $
           |   $
           |$
           |A new paragraph$
           |# with a commented-out line    $
           |explaining lots of stuff.$
           |$
           |# An old paragraph, also commented-out. $
           |      $
           |The end.$
           |  $

       Use git stripspace with no arguments to obtain:

           |A brief introduction$
           |$
           |A new paragraph$
           |# with a commented-out line$
           |explaining lots of stuff.$
           |$
           |# An old paragraph, also commented-out.$
           |$
           |The end.$

       Use git stripspace --strip-comments to obtain:

           |A brief introduction$
           |$
           |A new paragraph$
           |explaining lots of stuff.$
           |$
           |The end.$

GIT top

       Part of the git(1) suite

COLOPHON top

       This page is part of the git (Git distributed version control
       system) project.  Information about the project can be found at
       ⟨http://git-scm.com/⟩.  If you have a bug report for this manual
       page, see ⟨http://git-scm.com/community⟩.  This page was obtained
       from the project's upstream Git repository
       ⟨https://github.com/git/git.git⟩ on 2024-06-14.  (At that time,
       the date of the most recent commit that was found in the
       repository was 2024-06-12.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

Git 2.45.2.492.gd63586         2024-06-12              GIT-STRIPSPACE(1)

Pages that refer to this page: git(1)