This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Request for comments: adding a Fileoutput element (RFE613293)


-----BEGIN PGP SIGNED MESSAGE-----
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
'filelisting'?

                                        Be seeing you,
                                          norm

- -- 
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
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>

iD8DBQE+EF3rOyltUcwYWjsRAvOVAJ9OWkAuq4UC1hC6J4Ktv+12mO716gCgmzmQ
HrxyRZjpsgVoKfkyGXdJ0rk=
=DTQO
-----END PGP SIGNATURE-----


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]