[Xen-devel] [PATCH 12 of 15 v2] docs: move user and interface .tex documents under reference

[Ian Campbell <ian.campbell@xxxxxxxxxx>]

# HG changeset patch
# User Ian Campbell <ian.campbell@xxxxxxxxxx>
# Date 1322231662 0
# Node ID 9e98f587da45fced29dc9c317f403f53e3fec904
# Parent  00ea49f77bdcef16251e3773c99fc02394524b83
docs: move user and interface .tex documents under reference.

Taking over the top level "user" entry with a relatively obsolete document is a
bit of an annoyance but these docs are not so out of date that they should be
deleted. Move them out of the top-level instead.

(the original motivation here was to allow for user/xl-domain-cfg.markdown but
we have since decided to go with man/xl.cfg.pod.5 instead so perhaps this is a
waste of time)

Signed-off-by: Ian Campbell <ian.campbell@xxxxxxxxxx>

diff -r 00ea49f77bdc -r 9e98f587da45 docs/INDEX
--- a/docs/INDEX        Fri Nov 25 14:34:21 2011 +0000
+++ b/docs/INDEX        Fri Nov 25 14:34:22 2011 +0000
@@ -1,5 +1,5 @@
 misc/hvm-emulated-unplug       Xen HVM emulated device unplug protocol
 
 # These are not all that useful anymore, hide them from the index
-interface/index                        NO-INDEX
-user/index                     NO-INDEX
+reference/interface/index      NO-INDEX
+reference/user/index           NO-INDEX
diff -r 00ea49f77bdc -r 9e98f587da45 docs/Makefile
--- a/docs/Makefile     Fri Nov 25 14:34:21 2011 +0000
+++ b/docs/Makefile     Fri Nov 25 14:34:22 2011 +0000
@@ -14,7 +14,7 @@ DOC_TEX               := src/user.tex src/interface.t
 DOC_MARKDOWN   := $(wildcard misc/*.markdown)
 DOC_PS         := $(patsubst src/%.tex,ps/%.ps,$(DOC_TEX))
 DOC_PDF                := $(patsubst src/%.tex,pdf/%.pdf,$(DOC_TEX))
-DOC_HTML       := $(patsubst src/%.tex,html/%/index.html,$(DOC_TEX)) \
+DOC_HTML       := $(patsubst src/%.tex,html/reference/%/index.html,$(DOC_TEX)) 
\
                   $(patsubst %.markdown,html/%.html,$(DOC_MARKDOWN)) \
                   $(patsubst man/%.pod.1,html/man/%.1.html,$(DOC_MAN1SRC)) \
                   $(patsubst man/%.pod.5,html/man/%.5.html,$(DOC_MAN5SRC))
@@ -119,14 +119,14 @@ ps/%.ps: %.dvi
 %.eps: %.fig
        $(FIG2DEV) -L eps $< $@
 
-html/%/index.html: src/%.tex
+html/reference/%/index.html: src/%.tex
        @$(INSTALL_DIR) $(@D)
        @set -e ; if which $(LATEX2HTML) 1>/dev/null 2>/dev/null; then \
-        echo "Running latex2html to generate $*/index.html ... "; \
+        echo "Running latex2html to generate reference/$*/index.html ... "; \
        $(LATEX2HTML) -split 0 -show_section_numbers -toc_depth 3 -nonavigation 
\
        -numbered_footnotes -local_icons -noinfo -math -dir $(@D) \
        $< 1>/dev/null 2>/dev/null ; else \
-       echo "latex2html not installed; skipping $*."; fi
+       echo "latex2html not installed; skipping reference/$*."; fi
 
 html/index.html: $(DOC_HTML) ./gen-html-index INDEX
        ./gen-html-index -i INDEX html $(DOC_HTML)

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel