From owner-freebsd-doc@FreeBSD.ORG  Wed Sep 22 09:56:48 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 815)
	id 7A05316A4CF; Wed, 22 Sep 2004 09:56:48 +0000 (GMT)
Date: Wed, 22 Sep 2004 09:56:48 +0000
From: Murray Stokely <murray@FreeBSD.org>
To: Ceri Davies <ceri@FreeBSD.org>,
	Dmitry Morozovsky <marck@FreeBSD.org>, freebsd-doc@FreeBSD.org
Message-ID: <20040922095648.GC32890@hub.freebsd.org>
References: <20040922100938.Y92969@woozle.rinet.ru>
	<20040922084814.GU2493@submonkey.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20040922084814.GU2493@submonkey.net>
User-Agent: Mutt/1.4.1i
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
Subject: Re: authorgroup description in articles
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 22 Sep 2004 09:56:48 -0000

Yes, Ceri's patch looks correct.  I wrote that comment and the
original support for the authorgroup information, but this was only an
issue for the Handbook at the time.

   - Murray

On Wed, Sep 22, 2004 at 09:48:14AM +0100, Ceri Davies wrote:
> On Wed, Sep 22, 2004 at 10:11:11AM +0400, Dmitry Morozovsky wrote:
> > Dear colleagues,
> > 
> > in freebsd.dsl we have the following comment
> > 
> >       <!-- We would like the author attributions to show up in line
> >            with the section they refer to.  Authors who made the same
> >            contribution should be listed in a single <authorgroup> and
> >            only one of the <author> elements should contain a <contrib>
> >            element that describes what the whole authorgroup was
> >            responsible for.  For example:
> > 
> >            <chapterinfo>
> >              <authorgroup>
> >                <author>
> >                  <firstname>Bob</firstname>
> >                  <surname>Jones</surname>
> >                  <contrib>Contributed by </contrib>
> >                </author>
> >                <author>
> >                  <firstname>Sarah</firstname>
> >                  <surname>Lee</surname>
> >                </author>
> >              </authorgroup>
> >            </chapterinfo>
> > 
> >            Would show up as "Contributed by Bob Jones and Sarah Lee".  Each
> >            authorgroup shows up as a separate sentence. -->
> > 
> > and such construction works in book chapters ok. However, when I try to use it
> > inside article's articleinfo, it is not rendering correctly (AFAICC).
> 
> Naive, untested, patch attached.  Please try that out.
> 
> Ceri
> -- 
> It is not tinfoil, it is my new skin.  I am a robot.

> Index: freebsd.dsl
> ===================================================================
> RCS file: /home/ncvs/doc/share/sgml/freebsd.dsl,v
> retrieving revision 1.82
> diff -u -r1.82 freebsd.dsl
> --- freebsd.dsl	30 Aug 2004 09:19:35 -0000	1.82
> +++ freebsd.dsl	22 Sep 2004 08:45:55 -0000
> @@ -837,6 +837,8 @@
>             authorgroup shows up as a separate sentence. -->
>    
>  
> +      (element articleinfo 
> +        (process-children))
>        (element chapterinfo 
>          (process-children))
>        (element sect1info 
> @@ -849,6 +851,8 @@
>          (process-children))
>        (element sect5info 
>          (process-children))
> +      (element (articleinfo authorgroup author)
> +        (literal (author-list-string)))
>        (element (chapterinfo authorgroup author)
>          (literal (author-list-string)))
>        (element (sect1info authorgroup author)
> @@ -870,6 +874,8 @@
>              (process-children)
>              (literal ".  "))))
>  
> +      (element (articleinfo authorgroup)
> +        (custom-authorgroup))
>        (element (chapterinfo authorgroup)
>          (custom-authorgroup))
>        (element (sect1info authorgroup)