Add a basic tutorial for the tools in depot_tools.

docs/src/make_docs.sh

 #!/bin/bash -e
 shopt -s nullglob
 
 cd $(dirname "$0")
 
 # Script which takes all the asciidoc git-*.txt files in this directory, renders
 # them to html + manpage format using git 1.9's doc toolchain, then puts
 # them in depot_tools to be committed.
 
 ensure_in_path() {
@@ skipping 112 matching lines @@
         # ex.
         # CATEGORY TOOLS
         # --------------
         BANNER=$(echo $category tools | awk '{print toupper($0)}')
         echo $BANNER
         for i in $(seq 1 ${#BANNER})
         do
           echo -n -
         done
         echo
+        cat _${category}_prefix.txt 2> /dev/null || true
         echo
       fi
 
       # ex.
       # linkgit:git-tool[1]::
       # \tinclude::_git-tool_desc.category.txt[]
       PLAIN_PATH=${x%%_desc.*.txt}
       PLAIN_PATH=${PLAIN_PATH:1}
       echo "linkgit:$PLAIN_PATH[1]::"
       echo -e "include::${x}[]"
       echo
     done
   } > __${category}.txt
 done
 
-JOBS=0
+JOBS=1
 HTML_TARGETS=()
 MAN_TARGETS=()
 for x in *.txt *.css
 do
   TO="git/Documentation/$x"
   if [[ ! -f "$TO" ]] || ! cmp --silent "$x" "$TO"
   then
     echo \'$x\' differs
     cp $x "$TO"
-  fi
-  # Exclude files beginning with _ from the target list. This is useful to have
-  # includable snippet files.
-  if [[ ${x:0:1} != _ && ${x:(-4)} == .txt ]]
-  then
-    HTML_TARGETS+=("${x%%.txt}.html")
-    if [[ ${x:0:3} == git ]]
+    # Exclude files beginning with _ from the target list. This is useful to have

[Ryan Tseng, 2014/04/05 00:51:20]

80 char

[iannucci, 2014/04/05 01:31:13]

Done.

[iannucci, 2014/04/05 01:31:13]

Done.

+    # includable snippet files.
+    if [[ ${x:0:1} != _ && ${x:(-4)} == .txt ]]
     then
-      MAN1_TARGETS+=("${x%%.txt}.1")
-    else
-      MAN7_TARGETS+=("${x%%.txt}.7")
+      HTML_TARGETS+=("${x%%.txt}.html")
+      if [[ ${x:0:3} == git ]]
+      then
+        MAN1_TARGETS+=("${x%%.txt}.1")
+      else
+        MAN7_TARGETS+=("${x%%.txt}.7")
+      fi
+      JOBS=$[$JOBS + 2]
     fi
-    JOBS=$[$JOBS + 2]
   fi
 done
 
+if [[ ${#HTML_TARGETS} == 0 && ${#MAN_TARGETS} == 0 ]]
+then
+  exit
+fi
+
 VER="v$(git rev-parse --short HEAD)"
 if [[ ! -f git/version ]] || ! cmp --silent git/version <(echo "$VER")
 then
   echo Version changed, cleaning.
   echo "$VER" > git/version
   (cd git/Documentation && make clean)
 fi
 
 # This export is so that asciidoc sys snippets which invoke git run relative to
 # depot_tools instead of the git clone.
@@ skipping 13 matching lines @@
 do
   echo Copying ../man1/$x
   cp "git/Documentation/$x" ../man1
 done
 
 for x in "${MAN7_TARGETS[@]}"
 do
   echo Copying ../man7/$x
   cp "git/Documentation/$x" ../man7
 done