os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Replace the <port> tag with a construct in terms of <filename>:

Browse source 
<filename role="package">.  The <port> tag as it was had two major
defects: (a) the name is ambiguous (does "port" mean "architecture"?
how about "TCP/UDP port"?), and (b) it introduces a non-standard (to
DocBook) tag, which is generally assumed to be evil.

Moral support by:	bmah, keramida, mwlucas, roam
This commit is contained in:
Dima Dorfman 2002-02-27 04:56:44 +00:00
parent d389050efd
commit 9d1a5ade02
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=12303
2 changed files with 10 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
share/sgml/freebsd.dsl
View file

@ -141,13 +141,16 @@
($italic-seq$) ($italic-seq$)
($charseq$))))) ($charseq$)))))
(element port (element filename
(let* ((class (attribute-string (normalize "role"))))
(cond
((equal? class "package")
(let* ((urlurl "http://www.FreeBSD.org/cgi/url.cgi") (let* ((urlurl "http://www.FreeBSD.org/cgi/url.cgi")
(href (string-append urlurl "?ports/" (href (string-append urlurl "?ports/"
(data (current-node)) (data (current-node))
"/pkg-descr"))) "/pkg-descr")))
(create-link (list (list "HREF" href)) (create-link (list (list "HREF" href)) ($mono-seq$))))
($mono-seq$)))) (else ($mono-seq$)))))
]]> ]]>
<!-- HTML with images ............................................ --> <!-- HTML with images ............................................ -->
@ -394,9 +397,6 @@
; (urlwrap) ; (urlwrap)
; (literal ">"))) ; (literal ">")))
(element port
(pathwrap))
(element filename (element filename
(pathwrap)) (pathwrap))

9
share/sgml/freebsd41.dtd
View file

@ -7,7 +7,7 @@
The FPI for this DTD is "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" The FPI for this DTD is "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN"
$FreeBSD: doc/share/sgml/freebsd41.dtd,v 1.2 2001/05/22 03:32:17 dd Exp $ $FreeBSD$
--> -->
<!-- ..................................................................... --> <!-- ..................................................................... -->
@ -26,7 +26,7 @@
<!-- Entities for element classes and mixtures ........................... --> <!-- Entities for element classes and mixtures ........................... -->
<!-- Character level classes --> <!-- 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"> <!ENTITY % local.cptr.char.mix "|CO">
@ -116,11 +116,6 @@
%common.attrib; %common.attrib;
> >
<!ELEMENT Port - - ((%cptr.char.mix;)+)>
<!ATTLIST Port
%common.attrib;
>
<!-- The content model for <filename> was changed between DocBook 3.1 and <!-- The content model for <filename> was changed between DocBook 3.1 and
4.1. Specifically, <envar> was disallowed. There's a suggestion from 4.1. Specifically, <envar> was disallowed. There's a suggestion from
the DocBook maintainers that this may have been a mistake. In the the DocBook maintainers that this may have been a mistake. In the