autoproj 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,325 @@
1
+ /* andreas03 - an open source xhtml/css website layout by Andreas Viklund - http://andreasviklund.com . Free to use for any purpose as long as the proper credits are given to the original author.
2
+
3
+ Version: 1.2
4
+ (Nov 28, 2005)
5
+
6
+ Screen layout: */
7
+
8
+ body{
9
+ margin:0;
10
+ padding:30px 0;
11
+ font:76% tahoma,verdana,sans-serif;
12
+ background:#047 url(images/bodybg.png) repeat-x fixed;
13
+ color:#222;
14
+ }
15
+
16
+ #thetop{
17
+ margin:0;
18
+ }
19
+
20
+ #container{
21
+ width:720px;
22
+ margin:0 auto;
23
+ padding:20px 20px 0 20px;
24
+ background:#fff url(images/contbg.png) no-repeat;
25
+ color:#222;
26
+ }
27
+
28
+ a{
29
+ text-decoration:none;
30
+ background-color:inherit;
31
+ color:#26c;
32
+ }
33
+
34
+ a:hover {
35
+ text-decoration:underline;
36
+ }
37
+
38
+ a img{
39
+ border:0;
40
+ }
41
+
42
+ p{
43
+ margin:0 0 15px 0;
44
+ line-height:1.5em;
45
+ }
46
+
47
+ #main p,#sidebar p{
48
+ padding:0 0 0 10px;
49
+ }
50
+
51
+ #logo{
52
+ float:left;
53
+ width:240px;
54
+ margin:0 20px 0 0;
55
+ padding:0 0 25px 0;
56
+ background:#eee;
57
+ border:4px solid #dde;
58
+ text-align:center;
59
+ color:#555;
60
+ overflow:auto;
61
+ }
62
+
63
+ #logo h1{
64
+ margin:50px 5px 1px 5px;
65
+ letter-spacing:-3px;
66
+ }
67
+
68
+ #logo a{
69
+ background-color:inherit;
70
+ color:#26a;
71
+ text-decoration:none;
72
+ }
73
+
74
+ #logo a:hover{
75
+ background-color:inherit;
76
+ color:#69e;
77
+ }
78
+
79
+ #tagline{
80
+ text-align:center;
81
+ font-size:1.2em;
82
+ }
83
+
84
+ #intro p{
85
+ line-height:1.5em;
86
+ }
87
+
88
+ #main{
89
+ float:left;
90
+ width:530px;
91
+ margin-right:20px;
92
+ padding:0;
93
+ }
94
+
95
+ #main h2, .navbar {
96
+ display:block;
97
+ margin:30px 0 10px 0;
98
+ padding:5px 0 5px 8px;
99
+ background:#eee url(images/gradient2.png) repeat-x;
100
+ color:#222;
101
+ border-top:1px solid #ddd;
102
+ border-right:1px solid #bbb;
103
+ border-bottom:1px solid #bbb;
104
+ border-left:1px solid #ddd;
105
+ text-decoration:none;
106
+ }
107
+
108
+ #sidebar{
109
+ width:155px;
110
+ float:right;
111
+ margin-top:20px;
112
+ font-size:1em;
113
+ line-height:1.3em;
114
+ }
115
+
116
+ #sidebar p, #sidebar .linklist {
117
+ font-size:0.9em;
118
+ }
119
+
120
+ #sidebar ul.linklist {
121
+ list-style-type: none;
122
+ margin: 0px;
123
+ padding: 5px 0px 5px 8px;
124
+ }
125
+
126
+ #sidebar #menu ul, #sidebar #submenu ul {
127
+ list-style-type: none;
128
+ margin: 0px;
129
+ padding: 0px;
130
+ }
131
+
132
+ ul li ul li {
133
+ margin-left: -2em;
134
+ padding-left: 0;
135
+ }
136
+
137
+ #sidebar #menu li, .sidelink, #sidebar #submenu li, #sidebar #submenu li {
138
+ display:block;
139
+ width:140px;
140
+ margin:3px 10px 2px 0;
141
+ padding:5px 0 5px 8px;
142
+ font-size:1.1em;
143
+ font-weight:bold;
144
+ text-align:left;
145
+ background:#eee url(images/gradient1.png) repeat-x;
146
+ color:#26c;
147
+ border-top:1px solid #ddd;
148
+ border-right:1px solid #bbb;
149
+ border-bottom:1px solid #bbb;
150
+ border-left:1px solid #ddd;
151
+ }
152
+
153
+ #sidebar #menu a:hover {
154
+ text-decoration: none;
155
+ }
156
+
157
+ #sidebar #menu li.webgen-menu-submenu-inhierarchy, .menuheader {
158
+ background:#fff url(images/gradient2.png) repeat-x;
159
+ color:#222;
160
+ border-top:1px solid #ddd;
161
+ border-right:1px solid #888;
162
+ border-bottom:1px solid #888;
163
+ border-left:1px solid #ddd;
164
+ text-decoration:none;
165
+ }
166
+
167
+ #sidebar #menu li.webgen-menu-item-selected {
168
+ color: #222;
169
+ }
170
+ #sidebar #menu li.webgen-menu-item-selected:hover {
171
+ color: #222;
172
+ background: none;
173
+ border: none;
174
+ }
175
+
176
+ .menuheader {
177
+ font-size: 1.4em;
178
+ text-align: center;
179
+ margin-bottom: .4em;
180
+ }
181
+
182
+ #sidebar #submenu li.webgen-menu-item-selected, #sidebar #submenu li:hover {
183
+ background: none;
184
+ font-size: 1em:
185
+ }
186
+
187
+ #sidebar #menu li ul li, #sidebar #submenu li ul li, #sidebar #submenu li ul li.webgen-menu-item-selected {
188
+ display:block;
189
+ width:130px;
190
+ margin:3px 10px 2px 0;
191
+ padding:0px 0 0px 8px;
192
+ font-size:0.8em;
193
+ font-weight:bold;
194
+ text-align:left;
195
+ background: none;
196
+ color:#26c;
197
+ border: none;
198
+ }
199
+
200
+
201
+ #footer{
202
+ margin:0 auto 20px auto;
203
+ width:760px;
204
+ background:#fff url(images/footerbg.png) bottom left no-repeat;
205
+ padding:0 0 5px 0;
206
+ font-size:0.9em;
207
+ color:#888;
208
+ text-align:center;
209
+ }
210
+
211
+ h1,h2,h3,h4{
212
+ margin:0 0 10px 0;
213
+ font-weight:normal;
214
+ }
215
+
216
+ h1{
217
+ font-size:2.8em;
218
+ margin-top: 5px;
219
+ margin-bottom: 5px;
220
+ }
221
+
222
+ h2{
223
+ margin:0 0 4px 0;
224
+ font-size:1.8em;
225
+ }
226
+
227
+ h3{
228
+ margin:20px 0 8px 0;
229
+ font-size:1.4em;
230
+ }
231
+
232
+ h4{
233
+ margin:10px 0 5px 0;
234
+ font-size:1.2em;
235
+ }
236
+
237
+ .clear{
238
+ clear:both;
239
+ margin:0;
240
+ }
241
+
242
+ .right{
243
+ text-align:right;
244
+ }
245
+
246
+ .internallink{
247
+ font-size:0.9em;
248
+ text-align:center;
249
+ }
250
+
251
+ .block{
252
+ padding:20px;
253
+ background:#eee;
254
+ color:#222;
255
+ border:2px solid #ddd;
256
+ }
257
+
258
+ .warning{
259
+ padding:20px;
260
+ background:#fbb;
261
+ color:#222;
262
+ border:2px solid #eaa;
263
+ margin-top: 3em;
264
+ margin-bottom: 3em;
265
+ margin-left: 2em;
266
+ margin-right: 2em;
267
+
268
+ }
269
+
270
+ .credit{
271
+ color:#888;
272
+ background-color:inherit;
273
+ }
274
+
275
+ .hide{
276
+ display:none;
277
+ }
278
+
279
+ pre .code{
280
+ margin-left: 2.5em;
281
+ }
282
+ pre {
283
+ margin-left: 2.5em;
284
+ }
285
+
286
+ /* Original open source design by Andreas Viklund - http://andreasviklund.com
287
+ Released through OSWD.org */
288
+
289
+ .navbar {
290
+ padding-left: 1em;
291
+ padding-right: 1em;
292
+ padding-bottom: 2em;
293
+ }
294
+ .previous .next {
295
+ margin: 1em;
296
+ display: inline;
297
+ font-size: 1.2em;
298
+ }
299
+ .previous {
300
+ float: left;
301
+ }
302
+ .next {
303
+ float: right;
304
+ }
305
+
306
+ .fullfigure {
307
+ text-align: center;
308
+ }
309
+ .figurecaption {
310
+ text-align: center;
311
+ margin-top: -1em;
312
+ margin-bottom: 4em;
313
+ margin-left: 10%;
314
+ margin-right: 10%;
315
+ background:#eee;
316
+ color:#222;
317
+ border:2px solid #ddd;
318
+ }
319
+ .commandline {
320
+ font: monospace;
321
+ margin-left: 1em;
322
+ margin-top: -.6em;
323
+ margin-bottom: .5em;
324
+ }
325
+
@@ -0,0 +1,74 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{lang:}">
4
+ <head>
5
+ <meta http-equiv="content-type" content="text/html; charset=utf-8" />
6
+ <meta name="description" content="your description goes here" />
7
+ <meta name="keywords" content="your,keywords,goes,here" />
8
+ <meta name="author" content="Your Name / Original design: Andreas Viklund - http://andreasviklund.com/" />
9
+ <meta name="generator" content="webgen - http://webgen.rubyforge.org" />
10
+ <link rel="stylesheet" type="text/css" href="{relocatable: default.css}" />
11
+ <title>{title: }</title>
12
+ </head>
13
+
14
+ <body>
15
+ <div id="thetop">
16
+ <a id="top"></a>
17
+ <p class="hide">Skip to: <a href="#sitemenu" accesskey="2">Site menu</a> | <a href="#maincontent" accesskey="3">Main content</a></p>
18
+ </div>
19
+
20
+ <div id="container">
21
+ <div id="main">
22
+
23
+ <div id="logo">
24
+ <h1>[<a href="{relocatable: /index.html}" accesskey="4">autoproj</a>]</h1>
25
+ <span id="tagline">User's guide</span><BR />
26
+ for v{execute_cmd: ruby -rlib/autoproj/version -e "puts Autoproj::VERSION"}
27
+ </div>
28
+
29
+ <div id="intro">
30
+ <h2><a id="maincontent"></a>A meta build system</h2>
31
+ <!--
32
+ <p>Here could go a description of your website! Or a quick overview of the page!</p>
33
+ -->
34
+ </div>
35
+ <div class="clear">&nbsp;</div>
36
+
37
+ <div class="navbar">
38
+ {breadcrumb_trail: }
39
+ <div>
40
+ <div class="previous">
41
+ {previous:: }<b>Previous</b>: %{previous}
42
+ </div>
43
+ <div class="next">
44
+ {next:: }<b>Next</b>: %{next}
45
+ </div>
46
+ </div>
47
+ <webgen:block name="navbar" notfound="ignore"/>
48
+ </div>
49
+
50
+ <h1>{title: }</h1>
51
+ <div class="clear">&nbsp;</div>
52
+ <webgen:block name="content" />
53
+ <div class="navbar">
54
+ {breadcrumb_trail: }
55
+ <webgen:block name="navbar" notfound="ignore"/>
56
+ </div>
57
+ </div>
58
+
59
+
60
+ <div id="sidebar">
61
+
62
+ <h2 class="sidelink menuheader"><a id="sitemenu"></a>Main Menu</h2>
63
+ <div id="menu">{menu: {max_levels: 2, show_current_subtree_only: true, nested: true, used_nodes: files}}</div>
64
+ <br>
65
+ <a class="hide" href="#top" accesskey="1">Top of page</a>
66
+
67
+ </div>
68
+ <div class="clear">&nbsp;</div>
69
+ </div>
70
+
71
+ <div id="footer"><p>&copy; 2009 Sylvain Joyeux | Generated by <a href="http://webgen.rubyforge.org/">webgen</a> | Design by <a href="http://andreasviklund.com">Andreas Viklund</a></p></div>
72
+
73
+ </body>
74
+ </html>
@@ -0,0 +1,4 @@
1
+ /index.page:
2
+ title: Introduction
3
+ sort_info: 0
4
+
Binary file
Binary file
Binary file
Binary file
Binary file
@@ -0,0 +1,79 @@
1
+ What is Autoproj
2
+ ----------------
3
+ Autoproj allows to easily install and maintain software that is under source
4
+ code form (usually from a version control system). It has been designed to support a
5
+ package-oriented development process, where each package can have its own
6
+ version control repository (think "distributed version control"). It also
7
+ provides an easy integration of the local operating system (Debian, Ubuntu,
8
+ Fedora, maybe MacOSX at some point).
9
+
10
+ This tool has been developped in the frame of the RubyInMotion project
11
+ (http://sites.google.com/site/rubyinmotion), to install robotics-related
12
+ software -- that is often bleeding edge. Unlike [the ROS build
13
+ system](http://ros.org), it is not bound to one build system, one VCS and one
14
+ integration framework. The philosophy behind autoproj
15
+ is:
16
+ * supports both CMake and autotools, and can be adapted to other tools
17
+ * supports different VCS: cvs, svn, git, plain tarballs.
18
+ * software packages are plain packages, meaning that they can be built and
19
+ installed /outside/ an autoproj tree, and are not tied *at all* to the
20
+ autoproj build system.
21
+ * leverage the actual OS package management system. Right now, only Debian-like
22
+ systems (like Ubuntu) are supported, simply because it is the only one I have
23
+ access to.
24
+ * handle code generation properly
25
+
26
+ It tries as much as possible to follow the lead of Willow Garage on the package
27
+ specification. More specifically, the package manifest files are common between
28
+ ROS package management and autoproj (more details in the following of this
29
+ document).
30
+
31
+ Components of an Autoproj installation
32
+ -------------------------------------
33
+ A autoproj installation is seeded by _package sets_. A package set is a local or remote
34
+ directory in which there is:
35
+ * autobuild scripts that describe what can be built and how it should be built.
36
+ These scripts an also list a set of configuration options that allow to
37
+ parametrize the build. In general, there should be only a limited number of
38
+ such options.
39
+ * a source.yml file which describes the package set itself, and where the software
40
+ packages are located (what version control system and what URL).
41
+ * optionally, a file that describe prepackaged dependencies that can be
42
+ installed by using the operating system package management system.
43
+
44
+ Bootstrapping
45
+ -------------
46
+ "Bootstrapping" means getting autoproj itself before it can work its magic ...
47
+ The canonical way is the following:
48
+
49
+ * install Ruby by yourself. On Debian or Ubuntu, this is done with
50
+ done with
51
+
52
+ sudo apt-get install wget ruby
53
+ {.cmdline}
54
+
55
+ * then, [download this script](autoproj_bootstrap) *in the directory where
56
+ you want to create an autoproj installation*, and run it. This can be done with
57
+
58
+ wget http://doudou.github.com/autoproj/autoproj\_bootstrap <br />
59
+ ruby autoproj\_bootstrap
60
+ {.cmdline}
61
+
62
+ * follow the instructions printed by the script above :)
63
+
64
+ Software packages in Autoproj
65
+ -----------------------------
66
+ In the realm of autoproj, a software package should be a self-contained build
67
+ system, that could be built outside of an autoproj tree. In practice, it means
68
+ that the package writer should leverage its build system (for instance, cmake)
69
+ to discover if the package dependencies are installed, and what are the
70
+ appropriate build options that should be given (for instance, include
71
+ directories or library names).
72
+
73
+ As a guideline, we recommend that inter-package dependencies are managed by
74
+ using pkg-config.
75
+
76
+ To describe the package, and more importantly to setup cross-package
77
+ dependencies, an optional manifest file can be added. This manifest file is
78
+ named manifest.xml. Its format is described later in this user's guide.
79
+