patchGNU Autoconf Archive - Patches: patch #6910, Create Docbook5 Version of...


patch #6910: Create Docbook5 Version of AX_CHECK_DOCBOOK_XSLT

Submitter:  None
Submitted:  Mon 07 Sep 2009 03:39:49 AM UTC
Priority:  5 - Normal Status:  Postponed
Assigned to:  djmitche Originator Email:  -email is unavailable-
Open/Closed:  Closed
* Mandatory Fields

Add a New Comment (Rich Markup)

Comment Type & Canned Response:
       No canned response available


( Jump to the original submission )

Sat 25 Jun 2011 09:06:51 AM UTC, comment #7: 

This task has been inactive for almost 2 years, and I would like to close it -- unless, if anyone sees a reason to keep it around anyway?

Peter Simons <simons>
Project Administrator
Sun 11 Oct 2009 04:57:02 PM UTC, comment #6: 

OK, so we really do need to add a parameter to indicate the desired docbook version, on the assumption that the user has written their documentation in one and only one version of docbook.

Dustin J. Mitchell <djmitche>
Project Member
Sun 11 Oct 2009 03:32:15 PM UTC, comment #5: 

My understanding is that there is no relationship between the DocBook version and the XSL version (other than that sufficiently old versions of the XSL had no DocBook 5 version, of course).  It is the case that each (recent) XSL release includes both a DocBook 4 (non-ns) version and a DocBook 5 (ns) version.  However, it is not the case that both would necessarily be installed locally on a target system.  For example, in Debian there is a docbook-xsl package containing only the non-ns (v4) XSL and a docbook-xsl-ns package containing only the ns (v5) versions.

Sat 10 Oct 2009 04:19:26 PM UTC, comment #4: 

Is there some relationship betwee the XSLT version and the Docbook version?  Or does each release of the stylesheets come in both a Docbook5 and Docbook4 flavor?

Dustin J. Mitchell <djmitche>
Project Member
Fri 09 Oct 2009 01:06:57 PM UTC, comment #3: 

I think that is a good solution to find if some type of DocBook support is available, but I don't think it would have as much utility to potential users as having separate checks.  The DocBook files in a user's project will likely have one URL set as the xml-stylesheet, so if AX_CHECK_DOCBOOK_XSLT returns true after testing for DocBook 4 but the documents use the DocBook 5 XSLT, which is not available, the check isn't really helping.

If one function is desirable, perhaps adding a parameter for which DocBook version to check, or a return value to indicate which version was found, would be the way to go?

Thu 08 Oct 2009 02:13:52 PM UTC, comment #2: 

Check out both-versions.patch -- it tries to run the same check with a Docbook5 and then Docbook4 document, and a success with either is taken to mean the relevant docbook version is present.

(file #18833)

Dustin J. Mitchell <djmitche>
Project Member
Thu 08 Oct 2009 12:01:07 AM UTC, comment #1: 

Hmm, so this requires different ways of looking for the same XSLT files, depending on the docbook DTD version installed?  Would it make sense to use the new test document, and if that fails, try the old one?

Mon 07 Sep 2009 03:39:49 AM UTC, original submission:  

Docbook5 introduced an XML namespace for the Docbook elements, which caused a new set of XSL stylesheets to be created.  It would be very convenient if there was a version of AX_CHECK_DOCBOOK_XSLT which would check for these namespaced XSL stylesheets.

The changes needed to make the new macro are very straightforward.  I created a patch against AX_CHECK_DOCBOOK_XSLT which would result in an AX_CHECK_DOCBOOK_XSLT_NS function.  The only significant changes are in the xsl stylesheet url (where xsl is changed to xsl-ns) and in the test document (which no longer has a DTD and instead has a namespace and version element).

The reason I submitted this as a patch, rather than a file ready for inclusion is that I am hoping someone with more M4 knowledge than me can find an elegant way to combine the macros and eliminate all of the code duplication in having 2 separate versions of this function.  If this is not possible, or there is more legwork that I can do to make it happen, please let me know.

Note:  The patch is against a version of AX_CHECK_DOCBOOK_XSLT with the patch from #6909 already applied.



(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:

Attached Files
file #18833:  both-versions.patch added by djmitche (2KiB - application/octet-stream)
file #18681:  ax_check_docbook_xslt.m4-create_ns_version.patch added by None (3KiB - text/x-patch - Patch against ax_check_docbook_xslt.m4 to create ax_check_docbook_xslt_ns.m4)


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -email is unavailable- added by djmitche (Updated the item)
  • -email is unavailable- added by simons (Updated the item)
  • -email is unavailable- added by None (Submitted the item)




    Follow 6 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2011-07-17 simons StatusNeed Info Postponed
        Open/ClosedOpen Closed
    2009-10-08 djmitche Attached File- Added both-versions.patch, #18833
    2009-09-18 simons Assigned toNone djmitche
        StatusNone Need Info
    2009-09-07 None Attached File- Added ax_check_docbook_xslt.m4-create_ns_version.patch, #18681

    Back to the top

    Powered by Savane 3.9