Date: Tue, 12 Feb 2002 11:39:25 -0800 (PST) From: Valentino Vaschetto <logo@FreeBSD.org> To: Dima Dorfman <dima@trit.org> Cc: doc@FreeBSD.org Subject: Re: <port> replacement Message-ID: <Pine.LNX.4.43.0202121137570.11667-100000@wrath.forked.net> In-Reply-To: <20020210100554.9A7DB3E35@bazooka.trit.org>
next in thread | previous in thread | raw e-mail | index | archive | help
I like this idea. The only issue I have with it is the fact that it's only a package. Would it be possible to have 2 new roles? A package role and a port role? -val On Sun, 10 Feb 2002, Dima Dorfman wrote: > I propose to replace the <port> tag with <filename> and a "role" > attribute as follows: > > <filename role="package"> > > There have been some discussions about this in the past, and I think > everyone agrees that <port> should be taken out and shot. Some people > wanted to do weird (to me, at least) things instead, but I believe the > above is what most people felt comfortable with. > > The attached patch makes the above valid and removes <port>. I've > only tested it with HTML output, so if someone could test it with > other output formats I'd appreciate it. The following patches replace > all instances of <port> with the new construct for the doc tree, > relnotes in -current, and relnotes in -stable, respectively: > > http://www.trit.org/~dima/home/p/docport.doc.diff > http://www.trit.org/~dima/home/p/docport.rc.diff > http://www.trit.org/~dima/home/p/docport.r4.diff > > They were generated by applying the following to all SGML files: > > s:<port>(.*?)</port>:<filename role="package">\1</filename>:g > > (Since the new construct is longer, many of the lines now go over 80 > characters, but that can't be helped.) > > If nobody objects, I'd like to commit this soon-ish to avoid having to > regenerate and retest everything due to other, unrelated, changes. > > Thanks. > > Index: freebsd.dsl > =================================================================== > RCS file: /ref/cvsf/doc/share/sgml/freebsd.dsl,v > retrieving revision 1.63 > diff -u -r1.63 freebsd.dsl > --- freebsd.dsl 10 Jan 2002 22:09:44 -0000 1.63 > +++ freebsd.dsl 10 Feb 2002 08:55:01 -0000 > @@ -141,13 +141,16 @@ > ($italic-seq$) > ($charseq$))))) > > - (element port > - (let* ((urlurl "http://www.FreeBSD.org/cgi/url.cgi") > - (href (string-append urlurl "?ports/" > + (element filename > + (let* ((class (attribute-string (normalize "role")))) > + (cond > + ((equal? class "package") > + (let* ((urlurl "http://www.FreeBSD.org/cgi/url.cgi") > + (href (string-append urlurl "?ports/" > (data (current-node)) > "/pkg-descr"))) > - (create-link (list (list "HREF" href)) > - ($mono-seq$)))) > + (create-link (list (list "HREF" href)) ($mono-seq$)))) > + (else ($mono-seq$))))) > ]]> > > <!-- HTML with images ............................................ --> > @@ -394,9 +397,6 @@ > ; (urlwrap) > ; (literal ">"))) > > - (element port > - (pathwrap)) > - > (element filename > (pathwrap)) > > Index: freebsd41.dtd > =================================================================== > RCS file: /ref/cvsf/doc/share/sgml/freebsd41.dtd,v > retrieving revision 1.3 > diff -u -r1.3 freebsd41.dtd > --- freebsd41.dtd 24 Jul 2001 11:07:59 -0000 1.3 > +++ freebsd41.dtd 10 Feb 2002 09:01:14 -0000 > @@ -26,7 +26,7 @@ > <!-- Entities for element classes and mixtures ........................... --> > > <!-- Character level classes --> > -<!ENTITY % local.tech.char.class "|HostID|Username|Groupname|Devicename|MakeTarget|MakeVar|Port"> > +<!ENTITY % local.tech.char.class "|HostID|Username|Groupname|Devicename|MakeTarget|MakeVar"> > > <!ENTITY % local.cptr.char.mix "|CO"> > > @@ -113,11 +113,6 @@ > > <!ELEMENT MakeVar - - ((%cptr.char.mix;)+)> > <!ATTLIST MakeVar > - %common.attrib; > -> > - > -<!ELEMENT Port - - ((%cptr.char.mix;)+)> > -<!ATTLIST Port > %common.attrib; > > > > > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-doc" in the body of the message > To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.LNX.4.43.0202121137570.11667-100000>