Re: doc/book request

bmah@packetdesign.com (Bruce A. Mah) writes:
> --==_Exmh_-833565088P
> Content-Type: text/plain; charset=us-ascii
>
> Would it be possible to include an $Id$ or other tag somewhere near the
> front of the book (like on the title page)? This would help those of us
> making dead-tree printout versions remember how current they are.

It's actually not quite as easy as you might think.
 
> I notice that the renderings on svnbook.red-bean.com have some sort of
> revision number on them but I'm not sure where it came from.

It comes from me--Manually--when I build the book. :)

The problem is this: If we put a keyword in book.xml in order to
display a revision number on the cover of the book, it's only going to
display the last revision in which book.xml changed--and it rarely
changes. ch0*.xml and app*.xml change all the time, but that wouldn't
be reflected on the cover.

Now there are a couple of possible solutions for this (I was just
chatting with Sander on irc about this actually):

- Tweak the Makefile to scrub through your working copy (ala
  svnversion) and generate a revision number which it would inject
  into book.xml before making the pdf, html, or whatever.

- Add a new feature to Subversion (post 1.0, of course) to provide a
  keyword that reflects the HEAD revision of the repository that the
  working copy belongs to.

If you want to take on the former and submit a patch, I would be more
than willing to review and incorporate it.

-Fitz

--
Brian W. Fitzpatrick    <fitz_at_red-bean.com>   http://www.red-bean.com/fitz/
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org