man pages section 1: User Commands

git-stripspace (1)

Name

git-stripspace - Remove unnecessary whitespace

Synopsis

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

Description

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



NAME
       git-stripspace - Remove unnecessary whitespace

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


DESCRIPTION
       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:

       o   remove trailing whitespace from all lines

       o   collapse multiple consecutive empty lines into one empty line

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

       o   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
       -s, --strip-comments
           Skip and remove all lines starting with comment character (default
           #).

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

EXAMPLES
       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
       Part of the git(1) suite



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       +---------------+--------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE      |
       +---------------+--------------------------+
       |Availability   | developer/versioning/git |
       +---------------+--------------------------+
       |Stability      | Uncommitted              |
       +---------------+--------------------------+
NOTES
       This software was built from source available at
       https://java.net/projects/solaris-userland.  The original community
       source was downloaded from
       https://www.kernel.org/pub/software/scm/git/git-2.7.4.tar.xz

       Further information about this software can be found on the open source
       community website at http://git-scm.com/.



Git 2.7.4                         03/17/2016                 GIT-STRIPSPACE(1)