README 1.2 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. I couldn't get the date_time.xml to validate, however, it works anyway.
  2. The build process with fail with adequate error messages to fix
  3. any errors.
  4. /********************************/
  5. Do not place a dtd declaration in the doc xml files.
  6. Begin each file with:
  7. <section ...
  8. /********************************/
  9. Including files into sections has some quirks to it. Unless there is a
  10. section in the parent file, the first included file will display
  11. instead of link.
  12. Example.
  13. In date_time.xml:
  14. <xi:include href="subsection.xml" />
  15. And in subsection/xml:
  16. <section id="date_time.my_subsection"
  17. xmlns:xi="http://www.w3.org/2001/XInclude">
  18. <para>
  19. ...
  20. </para>
  21. <xi:include href="another.xml" />
  22. /********************************/
  23. To crosslink use:
  24. <link linkend="date_time.section.subsection">optional text</link>
  25. If you use '<link linkend="top">top</link>' the link will automatically
  26. go to the top of the page it ends up in.
  27. # Copyright (c) 2002-2006 CrystalClear Software, Inc.
  28. # Use, modification and distribution is subject to the
  29. # Boost Software License, Version 1.0. (See accompanying
  30. # file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt)