Re: [Xenomai] Generating the documentation

[Leopold Palomo-Avellaneda <leo@alaxarxa.net>]

El Dilluns, 15 de juny de 2015, a les 11:09:39, Gilles Chanteperdrix va 
escriure:
> Leopold Palomo-Avellaneda wrote:
> > El Dilluns, 15 de juny de 2015, a les 10:47:36, Gilles Chanteperdrix va
> > 
> > escriure:
> >> Leopold Palomo-Avellaneda wrote:
> >> > Hi,
> >> > 
> >> > I try to generate the documentation (2.6.4, official tarball) using:
> >> > 
> >> > ./configure --enable-dox-doc
> >> > 
> >> > and I have found that make -jX with X >= 2 fails:
> >> > 
> >> > and I got this message:
> >> > 
> >> > make[2]: Entering directory
> >> > '/srv/drp/packages/xenomai/xenomai.git/build/doc/doxygen'
> >> > doxygen
> >> > make[2]: *** No rule to make target 'api/search', needed by
> >> 
> >> 'all-local'.
> >> 
> >> > Stop.
> >> > make[2]: *** Waiting for unfinished jobs....
> >> > 
> >> > 
> >> > so, IMHO there's something wrong in the dependencies. Then, I would
> >> 
> >> like
> >> 
> >> > kindly to ask to upstream if you can:
> >> > 
> >> > - review the generation of the documentation, to avoid this error.
> >> > 
> >> > or if it's not obvious,
> >> > 
> >> > please add "make doc" target and take out from the default rule to be
> >> 
> >> able
> >> 
> >> > to
> >> > do:
> >> > 
> >> > - make -jX (>=2)
> >> > - make -j1 doc
> >> > 
> >> > Best regards,
> >> 
> >> The documentation generation is reserved to the maintainer. Why do you
> >> need it?
> > 
> > because it's recommended generate the documentation when you create the
> > debian
> > package. That's all.
> 
> The generated documentation is included in the source tree, so if you do
> not pass --enable-*-doc options, a documentation is still present. I would
> recommend you use that doc, it is guaranteed to be generated by me for
> every release.

Ok, I will use that.

> 
> Failing that, submit a patch that arranges the things how you need them.
> Note that some work may be needed, because notably the asciidoc
> documentation generation assumes how asciidoc is installed on my machine,
> and not how it is installed on Debian.

Yes, I thought that.

Best regards,

Leopold

-- 
--
Linux User 152692     GPG: 05F4A7A949A2D9AA
Catalonia
-------------------------------------
A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: Top-posting.
Q: What is the most annoying thing in e-mail?
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: This is a digitally signed message part.
URL: <http://xenomai.org/pipermail/xenomai/attachments/20150615/78fad73e/attachment.sig>