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

[Ian Campbell <Ian.Campbell@xxxxxxxxxx>]

On Thu, 2012-08-30 at 16:41 +0100, Ian Jackson 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.

If we are going to have this idea that docs works without or without
running configure then I think it is fine for the without case to just
copy unconditionally and not run markdown.

> Keir, would it be OK if we simply declared that you must run configure
> to "make docs" ?

Also an option.

Ian


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