Including references, was: [xml2rfc] Slides for edu presentation on xml2rfc in Dallas

[julian.reschke at gmx.de (Julian Reschke)]

Thomas Morin wrote:
> ...
> Another issue I have wrt using entities with XMLMind is that this editor
> will replace an entity ("&RFC2119;") by its content
> ("<reference>...</reference>" block) in the saved file, which is a pain
> because you lose the nice feature of having reference block updated when
> new drafts version are published.
> ...

I personally think that this is a non-feature. Furthermore, a risky one.

If I reference an Internet Draft, and that one changes, the last thing I 
want is that my xml2rfc processor silently updates the reference without 
myself knowing. Note that the I-D may have changed in a way that 
requires change in the referring document as well.

Best regards, Julian
>From tony at att.com  Tue Mar 14 11:39:33 2006
From: tony at att.com (Tony Hansen)
Date: Tue Mar 14 08:39:47 2006
Subject: [xml2rfc] Slides for edu presentation on xml2rfc in Dallas
In-Reply-To: <[e-mail]>
References: <[e-mail]> <[e-mail]>
	<[e-mail]> <[e-mail]>
	<[e-mail]> <[e-mail]>
	<[e-mail]>
	<[e-mail]>
Message-ID: <[e-mail]>

I tried converting a document from using <?rfc include...>.

My DOCTYPE looks like

    <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
       <!ENTITY rfc2119 PUBLIC ''
    'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml'>
    ]>

and my <references> looks like:

    <references title="Normative References">
	&rfc2045;	<!-- mime part 1 -->
	&rfc2047;	<!-- mime part 3 -->
	&rfc2119;	<!-- keywords -->
	&rfc2822;	<!-- message format -->
        &rfc3028;	<!-- sieve -->
    </references>

Now I get an error message like this:

    Unable to Convert File

    can't read "xref(RFC3028)": no such element in array around input
    line 69

    Context (format:  "file_basename:line_in_file:#elem_num:<elem
    ...>"):
        CGI16048.2:66:#38:<t>
        CGI16048.2:65:#37:<section title="Introduction">
        CGI16048.2:64:#36:<middle>
        CGI16048.2:11:#1:<rfc ipr="full3978" category="std"
    docName="draft-ietf-sieve-mime-loop-01.txt">

The reference there looks like

    <xref target="RFC3028" />

Where am I doing something wrong?

	Tony Hansen
	[e-mail]

Julian Reschke wrote:
> I didn't argue with it being convenient :-).
> 
> The alternative is...:
> 
> <!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
>   <!ENTITY rfc2119 PUBLIC ''
> 'http://xml.resource.org/public/rfc/bibxml/reference.RFC.2119.xml'>
> ]>
> 
> and then....
> 
> <references>
>   &rfc2119;
> </references>