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

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

Michael Tuexen wrote:
> Julian,
> 
> see my comment below.
> 
> Best regards
> Michael
> 
> On Mar 14, 2006, at 2:23 PM, Julian Reschke wrote:
> 
>> 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.
> But you can not cite an ID if it is outdated.... So you have to make 
> sure that all citations are valid
> by hand. I only like the functionality that I do not have to insert the 
> latest number...

Well, you don't need to check by hand, that can be automated as well 
(see 
<http://greenbytes.de/tech/webdav/rfc2629xslt/rfc2629xslt.html#rfc.section.10.1>, 
although I have to admit that it doesn't yet document that functionality 
for internet drafts...)

Best regards, Julian
>From elwynd at dial.pipex.com  Tue Mar 14 19:59:45 2006
From: elwynd at dial.pipex.com (Elwyn Davies)
Date: Tue Mar 14 11:57:28 2006
Subject: [xml2rfc] use of <?rfc typeout crashes online xml2rfc
In-Reply-To: <[e-mail]>
References: <[e-mail]>
	<[e-mail]>
Message-ID: <[e-mail]>

Hi.

It is possible that this isn't fully fixed (or maybe there is a cache 
problem).  I was building a template file to go with the course slides 
and it gets an error when trying to convert to html (it works fine for 
text).

The ffending file is attached (and it has iprExtract again).

Regards,
Elwyn

Marshall Rose wrote:
>
> On Mar 13, 2006, at 07:15 , Elwyn Davies wrote:
>
>> Whilst tryimg to work out what the name attribute of artwork actually 
>> does I discovered that using <?rfc typeout... cause an Internal 
>> Server Error on the web service.
>
> the issue is a bug in the handling of <rfc iprExtract='...' /> 
> attribute when producing html.
>
> i have fixed the web-based service. the next release of the .tgz/.zip 
> files will include this fix.
>
> /mtr
>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: template-edu-full-00.xml
Type: text/xml
Size: 25605 bytes
Desc: not available
Url : http://drakken.dbc.mtview.ca.us/pipermail/xml2rfc/attachments/20060314/abebec37/template-edu-full-00-0001.xml
>From Michael.Tuexen at lurchi.franken.de  Tue Mar 14 21:05:53 2006
From: Michael.Tuexen at lurchi.franken.de (Michael Tuexen)
Date: Tue Mar 14 12:06:04 2006
Subject: Including references, was: [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]> <1142341470.1361.26.camel@wintermute>
	<[e-mail]>
	<[e-mail]>
	<[e-mail]>
Message-ID: <[e-mail]>

Well, I have to be more precise...

Since I can not reference old IDs, I always have to reference the  
latest version.
I, at least this is what I think, I have to check if the contents is  
still that
way I was referring to. Sometimes, procedures, packets or something  
else gets
deleted or modified....

Best regards
Michael

On Mar 14, 2006, at 8:28 PM, Julian Reschke wrote:

> Michael Tuexen wrote:
>> Julian,
>> see my comment below.
>> Best regards
>> Michael
>> On Mar 14, 2006, at 2:23 PM, Julian Reschke wrote:
>>> 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.
>> But you can not cite an ID if it is outdated.... So you have to  
>> make sure that all citations are valid
>> by hand. I only like the functionality that I do not have to  
>> insert the latest number...
>
> Well, you don't need to check by hand, that can be automated as  
> well (see <http://greenbytes.de/tech/webdav/rfc2629xslt/ 
> rfc2629xslt.html#rfc.section.10.1>, although I have to admit that  
> it doesn't yet document that functionality for internet drafts...)
>
> Best regards, Julian
>