DOCBOOK: Re: A couple issues to discuss....

[Norman Walsh <ndw at nwalsh dot com>]

/ Eric Bischoff <ebisch@cybercable.tm.fr> was heard to say:
| Norman Walsh wrote:
| > 
| > Could you please start a thread about this on the docbook
| > mailing list (docbook@lists.oasis-open.org)? I'm interested in
| > the problem, but I think it needs a wider audience.
| 
| Sure. But I'm not on this list, and I don't want to
| subscribe to yet another list ;-).
| 
| Can you forward this to the docbook list? (Please feel free
| to correct any wrong assumption I could make in this
| explanation.)
| 
| ------------------------------------------------
| Explanation of the problem :
| 
| The KDE project has recently switched to docbook (currently
| 3.1).
| 
| In the metainformation about the authors we need to mention
| the email and the type of contribution of various authors.
| 
| The email is usually their personal email, not the email of
| KDE nor an email at KDE. So far, we have been unable to
| specify this email address outside of <affiliation>. This is
| wrong, it would mean it's the email of (or at) the KDE
| project.
| 
| The type of contribution may be one of "redaction" "upgrade"
| "proofreading" "translation", etc.... Some of these look
| like real <author>s, other ones could be classified as
| <othercredit>s. Right now, we are hesitating between putting
| this type of contribution to the document in
| <affiliation><jobtitle> or in a "role" attribute. None of
| them is really satisfactory. For example, a <jobtitle> in
| <affiliation> would rather mean "the usual work this person
| is doing in this organization" and would be more convenient
| for things like "programmer" or "editor".
| 
| A solution would be to enable <email> and <jobtitle>
| directly at <author> or <othercredit> level.
| ------------------------------------------------
| 
| By the way, Norm ;-) :
| 
| - <email> should be rendered as an anchor <a> by the HTML
| stylesheets
|   when this tag is encountered in the bookinfo.
| 
| - &verbar; isn't rendered as '|' by the HTML stylesheets
| 
| - I've forwarded to you a problem about a division by zero
| in dbtable.dsl
| 
| -- 
|  Éric Bischoff   -   mailto:ebisch@cybercable.tm.fr
|  __________________________________________________
|                                            \^o~_.
|      .~.                           ______  /( __ )
|      /V\         Toys story         \__  \/  (  V
|    //   \\                            \__| (__=v
|   /(     )\                        |\___/     )
|     ^^-^^                           \_____(  )
|      Tux                        Konqui     \__=v
|  __________________________________________________