]> 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)
commit2b6206f815d6e08cafc26bb9df5a09206b097a0e
tree5208e5cf5a4eafa4f8ab8eee0830e4e4d0adb0e5
parent01e44d2150189d5a6c1131730a525be9b23dcc1a
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