www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - More DS3 feedback

reply "David B. Held" <dheld codelogicconsulting.com> writes:
Ok, being lazy again (and trying to replicate what I think the typical 
lazy D programmer will do), I created a dsss.conf like so:

name = myapp
[myapp.d]
[mymain.d]
target = myapp

And my tree looks like so:

src/
   foo/
     bar/
       myapp.d
       mymain.d
       dsss.conf

Of course, when I ran 'dsss build', I got:

   myapp.d(5): module dunit cannot read file 'foo\bar\myapp.d'

So I thought: "Aha!  I need to move dsss.conf to my app root and build 
from there"...which resulted in:

   WARNING: Section for nonexistant file myapp.d.
   WARNING: Section for nonexistant file mymain.d.

Now, the reason this is significant, is because these guesses were tried 
*after* reading "DSSS by Example" page (very quickly, of course).  After 
playing around with it some more, things start to crystallize for me, 
and I realize that one little line of explanation would have gone a long 
way for me:

   "Thingys in dsss.conf in square brackets are directories or files
   relative to the project root."

I guess you're supposed to infer this from the third example, but my 
powers of inference are clearly inferior to Inspector Holmes', so a 
conspicuous, explicit statement somewhere early would probably help 90% 
of users get started right away and see the magic.  Hope that helps.

Dave


P.S.  You're probably wondering how such an idiot could possibly write 
correct D programs; but I assure you it is both possible and much more 
common than you might suspect!
Aug 26 2007
parent Chris Nicholson-Sauls <ibisbasenji gmail.com> writes:
David B. Held wrote:
 P.S.  You're probably wondering how such an idiot could possibly write 
 correct D programs; but I assure you it is both possible and much more 
 common than you might suspect!
I concur! .......waitaminnut... -- Chris Nicholson-Sauls -- Chris Nicholson-Sauls
Aug 27 2007