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: Re: Request for comments: adding a Fileoutput element (RFE613293)

Hash: SHA1

/ Norman Walsh <ndw@nwalsh.com> was heard to say:
| / Michael Smith <smith@xml-doc.org> was heard to say:
| |  1. add a new element (for example, 'Filecontents') with a 'class'
| |     attribute and enumerated values to indicate what type of file
| |     the marked-up content is from (for example, a program file, a config
| |     file, a documentation file, etc.)[2]
| I really dislike the name 'filecontents'. For one thing, if I use

- From reading the follow-ups, I get the impression that we definitely
want to keep 'programlisting' and my idea of creating 'verbatim' was
going to add confusion more than anything else.

Some people seemed to feel that a new attribute on literallayout would
be enough, others seemed to prefer a new element.

Show of hands: who wants a new element? Who wants to just add an attribute?

Let's say we're going to add a new element, it seems like the purpose
is similar to programlisting but without the "program" semantics.
Rather than 'filecontents', how about 'documentlisting' or

                                        Be seeing you,

- -- 
Norman Walsh <ndw@nwalsh.com>      | In science, "fact" can only mean
http://www.oasis-open.org/docbook/ | "confirmed to such a degree that
Chair, DocBook Technical Committee | it would be perverse to withhold
                                   | provisional assent." I suppose
                                   | that apples might start to rise
                                   | tomorrow, but the possibility does
                                   | not merit equal time in physics
                                   | classrooms.--Stephen J. Gould
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>


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

Powered by eList eXpress LLC