Re: [Modeling-users] Raw Qualifiers

[Sebastien B. <sbi...@us...>]

Yannick Gingras <ygi...@yg...> wrote:
> No problem.  And as I asked in private why LaTex instead of DocBook ?
> DocBook is a really simple mark up with implied support for unicode
> since it's XML.  30 different tags max in a regular document.  KDE,
> Gnome, Python and Linux are all moving to DocBook.  I would have put
> it the mark up myself but this LaTex thing is beyond my mere mortal
> capabilities.

[laziness speaking] I couldn't find a reference for python/docbook, do
you have any?

Why latex? Because I know latex for years and have never tried docbook,
that's as simple. Moreover, I've found the python documentation process,
based on latex, quite handy to generate docs in html/pdf. And well,
before considering a migration, I'd better have a look at docbook
itself.

> No the doc is not that bad.  This is just a reminder that code is
> meant to be read by both human and computers.  Furthermore, a good
> programming language will be more expressive that english.
[...]
> The case of the unit tests is really special.  The fact that those are
> your quality assurance kit means that they are guaranteed to work.
> There is in those tests an amazing amount of working example and we need
> just that : a picture.  I think that the doc should mention them, they
> are more valuable than you think.

You're probably right.

However this is already there in the doc, admittedly in little
characters, at http://modeling.sf.net/UserGuide/ec-object-uniquing.html,
I'll see how I can make this more proeminent.

        Regards,

-- S=E9bastien.