root/branches/bud/docs/README.overview

Revision 91, 2.8 kB (checked in by Gregor, 2 years ago)

Updated the docs in preparance for:

RELEASE: 0.1

Line 
1 The D Shared Software System
2 ----------------------------
3
4 DSSS, the D Shared Software System, is a tool to ease the building,
5 installation, configuration and acquisition of D software.
6
7
8 Building
9 --------
10
11 There are plenty of tools for building D software. There's bud (previously
12 build), upon which DSSS is based, the antiquated make, and a plethora of other
13 tools capable of building D software. DSSS intends to be more generally useful
14 than any of them.
15
16  * DSSS eliminates the need to keep lists of source files, figuring them all
17    out by imports in source. It will even link in the proper libraries
18    automatically.
19  * DSSS can transparently build libraries from any D package.
20  * DSSS automatically generates .di (D import) files for libraries which cause
21    code using the library to link it in automatically.
22  * Since DSSS uses bud, DSSS has all of bud's features as well.
23  * DSSS can automatically choose names for libraries generated from D packages
24    which will not conflict with libraries from other sources, or incompatible
25    compilers. So you do not need to concern yourself with library names.
26
27
28 Installation
29 ------------
30
31 As compared to building software, there are few tools capable of installing D
32 software well.
33
34  * DSSS maintains a centralized repository of installed software, such that you
35    can use it in your software trivially. .di files and library files are all
36    managed by DSSS, as part of its effort to make imports map to library files
37    automatically.
38  * DSSS keeps track of all of the software that has been installed through
39    DSSS, so any of it can be uninstalled easily.
40
41
42 Configuration
43 -------------
44
45 DSSS' build configuration file (dsss.conf) allows full use of version
46 statements from D. So, you can fine-tune your software to build precisely what
47 is necessary for the host system.
48
49
50 Acquisition
51 -----------
52
53 In the spirit of Perl's CPAN or Ruby's Gems, DSSS has a central repository of
54 sources for D software. It maintains a list of software packages available,
55 where they can be acquired, and what packages/modules they provide. Because it
56 maintains a list of packages and modules, dependencies for a tool can be
57 installed as easily as:
58 $ dsss net deps
59
60 DSSS will then trace all of the software's D dependencies and install them.
61 This feature can of course also be used to install arbitrary software, such as:
62 $ dsss net install mango
63
64 Upon either of these commands, DSSS will download the software from its
65 upstream source, compile it, and install it.
66
67
68 More Information
69 ----------------
70
71 DSSS is available from http://www.dsource.org/projects/dsss . It is FOSS
72 (Free/Open Source Software) under a very permissive license. Its development
73 code base is maintained in subversion and can be checked out from the following
74 URL:
75 http://svn.dsource.org/projects/dsss/trunk
Note: See TracBrowser for help on using the browser.