Subject: [xml2rfc] Re: nsgmls?
From: [email-masked] (Scott W Brim)
Date: Tue, 27 Aug 2002 13:19:50 -0400

On Tue, Aug 27, 2002 10:18:16AM -0700, Marshall Rose allegedly wrote:
> > It seems, though, that rfc262.dtd isn't formal enough for the sgml tools
> > I have here.  So it goes.  It's been interesting.
> 
> scott - this sort of troubles me in the sense that, afaik, rfc2629.dtd is a
> perfectly fine, conformant dtd.
> 
> what did nsgmls complain about, exactly?

I'll set it all up again and pass you the messages, offline.  If you
think it should work, I'm probably doing something wrong.

From: [email-masked] (Marshall Rose)
Date: Tue, 27 Aug 2002 10:18:16 -0700
Subject: [xml2rfc] Re: nsgmls?
References: <[email-masked]> <r01050300-1015-E667C00DB9C811D6902C00039300CF5C@[193.157.66.10]> <[email-masked]>
Message-ID: <008c01c24ded$bc25ffb0$6500000a@dev0196>

> It seems, though, that rfc262.dtd isn't formal enough for the sgml tools
> I have here.  So it goes.  It's been interesting.

scott - this sort of troubles me in the sense that, afaik, rfc2629.dtd is a
perfectly fine, conformant dtd.

what did nsgmls complain about, exactly?

thanks,

/mtr

From: [email-masked] (Scott W Brim)
Date: Tue, 27 Aug 2002 10:59:31 -0400
Subject: [xml2rfc] Re: nsgmls?
In-Reply-To: <r01050300-1015-E667C00DB9C811D6902C00039300CF5C@[193.157.66.10]>; from [email-masked] on Tue, Aug 27, 2002 at 04:25:56PM +0200
References: <[email-masked]> <r01050300-1015-E667C00DB9C811D6902C00039300CF5C@[193.157.66.10]>
Message-ID: <[email-masked]>

On Tue, Aug 27, 2002 04:25:56PM +0200, Terje Bless allegedly wrote:
> Find the catalog file it uses and associate the FPI or SI with
> /the/path/to/rfc2629.dtd, I would assume. On Red Hat Linux, the catalog and
> DTDs are kept in /usr/share/sgml/ somewhere and are named either "catalog"
> or "*.soc". The catalog should probably have an entry for:
> 
>   SYSTEM "rfc2629.dtd" "/real/path/to/rfc2629.dtd"
> 
> or the '<!DOCTYPE rfc SYSTEM "rfc2629.dtd">' bit could reference the file
> directly (iow, include a full path to rfc2629.dtd).
> 
> 
> With the caveat that I'm not familiar with 2629 so it may have
> peculiarities that I'm not aware of which makes this not work.

Thanks for the clues.  On RH 7.3, the main catalog is /etc/sgml/catalog.
Subsidiary catalogs are kept there and in subdirectories under
/usr/share/sgml.  DTDs are kept in subdirectories of /usr/share/sgml.
It seems, though, that rfc262.dtd isn't formal enough for the sgml tools
I have here.  So it goes.  It's been interesting.

...Scott

From: [email-masked] (Terje Bless)
Date: Tue, 27 Aug 2002 16:25:56 +0200
Subject: [xml2rfc] Re: nsgmls?
In-Reply-To: <[email-masked]>
Message-ID: <r01050300-1015-E667C00DB9C811D6902C00039300CF5C@[193.157.66.10]>

Randy Bush <[email-masked]> wrote:

>i have become a fan of tidy, on freebsd /usr/ports/www/tidy, it
>diagnoses and cleans up html and xml, and prettyprints it as well.

But it's a lint and not a validator; especially not in the SGML/XML sense.

>Emacs psgml mode wants to use nsgmls as an XML verifier (on linux).
>[...] what do I have to do to make nsgmls aware of rfc2629.dtd?

Find the catalog file it uses and associate the FPI or SI with
/the/path/to/rfc2629.dtd, I would assume. On Red Hat Linux, the catalog and
DTDs are kept in /usr/share/sgml/ somewhere and are named either "catalog"
or "*.soc". The catalog should probably have an entry for:

  SYSTEM "rfc2629.dtd" "/real/path/to/rfc2629.dtd"

or the '<!DOCTYPE rfc SYSTEM "rfc2629.dtd">' bit could reference the file
directly (iow, include a full path to rfc2629.dtd).

With the caveat that I'm not familiar with 2629 so it may have
peculiarities that I'm not aware of which makes this not work.

-- 
"Hath no man's dagger here a point for me?"   - Leonato, Governor of Messina.
                   See Project Gutenberg <URL:http://promo.net/pg/> for more.

