website/community/sandbox.html at 43d8ca429bdb541518d03ba512550d53d9e068f2 · boostorg/website · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
  <title>Boost Sandbox</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <link rel="icon" href="/favicon.ico" type="image/ico" />
  <link rel="stylesheet" type="text/css" href=
  "/style-v2/section-community.css" />
  <!--[if IE 7]> <style type="text/css"> body { behavior: url(/style-v2/csshover3.htc); } </style> <![endif]-->
<script defer data-domain="original.boost.org" src="https://plausible.io/js/script.js"></script></head><!--
Note: Editing website content is documented at:
https://www.boost.org/development/website_updating.html
-->

<body>
  <div id="heading">
    <!--#include virtual="/common/heading.html" -->
  </div>

  <div id="body">
    <div id="body-inner">
      <div id="content">
        <div class="section" id="intro">
          <div class="section-0">
            <div class="section-title">
              <h1>Boost Sandbox</h1>
            </div>

            <div class="section-body">
              <p>When boost was developed using subversion, the Boost Sandbox
              contained unreviewed code that is intended to eventually become
              a part of the Boost libraries. New libraries should be
              developed separately as <a href=
              "https://svn.boost.org/trac/boost/wiki/ModularBoost">git
              modules</a>, and existing projects should be <a href=
              "https://svn.boost.org/trac/boost/wiki/ExtractSandbox">moved to
              GitHub</a>. The sandbox remains as a historical record.</p>

              <h2>Accessing the Boost Sandbox</h2>

              <p>The Boost Sandbox lives at <a href=
              "https://svn.boost.org/svn/boost/sandbox">https://svn.boost.org/svn/boost/sandbox</a>
              within the old Boost Subversion repository.</p>

              <h2>Organization</h2>

              <p>Because there were typically many projects in the sandbox at
              any one time (in various stages of development), the sandbox
              should have been organized by project. Each project should have
              had its own subdirectory inside <tt>sandbox</tt>. For example,
              an XML library would reside in <tt>sandbox/xml</tt>. Inside
              that project-specific subdirectory, the project would be
              organized like any other Boost library, with a <tt>boost</tt>
              subdirectory (for headers) and <tt>libs</tt> subdirectory (for
              source code, build files, and documentation). Our hypothetical
              XML project would likely have had the following structure:</p>

              <ul class="tree">
                <li>
                  <tt>sandbox/xml/</tt>

                  <ul>
                    <li>
                      <tt>boost/</tt> - Contains <tt>xml.hpp</tt>, which
                      includes all of the headers from <tt>xml/</tt>

                      <ul>
                        <li><tt>xml/</tt> - Contains Boost.XML headers</li>
                      </ul>
                    </li>

                    <li>
                      <tt>libs/</tt>

                      <ul>
                        <li>
                          <tt>xml/</tt>

                          <ul>
                            <li><tt>build/</tt> - Contains <tt>Jamfiles</tt>
                            to build Boost.XML</li>

                            <li><tt>doc/</tt> - Contains documentation for
                            Boost.XML</li>

                            <li><tt>src/</tt> - Contains Boost.XML compiled
                            source files</li>
                          </ul>
                        </li>
                      </ul>
                    </li>
                  </ul>
                </li>
              </ul>

              <p>Many existing projects in the sandbox didn't follow this
              structure, opting to place headers in <tt>sandbox/boost</tt>
              and supporting files in <tt>sandbox/libs</tt>.</p>
            </div>
          </div>
        </div>
      </div>

      <div id="sidebar">
        <!--#include virtual="/common/sidebar-common.html" -->
        <!--#include virtual="/common/sidebar-community.html" -->
      </div>

      <div class="clear"></div>
    </div>
  </div>

  <div id="footer">
    <div id="footer-left">
      <div id="revised">
        <p>Revised $Date$</p>
      </div>

      <div id="copyright">
        <p>Copyright Rene Rivera 2007.</p>
      </div><!--#include virtual="/common/footer-license.html" -->
    </div>

    <div id="footer-right">
      <!--#include virtual="/common/footer-banners.html" -->
    </div>

    <div class="clear"></div>
  </div>
</body>
</html>