Documentation/git-stripspace.txt

   1 git-stripspace(1)
   2 =================
   3
   4 NAME
   5 ----
   6 git-stripspace - Remove unnecessary whitespace
   7
   8
   9 SYNOPSIS
  10 --------
  11 [verse]
  12 'git stripspace' [-s | --strip-comments]
  13 'git stripspace' [-c | --comment-lines]
  14
  15 DESCRIPTION
  16 -----------
  17
  18 Read text, such as commit messages, notes, tags and branch
  19 descriptions, from the standard input and clean it in the manner
  20 used by Git.
  21
  22 With no arguments, this will:
  23
  24 - remove trailing whitespace from all lines
  25 - collapse multiple consecutive empty lines into one empty line
  26 - remove empty lines from the beginning and end of the input
  27 - add a missing '\n' to the last line if necessary.
  28
  29 In the case where the input consists entirely of whitespace characters, no
  30 output will be produced.
  31
  32 *NOTE*: This is intended for cleaning metadata. Prefer the `--whitespace=fix`
  33 mode of linkgit:git-apply[1] for correcting whitespace of patches or files in
  34 the repository.
  35
  36 OPTIONS
  37 -------
  38 -s::
  39 --strip-comments::
  40         Skip and remove all lines starting with a comment character (default '#').
  41
  42 -c::
  43 --comment-lines::
  44         Prepend the comment character and a blank space to each line. Lines will automatically
  45         be terminated with a newline. On empty lines, only the comment character
  46         will be prepended.
  47
  48 EXAMPLES
  49 --------
  50
  51 Given the following noisy input with '$' indicating the end of a line:
  52
  53 ---------
  54 |A brief introduction   $
  55 |   $
  56 |$
  57 |A new paragraph$
  58 |# with a commented-out line    $
  59 |explaining lots of stuff.$
  60 |$
  61 |# An old paragraph, also commented-out. $
  62 |      $
  63 |The end.$
  64 |  $
  65 ---------
  66
  67 Use 'git stripspace' with no arguments to obtain:
  68
  69 ---------
  70 |A brief introduction$
  71 |$
  72 |A new paragraph$
  73 |# with a commented-out line$
  74 |explaining lots of stuff.$
  75 |$
  76 |# An old paragraph, also commented-out.$
  77 |$
  78 |The end.$
  79 ---------
  80
  81 Use 'git stripspace --strip-comments' to obtain:
  82
  83 ---------
  84 |A brief introduction$
  85 |$
  86 |A new paragraph$
  87 |explaining lots of stuff.$
  88 |$
  89 |The end.$
  90 ---------
  91
  92 GIT
  93 ---
  94 Part of the linkgit:git[1] suite