From: [email-masked] (Randy Bush)
Date: Tue, 27 Aug 2002 05:07:09 -0700
Subject: [xml2rfc] nsgmls?
References: <[email-masked]>
Message-ID: <[email-masked]>

i have become a fan of tidy, on freebsd /usr/ports/www/tidy, it
diagnoses and cleans up html and xml, and prettyprints it as
well.

randy

From: [email-masked] (Scott W Brim)
Date: Tue, 27 Aug 2002 06:01:02 -0400
Subject: [xml2rfc] nsgmls?
Message-ID: <[email-masked]>

Emacs psgml mode wants to use nsgmls as an XML verifier (on linux).  All
I know about XML I learned from Marshall -- what do I have to do to make
nsgmls aware of rfc2629.dtd?  Alternatively, what do you use to easily
find problems with your XML on *n*x?  I'd even be willing to try out a
different editing environment.

Thanks ... Scott

From: [email-masked] (Michael Richardson)
Date: Mon, 26 Aug 2002 18:49:54 -0400
Subject: [xml2rfc] references
In-Reply-To: Your message of "Mon, 26 Aug 2002 12:13:53 PDT." <[email-masked]>
Message-ID: <[email-masked]>

-----BEGIN PGP SIGNED MESSAGE-----

>>>>> "Marshall" == Marshall Rose <[email-masked]> writes:
    >> where killtodeepcontents.pl is on the above web site as well, and
    >> rfc_pg.c is the standard thing used for processing nroff output.

    Marshall> hi. did you know that the current xml2rfc has a tocdepth PI,
    Marshall> e.g.,
    
    Marshall> <?rfc tocdepth='2' ?>
    
  I did not.
  I'll make use of it.

]       ON HUMILITY: to err is human. To moo, bovine.           |  firewalls  [
]   Michael Richardson, Sandelman Software Works, Ottawa, ON    |net architect[
] [email-masked] http://www.sandelman.ottawa.on.ca/ |device driver[
] panic("Just another Debian GNU/Linux using, kernel hacking, security guy"); [

From: [email-masked] (Randy Bush)
Date: Mon, 26 Aug 2002 13:25:21 -0700
Subject: [xml2rfc] double space after e.g. i.e.
References: <[email-masked]> <[email-masked]>
Message-ID: <[email-masked]>

>>    E.g.  a flozzie may floozie ...
>>        ^^
> well, this is a hard one to get right.

agreed.  fyi, emacs M-Q seems to retain whatever one puts after a
period.

> the original version of xml2rfc just put one space after "."
> because that worked for everything. then it was noted that the
> rfc editor prefers that sentences have two spaces after them.

as do i, so i really appreciate xml2rfc doing the double space.

> to avoid the problem, i do this "e.g.," "cf.," etc.

hmmm.  that's proper.

> if someone has a counter-example, let me know.

well, there is the case of ... in the middle of a sentence.

> the alternative is to add some rather odd heuristics, e.g.,
> 	if you see <not-a-letter><letter>". " then it should have one space
> 	if you see "cf. " then it should have one space
> 	otherwise, if you see ". ", it should have two spaces

see elipses above.

i promise to use the comma and shut up. :-)

randy

From: [email-masked] (Marshall Rose)
Date: Mon, 26 Aug 2002 12:13:53 -0700
Subject: [xml2rfc] references
In-Reply-To: <[email-masked]>
References: <[email-masked]> <[email-masked]>
Message-ID: <[email-masked]>

> where killtodeepcontents.pl is on the above web site as well, and rfc_pg.c
> is the standard thing used for processing nroff output.

hi. did you know that the current xml2rfc has a tocdepth PI, e.g.,
    
    <?rfc tocdepth='2' ?>
    
/mtr

From: [email-masked] (Michael Richardson)
Date: Mon, 26 Aug 2002 14:22:50 -0400
Subject: [xml2rfc] references
In-Reply-To: Your message of "Mon, 26 Aug 2002 08:06:28 EDT." <[email-masked]>
Message-ID: <[email-masked]>

If there is any value, I've been posting the XML for
the document I've been working on at
http://www.sandelman.ca/SSW/freeswan/oeid/. It is not a short
document, and it may serve as a good reference for others.

I produce the .txt files with:

rfc_pg: utils/rfc_pg.c

draft-richardson-ipsec-opportunistic.txt: draft-richardson-ipsec-opportunistic.nr rfc_pg
        perl utils/killtoodeepcontents.pl draft-richardson-ipsec-opportunistic.nr \
        | nroff -ms \
        | sed -e 's/FORMFEED\[Page/        ^L\[Page/' | ./rfc_pg -n5 >draft-richardson-ipsec-opportunistic.txt

