introduction.html 2.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Language" content="en-us">
  5. <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
  6. <link rel="stylesheet" type="text/css" href="../../boost.css">
  7. <title>Writing Documentation for Boost - Introduction</title>
  8. </head>
  9. <body link="#0000FF" vlink="#800080">
  10. <table border="0" cellpadding="7" cellspacing="0" width="100%" summary=
  11. "header">
  12. <tr>
  13. <td valign="top" width="300">
  14. <h3><a href="index.html"><img height="86" width="277" alt="C++ Boost"
  15. src="../../boost.png" border="0"></a></h3>
  16. </td>
  17. <td valign="top">
  18. <h1 align="center">Writing Documentation for Boost</h1>
  19. <h2 align="center">Introduction</h2>
  20. </td>
  21. </tr>
  22. </table>
  23. <hr>
  24. <p>Boost does not have any requirements on how you write your
  25. documentation. If you are submitting a library that already has written
  26. documentation in HTML format, there is no reason to change it to follow any
  27. of the guidelines presented here. However, if you have documentation that's
  28. not in HTML format and can't be easily converted to HTML, or if you're
  29. starting on a library from scratch or have a library with no documentation
  30. then these guidelines can make writing the documentation much easier.</p>
  31. <p>The section on <a href="structure.html">Documentation Structure</a>
  32. describes how to go about structuring the documentation's content. This
  33. section may be helpful even for libraries that already have documentation.
  34. If there's a desire to present the library for possible inclusion by the
  35. C++ Standards Committee then there may be a need to restructure the
  36. documentation's content in order to insure the content meets explicit
  37. requirements for library components (Section 17.3).</p>
  38. <p>The section on <a href="design.html">HTML Design</a> gives general rules
  39. to follow when writing HTML documentation in order to give a professional
  40. and consistent look. This section also contains some template files that
  41. can be used to rapidly create documentation pages.</p>
  42. <hr>
  43. <p><a href="http://validator.w3.org/check?uri=referer"><img border="0" src=
  44. "../../doc/images/valid-html401.png" alt="Valid HTML 4.01 Transitional"
  45. height="31" width="88"></a></p>
  46. <p>Revised
  47. <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->04
  48. December, 2006<!--webbot bot="Timestamp" endspan i-checksum="38514" --></p>
  49. <p><i>Copyright &copy; 2001 <a href=
  50. "mailto:williamkempf@hotmail.com">William E. Kempf</a></i></p>
  51. <p><i>Distributed under the Boost Software License, Version 1.0. (See
  52. accompanying file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or
  53. copy at <a href=
  54. "http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</i></p>
  55. </body>
  56. </html>
粤ICP备19079148号