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