draft-richardson-ipsec-opportunistic.nr: src/draft-richardson-ipsec-opportunistic.xml
        XML_LIBRARY=$(XML_LIBRARY):./src xml2rfc xml2nroff $? $@

src/draft-richardson-ipsec-opportunistic.html: src/draft-richardson-ipsec-opportunistic.xml
        XML_LIBRARY=$(XML_LIBRARY):./src xml2rfc xml2html $? $@

where killtodeepcontents.pl is on the above web site as well, and rfc_pg.c
is the standard thing used for processing nroff output.

]       ON HUMILITY: to err is human. To moo, bovine.           |  firewalls  [
]   Michael Richardson, Sandelman Software Works, Ottawa, ON    |net architect[
] [email-masked] http://www.sandelman.ottawa.on.ca/ |device driver[
] panic("Just another Debian GNU/Linux using, kernel hacking, security guy"); [

From: [email-masked] (Marshall Rose)
Date: Mon, 26 Aug 2002 09:34:32 -0700
Subject: [xml2rfc] double space after e.g. i.e.
In-Reply-To: <[email-masked]>
References: <[email-masked]>
Message-ID: <[email-masked]>

> xml2rfc seems to double space after abbreviations.  in noticed this
> in the following result
> 
>    E.g.  a flozzie may floozie ...
>        ^^

well, this is a hard one to get right.

the original version of xml2rfc just put one space after "." because that worked for everything. then it was noted that the rfc editor prefers that sentences have two spaces after them.

to avoid the problem, i do this "e.g.," "cf.," etc. i have yet to meet an abbreviation ending with a period that can't also take a comma.

if someone has a counter-example, let me know.

the alternative is to add some rather odd heuristics, e.g.,

	if you see <not-a-letter><letter>". " then it should have one space
	if you see "cf. " then it should have one space
	otherwise, if you see ". ", it should have two spaces

/mtr

From: [email-masked] (Marshall Rose)
Date: Mon, 26 Aug 2002 08:30:28 -0700
Subject: [xml2rfc] references
In-Reply-To: <[email-masked]>
References: <[email-masked]>
Message-ID: <[email-masked]>

> how do i sub-divide <references> into normative and non-normative?

there's an example of that under "Helpful Hints" on http://xml.resource.org/

/mtr

From: [email-masked] (Scott W Brim)
Date: Mon, 26 Aug 2002 08:06:28 -0400
Subject: [xml2rfc] references
In-Reply-To: <[email-masked]>; from [email-masked] on Mon, Aug 26, 2002 at 05:02:49AM -0700
References: <[email-masked]>
Message-ID: <[email-masked]>

On Mon, Aug 26, 2002 05:02:49AM -0700, Randy Bush allegedly wrote:
> how do i sub-divide <references> into normative and non-normative?

<references> can have title="Normative References", etc.

From: [email-masked] (Randy Bush)
Date: Mon, 26 Aug 2002 05:02:49 -0700
Subject: [xml2rfc] references
Message-ID: <[email-masked]>

how do i sub-divide <references> into normative and non-normative?

randy

From: [email-masked] (Randy Bush)
Date: Mon, 26 Aug 2002 04:10:52 -0700
Subject: [xml2rfc] expiration date calculation
References: <[email-masked]> <[email-masked]> <[email-masked]> <[email-masked]>
Message-ID: <[email-masked]>

aha!

six months != year/2

now that i can understand.  thanks.

randy

From: [email-masked] (Marshall Rose)
Date: Sun, 25 Aug 2002 22:47:39 -0700
Subject: [xml2rfc] expiration date calculation
In-Reply-To: <[email-masked]>
References: <[email-masked]> <[email-masked]> <[email-masked]>
Message-ID: <[email-masked]>

> but feb 23rd is not six months later than august 25th.  feb 25th is.
> though i could see argument to use feb 24th, giving the document a
> six month life.  but feb 23rd i just don't understand.
> 
> btw, i freely admit this is picayune pedantry.  but it's the kind of
> thing a picayune and pedantic nerd notices.

the current algorithm is:
    
    start with the current time in seconds
    add 182*86400 seconds
    add 43200 seconds
    
that's half a year.
    
now it is true that half a year isn't six months...
    
/mtr

From: [email-masked] (Randy Bush)
Date: Sun, 25 Aug 2002 22:40:56 -0700
Subject: [xml2rfc] expiration date calculation
References: <[email-masked]> <[email-masked]>
Message-ID: <[email-masked]>

but feb 23rd is not six months later than august 25th.  feb 25th is.
though i could see argument to use feb 24th, giving the document a
six month life.  but feb 23rd i just don't understand.

btw, i freely admit this is picayune pedantry.  but it's the kind of
thing a picayune and pedantic nerd notices.

randy

From: [email-masked] (Marshall Rose)
Date: Sun, 25 Aug 2002 22:33:30 -0700
Subject: [xml2rfc] expiration date calculation
In-Reply-To: <[email-masked]>
References: <[email-masked]>
Message-ID: <[email-masked]>

> i had been presuming that the expiration date was calculated
> cleverly to not occur on weekends or something.  but i decided
> to check when i noticed this document

okay, why do you care if it's a weekend or a holiday. it's just 6 months later, right?

/mtr

From: [email-masked] (Randy Bush)
Date: Sun, 25 Aug 2002 21:57:13 -0700
Subject: [xml2rfc] expiration date calculation
Message-ID: <[email-masked]>

i had been presuming that the expiration date was calculated
cleverly to not occur on weekends or something.  but i decided
to check when i noticed this document

Network Working Group                                 R. Bush
Internet-Draft                                            IIJ
Expires: February 23, 2003                    August 25, 2002

and that's a sunday!

   February 2003
Su Mo Tu We Th Fr Sa
                   1
 2  3  4  5  6  7  8
 9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28

could someone please explain?

randy

From: [email-masked] (Randy Bush)
Date: Sun, 25 Aug 2002 21:50:00 -0700
Subject: [xml2rfc] double space after e.g. i.e.
Message-ID: <[email-masked]>

xml2rfc seems to double space after abbreviations.  in noticed this
in the following result

   E.g.  a flozzie may floozie ...
       ^^

randy

From: [email-masked] (Randy Bush)
Date: Wed, 21 Aug 2002 10:51:52 -0700
Subject: [xml2rfc] anchors away - the newless cluebie saga continues
References: <[email-masked]> <[email-masked]>
Message-ID: <[email-masked]>

>>     <reference anchor="RFC2065">
>> 	<?rfc include="reference.RFC.2065" ?>
>> 	</reference>
> the <reference anchor=... > and </reference> are already in the include
> file.  Just leave them out.

thanks!

randy

From: [email-masked] (Remco van de Meent)
Date: Wed, 21 Aug 2002 19:40:52 +0200
Subject: [xml2rfc] anchors away - the newless cluebie saga continues
In-Reply-To: <[email-masked]>
References: <[email-masked]>
Message-ID: <[email-masked]>

Randy Bush wrote:
> in the <middle>, i have
> 
>     Secure DNS RFC <xref target="RFC2065"></xref>.
> 
> then, in the <back><references> i have
> 
>     <reference anchor="RFC2065">
> 	<?rfc include="reference.RFC.2065" ?>
> 	</reference>
> 
> and i get the diagnostic
> 
>     anchor attribute already in use: RFC2065

You can leave out both the <reference ...> and </reference> tags, as
they are already present in the included file. And that also solves
your problem :)

regards,
Remco.
-- 
:: [email-masked]
:: http://remco.vandemeent.net/

From: [email-masked] (Marshall Rose)
Date: Wed, 21 Aug 2002 10:32:06 -0700
Subject: [xml2rfc] anchors away - the newless cluebie saga continues
In-Reply-To: <[email-masked]>
References: <[email-masked]>
Message-ID: <[email-masked]>

> in the <middle>, i have
> 
>     Secure DNS RFC <xref target="RFC2065"></xref>.
> 
> then, in the <back><references> i have
> 
>     <reference anchor="RFC2065">
> 	<?rfc include="reference.RFC.2065" ?>
> 	</reference>
> 
> and i get the diagnostic
> 
>     anchor attribute already in use: RFC2065

that's becasue the reference already defines the anchor. (hint: look at
the reference.RFC.2065.xml file!)
    
just have:
    
<rfc>
    ...
<back>
    <references>
        <?rfc include='reference.RFC.2065' ?>
    </references>
</back>
</rfc>

the design principles for 2629/xml2rfc include trying to limit the
amount of typein...
    
/mtr

From: [email-masked] (Marshall Rose)
Date: Wed, 21 Aug 2002 10:29:48 -0700
Subject: [xml2rfc] .xml2rfc.rc
In-Reply-To: <[email-masked]>
References: <[email-masked]> <[email-masked]> <[email-masked]>
Message-ID: <[email-masked]>

> and if i want to add multiple?  follow with
>     append library $sep~/refs/rfcs

