Definitely fix formatting.

No warnings, the page looks quite readable.

slapos/recipe/README.build.txt

@@ -5,16 +5,16 @@ Recipe to build the software.
 
 Example buildout::
 
-[buildout]
-parts =
+  [buildout]
+  parts =
     file
 
-[zlib]
-# Use standard configure, make, make install way
-recipe = slapos.cookbook:build
-url = http://prdownloads.sourceforge.net/libpng/zlib-1.2.5.tar.gz?download
-md5sum = c735eab2d659a96e5a594c9e8541ad63
-slapos_promisee =
+  [zlib]
+  # Use standard configure, make, make install way
+  recipe = slapos.cookbook:build
+  url = http://prdownloads.sourceforge.net/libpng/zlib-1.2.5.tar.gz?download
+  md5sum = c735eab2d659a96e5a594c9e8541ad63
+  slapos_promisee =
     directory:include
     file:include/zconf.h
     file:include/zlib.h
@@ -30,14 +30,14 @@ slapos_promisee =
     directory:share/man/man3
     file:share/man/man3/zlib.3
 
-[file]
-recipe = slapos.cookbook:buildcmmi
-url = ftp://ftp.astron.com/pub/file/file-5.04.tar.gz
-md5sum = accade81ff1cc774904b47c72c8aeea0
-environment =
+  [file]
+  recipe = slapos.cookbook:buildcmmi
+  url = ftp://ftp.astron.com/pub/file/file-5.04.tar.gz
+  md5sum = accade81ff1cc774904b47c72c8aeea0
+  environment =
     CPPFLAGS=-I${zlib:location}/include
     LDFLAGS=-L${zlib:location}/lib -Wl,-rpath -Wl,${zlib:location}/lib
-slapos_promisee =
+  slapos_promisee =
     directory:bin
     dynlib:bin/file linked:libz.so.1,libc.so.6,libmagic.so.1 rpath:${zlib:location}/lib,!/lib
     directory:include
@@ -60,18 +60,18 @@ slapos_promisee =
     directory:share/misc
     file:share/misc/magic.mgc
 
-[somethingelse]
-# default way with using script
-recipe = slapos.cookbook:build
-url_0 = http://host/path/file.tar.gz
-md5sum = 9631070eac74f92a812d4785a84d1b4e
-script =
+  [somethingelse]
+  # default way with using script
+  recipe = slapos.cookbook:build
+  url_0 = http://host/path/file.tar.gz
+  md5sum = 9631070eac74f92a812d4785a84d1b4e
+  script =
     import os
     os.chdir(%(work_directory)s)
     unpack(%(url_0), strip_path=True)
     execute('make')
     execute('make install DEST=%(location)s')
-slapos_promisee =
+  slapos_promisee =
     ...
 
 TODO:
@@ -80,10 +80,10 @@ TODO:
 
 slapos_link = <relative/path> [optional-path
 
-can be used as:
+can be used as::
 
-[file]
-slapos_link =
+  [file]
+  slapos_link =
     bin/file
     bin/file ${buildout:bin-directory}/bin/anotherfile
 

slapos/recipe/README.download.txt

@@ -6,6 +6,8 @@ Extremely simple recipe to download using zc.buildout download utility.
 Usage
 -----
 
+::
+
   [buildout]
   parts =
     download

slapos/recipe/README.kvm.txt

@@ -19,6 +19,8 @@ The follow examples lists different kind of configurations.
 KVM with Remote and gzipped Image
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+::
+
     [kvm-testing-with-remote-gzip-image]
     image = http://URL/public.mdv2010.0_x86_64.qcow2.img.gz
 
@@ -56,6 +58,8 @@ KVM with Remote and gzipped Image
 KVM with Remote and raw Image
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+::
+
     [kvm-testing-with-remote-raw-image]
     image = http://URL/public.mdv2010.0_x86_64.qcow2.img
     md5_download = 1a4e371a4e371a4e371a4e371a4e37
@@ -68,7 +72,7 @@ KVM with Remote and raw Image
 KVM with direct local Image file
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-This does not copy and/or download the image.
+This does not copy and/or download the image::
 
     [kvm-testing-with-local-image]
 
@@ -80,7 +84,7 @@ This does not copy and/or download the image.
 KVM with a linux partition
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-This does not copy and/or download the image.
+This does not copy and/or download the image::
 
     [kvm-testing-a-linux-partition]
 

slapos/recipe/README.template.txt

@@ -7,6 +7,8 @@ ability to download template over the network
 Usage
 -----
 
+::
+
   [buildout]
   parts = template