Rant: Giving up on XML

[iFaqeer (SIA)]

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.

iF/SIA

On 3/12/07, siliconwriter at comcast.net <siliconwriter at comcast.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
Web: http://iFaqeer.wikispaces.com/
Blog & Podcast: http://iFaqeer.blogspot.com or http://pkblogs.com/iFaqeer
Urdu Podcast: http://AzadKarachiRadio.blogspot.com or
http://pkblogs.com/AzadKarachiRadio
-----------------------------------
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
-----------------------------------