[xml2rfc] eref placement in references sections

fenner at research.att.com (Bill Fenner) Wed, 07 June 2006 06:40 UTC

From: fenner at research.att.com (Bill Fenner)
Date: Wed, 07 Jun 2006 06:40:06 +0000
Subject: [xml2rfc] eref placement in references sections
Message-ID: <200606071339.k57DdtUw032539@bright.research.att.com>
X-Date: Wed Jun 7 06:40:06 2006

I have a problem in a document that I'm currently writing.
It has two normative references and no informative, so I
have a single <references title="Normative References">.
I added an eref, for convenience, which is an informative
reference.  However, because of the current xml2rfc logic,
it ends up in the Normative section.

My understanding of the current logic:

a) If there is only one references section, the eref goes
there.
b) Otherwise, the eref goes in a seperate "URLs" section
which is not explicitly labelled as to whether it's normative
or not.

I think my options with the current system are:

1. Make up an informative reference that the document doesn't
need, to trigger behavior b
2. Don't use an eref.

It's only to a working group charter, so there's no pressing
need to use an eref, so I will probably use option 2.  However,
I was wondering if anyone else was running into issues like this
and can we come up with a DTD change that addresses this?
(e.g., allow empty <references>, allow anchor= on <references>,
and allow goesInReferenceSection= [with a better name] on <eref>?)
Alternately, perhaps there could be a flag (or something) to always
generate the URLs section seperately instead of using the presence
of only a single references tag as an implicit request?

Thanks,
  Bill
>From mark at digitalfountain.com  Fri Jun 16 12:16:32 2006
From: mark at digitalfountain.com (Mark Watson)
Date: Fri Jun 16 11:17:39 2006
Subject: [xml2rfc] I-D citation database: docs with multiple authors
Message-ID: <277CB7DD1E4B4C4C860484C00389C9C92A30A2@EXVS01.ex.dslextreme.net>

Hi,

 

I notice that some citation entries (for example
http://xml.resource.org/public/rfc/bibxml3/reference.I-D.ietf-rmt-fec-bb
-revised.xml) include only a single author whereas the target document
has several authors.

 

Checking back, I don't think this is new (i.e. the citations for
previous versions of the document were also like this).

 

I guess this could be a problem with the program which constructs the
citation XML or a problem with the way the authors have been included in
the cited document itself.

 

Any ideas ?

 

Best regards,

 

Mark Watson

 

 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/attachments/20060616/9e5a6c30/attachment.htm
>From mrose at dbc.mtview.ca.us  Sat Jun 17 13:55:15 2006
From: mrose at dbc.mtview.ca.us (Marshall Rose)
Date: Sat Jun 17 02:55:48 2006
Subject: [xml2rfc] I-D citation database: docs with multiple authors
In-Reply-To: <277CB7DD1E4B4C4C860484C00389C9C92A30A2@EXVS01.ex.dslextreme.net>
References: <277CB7DD1E4B4C4C860484C00389C9C92A30A2@EXVS01.ex.dslextreme.net>
Message-ID: <D7E44981-6D56-41D8-B431-D2D3494C7192@dbc.mtview.ca.us>

> Checking back, I don?t think this is new (i.e. the citations for  
> previous versions of the document were also like this).
>
> I guess this could be a problem with the program which constructs  
> the citation XML or a problem with the way the authors have been  
> included in the cited document itself.
>
> Any ideas ?

the file that is used to generate the xml file

	ftp://ftp.ietf.org/internet-drafts/1id-abstracts.txt

lists only one author.

/mtr