Re: [Xen-devel] [PATCH 2 of 3] docs: use elinks to format markdown-generated html to text

[Matt Wilson <msw@xxxxxxxxxx>]

On Thu, Aug 30, 2012 at 04:47:29PM +0100, Keir Fraser wrote:
> On 30/08/2012 16:41, "Ian Jackson" <Ian.Jackson@xxxxxxxxxxxxx> wrote:
> 
> > Matt Wilson writes ("[Xen-devel] [PATCH 2 of 3] docs: use elinks to format
> > markdown-generated html to text"):
> >> Markdown, while easy to read and write, isn't the most consumable
> >> format for users reading documentation on a terminal. This patch uses
> >> lynx to format markdown produced HTML into text files.
> > ...
> >>  txt/%.txt: %.markdown
> >> - $(INSTALL_DIR) $(@D)
> >> - cp $< $@.tmp
> >> - $(call move-if-changed,$@.tmp,$@)
> >> + @$(INSTALL_DIR) $(@D)
> >> + set -e ; \
> >> + if which $(MARKDOWN) >/dev/null 2>&1 && \
> >> +  which $(HTMLDUMP) >/dev/null 2>&1 ; then \
> >> +  echo "Running markdown to generate $*.txt ... "; \
> > 
> > So now we have two efforts to try to find markdown, one in configure
> > and one here.
> > 
> > Keir, would it be OK if we simply declared that you must run configure
> > to "make docs" ?
> 
> Yes!

Great! The confusing bit of having these tools in two places was only
to retain the ability to run 'make -C docs' without running
./configure. I'll resubmit with this cleaned up.

Matt

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
http://lists.xen.org/xen-devel