]> granicus.if.org Git - docbook-dsssl/commit
Made reporting of missing refentry metadata more quiet:
authorMichael Smith <xmldoc@users.sourceforge.net>
Wed, 5 Mar 2008 15:16:10 +0000 (15:16 +0000)
committerMichael Smith <xmldoc@users.sourceforge.net>
Wed, 5 Mar 2008 15:16:10 +0000 (15:16 +0000)
commit5d618f903e6e281b0ae7429757e7ca609db584c8
tree6c70823aa86096c86f6023ff81a284d5ee0f8aaa
parent2a57ad760160a1f50e05852e31098c6cbd5ad12b
Made reporting of missing refentry metadata more quiet:

  - we no longer report anything if usable-but-not-preferred
    metadata is found; we just quietly use whatever we manage to
    find

  - we now only report missing "source" metadata if the refentry
    is missing BOTH "source name" and "version" metadata; if it
    has one but not the other, we use whichever one it has and
    don't report anything as missing

The above changes were made because testing with some "real world"
source reveals that some authors are intentionally choosing to use
"non preferred" markup for some metadata, and also choosing to
omit "source name" or "version" metadata in there DocBook XML. So
it does no good to give them pedantic reminders about what they
already know...

Also, changed code to cause "fixme" text to be inserted in output
in particular cases:

  - if we can't manage to find any "source" metadata at all, we
    now put fixme text into the output

  - if we can't manage to find any "manual" metadata a all, we
    now put fixme text into the output

The "source" and "manual" metadata is necessary information, so
buy putting the fixme stuff in the output, we alert users to the
need problem of it being missing.
xsl/common/refentry.xsl