Documentation Dependency Tracking Bug

Joel Sherrill joel.sherrill at OARcorp.com
Mon Feb 25 17:58:50 UTC 2013


On 2/25/2013 5:45 AM, Ralf Corsepius wrote:
> On 02/24/2013 06:48 PM, Joel Sherrill wrote:
>> Hi
>>
>> I was tidying up my patches to support both Texinfo 4.x and 5.x
>> for RTEMS documentation when I noticed a bug in the Makefile's
>> and confirmed they are present without my modifications.
>>
>> Each manual has a version.texi which is supposed to be dependent
>> on the timestamp of that manual's main file.  So the C User's Guide
>> is dependent on touching c_user.texi to update version.texi.
> Not quite - This would be a pretty broken design ;-)
>
>
> Instead, automake keeps timestamps as text inside of separate files,
> named stamp-vti, which are not automatically updated, but supposed to be
> manually updated by the "package maintainer".
>
> I.e. to update the timestamp files, the package maintainer is supposed
> to do the following:
>
> mkdir BUILDDIR
> <path-to-rtems>/configure --enable-maintainer-mode --enable-docs
> cd doc/<subdir>
> make maintainer-clean-vti
> make stamp-vti
>
> Note: maintainer-clean-vti and stamp-vti are non-recursive and are only
> available in maintainer-mode.
>
OK. This works.  Thanks.

But it only works if you configure from the top of the tree.
Building the doc using "..../doc/configure" has always worked fine. But
if you use .../doc/configure, the commands in the stanza are commented
out even with --enable-maintainer-mode and --enable-docs.

You don't have to configure the documentation from the top of the tree
except to regenerate the version.texi files. All of the documented 
procedures
for generating documentation I am aware of configure using "doc/configure".

Any idea why that doesn't let you regenerate the version.texi?
> Sounds more complicated than it actually is.
>    Simply consider that automake and the GNU Standards consider *.texis
> as "package maintainer maintained" sources, which ordinary users are not
> supposed to touch.
>
> Ralf
>
>
> _______________________________________________
> rtems-devel mailing list
> rtems-devel at rtems.org
> http://www.rtems.org/mailman/listinfo/rtems-devel
cd doc

-- 
Joel Sherrill, Ph.D.             Director of Research & Development
joel.sherrill at OARcorp.com        On-Line Applications Research
Ask me about RTEMS: a free RTOS  Huntsville AL 35805
Support Available                (256) 722-9985




More information about the devel mailing list