Reading docs from CVS

[Paul W. Frields]

Rather than doing temporary builds of documents, you can use the yelp
GNOME Help Browser to read DocBook documents directly.  To read a
document "under construction" in CVS, do the following:

1.  Checkout the document:
   $ export CVSROOT=:ext:<username>@cvs.fedoraproject.org:/cvs/docs
   $ cvs co install-guide-devel
2.  Validate the XML to ensure all the dependency files are bulit:
   $ cd install-guide-devel/install-guide
   $ make validate-xml-<LANG>            # <LANG> = en_US, pt, ...
3.  Open the document "parent" file in yelp:
   $ yelp file://$PWD/<LANG>/fedora-install-guide.xml

As you make changes, you can hit Ctrl+R in yelp to reload the changes
immediately.  This is also far easier than rebuilding to see your
changes in HTML!

-- 
Paul W. Frields, RHCE                          http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
      Fedora Project:  http://fedoraproject.org/wiki/PaulWFrields
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug