Re: [SQLObject] SQLBuilder documentation

[Oleg Broytman <phd@ph...>]

On Wed, Dec 15, 2010 at 11:20:21PM +0100, Daniel Fetchinson wrote:
> > Hello. I just started to document SQLBuilder, the most underdocumented part
> > of SQLObject: http://svn.colorstudy.com/SQLObject/trunk/docs/SQLBuilder.txt
> >    I plan to document it fully (though, perhaps, not in the greatest
> > details) before releasing the trunk as the version 1.0 in the beginning of
> > next year.
> >    Any help will be appreciated. A few paragraphs of text, or just a
> > sentence, a wording or grammar suggestion - anything, however small, would
> > be helpful.
> 
> This is really great Oleg!
> 
> Here is a patch (coming from "diff -u SQLBuilder.new.txt
> SQLBuilder.txt") with grammatical suggestions. I also attached the new
> file along with the patch.

   Thank you very much! Everything looks great except that you did diff in
the reverse direction. (-:
   I copied and renamed your full SQLObject.new.txt and committed it in the
revision 4302.

Oleg.
-- 
     Oleg Broytman            http://phd.pp.ru/            phd@...
           Programmers don't die, they just GOSUB without RETURN.

[SQLObject] SQLBuilder documentation

[Oleg Broytman <phd@ph...>]

Hello. I just started to document SQLBuilder, the most underdocumented part
of SQLObject: http://svn.colorstudy.com/SQLObject/trunk/docs/SQLBuilder.txt
   I plan to document it fully (though, perhaps, not in the greatest
details) before releasing the trunk as the version 1.0 in the beginning of
next year.
   Any help will be appreciated. A few paragraphs of text, or just a
sentence, a wording or grammar suggestion - anything, however small, would
be helpful.

Oleg.
-- 
     Oleg Broytman            http://phd.pp.ru/            phd@...
           Programmers don't die, they just GOSUB without RETURN.

Re: [SQLObject] SQLBuilder documentation

[Daniel Fetchinson <fetchinson@go...>]

> Hello. I just started to document SQLBuilder, the most underdocumented part
> of SQLObject: http://svn.colorstudy.com/SQLObject/trunk/docs/SQLBuilder.txt
>    I plan to document it fully (though, perhaps, not in the greatest
> details) before releasing the trunk as the version 1.0 in the beginning of
> next year.
>    Any help will be appreciated. A few paragraphs of text, or just a
> sentence, a wording or grammar suggestion - anything, however small, would
> be helpful.

This is really great Oleg!

Here is a patch (coming from "diff -u SQLBuilder.new.txt
SQLBuilder.txt") with grammatical suggestions. I also attached the new
file along with the patch.

Cheers,
Daniel

-- 
Psss, psss, put it down! - http://www.cafepress.com/putitdown

Re: [SQLObject] SQLBuilder documentation

[Oleg Broytman <phd@ph...>]

On Wed, Dec 15, 2010 at 11:20:21PM +0100, Daniel Fetchinson wrote:
> > Hello. I just started to document SQLBuilder, the most underdocumented part
> > of SQLObject: http://svn.colorstudy.com/SQLObject/trunk/docs/SQLBuilder.txt
> >    I plan to document it fully (though, perhaps, not in the greatest
> > details) before releasing the trunk as the version 1.0 in the beginning of
> > next year.
> >    Any help will be appreciated. A few paragraphs of text, or just a
> > sentence, a wording or grammar suggestion - anything, however small, would
> > be helpful.
> 
> This is really great Oleg!
> 
> Here is a patch (coming from "diff -u SQLBuilder.new.txt
> SQLBuilder.txt") with grammatical suggestions. I also attached the new
> file along with the patch.

   Thank you very much! Everything looks great except that you did diff in
the reverse direction. (-:
   I copied and renamed your full SQLObject.new.txt and committed it in the
revision 4302.

Oleg.
-- 
     Oleg Broytman            http://phd.pp.ru/            phd@...
           Programmers don't die, they just GOSUB without RETURN.

Re: [SQLObject] SQLBuilder documentation

[Daniel Fetchinson <fetchinson@go...>]

>> > Hello. I just started to document SQLBuilder, the most underdocumented
>> > part
>> > of SQLObject:
>> > http://svn.colorstudy.com/SQLObject/trunk/docs/SQLBuilder.txt
>> >    I plan to document it fully (though, perhaps, not in the greatest
>> > details) before releasing the trunk as the version 1.0 in the beginning
>> > of
>> > next year.
>> >    Any help will be appreciated. A few paragraphs of text, or just a
>> > sentence, a wording or grammar suggestion - anything, however small,
>> > would
>> > be helpful.
>>
>> This is really great Oleg!
>>
>> Here is a patch (coming from "diff -u SQLBuilder.new.txt
>> SQLBuilder.txt") with grammatical suggestions. I also attached the new
>> file along with the patch.
>
>    Thank you very much! Everything looks great except that you did diff in
> the reverse direction. (-:
>    I copied and renamed your full SQLObject.new.txt and committed it in the
> revision 4302.

Oh sorry, next time it will be the other way around. Or better yet
I'll check out trunk and use svn diff.

Cheers,
Daniel


-- 
Psss, psss, put it down! - http://www.cafepress.com/putitdown

Re: [SQLObject] SQLBuilder documentation

[Oleg Broytman <phd@ph...>]

On Thu, Dec 16, 2010 at 10:13:57AM +0100, Daniel Fetchinson wrote:
> Oh sorry, next time it will be the other way around. Or better yet

   No problem, I can always do patch -R :-)

> I'll check out trunk and use svn diff.

   That would be the best. Thank you in advance!

Oleg.
-- 
     Oleg Broytman            http://phd.pp.ru/            phd@...
           Programmers don't die, they just GOSUB without RETURN.

Re: [SQLObject] SQLBuilder documentation

[Oleg Broytman <phd@ph...>]

On Thu, Dec 16, 2010 at 12:23:58AM +0300, Oleg Broytman wrote:
> Hello. I just started to document SQLBuilder, the most underdocumented part
> of SQLObject
>    I plan to document it fully (though, perhaps, not in the greatest
> details)

   I want to document:

 * Insert, Update and Delete; mention Insert as the mean to do
   mass-insertion and made a link from the FAQ;
 * All kinds of JOINs (they are quite similar);
 * Alias and Outer for joining a table with itself.

Oleg.
-- 
     Oleg Broytman            http://phd.pp.ru/            phd@...
           Programmers don't die, they just GOSUB without RETURN.

Re: [SQLObject] SQLBuilder documentation

[Oleg Broytman <phd@ph...>]

On Thu, Dec 16, 2010 at 03:37:43PM +0300, Oleg Broytman wrote:
>    I want to document:
> 
>  * Insert, Update and Delete

   + Union. Insert is documented meanwhile.

Oleg.
-- 
     Oleg Broytman            http://phd.pp.ru/            phd@...
           Programmers don't die, they just GOSUB without RETURN.