This is the mail archive of the
libc-help@sourceware.org
mailing list for the glibc project.
Re: [Manual] Problems building the manual.
- From: Juan Manuel Torres Palma <j dot m dot torrespalma at gmail dot com>
- To: OndÅej BÃlka <neleai at seznam dot cz>
- Cc: libc-help at sourceware dot org
- Date: Tue, 25 Aug 2015 15:40:29 +0900
- Subject: Re: [Manual] Problems building the manual.
- Authentication-results: sourceware.org; auth=none
- References: <CAD82F-r4io2M0fvccGbgQV13qGi5UbdTj1kSk0oGoHAmZUyZeA at mail dot gmail dot com> <20150825060403 dot GA16540 at domone>
The problem seems to be related to manual/check_safety.sh, or
more precisely being unable to understand how to add safety annotations.
Every unsafe annotation needs to have its explanation, that is,
why it is unsafe.
Now I managed to make it work but probably that script needs to add
some more detailed messages to check where the error is coming from,
as in the previous case it must be something like:
"@mtunsafe{} empty in line XX".
That kind of error message is easier to troubleshoot and track down, but
this problem actually happens because of lack of documentation about
(ironically) generating documentation.
Cheers.
--
Juan Manuel Torres Palma.
Computer Science Student at Universidad de Granada.