[PATCH macros 1/2] doc: Specify minimum asciidoc version to XORG_CHECK_ASCIIDOC

[Gaetan Nadon]

On Thu, 2010-03-04 at 19:41 -0300, Fernando Carrijo wrote:

> Gaetan Nadon <memsize at videotron.ca> wrote:
> > I have a theory. Removing the .man files should clear the problem. This
> > can be done by running make maintainer-clean as well.
> > 
> > The 2 step process. Convert .txt to .man using asciidoc and convert .man
> > to .3 using sed. If asciidoc is disabled but if you have .man, then sed
> > is invoked to create .3 files. In this case, the .man files are probably
> > present but broken due to earlier run with asciidoc at the wrong level.
> > They are are not removed by "clean", only by maintainer-clean. We have
> > not tested with broken .man files.
> 
> Bingo!
> 
> I removed the .man files by executing 'make maintainer-clean' and
> rebuilt libXi with 'build.sh', and this time the compilation went
> fine. If you are curious about the generated output:
> 
>   http://pastebin.com/HP9jWae4
> 
> The doubt that remains is if the semantics of 'make distclean' as
> mandated by automake and chosen by libXi is the most adequate for
> maintainers - which is clearly not my case - and end-users, like
> me. I read something concerning this discussion in automake's
> manual that may be useful, if you don't know by heart:
> 
>   http://www.gnu.org/software/hello/manual/automake/Clean.html
> 
> So, this is it! And for what it's worth:
> 
>   Tested-by: Fernando Carrijo <fcarrijo at yahoo.com.br>
> 
> Thank you guys!
> 

Thank you very much for taking the time to report this problem. Life
would be simpler if all the tools were available on all platforms and
always at the correct version. The word "patch" takes it's true meaning
here. With this additional patch there is less chances for someone to
get into that situation. There are other gaps to fill.

I updated this wiki a while ago for Ubuntu so you can install all the
required tools ahead of time, rather than discovering them the hard way
like I did.
http://wiki.x.org/wiki/RequiredPackages.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20100304/fcff72d3/attachment.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
URL: <http://lists.x.org/archives/xorg-devel/attachments/20100304/fcff72d3/attachment-0001.pgp>