Re: [docbook] Re: Listing dates of contributions in a DocBook manpage ?

[Richard Hamilton <hamilton@xmlpress.net>]

Hi Roland,

You can go at this two ways.

1) Go ahead and use the <contrib> element. There's no particular restriction on the contents of this element, so there's nothing wrong with using it as you do.

2) Use the <personblurb> element, which is for additional information about a person.

If you use <personblurb> you could do something like the following (I added <personname>, which is required around <firstname> and <surname>):

    <author>
      <personname>
        <firstname>Merida</firstname>
        <surname>Archer</surname>
      </personname>
      <email>merida.archer@gmail.com</email>
      <contrib>Developer</contrib>
      <personblurb><para>2014 to present</para></personblurb>
    </author>
    <author>
      <personname>
        <firstname>Merida</firstname>
        <surname>Archer</surname>
      </personname>
      <email>marcher@bowhunting.com</email>
      <affiliation><orgname>Archery Inc.</orgname></affiliation>
      <contrib>Developer</contrib>
      <personblurb><para>2013 to 2014</para></personblurb>
    </author>



-------
XML Press
XML for Technical Communicators
http://xmlpress.net
hamilton@xmlpress.net



On Sep 9, 2014, at 18:07, Roland Mainz <roland.mainz@nrubsig.org> wrote:

> On Tue, Sep 2, 2014 at 4:02 PM, Roland Mainz <roland.mainz@nrubsig.org> wrote:
>> [2nd try to get this question posted...]
>> 
>> ---------- Forwarded message ----------
>> From: Roland Mainz <roland.mainz@nrubsig.org>
>> Date: Tue, Sep 2, 2014 at 3:51 PM
>> Subject: Listing dates of contributions in a DocBook manpage ?
>> To: docbook@lists.oasis-open.org
>> 
>> 
>> Hi!
>> 
>> ----
>> 
>> Is there any good way to describe that an author contributed from
>> date1 to date 2 to a project as employee of a company and then from
>> date3 until now on the same project as a private person ?
>> 
>> Right now it looks like this:
>> -- snip --
>> <refentryinfo>
>> <authorgroup>
>> 
>> <author>
>> <firstname>Merida</firstname>
>> <surname>Archer</surname>
>> <email>marcher@bowhunting.com</email>
>> <affiliation><orgname>Archery Inc.</orgname></affiliation>
>> <contrib>Developer (2013-2014)</contrib>
>> </author>
>> 
>> <author>
>> <firstname>Merida</firstname>
>> <surname>Archer</surname>
>> <email>merida.archer@gmail.com</email>
>> <contrib>Developer (2014-)</contrib>
>> </author>
>> 
>> </authorgroup>
>> </refentryinfo>
>> -- snip --
>> 
>> The problematic parts for me are the year ranges embedded in <contrib>
>> where they AFAIK do not belong to...
> 
> Did anyone get the posting ?
> 
> ----
> 
> Bye,
> Roland
> 
> -- 
>  __ .  . __
> (o.\ \/ /.o) roland.mainz@nrubsig.org
>  \__\/\/__/  MPEG specialist, C&&JAVA&&Sun&&Unix programmer
>  /O /==\ O\  TEL +49 641 3992797
> (;O/ \/ \O;)
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org