well, if you want to have multiple directories, then look at the
original three lines:
    
    foreach bibxmlD [lsort -dictionary [glob -nocomplain ~/rfcs/bibxml/*]] {
        append library $sep$bibxmlD
    }

this says add everything you find in ~/rfcs/bibxml/ to the search
path. (obviously, put only directories there...)
    
so, just change it to whatever you want.
    
/mtr

From: [email-masked] (Scott W Brim)
Date: Wed, 21 Aug 2002 13:28:22 -0400
Subject: [xml2rfc] anchors away - the newless cluebie saga continues
In-Reply-To: <[email-masked]>; from [email-masked] on Wed, Aug 21, 2002 at 10:04:14AM -0700
References: <[email-masked]>
Message-ID: <[email-masked]>

On Wed, Aug 21, 2002 10:04:14AM -0700, Randy Bush allegedly wrote:
> in the <middle>, i have
> 
>     Secure DNS RFC <xref target="RFC2065"></xref>.
> 
> then, in the <back><references> i have
> 
>     <reference anchor="RFC2065">
> 	<?rfc include="reference.RFC.2065" ?>
> 	</reference>
> 
> and i get the diagnostic
> 
>     anchor attribute already in use: RFC2065
> 
> randy

the <reference anchor=... > and </reference> are already in the include
file.  Just leave them out.

From: [email-masked] (Randy Bush)
Date: Wed, 21 Aug 2002 10:04:14 -0700
Subject: [xml2rfc] anchors away - the newless cluebie saga continues
Message-ID: <[email-masked]>

in the <middle>, i have

    Secure DNS RFC <xref target="RFC2065"></xref>.

then, in the <back><references> i have

    <reference anchor="RFC2065">
	<?rfc include="reference.RFC.2065" ?>
	</reference>

and i get the diagnostic

    anchor attribute already in use: RFC2065

randy

From: [email-masked] (Randy Bush)
Date: Wed, 21 Aug 2002 09:47:41 -0700
Subject: [xml2rfc] .xml2rfc.rc
References: <[email-masked]> <[email-masked]>
Message-ID: <[email-masked]>

> actually, it looks for the .rc file in the same directory as the input
> file.

that's new and different.  thanks for that clue

> you don't source .xml2rfc.rc directly

i figured that out in the shower this morning.  no, i do not have a
waterproof laptop (which may explain a lot:-).

>> secondly, how can i hack it to suck up the ~/refs/ids/* directory
>> as well?
> since you're starting with the .rcfile that comes with the software,
> replace these three lines:
>     foreach bibxmlD [lsort -dictionary [glob -nocomplain ~/rfcs/bibxml/*]] {
>         append library $sep$bibxmlD
>     }
> with this line
>     append library $sep~/refs/ids
> that adds one directory, ~/refs/ids/ to your search path for include
> files.

and if i want to add multiple?  follow with
    append library $sep~/refs/rfcs

randy

From: [email-masked] (Marshall Rose)
Date: Wed, 21 Aug 2002 00:38:56 -0700
Subject: [xml2rfc] .xml2rfc.rc
In-Reply-To: <[email-masked]>
References: <[email-masked]>
Message-ID: <[email-masked]>

> first, will the xml2rfc tcl script always find ~/.xml2rfc.rc?  i
> presume so.

actually, it looks for the .rc file in the same directory as the input
file.

> but, if i manually run a slightly modified version of the one in
> the distribution (appended), i get
> 
>     % tclsh8.3 .xml2rfc.rc
>     can't read "inputD": no such variable
> 	while executing
>     "file nativename $inputD"
> 	invoked from within
>     "set nativeD [file nativename $inputD]"
> 	(file ".xml2rfc.rc" line 16)
    
well, to begin, you don't source .xml2rfc.rc directly, you let xml2rfc
do that at the right time (when it will set inputD)

    
> secondly, how can i hack it to suck up the ~/refs/ids/* directory
> as well?

since you're starting with the .rcfile that comes with the software,
replace these three lines:
    
    foreach bibxmlD [lsort -dictionary [glob -nocomplain ~/rfcs/bibxml/*]] {
        append library $sep$bibxmlD
    }

with this line
    
    append library $sep~/refs/ids
    
that adds one directory, ~/refs/ids/ to your search path for include
files.
    
/mtr

From: [email-masked] (Marshall Rose)
Date: Tue, 20 Aug 2002 23:47:54 -0700
Subject: [xml2rfc] url prob in ref when converting to html
In-Reply-To: <[email-masked]>
References: <[email-masked]> <042601c248ac$89127c20$6500000a@dev0196> <[email-masked]>
Message-ID: <[email-masked]>

> Why no vaidation pass locally?  It would obviously be useful.

useful, yes.

however, validation is currently done via a separate service written in java. given all the complaints i got a year about people not wanting to install tcl to run xml2rfc, i'm just not up for the conversations i'll have with folks stepping them through how to install a jvm, a whole bunch of packages, etc., etc.

on the plus side, i recently wrote a limited validator in tcl for another project. maybe i'll put that in the next release...

/mtr

From: [email-masked] (Randy Bush)
Date: Tue, 20 Aug 2002 19:14:56 -0700
Subject: [xml2rfc] .xml2rfc.rc
Message-ID: <[email-masked]>

first, will the xml2rfc tcl script always find ~/.xml2rfc.rc?  i
presume so.

but, if i manually run a slightly modified version of the one in
the distribution (appended), i get

    % tclsh8.3 .xml2rfc.rc
    can't read "inputD": no such variable
	while executing
    "file nativename $inputD"
	invoked from within
    "set nativeD [file nativename $inputD]"
	(file ".xml2rfc.rc" line 16)

secondly, how can i hack it to suck up the ~/refs/ids/* directory
as well?

randy, obviously not a tcl hacker

---

global env tcl_platform

if {![string compare $tcl_platform(platform) windows]} {
    set sep ";"
} else {
    set sep ":"
}

if {[catch { set env(XML_LIBRARY) } library]} {
    set library ""
    foreach bibxmlD [lsort -dictionary [glob -nocomplain ~/refs/rfc/*]] {
        append library $sep$bibxmlD
    }
}

set nativeD [file nativename $inputD]
if {[lsearch [split $library $sep] $nativeD] < 0} {
    set library "$nativeD$sep$library"
}

set env(XML_LIBRARY) $library

From: [email-masked] (Scott W Brim)
Date: Tue, 20 Aug 2002 21:39:40 -0400
Subject: [xml2rfc] url prob in ref when converting to html
In-Reply-To: <042601c248ac$89127c20$6500000a@dev0196>; from [email-masked] on Tue, Aug 20, 2002 at 05:48:58PM -0700
References: <[email-masked]> <042601c248ac$89127c20$6500000a@dev0196>
Message-ID: <[email-masked]>

On Tue, Aug 20, 2002 05:48:58PM -0700, Marshall Rose allegedly wrote:
> the reason i say this is that when xml2rfc runs locally, it doesn't do a
> validation pass. if a validation pass were made, it would complain that the
> <author/> doesn't contain an <organization/>.

Why no vaidation pass locally?  It would obviously be useful.

Thanks ... Scott

From: [email-masked] (Marshall Rose)
Date: Tue, 20 Aug 2002 17:58:09 -0700
Subject: [xml2rfc] url prob in ref when converting to html
References: <[email-masked]><042601c248ac$89127c20$6500000a@dev0196> <[email-masked]>
Message-ID: <045601c248ad$d1dd7990$6500000a@dev0196>

> thankd

no worries. enjoy!

/mtr

From: [email-masked] (Randy Bush)
Date: Tue, 20 Aug 2002 17:53:10 -0700
Subject: [xml2rfc] url prob in ref when converting to html
References: <[email-masked]> <042601c248ac$89127c20$6500000a@dev0196>
Message-ID: <[email-masked]>

>> [0] - btw, how do i get xml2rfc to produce an html output?
> % ln -s xml2rfc.tcl xml2html.tcl

aha!

> i'm also assuming that the reason you got that particular error is that
> when you selected a file to convert, you accidentally selected the text
> file rather than the html file.

<blush>

moi do something that stoopid?  nah.  never.

<blush^2>  <sigh>

thankd

randy

From: [email-masked] (Marshall Rose)
Date: Tue, 20 Aug 2002 17:48:58 -0700
Subject: [xml2rfc] url prob in ref when converting to html
References: <[email-masked]>
Message-ID: <042601c248ac$89127c20$6500000a@dev0196>

first, the short answer:

> [0] - btw, how do i get xml2rfc to produce an html output?

what i do is this:

    % cd ~/bin/
    % ln -s xml2rfc.tcl xml2html.tcl

then i can just say

    xml2html.tcl foo.xml

and it will produce

    foo.html

(assuming of course that ~/bin/ is in your $PATH and you've done a "chmod
+x")

now,  the longer answer:

> <reference anchor="Kerc83"
target="http://www.cl.cam.ac.uk/~fapp2/kerckhoffs">
>     <front>
>     <title>La Cryptographie Militaire</title>
>     <author initials="A." surname="Kerckhoffs" fullname="A. Kerckhoffs">
>     </author>
>     <date year="1883" />
>     </front>
>     </reference>
>
> produces what i wanted for text
>
>    [Kerc83]   Kerckhoffs, A., "La Cryptographie Militaire", 1883,
>               <http://www.cl.cam.ac.uk/~fapp2/kerckhoffs>.
>
> but the html (via the web page converter [0]) gets me (my backslashes)
>
>     <title>You lose</title>
>     <h1>Unable to Convert File</h1><pre>element \
>     http://www.cl.cam.ac.uk/~fapp2/kerckhoffs remains unclosed around line
101
>
>     Context:
> &lt;http://www.cl.cam.ac.uk/~fapp2/kerckhoffs&gt;
>     </pre><hr><address>Apache/1.3.20 Server at xml.resource.org \
>     Port 80</address>
>
>     <html>
>     <body >
>     </body>
>     </html>
>
> huh?

i'm assuming that what's going on here is that you are running xml2rfc
locally to produce text, but using the xml2rfc service to produce html. i'm
also assuming that the reason you got that particular error is that when you
selected a file to convert, you accidentally selected the text file rather
than the html file. just a theory. (you can check it by putting your .txt
file in an editor and looking at the line number where

                 <http://www.cl.cam.ac.uk/~fapp2/kerckhoffs>.

appears. i bet it's around line 101.

here's why i think that:

the reason i say this is that when xml2rfc runs locally, it doesn't do a
validation pass. if a validation pass were made, it would complain that the
<author/> doesn't contain an <organization/>.

when i take that reference and give it to the service (regardless of whether
i ask for text or html), i get this error:

    Unable to Validate File
    [Error] README.xml:299:15: The content of element type "author" is
incomplete,
    it must match "(organization,address?)".

anyway, you should now be able to generate html locally (the short
answer)...

enjoy!

/mtr

From: [email-masked] (Randy Bush)
Date: Tue, 20 Aug 2002 16:59:39 -0700
Subject: [xml2rfc] url prob in ref when converting to html
Message-ID: <[email-masked]>

<reference anchor="Kerc83" target="http://www.cl.cam.ac.uk/~fapp2/kerckhoffs">
    <front>
    <title>La Cryptographie Militaire</title>
    <author initials="A." surname="Kerckhoffs" fullname="A. Kerckhoffs">
    </author>
    <date year="1883" />
    </front>
    </reference>

produces what i wanted for text

   [Kerc83]   Kerckhoffs, A., "La Cryptographie Militaire", 1883,
              <http://www.cl.cam.ac.uk/~fapp2/kerckhoffs>.

but the html (via the web page converter [0]) gets me (my backslashes)

    <title>You lose</title>
    <h1>Unable to Convert File</h1><pre>element \
    http://www.cl.cam.ac.uk/~fapp2/kerckhoffs remains unclosed around line 101

    Context: 
	&lt;http://www.cl.cam.ac.uk/~fapp2/kerckhoffs&gt;
    </pre><hr><address>Apache/1.3.20 Server at xml.resource.org \
    Port 80</address>

    <html>
    <body >
    </body>
    </html>

huh?

randy

---

[0] - btw, how do i get xml2rfc to produce an html output?

From: [email-masked] (Michael Tuexen)
Date: Tue, 20 Aug 2002 09:48:50 +0200
Subject: [xml2rfc] raft- instead of draft-
References: <F92978223B01D311ACFF0008C71EE19D015DF901@MCHH225E> <[email-masked]>
Message-ID: <[email-masked]>

Seems to work again for me to. Maybe a temporary problem.
Thank for the help.
Best regards
Michael

Marshall Rose wrote:
> 
> > Dear all,
> >
> > there seems to be a problem with the convert to .txt, .html and
> > so on function. When submitting a .xml file I get
> >
> > ERROR
> >
> > The requested URL could not be retrieved
> >
> >
> >
> > While trying to retrieve the URL: http://xml.resource.org/cgi-bin/xml2rfc.cgi
> >
> > The following error was encountered:
> >
> >      Zero Sized Reply
> >
> > Squid did not receive any data for this request.
> >
> > Any hints?
> 
> looks fine to me.
> 
> /mtr

From: [email-masked] (Marshall Rose)
Date: Mon, 19 Aug 2002 10:52:19 -0700
Subject: [xml2rfc] raft- instead of draft-
In-Reply-To: <F92978223B01D311ACFF0008C71EE19D015DF901@MCHH225E>
References: <F92978223B01D311ACFF0008C71EE19D015DF901@MCHH225E>
Message-ID: <[email-masked]>

> Dear all,
> 
> there seems to be a problem with the convert to .txt, .html and
> so on function. When submitting a .xml file I get
> 
> ERROR
> 
> The requested URL could not be retrieved
> 
> 
> 
> While trying to retrieve the URL: http://xml.resource.org/cgi-bin/xml2rfc.cgi 
> 
> The following error was encountered: 
> 
>      Zero Sized Reply 
> 
> Squid did not receive any data for this request. 
> 
> Any hints?

looks fine to me.

/mtr

From: [email-masked] (Tuexen Michael)
Date: Mon, 19 Aug 2002 10:07:51 +0200
Subject: [xml2rfc] raft- instead of draft-
Message-ID: <F92978223B01D311ACFF0008C71EE19D015DF901@MCHH225E>

Dear all,

there seems to be a problem with the convert to .txt, .html and
so on function. When submitting a .xml file I get

ERROR

The requested URL could not be retrieved

While trying to retrieve the URL: http://xml.resource.org/cgi-bin/xml2rfc.cgi 

The following error was encountered: 

     Zero Sized Reply 

Squid did not receive any data for this request. 

Any hints?

Best regards
Michael

Michael Tuexen    Tel.:   +49 89 722 47210
Siemens AG        Fax:    +49 89 722 48212
ICN WN CC SE 7    e-Mail: [email-masked]

> -----Original Message-----
> From: Marshall Rose [mailto:[email-masked]]
> Sent: Friday, August 16, 2002 7:58 PM
> To: [email-masked]
> Cc: [email-masked]
> Subject: Re: [xml2rfc] raft- instead of draft-
> 
> 
> > I'm using the ID database available at xml.resource.org. The
> > title of all ID start with raft- instead of draft-.
> > 
> > Could someome fix that? That would be great.
> 
> oops. the datasource got a little jittery. fixed.
> 
> /mtr
> 

From: [email-masked] (Marshall Rose)
Date: Fri, 16 Aug 2002 10:57:35 -0700
Subject: [xml2rfc] raft- instead of draft-
In-Reply-To: <F92978223B01D311ACFF0008C71EE19D015DF8FA@MCHH225E>
References: <F92978223B01D311ACFF0008C71EE19D015DF8FA@MCHH225E>
Message-ID: <[email-masked]>

> I'm using the ID database available at xml.resource.org. The
> title of all ID start with raft- instead of draft-.
> 
> Could someome fix that? That would be great.

oops. the datasource got a little jittery. fixed.

/mtr

From: [email-masked] (Tuexen Michael)
Date: Fri, 16 Aug 2002 10:48:20 +0200
Subject: [xml2rfc] raft- instead of draft-
Message-ID: <F92978223B01D311ACFF0008C71EE19D015DF8FA@MCHH225E>

Dear all,

I'm using the ID database available at xml.resource.org. The
title of all ID start with raft- instead of draft-.

Could someome fix that? That would be great.

Best regards
Michael

Michael Tuexen    Tel.:   +49 89 722 47210
Siemens AG        Fax:    +49 89 722 48212
ICN WN CC SE 7    e-Mail: [email-masked]

From: [email-masked] (Joe Abley)
Date: Thu, 1 Aug 2002 18:04:30 -0400
Subject: [xml2rfc] can't read "counter(firstxref)": no such element in array
In-Reply-To: <[email-masked]>
Message-ID: <[email-masked]>

On Thursday, August 1, 2002, at 03:41 , Joe Abley wrote:

> xml2txt is complaining:
>
>   can't read "counter(firstxref)": no such element in array
>
> when I attempt to render a document which contains no xref elements.
> Inserting a dummy xref element avoids the error. This seems like a bug;
> is it?

For the benefit of the archive, this does indeed appear to be a bug and 
Marshall has identified a fix.

Joe

From: [email-masked] (Joe Abley)
Date: Thu, 1 Aug 2002 12:41:15 -0700
Subject: [xml2rfc] can't read "counter(firstxref)": no such element in array
Message-ID: <[email-masked]>

xml2txt is complaining:

  can't read "counter(firstxref)": no such element in array

when I attempt to render a document which contains no xref elements.
Inserting a dummy xref element avoids the error. This seems like a bug;
is it?

This is xml2rfc 1.13 running on Mac OS 10.1.5 with the shipped tclsh8.3.

Joe

From: [email-masked] (Marshall Rose)
Date: Thu, 1 Aug 2002 08:58:04 -0700
Subject: [xml2rfc] non-ascii names in xml2rfc, the sequel
References: <00c801c235ca$9d1f1100$0701000a@FATORA><[email-masked]> <[email-masked]>
Message-ID: <016601c23974$38ea1650$6500000a@dev0196>

here is my current thinking. comments are welcome.

to support authors who want localized names when rendering to a format that
supports that,
an optional element will be added to the <author/> element, i.e.,

    <!ELEMENT author      (organization,address?,unictext?)>

    <!ELEMENT unictext    (organization,address?)>
    <!ATTLIST unictext
              initials        %ATEXT;            #IMPLIED
              surname     %ATEXT;            #IMPLIED
              fullname     %ATEXT;            #IMPLIED>

 which allows CDATA and #PCDATA to contain unicode characters. The xml:lang
attribute may also be used to provide additional information.

The <unictext/> element is consulted only if the output format supports
unicode.

comments?

/mtr