OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Subject: DOCBOOK: Marking up protocols such as ftp..?

On Mon, Aug 07, 2000 at 12:18:09PM -0400 or thereabouts, Norman Walsh wrote:
> / Sean Donnellan <sean@donnellan.de> was heard to say:
> | I was wondering, as I come from a UNIX/Network background, if there are
> | any standard ways of representing hostnames, domainnames, and ip addresses
> | in DocBook.
> This came up recently. From my (as yet unpublised minutes from the
> last f2f meeting)

Oh, goodie.

Something I have been wondering is whether there is any way to mark 
up protocols such as FTP, HTTP, UDP and so on, and whether such a 
thing would be useful to others as well as to me. Is this the sort 
of thing I should be justified in requesting as an RFE?

I haven't been using DocBook for very long (less than a year) so
I'm a bit hesitant to request another tag to add to the fairly 
large list. At the same time, I can't find anything I can use to
mark many of them up. 

The sort of thing I'm thinking of is where you are describing the 
protocol, not linking to something. In the documentation of a firewall
tool aimed squarely at new users (gnome-lokkit) there are explanations
of what various options will do and how they will affect the user. That
was one place I became sorely confused. Some examples are: 

    DHCP is the Dynamic Hostname Configuration Protocol, which is 
    a way of being assigned an internet address....
    If email arrives on your ISP's server and you collect
    it over <acronym>IMAP</acronym> or <acronym>POP3</acronym>...
    FTP has two modes of operation, one of which is firewall-friendly. 
    Modern FTP clients tend to support the friendly mode (really called 
    passive mode)...
    Realaudio defaults to using UDP which is hard to firewall...
(Eep. What a horrible sentence. Must fix that.)

Etc. Etc. I looked at DHCP, IMAP, POP3, FTP, UDP and the rest and
the best I could do was to find <acronym>. For some reason I didn't
spot <abbrev> at the time. 

There are a host more examples of similar and related items I wanted
to mark up ("There's tags for everything else, there must be for this",
was roughly my feeling at the time) at: 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Powered by eList eXpress LLC