SourceForge has been redesigned. Learn more.

#118 Generalize programlisting

John Daily

Currently, there does not seem to be a semantically-precise
way to wrap the contents of files that are not
programs. literallayout
is tolerable, but conveys no semantics.

Since the name of the "programlisting" element is not
really open to
interpretation, I would suggest replacing it with a
element ("filecontents"?) with classes like:
- interpreted
- compiled
- input
- output
- configuration
- documentation

I don't know if there would be value in stating whether
a file listing is partial or complete.

If it is reasonable to generalize this further, it
could also
wrap multi-line user commands, which don't seem to have a

Perhaps all the above can be best achieved by adding
classes to
literallayout instead of creating a new element.


  • Michael(tm) Smith

    Logged In: YES

    When I asked about this on the docbook mailing list[1],
    there were a significant number of responses in support
    of adding a new element, called 'filecontents' or
    'fileoutput', instead of just adding new attribute
    values to literallayout.


    Norm posted a couple of follow-up messages syntesizing
    the discussion, and concluding with a suggestion that
    we might name it 'filelisting' instead [2].


    The consensus supports the addition of a new element
    for purpose outlined in the RFE. But it should be noted
    that there was strong opinion against completely
    deprecating <programlisting> and replacing it with the
    new element. They would need to exist side by side.

  • Robert Stayton

    Robert Stayton - 2004-05-03

    Logged In: YES

    The TC does not want to add another element for this
    purpose. They felt that programlisting and literallayout,
    possibly with role attribute, sufficiently satisfy the need. The
    TC will reconsider the element names for 5.0 to make them
    more general.

  • Robert Stayton

    Robert Stayton - 2004-05-03
    • status: open --> closed-rejected

Log in to post a comment.