Thilo Goetz wrote: > Jörn Kottmann wrote: > >> Hi, >> >> after building uima there are lots of empty src/main/resource/META-INF >> folders >> created in different projects. >> Can these be added to svn:ignore ? >> >> After building the docbook there are .db files created, why these are >> checked in ? >> Must they be checked in again when they change during the build ? >> Could we ignore these files, since they are generated ? >> >> Jörn >> > > History repeating itself: > http://www.mail-archive.com/uima-dev@incubator.apache.org/msg03700.html > and surrounding discussion. I think Marshall deleted some generated > files, but not all of them. > > I think the docbook .db files are used for resolving cross-references. > They change every time you change sections and such. I don't pretend > to understand the docbook build, but imho those files should not be in > svn. > That is correct - the files are used for resolving cross references. If they are not in svn, then to do the docbook build, the pdf part has to be done twice: once to format things using perhaps incorrect values for cross references, to at least get the page numbers (almost) right, and the 2nd time, to get the cross ref page numbers right.
If these are not checked in, it's possible (but perhaps unlikely) that even two passes won't quite do it. Here's the case: the first run - without page number info, lays out the pages of a doc one way, and on pass 2, it slightly alters the page layout because the characters of the page reference take a different amount of space that previously, causing some of the layout to shift pages. When the db files are approximately right, this probability drops to very low... - that's why they're checked in. -Marshall > --Thilo > > >
