two issues with quickguide
corey.burger at gmail.com
Fri Mar 11 04:06:33 UTC 2005
I sorted out the issue I think. For some reason, when I added myself
as an author, it didn't work. I am no familiar enough with all the
byways of docbook to find the error. I think the resource issue in
Yelp is associated with bad xml. I have something similar when I load
it, but an order of magnitude smaller. (Maybe my system is beefier
On Thu, 10 Mar 2005 19:53:32 -0800, Jeff Schering
<jeffschering at gmail.com> wrote:
> On Thu, 10 Mar 2005 17:47:59 -0800, Corey Burger <corey.burger at gmail.com> wrote:
> > The latest edit crashes mine too. That would be me.
> > The 2nd is also me. I will fix it.
> > Corey
> Awesome. I will have a few hours free on Friday. I'll go over the
> whole quick guide (text only, not structure) for a double check. I
> want to be confident that nothing else has crept in.
> Corey, if you run into troubles tracking down the source of the
> resource consumption problem, let me know and I will try to help as
> much as I can. I suspect it is a structural issue with the xml markup.
> I have read on the sun java site (I forget exactly where - IRC, it was
> on one of the xalan pages) that xml processing programs consume large
> amounts of memory when dealing with xrefs. I hope that bit of info
> aides your search for the fix, if you haven't found it already.
> P.S. for my own purposes, I developed a procedure for checking things
> before committing them. The procedure is a bit tedious and seems like
> overkill, but it has already saved me once from making a bad commit.
> It was only in my head until now, I have just written it down now. I
> will find a place on the wiki to put it, hopefully later on tonight.
> (a guy's gotta eat! :-) I include it below:
> In the procedure below I make the following assumptions:
> * ubuntu-doc is your top level document directory
> * the document you have changed is the Ubuntu QuickGuide
> 1. Change to the ubuntu-doc directory.
> 2. Validate the file.
> ./validate.sh quickguide/quickguide.xml
> 3. Open the file in yelp and visually double check your work.
> yelp quickguide/quickguide.xml
> 4. Build the html version of the file.
> make qg
> 5. Visually check the html file in your favourite browser.
> file location: ubuntu-doc/build/quickguide/quickguide.xml
> 6. If everything is fine, commit your changes.
> Any suggestions or errors, let me know. Once I have found a place for
> it, I'll let the list know where it is.
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
More information about the ubuntu-doc