PureBasic Forums - English

yup, and too save others time and the effort i had to go through myself, i made a survial guide, i hope it does help as a starting point, and hey, it's free

but i must admit, it's in the documentation department that purebasic is seriously, and i mean SERIOUSLY lacking

i guess fred is concentrating on the code core and language, but he might consider dressing it up a little (the bookstuff / docs / etc. i mean)

the lack of a tutorial is evident, the foreign accent in the language of the help file is charming but doesn't help much either, and some explanations of some of the comments are, well, somewhat 'off'

lots and loads of work left yet it is a nice language...

blueznl,

I meant to mention your fantastic tutorial in my post and am sorry I didn't. It fills a huge gap in the documentation for PB and is very helpful.

I only really read through it properly recently after searching for hours through the forums for some simple help with the Windoze API and finding a link to the tutorial.

Regards,
Jim

Well, it is a common problem, that good coders write bad documentation.
The decomentation, even though it is not the best, costs use a lot of work
to maintain. And with no native english speaker on the team it is no surprise,
that the docs are not perfect english.

We just can't pay somebody to create a real good documentation like a bigger company would do in such a situation.

This is the reason, why Fred put up a cvs system for the docs a long time
ago, in the hope to get some help from the users.
Well, there are some people where very helpfull, but obviously, more could be done.

I know this is a big problem, but honestly, i don't know how to solve it.
We are coders, no writers...

Timo

> Fred put up a cvs system for the docs a long time ago

I'd gladly help (I have in the past, ask Fred) but CVS is just too confusing.

I'm a native English speaker and would gladly offer my time to help with the docs.

I have a sort of idea of what CVS is (updating version of a project by increments?), but no idea how it's used. I am willing to help as much as I can if you point me in the right direction.

Regards,
Jim

as i said before i'm willing to help as well, for the moment i try to get to grips with some of the more... esoteric (that's not 'erotic' you moron, yeah, you!) aspects of the language

(and time is somehwat failing, but that's an altogether different story)

i wonder about any major upcoming changes though, i'd hate to do an immediate rewrite... and i'd hate to tell the world things like 'can't do this' 'can't do that' etc. there's still some stuff missing (hint )

Ok, thanks for the proposal. You can get a quick introduction to CVS in the help dir of cvs.purebasic.com. It's not dificult to use, it's just need a bit of habit. We could setup a write account for anyone willing to enhance to doc, no problem.

Hi Fred,

I've had a poke around the cvs site and after reading some of the help text have now downloaded and installed Wincvs. The problem is, in the help text it says:

a) A preference window will popup automatically at the first start asking
for some basic informations. If it doesn't popup it's under the menu
'Admin/Preferences'.

It didn't open automatically. When I go into preferences, there is nothing in any of the tabs to input the info the help text mentions (authentication, path etc.). There's no mention of these in the Wincvs helpfile either. I'm using Wincvs v1.3.20.3 beta 20 (build 3) if that makes any difference.

I installed Wincvs with all the default options and I haven't installed Python 2.1 as I didn't know whether I needed to or not.

Regards,
Jim

For windows, you could use TortoiseCVS to manage cvs projects, is a lot easy for new users (and old, like me), and it works with explorer (you get cvs options with right click).