Re: Rant: Giving up on XML

Subject: Re: Rant: Giving up on XML
From: "iFaqeer (SIA)" <techdarwaish -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 13 Mar 2007 16:48:21 -0700

Okay, this is the definition of a quick-and-dirty solution, but what I
am doing right now is exactly that: a quick-and-dirty Doxygen-to-PDF
path. What we are doing is taking the HTML (not XML) from Doxygen and
pointing Adobe Acrobat Professional at the file at the top of the HTML
tree and saying File > Create PDF > From Web Page.

What you get is crude and has no prayer of looking like
professional-quality doc with TOCs and Indices, etc. But for a
quick-and-dirty to send into the field for those customers that MUST
have PDF, it's a ... did I say "quick" often enough?... quick fix.


On 3/12/07, siliconwriter -at- comcast -dot- net <siliconwriter -at- comcast -dot- net> wrote:
> After weeks of research, reading and studying, I'm throwing in the towel on XML. I was really hoping I could use DocBook to turn the output of our code documentation software into a manual, but no such luck. The output from our software (Doxygen) is so idiosyncratic, so impossible to tweak, that I've been unable to change the page size from A4 to US letter. I tried using DocBook, only to find that the learning curve is steep, undocumented and tricky. Doxygen uses LaTeX as its output engine, and a creakier, more poorly documented, unnecessarily complicated piece of software I have never seen.
> So I'm actually going back to MS Word. There are not enough words in English to say how much I loathe and despise Word, but I can't justify spending weeks and weeks more trying to figure out how all the puzzle pieces of XML, DTDs, XLSTs and other alphabet soup fit together. I'm not interested in becoming a programmer in order to do my job, which is writing manuals, not coding stylesheets. My company already sprang for InDesign (which bombed big time), so I have no hope of persuading them to go to Framemaker, which I don't want to do anyway. So, it's back to Word. *head desk*
> Until now, I was an eager devotee of open source software. I was trying to move all our documentation into OpenOffice and other open source software. Now, not so much. I no longer trust open source, I find it extremely poorly documented from an end-user point of view, and it never, ever has all the features I need. The learning curve resembles a vertical wall.
> If any of you fellow tech writers who actually UNDERSTANDS XML ever gets around to documenting it so that technically savvy but non-programmer audiences can understand and/or use it, I will be very grateful.
> Thanks for listening.
[Sabahat Iqbal Ashraf]
Cell: (510) 304 5927
Blog & Podcast: or
Urdu Podcast: or
poochha joe mainay aap ka parda woe kyaa huwa
kehnay lageen ka aql pay mardhon kee par gaya
[Asked I, your veil, what became of it?
Said she it sits, now, on the minds of menfolk]
Akbar Allahabadi, Urdu/South Asian/Muslim Poet

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output.

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual:

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.


Rant: Giving up on XML: From: siliconwriter

Previous by Author: Re: wiki's
Next by Author: Word Appendix Numbering
Previous by Thread: Re: Rant: Giving up on XML
Next by Thread: Re: Rant: Giving up on XML

What this post helpful? Share it with friends and colleagues:

Sponsored Ads

Sponsored Ads