asciidoc: moved support files into doc/

Docs should live happily together, after all,
and toplevel should be more or less uncluttered :)

Adjusted/rewrote as appropriate as well.

Makefile

@@ -61,3 +61,6 @@ SHELL = /bin/bash
 		fi; \
 	done; \
 	if [ "$$n" -lt "$(NUM_TARGETS)" ]; then say; fi
+
+docs:
+	@$(MAKE) -C doc

README.asciidoc

@@ -1,14 +0,0 @@
-== Генерация документации == 
-
-Необходимые пакеты:
-apt-get install asciidoc-a2x xmlgraphics* fonts-ttf-ms
-Внимание! Пакеты весьма увесисты (около гигабайта), имейте ввиду.
-
-Для генерации текущей документации посредством ASCIIDOC выполнить:
-для pdf-версии
-  make -f Makefile.asciidoc -d pdf
-для html-версии
-  make -f Makefile.asciidoc -d
-
-Сгенерируются соответственно mkimage-profiles.pdf или mkimage-profiles.html
-Опция -d для детального вывода, необязательна.

doc/.fop.xconf

@@ -1,9 +1,9 @@
 <?xml version="1.0"?>
 <!-- $Id: fop.xconf 901793 2010-01-21 17:37:07Z jeremias $ -->
- 
+
 <!-- NOTE: This is the version of the configuration -->
 <fop version="1.0">
- 
+
   <base>.</base>
   <source-resolution>72</source-resolution>
   <target-resolution>72</target-resolution>
@@ -13,42 +13,42 @@
       <filterList>
         <value>flate</value>
       </filterList>
- 
+
       <fonts>
-          <auto-detect/> 
+          <auto-detect/>
       </fonts>
     </renderer>
- 
+
     <renderer mime="application/x-afp">
       <images mode="b+w" bits-per-pixel="8"/>
       <renderer-resolution>240</renderer-resolution>
       <resource-group-file>resources.afp</resource-group-file>
     </renderer>
- 
+
     <renderer mime="application/postscript">
     </renderer>
- 
+
     <renderer mime="application/vnd.hp-PCL">
     </renderer>
- 
+
     <renderer mime="image/svg+xml">
       <format type="paginated"/>
       <link value="true"/>
       <strokeText value="false"/>
     </renderer>
- 
+
     <renderer mime="application/awt">
     </renderer>
- 
+
     <renderer mime="image/png">
     </renderer>
- 
+
     <renderer mime="image/tiff">
     </renderer>
- 
+
     <renderer mime="text/xml">
     </renderer>
- 
+
   </renderers>
- 
+
-</fop>
+</fop>

doc/Makefile

@@ -1,7 +1,7 @@
 PROJECT = mkimage-profiles
 TOPLEVEL_DOC = mkimage-profiles.asciidoc
 HTMLPAGE = $(TOPLEVEL_DOC:.asciidoc=.html)
-RESOURCE_FILES = /etc/asciidoc/
+RESOURCE_FILES = /etc/asciidoc
 
 A2X = a2x
 
@@ -11,18 +11,18 @@ all: $(HTMLPAGE)
 
 %.html: %.asciidoc
 	$(A2X) -d book -f xhtml -a lang=ru \
-	  --icons -r $(RESOURCE_FILES) -r ./ \
+	  --icons -r $(RESOURCE_FILES) -r . \
 	  --xsltproc-opts='--stringparam toc.max.depth 3' \
 	  $<
 
 chunked: $(TOPLEVEL_DOC)
 	$(A2X) -d book -f chunked -a lang=ru \
-	  --icons -r /etc/asciidoc/ -r ./ \
+	  --icons -r $(RESOURCE_FILES) -r . \
 	  --xsltproc-opts='--stringparam toc.max.depth 3' \
 	  $<
 
 pdf: $(TOPLEVEL_DOC)
-	$(A2X) --verbose --fop --fop-opts='-c fop.xconf' -d book -f pdf -a lang=ru \
+	$(A2X) --verbose --fop --fop-opts='-c .fop.xconf' -d book -f pdf -a lang=ru \
 	  --xsltproc-opts=' \
 	  --stringparam toc.max.depth 3 \
 	  --stringparam title.font.family "Arial" \

doc/assumptions.txt

@@ -1,5 +1,4 @@
-
+== Предположения фрагментов кода об окружении ==
-*Предположения фрагментов кода об окружении*
 
 NB: пути приводятся от верхнего уровня; проект в целом предполагает
 ALT Linux 6.0+ и GNU make 3.81 (на которых и разрабатывается),

doc/gen-asciidoc.txt

@@ -0,0 +1,16 @@
+== Генерация документации ==
+
+При желании сгенерировать PDF устанавливаем необходимые пакеты:
+  # apt-get install asciidoc-a2x xmlgraphics-fop fonts-ttf-dejavu
+
+// Внимание!  FOP со всем нужным весьма увесист (несколько сот мегабайт).
+
+Для генерации текущей документации посредством ASCIIDOC выполнить по вкусу:
+  $ make pdf
+  $ make xhtml
+
+Сгенерируются соответственно mkimage-profiles.pdf или mkimage-profiles.html
+(в текущем каталоге либо BUILDDIR, если задан).
+
+Для очистки:
+  $ make clean

doc/mkimage-profiles.asciidoc

@@ -1,11 +1,12 @@
 = mkimage-profiles =
 Michael Shigorin <mike@altlinux.org>
-:DocVersion: v0.1.0
+:DocVersion: v0.2.0
 :DocDate:  Oct 2012
 
 = Введение =
 
-mkimage-profiles, или m-p — результат осмысления и обобщения опыта создания семейств дистрибутивов.
+mkimage-profiles, или m-p — результат осмысления и обобщения опыта создания
+семейств дистрибутивов свободного программного обеспечения на базе ALT Linux.
 
 *Цели*
 
@@ -30,45 +31,43 @@ mkimage-profiles, или m-p — результат осмысления и об
   cd mkimage-profiles
   make distro/icewm.iso
 
-include::README[]
+include::../README[]
 
 = Основы =
 
-== Предположения об окружении ==
+include::assumptions.txt[]
 
-include::doc/assumptions.txt[]
+include::debug.txt[]
 
-include::doc/debug.txt[]
+include::features.txt[]
 
-include::doc/features.txt[]
+include::params.txt[]
 
-include::doc/params.txt[]
+include::pkglists.txt[]
 
-include::doc/pkglists.txt[]
+include::qemu.txt[]
 
-include::doc/qemu.txt[]
+include::style.txt[]
 
-include::doc/style.txt[]
+include::vm.txt[]
-
-include::doc/vm.txt[]
 
 
 = Каталоги =
 
-include::conf.d/README[]
+include::../conf.d/README[]
 
-include::features.in/README[]
+include::../features.in/README[]
 
-include::image.in/README[]
+include::../image.in/README[]
 
-include::lib/README[]
+include::../lib/README[]
 
-include::pkg.in/README[]
+include::../pkg.in/README[]
 
-include::sub.in/README[]
+include::../sub.in/README[]
 
-include::sub.in/main/README[]
+include::../sub.in/main/README[]
 
-include::sub.in/stage1/README[]
+include::../sub.in/stage1/README[]
 
-include::sub.in/stage2/README[]
+include::../sub.in/stage2/README[]